Introdução - Treeunfe API B2C

A API B2C da Treeunfe leva a emissão fiscal para dentro do sistema da sua empresa. Ela é feita para times de tecnologia que precisam emitir as notas da própria empresa de forma automática, a partir do e-commerce, do ERP ou do sistema de gestão, sem alguém digitando nota por nota em um portal.

Alguns exemplos:

Loja virtual que emite a NF-e assim que o pagamento do pedido é aprovado.
ERP ou sistema de gestão que gera a nota no faturamento do pedido.
Empresa de serviços ou assinaturas que emite a NFS-e de cada cobrança.
Equipe financeira que cancela, corrige e consulta notas pelo próprio sistema, ou conversando com um agente de IA pelo MCP.

A API emite dois tipos de nota:

NF-e (modelo 55): venda e circulação de mercadorias.
NFS-e (padrão nacional): prestação de serviços.

Vai emitir notas para várias empresas? Se você é uma software house, plataforma ou marketplace que emite em nome dos seus clientes, use a API Enterprise da Treeunfe, que gerencia várias empresas com uma só integração.

Como começar

A sua empresa precisa de uma conta na Treeunfe. É nela que você cadastra o certificado digital, configura a emissão e gera a API Key que o seu sistema usa nas chamadas. Veja Primeiros passos.

O que dá para fazer

Recurso	Para quê
Empresa	Consultar os dados da empresa e o checklist de prontidão para emitir NF-e.
NF-e	Emitir NF-e modelo 55, com ou sem cálculo automático de tributos. Cancelar e emitir carta de correção (CC-e).
Regras fiscais	Definir CFOP, CST e alíquotas que a emissão de NF-e com cálculo usa para cada NCM e UF.
NFS-e	Emitir NFS-e enviando só o serviço e o valor. Baixar o PDF, enviar por e-mail, cancelar e substituir.
Distribuição ADN	Baixar as NFS-e em que a empresa aparece como tomadora.
Webhooks	Receber avisos quando uma nota é autorizada, rejeitada ou cancelada.
Cadastros	Manter clientes, produtos e transportadoras.
Certificado digital	Enviar e consultar o certificado A1.
MCP	Emitir e consultar NF-e pelo Claude, Cursor, VS Code e outros agentes de IA.

Todas as rotas da API usam a API Key da sua empresa, no header x-api-key. Veja Autenticação.

Primeiros passos

Da API Key à primeira nota em homologação.

Emissão de NF-e

Com ou sem cálculo automático de tributos.

Emissão de NFS-e

Só o código do serviço e o valor.

MCP e agentes de IA

Emita NF-e conversando com o Claude e outros agentes.

Webhooks

Avisos de autorização e cancelamento.

Referência da API

Todos os endpoints, com playground.

URL base

https://api.treeunfe.com.br/api/v1

Todas as requisições e respostas usam JSON (Content-Type: application/json), com três exceções: o envio de certificado usa multipart/form-data, o XML da NF-e vem como texto e o PDF da NFS-e vem como arquivo.

Termos fiscais como CFOP, NCM, DPS e ISSQN estão no Glossário.

​Como começar

​O que dá para fazer