Receita, ticket médio e cupons

Esta página combina duas famílias de rotas: as vendas atribuídas ao relacionamento com o cliente (Conversões) e o total de vendas da loja, com ou sem campanha (Vendas diárias). A diferença entre as duas é o que sustenta a maioria dos indicadores abaixo.

Receita via CRM e % da receita da loja

Pergunta: quanto da receita da loja veio de vendas atribuídas ao CRM (campanhas)?

Requisição

curl --request GET \
  --url 'https://public-api.repediu.com.br/v1/stores/{merchantId}/conversions?from=2026-08-01&to=2026-08-31' \
  --header 'Authorization: Bearer <token>'

curl --request GET \
  --url 'https://public-api.repediu.com.br/v1/stores/{merchantId}/sales-daily?from=2026-08-01&to=2026-08-31' \
  --header 'Authorization: Bearer <token>'

receitaCRM = soma(amount) de todas as conversões do período
receitaLoja = soma(grossRevenue) de sales-daily no período
percentualDaReceita = receitaCRM / receitaLoja * 100

Se você só precisa do total (sem o detalhe por venda), Receita gerada devolve receitaCRM pronta em uma chamada, sem paginar.

Ticket médio: período vs. histórico

Pergunta 1: qual o ticket médio das vendas via CRM neste período?

ticketCRM = receitaCRM / número de conversões do período

Pergunta 2: qual o ticket médio histórico da loja (todo o histórico, não só este período)?

Requisição

curl --request GET \
  --url https://public-api.repediu.com.br/v1/stores/{merchantId}/metrics/average-ticket \
  --header 'Authorization: Bearer <token>'

Resposta

{ "value": 47.35 }

Não confunda os dois números: ticketCRM é do período filtrado e só considera vendas via CRM; Ticket médio (metrics/average-ticket) não aceita from/to — é sempre o histórico completo da loja inteira, campanha ou não.

Vendas com cupom e % da receita da loja

Pergunta: quanto da receita da loja veio de vendas com cupom?

Requisição

curl --request GET \
  --url 'https://public-api.repediu.com.br/v1/stores/{merchantId}/coupons?from=2026-08-01&to=2026-08-31&limit=500' \
  --header 'Authorization: Bearer <token>'

receitaComCupom = soma(amount) dos itens de coupons no período
percentualDaReceita = receitaComCupom / receitaLoja * 100

Divida pela receita da loja inteira (sales-daily), não pela receita via CRM — cupons cobrem qualquer venda da loja, não só as atribuídas a campanhas.

Cupons mais usados

Pergunta: quais cupons trazem mais vendas? Agrupe os itens de Cupons pelo campo coupon:

para cada código de cupom:
  pedidos = contagem de vendas com esse coupon
  receita = soma(amount) das vendas com esse coupon
  ticketMedio = receita / pedidos
ordene por pedidos (ou receita) decrescente e pegue o top N

Item de exemplo

{
  "saleId": 1107300,
  "customerId": 18452,
  "coupon": "VOLTE10",
  "amount": 75.90,
  "saleDate": "2026-08-14T23:30:00+00:00"
}

Cruzar customerId com Clientes (CRM) mostra se um cupom está atraindo clientes novos ou só dando desconto para quem já compraria de qualquer forma.

Autenticação

API

CRM do parceiro

Métricas prontas

Casos de uso

Receita, ticket médio e cupons

Receita via CRM e % da receita da loja

Ticket médio: período vs. histórico

Vendas com cupom e % da receita da loja

Cupons mais usados

​Receita via CRM e % da receita da loja

​Ticket médio: período vs. histórico

​Vendas com cupom e % da receita da loja

​Cupons mais usados

Receita via CRM e % da receita da loja

Ticket médio: período vs. histórico

Vendas com cupom e % da receita da loja

Cupons mais usados