tray-autorizacaoAutenticação e autorização na API da Tray. Utilize quando o desenvolvedor precisar implementar o fluxo OAuth 2.0, gerar chaves de acesso (access_token), renovar tokens expirados via refresh_token, ou tratar erros de autenticação na plataforma Tray. Inclui o fluxo completo de 3 etapas, campos de resp
tray-caracteristicasAPI de Características de Produtos da Tray. Utilize quando o desenvolvedor precisar gerenciar características (propriedades) dos produtos, incluindo cadastro, atualização, consulta e exclusão. Permite criar características globais reutilizáveis e associar valores específicos a cada produto (ex: cor,
tray-carrinho-comprasAPI de carrinho de compras da Tray. Permite criar, consultar, atualizar e excluir carrinhos, incluindo suporte a kits de produtos. Contém 6 endpoints. Use quando o desenvolvedor mencionar: carrinho, cart, adicionar ao carrinho, GET /carts, POST /carts, PUT /carts, remover do carrinho, carrinho aband
tray-categoriasAPI de Categorias da Tray. Utilize quando o desenvolvedor precisar gerenciar a árvore de categorias da loja, incluindo consulta hierárquica, criação de subcategorias, reordenação e exclusão. Inclui consulta de árvore completa e dados individuais por ID. Use quando o desenvolvedor mencionar: categori
tray-clientesAPI 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. Use quando o desenvolvedor mencionar: cli
tray-configuracao-freteAPI de Configuração de Frete da Tray. Utilize quando o desenvolvedor precisar gerenciar métodos de envio e tabelas de faixa de CEP da loja, incluindo criação, atualização e exclusão de formas de envio e suas respectivas tabelas de CEP com faixas de peso, preços e prazos. Essencial para configurar re
tray-cuponsAPI 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
tray-emissores-etiquetaAPI de Emissores de Etiqueta da Tray. Utilize quando o desenvolvedor precisar integrar geração de etiquetas de envio, cadastrando URLs de etiqueta e vinculando-as a pedidos. Use quando o desenvolvedor mencionar: emissor de etiqueta, label issuer, cadastrar URL de etiqueta, vincular etiqueta a pedido
tray-enderecos-clienteAPI 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,
tray-etiquetas-hubAPI de Etiquetas do HUB da Tray. Utilize quando o desenvolvedor precisar criar ou consultar etiquetas de envio através do sistema HUB de integração logística da Tray. Use quando o desenvolvedor mencionar: etiqueta HUB, hub label, etiqueta de envio HUB, POST /orders/:id/labels/hub, integração logísti
tray-etiquetas-mercado-livreAPI de Etiquetas do Mercado Livre da Tray. Utilize quando o desenvolvedor precisar consultar etiquetas de envio geradas pelo Mercado Livre para pedidos originados neste marketplace. Use quando o desenvolvedor mencionar: etiqueta Mercado Livre, ML label, etiqueta ML, GET /orders/:id/labels/mercadoliv
tray-freteAPI de cotação e listagem de frete da Tray (recurso `shippings`, somente leitura). Cobre dois endpoints GET: `/shippings/cotation/` calcula valor e prazo de entrega para um ou mais produtos rumo a um CEP, consultando os gateways de frete configurados na loja (Frete-X API, Correios, transportadoras);
tray-imagens-produtosAPI de Imagens de Produtos e Variações da Tray. Utilize quando o desenvolvedor precisar fazer upload, atualizar ou remover imagens de produtos e variações. Inclui formatos aceitos, método de envio e posicionamento de imagens. Use quando o desenvolvedor mencionar: imagem de produto, upload de imagem,
tray-informacoes-adicionaisAPI 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. Use quando o desenvolvedor mencionar: informação adicional, campo customizado, addition
tray-informacoes-lojaAPI 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. Use quando o desenvolvedor mencionar: informações da loja, dados da loja, GET /info, domínio
tray-kitsAPI de Kits de Produtos da Tray. Utilize quando o desenvolvedor precisar gerenciar kits (combos/bundles) de produtos, incluindo listagem, consulta individual, criação e atualização. Permite agrupar múltiplos produtos em um único kit com quantidades específicas, ideal para combos promocionais e pacot
tray-listagem-carrinhoNova API de Listagem de Carrinho da Tray. Utilize quando o desenvolvedor precisar listar todos os carrinhos de compra da loja com paginação. Endpoint separado da API principal de carrinho. Use quando o desenvolvedor mencionar: listar carrinhos, listagem de carrinhos, GET /carts/list, carrinhos aband
tray-listas-preco-b2bAPI de Lista de Preço B2B da Tray. Utilize quando o desenvolvedor precisar gerenciar tabelas de preço diferenciadas para clientes B2B e atacado, incluindo criação de listas, gestão de valores por produto/variação. Use quando o desenvolvedor mencionar: lista de preço B2B, tabela de preço, preço ataca
tray-marcasAPI 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. Use quando o desenvolvedor mencionar: marca,
tray-multicdAPI de Multi-CD (Centros de Distribuição) da Tray. Cobre o CRUD de centros de distribuição (`/multicd/distribution-centers`: listar, consultar, criar, atualizar e excluir CDs) e a gestão de estoque distribuído por CD (`/multicd/stock/detailed/product/:id`, `/multicd/stock/detailed/variant/:id` e `PU
tray-newsletterAPI de Newsletter da Tray. Utilize quando o desenvolvedor precisar gerenciar assinaturas de newsletter da loja, incluindo listagem de assinantes, inscrição e confirmação de cadastro. Use quando o desenvolvedor mencionar: newsletter, assinatura de e-mail, opt-in, GET /newsletters, POST /newsletters,
tray-notas-fiscaisAPI de Notas Fiscais (NF-e) da Tray. Utilize quando o desenvolvedor precisar gerenciar notas fiscais eletrônicas associadas a pedidos, incluindo listagem geral, consulta por ID, consulta por pedido, criação e atualização. Inclui campos como número, série, chave de acesso, CFOP, link do DANFE e valor
tray-pagamentosAPI de informações de pagamento da Tray (recurso `payments`). Cobre listar, consultar, criar, atualizar e excluir registros de pagamento (CRUD em `/payments`), além de consultar as opções de pagamento ativas da loja (`/payments/options`) e as configurações globais de pagamento (`/payments/settings`)
tray-palavras-chaveAPI de Palavras-Chave da Tray. Utilize quando o desenvolvedor precisar consultar palavras-chave de SEO associadas à loja. API somente leitura. Use quando o desenvolvedor mencionar: palavras-chave, SEO, keyword, GET /keywords, termos de busca da loja, otimização de busca ou palavras buscadas na vitri
tray-parceirosAPI de Parceiros da Tray. Utilize quando o desenvolvedor precisar gerenciar parceiros/revendedores da loja, incluindo listagem, consulta, cadastro, atualização e exclusão. Use quando o desenvolvedor mencionar: parceiro, revendedor, partner, GET /partners, POST /partners, cadastrar parceiro, canal de
tray-pedidosAPI de Pedidos da Tray. Utilize quando o desenvolvedor precisar gerenciar o ciclo completo de pedidos: listagem com filtros, consulta de dados simples e completos, criação, atualização, cancelamento, e gestão de produtos dentro do pedido. Inclui todos os campos, status e fluxos de pedido. Use quando
tray-perfis-clienteAPI de Perfis de Clientes da Tray. Utilize quando o desenvolvedor precisar gerenciar perfis (grupos/segmentos) de clientes da loja, incluindo criação, consulta, atualização, exclusão e associação/desassociação de clientes a perfis. Útil para segmentação de clientes, preços diferenciados (B2B/B2C) e
tray-produtos-vendidosAPI de Produtos Vendidos da Tray. Utilize quando o desenvolvedor precisar consultar o histórico de vendas e analytics de produtos vendidos na loja. API somente leitura com filtros de data. Use quando o desenvolvedor mencionar: produtos vendidos, analytics de vendas, histórico de vendas, GET /sold_pr
tray-produtosAPI 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.
tray-scripts-externosAPI de Scripts Externos da Tray. Utilize quando o desenvolvedor precisar gerenciar scripts JavaScript customizados injetados na vitrine da loja, incluindo listagem, cadastro, atualização e exclusão. Use quando o desenvolvedor mencionar: script externo, JavaScript na vitrine, tag de pixel, GET /exter
tray-status-pedidoAPI de Status de Pedido da Tray (recurso `/orders/statuses`). Cobre o CRUD completo do CATÁLOGO de status de pedido da loja: listar, consultar por ID, criar, atualizar e excluir tipos de status, definindo nome, descrição, cores hexadecimais (`background_color`/`font_color`) e o tipo de fluxo (`type`
tray-devSkill de busca em developers.tray.com.br. Utilize quando o desenvolvedor precisar de informações atualizadas sobre endpoints, parâmetros, formatos ou exemplos da API Tray oficial. Substitui referências estáticas envelhecidas por busca local sobre snapshot fresco da SPA.
tray-usuariosAPI de Usuários da Tray. Utilize quando o desenvolvedor precisar listar os usuários administrativos da loja. API somente leitura. Use quando o desenvolvedor mencionar: usuário administrativo, usuário da loja, GET /users, listar usuários, administrador da Tray ou user_id da loja. Não use para cliente
tray-variacoesAPI de Variações de Produtos da Tray. Utilize quando o desenvolvedor precisar gerenciar variantes de produtos (SKUs) como diferentes tamanhos, cores ou modelos. Inclui listagem, consulta, cadastro, atualização, exclusão e informações sobre limitações de variações por produto. Use quando o desenvolve
tray-visao-geralSkill de entrada para qualquer trabalho de integração com a API da Tray. Estabelece as regras invariantes da plataforma (OAuth como query param, payloads envolvidos na chave do recurso, expiração de tokens, rate limit, validação de dados brasileiros) e orienta para a skill específica do recurso. Sem
tray-webhooksSistema de Notificação (Webhook) da Tray. Utilize quando o desenvolvedor precisar implementar notificações em tempo real para alterações em produtos, pedidos, clientes, variações e configurações da loja. Inclui todos os escopos suportados, formato de payload, lógica de retry e boas práticas de imple