Abbiamo DocsEvento `ORDER_RECEIVER_UPDATE`
Webhook complementar, enviado apenas quando a transportadora reporta dados do recebedor (nome, documento) e/ou comprovante de entrega (foto/assinatura).
Evento que carrega os dados do recebedor de uma entrega — nome, documento, descrição (ex.: "Vizinho") — e/ou o comprovante de entrega (POD): fotos e assinatura.
Ele é disparado sempre que um evento de entrega traz recebedor e/ou anexos — tipicamente junto da confirmação de entrega (SUCCESSFUL).
Por que um evento separado
Quando a transportadora captura o recebedor/POD no mesmo momento da entrega, esses dados já acompanham o próprio ORDER_STATUS_CHANGE de SUCCESSFUL (nos campos receiver_name, receiver_description e attachments) — e o ORDER_RECEIVER_UPDATE chega junto, com a mesma informação.
O valor deste evento está no caso em que esses dados são reportados separadamente: a transportadora confirma a entrega primeiro e só registra o recebedor/comprovante depois (minutos ou horas mais tarde). Nesse cenário o SUCCESSFUL já foi enviado sem esses campos, e é o ORDER_RECEIVER_UPDATE que entrega o recebedor/POD posteriormente.
Para receber o recebedor/comprovante de forma confiável — independente de a transportadora reportar junto ou depois da entrega — ouça o ORDER_RECEIVER_UPDATE. Confiar só no ORDER_STATUS_CHANGE faz você perder os casos em que o recebedor/POD chega após a confirmação.
O evento depende de a transportadora enviar recebedor e/ou anexos — entregas confirmadas sem esses dados não o geram. Por vir em webhook próprio, ele pode chegar junto ou após o SUCCESSFUL do mesmo pedido; correlacione pelo order_id/tracking.
Glossário de campos
| Campo | Tipo | Descrição |
|---|---|---|
event_type | "ORDER_RECEIVER_UPDATE" | identificador do evento |
order_id | uuid | UUID do pedido na Abbiamo |
order_number | string | mesmo valor do number enviado no create-order |
order_type | string | DELIVERY, TAKEOUT, RETURN, etc. |
invoice_number | string | número da nota fiscal |
external_order_id | string | null | ID externo do pedido (se informado na criação) |
seller_identifier | string | identificador da filial |
seller_id | uuid | ID interno da filial |
seller_group_id | uuid | ID interno da conta |
creation_origin | string | origem do pedido (API-V2, VTEX, etc.) |
tracking | string(7) | código de rastreio gerado pela Abbiamo |
timestamp | integer | timestamp em ms de quando o evento foi disparado |
event_at | ISO datetime | quando o evento aconteceu |
receiver_name | string | null | nome de quem recebeu o pedido |
receiver_document_number | string | null | documento de quem recebeu |
receiver_description | string | null | descrição livre (ex.: "Porteiro", "Vizinho") |
attachments | Array<{ url, type }> | null | anexos do POD (Proof of Delivery) |
attachments[].url | URL | URL pública do anexo |
attachments[].type | "image" | "signature" | tipo do anexo — foto da entrega ou assinatura do recebedor |
attachments pode trazer múltiplos itens — tipicamente uma image (foto da entrega) e uma signature (assinatura do recebedor). Pode vir vazio/ausente quando não houve captura.
Exemplo
{
"order_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"order_number": "123456789",
"order_type": "DELIVERY",
"invoice_number": "xxxxxxxxxx",
"external_order_id": "1892831",
"seller_identifier": "1234569191",
"seller_id": "f3b3a3a3-aaaa-bbbb-cccc-ddddddddddd",
"seller_group_id": "c2c2c2c2-aaaa-bbbb-cccc-ddddddddddd",
"creation_origin": "API-V2",
"event_type": "ORDER_RECEIVER_UPDATE",
"tracking": "a7g92yd",
"timestamp": 1661280476296,
"event_at": "2026-05-26T13:50:07.709Z",
"receiver_name": "João",
"receiver_document_number": "12345678909",
"receiver_description": "Vizinho",
"attachments": [
{
"url": "https://attachments.abbiamolog.com/11111111-1111-1111-1111-111111111111.jpeg",
"type": "image"
},
{
"url": "https://attachments.abbiamolog.com/22222222-2222-2222-2222-222222222222.jpeg",
"type": "signature"
}
]
}