Devolver o pacote assinado (entrega diferida)

POST/v1/emprestimos/{id}/documentos-dataprev

🔒 Requer Bearer token

Escopo documentos:write. Requer header Idempotency-Key. Disponível apenas para parceiros de assinatura externa com **entrega diferida** habilitada no cadastro (senão 409). **Passo final** do fluxo diferido (emitir → averbar → desembolsar → devolver o pacote): a averbação abre a necessidade (docs_dataprev_status=aguardando) com **prazo de 5 dias**, e o parceiro entrega aqui o pacote assinado — ccb_assinada (PDF, ≤10MB) + selfie, doc_frente e doc_verso (JPEG/PNG, ≤5MB). A ccb_assinada só pode ser omitida se já tiver sido adiantada em POST /v1/emprestimos/:id/documentos (aí o reenvio apenas substitui a arquivada). Se as evidências da assinatura ainda não foram registradas, envie-as no campo metadados (senão 400). Arquiva os documentos, marca a necessidade como entregue e encaminha o pacote ao Dataprev de forma assíncrona (responde 202). Pode ser chamado a partir da averbação (não exige o desembolso); antes da averbação retorna 409.

Parâmetros

idstringpathobrigatório

Corpo da requisição

ccb_assinadastring<binary>obrigatório

CCB assinada — PDF, ≤10MB. Obrigatória, exceto se já arquivada em POST /v1/emprestimos/:id/documentos (aí o envio aqui apenas substitui).

selfiestring<binary>obrigatório

Selfie do signatário — JPEG/PNG, ≤5MB.

doc_frentestring<binary>obrigatório

Documento de identidade (frente) — JPEG/PNG, ≤5MB.

doc_versostring<binary>obrigatório

Documento de identidade (verso) — JPEG/PNG, ≤5MB.

metadadosstringopcional

String JSON com as evidências da assinatura (mesmo formato de POST /v1/emprestimos/:id/documentos). Obrigatório quando as evidências ainda não foram registradas; se enviado aqui, completa/atualiza o registro de auditoria.

Respostas

Corpo da resposta 202

emprestimo_idstring<uuid>obrigatório

statusstringobrigatório

emitindoem_assinaturaaguardando_averbacaoaverbadadesembolso_agendadodesembolsadaem_atrasoliquidadacanceladarefinanciada

docs_dataprev_statusstringobrigatório

aguardandoentregue

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/emprestimos/:id/documentos-dataprev' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -F 'ccb_assinada=@ccb-assinada.pdf' \
  -F 'selfie=@selfie.jpg' \
  -F 'doc_frente=@doc-frente.jpg' \
  -F 'doc_verso=@doc-verso.jpg' \
  -F 'metadados={"signatario":"João da Silva","tipo_assinatura":"eletronica","assinatura_ip":"177.0.0.1","localizacao":{"lat":-23.5505,"lng":-46.6333},"assinado_em":"2026-06-03T00:27:42.573Z"};type=application/json'

Response

{
  "emprestimo_id": "8f2a1c4e-1234-5678-9abc-def012345678",
  "status": "averbada",
  "docs_dataprev_status": "entregue"
}