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

# Ferramentas

> Endpoints auxiliares para calcular a taxa de entrega de um endereço e consultar se a loja está aberta.

Endpoints de apoio para o dia a dia do seu sistema: cotar a entrega antes de lançar um pedido por telefone ou no balcão, e saber se a loja está aberta e em quais horários atende.

> [card] [Obter taxa de entrega](/docs/guides/merchant/tools/obter-taxa-de-entrega.md)
>
> Informe latitude e longitude e receba se a loja entrega ali, a distância e a taxa.

> [card] [Obter status do merchant](/docs/guides/merchant/tools/obter-status-do-merchant.md)
>
> Veja se a loja está aberta ou fechada e os horários de funcionamento da semana.

> [!NOTE]
>
> Os dois endpoints usam o `merchantId` da loja no caminho e exigem um token com acesso a ela. Uma loja que o token não alcança responde `404`.


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