Cancelamento de CCB

Cancela uma operação consignada junto à Socinal/Dataprev e marca o empréstimo como cancelada.

Endpoint

POST /v1/emprestimos/{id}/cancelamento — escopo emprestimos:write, com Idempotency-Key.

curl -X POST https://api.socinal.com.br/v1/emprestimos/emp_77aa.../cancelamento \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Idempotency-Key: 1f0c...-excl-1' \
  -H 'Content-Type: application/json' \
  -d '{ "motivo_cancelamento": 3 }'

{ "excluido": true, "competenciaExclusao": "2026-06" }

Regras

• Só é permitido para empréstimos averbada, desembolsada ou em_atraso — caso contrário, 409.
• motivo_cancelamento é um código inteiro (tabela de motivos a documentar).
• Pode retornar 422 ERRO_NEGOCIO (regra do consignante) ou 502 DATAPREV_INDISPONIVEL — neste último, faça retry com a mesma Idempotency-Key.

A detalhar: tabela completa de códigos de motivo_cancelamento e regras de competência de exclusão.