Enviar informações do contrato (kit da CCB)

Envia a CCB assinada e a prova de identidade de quem assinou. Exige contrato já averbado e pertencente à conta.

Endpoint: POST /econsigado/loans/contract-information
Scope: econsignado.write
Equivalente na Dataprev: /emprestimos/incluir-informacoes-contrato-trabalhador

curl --location 'https://secureapi.onz.finance/api/v2/econsigado/loans/contract-information' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "cpf": "12345678901",
    "employee_id": "12345",
    "employer_registration_type": 1,
    "employer_registration_number": "12345678000199",
    "contract_number": "CTR0001",
    "loan_contract_file": "<PDF da CCB assinada em base64>",
    "signed_at": "21082026161500",
    "ip": "189.100.10.25",
    "icp_brasil_signature": false,
    "illiterate": false,
    "validated_with_official_document": false,
    "facial_biometrics": "<JPG da biometria facial em base64>",
    "biometric_base": "SERPRO",
    "score": 98.5
  }'

Campo	Obrigatório	Descrição
cpf	Sim	CPF do trabalhador
employee_id	Sim	Matrícula do trabalhador
employer_registration_type	Sim	Código do tipo de inscrição do empregador
employer_registration_number	Sim	Número de inscrição do empregador
contract_number	Sim	Contrato averbado
loan_contract_file	Sim	PDF da CCB assinada, em base64
signed_at	Sim	Data e hora da assinatura (ddMMyyyyHHmmss, horário de Brasília)
ip	Sim	IP usado na assinatura (IPv4 ou IPv6)
icp_brasil_signature	Sim	Indica assinatura com certificado digital ICP-Brasil
illiterate	Sim	Indicador de analfabetismo
facial_biometrics	Sim	JPG do registro biométrico facial, em base64
validated_with_official_document	Não	Caminho de validação da identidade (ver abaixo)
official_document_front	Condicional	JPG da frente do documento, em base64
official_document_back	Condicional	JPG do verso do documento, em base64
document_type	Condicional	1=RG, 2=CNH
biometric_base	Condicional	TSE, SERPRO ou IDRC
score	Condicional	Score de similaridade da validação biométrica
latitude / longitude	Não	Geolocalização da assinatura
device	Não	Dispositivo usado (até 100 caracteres)
contract_nsu	Não	NSU do contrato
authentication_type	Não	Tipo de autenticação

Dois caminhos de validação da identidade

A biometria facial é obrigatória nos dois casos. O que muda é o restante:

validated_with_official_document	Campos exigidos
true	official_document_front, official_document_back e document_type
false ou ausente	biometric_base e score

Omitir o indicador não dispensa nada: a ausência é tratada como caminho biométrico.

O biometric_base aceita apenas as bases governamentais TSE, SERPRO e IDRC (Identidade Eletrônica do Registro Civil). A habilitação é por instituição, então uma base válida da lista pode ainda não estar liberada para a sua.

Limite de tamanho

A soma dos campos em base64 — CCB, documentos e biometria — precisa ficar abaixo de 10 MB. Acima disso a requisição é recusada com 400 antes do envio à Dataprev.

Como o payload é grande, esta rota tem timeout estendido. Os arquivos não são persistidos nem registrados em log pela Onz: apenas o retorno da Dataprev é guardado.

Resposta

{
  "data": {
    "codigo": "BD",
    "mensagem": "Inclusão efetuada com sucesso",
    "numeroContrato": "CTR0001",
    "hashOperacao": 1617011102
  }
}

Erros relevantes

HTTP	Situação
400	Campo do caminho de validação ausente, base biométrica fora da lista ou payload acima de 10 MB
403	Conta sem a liberação de empréstimo consignado
404	Contrato não averbado nesta plataforma ou de outra conta
422	Base biométrica não habilitada para a instituição