Tray Variacoes

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 Variações de Produtos — Tray

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

Endpoints

Autenticação: ?access_token={token}

Campos da Variação

Herança de Dados

Quando um campo não é informado na variação, ele herda o valor do produto pai. Isso se aplica a: price, weight, length, width, height.

Limitação de Variações por Produto

A plataforma Tray impõe um limite de variações por produto. Consulte a seção "Limitação de variações por produto" na documentação oficial para os limites atuais.

Corpo da Requisição (POST/PUT)

{
  "Variant": {
    "product_id": 123,
    "ean": "7891234567890",
    "price": "89.90",
    "stock": 50,
    "values": [
      {"name": "Cor", "value": "Azul"},
      {"name": "Tamanho", "value": "M"}
    ]
  }
}

Paginação

Mesmos parâmetros da API de Produtos: limit (máximo 50, padrão 30), page.

Imagens de Variação

As imagens de variação são gerenciadas pela API de Imagens separada (POST /variants/:id/images). Consulte o skill tray-imagens-produtos.

Como Usar no Claude Code

Exemplos de Prompt

• "adiciona variações de tamanho e cor ao produto 456"
• "atualiza o estoque da variação tamanho M cor azul"
• "lista todas as variações do produto 123"
• "como crio variações com preço e estoque individuais?"

O que o Claude faz

1. Gera o código com o wrapper Variant e o product_id do produto pai
2. Monta o array values com os atributos (cor, tamanho, modelo, etc.)
3. Define campos individuais da variação (preço, estoque, EAN) quando necessário
4. Explica a herança de dados do produto pai para campos não informados

O que você recebe

• Código de criação de variação com wrapper {"Variant": {...}} correto
• Array values montado com os atributos desejados
• Lógica de herança explicada (quais campos herdam do produto pai)
• Exemplo de listagem por product_id

Pré-requisitos

• Produto pai já cadastrado com o product_id disponível
• access_token configurado