Modelo de dados
Como comandas, contas, pedidos e complementos se relacionam.
Os pedidos da Takeat seguem uma hierarquia. Entendê-la facilita o consumo do endpoint de Sessões de comanda.
| Nível | Recurso | Descrição |
|---|---|---|
| 1 | table_sessions | Sessões de comanda de mesa, comanda única, totem e delivery. |
| 2 | individual_bills | Cada sessão pode ter múltiplas contas individuais. Cada conta pode ter buyer (cliente associado) ou waiter (garçom associado). |
| 3 | order_baskets | Cada conta individual pode conter uma ou mais cestas de pedidos. |
| 4 | orders | Cada cesta pode ter múltiplos pedidos. |
| 5 | order_complement_categories | Cada pedido pode ter diferentes categorias de complementos. |
| 6 | order_complements | Cada categoria de complemento pode conter múltiplos complementos. |
Valores e descontos
total_priceé a soma dos produtos;total_service_priceé ototal_price+ taxa de serviço.- Na table_session,
total_price/total_service_pricejá consideram o desconto (se houver). Oold_total_priceé o valor sem desconto. - Em bills, order_baskets e orders, os valores não têm o desconto aplicado.
Datas e fuso horário
Todas as datas de consulta e de retorno estão em UTC-0. Para converter para o horário de Brasília, adicione 3 horas.
Pagamentos e troco
Pagamentos em dinheiro consideram o troco:
payment_value— valor que entrou no faturamento (já descontado o troco).original_value— valor original pago pelo cliente.change— valor do troco.
Exemplo: pedido de R$ 80, pago R$ 50 no cartão de crédito e R$ 50 em dinheiro.
No cartão, payment_value = original_value (R$ 50) e change = R$ 0. No
dinheiro, payment_value = R$ 30, original_value = R$ 50 e change = R$ 20.
predicted_received_value— valor a receber já descontadas as taxas do método.predicted_received_date— data prevista de recebimento, calculada a partir das configurações do método na Área do Gestor (intervalo de dias, regras de fim de semana etc.).