Nova API V1.0 · Referência
Listar sessões de comanda
Retorna comandas abertas e fechadas com contas, pedidos, pagamentos e dados fiscais. O intervalo máximo é de três dias e as datas são UTC. Com OAuth, exige o escopo `table-sessions:read`; a sessão do restaurante também é aceita sem escopos de integração. A resposta preserva o contrato publicado: chaves `snake_case`, valores monetários como strings com escala e relações aninhadas. `status_timings` sempre está presente e agrupa os horários persistidos do ciclo do pedido. Etapas ainda não atingidas retornam `null`; a API não infere transições ausentes nem calcula durações. `bills[].buyer.delivery_address` é o destino selecionado pela sessão por `buyer_delivery_address_id`, nunca um endereço arbitrário do cadastro do comprador. Retorna null para sessões sem entrega, retirada, destino ausente ou de outro restaurante; um comprador ausente também permanece null.
Retorna comandas abertas e fechadas com contas, pedidos, pagamentos e
dados fiscais. O intervalo máximo é de três dias e as datas são UTC.
Com OAuth, exige o escopo table-sessions:read; a sessão do
restaurante também é aceita sem escopos de integração.
A resposta preserva o contrato publicado: chaves snake_case, valores
monetários como strings com escala e relações aninhadas.
status_timings sempre está presente e agrupa os horários persistidos
do ciclo do pedido. Etapas ainda não atingidas retornam null; a API
não infere transições ausentes nem calcula durações.
bills[].buyer.delivery_address é o destino selecionado pela sessão por
buyer_delivery_address_id, nunca um endereço arbitrário do cadastro do comprador.
Retorna null para sessões sem entrega, retirada, destino ausente ou de outro
restaurante; um comprador ausente também permanece null.
Authorization
bearerAuth Access token OAuth obtido em POST /oauth/token ou sessão autenticada
do restaurante emitida pelo login Takeat. Tokens OAuth exigem os
escopos de cada operação. A sessão não usa escopos de integração e
fica limitada ao restaurant_id assinado. Chaves tk_ não são aceitas.
In: header
Query Parameters
Omitido para sessões de restaurante, chaves de restaurante e parceiros
ligados a um único restaurante. Obrigatório para parceiros
multi-restaurante e validado contra os restaurantes autorizados para a
credencial. Em uma sessão, um valor diferente do restaurant_id
assinado responde 403.
Data/hora inicial em UTC.
Data/hora final em UTC. Aceita até três dias inteiros mais uma fração; quatro dias são rejeitados. Intervalo invertido retorna lista vazia.
Response Body
application/json
application/json
application/json
application/json