Iniciar averbação

POST/v1/emprestimos/{id}/averbacao

🔒 Requer Bearer token

Escopo emprestimos:write. Requer header Idempotency-Key. Corpo vazio ({}, opcional). **Segundo passo** da assinatura externa. Revalida a margem, cria a averbação e a processa de forma **assíncrona** — responde 202. Na variante **diferida** (entrega_docs_dataprev_diferida=true) averbar **não exige documento nenhum** — nem a CCB assinada: chame logo após emitir o empréstimo, com ele ainda em em_assinatura. O pacote assinado é entregue depois, em POST /v1/emprestimos/:id/documentos-dataprev (necessidade aberta na averbação, prazo de 5 dias). Na variante **agrupada** a pré-condição continua sendo aguardando_averbacao com o pacote já registrado em POST /v1/emprestimos/:id/documentos. Recusa (409) se o status não permite, já há averbação em andamento/concluída, ou o empréstimo é do fluxo D4Sign. Para reprocessar uma averbação que falhou use POST /v1/emprestimos/:id/averbacao/retry. O status da resposta é o da **averbação** (não o da CCB); a pendência de entrega de documentos ao Dataprev vem no bloco separado entrega_docs_dataprev (null fora da variante diferida).

Parâmetros

idstringpathobrigatório

Respostas

Corpo da resposta 202

averbacao_idstring<uuid>obrigatório

statusstringobrigatório

averbacao_iniciada

entrega_docs_dataprevobjectobrigatórionullable

statusstringobrigatório

aguardandoentregue

prazostring<date-time>obrigatórionullable

proxima_acaostringobrigatórionullable

aguardar_averbacaoentregar_documentos_dataprev

Request

curl -X POST 'https://econsignado-api.socinal.com.br/v1/emprestimos/:id/averbacao' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 3f1c8a90-0000-4000-8000-000000000000' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response

{
  "averbacao_id": "9f8e7d6c-5b4a-3c2d-1e0f-9a8b7c6d5e4f",
  "status": "averbacao_iniciada",
  "entrega_docs_dataprev": {
    "status": "aguardando",
    "prazo": null,
    "proxima_acao": "aguardar_averbacao"
  }
}