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

# Indoor

> Integre o autoatendimento no salão, com mesas, comandas, chamadas de garçom e pedidos de fechamento de conta.

O indoor é o autoatendimento dentro do estabelecimento: o cliente faz o pedido pelo celular, lendo o QR Code da mesa ou da comanda, ou por um tablet fixo na mesa. Pela API, o seu PDV recebe os pedidos e os chamados do salão e controla quais mesas e comandas aceitam consumo.

> [!WARNING]
>
> **API em beta.** Ela ainda pode mudar. Acompanhe o [changelog](/docs/changelog.md) antes de cada atualização da sua integração.

## Conceitos

> [card] Place (mesa)
>
> Um ponto de atendimento fixo: um **QR Code de mesa** ou um **tablet**. O `id` traz o tipo no prefixo, como `indoor_qrcode_…` ou `indoor_tablet_…`. Os places são cadastrados no painel; pela API você lista e abre ou fecha cada um.

> [card] Comanda (tab)
>
> Um cartão ou ficha que acompanha o cliente, com nome, código e QR Code próprio. Pela API você cadastra, edita, remove e abre ou fecha cada comanda.

> [card] Pedido INDOOR
>
> Os pedidos feitos no salão chegam como pedidos do tipo `INDOOR` e seguem o mesmo fluxo de [pedidos](/docs/guides/merchant/order.md) de delivery e retirada.

> [card] Eventos do salão
>
> `CALL_WAITER` (chamar garçom) e `CLOSE_ACCOUNT` (pedir a conta) chegam pelo mesmo polling e webhook dos pedidos.

## Aberto e fechado para consumo

Mesas e comandas têm uma situação que diz se aceitam pedidos. Enquanto estiver fechada, o cliente que abrir aquela mesa ou comanda vê o aviso de mesa fechada e não consegue finalizar pedidos nela.

![Após o cadastro a mesa ou comanda fica aberta e alterna para fechada com POST closed e de volta com POST opened](https://mintcdn.com/deliveryvip-a4256422/ELxpcniK2_BP8zxT/images/indoor-aberta-fechada.png?fit=max\&auto=format\&n=ELxpcniK2_BP8zxT\&q=85\&s=dbeea5ef46a3cceb91103852b60391b9)

Aberta e fechada para consumo

O uso típico é fechar a comanda ou a mesa quando a conta é paga e reabrir quando ela volta a ser usada. Veja [ações das comandas](/docs/guides/merchant/indoor/comanda-api/acoes-das-comandas.md) e [ações de places](/docs/guides/merchant/indoor/places-api/acoes-de-places.md).

## Por onde seguir

> [card] [Fluxo de integração](/docs/guides/merchant/indoor/fluxo-de-integracao.md)
>
> Receba e confirme os eventos de chamar garçom e fechar conta.

> [card] [Comandas](/docs/guides/merchant/indoor/comanda-api.md)
>
> Cadastre, liste, edite e abra ou feche comandas.

> [card] [Places](/docs/guides/merchant/indoor/places-api.md)
>
> Liste as mesas e veja quais estão livres, ocupadas ou fechadas.

> [card] [Pedidos](/docs/guides/merchant/order.md)
>
> Receba e atualize os pedidos `INDOOR`, que seguem o fluxo de pedidos.

> [!NOTE]
>
> Todos os endpoints de indoor exigem um token com o scope `od.all` e respondem `404` quando o `merchantId` não está entre as lojas que autorizaram o seu app.


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