Visão geral

Suporte

x-api-key

Treeunfe API

Referência da API Enterprise

Documentação

Site da Treeunfe

Emita NF-e e gerencie os clientes da sua software house com a API da Treeunfe.

Introdução

Crie uma organization, gere a API Key e emita a primeira NF-e em homologação.

Primeiros passos

As duas credenciais da API e quando usar cada uma.

Autenticação

Status HTTP retornados pela API e o que fazer em cada caso.

Erros

Os termos fiscais da NF-e que aparecem na documentação, com o campo correspondente na API.

Glossário fiscal

Escopos, ambiente e validade das chaves das organizations.

API Keys

Crie, edite e inative os clientes da sua software house.

Cadastro de organizations

Clientes, produtos e transportadoras da organization.

Cadastros

Emita NF-e modelo 55 com ou sem cálculo automático de tributos.

Emissão de NF-e

Cancele notas e emita cartas de correção.

Eventos de NF-e

Conecte o Claude e outros agentes de IA à Treeunfe para emitir e consultar NF-e em linguagem natural.

MCP da Treeunfe

Configure o MCP da Treeunfe no Claude, Cursor, VS Code, Codex, Gemini CLI e outros clientes.

Conectar seu agente

Use o MCP da Treeunfe direto do seu backend com o conector MCP da API do Claude.

Agente próprio com a API do Claude

Cria uma organization cliente sob a Enterprise autenticada

Criar organization

Editar organization

Gera uma nova API Key para uma organization existente

Criar API Key

Gera um link para o cliente preencher, numa tela da Treeunfe, as configurações de NF-e da organization

Criar link de configuração fiscal

Lista os links de configuração fiscal já gerados para a organization

Listar links de configuração fiscal

Emite uma NF-e modelo 55 para a organization dona da API Key

Emitir NF-e

Registra o evento de cancelamento de uma NF-e autorizada, dentro do prazo da SEFAZ da UF

Cancelar NF-e

Emitir Carta de Correção (CC-e)

Retorna as cartas de correção registradas para a NF-e

Consultar CC-e

Cadastrar cliente

Listar clientes

Buscar cliente

Atualizar cliente

Excluir cliente

Cadastrar produto

Listar produtos

Buscar produto

Atualizar produto

Excluir produto

Cadastrar transportadora

Listar transportadoras

Buscar transportadora

Atualizar transportadora

Excluir transportadora

Envia o certificado digital A1 (`.pfx`) da organization e a senha dele

Enviar certificado A1

Retorna os dados do certificado em uso pela organization

Consultar certificado atual

Excluir certificado

Issue NF-e and manage your software house's customers with the Treeunfe API.

Introduction

Create an organization, generate the API Key, and issue your first NF-e in the sandbox.

Quickstart

The API's two credentials and when to use each one.

Authentication

HTTP statuses returned by the API and what to do in each case.

Errors

Scopes, environment, and expiration of organization keys.

Create, edit, and deactivate your software house's customers.

Registering organizations

The organization's customers, products, and carriers.

Records

Issue NF-e model 55 with or without automatic tax calculation.

Issuing NF-e

Cancel invoices and issue correction letters.

NF-e events

Connect Claude and other AI agents to Treeunfe to issue and look up NF-e in natural language.

Treeunfe MCP

Set up the Treeunfe MCP in Claude, Cursor, VS Code, Codex, Gemini CLI and other clients.

Connect your agent

Use the Treeunfe MCP from your backend with the Claude API MCP connector.

Your own agent with the Claude API

Overview

Creates a customer organization under the authenticated Enterprise

Create organization

Edit organization

Generates a new API Key for an existing organization

Create API Key

Generates a link for the customer to fill in the organization's NF-e settings on a Treeunfe page

Create fiscal configuration link

Lists the fiscal configuration links already generated for the organization

List fiscal configuration links

Issues an NF-e model 55 for the organization that owns the API Key

Issue NF-e

Registers the cancellation event for an authorized NF-e, within the state SEFAZ's deadline

Cancel NF-e

Issue correction letter (CC-e)

Returns the correction letters registered for the NF-e

Get CC-e

Create customer

List customers

Get customer

Update customer

Delete customer

Create product

List products

Get product

Update product

Delete product

Create carrier

List carriers

Get carrier

Update carrier

Delete carrier

Uploads the organization's A1 digital certificate (`.pfx`) and its password

Upload A1 certificate

Returns the details of the certificate the organization is using

Grupo	Credencial
Organizations, API Keys, Configuração fiscal	`x-enterprise-key`
NF-e, Eventos, Cadastros, Certificado	`x-api-key`

Baixar a especificação OpenAPI