| 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 Required Before Answering
Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar
qualquer código de consulta. Se você está respondendo sem ter chamado a
ferramenta abaixo, pare e chame agora.
Buscar documentação atualizada (sempre)
node skills/tray-dev/scripts/search_docs.mjs --topic=produtos-vendidos "<termo da pergunta>"
<TOPIC_SLUG>: ver tabela em skills/tray-dev/SKILL.md.- Use os trechos retornados como fonte primária; este SKILL.md é resumo.
Nota: este recurso é só de leitura (apenas endpoints GET) — não há payload
para validar. Foque em parâmetros de query e paginação.
Antes de responder
Execute estas verificações antes de gerar qualquer payload ou código:
- Confirme o método HTTP e endpoint correto para a operação solicitada.
- Identifique os campos obrigatórios listados neste documento — não omita nenhum.
- Verifique que
access_token não aparece como literal string no código gerado.
- 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
- Gera o código para
GET /products-sold com filtros de data e product_id
- Itera pelas páginas para relatórios completos
- 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
