tray-etiquetas-hub

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 Etiquetas do HUB — Tray

Documentação oficial: https://developers.tray.com.br/#api-de-etiquetas-do-hub

Endpoints

Método	Endpoint	Descrição
POST	/labels	Criar etiquetas
GET	/labels	Consultar etiquetas

Autenticação: ?access_token={token}

Criação de Etiquetas

POST /labels?access_token={token}
Content-Type: application/json

{
  "Label": {
    "order_id": 12345
  }
}

Consulta de Etiquetas

GET /labels?access_token={token}&order_id=12345

Observação

O sistema HUB é a integração logística interna da Tray para geração centralizada de etiquetas de envio.

Como Usar no Claude Code

Exemplos de Prompt

• "gera a etiqueta de envio para o pedido 12345 via HUB da Tray"
• "consulta as etiquetas geradas para o pedido 12345"
• "implementa a geração automática de etiquetas após confirmação de pagamento"

O que o Claude faz

1. Gera o código de criação de etiqueta com POST /labels e o order_id
2. Gera o código de consulta com GET /labels?order_id=...
3. Orienta sobre o funcionamento do sistema HUB da Tray

O que você recebe

• Código de criação de etiqueta com wrapper {"Label": {"order_id": ...}}
• Código de consulta por pedido
• Orientação sobre integração com o fluxo de pedidos

Pré-requisitos

• access_token configurado
• Loja com HUB logístico ativo na Tray
• order_id do pedido com pagamento confirmado