---
title: 6.11. Histórico
url: https://docs.vehub.com.br/Emiss%C3%A3o%20de%20Ativos/API/Cr%C3%A9dito/6.%20Proposta/6.11.%20Hist%C3%B3rico/
---
# 6.11. Histórico

!!! warning "Especificação — em construção"
    Os serviços descritos nesta área ainda não estão disponíveis.

## 🔗 Endpoint

| Método | URL |
|--------|-----|
| ![GET](https://img.shields.io/badge/GET-green) | `/credito/propostas/{idProposta}/historico` |

---

## 🧾 Descrição

Devolve a **trilha de mudanças de estado** da proposta, em ordem cronológica: quando cada status foi
atingido e o que o originou.

É o serviço que responde *"por que esta proposta está nesse estado?"* sem abrir chamado. Use-o no seu
atendimento e nos seus logs de auditoria.

### 🔹 Path Parameter

| Parâmetro | Tipo | Descrição |
|-----------|------|-----------|
| idProposta | integer | Identificador da proposta |

---

## 🧪 Exemplo de cURL

```bash
curl -X GET "https://api.vehub.com.br/credito/propostas/1001/historico" \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}"
```

---

## 📥 Responses

### ✅ 200 OK

```json
[
  {
    "status": { "id": 1, "nome": "Em digitação" },
    "dataHora": "2026-08-20T13:04:11Z",
    "origem": "api",
    "observacao": null
  },
  {
    "status": { "id": 10, "nome": "Falha na simulação" },
    "dataHora": "2026-08-20T13:06:02Z",
    "origem": "integracao-bancarizadora",
    "observacao": "Prazo informado é inválido para o produto."
  },
  {
    "status": { "id": 1, "nome": "Em digitação" },
    "dataHora": "2026-08-20T13:08:45Z",
    "origem": "api",
    "observacao": "Reabertura da proposta."
  },
  {
    "status": { "id": 13, "nome": "Aguardando motor de crédito" },
    "dataHora": "2026-08-20T13:10:02Z",
    "origem": "api",
    "observacao": null
  },
  {
    "status": { "id": 16, "nome": "Retorno do motor de crédito recebido" },
    "dataHora": "2026-08-20T13:22:40Z",
    "origem": "integracao-bancarizadora",
    "observacao": "Aprovado"
  }
]
```

### 🧾 Detalhamento dos Campos

| Campo | Tipo | Descrição |
|-------|------|-----------|
| status | object | Status atingido. Ver [2.1. Enumerações](../2.%20Enumerações/2.1.%20Enumerações.md) |
| dataHora | string | Momento da transição, em UTC |
| origem | string | O que provocou a transição — ver tabela abaixo |
| observacao | string / null | Detalhe da transição: mensagem de erro, resultado da análise, motivo do cancelamento |

### Valores de `origem`

| Valor | Significado |
|-------|-------------|
| `api` | Uma chamada sua a esta API |
| `plataforma` | Ação de um operador na plataforma VeTrust |
| `integracao-bancarizadora` | Retorno da bancarizadora, incluindo webhooks de status e de análise |
| `job` | Processamento automático da plataforma |

---

## 🧭 Casos em que o histórico resolve

| Situação | O que o histórico mostra |
|---|---|
| A proposta voltou para *Em digitação* e você não sabe por quê | Uma falha de cálculo seguida de reabertura, com a mensagem da bancarizadora |
| A proposta está em *Aguardando motor* há muito tempo | Quando a submissão ocorreu, para dimensionar o atraso |
| A operação foi cancelada e o cliente reclama | Quando, por qual origem e com qual observação |
| Um operador alterou algo pela plataforma | Transições com `origem: plataforma` |

---

## ⚠️ Observações

- O histórico registra **transições de estado**, não alterações de campo. Uma correção de endereço
  do tomador não gera entrada.
- A lista é devolvida em **ordem cronológica crescente** — a última entrada é o estado atual.
- Um mesmo status pode aparecer mais de uma vez, como no ciclo falha → reabertura → falha.