Cupons
Cupons
Vendas em que um cupom foi usado — o código, o valor da venda e quem usou
GET
Cupons
Retorna as vendas da loja em que um cupom foi usado: o código do cupom (
Filtre pelo período da venda com
coupon), o valor da venda (amount), a data (saleDate) e o cliente (customerId). Vendas sem cupom não aparecem aqui — a ausência de uma venda nesta rota não significa que ela não existe.
Para medir o desempenho de um cupom, agrupe pelos valores de
coupon: quantas vendas, receita total e quantos clientes distintos usaram. Cruzando customerId com Clientes (CRM), dá para saber se o cupom atraiu clientes novos ou recorrentes.from/to (datas inclusivas) ou sincronize incrementalmente com updatedSince; pagine com cursor/nextCursor.
Erros
Obter pedido
O pedido completo por trás de cada
saleId — itens, valores e modalidade.Autorizações
Token de acesso emitido por POST /od/v2/oauth/token (fluxo client_credentials). Envie no header Authorization como Bearer <token>.
Parâmetros de caminho
Identificador (UUID) do merchant — o mesmo id de GET /od/v2/merchants.
Parâmetros de consulta
Início do período (data, inclusive). Deve ser anterior ou igual a to.
Fim do período (data, inclusive).
Retorna apenas registros atualizados a partir deste instante (sincronização incremental).
Cursor opaco da próxima página, retornado em nextCursor. Omita na primeira chamada.
Itens por página. Valores acima de 500 são limitados a 500.
Intervalo obrigatório:
x <= 500
