> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Documentação das APIs da DeliveryVip, em português. Regras que mais quebram integrações: (1) Merchant API: faça polling em GET /merchant/v3/events:polling no máximo a cada 30 s por token; confirme todo evento recebido com POST /merchant/v3/events/acknowledgment e corpo [{"id": "<eventId>"}] (o campo lido é id, não eventId), inclusive eventos repetidos ou que o sistema não trata; deduplique por eventId; o evento é só um aviso, busque o pedido na orderURL. (2) Tokens client_credentials valem 24 h e não têm refresh_token: peça outro ao receber 401. (3) Webhooks: valide a assinatura HMAC sobre o corpo bruto e responda 2xx rápido; o polling é a reconciliação. (4) Open Delivery: host od.deliveryvip.com.br, um client_secret por loja, datas em UTC. (5) Fidelidade: o operador implementa 5 rotas assinadas com HMAC e chama o config push; o estorno precisa ser idempotente. (6) Partner API: scope dv.partner. Não invente endpoints: use a referência gerada das specs OpenAPI.

# Pedidos

> Endpoints para receber eventos, listar, consultar e atualizar pedidos.

Endpoints para receber eventos de pedido, listar e consultar pedidos e executar as ações do ciclo de vida. Todos exigem [autenticação](/docs/reference/merchant/v3/authentication.md) com o scope `od.all`. Para o fluxo completo, veja o guia de [Pedidos](/docs/guides/merchant/order.md).

| Etapa | Endpoint | Guia |
| - | - | - |
| 1. Receber eventos | `GET /events:polling` (ou [webhook](/docs/guides/merchant/webhooks.md)) | [Consultar novos pedidos](/docs/guides/merchant/order/fluxo-de-integracao/consultar-novos-pedidos.md) |
| 2. Confirmar o recebimento | `POST /events/acknowledgment` | [Acknowledgment](/docs/guides/merchant/order/fluxo-de-integracao/acknowledgment-de-eventos.md) |
| 3. Buscar o pedido | `GET /orders/{orderId}` (a `orderURL` do evento) | [Obter detalhes do pedido](/docs/guides/merchant/order/fluxo-de-integracao/obter-detalhes-do-pedido.md) |
| 4. Atualizar o status | `POST /orders/{orderId}/confirm`, `dispatch`, `readyForPickup`... | [Ações de pedidos](/docs/guides/merchant/order/fluxo-de-integracao/acoes-de-pedidos.md) |
| Histórico | `GET /{merchantId}/orders` | [Listar pedidos](/docs/guides/merchant/order/listar-pedidos.md) |

Começando agora? [Receba seu primeiro pedido](/docs/guides/merchant/order/fluxo-de-integracao/recepcao-de-pedidos.md) junta as quatro etapas num script.

> [!NOTE]
>
> **Filtros do polling.** `eventType` e `orderType` são repetidos na query, uma vez por valor e sem colchetes (`style: form`, `explode: true`). Um valor inválido retorna `403 Forbidden`.
>
> ```text theme={null}
> GET /merchant/v3/events:polling?eventType=CREATED&eventType=CANCELLED
> ```
>
> Na listagem de pedidos é diferente: o filtro usa colchetes (`orderType[]=DELIVERY`). Veja [Listar pedidos](/docs/guides/merchant/order/listar-pedidos.md) e [Consultar novos pedidos](/docs/guides/merchant/order/fluxo-de-integracao/consultar-novos-pedidos.md#filtros).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.