Skip to main content
Toda mudança relevante numa loja gera um evento: um pedido criado, confirmado, despachado ou cancelado, um cliente chamando o garçom ou pedindo a conta. O seu sistema recebe esses eventos de duas formas, que funcionam de modo independente.

Webhook

A DeliveryVip faz um POST na sua URL assim que o evento acontece. Sem fila para drenar, sem limite de 100 e sem intervalo de consulta.

Polling

O seu sistema chama GET /merchant/v3/events:polling a cada 30 segundos e confirma o que processou.
Uma integração robusta usa o webhook como canal principal e o polling como reconciliação. Receber um evento por webhook não o tira da fila do polling, e vice-versa.

​
Como funciona o polling

A cada 30 segundos o sistema chama o polling; com eventos, processa, descarta repetidos e envia o acknowledgment; com a fila vazia recebe 204A cada 30 segundos o sistema chama o polling; com eventos, processa, descarta repetidos e envia o acknowledgment; com a fila vazia recebe 204

O ciclo do polling de eventos

1

Consulte a fila

GET /merchant/v3/events:polling devolve até 100 eventos, do mais antigo para o mais recente, ou 204 quando não há nada novo.
2

Processe cada evento

Use o eventType para decidir o que fazer. Eventos de pedido trazem a orderURL para buscar os detalhes.
3

Confirme o recebimento

Envie os eventId processados em POST /merchant/v3/events/acknowledgment. Eventos sem acknowledgment voltam na próxima chamada.
Se a resposta trouxer 100 eventos, a fila está acumulada. Envie o acknowledgment e chame o polling de novo sem esperar os 30 segundos, até receber menos de 100 eventos ou 204.
O polling só considera eventos criados nas últimas 24 horas. Eventos mais antigos deixam de ser retornados, mesmo sem acknowledgment.

​
Tipos de evento

Eventos de pedidos

CREATED, CONFIRMED, DISPATCHED, CANCELLED e os demais estados do pedido.

Eventos de indoor

CALL_WAITER e CLOSE_ACCOUNT, gerados pelas comandas e mesas do autoatendimento.

​
Próximos passos

Consultar novos pedidos

Requisição, filtros por tipo de evento, tipo de pedido e loja.

Acknowledgment

Como confirmar os eventos e tirar da fila.