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.
É 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.
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
| Perfil | Host | Permissão exigida |
|---|---|---|
| Gestora | manager-api | Escrita |
| Consultoria | consultant-api | Cadastrar Cedente |
| Cedente | assignor-api | Escrita |
URL base de cada host: Ambientes (Hosts).
Request
{
"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
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
name | string | Nome/razão social do cedente. | 1 a 255 |
annual_revenues | integer | Declaração de faturamento anual do cedente, em inteiros. | Mínimo de 1 |
email | string | Endereço de e-mail do cedente. | 1 a 255 |
is_in_national_financial_system | boolean | Indicador se o cedente é integrante do SFN. | - |
phone | object | Objeto referenciando as informações do telefone do cedente. | Ver Definição de Telefone. |
address | object | Objeto referenciando as informações do endereço do cedente. | Ver Definição de Endereço. |
related_parties | array | Lista de partes relacionadas da empresa. | Ver Definição de Parte Relacionada. |
minimum_required_signers | integer | Quantidade mínima de representantes que precisam assinar pelo cedente. | Mínimo de 1 |
guarantors | array | Lista 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
{
"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"
}
]
}
}
| Campo | Tipo | Descrição | Caracteres |
|---|---|---|---|
assignor_registry_key | string | Identificador do cadastro. | 36 |
status | string | Status do cadastro. | Ver Enumeradores de status do cadastro. |
name | string | Nome do Cedente. | 1 a 255 |
document_number | string | Documento do Cedente. | 14 a 18 |
last_analysis | object | Objeto de análise. | Ver Definição de Análise. |
É 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.
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.
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
| Status | Código | Quando acontece |
|---|---|---|
| 404 | ASR000004 | Cedente 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). |
| 400 | ASR000100 | Campo 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. |
| 400 | ASR000128 | Uma 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. |
| 400 | ASR000056 | Pessoa 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. |
| 400 | ASR000054 | Cedente 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. |
| 400 | ASR000057 | Cedente pessoa jurídica deve ter pelo menos 1 representante assinante. Garantir que ao menos uma parte relacionada tenha is_representative=true. |
| 400 | ASR000011 | Número de documento de parte relacionada duplicado. Cada document_number em related_parties deve ser único. |
| 400 | ASR000041 | Email obrigatório para representante. Para partes relacionadas com is_representative=true, informar email. |
| 400 | ASR000058 | Pessoa estrangeira sem CPF não pode ser assinante. Estrangeiros sem document_number (CPF) não podem ter is_representative=true. |
| 400 | ASR000078 | Número de documento de avalista duplicado. Cada avalista em guarantors deve ter document_number único. |
| 400 | ASR000079 | Avalista pessoa física não aceita representante. Para person_type=natural_person, só é aceito o cônjuge: related_party_type: spouse. |
| 400 | ASR000080 | Documento de representante de avalista duplicado. Cada representante em guarantor_representatives deve ter document_number único. |
| 400 | ASR000091 | Avalista 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.