6.1. Informar Ciência do Sacado¶

🔗 Endpoint¶

Método	URL
	/public/api/v1/duplicata-escritural/sacados/ciencia

🧾 Descrição¶

Informa ao sistema a ciência do sacado em relação aos contratos de duplicata escritural informados. Essa operação registra o conhecimento formal do sacado sobre suas obrigações nos contratos listados.

📤 Requisição¶

📋 Payload (JSON)¶

{
  "identificadoresContratos": [
    "5174568D-9FFE-4C10-9FC2-B0F4E7F8D1B6",
    "A1B2C3D4-E5F6-7890-ABCD-EF1234567890"
  ]
}

🧾 Detalhamento dos Campos¶

🧪 Exemplo de cURL¶

curl -X POST https://api.vehub.com.br/public/api/v1/duplicata-escritural/sacados/ciencia \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -H "Content-Type: application/json" \
  -d '{
    "identificadoresContratos": [
      "5174568D-9FFE-4C10-9FC2-B0F4E7F8D1B6"
    ]
  }'

📥 Responses¶

✅ 200 OK¶

{
  "mensagem": "Ciência do sacado registrada com sucesso!"
}

✅ 202 Accepted¶

{
  "mensagem": "Ciência recebida e será processada em breve.",
  "identificadorProcessamento": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890"
}

❌ 400 Bad Request¶

{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "titulo": "Atenção",
  "status": 400,
  "erros": [
    "Um ou mais contratos informados não foram encontrados."
  ]
}

🕒 Observações¶

• O campo identificadoresContratos pode ser omitido ou enviado vazio para registrar ciência geral, dependendo da implementação.
• Quando o retorno for 202 Accepted, o processamento ocorrerá de forma assíncrona.