메뉴
API de Informação Adicional da Tray. Utilize quando o desenvolvedor precisar gerenciar campos customizados de informação que podem ser vinculados a produtos, incluindo criação, atualização, vinculação e exclusão.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | tray-informacoes-adicionais |
| description | API de Informação Adicional da Tray. Utilize quando o desenvolvedor precisar gerenciar campos customizados de informação que podem ser vinculados a produtos, incluindo criação, atualização, vinculação e exclusão. |
| when_to_use | Use quando o desenvolvedor mencionar: informação adicional, campo customizado, additional_info, campo extra de produto, POST /additional_infos, vincular informação adicional a produto ou campo personalizado de catálogo. |
| when_not_to_use | Não use para características com filtro de vitrine (use tray-caracteristicas) nem para variações com estoque separado (use tray-variacoes). |
Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar qualquer código ou payload. Se você está respondendo sem ter chamado a ferramenta abaixo, pare e chame agora.
node skills/tray-dev/scripts/search_docs.mjs --topic=informacoes-adicionais "<termo da pergunta>"
<TOPIC_SLUG>: ver tabela em skills/tray-dev/SKILL.md.Nota: este recurso ainda não tem
validate.mjslocal. Você é responsável por revisar campos obrigatórios contra a doc retornada e o resumo abaixo.
Execute estas verificações antes de gerar qualquer payload ou código:
access_token não aparece como literal string no código gerado.when_not_to_use no frontmatter).Documentação oficial: https://developers.tray.com.br/#api-de-informacao-adicional-additional_info
| 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}
{
"AdditionalInfo": {
"name": "Composição",
"value": "100% Algodão"
}
}
Para vincular uma informação adicional a um produto:
POST /products/123/additional-info?access_token={token}
{
"additional_info_id": 456
}
limit (máximo 50, padrão 30), pageAdditionalInfoPOST /products/:id/additional-info{"AdditionalInfo": {"name": "...", "value": "..."}}additional_info_id retornadoDELETE /products/:id/additional-info/:info_idproduct_id disponívelaccess_token configuradoAPI de Informações da Loja da Tray. Utilize quando o desenvolvedor precisar consultar dados de configuração da loja como nome, razão social, CNPJ, endereço, contatos, URLs (domínio) e status interno da loja.
API de Produtos da Tray. Utilize quando o desenvolvedor precisar listar, consultar, cadastrar, atualizar ou excluir produtos no catálogo de uma loja Tray. Inclui todos os campos do produto (nome, preço, estoque, EAN, NCM, dimensões, SEO), filtros de listagem, paginação, ordenação e exclusão de kits.
API de Clientes da Tray. Utilize quando o desenvolvedor precisar gerenciar dados de clientes da loja: listagem, consulta, cadastro, atualização e exclusão. Inclui campos de pessoa física (CPF) e jurídica (CNPJ), validações brasileiras e gestão de newsletter.
API completa de cupons de desconto da Tray (recurso `discount_coupons`). Cobre criar, editar, listar, consultar e excluir cupons (CRUD) e gerenciar os relacionamentos do cupom com clientes, produtos, categorias, marcas, fretes e cupom-presente, além da geração de cupom de troca a partir de um pedido. Total de 21 endpoints. DISAMBIGUATION: o endpoint base é `/discount_coupons` (NÃO `/coupons`) e o wrapper de payload/resposta é `DiscountCoupon` (NÃO `Coupon`). Cupom é desconto por CÓDIGO aplicado no checkout — não confundir com preço permanente por grupo de cliente (lista de preço B2B).
API de Endereços de Clientes da Tray. Utilize quando o desenvolvedor precisar gerenciar os endereços cadastrados dos clientes, incluindo listagem, consulta individual, criação e exclusão. Suporta endereços de entrega e cobrança, com campos completos do padrão brasileiro (CEP, bairro, cidade, estado, complemento).
API de Marcas da Tray. Utilize quando o desenvolvedor precisar gerenciar as marcas (fabricantes) dos produtos da loja, incluindo listagem, consulta individual, criação, atualização e exclusão. Inclui os campos da marca (brand, slug), paginação e filtros.