- Começando
- Introdução
Começando
Introdução
Emita NF-e para várias empresas a partir de uma única integração com a Treeunfe.
A API NF-e Enterprise é para quem emite NF-e modelo 55 em nome de várias empresas a partir de um único sistema. Com uma conta Enterprise, você cadastra cada empresa emitente, gera as credenciais dela e emite as notas pela API. Por padrão, a Treeunfe calcula os tributos a partir da configuração fiscal da empresa.
O que você faz com a API
- Cadastrar, editar e inativar as empresas emitentes.
- Gerar API Keys para cada empresa, em homologação ou produção.
- Enviar à empresa um link para ela preencher a própria configuração fiscal.
- Emitir NF-e, com ou sem cálculo automático de tributos.
- Cancelar notas e emitir carta de correção.
- Manter clientes, produtos, transportadoras e o certificado digital de cada empresa.
Como a API se organiza
A API tem dois níveis de acesso:
| Nível | O que representa | Credencial | O que faz |
|---|---|---|---|
| Enterprise | A sua conta, que reúne as empresas emitentes | x-enterprise-key | Cria e edita organizations, gera API Keys, cria links de configuração fiscal |
| Organization | Cada empresa emitente | x-api-key | Emite NF-e, registra eventos, mantém cadastros e certificado |
Cada organization tem as próprias API Keys, cadastros e certificado digital. As notas de uma organization nunca se misturam com as de outra.
Primeiros passos
Da organization à primeira NF-e em homologação.
Autenticação
Quando usar cada credencial.
Emissão de NF-e
Com ou sem cálculo automático de tributos.
Referência da API
Todos os endpoints, com playground.
Glossário fiscal
CFOP, NCM, CST, DIFAL e outros termos.
Quer emitir NF-e pelo Claude ou outro agente de IA? Veja o MCP da Treeunfe.
URL base
https://api.treeunfe.com.br/api/v1
Todas as requisições e respostas usam JSON (Content-Type: application/json), exceto o envio de certificado, que usa multipart/form-data.