Pular para o conteúdo principal

Webhooks da AZFRETE

Envelope proposto​

{
  "id": "evt_01K5...",
  "tipo": "viagem.entregue",
  "versao": "1",
  "ocorridoEm": "2026-10-05T13:20:00Z",
  "organizacaoId": "org_...",
  "dados": {"viagemId": "vgg_...", "freteId": "frt_..."}
}

Segurança​

A requisição deve incluir identificador, timestamp e assinatura HMAC calculada sobre o corpo bruto. O receptor rejeita timestamp antigo, valida assinatura com comparação segura e deduplica pelo id.

Entrega​

  • timeout curto;
  • tentativas com backoff exponencial;
  • fila de reprocessamento;
  • consulta de histórico;
  • desativação controlada após falhas persistentes;
  • segredos rotacionáveis sem interrupção.

O catálogo final de eventos e cabeçalhos será versionado junto à API.