Enviar um documento (entrega diferida, incremental)

POST/v1/emprestimos/{id}/documentos/{tipo}

🔒 Requer Bearer token

Escopo documentos:write. Requer header Idempotency-Key. Envia **um** documento por vez (ccb_assinada, selfie, doc_frente ou doc_verso) no fluxo de entrega diferida — alternativa de menor tráfego ao envio em lote (POST /v1/emprestimos/:id/documentos-dataprev). multipart/form-data com o campo arquivo (PDF ≤10MB para ccb_assinada; JPEG/PNG ≤5MB para as imagens). Cada envio apenas acumula; quando o pacote fica completo (CCB + as 3 imagens + as evidências da assinatura), o encaminhamento ao Dataprev é disparado automaticamente e a necessidade é marcada como entregue. As evidências (metadados) podem ser anexadas em qualquer um dos envios quando ainda não registradas (ver metadados_pendente em documentos-pendentes). Pré-condições iguais às do envio em lote: entrega diferida habilitada, necessidade aguardando e averbação concluída (senão 409).

Parâmetros

idstringpathobrigatório

tipostringpathobrigatório

Corpo da requisição

arquivostring<binary>obrigatório

O documento — PDF ≤10MB quando `tipo=ccb_assinada`; JPEG/PNG ≤5MB nos demais.

metadadosstringopcional

String JSON com as evidências da assinatura (mesmo formato de POST /v1/emprestimos/:id/documentos). Necessário apenas se ainda não registradas; pode ser enviado em qualquer um dos envios.

Respostas

Corpo da resposta 202

emprestimo_idstring<uuid>obrigatório

tipostringobrigatório

ccb_assinadaselfiedoc_frentedoc_verso

recebidobooleanobrigatório

pendentesarray<string>obrigatório

ccb_assinadaselfiedoc_frentedoc_verso

efeito_disparadobooleanobrigató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/:tipo' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -F 'arquivo=@arquivo.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",
  "tipo": "doc_verso",
  "recebido": true,
  "pendentes": [],
  "efeito_disparado": true,
  "status": "averbada",
  "docs_dataprev_status": "entregue"
}