@projetoacbr/acbrlib-nfe-node

📋 Descrição

ACBrLib NFe Node é uma implementação específica para Nota Fiscal Eletrônica (NFe) que fornece uma interface de alto nível para todas as funcionalidades da ACBrLibNFe. Esta classe permite emissão, cancelamento, consultas e outras operações relacionadas à NFe.

🏗️ Arquitetura

Esta classe (ACBrLibNFeMT) estende ACBrLibDFeMT e implementa todos os métodos específicos da NFe, herdando funcionalidades comuns dos pacotes base.

📦 Instalação

npm install @projetoacbr/acbrlib-nfe-node

📖 Como Usar

🎯 Importação

📝 TypeScript (Recomendado)

// Importa a classe ACBrLibNFeMT oficial conforme documentação
import ACBrLibNFeMT from "@projetoacbr/acbrlib-nfe-node/dist/src";

⚙️ Configuração tsconfig.json recomendada:

{
  "compilerOptions": {
    "target": "es2022",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}

🔧 JavaScript/CommonJS

const ACBrLibNFeMT = require('@projetoacbr/acbrlib-nfe-node/dist/src').default

🔧 Uso Básico

TypeScript

const acbrNFe = new ACBrLibNFeMT(
    './libacbrnfe64.so',    // Linux
    // './ACBrNFe64.dll', // Windows
    './acbrlib.ini',
    '12345678'
)

JavaScript/CommonJS

const acbrNFe = new ACBrLibNFeMT(
    './libacbrnfe64.so',    // Linux
    // './ACBrNFe64.dll', // Windows
    './acbrlib.ini',
    '12345678'
)

// Inicializar a biblioteca
acbrNFe.inicializar()

// Carregar XML
acbrNFe.carregarXML('./nfe.xml')

// Validar e assinar
acbrNFe.validar()
acbrNFe.assinar()

// Enviar
const resposta = acbrNFe.enviar(1, false, true, false)

🔧 Funcionalidades

Métodos Herdados (DFe Comum)

• inicializar(), finalizar()
• carregarXML(), carregarINI()
• obterXml(), obterIni()
• gravarXml(), gravarIni()
• imprimirPDF(), salvarPDF()
• enviarEmail()

Métodos Específicos da NFe

• Emissão e Envio

  • enviar(lote, imprimir, sincrono, zipado)
  • enviarEvento(idLote)

• Cancelamento e Inutilização

  • cancelar(chave, justificativa, CNPJ, lote)
  • inutilizar(CNPJ, justificativa, ano, modelo, serie, numeroInicial, numeroFinal)

• Consultas

  • statusServico()
  • consultar(chaveOuDocumento, extrairEventos)
  • consultarRecibo(recibo)
  • consultaCadastro(cUF, nDocumento, nIE)

• Distribuição DFe

  • distribuicaoDFePorUltNSU(ufAutor, cnpjCpf, ultNSU)
  • distribuicaoDFePorNSU(ufAutor, cnpjCpf, NSU)
  • distribuicaoDFePorChave(ufAutor, cnpjCpf, chave)

• Impressão Específica

  • imprimirInutilizacao(arquivoXml)
  • imprimirInutilizacaoPDF(arquivoXml)
  • salvarInutilizacaoPDF(arquivoXml)

🔗 Dependências

• @projetoacbr/acbrlib-dfe-node - Classe base para DFe

📚 Documentação

Para informações detalhadas sobre cada método, consulte a documentação JSDoc incluída no código fonte.

🤝 Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature
3. Commit suas mudanças
4. Push para a branch
5. Abra um Pull Request

📞 Suporte

• Issues: GitHub Issues
• Documentação ACBrLib: https://acbr.sourceforge.io/ACBrLib/BemVindo.html

📄 Licença

LGPL-2.1 License - veja o arquivo LICENSE para detalhes.

ACBrLib NFe Node - Interface Node.js para ACBrLibNFe
Versão: 1.0.5
Desenvolvido por: Projeto ACBr