Pular para o conteúdo principal

Envio de cadastro

Na primeira etapa de cadastro do cedente, são informados os dados do mesmo, conforme definidos abaixo. Vale relembrar que, apenas enviar os dados, não cria um cedente operacional, o mesmo só será ativado após a conclusão bem sucedida das análises dos documentos do mesmo.

Obrigatoriamente para pessoas jurídicas, e opcionalmente em pessoas físicas, é possível cadastrar partes relacionadas, que representam os beneficiários finais ligados ao cedente.

Informação

Um beneficiário final é definido como o indivíduo, ou grupo de indivíduos, com relevância significativa na empresa ou conglomerado, com poder decisório ou participação significativa na grade societária. Para fins de cadastro, devem ser levados em conta quaisquer associados com participação superior a 15% na companhia, ou no conglomerado do qual fazem parte, ou, caso não haja participação tão relevante, os três maiores em ordem decrescente.

Caso o beneficiário relevante seja uma outra empresa, deve-se atribuir os seus beneficiários finais, indicados como beneficiários indiretos. Além disso, são considerados partes relacionadas quaisquer procuradores, gestores, e diretores envolvidos na operação, que serão os representantes assinantes do cedente na mesma.

Os representantes assinantes são partes relacionadas responsáveis por acompanhar e assinar os documentos direcionados ao cedente pelo nosso sistema, sendo necessária comprovação do vínculo, no caso de empresas, por meio do quadro societário, ou de diretores, ou com uma procuração. Não é possível cadastrar uma parte relacionada que não seja um procurador para um cedente pessoa física. Além disso, é necessário indicar se a parte relacionada considerada beneficiário final tem vínculo direto ou indireto com o cedente.

Sandbox

Em sandbox, o resultado da análise depende do primeiro dígito do documento do cedente (document_number): começando com 1, reprovação automática; começando com 8, a análise vai para validação manual (pending_internal_validation); os demais são aprovados automaticamente.


Cadastro de Cedente​

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
MÉTODO
POST
Request Body
{
"name": "Cedente Exemplo LTDA",
"document_number": "55.666.777/0001-81",
"person_type": "legal_person",
"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",
"address": {
"street": "Rua Maria Carolina",
"number": "624",
"neighborhood": "Jardim Paulistano",
"city": "São Paulo",
"postal_code": "01445-000",
"uf": "SP",
"country": "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": false,
"email": "roberto.carlos@yopmail.com",
"phone": {
"international_dial_code": "+64",
"area_code": "11",
"number": "936360268"
}
}
],
"accounts": [
{
"account_branch": "0001",
"account_number": "7912584",
"account_digit": "1",
"financial_institution_code": "329",
"account_type": "checking_account",
"default_account": true
},
{
"account_branch": "0001",
"account_number": "8758931",
"account_digit": "5",
"financial_institution_code": "329",
"account_type": "escrow_account",
"default_account": false
}
],
"guarantors": [
{
"name": "Avalista PF",
"address": {
"street": "Rua Maria Carolina",
"number": "624",
"neighborhood": "Jardim Paulistano",
"city": "São Paulo",
"postal_code": "01445-000",
"uf": "SP",
"country": "BRA"
},
"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",
"address": {
"street": "Rua Maria Carolina",
"number": "624",
"neighborhood": "Jardim Paulistano",
"city": "São Paulo",
"postal_code": "01445-000",
"uf": "SP",
"country": "BRA"
}
}
]
}
]
}

Definição do Cedente​

CampoTipoDescriçãoCaracteres
name *stringNome do cedente.1 a 255
document_number *stringCPF ou CNPJ do cedente, formatado (000.000.000-00 ou 00.000.000/0000-00).14 a 18
annual_revenues *numberDeclaração de faturamento anual do cedente, em inteiros.Mínimo de 1
person_type *stringnatural_person (física) ou legal_person (jurídica).-
email *stringEndereço de e-mail do cedente.1 a 255
is_in_national_financial_system *booleanIndicador se o cedente é integrante do SFN.-
phoneobjectObjeto referenciando as informações do telefone do cedente.Ver Definição de Telefone.
address *objectObjeto referenciando as informações do endereço do cedente.Ver Definição de Endereço.
related_parties **arrayLista de partes relacionadas da empresa.Ver Definição de Parte Relacionada.
accountsarrayLista de contas de desembolso do cedente. Sem conta, não é possível propor um contrato de cessão.Ver Definição de Conta.
guarantorsarrayLista de avalistas do cedente.Ver Definição de Avalista.
minimum_required_signersintegerQuantidade mínima de representantes que precisam assinar pelo cedente.Mínimo de 1

*Campos obrigatórios.

**Obrigatório para pessoa jurídica, com ao menos um representante assinante (is_representative: true).

Response​

STATUS
201
Response Body
{
"assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
"status": "pending_registry",
"name": "Cedente Exemplo LTDA",
"document_number": "55.666.777/0001-81",
"related_parties": [
{
"related_party_key": "0b6f6a52-6c1e-4f4e-9d2a-1f3c5e7a9b10",
"name": "Natália Nascimento",
"document_number": "123.456.789-09",
"direct_beneficiary": true,
"is_representative": true,
"related_party_type": "attorney"
},
{
"related_party_key": "3e9d1c7b-2a4f-4b8e-8c6d-5f7a9b1c3d20",
"name": "Maria Vitoria",
"document_number": null,
"direct_beneficiary": true,
"is_representative": false,
"related_party_type": "president",
"passport_number": "C01X00T47"
},
{
"related_party_key": "7a2c4e6f-8b0d-4f1a-9c3e-5d7f9a1b3c30",
"name": "Roberto Carlos",
"document_number": "969.698.790-03",
"direct_beneficiary": false,
"is_representative": false,
"related_party_type": "director"
}
],
"last_analysis": {
"analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
"analysis_number": 1,
"status": "pending_documents",
"analysis_datetime": "2026-01-15T14:32:10Z",
"analysis_related_parties": [
{
"analysis_related_party_key": "5cdcc13b-c67d-45f3-aa66-36cb4f178b59",
"name": "Roberto Carlos",
"document_number": "969.698.790-03",
"analysis_roles": [{ "related_party_type": "director" }],
"documents": []
},
{
"analysis_related_party_key": "d4c75c93-4aa9-4567-89c4-b49334927721",
"name": "Natália Nascimento",
"document_number": "123.456.789-09",
"analysis_roles": [{ "related_party_type": "attorney" }],
"documents": []
},
{
"analysis_related_party_key": "8a3e2f61-0c4b-4d7e-9f15-2b6c7d8e9a01",
"name": "Maria Vitoria",
"document_number": null,
"analysis_roles": [{ "related_party_type": "president" }],
"documents": [],
"passport_number": "C01X00T47"
},
{
"analysis_related_party_key": "1f4b6d8a-3c5e-4a7b-9d1f-2e4a6c8b0d40",
"name": "Avalista PF",
"document_number": "222.333.444-05",
"analysis_roles": [{ "related_party_type": "guarantor" }],
"documents": []
},
{
"analysis_related_party_key": "9c1e3a5b-7d9f-4b2c-8e4a-6f8b0c2d4e50",
"name": "Avalista PJ",
"document_number": "22.333.444/0001-81",
"analysis_roles": [{ "related_party_type": "guarantor" }],
"documents": []
},
{
"analysis_related_party_key": "4d6f8b0c-2e4a-4c6d-8f0b-1a3c5e7d9f60",
"name": "Assinante do Avalista",
"document_number": "111.444.777-35",
"analysis_roles": [{ "related_party_type": "guarantor_representative" }],
"documents": []
}
],
"documents": [],
"annotations": [],
"last_updated": "2026-01-15T14:32:10Z",
"analysis_origin_type": "assignor_registry",
"reproval_reason": null,
"reproval_details": null
}
}
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
related_partiesarrayPartes relacionadas do cedente, com related_party_key, name, document_number, direct_beneficiary, is_representative, related_party_type e, para estrangeiros, passport_number.-
last_analysisobjectObjeto de análise.Ver Definição de Análise.
informação

É importante armazenar a assignor_registry_key pois ela será utilizada em diversos outros processos, assim como a analysis_key e as analysis_related_party_key que serão utilizadas para envio de documentos do cedente e das partes relacionadas.

informação

Na estrutura de análise, um avalista, ou um representante de um avalista, também é representado por um analysis_related_party. Importante notar que o mesmo é único por document_number, logo, caso a mesma pessoa seja avalista e parte relacionada do cedente, por exemplo, gerará apenas um analysis_related_party, com uma analysis_related_party_key, que servirá tanto para a parte relacionada, quanto para o avalista.

informação

Os representantes de pessoa física se limitam apenas ao procurador que pode assinar por tal.


Definições​

Definição de Endereço​

CampoTipoDescriçãoCaracteres
street *stringNome da rua.1 a 255
number *stringNúmero do endereço.1 a 4
neighborhood *stringBairro.1 a 255
city *stringCidade.1 a 255
uf *stringSigla do estado.2
complementstringComplemento do endereço.1 a 255
postal_code *stringCódigo postal.9 (formato: XXXXX-XXX)
country *stringPaís (sigla).3, de acordo com a ISO 3166-1 alpha-3

*Campos obrigatórios.


Definição de Telefone​

CampoTipoDescriçãoCaracteres
international_dial_code *stringCódigo internacional de discagem.1 a 3
area_code *stringCódigo de área.2
number *stringNúmero de telefone.8 a 9

*Campos obrigatórios.


Definição de Parte Relacionada​

CampoTipoDescriçãoCaracteres
name *stringNome da parte relacionada.1 a 255
document_number **stringNúmero de documento do beneficiário (CPF).14 a 18
passport_number **stringNúmero de documento do beneficiário estrangeiro.8 a 9
related_party_type *stringTipo de vínculo da parte relacionada.Ver Enumeradores de tipo de parte relacionada
nationality *stringPaís de origem do beneficiário.3, de acordo com a ISO 3166-1 alpha-3
direct_beneficiary *booleanBeneficiário diretamente ou indiretamente ligado ao cedente.1 a 255
is_representative *booleanIndicador se a parte relacionada é representante assinante do cedente.1 a 255
company_registry_number ***stringCaso não seja diretamente ligado ao cedente, à qual companhia o mesmo está ligado.1 a 255
company_country ***stringPaís onde a companhia-elo entre o beneficiário e o cedente está registrada.3, de acordo com a ISO 3166-1 alpha-3
addressobjectObjeto referenciando as informações do endereço do representante.Ver Definição de Endereço.
email ****stringEndereço de e-mail do representante.1 a 255
phoneobjectObjeto referenciando as informações do telefone do representante. Recomendado para representantes assinantes.Ver Definição de Telefone.
marital_statusstringEstado civil da parte relacionada.Ver Enumeradores de estado civil.
property_systemstringRegime de separação de bens.Ver Enumeradores de regime de separação de bens.
professionstringProfissão da parte relacionada.1 a 255.

*Campos obrigatórios.

**document_number obrigatório para brasileiros, para estrangeiros, caso tenha CPF, é possível utilizar o document_number, caso contrário, pelo menos o passport_number deve ser enviado.

***Campos obrigatórios caso a parte relacionada não seja beneficiário diretamente ligada ao cedente. Caso contrário, não devem ser enviados.

****Campo exigido apenas para representantes assinantes.

informação

Campos não obrigatorios, como marital_status e address, podem ser enviados caso deseje uma qualificação mais completa no contrato mãe de cessão, nas etapas futuras.


Definição de Análise​

CampoTipoDescriçãoCaracteres
analysis_key *stringIdentificador da análise.36
analysis_number *integerNúmero sequencial da análise.-
status *stringStatus da análise.Ver Enumeradores de status de análise.
analysis_related_parties *arrayPartes Relacionadas da análise.Ver Definição de Partes Relacionadas de Análise.
documents *arrayDocumentos da análise.Ver Definição de Documentos de análise.
analysis_datetime *stringData e hora de criação da análise (ISO 8601, UTC).-
annotations *arrayApontamentos da análise.-
last_updated *stringData e hora da última alteração da análise (ISO 8601, UTC).-
analysis_origin_type *stringOrigem da análise. Para cadastros enviados pela API, assignor_registry.-
analysis_dataobjectRequest body que originou a análise. Só vem na consulta da análise; não vem no retorno do cadastro.-
reproval_reasonstringEnumerador com o motivo de rejeição da análise.Ver Enumeradores de motivo de reprovação.
reproval_detailsstringCampo livre com detalhes da rejeição da análise.-

*Campos obrigatórios.


Definição de Partes Relacionadas de análise​

CampoTipoDescriçãoCaracteres
analysis_related_party_key *stringIdentificador da parte relacionada.36
document_number *stringNúmero de documento da parte relacionada.14 a 18
name *stringNome da parte relacionada.1 a 255
passport_numberstringPassaporte, só para estrangeiros que o informaram.-
analysis_roles *arrayPapéis da pessoa na análise, cada um com related_party_type (por exemplo, director, guarantor ou guarantor_representative).-
documents *arrayDocumentos da análise da parte relacionada.Ver Definição de Documentos de análise.

*Campos obrigatórios.


Definição de Documentos​

CampoTipoDescriçãoCaracteres
document_key *stringIdentificador do documento.36
document_type *stringTipo do documento.Ver Enumeradores de tipo de documento.
statusstringStatus do documento.Ver Enumeradores de status de documento.
observationstringObservações enviadas.-

*Campos obrigatórios.


Definição de Conta​

CampoTipoDescriçãoCaracteres
account_branch *stringAgência da conta do cedente.4
account_number *stringNúmero da conta do cedente. Só dígitos.3 - 20
account_digit *stringDígito da conta do cedente.1
financial_institution_code *stringCódigo do banco da conta do cedente.3
account_type *stringTipo de conta.Ver Enumeradores de tipo de conta.
default_account *booleanConta padrão de desembolso.-
descriptionstringDescrição livre da conta.Até 255

*Campos obrigatórios.

Apenas uma conta do cedente pode ser a conta padrão, que será a conta para qual o dinheiro das cessões será enviado caso nenhuma conta alternativa seja indicada. Caso sejam enviadas mais de uma conta padrão, um erro será retornado.

Atenção

Muito cuidado ao preencher os dados da conta. Caso a conta seja inválida, o pagamento da cessão não ocorrerá, e toda a operação será cancelada.


Definição de Avalista​

CampoTipoDescriçãoCaracteres
name *stringNome do Avalista.3 - 255
document_number *stringNúmero de documento do avalista.14 a 18
person_type *stringTipo de pessoa (física ou jurídica) do cedente.-
email *stringEndereço de e-mail do avalista.1 a 255
nationalitystringPaís de origem do avalista.3, de acordo com a ISO 3166-1 alpha-3
phoneobjectObjeto referenciando as informações do telefone do avalista.Ver Definição de Telefone.
addressobjectObjeto referenciando as informações do endereço do avalista.Ver Definição de Endereço.
guarantor_representativesarrayRepresentantes do avalista PJ ou cônjuge do avalista PF.Ver Definição de Representante do Avalista.
marital_statusstringEstado civil do avalista.Ver Enumeradores de estado civil.
property_systemstringRegime de separação de bens.Ver Enumeradores de regime de separação de bens.
professionstringProfissão do avalista.1 a 255.

*Campos obrigatórios.

O campo guarantor_representatives pode ser utilizado para indicar tanto representantes de um avalista pessoa jurídica, quanto, no caso de avalista pessoa física, onde se encontrar necessário, o cônjuge para realização da Outorga Uxória.

Atenção

Tanto o avalista quanto os representantes também serão adicionados à análise gerada, sendo necessário enviar os documentos padrão de acordo com o tipo de pessoa do mesmo. Os mesmos também passam pelo processo de compliance, podendo gerar apontamentos.


Definição de Representante do Avalista​

CampoTipoDescriçãoCaracteres
name *stringNome do Representante.3 - 255
document_number *stringNúmero de documento do representante do avalista - obrigatóriamente pessoa física.14
email *stringEndereço de e-mail do representante do avalista.1 a 255
nationalitystringPaís de origem do representante do avalista.3, de acordo com a ISO 3166-1 alpha-3
addressobjectObjeto referenciando as informações do endereço do representante do avalista.Ver Definição de Endereço.
phoneobjectObjeto referenciando as informações do telefone do representante do avalista.Ver Definição de Telefone.
marital_statusstringEstado civil do representante do avalista.Ver Enumeradores de estado civil.
property_systemstringRegime de separação de bens.Ver Enumeradores de regime de separação de bens.
professionstringProfissão do representante do avalista.1 a 255.
related_party_typestringguarantor_representative (padrão) para representante de avalista PJ; spouse para o cônjuge de avalista PF (outorga uxória).-

Enumeradores​

Assignor Registry Status​

EnumeradorDescrição
createdCriado (transitório)
pending_registryPendente Registro
pending_manual_approvalPendente aprovação manual da QI DTVM
registeredRegistrado
rejectedRejeitado
blockedBloqueado

Analysis Status​

EnumeradorDescrição
createdCriada (transitório)
pending_documentsPendente Documentos
sent_to_analysisEnviado para Análise
pending_internal_validationEm Validação de documentos
in_manual_analysisEm Análise Manual de Compliance
in_risk_analysisEm Análise de Risco
approvedAprovado
reprovedReprovado
canceledCancelado

EnumeradorDescrição
presidentPresidente
partnerSócio
administratorAdministrador
directorDiretor
managerGestor
attorneyProcurador
spouseCônjuge
legal_representativeRepresentante legal

Document Status​

EnumeradorDescrição
createdCriado
validVálido
invalidInválido
canceledCancelado
acceptedAceito, porém não validado
inconclusiveValidação inconclusiva

Document Type​

EnumeradorDescrição
cnhCNH.
rg_backRG parte traseira.
rg_frontRG parte frontal.
passportPassaporte - exclusivo para estrangeiros.
national_migration_registryRegistro Nacional de Migração.
national_registry_of_foreignersRegistro Nacional de Estrangeiros.
cin_digitalCarteira de Identidade Nacional (Digital).
social_contractContrato/Estatuto Social.
cnpj_cardCartão CNPJ.
commercial_board_certificateCertidão Simplificada da Junta Comercial.
board_election_recordAta de Eleição da Diretoria Vigente.
power_of_attorneyProcuração - obrigatório caso o representante seja um procurador.
marital_power_of_attorneyProcuração Uxória - disponível apenas para cônjuges.
compliance_statementParecer de Compliance.
financial_statementDemonstração Financeira.
credit_reportAta/Parecer de Crédito.
manager_statementParecer/Ficha do Gestor.
visit_reportRelatório de Visita.
proof_of_residenceComprovante de Residência.
credit_agency_consulationConsulta aos órgãos de Proteção de Crédito.
annual_revenues_declarationDeclaração de Faturamento.
financial_institutions_declarationDeclaração de Relacionamento Bancário.
additional_documentDocumento adicional - livre.

Account Type​

EnumeradorDescrição
checking_accountConta Corrente
saving_accountConta Poupança
escrow_accountConta Vinculada (escrow)

Analysis Reproval Reason​

EnumDescription
assignor_updateAnálise cancelada devido à atualização cadastral posterior
insuficient_documentsDocumentação mínima para comprovação de poderes não enviada
compliance_reprovalReprovação de vínculo por análise do time de compliance
unidentified_related_partiesParte relacionada enviada, porém vinculo não comprovado
invalid_documentsDocumentação inválida/expirada
missing_related_partiesParte relacionada obrigatória não enviada
risk_analysis_reprovalReprovação na análise de risco

Marital Status​

EnumDescription
singleSolteiro(a)
marriedCasado(a)
widowerViúvo(a)
divorcedDivorciado(a)
separatedSeparado(a)
stable_unionEm União Estável

Property System​

EnumDescrição
total_communion_of_goodsComunhão Total de Bens
partial_communion_of_goodsComunhão Parcial de Bens
total_separation_of_goodsSeparação Total de Bens
final_participation_of_acquisitionsParticipação Final nos Aquestos
compulsory_separation_of_goodsSeparação Obrigatória de Bens

Erros​

StatusCódigoQuando acontece
409ASR000032Esse agente já cadastrou esse cedente. O document_number já possui um cadastro; utilize o fluxo de atualização de cadastro.
400ASR000054Cedente pessoa jurídica deve ter pelo menos 1 parte relacionada. Incluir ao menos uma parte relacionada em related_parties.
400ASR000056Pessoa física não pode ser participante do Sistema Financeiro Nacional. Para person_type=natural_person, enviar is_in_national_financial_system=false.
400ASR000057Cedente pessoa jurídica deve ter pelo menos 1 representante assinante. Garantir que ao menos uma parte relacionada possua is_representative=true.
400ASR000011Número de documento de parte relacionada duplicado. Cada document_number em related_parties deve ser único.
400ASR000041Parte relacionada com is_representative=true sem email. Informe o e-mail do representante.
400ASR000058Pessoa estrangeira sem CPF não pode ser assinante. Estrangeiros sem document_number (CPF) não podem ter is_representative=true.
404ASR000071Instituição financeira não encontrada. Validar o financial_institution_code (código bancário) informado para a conta.
400ASR000087Informação de conta deve conter apenas números. Enviar account_branch, account_number e account_digit apenas com dígitos.
400ASR000081Mais de uma conta padrão foi enviada. Apenas uma conta deve ter default_account=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.