Produtos Vendidos

---
name: tray-produtos-vendidos
description: >
  API de Produtos Vendidos da Tray. Utilize quando o desenvolvedor
  precisar consultar o histórico de vendas e analytics de produtos vendidos
  na loja. API somente leitura com filtros de data.
when_to_use: >
  Use quando o desenvolvedor mencionar: produtos vendidos, analytics de vendas,
  histórico de vendas, GET /sold_products, relatório de produtos, mais vendidos,
  performance de produto ou filtrar vendas por período.
when_not_to_use: >
  Não use para listar pedidos em aberto (use tray-pedidos). API somente leitura para
  analytics de produtos vendidos.
---

## MANDATORY: Tool Call(s) Required Before Answering

- **OBRIGATÓRIO:** `node skills/tray-dev/scripts/search_docs.mjs "<termo>"` — confirme o comportamento da API antes de gerar código.

## Antes de responder

> Execute estas verificações antes de gerar qualquer payload ou código:

1. Confirme o método HTTP e endpoint correto para a operação solicitada.
2. Identifique os campos obrigatórios listados neste documento — não omita nenhum.
3. Verifique que `access_token` não aparece como literal string no código gerado.
4. Confirme que esta é a skill correta para o recurso (leia `when_not_to_use` no frontmatter).

# API de Produtos Vendidos — Tray

Documentação oficial: https://developers.tray.com.br/#apis-de-produtos-vendidos

## Endpoints

| Método | Endpoint | Descrição |
|:--|:--|:--|
| GET | `/products-sold` | Listagem de produtos vendidos |

**Autenticação:** `?access_token={token}`

**Somente leitura** — esta API não permite criação, atualização ou exclusão.

## Filtros

| Parâmetro | Descrição |
|:--|:--|
| `created` | Filtrar por data de venda |
| `product_id` | Filtrar por produto |

## Paginação

`limit` (máximo 50, padrão 30), `page`.

## Uso

Ideal para relatórios de vendas, analytics e dashboards. Consulte periodicamente para manter dados atualizados.

## Como Usar no Claude Code

### Exemplos de Prompt

- "gera um relatório dos produtos mais vendidos no último mês"
- "consulta o histórico de vendas do produto 123"
- "implementa um dashboard de analytics de vendas por produto"

### O que o Claude faz

1. Gera o código para `GET /products-sold` com filtros de data e `product_id`
2. Itera pelas páginas para relatórios completos
3. Organiza os dados para exibição em dashboard ou exportação

### O que você recebe

- Código de consulta com filtros de data (`created`) e produto (`product_id`)
- Lógica de paginação para exportação completa do histórico
- Estrutura para relatório de produtos mais vendidos

### Pré-requisitos

- `access_token` configurado