> ## 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.

# Fluxo de integração

> As etapas para receber e gerenciar um pedido, da consulta de eventos às ações.

Para receber um pedido novo (evento `CREATED`) você precisa das etapas 1 a 3. A etapa 4 acompanha o pedido até a entrega.

**1. Consulte novos eventos**

Polling a cada 30 segundos, com até 100 eventos por chamada. [Consultar novos pedidos](/docs/guides/merchant/order/fluxo-de-integracao/consultar-novos-pedidos.md)

**2. Confirme o recebimento**

Acknowledgment de todos os eventos recebidos. [Acknowledgment de eventos](/docs/guides/merchant/order/fluxo-de-integracao/acknowledgment-de-eventos.md)

**3. Busque os detalhes do pedido**

Itens, cliente, entrega, pagamento e totais. [Obter detalhes do pedido](/docs/guides/merchant/order/fluxo-de-integracao/obter-detalhes-do-pedido.md)

**4. Execute as ações**

Confirmar, preparar, despachar, entregar ou cancelar. [Ações de pedidos](/docs/guides/merchant/order/fluxo-de-integracao/acoes-de-pedidos.md)

![Diagrama de sequência da recepção de um pedido](https://mintcdn.com/deliveryvip-a4256422/ELxpcniK2_BP8zxT/images/order-integrations2.png?fit=max\&auto=format\&n=ELxpcniK2_BP8zxT\&q=85\&s=c92f4814e5b4af8b14a799ab50ec6c75)

Sequência completa entre cliente, plataforma e loja

> [card] [Seu primeiro pedido](/docs/guides/merchant/order/fluxo-de-integracao/recepcao-de-pedidos.md)
>
> As quatro etapas num script pronto para rodar.

> [card] [Eventos de pedidos](/docs/guides/merchant/order/fluxo-de-integracao/eventos-de-pedidos.md)
>
> A estrutura do evento e todos os tipos.


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