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.