Notificações e webhooks

Canais

A arquitetura prevê notificações no app, web push, e-mail e eventos em tempo real. Preferências por usuário e criticidade devem ser respeitadas, exceto comunicações legais ou de segurança obrigatórias.

Webhooks

Webhooks permitem que o sistema cliente receba mudanças sem consultar continuamente a API.

Eventos típicos:

• frete.publicado, frete.contratado, frete.cancelado;
• viagem.coleta_confirmada, viagem.ocorrencia, viagem.entregue;
• documento.autorizado, documento.rejeitado;
• pagamento.confirmado, pagamento.falhou;
• parceiro.documento_expirando.

O receptor deve responder rapidamente com 2xx, processar de forma idempotente e tolerar reentregas. A assinatura e o timestamp protegem contra adulteração e replay.