---
title: 6.4. Histórico de Duplicata do Sacado
url: https://docs.vehub.com.br/API/VeFlow%20-%20Duplicata%20Escritural/6.%20Sacados/v1/6.4.%20Hist%C3%B3rico%20de%20Duplicata/
---
# 6.4. Histórico de Duplicata do Sacado

## 🔗 Endpoint

| Método                                          | URL |
|-------------------------------------------------|-----|
| ![POST](https://img.shields.io/badge/POST-blue) | `/public/api/v1/duplicata-escritural/sacados/{cnpjSacado}/duplicatas/{identificadorDuplicata}/historico` |

---

## 🧾 Descrição

Solicita o histórico completo de uma duplicata específica vinculada a um sacado. O histórico inclui os eventos e alterações de status ocorridos na duplicata ao longo do seu ciclo de vida. O resultado é retornado de forma assíncrona via WebHook.

---

## 🧾 Parâmetros

| Parâmetro               | Tipo   | Local | Obrigatório | Descrição |
|-------------------------|--------|-------|-------------|-----------|
| cnpjSacado              | string | Path  | Sim         | CNPJ do sacado (somente números) |
| identificadorDuplicata  | string | Path  | Sim         | GUID da duplicata |

---

## 🧪 Exemplo de cURL

```bash
curl -X POST "https://api.vehub.com.br/public/api/v1/duplicata-escritural/sacados/98765432000155/duplicatas/A1B2C3D4-E5F6-7890-ABCD-EF1234567890/historico" \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -H "Content-Type: application/json"
```

---

## 📥 Responses

### ✅ 200 OK

```json
{
  "mensagem": "Solicitação de histórico registrada com sucesso!"
}
```

---

### ✅ 202 Accepted

```json
{
  "mensagem": "Solicitação de histórico recebida e será processada em breve.",
  "identificadorProcessamento": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890"
}
```

---

### ❌ 400 Bad Request

```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "titulo": "Atenção",
  "status": 400,
  "erros": [
    "Duplicata não encontrada para o sacado informado."
  ]
}
```

---

## 🕒 Observações

- O `cnpjSacado` deve ser informado sem formatação (somente números).
- O `identificadorDuplicata` deve ser o GUID da duplicata conforme retornado nas operações de escrituração.
- O resultado do histórico é retornado de forma assíncrona via WebHook.
- Quando o retorno for `202 Accepted`, o processamento ocorrerá de forma assíncrona.