6.5. Manifestação do Sacado¶

🔗 Endpoint¶

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

🧾 Descrição¶

Envia a manifestação do sacado referente a uma ou mais duplicatas escriturais. Permite registrar aceite, recusa por diferentes motivos ou anotação comercial. O retorno é síncrono.

📤 Requisição¶

📋 Payload (JSON)¶

{
  "manifestacoes": [
    {
      "identificadorUnicoDuplicata": "5174568D-9FFE-4C10-9FC2-B0F4E7F8D1B6",
      "tipoManifestacao": "RCVL",
      "novoValor": 9500.00,
      "indicadorRecebimento": "S",
      "dataManifestacao": "2026-03-20"
    }
  ]
}

🧾 Detalhamento dos Campos¶

Campo	Tipo	Obrigatório	Descrição
data	array	Sim	Lista de manifestações a enviar

🔹 data[]¶

Campo	Tipo	Obrigatório	Descrição
identificadorUnicoDuplicata	string	Sim	GUID da duplicata
tipoManifestacao	string	Sim	Tipo de manifestação (ver TipoManifestacao)
novoValor	number	Não	Novo valor proposto pelo sacado (quando aplicável)
indicadorRecebimento	string	Sim	Indicador de recebimento (`S` = Sim, `N` = Não)
dataManifestacao	string	Sim	Data da manifestação (YYYY-MM-DD)

🔢 Enumeradores¶

TipoManifestacao¶

Código	Significado
ACTO	Aceite
RCAV	Recusa por avaria
RCQQ	Recusa por diferenças de qualidade ou quantidade
RCVN	Recusa por divergências no vencimento
RCVL	Recusa por divergências no valor
RCOP	Recusa por desconhecimento da operação
ANTC	Anotação Comercial

🧪 Exemplo de cURL¶

curl -X POST https://api.vehub.com.br/public/api/v1/duplicata-escritural/sacados/manifestacoes \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -H "Content-Type: application/json" \
  -d '{
    "manifestacoes": [
      {
        "identificadorUnicoDuplicata": "5174568D-9FFE-4C10-9FC2-B0F4E7F8D1B6",
        "tipoManifestacao": "RCVL",
        "novoValor": 9500.00,
        "indicadorRecebimento": "S",
        "dataManifestacao": "2026-03-20"
      }
    ]
  }'

📥 Responses¶

✅ 200 OK¶

{
  "mensagem": "Manifestação enviada com sucesso."
}

❌ 400 Bad Request¶

{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "titulo": "Atenção",
  "status": 400,
  "erros": [
    "Campo 'identificadorUnicoDuplicata' é obrigatório.",
    "Campo 'tipoManifestacao' possui valor inválido."
  ]
}

🕒 Observações¶

É possível enviar múltiplas manifestações em um único request através do array manifestacoes.
O campo novoValor é opcional e deve ser preenchido apenas quando a manifestação implica em alteração de valor (ex: RCVL).
O retorno é síncrono — não é gerada notificação via WebHook para este endpoint.