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 (após POST /v1/emprestimos/:id/documentos). Pré-condição: empréstimo em validar_assinatura com assinatura externa (assinatura_socinal=false). Revalida a margem, cria a averbação e a processa de forma **assíncrona** — responde 202. Recusa (409) se os documentos não foram entregues, 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.

Parâmetros

idstringpathobrigatório

Respostas

202Averbação iniciada.

400Header `Idempotency-Key` ausente (`IDEMPOTENCY_KEY_OBRIGATORIA`). Dados inválidos (`ERRO_VALIDACAO`).

401Token ausente ou inválido (`CREDENCIAL_INVALIDA`).

404Empréstimo inexistente (`EMPRESTIMO_NAO_ENCONTRADO`).

Request

curl -X POST 'http://localhost:3101/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"
}