tray-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 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:

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