Pular para o conteúdo principal

Atualização de cadastro

É de responsabilidade do gestor manter os dados dos cedentes atualizados, de acordo com a situação atual da companhia. Este comprometimento é de extrema importância, tanto para manter as análises de PLD atualizadas quanto para atualizar os grupos de assinantes, que mudam constantemente e expiram, sendo necessária uma nova análise. Além disso, a cada 2 anos, automaticamente é gerada uma nova análise para garantir a atualização periódica dos mesmos.

Aviso

É de responsabilidade do gestor manter os dados do cedente atualizados e refletindo a realidade da companhia.

Ao atualizar um cadastro, independente de qual campo for alterado, uma nova análise será gerada, a qual exigirá novos documentos de acordo com as alterações realizadas. As análises seguem um sequencial, e podem falhar inúmeras vezes até serem finalmente aprovadas pelo compliance. As alterações só serão aplicadas após a análise ser concluída com sucesso. Caso as partes relacionadas sejam alteradas, haverá uma etapa de validação dos grupos de assinantes do cedente. Vale ressaltar que caso uma parte relacionada ou um avalista NÃO for enviado, o mesmo será considerado EXCLUÍDO.

informação

Se houver uma análise em andamento quando a atualização cadastral for enviada, ela é cancelada automaticamente (analysis_status: canceled, com reproval_details indicando a atualização cadastral) e uma nova análise é gerada.


Atualização de Cadastro de Cedente Pessoa Jurídica​

Disponível em
PerfilHostPermissão exigida
Gestoramanager-apiEscrita
Consultoriaconsultant-apiCadastrar Cedente
Cedenteassignor-apiEscrita

URL base de cada host: Ambientes (Hosts).

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY
MÉTODO
PUT
Request Body
{
"email": "financeiro@cedente-exemplo.com.br",
"annual_revenues": 1000000,
"is_in_national_financial_system": true,
"address": {
"street": "Rua Maria Carolina",
"number": "624",
"neighborhood": "Jardim Paulistano",
"city": "São Paulo",
"postal_code": "01445-000",
"uf": "SP",
"country": "BRA"
},
"phone": {
"international_dial_code": "+55",
"area_code": "11",
"number": "936360268"
},
"related_parties": [
{
"name": "Natália Nascimento",
"document_number": "123.456.789-09",
"related_party_type": "attorney",
"nationality": "BRA",
"direct_beneficiary": true,
"is_representative": true,
"email": "natalia.nascimento@yopmail.com",
"phone": {
"international_dial_code": "+55",
"area_code": "11",
"number": "936360268"
}
},
{
"name": "Maria Vitoria",
"related_party_type": "president",
"nationality": "DEU",
"passport_number": "C01X00T47",
"direct_beneficiary": true,
"is_representative": false

},
{
"name": "Roberto Carlos",
"document_number": "969.698.790-03",
"related_party_type": "director",
"nationality": "BRA",
"direct_beneficiary": false,
"company_country": "NZL",
"company_registry_number": "4984037284610",
"is_representative": true,
"email": "roberto.carlos@yopmail.com",
"phone": {
"international_dial_code": "+64",
"area_code": "11",
"number": "936360268"
}
}
],
"guarantors": [
{
"name": "Avalista PF",
"document_number": "222.333.444-05",
"person_type": "natural_person",
"email": "email@avalista.com"
},
{
"name": "Avalista PJ",
"document_number": "22.333.444/0001-81",
"person_type": "legal_person",
"email": "email@avalista.com",
"guarantor_representatives": [
{
"name": "Assinante do Avalista",
"document_number": "111.444.777-35",
"email": "emailrepresentante@avalista.com"
}
]
}
]
}

Definição do Cedente​

CampoTipoDescriçãoCaracteres
namestringNome/razão social do cedente.1 a 255
annual_revenuesintegerDeclaração de faturamento anual do cedente, em inteiros.Mínimo de 1
emailstringEndereço de e-mail do cedente.1 a 255
is_in_national_financial_systembooleanIndicador se o cedente é integrante do SFN.-
phoneobjectObjeto referenciando as informações do telefone do cedente.Ver Definição de Telefone.
addressobjectObjeto referenciando as informações do endereço do cedente.Ver Definição de Endereço.
related_partiesarrayLista de partes relacionadas da empresa.Ver Definição de Parte Relacionada.
minimum_required_signersintegerQuantidade mínima de representantes que precisam assinar pelo cedente.Mínimo de 1
guarantorsarrayLista de avalistas do cedente.Ver Definição de Avalista.

Caso não deseje alterar um campo, basta não enviá-lo na request. Para listas, como é o caso de related_parties e guarantors, caso uma lista vazia seja enviada, ou uma parte previamente indicada na lista, e não indicada na nova, será tratado como exclusão.

Response​

STATUS
200
Response Body
{
"assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
"status": "registered",
"name": "Cedente Exemplo LTDA",
"document_number": "55.666.777/0001-81",
"last_analysis": {
"analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
"analysis_number": 2,
"status": "pending_documents",
"analysis_related_parties": [
{
"analysis_related_party_key": "5cdcc13b-c67d-45f3-aa66-36cb4f178b59",
"document_number": "969.698.790-03",
"name": "Roberto Carlos",
"documents": []
},
{
"analysis_related_party_key": "d4c75c93-4aa9-4567-89c4-b49334927721",
"document_number": "123.456.789-09",
"name": "Natália Nascimento",
"documents": []
},
{
"analysis_related_party_key": "8a3e2f61-0c4b-4d7e-9f15-2b6c7d8e9a01",
"passport_number": "C01X00T47",
"name": "Maria Vitoria",
"documents": []
}
],
"documents": [
{
"document_key": "994621ac-7d3f-4f6b-90c5-74a4d8c5d017",
"document_type": "social_contract",
"status": "valid"
}
]
}
}
CampoTipoDescriçãoCaracteres
assignor_registry_keystringIdentificador do cadastro.36
statusstringStatus do cadastro.Ver Enumeradores de status do cadastro.
namestringNome do Cedente.1 a 255
document_numberstringDocumento do Cedente.14 a 18
last_analysisobjectObjeto de análise.Ver Definição de Análise.
informação

É importante armazenar a analysis_key e as analysis_related_party_key que serão utilizadas para envio de documentos do cedente e das partes relacionadas.


Atenção!

Ao atualizar o cadastro de um cedente, uma nova análise cadastral é gerada, resultando em uma nova analysis_key e novas analysis_related_party_key. O cadastro só será efetivamente atualizado após a aprovação desta nova análise.

Importante!

Não é possível atualizar dados essenciais do cedente como Número do Documento, Tipo de Pessoa. Os dados cadastrais passíveis de alteração incluem:

  • Nome/Razão Social;
  • Email;
  • Endereço;
  • Telefone;
  • Faturamento;
  • Participante do SFN;
  • Partes Relacionadas (inclusão e alteração de vigentes);
  • Avalistas (inclusão e alteração de vigentes);

Erros​

StatusCódigoQuando acontece
404ASR000004Cedente não encontrado para o assignor_registry_key informado. Verificar se o assignor_registry_key existe (ou, para gestora e consultoria, se o cadastro pertence à sua integração).
400ASR000100Campo enviado não pode ser atualizado em uma filial: name, related_parties e guarantors são sempre os da matriz. Para alterá-los, atualize o cadastro da matriz.
400ASR000128Uma filial vinculada a esta matriz está com análise em andamento. Aguarde a conclusão da análise da filial e reenvie a atualização da matriz.
400ASR000056Pessoa física não pode ser participante do Sistema Financeiro Nacional. Para cedentes pessoa física, enviar is_in_national_financial_system=false ou omitir o campo.
400ASR000054Cedente pessoa jurídica deve ter pelo menos 1 parte relacionada. Garantir que related_parties (após a atualização) tenha ao menos um item para cedentes pessoa jurídica.
400ASR000057Cedente pessoa jurídica deve ter pelo menos 1 representante assinante. Garantir que ao menos uma parte relacionada tenha is_representative=true.
400ASR000011Número de documento de parte relacionada duplicado. Cada document_number em related_parties deve ser único.
400ASR000041Email obrigatório para representante. Para partes relacionadas com is_representative=true, informar email.
400ASR000058Pessoa estrangeira sem CPF não pode ser assinante. Estrangeiros sem document_number (CPF) não podem ter is_representative=true.
400ASR000078Número de documento de avalista duplicado. Cada avalista em guarantors deve ter document_number único.
400ASR000079Avalista pessoa física não aceita representante. Para person_type=natural_person, só é aceito o cônjuge: related_party_type: spouse.
400ASR000080Documento de representante de avalista duplicado. Cada representante em guarantor_representatives deve ter document_number único.
400ASR000091Avalista pessoa jurídica deve ter pelo menos um representante. Para person_type=legal_person, enviar pelo menos um item em guarantor_representatives.

Erros de autenticação, permissão e host: veja Erros da API.