Enviar para assinatura

POST/v1/emprestimos/{id}/assinatura

🔒 Requer Bearer token

Escopo emprestimos:write. **Assíncrono**: o envio à D4Sign (que dispara o convite de assinatura ao signatário) é processado em segundo plano. O canal é definido por metodo_auth (email ou whatsapp; default email). Responde 202 de imediato com { recebido: true, status: "em_assinatura" } — acompanhe a conclusão pelo webhook assinatura.concluida. Reenviar um documento já enviado retorna 400 ERRO_VALIDACAO. Disponível apenas para parceiros com assinatura Socinal (D4Sign) habilitada; parceiros de assinatura externa recebem 403 e devem usar POST /v1/emprestimos/:id/documentos.

Parâmetros

idstringpathobrigatório

Corpo da requisição

metodo_authenumopcional

emailwhatsapp

Respostas

202Envio recebido; empréstimo em `em_assinatura`.

400Dados 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/assinatura' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "metodo_auth": "email"
}'

Response

{
  "recebido": true,
  "status": "em_assinatura"
}