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

# Ações de places

> Abra e feche mesas com QR Code ou tablet para consumo.

Cada ação é um `POST` sem corpo em `/merchant/v3/{merchantId}/places/{placeId}/<ação>`, onde `placeId` é o `id` completo do place, com o prefixo (`indoor_qrcode_…` ou `indoor_tablet_…`). A resposta de sucesso é `202 Accepted` com esse mesmo `id`.

| Ação | Endpoint | Efeito |
| - | - | - |
| [Abrir para consumo](/docs/guides/merchant/indoor/places-api/acoes-de-places/abrir-para-consumo-um-place.md) | `opened` | A mesa volta a aceitar pedidos. O `status` passa a `AVAILABLE`, ou `BUSY` se houver pedidos em andamento. |
| [Fechar para consumo](/docs/guides/merchant/indoor/places-api/acoes-de-places/fechar-para-consumo-um-place.md) | `closed` | A mesa para de aceitar pedidos. O `status` passa a `CLOSED`. |

As ações são idempotentes: abrir uma mesa já aberta, ou fechar uma já fechada, responde `202` sem mudar nada.

```json 202 Accepted theme={null}
{ "id": "indoor_qrcode_a7f4a8b1-8e6d-4614-be9a-b81b10a0de99" }
```

## Erros

| Status | Quando |
| - | - |
| `404 Not Found` | O `merchantId` não autorizou o seu app, o place não existe, pertence a outra loja ou o `placeId` não tem um prefixo válido. |


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