跳到主要内容

Envio de Documentos e Formalização

Envio dos dados complementares exigidos pela IN 138 do INSS e formalização da operação (assinatura da CCB). Depois da formalização, a operação entra na fila de averbação.

Envio de documentos

É obrigatório o envio (segundo IN 138 do INSS) dos dados complementares do contrato.

Os documentos devem ser enviados através do endpoint de upload de documentos e devem seguir a seguinte formatação:

ValidaçõesValores
FormatoJPEG
Tamanho mínimo250 x 250 px
Tamanho máximo2 MB
Atenção

Contratos que tiverem documentos vinculados que não respeitam as regras de tamanho mínimo ou máximo serão cancelados permanentemente.

Após o upload dos documentos, as chaves dos documentos enviados devem ser informadas no payload de criação da operação ou após, através do seguinte endpoint:

ENDPOINT
/debt/DEBT-KEY/related_party/RELATED-PARTY-KEY/attached_document
MÉTODO
POST
Testar no Playground
Request Body
{
"document_identification": "2893fc74-88fd-4cc9-a5c6-8a63d9d00f41",
"document_identification_back": "e881ddf4-bc9a-48e0-9555-cac979f65431",
"selfie": "ca37979e-6f11-4465-bf3b-69cd8307549c"
}
Informação

A related_party_key é retornada na response da criação de dívida dentro do objeto borrower

Formalização da operação

Após o input dos documentos a operação pode seguir para formalização.

No caso de assinatura por parte do representante legal, no campo "data.contract.signers[i]" serão retornados os dados do representante legal, e o valor do objeto "data.contract.signers[i].signer_role" será "issuer_legal_representative".

No payload de assinatura devem conter os campos obrigatórios relacionados aos documentos enviados no item 5. Os campos obrigatórios são os seguintes: ip_address e signature_datetime.

Request

ENDPOINT
/debt/DEBT-KEY/signed
MÉTODO
POST
Testar no Playground
Request Body
{
...,
"ip_address": "192.168.0.0",
"signature_datetime": "2020-03-20T14:28:23.382748Z",
"similarity_score": 0.98000,
"biometry_analysis_reference": "serpro",
"type": "data-signature"
}
Atenção

O payload de envio da assinatura varia de acordo com o processo de formalização do parceiro e deve ser alinhado com o time de integração da QI Tech.

Enumeradores Biometry Analysis Reference

EnumeradorDescrição
serproUtilizado quando o similarity_score for retornado através de consulta realizada na base de documentos com foto do Detran (Serviço prestado através da Serpro)
tseUtilizado quando o similarity_score for retornado através de consulta realizada na base de documentos com foto do TSE
not_foundDeve ser informado quando a biometria facial não for localizada em nenhuma das bases governamentais anteriores (serpro ou tse). Neste caso o similarity_score deve ser null ou o grau de similaridade da selfie com o documento oficial com foto, retornado pelo parceiro.
QI Sign

A QI Tech oferece o serviço de assinatura que atende ao determinado pela IN 138. Com biometria facial e envio de documentos.

Para receber uma cotação consulte nosso time comercial:

comercial@qitech.com.br ou (11) 2339-4763

Response

ENDPOINT
/debt/DEBT-KEY/signed
MÉTODO
POST
Response Body
{
"data": {},
"event_datetime": "2022-11-07 15:24:47",
"key": "<DEBT-KEY>",
"status": "signature_received",
"webhook_type": "debt"
}

Após o recebimento da assinatura, uma validação dos documentos enviados e do campo assistance type será feita.

Caso seja enviado um tipo de benefício (assistance_type) que não esteja mapeado, a operação será cancelada permanentemente.

O mesmo vale para as validações de documentos, caso haja duplicidade, falta ou documentos fora dos padrões mínimos exigidos, a operação será cancelada permanente.

Em ambos os casos, um webhook será enviado com o seguinte payload:

WEBHOOK_TYPE
debt
STATUS
Canceled Permanently
Webhook Body
{
"key": "<DEBT-KEY>",
"data": {},
"status": "canceled_permanently",
"webhook_type": "debt",
"event_datetime": "2022-11-01 03:46:31"
}