Tray Produtos

MANDATORY: Tool Calls Required Before Answering

Estas chamadas são OBRIGATÓRIAS, não opcionais. Execute-as antes de gerar qualquer código ou payload. Se você está respondendo sem ter chamado as duas ferramentas abaixo, pare e chame agora.

1. Buscar documentação atualizada (sempre)

node skills/tray-dev/scripts/search_docs.mjs --topic=produtos "<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.

2. Validar payload localmente (antes de retornar código)

node skills/produtos/scripts/validate.mjs --schema=<SCHEMA_NAME> '<payload_json>'

• Schemas disponíveis: produto.create, produto.update. Use --list-schemas para confirmar.
• Exit codes: 0 válido · 1 inválido · 2 erro de uso.
• Para output programático: --json.
• Corrija todos os erros antes de retornar o código (até 3 tentativas).

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 — 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)