Pular para o conteúdo principal

Envio de documentos

Após o envio do cadastro do cedente, devem ser enviados os documentos relacionados ao mesmo. Para isso, é utilizada a estrutura de análise de documentos, onde, tanto na criação quanto na alteração, uma análise é gerada e os devidos documentos devem ser enviados. Cabe à gestora averiguar a operação do cedente que irá operar com os fundos geridos, e, futuramente, na etapa de criação de contrato mãe, será necessário assinar uma declaração da gestora, atestando que a mesma cumpriu toda a análise requerida pelo manual de Regras e Procedimentos de Administração e Gestão de Recursos de Terceiros, a qual encarrega à gestora tanto a análise quanto a atualização do cadastro do cedente.

informação

Caso se trate de uma atualização, os documentos da última análise aprovada são automaticamente reaproveitados, podendo ser substituídos por novos.

Documentos só são aceitos enquanto a análise estiver em pending_documents. Pela gestora e pela consultoria, o envio é restrito ao agente dono do cadastro (quem o criou); para outro agente, a API responde ASR000004.

Enviou o documento errado?​

Reenvie o documento correto com o mesmo document_type, enquanto a análise ainda estiver em pending_documents. O documento anterior daquele tipo (valid ou accepted) passa automaticamente para canceled e o novo o substitui. Não existe chamada de cancelamento.

A exceção é additional_document: documentos adicionais se acumulam e não são substituídos. Se um documento adicional foi enviado por engano, fale com o time de integração em integracao.dtvm@qitech.com.br antes de disparar a análise.

Depois do Envio para Análise, a análise não aceita mais documentos (ASR000039). Para corrigir, gere uma nova análise pela Atualização de Cadastro.


Documentos do 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/ASSIGNOR_REGISTRY_KEY/analysis/ANALYSIS_KEY/document
MÉTODO
POST
Request Body
{
"document_type":"social_contract",
"document_b64": "JVBERi0xLjQK...",
"observation":"CONTRATO SOCIAL ATUALIZADO"
}

Objeto de Documento​

CampoTipoDescriçãoCaracteres
document_type *stringTipo do documento.Ver Tipos de Documento.
document_b64 *stringArquivo PDF codificado em Base64.-
observationstringCampo livre para descrever arquivos enviados.1 - 255

*Campos obrigatórios.

Response​

STATUS
201
Response Body
{
"document_key": "8e515a17-8b4d-49a3-aed6-47c9574e426a",
"document_type": "social_contract",
"status": "valid",
"observation": "CONTRATO SOCIAL ATUALIZADO",
"reference_date": null
}
informação

Em caso de atualização cadastral, o envio de documentos específicos do cedente na análise será necessário somente quando houver alguma atualização nas informações que sejam específicas do cedente.

Erros​

StatusCódigoQuando acontece
404ASR000004Cedente não encontrado para o assignor_registry_key informado (ou, para gestora e consultoria, o cadastro não pertence à sua integração). Verificar se o assignor_registry_key está correto.
404ASR000033Análise não encontrada para o analysis_key informado. Verificar se o analysis_key está correto.
400ASR000039O status atual da análise não aceita novos documentos. Documentos só podem ser anexados quando a análise estiver em pending_documents. Para reenviar após análise iniciada — ou se a análise tiver sido cancelada por inatividade (canceled) — gere uma nova análise via Atualização de Cadastro.
400ASR000005Formato de arquivo inválido. Enviar document_b64 como string em base64 válida.
400ASR000060O arquivo enviado não é um PDF válido. O conteúdo decodificado de document_b64 deve ser um PDF.
400ASR000059Tamanho do arquivo excede o limite. Reduzir o tamanho do PDF antes de enviar (limite informado na mensagem do erro).
400ASR000061Tipo de documento inválido para o cedente. Usar um document_type compatível com o tipo de pessoa do cedente (ver tabela Documentos padrão do cedente/avalista).

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

Documentos das partes relacionadas​

Disponível em
PerfilHostPermissão exigida
Gestoramanager-apiEscrita
Consultoriaconsultant-apiLer Cedentes
Cedenteassignor-apiEscrita

URL base de cada host: Ambientes (Hosts).

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY/analysis/ANALYSIS_KEY/related_party/ANALYSIS_RELATED_PARTY_KEY/document
MÉTODO
POST
Request Body
{
"document_type":"cnh",
"document_b64": "JVBERi0xLjQK...",
"observation":"CNH Válida"
}

Response​

STATUS
201
Response Body
{
"document_key": "afe8532a-4b0b-4e63-8d16-5084b2681752",
"status": "valid",
"document_type": "cnh",
"observation": "CNH Válida"
}
informação

Em caso de atualização cadastral, o envio de documentos das partes relacionadas na análise será necessário somente quando houver alguma inclusão ou atualização de partes relacionadas do cedente.

Atenção!

Caso um documento seja enviado com o tipo errado, ou com má qualidade ele pode retornar com o status accepted, indicando que a qualidade do mesmo está duvidosa, ou até invalid, assim sendo necessário reenviá-lo corretamente — veja Enviou o documento errado?.

Erros​

StatusCódigoQuando acontece
404ASR000004Cedente não encontrado para o assignor_registry_key informado (ou, para gestora e consultoria, o cadastro não pertence à sua integração). Verificar se o assignor_registry_key está correto.
404ASR000033Análise não encontrada para o analysis_key informado. Verificar se o analysis_key está correto.
404ASR000035Parte relacionada da análise não encontrada para o analysis_related_party_key informado. Verificar se o analysis_related_party_key retornado na criação da análise está correto.
400ASR000039O status atual da análise não aceita novos documentos. Documentos só podem ser anexados quando a análise estiver em pending_documents; depois disso, gere uma nova análise via Atualização de Cadastro.
400ASR000005Formato de arquivo inválido. Enviar document_b64 como string em base64 válida.
400ASR000060O arquivo enviado não é um PDF válido. O conteúdo decodificado de document_b64 deve ser um PDF.
400ASR000059Tamanho do arquivo excede o limite. Reduzir o tamanho do PDF antes de enviar (limite informado na mensagem do erro).
400ASR000062Tipo de documento inválido para a parte relacionada. Usar um document_type compatível com o tipo de pessoa da parte relacionada (ver tabela Documentos padrão das partes relacionadas/representantes).

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


Documentos padrão do cedente/avalista​

Tipo de Pessoadocument_typeDescriçãoObrigatoriedade
Pessoa FísicacnhCNH (Carteira Nacional de Habilitação)*
Pessoa Físicacin_digitalCarteira de Identidade Nacional (Digital)*
Pessoa Físicarg_backRG (Carteira de Identidade) - Verso*
Pessoa Físicarg_frontRG (Carteira de Identidade) - Frente*
Pessoa Jurídicasocial_contractContrato SocialSempre
Pessoa Jurídicacommercial_board_certificateCertidão Simplificada da Junta ComercialOpcional, entretanto obrigatório para contratos sociais com data superior a 3 anos
Pessoa Jurídicaboard_election_recordEleição da diretoria - se aplicávelNecessário para comprovação de vínculo

*Para quaisquer pessoas físicas, é necessário apenas um dentre RG frente e verso, CNH e Carteira de Identidade Nacional.

Documentos padrão das partes relacionadas/representantes​

Tipo de Pessoadocument_typeDescriçãoObrigatoriedade
Pessoa FísicacnhCNH (Carteira Nacional de Habilitação)*
Pessoa Físicacin_digitalCarteira de Identidade Nacional (Digital)*
Pessoa Físicarg_backRG (Carteira de Identidade) - Verso*
Pessoa Físicarg_frontRG (Carteira de Identidade) - Frente*
Pessoa Físicapower_of_attorneyProcuração PF ou PJ - Obrigatório caso representante seja um procuradorNecessário para comprovação de vínculo

*Para quaisquer pessoas físicas, é necessário apenas um dentre RG frente e verso, CNH e Carteira de Identidade Nacional.

Atenção

Alguns tipos de documentos passam por uma ferramenta de OCR para extração e verificação dos dados. Deve-se sempre atentar ao retorno do envio de documento, que retorna de forma síncrona a validação - valid/accepted/invalid do OCR.

Tipos de Documento​

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.

Document Status​

EnumeradorDescrição
createdCriado
validVálido
invalidInválido
canceledCancelado (substituído por um novo envio do mesmo tipo)
acceptedAceito, porém não validado
inconclusiveValidação inconclusiva