# 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.

- Skill: `tray-tecnologia/tray-emissores-etiqueta` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add tray-tecnologia/tray-emissores-etiqueta`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tray-tecnologia/tray-emissores-etiqueta/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tray-tecnologia (https://skillmd.com/u/tray-tecnologia)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tray-tecnologia/tray-emissores-etiqueta

---


## MANDATORY: Tool Call Required Before Answering

> **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**.

### Buscar documentação atualizada (sempre)

```bash
node skills/tray-dev/scripts/search_docs.mjs --topic=emissores-etiqueta "<termo da pergunta>"
```

- `<TOPIC_SLUG>`: ver tabela em `skills/tray-dev/SKILL.md`.
- Use os trechos retornados como fonte primária; este SKILL.md é resumo.

> **Nota:** este recurso ainda não tem `validate.mjs` local. Você é responsável
> por revisar campos obrigatórios contra a doc retornada e o resumo abaixo.

## 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 Emissores de Etiqueta — Tray

Documentação oficial: https://developers.tray.com.br/#api-de-emissores-de-etiqueta

## Endpoints

| Método | Endpoint | Descrição |
|:--|:--|:--|
| POST | `/label-emitters` | Cadastrar URL da etiqueta |
| POST | `/label-emitters/:order_id` | Vincular URL da etiqueta ao pedido |
| DELETE | `/label-emitters/:id` | Excluir URL da etiqueta |

**Autenticação:** `?access_token={token}`

## Fluxo de Uso

1. **Cadastrar a URL** — registre a URL base do seu sistema de etiquetas
2. **Vincular ao pedido** — associe a etiqueta gerada a um pedido específico
3. **Excluir** — remova a etiqueta se necessário

## Exemplo de Cadastro

```http
POST /label-emitters?access_token={token}
Content-Type: application/json

{
  "LabelEmitter": {
    "url": "https://meusistema.com/etiquetas"
  }
}
```

## Exemplo de Vinculação ao Pedido

```http
POST /label-emitters/12345?access_token={token}
Content-Type: application/json

{
  "LabelEmitter": {
    "label_url": "https://meusistema.com/etiquetas/pedido-12345.pdf"
  }
}
```

## Como Usar no Claude Code

### Exemplos de Prompt

- "integra meu sistema de etiquetas externo com a Tray"
- "cadastra a URL do meu emissor de etiquetas e vincula ao pedido 12345"
- "implementa o fluxo completo de geração e vinculação de etiquetas ao pedido"

### O que o Claude faz

1. Gera o código de cadastro da URL base do emissor com `POST /label-emitters`
2. Gera o código de vinculação da etiqueta ao pedido com `POST /label-emitters/:order_id`
3. Guia o fluxo de 3 etapas: cadastrar URL → vincular ao pedido → excluir se necessário

### O que você recebe

- Código de cadastro da URL do emissor com wrapper `LabelEmitter`
- Código de vinculação de etiqueta PDF gerada ao pedido
- Código de exclusão via `DELETE /label-emitters/:id`

### Pré-requisitos

- `access_token` configurado
- URL do sistema externo de geração de etiquetas
- `order_id` do pedido para vinculação