> ## Documentation Index
> Fetch the complete documentation index at: https://docs.repediu.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Receita, ticket médio e cupons

> Como calcular a participação do CRM na receita da loja, ticket médio por período e histórico, e o desempenho de vendas com cupom

Esta página combina duas famílias de rotas: as vendas atribuídas ao relacionamento com o cliente ([Conversões](/crm-parceiro/conversoes)) e o total de vendas da loja, com ou sem campanha ([Vendas diárias](/crm-parceiro/vendas-diarias)). 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)?

```bash Requisição theme={null}
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
```

<Tip>
  Se você só precisa do total (sem o detalhe por venda), [Receita gerada](/metricas/receita-gerada) devolve `receitaCRM` pronta em uma chamada, sem paginar.
</Tip>

## 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)?

```bash Requisição theme={null}
curl --request GET \
  --url https://public-api.repediu.com.br/v1/stores/{merchantId}/metrics/average-ticket \
  --header 'Authorization: Bearer <token>'
```

```json Resposta theme={null}
{ "value": 47.35 }
```

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

## Vendas com cupom e % da receita da loja

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

```bash Requisição theme={null}
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
```

<Warning>
  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.
</Warning>

## Cupons mais usados

**Pergunta:** quais cupons trazem mais vendas?

Agrupe os itens de [Cupons](/crm-parceiro/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
```

```json Item de exemplo theme={null}
{
  "saleId": 1107300,
  "customerId": 18452,
  "coupon": "VOLTE10",
  "amount": 75.90,
  "saleDate": "2026-08-14T23:30:00+00:00"
}
```

<Note>
  Cruzar `customerId` com [Clientes (CRM)](/crm-parceiro/clientes) mostra se um cupom está atraindo clientes novos ou só dando desconto para quem já compraria de qualquer forma.
</Note>