> ## 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. # Cupons > Vendas em que um cupom foi usado — o código, o valor da venda e quem usou Retorna as vendas da loja em que um **cupom foi usado**: o código do cupom (`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)](/crm-parceiro/clientes), dá para saber se o cupom atraiu clientes novos ou recorrentes. Filtre pelo período da venda com `from`/`to` (datas inclusivas) ou sincronize incrementalmente com `updatedSince`; pagine com `cursor`/`nextCursor`. ## Erros | HTTP | `code` no corpo | Quando acontece | O que fazer | | ----- | --------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------- | | `400` | `BAD_REQUEST` | `from`/`to` mal formatados, janela invertida ou `cursor` inválido | Corrija o parâmetro indicado em `details` | | `401` | `UNAUTHORIZED` | Token ausente, inválido ou expirado | Gere um novo token em [Obter token](/open-delivery/obter-token) | | `403` | `FORBIDDEN` | Token sem o escopo exigido pela rota | Confirme as permissões da credencial com a Repediu | | `404` | `NOT_FOUND` | Merchant inexistente **ou fora do escopo** | Confirme o `id` em [Listar merchants](/open-delivery/listar-merchants) | O pedido completo por trás de cada `saleId` — itens, valores e modalidade. ## OpenAPI ````yaml openapi.yaml GET /v1/stores/{merchantId}/coupons openapi: 3.0.1 info: title: Repediu — API de integração description: >- API de integração da Repediu: rotas Open Delivery 2.0 (capabilities CRM), dado bruto do CRM do parceiro (/v1/stores) e métricas agregadas (/v1/stores/.../metrics). A autenticação usa o fluxo client_credentials: o token identifica a aplicação integradora e dá acesso a todos os estabelecimentos (merchants) que ativaram a integração. version: v2 servers: - url: https://public-api.repediu.com.br description: Produção security: - Bearer: [] paths: /v1/stores/{merchantId}/coupons: get: tags: - CRM do parceiro summary: Cupons description: >- Vendas da loja em que um cupom foi usado — código, valor, data e cliente. Vendas sem cupom não aparecem. operationId: listStoreCoupons parameters: - $ref: '#/components/parameters/MerchantIdPath' - $ref: '#/components/parameters/CrmFrom' - $ref: '#/components/parameters/CrmTo' - name: updatedSince in: query description: >- Retorna apenas registros atualizados a partir deste instante (sincronização incremental). schema: type: string format: date-time - $ref: '#/components/parameters/CrmCursor' - $ref: '#/components/parameters/CrmLimit' responses: '200': description: Página de vendas com cupom do período. content: application/json: schema: $ref: '#/components/schemas/CouponListResponse' example: items: - saleId: 1107300 customerId: 18452 coupon: VOLTE10 amount: 75.9 saleDate: '2026-08-14T23:30:00+00:00' updatedAt: '2026-08-14T23:45:02+00:00' nextCursor: null '400': $ref: '#/components/responses/InvalidDateRange' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/InsufficientScope' '404': $ref: '#/components/responses/MerchantNotFound' components: parameters: MerchantIdPath: name: merchantId in: path required: true description: Identificador (UUID) do merchant — o mesmo id de GET /od/v2/merchants. schema: type: string format: uuid CrmFrom: name: from in: query description: Início do período (data, inclusive). Deve ser anterior ou igual a to. schema: type: string format: date CrmTo: name: to in: query description: Fim do período (data, inclusive). schema: type: string format: date CrmCursor: name: cursor in: query description: >- Cursor opaco da próxima página, retornado em nextCursor. Omita na primeira chamada. schema: type: string CrmLimit: name: limit in: query description: Itens por página. Valores acima de 500 são limitados a 500. schema: type: integer format: int32 default: 100 maximum: 500 schemas: CouponListResponse: type: object properties: items: type: array items: type: object properties: saleId: type: integer format: int32 description: >- Venda com cupom — mesmo id (numérico) do pedido em GET /od/v2/orders/{orderId}. customerId: type: integer format: int32 coupon: type: string description: Código do cupom usado na venda. amount: type: number description: Valor da venda, em reais. saleDate: type: string format: date-time updatedAt: type: string format: date-time nextCursor: type: string nullable: true description: Cursor da próxima página. Null quando não há próxima página. ErrorResponse: type: object properties: code: type: string description: >- Código do erro (BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, INTERNAL_SERVER_ERROR). message: type: string details: type: array nullable: true description: Lista de mensagens de validação, quando aplicável. items: type: string responses: InvalidDateRange: description: from/to mal formatados, janela invertida ou cursor inválido. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: BAD_REQUEST message: One or more validation errors occurred details: - from should be less than or equal to to Unauthorized: description: Token ausente, inválido ou expirado. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: UNAUTHORIZED message: Invalid client credentials. details: null InsufficientScope: description: Token sem o escopo exigido pela rota. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: FORBIDDEN message: The access token does not have the required scope. details: null MerchantNotFound: description: Merchant inexistente ou fora do escopo da aplicação. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: NOT_FOUND message: Merchant not found. details: null securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT description: >- Token de acesso emitido por POST /od/v2/oauth/token (fluxo client_credentials). Envie no header Authorization como `Bearer `. ````