O que é ACBr Node?

ACBr Node é uma biblioteca gratuita para trabalhar com NF-e (modelo 55) e NFC-e (modelo 65) em aplicações Node.js. Você programa em JavaScript ou TypeScript; um processo auxiliar usa os componentes públicos do ACBr para executar as operações fiscais.

O projeto é independente. Não é um produto oficial do ACBr e não usa Delphi nem binários ACBr Pro.

O que a biblioteca faz

• Gera XML a partir de modelos com os nomes do ACBr.
• Assina XML com certificado A1 e valida sua estrutura usando schemas.
• Oferece operações explícitas para transmissão, consulta, cancelamento, carta de correção de NF-e e inutilização.
• Recupera o processo XML autorizado a partir da NFe assinada original, mediante consulta externa com A1 e comprovação do protocolo.
• Confere se cliente e motor usam a mesma revisão e contrato.

A sua aplicação continua responsável pelo cadastro, regras tributárias, cálculos, numeração, armazenamento e acompanhamento das notas. A biblioteca não escolhe os impostos de uma venda.

Onde ela executa

Use ACBr Node no backend Node.js: servidor, serviço ou processo local. A biblioteca inicia um executável nativo, portanto não executa no navegador. Em uma aplicação React ou Next.js, as chamadas fiscais ficam no servidor; o frontend chama sua API.

Requisito	Versão inicial
Node.js	22.12 ou superior
Linux	x64, Ubuntu 24.04 com glibc validado
Windows	x64
Certificado	A1 em PFX/P12
Documentos	NF-e 55 e NFC-e 65

macOS, ARM, Alpine/musl e outras distribuições Linux não fazem parte da validação desta versão. Veja os limites completos.

Dois caminhos de uso

Para começar: instale o pacote npm. Ele acompanha modelos gerados e seleciona o runtime da sua plataforma. Você não precisa instalar Free Pascal, Lazarus ou SVN.

Para acompanhar uma revisão própria do ACBr: use a CLI para obter fontes, gerar modelos e compilar o motor. Esse caminho exige ferramentas de desenvolvimento e está no guia avançado.

A sequência de uma nota

Dados fiscais → gerar XML → assinar com A1 → validar → transmitir explicitamente

Gerar, assinar e validar não autorizam uma nota. Autorização depende da resposta fiscal do serviço competente. A documentação começa com um XML sintético offline; os testes do projeto não enviam documentos à SEFAZ.

Continue em Instalação.