Mesas e Comandas

Disponível apenas para restaurantes com plano board.

Conceitos

Termo	Descrição
Board	Mesa física cadastrada no sistema
Board Movement	Abertura de uma mesa (início do atendimento)
Board Session	Sessão individual dentro de uma comanda (para split)

Fluxo de Atendimento

1. Atendente abre comanda (POST /boardMovements)
2. Cliente ou atendente adiciona pedidos à comanda
3. Cozinha prepara os itens
4. Cliente solicita a conta
5. Atendente imprime a conta (POST /board-sessions/{uuid}/print)
6. Cliente paga
7. Atendente libera a mesa (PATCH /boardMovements/{id}/free)

Regras de Abertura

• Uma mesa só pode ter uma comanda aberta por vez

• Para abrir novamente, a comanda anterior deve ser liberada

• Não é possível deletar uma comanda com pedidos

Split (Dividir Conta)

Permite separar itens de uma comanda em sessões independentes para cobrança separada:

Comanda principal
    ├─ Sessão A (João) — 2 itens
    └─ Sessão B (Maria) — 3 itens

• Cada sessão pode ser paga independentemente

• POST /board-sessions/{uuid}/products/{id}/split — move um item para outra sessão

Join (Reunir Itens)

• POST /board-sessions/{uuid}/products/{id}/join — retorna um item para a sessão principal

QR Code nas Mesas

• Cada mesa possui um QR Code único

• O cliente escaneia e acessa o app diretamente na mesa

• O app identifica a mesa automaticamente pela URL do QR

• O cliente pode fazer pedidos diretamente pelo app

Impressão

• A conta pode ser impressa parcialmente por sessão ou completa

• A impressão não fecha a comanda — é apenas um relatório

• Para fechar, sempre usar o endpoint free