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

# Catálogo

> Endpoints para consultar a loja, sincronizar o catálogo e ver o status de funcionamento.

Endpoints para consultar os dados e o catálogo da loja, sincronizar produtos, opções e serviços (`merchantUpdate`, `merchantUpsert`, `merchantForce`) e consultar o status de funcionamento. Todos exigem [autenticação](/docs/reference/merchant/v3/authentication.md) com o scope `od.all`.

Para escolher entre as três formas de sincronização, veja o guia de [Catálogo](/docs/guides/merchant/catalog-and-services/actions.md).

| Endpoint | Para quê | Guia |
| - | - | - |
| `GET /{merchantId}` | Ler a loja, os serviços, as formas de pagamento e o catálogo completo. | [Detalhes](/docs/guides/merchant/catalog-and-services/details.md) |
| `POST /{merchantId}/merchantUpdate` | Alterar objetos que já existem: preço, status, tempo de preparo. | [Update](/docs/guides/merchant/catalog-and-services/actions/update.md) |
| `POST /{merchantId}/merchantUpsert` | Criar ou alterar objetos de um tipo, sem mexer no resto. | [Upsert](/docs/guides/merchant/catalog-and-services/actions/upsert.md) |
| `POST /{merchantId}/merchantForce` | Reescrever o catálogo inteiro: o que não vier é removido. | [Force](/docs/guides/merchant/catalog-and-services/actions/force.md) |
| `GET /{merchantId}/status` | Ver se a loja está aberta e os horários da semana. | [Status do merchant](/docs/guides/merchant/tools/obter-status-do-merchant.md) |

O fluxo típico é uma carga inicial com `merchantForce` (ou `merchantUpsert` tipo a tipo) e, no dia a dia, `merchantUpsert` para produtos novos e `merchantUpdate` para mudanças pontuais.


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