- Getting started
- Introduction
Getting started
Introduction
Issue NF-e for multiple companies from a single Treeunfe integration.
The NF-e Enterprise API is for anyone who issues NF-e model 55 (Brazilian electronic invoices) on behalf of multiple companies from a single system. With an Enterprise account, you register each issuing company, generate its credentials, and issue invoices through the API. By default, Treeunfe calculates the taxes from the company’s fiscal configuration.
What you can do with the API
- Register, edit, and deactivate issuing companies.
- Generate API Keys for each company, in the sandbox or in production.
- Send the company a link to fill in its own fiscal configuration.
- Issue NF-e, with or without automatic tax calculation.
- Cancel invoices and issue correction letters.
- Maintain each company’s customers, products, carriers, and digital certificate.
How the API is organized
The API has two access levels:
| Level | What it represents | Credential | What it does |
|---|---|---|---|
| Enterprise | Your account, which groups the issuing companies | x-enterprise-key | Creates and edits organizations, generates API Keys, creates fiscal configuration links |
| Organization | Each issuing company | x-api-key | Issues NF-e, registers events, maintains records and the digital certificate |
Each organization has its own API Keys, records, and digital certificate. One organization’s invoices never mix with another’s.
Quickstart
From the organization to the first NF-e in the sandbox.
Authentication
When to use each credential.
Issuing NF-e
With or without automatic tax calculation.
API Reference
Every endpoint, with a playground.
Want to issue NF-e from Claude or another AI agent? See the Treeunfe MCP.
Base URL
https://api.treeunfe.com.br/api/v1
All requests and responses use JSON (Content-Type: application/json), except the certificate upload, which uses multipart/form-data.