tray-notas-fiscais

Manage NF-e invoices for Tray orders via REST API endpoints.

14|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tray-tecnologia/tray-api-claude-plugin --skill tray-notas-fiscais
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tray-notas-fiscais
Source: https://github.com/tray-tecnologia/tray-api-claude-plugin/tree/main/skills/notas-fiscais
Command: npx skills add https://github.com/tray-tecnologia/tray-api-claude-plugin --skill tray-notas-fiscais

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides clear, actionable API documentation and usage guidance to manage electronic invoices (NF-e) associated with Tray orders, removing ambiguity when listing, querying, creating, or updating fiscal documents during e-commerce integrations.

Core Features & Use Cases

  • List and paginate invoices using GET /invoices with filtering by order, number and dates to retrieve billing records at scale.
  • Query by ID or order via GET /invoices/:id and GET /orders/:order_id/invoices to reconcile orders with their fiscal documents.
  • Create and update NF-e records using POST /orders/:order_id/invoices and PUT /invoices/:id with the Invoice wrapper and common fiscal fields (number, series, issue_date, key, cfop, link, total_amount).
  • Validation and best practices including enforcement of the 44-digit key format, use of public DANFE links, and recommended integration patterns with ERPs for automated fiscal workflows.

Quick Start

Register an NF-e for order 1001 by providing a valid 44-digit access key, number, series, issue_date and a public DANFE link using the POST /orders/1001/invoices endpoint with your access_token set.

Frequently Asked Questions about tray-notas-fiscais

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an NF-e electronic invoice for a Tray order via API?

To create an NF-e electronic invoice for a Tray order, send a POST request to the /orders/:order_id/invoices endpoint. You must wrap your payload in an Invoice object and include a valid 44-digit access key, number, series, issue_date, and a public DANFE link.

What is the required format for an NF-e access key in Tray API integrations?

The required format for an NF-e access key in Tray API integrations is a strict 44-digit numerical string. Validating this 44-digit key format before submitting your POST or PUT request ensures the electronic invoice payload is accepted without errors.

Can I list and filter Tray electronic invoices in bulk for ERP integration?

Yes, you can list and filter Tray electronic invoices in bulk for ERP integration using the GET /invoices endpoint. This endpoint supports pagination and filtering by order, invoice number, and dates to retrieve billing records at scale.

How do I query a specific Tray order to find its associated fiscal documents?

To query a specific Tray order and find its associated fiscal documents, call the GET /orders/:order_id/invoices endpoint. This retrieves all NF-e electronic invoices linked to that particular order for reconciliation.

Does the Tray NF-e API support updating existing electronic invoice records?

Yes, the Tray NF-e API supports updating existing electronic invoice records using the PUT /invoices/:id endpoint. You can modify common fiscal fields like number, series, issue_date, key, cfop, and total_amount after creation.

What authentication is needed to manage Tray invoices through API endpoints?

To manage Tray invoices through API endpoints, you need an access_token set as a query authentication parameter. This token authorizes all requests to list, query, create, and update NF-e records.