Abbiamo DocsWebhook de disputa
Receba no seu sistema, em tempo real, toda mudança de status de uma disputa Care — quando ela abre, muda de situação, muda o status com a transportadora (TRP), ou é resolvida — assinando o webhook DISPUTE_STATUS_CHANGE.
Se você quer refletir o pós-venda no seu próprio sistema (ERP, CRM, planilha), assine o webhook DISPUTE_STATUS_CHANGE. A cada mudança relevante de uma disputa, a Abbiamo faz um POST no endereço que você configurar.
Como assinar
Em Configurações → Webhooks, crie um webhook, informe a URL do seu endpoint e escolha o evento DISPUTE_STATUS_CHANGE. Pronto — a partir daí, toda mudança de status de disputa dispara uma chamada.
O mesmo painel de webhooks permite acompanhar os logs de cada disparo (status da resposta, payload enviado), úteis para depurar a integração.
Quando dispara
O evento é disparado quando uma disputa:
- abre (pelo cliente ou manualmente);
- muda de status ou sub-status (ex.: passa a aguardar a transportadora);
- muda o status com a transportadora (TRP);
- é resolvida ou rejeitada.
Payload
{
"event_type": "DISPUTE_STATUS_CHANGE",
"dispute_public_id": "AB12CD",
"invoice_id": "a1b2c3d4-0000-0000-0000-000000000000",
"status": "pending",
"sub_status": "with_carrier",
"carrier_type": "CORREIOS",
"carrier_status": "pending",
"carrier_sub_status": "awaiting_response",
"outcome": null,
"resolution": null,
"compensation_amount": null,
"compensation_currency": null,
"rejection_reason_code": null,
"closure_reason": null,
"event_at": "2026-06-08T12:34:56.000Z"
}A referência completa do evento (com glossário e exemplos por estado) está na documentação de webhooks da API.
Campos
| Campo | Descrição |
|---|---|
dispute_public_id | Identificador curto da disputa (o mesmo exibido no painel). |
invoice_id | Identificador do pedido ao qual a disputa pertence. |
status | pending (em aberto) ou resolved (encerrada). |
sub_status | Detalhe da situação enquanto em aberto (ex.: aguardando a marca, a transportadora, o cliente). null quando resolvida. |
carrier_type | A transportadora envolvida, se houver. |
carrier_status / carrier_sub_status | A situação do trilho com a transportadora. |
outcome | O desfecho registrado ao resolver (entregue, retornado, perdido…). |
resolution | A compensação (reembolso, voucher, reenvio…). |
compensation_amount / compensation_currency | Valor da compensação, quando aplicável. |
rejection_reason_code | Motivo, quando a disputa é rejeitada. |
closure_reason | Motivo do encerramento. |
event_at | Quando a mudança aconteceu (ISO 8601). |
Os webhooks são entregues na ordem de cada disputa. Se o seu endpoint responder com erro, a Abbiamo tenta novamente algumas vezes antes de desistir — então trate o recebimento de forma idempotente (use dispute_public_id + event_at).