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

# Conceitos

> As regras que valem para todas as APIs da DeliveryVip, de autenticação a paginação e limites.

Autenticação, formato de erros, paginação, datas e limites funcionam do mesmo jeito em todas as APIs. Entender essas regras antes de integrar evita os problemas mais comuns em produção.

> [card] [Autenticação](/docs/inicio/conceitos/autenticacao.md)
>
> Fluxos OAuth2, scopes, expiração, renovação e revogação do token.

> [card] [Erros](/docs/inicio/conceitos/erros.md)
>
> O corpo de erro, as exceções ao formato e o que fazer com cada status.

> [card] [Paginação](/docs/inicio/conceitos/paginacao.md)
>
> Cursores `next` e `previous`, header `Link` e `per_page`.

> [card] [Datas e horários](/docs/inicio/conceitos/datas-e-horarios.md)
>
> RFC 3339 com offset: UTC-3 na API própria, UTC no Open Delivery.

> [card] [Rate limiting](/docs/inicio/conceitos/rate-limiting.md)
>
> O limite de requisições e como reagir ao `429`.

> [card] [Postman](/docs/inicio/conceitos/postman.md)
>
> Coleções prontas para chamar a API sem escrever código.

> [card] [Use com IA](/docs/inicio/conceitos/usando-com-ia.md)
>
> Conecte esta documentação ao seu assistente ou editor.

## Em resumo

| Tema | Regra |
| - | - |
| Host | `https://api.deliveryvip.com.br` (Open Delivery: `https://od.deliveryvip.com.br`) |
| Autenticação | `Authorization: Bearer {token}`, token OAuth2 válido por 24 horas |
| Formato | JSON; `204 No Content` sem corpo quando não há resultado |
| Erros | `{ "status": "422", "title": "..." }`, com exceções para `401`, `403` e o endpoint de token |
| Datas | RFC 3339 com offset (`-03:00` ou `Z`) |
| Ambiente | Só produção; testes em uma loja de teste pedida no [Discord](https://discord.gg/AJF8Yha4) |


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