Menu
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.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
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.
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.
| name | tray-etiquetas-mercado-livre |
| description | 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. |
| when_to_use | Use quando o desenvolvedor mencionar: etiqueta Mercado Livre, ML label, etiqueta ML, GET /orders/:id/labels/mercadolivre, pedido Mercado Livre, envio ML ou rastreio Mercado Livre. |
| when_not_to_use | Não use para etiquetas do HUB Tray (use tray-etiquetas-hub) nem para etiquetas de transportadoras externas (use tray-emissores-etiqueta). API somente leitura. |
Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar qualquer código de consulta. Se você está respondendo sem ter chamado a ferramenta abaixo, pare e chame agora.
node skills/tray-dev/scripts/search_docs.mjs --topic=etiquetas-mercado-livre "<termo da pergunta>"
<TOPIC_SLUG>: ver tabela em skills/tray-dev/SKILL.md.Nota: este recurso é só de leitura (apenas endpoints GET) — não há payload para validar. Foque em parâmetros de query e paginação.
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-etiqueta-do-mercado-livre
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /mercado-livre/labels | Consultar etiquetas do Mercado Livre |
Autenticação: ?access_token={token}
Este endpoint permite consultar as etiquetas de envio geradas automaticamente pelo Mercado Livre para pedidos originados neste marketplace e integrados à loja Tray.
GET /mercado-livre/labels?access_token={token}
Somente leitura. As etiquetas são geradas pelo Mercado Livre e não podem ser criadas via API Tray.
GET /mercado-livre/labelsaccess_token configurado