Tray Produtos

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).
5. Execute node skills/produtos/scripts/validate.mjs '<payload_json>' para confirmar a estrutura do payload que vai gerar. O validador checa apenas estrutura (campos obrigatórios, tipos e campos desconhecidos), nunca valores reais — então monte um payload sintético com placeholders sempre que os valores vierem de variáveis de ambiente, da entrada do usuário ou de outras chamadas. Exemplo: node skills/produtos/scripts/validate.mjs '{"Product":{"name":"<nome>","price":"<preço>"}}'. Corrija todos os erros antes de retornar o código ao usuário. Até 3 tentativas — se persistir, explique o problema ao usuário.

API de Produtos — Tray

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

Endpoints

Autenticação: ?access_token={token} em todas as chamadas.

Campos do Produto

Dados Básicos

Preços

Dimensões e Peso

Estoque e Disponibilidade

Classificação

Exibição e Marketing

SEO

Paginação

Resposta inclui: total, page, offset, limit, maxLimit

Filtros de Listagem

id, name, reference, ean, category_id, brand, available, available_in_store, stock, price, price_range, promotion, free_shipping, release, hot, quantity_sold, created, modified

Ordenação: parâmetro sort com nome do campo. rand para aleatório.

Corpo da Requisição (POST/PUT)

O body JSON deve envolver os dados na chave "Product":

{
  "Product": {
    "name": "Camiseta Exemplo",
    "price": "99.90",
    "stock": 100,
    "category_id": 1,
    "available": 1
  }
}

Respostas

Resposta de Consulta Individual

O endpoint GET /products/:id retorna o objeto Product com dados adicionais:

• Properties — características do produto
• payment_option_details — opções de parcelamento
• related_categories — categorias associadas
• all_categories — todas as categorias
• ProductImage — array de imagens com thumbnails (30px, 90px, 180px em HTTP e HTTPS)
• Variant — array de variações do produto

Como Usar no Claude Code

Exemplos de Prompt

• "cadastra um novo produto na loja com preço, estoque e categoria"
• "atualiza o estoque e o preço promocional do produto ID 123"
• "lista todos os produtos sem estoque disponível"
• "como filtro produtos por categoria e faixa de preço?"

O que o Claude faz

1. Identifica a operação desejada (criar, atualizar, listar ou consultar)
2. Gera o código com o wrapper Product obrigatório no body
3. Inclui os campos relevantes para o caso de uso (preço, estoque, dimensões, SEO)
4. Adiciona paginação e filtros se for listagem

O que você recebe

• Código funcional da chamada à API com todos os campos necessários
• Wrapper {"Product": {...}} correto no body
• Parâmetros de paginação (limit, page) e filtros aplicados
• Tratamento da resposta com os IDs gerados

Pré-requisitos

• access_token configurado
• category_id válido se for criar produto (use tray-categorias antes)
• brand_id válido se quiser associar marca (use tray-marcas antes)