tray-informacoes-adicionais

MANDATORY: Tool Call(s) Required Before Answering

• OBRIGATÓRIO: node skills/tray-dev/scripts/search_docs.mjs "<termo>" — confirme o comportamento da API antes de gerar código.

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 Informação Adicional — Tray

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

Endpoints

Método	Endpoint	Descrição
GET	/additional-info	Listagem geral das informações adicionais
GET	/additional-info/:id	Consultar dados por ID
POST	/additional-info	Cadastrar informação adicional
PUT	/additional-info/:id	Atualizar informação
PUT	/products/:id/additional-info	Atualizar informações relacionadas ao produto
POST	/products/:id/additional-info	Vincular informação adicional ao produto
DELETE	/products/:id/additional-info/:info_id	Excluir relação com produto
DELETE	/additional-info/:id	Excluir informação adicional

Autenticação: ?access_token={token}

Exemplo de Criação

{
  "AdditionalInfo": {
    "name": "Composição",
    "value": "100% Algodão"
  }
}

Vinculação com Produto

Para vincular uma informação adicional a um produto:

POST /products/123/additional-info?access_token={token}

{
  "additional_info_id": 456
}

Boas Práticas

1. Crie antes de vincular — primeiro crie a informação, depois vincule ao produto
2. Reutilize — a mesma informação pode ser vinculada a múltiplos produtos
3. Paginação — limit (máximo 50, padrão 30), page

Como Usar no Claude Code

Exemplos de Prompt

• "adiciona o campo Composição com valor '100% Algodão' ao produto 123"
• "como crio informações adicionais reutilizáveis para múltiplos produtos?"
• "vincula a informação adicional ID 45 aos produtos 101, 102 e 103"
• "lista todas as informações adicionais cadastradas"

O que o Claude faz

1. Gera o código de criação da informação com wrapper AdditionalInfo
2. Gera o código de vinculação ao produto via POST /products/:id/additional-info
3. Explica quando criar nova informação vs. reutilizar uma existente (via ID)
4. Monta o fluxo completo: criar → vincular para múltiplos produtos quando necessário

O que você recebe

• Código de criação com {"AdditionalInfo": {"name": "...", "value": "..."}}
• Código de vinculação com o additional_info_id retornado
• Exemplo de reutilização da mesma informação em múltiplos produtos
• Código de exclusão da relação via DELETE /products/:id/additional-info/:info_id

Pré-requisitos

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