From tray-api
Manages Tray NF-e fiscal notes for orders: lists with pagination/filters, queries by ID or order ID, creates, updates. Handles number, series, access key, CFOP, DANFE link, total value for ERP integrations.
npx claudepluginhub tray-tecnologia/tray-api-ai-plugin --plugin tray-apiThis skill uses the workspace's default tool permissions.
> Execute estas verificações antes de gerar qualquer payload ou código:
Monitors deployed URLs for regressions after deploys, merges, or upgrades by checking HTTP status, console errors, network failures, performance (LCP/CLS/INP), content, and API health.
Share bugs, ideas, or general feedback.
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-nota-fiscal
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /invoices | Listagem de notas fiscais com paginação e filtros |
| GET | /invoices/:id | Consultar nota fiscal por ID |
| GET | /orders/:order_id/invoices | Consultar notas fiscais de um pedido |
| POST | /orders/:order_id/invoices | Cadastrar nota fiscal para um pedido |
| PUT | /invoices/:id | Atualizar dados da nota fiscal |
Autenticação: ?access_token={token} em todas as chamadas.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | — | ID da nota fiscal (retornado pela API) |
order_id | number | — | ID do pedido associado (definido na URL no POST) |
number | string | Sim | Número da nota fiscal |
series | string | Sim | Série da nota fiscal (ex: "1", "001") |
issue_date | date | Sim | Data de emissão (formato: YYYY-MM-DD) |
key | string | Sim | Chave de acesso da NF-e (44 dígitos) |
cfop | string | Não | Código Fiscal de Operações e Prestações (ex: "5102", "6102") |
link | string | Não | URL do DANFE (PDF da nota fiscal) |
total_amount | decimal | Não | Valor total da nota fiscal |
created_at | datetime | — | Data de criação do registro |
updated_at | datetime | — | Data da última atualização |
| Parâmetro | Descrição |
|---|---|
limit | Itens por página (máximo 50, padrão 30) |
page | Número da página |
Resposta inclui: total, page, offset, limit, maxLimit
| Filtro | Tipo | Descrição |
|---|---|---|
order_id | number | Filtrar por ID do pedido |
number | string | Filtrar por número da NF |
issue_date | date | Filtrar por data de emissão |
created_at | date | Filtrar por data de criação |
{
"Invoice": {
"number": "000123456",
"series": "1",
"issue_date": "2026-03-21",
"key": "35260312345678000100550010001234561234567890",
"cfop": "5102",
"link": "https://exemplo.com/danfe/123456.pdf",
"total_amount": "299.90"
}
}
{
"Invoice": {
"link": "https://exemplo.com/danfe/123456-v2.pdf",
"total_amount": "310.50"
}
}
| Operação | Código | Mensagem |
|---|---|---|
| Criação | 201 | {"message": "Created", "id": 500, "code": 201} |
| Atualização | 200 | {"message": "Saved", "id": 500, "code": 200} |
{
"paging": {
"total": 150,
"page": 1,
"offset": 0,
"limit": 30,
"maxLimit": 50
},
"Invoices": [
{
"Invoice": {
"id": "500",
"order_id": "1001",
"number": "000123456",
"series": "1",
"issue_date": "2026-03-21",
"key": "35260312345678000100550010001234561234567890",
"cfop": "5102",
"link": "https://exemplo.com/danfe/123456.pdf",
"total_amount": "299.90",
"created_at": "2026-03-21 10:30:00",
"updated_at": "2026-03-21 10:30:00"
}
}
]
}
{
"Invoices": [
{
"Invoice": {
"id": "500",
"order_id": "1001",
"number": "000123456",
"series": "1",
"issue_date": "2026-03-21",
"key": "35260312345678000100550010001234561234567890",
"cfop": "5102",
"link": "https://exemplo.com/danfe/123456.pdf",
"total_amount": "299.90"
}
}
]
}
A chave de acesso (key) possui 44 dígitos e contém informações codificadas:
| Posição | Tamanho | Descrição |
|---|---|---|
| 1-2 | 2 | Código da UF |
| 3-6 | 4 | Ano e mês de emissão (AAMM) |
| 7-20 | 14 | CNPJ do emitente |
| 21-22 | 2 | Modelo do documento (55 = NF-e) |
| 23-25 | 3 | Série |
| 26-34 | 9 | Número da NF |
| 35-43 | 9 | Código numérico |
| 44 | 1 | Dígito verificador |
| CFOP | Descrição |
|---|---|
5102 | Venda de mercadoria (operação interna — mesmo estado) |
6102 | Venda de mercadoria (operação interestadual) |
5405 | Venda de mercadoria com ST (substituição tributária) — mesmo estado |
6404 | Venda de mercadoria com ST — interestadual |
tray-pedidos para gerenciar pedidos associadosInvoice e todos os campos obrigatóriosPOST /orders/:order_id/invoices com o order_id na URLorder_id para listagensGET /orders/:order_id/invoicesaccess_token configuradoorder_id do pedido já existente na Tray