claudecodex

tray-api

Plugin completo para integração com as APIs da Tray. Acelera o desenvolvimento de aplicativos e-commerce por parceiros e comunidade na plataforma Tray, fornecendo documentação detalhada de todos os endpoints, fluxos de autenticação OAuth, webhooks e boas práticas de integração.

15 on GitHubby Rodolfo Moraesv2.1.0MITupdated 3 months ago

Not in a marketplace yet, so it loads for one session with --plugin-dir.

Plugin tray-api in tray-tecnologia/tray-api-ai-plugin. Commands read from the repo's manifest — 1 month ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use and it starts local MCP servers. The exact commands are listed below; read them before installing.

What it installs

Skills (36)

  • tray-autorizacao

    Autenticaçã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-caracteristicas

    API 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-compras

    API 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-categorias

    API 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-clientes

    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. Use quando o desenvolvedor mencionar: cli

  • tray-configuracao-frete

    API 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-cupons

    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

  • tray-emissores-etiqueta

    API 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-cliente

    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,

  • tray-etiquetas-hub

    API 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-livre

    API 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-frete

    API 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-produtos

    API 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-adicionais

    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. Use quando o desenvolvedor mencionar: informação adicional, campo customizado, addition

  • tray-informacoes-loja

    API 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-kits

    API 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-carrinho

    Nova 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-b2b

    API 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-marcas

    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. Use quando o desenvolvedor mencionar: marca,

  • tray-multicd

    API 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-newsletter

    API 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-fiscais

    API 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-pagamentos

    API 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-chave

    API 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-parceiros

    API 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-pedidos

    API 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-cliente

    API 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-vendidos

    API 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-produtos

    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.

  • tray-scripts-externos

    API 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-pedido

    API 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-dev

    Skill 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-usuarios

    API 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-variacoes

    API 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-geral

    Skill 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-webhooks

    Sistema 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

Slash commands (3)

  • /tray-api:referencia-api

    Referência rápida de todos os endpoints da API da Tray, aceita nome do recurso como filtro

  • /tray-api:setup

    Guia rápido para configuração inicial de integração com a API da Tray

  • /tray-api:validar-integracao

    Valida o código de integração com a Tray verificando problemas comuns e boas práticas

Subagents (6)

  • AGENTES
  • assistente-migracao

    Especialista em migração de dados para a Tray. Utilize quando precisar migrar dados de outras plataformas de e-commerce (Shopify, WooCommerce, Magento, VTEX, Nuvemshop, etc.) para a Tray, incluindo produtos, clientes, pedidos e categorias.

  • configuracao-aplicativo

    Assistente guiado para configuração inicial de aplicativos que integram com a API da Tray. Utilize quando um desenvolvedor está iniciando um novo projeto de integração e precisa de ajuda com configuração OAuth, primeiras chamadas à API, configuração de webhooks e estrutura inicial do aplicativo.

  • debug-integracao

    Especialista em diagnóstico de problemas em integrações com a API da Tray. Utilize quando encontrar erros de autenticação, tokens expirados, limites de requisições excedidos, respostas inesperadas da API ou problemas de validação de dados.

  • gestor-catalogo

    Especialista em gestão de catálogo na Tray. Utilize para operações em massa de produtos, variações, categorias, marcas, imagens e kits. Auxilia em importação de CSV, sincronização de estoque, reestruturação de categorias e gestão de centros de distribuição (MultiCD).

  • gestor-pedidos

    Especialista em gestão de pedidos na Tray. Utilize para operações complexas envolvendo o ciclo completo do pedido: criação, atualização de status, emissão de notas fiscais, geração de etiquetas de envio e fluxo de cancelamento.

MCP servers (1)

  • tray

    runs: npx -y --package=@tray-tecnologia/tray-api-plugin tray-mcp

Hooks (1)

  • PostToolUse
View source on GitHub developers.tray.com.br

Problems found in this repo's manifests

  • .claude-plugin/marketplace.json is not valid JSON

Similar plugins

Business operations command center for Claude Code — 30 skills, 14 agents, smart background daemon. Manage communications (WhatsApp/Email/Slack/Telegram), projects, infrastructure (AWS), revenue (Stripe+RevenueCat), e-commerce, marketing, monitoring (Datadog/New Relic/OTEL), and voice. Includes /gtm go-to-market planner, /ops:projects portfolio dashboard, and 4 parallel C-suite agents (YOLO mode).

30 skills · 14 agents · hooks

davepoon/buildwithclaude 3,741

Claude Code skill pack for Shopify (38 skills covering e-commerce development, storefront APIs, and app integration)

38 skills

jeremylongshore/tons-of-skills-marketplace 2,917

Praxisplugin Fashion Law/Moderecht für Modeunternehmen, Designer, Händler und Kanzleien: IP, Designs, Marken, Textilkennzeichnung, Produktsicherheit, Nachhaltigkeit, Lieferkette, Plattformen, E-Commerce, Vertrieb, Influencer und Krisen.

51 skills

Klotzkette/claude-fuer-deutsches-recht 1,829

Official remote MCP server and skill for read-only shopping decisions, product search, Greek merchant offers with delivered totals, and price history from BestPrice.gr.

1 skill · 1 MCP server

hashgraph-online/awesome-codex-plugins 1,566

E-commerce & retail skills that sell: Product Description, Marketplace Listing Optimizer, Return & Refund Policy, Promotion Plan, Review Response, and Category Page Brief. Listings that rank and convert, promos with the margin math, and reviews handled well.

7 skills

mohitagw15856/pm-claude-skills 1,544

sangse

claude

Korean e-commerce detail page builder — product facts → verified image cut sheet (Kurly/Coupang/Smart Store style) with 8-question copy, compliance filters and a 3-gate QA

fivetaku/gptaku_plugins 1,298

Maintain tray-api?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex pluginslisted