Ir para o conteúdo

6.11. Histórico

Especificação — em construção

Os serviços descritos nesta área ainda não estão disponíveis.

🔗 Endpoint

Método URL
GET /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

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

[
  {
    "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
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.