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.

---

Cadastro de Cedente

Request

ENDPOINT

/assignor_registry/assignor_registry

MÉTODO

POST

Request Body

{
  "name": "QI DTVM",
  "document_number": "67.987.787/0001-06",
  "person_type": "legal_person",
  "email": "qidtvm@qitech.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": "883.512.866-80",
      "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": "802.834.257-41",
      "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
    }
  ]
}

---

Definição do Cedente

Campo	Tipo	Descrição	Caracteres
name *	string	Nome do cedente.	1 a 255
document_number *	string	Número de documento do cedente (CNPJ).	14 a 18
annual_revenues *	number	Declaração de faturamento anual do cedente.	-
person_type *	string	Tipo de pessoa (física ou jurídica) do cedente.	1 a 255
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.
accounts *	array	Lista de contas de desembolso do cedente.	Ver Definição de Parte Relacionada.

*Campos obrigatórios.

Response

STATUS

201

Response Body

{
  "assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
  "status": "pending_registry",
  "name": "QI DTVM",
  "document_number": "67.987.787/0001-06",
  "last_analysis": {
    "analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
    "analysis_number": 1,
	  "status": "pending_documents",
    "analysis_related_parties": [
      {
        "analysis_related_party_key": "5cdcc13b-c67d-45f3-aa66-36cb4f178b59",
        "document_number": "802.834.257-41",
        "name": "Roberto Carlos",
        "documents": []
      },
      {
        "analysis_related_party_key": "d4c75c93-4aa9-4567-89c4-b49334927721",
        "document_number": "883.512.866-80",
        "name": "Natália Nascimento",
        "documents": []
      },
      {
        "analysis_related_party_key": "d4c75c93-4aa9-4567-89c4-b49334927721",
        "passport_number": "C01X00T47",
        "name": "Maria Vitoria",
        "documents": []
      }
    ],
    "documents": [
      {
        "document_key": "994621ac-7d3f-4f6b-90c5-74a4d8c5d017",
        "document_type": "social_contract",
        "status": "valid",
      }
    ],
    "analysis_data": {}
  }
}

Campo	Tipo	Descrição	Caracteres
assignor_registry_key	string	Identificador do cadastro.	36
status	enumerador	Status do cadastro.	14 a 18
name	string	Nome do Cedente.	1 a 255
document_number	string	Documento do Cedente.	14 a 18
last_analysis	string	Objeto de análise.	Ver Definição de Análise.

info

É 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.

info

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

---

Definições

Definição de Endereço

Campo	Tipo	Descrição	Caracteres
street *	string	Nome da rua.	1 a 255
number *	string	Número do endereço.	1 a 4
neighborhood *	string	Bairro.	1 a 255
city *	string	Cidade.	1 a 255
uf *	string	Sigla do estado.	2
complement	string	Complemento do endereço.	1 a 255
postal_code *	string	Código postal.	9 (formato: XXXXX-XXX)
country *	string	País (sigla).	3, de acordo com a ISO 3166-1 alpha-3

*Campos obrigatórios.

---

Definição de Telefone

Campo	Tipo	Descrição	Caracteres
international_dial_code *	string	Código internacional de discagem.	1 a 3
area_code *	string	Código de área.	2
number *	string	Número de telefone.	8 a 9

*Campos obrigatórios.

---

Definição de Parte Relacionada

Campo	Tipo	Descrição	Caracteres
name *	string	Nome da parte relacionada.	1 a 255
document_number **	string	Número de documento do beneficiário (CPF).	14 a 18
passport_number **	string	Número de documento do beneficiário estrangeiro.	8 a 9
related_party_type *	enumerador	Tipo de vínculo da parte relacionada.	Ver Enumeradores de tipo de parte relacionada
nationality *	string	País de origem do beneficiário.	3, de acordo com a ISO 3166-1 alpha-3
direct_beneficiary *	boolean	Beneficiário diretamente ou indiretamente ligado ao cedente.	1 a 255
is_representative *	boolean	Indicador se a parte relacionada é representante assinante do cedente.	1 a 255
company_registry_number ***	string	Caso não seja diretamente ligado ao cedente, à qual companhia o mesmo está ligado.	1 a 255
company_country ***	string	País onde a companhia-elo entre o beneficiário e o cedente está registrada.	3, de acordo com a ISO 3166-1 alpha-3
email ****	string	Endereço de e-mail do representante.	1 a 255
phone ****	object	Objeto referenciando as informações do telefone do representante.	Ver Definição de Telefone.

*Campos obrigatórios.

**document_number obrigatório para brasileiros, e passport_number para estrangeiros.

***Campos obrigatórios caso a parte relacionada não seja beneficiário diretamente ligada ao cedente.

****Campos exigidos apenas para representantes assinantes.

---

Definição de Análise

Campo	Tipo	Descrição	Caracteres
analysis_key *	string	Identificador da análise.	36
analysis_number *	integer	Número sequencial da análise.	-
status *	string	Status da análise.	Ver Enumeradores de status de análise.
analysis_related_parties *	enumerador	Partes Relacionadas da análise.	Ver Definição de Partes Relacionadas de Análise.
documents *	string	Documentos da anáise.	Ver Definição de Documentos de análise.
analysis_data *	object	Payload da reqest que originou a análise.	-

*Campos obrigatórios.

---

Definição de Partes Relacionadas de análise

Campo	Tipo	Descrição	Caracteres
analysis_related_party_key *	string	Identificador da parte relacionada.	36
document_number *	string	Número de documento da parte relacionada.	14 a 18
name	string	Nome do beneficiário.	1 a 255
documents *	enumerador	Documentos da anáise da parte relacionada.	Ver Definição de Documentos de análise.

*Campos obrigatórios.

---

Definição de Documentos

Campo	Tipo	Descrição	Caracteres
document_key *	string	Identificador do documento.	36
document_type *	string	Tipo do documento.	Ver Enumeradores de tipo de documento.
status	string	Status do documento.	-

*Campos obrigatórios.

---

Definição de Conta

Campo	Tipo	Descrição	Caracteres
account_branch *	string	Agência da conta do cedente.	4
account_number *	string	Número da conta do cedente.	3 - 20
account_digit *	string	Dígito da conta do cedente.	1
financial_institution_code *	string	Código do banco da conta do cedente.	3
account_type *	string	Tipo de conta.	Ver Enumeradores de tipo de conta.
default_account *	boolean	Conta padrão de desembolso.	-

*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.

---

Enumeradores

Assignor Registry Status

Enumerador	Descrição
pending_registry	Pendente Registro
registered	Registrado

---

Analysis Status

Enumerador	Descrição
pending_documents	Pendente Documentos
sent_to_analysis	Enviado para Análise
in_manual_analysis	Em Análise Manual
approved	Aprovado
reproved	Reprovado

---

Related Party Type

Enumerador	Descrição
president	Presidente
partner	Sócio
administrator	Administrador
director	Diretor
manager	Gestor
attorney	Procurador

---

Document Status

Enumerador	Descrição
created	Criado
valid	Válido
invalid	Inválido

---

Document Type

Enumerador	Descrição
cnh	CNH.
rg_back	RG parte traseira.
rg_front	RG parte frontal.
passport	Passaporte - exclusivo para estrangeiros.
social_contract	Contrato/Estatuto Social.
commercial_board_certificate	Certidão Simplidicada da Junta Comercial.
board_election_record	Ata de Eleição da Diretoria Vigente.
power_of_attorney	Procuração - obrigatório caso o representante seja um procurador.

---

Account Type

Enumerador	Descrição
checking_account	Conta Corrente
saving_account	Conta Poupança

---