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

Erros

Suporte

x-api-key

Treeunfe API NF-e B2C

Referência da API

Documentação

Site da Treeunfe

Emita NF-e pela API usando a sua conta do emissor Treeunfe.

Introdução

Da API Key à primeira NF-e em homologação.

Primeiros passos

Autenticação

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

Glossário fiscal

Clientes, produtos e transportadoras da empresa.

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

Todos os endpoints da API de NF-e B2C da Treeunfe.

Visão geral

Empresa atual

Buscar empresa

Checklist de NF-e

Atualizar empresa

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

Emitir NF-e

Listar NF-e

Buscar NF-e

Itens da NF-e

XML da 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

Listar regras fiscais

Regras fiscais padrão

Criar regra fiscal

Buscar regra fiscal

Atualizar regra fiscal

Excluir regra fiscal

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 empresa e a senha dele

Enviar certificado A1

Retorna os dados do certificado em uso pela empresa

Status	Significado	O que fazer
`400`	Body inválido: campo obrigatório ausente, formato errado ou campo não permitido.	Corrija o payload.
`401`	Credencial ausente, inválida ou expirada.	Confira o header `x-api-key`. Gere uma nova chave no emissor se a atual expirou.
`402`	Emissão bloqueada por plano ou saldo da conta.	Fale com o comercial da Treeunfe.
`403`	Sem permissão. Inclui `Organization is inactive` (empresa inativa).	Confira se a empresa está ativa na Treeunfe.
`404`	Recurso não encontrado.	Confira o ID e se ele pertence à empresa da chave.
`422`	Nota ou evento rejeitado na validação ou pela SEFAZ.	Leia o motivo na resposta, corrija e envie de novo.
`503`	SEFAZ indisponível.	Tente de novo mais tarde, com intervalo crescente entre as tentativas.