Nova API V1.0 · Referência
Pagamentos por canal
Consulte a série de pagamentos por dia ou por mês usando granularity. A opção filtered permite recortar o período por marca, canal e forma de pagamento. Informe as datas ou os meses correspondentes à escolha. Exige reports:payments:read e restaurante autorizado; preserva o corpo e os cálculos da variante selecionada. Veja exemplos no guia de relatórios.
Consulte a série de pagamentos por dia ou por mês usando granularity. A opção filtered permite recortar o período por marca, canal e forma de pagamento. Informe as datas ou os meses correspondentes à escolha. Exige reports:payments:read e restaurante autorizado; preserva o corpo e os cálculos da variante selecionada. Veja exemplos no guia de relatórios.
Authorization
reportsIntegration Access token obtido por OAuth ou troca de API key. Exige reports:payments:read, reports:customers:read, reports:products:read ou reports:kds:read conforme a rota. Não aceita sessões humanas, tokens de garçom ou chaves brutas.
In: header
Query Parameters
Restaurante autorizado pela credencial. Obrigatório quando houver mais de um restaurante; sem seleção implícita para credenciais universais.
Granularidade: daily = diária; monthly = mensal; filtered = período com filtros de pagamentos. Padrão: diária.
Início do período (YYYY-MM-DD). No KDS também aceita ISO com timezone. Obrigatório quando granularity=daily ou filtered; ignorado no modo mensal.
Fim do período (YYYY-MM-DD). KDS inclui o dia civil de Brasília; com ISO, o instante final é exclusivo. KDS: máximo 92 dias. Obrigatório quando granularity=daily ou filtered; ignorado no modo mensal.
Primeiro mês (YYYY-MM). Obrigatório quando granularity=monthly; ignorado nos outros modos.
Último mês (YYYY-MM). Obrigatório quando granularity=monthly; ignorado nos outros modos.
ID da marca do restaurante.
Grupo do canal de venda (presencial, delivery_takeat ou marketplaces).
Canal de venda do relatório de origem.
ID do método de pagamento.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
Pagamentos por forma GET
Consulte a série de pagamentos por dia ou por mês usando granularity. A opção filtered permite recortar o período por marca, canal e forma de pagamento. Informe as datas ou os meses correspondentes à escolha. Exige reports:payments:read e restaurante autorizado; preserva o corpo e os cálculos da variante selecionada. Veja exemplos no guia de relatórios.
Transações de pagamento GET
Consulta de leitura equivalente à manager-api. Exige reports:payments:read e restaurante autorizado. Filtros, valores e paginação mantêm o contrato do serviço de relatórios. Não concede permissões novas a tokens existentes.