ghinfe 0.6.0

package/examples/gerar-danfe.js

@@ -0,0 +1,75 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { NFeService, NFCeService, DanfeService } from '../src/index.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const outDir = path.join(__dirname, '../tmp');
+fs.mkdirSync(outDir, { recursive: true });
+
+const danfe = new DanfeService();
+
+const nfeDoc = {
+  ambiente: 2,
+  ide: { uf: 'SP', codigoMunicipio: '3550308', serie: 1, numero: 50 },
+  emitente: {
+    cnpj: '12345678000199',
+    razaoSocial: 'EMPRESA EXEMPLO LTDA',
+    ie: '123456789012',
+    crt: '3',
+    endereco: {
+      logradouro: 'Rua Exemplo', numero: '100', bairro: 'Centro',
+      codigoMunicipio: '3550308', municipio: 'Sao Paulo', uf: 'SP', cep: '01001000',
+    },
+  },
+  destinatario: {
+    cpf: '12345678909',
+    razaoSocial: 'CONSUMIDOR FINAL',
+    indIEDest: 9,
+    endereco: {
+      logradouro: 'Rua B', numero: '2', bairro: 'Centro',
+      codigoMunicipio: '3550308', municipio: 'Sao Paulo', uf: 'SP', cep: '01001000',
+    },
+  },
+  itens: [{
+    codigo: '001', descricao: 'PRODUTO DANFE', ncm: '84713012', cfop: '5102',
+    unidade: 'UN', quantidade: 2, valorUnitario: 50, valorTotal: 100,
+  }],
+  frete: { modalidade: 9 },
+  pagamentos: [{ forma: '01', valor: 100 }],
+};
+
+const nfeService = new NFeService({ mock: true });
+const nfeResolved = nfeService.resolverDocumento(nfeDoc);
+const xmlNfe = nfeService.gerarXml(nfeResolved);
+const { html: htmlDanfe } = await danfe.gerarDanfe(xmlNfe, { protocolo: '135260000000001' });
+const danfePath = path.join(outDir, 'danfe.html');
+fs.writeFileSync(danfePath, htmlDanfe);
+
+const nfceDoc = {
+  ambiente: 2,
+  ide: { uf: 'SP', codigoMunicipio: '3550308', serie: 1, numero: 7 },
+  emitente: nfeDoc.emitente,
+  destinatario: { cpf: '12345678909', razaoSocial: 'CONSUMIDOR' },
+  itens: [{
+    codigo: '001', descricao: 'PRODUTO NFC-E', ncm: '22021000', cfop: '5102',
+    unidade: 'UN', quantidade: 1, valorUnitario: 15, valorTotal: 15,
+  }],
+  pagamentos: [{ forma: '01', valor: 15 }],
+  csc: { idCSC: '000001', codigo: 'CSC-EXEMPLO' },
+};
+
+const nfceService = new NFCeService({ mock: true });
+const nfceResolved = nfceService.resolverDocumento(nfceDoc);
+const xmlNfce = nfceService.gerarXml(nfceResolved);
+const { html: htmlDanfce } = await danfe.gerarDanfce(xmlNfce, {
+  protocolo: '135260000000099',
+  qrCodeUrl: 'https://www.homologacao.nfce.fazenda.sp.gov.br/consulta?p=EXEMPLO',
+});
+const danfcePath = path.join(outDir, 'danfce.html');
+fs.writeFileSync(danfcePath, htmlDanfce);
+
+console.log('=== GHINFE — DANFE / DANFCE ===\n');
+console.log('DANFE  →', danfePath);
+console.log('DANFCE →', danfcePath);
+console.log('\nAbra os HTML no navegador e use Imprimir / Salvar PDF.');

package/examples/layouts-nfse.js

@@ -0,0 +1,51 @@
+import { NFSeService, NFSE_LAYOUTS, NFSeMunicipioResolver } from '../src/index.js';
+
+const documento = {
+  numero: 10,
+  serie: 'NF',
+  ambiente: 2,
+  codigoMunicipio: '3550308',
+  cnpjPrestador: '12345678000199',
+  inscricaoMunicipal: '12345678',
+  optanteSimplesNacional: 1,
+  servico: {
+    itemListaServico: '01.01',
+    discriminacao: 'Consultoria em software',
+    codigoMunicipio: '3550308',
+    valorServicos: 500,
+    aliquotaIss: 5,
+    valorIss: 25,
+  },
+  tomador: {
+    cnpj: '98765432000100',
+    razaoSocial: 'CLIENTE EXEMPLO LTDA',
+    endereco: {
+      logradouro: 'Rua A',
+      numero: '10',
+      bairro: 'Centro',
+      codigoMunicipio: '3550308',
+      uf: 'SP',
+      cep: '01001000',
+    },
+  },
+};
+
+console.log('=== GHINFE — Layouts NFS-e municipais ===\n');
+
+for (const layout of Object.values(NFSE_LAYOUTS)) {
+  const service = new NFSeService({ mock: true, layout });
+  const xml = service.gerarXml(documento, layout);
+  const root = xml.match(/<([A-Za-z]+)[\s>]/)?.[1];
+  console.log(`${layout.padEnd(8)} → raiz <${root}> (${xml.length} bytes)`);
+}
+
+console.log('\nMunicípios pré-cadastrados:');
+for (const ibge of NFSeMunicipioResolver.listarMunicipios()) {
+  if (ibge === 'mock') continue;
+  const info = NFSeMunicipioResolver.resolver(ibge, 2);
+  console.log(`  ${ibge} ${info.nome} [${info.layout}]`);
+}
+
+console.log('\nEmissão mock (ABRASF):');
+const resultado = await new NFSeService({ mock: true }).emitir(documento);
+console.log(`  NFS-e ${resultado.retorno.numeroNfse} — verificação ${resultado.retorno.codigoVerificacao}`);

package/examples/mock-sefaz.js

@@ -0,0 +1,52 @@
+import { NFeService } from '../src/index.js';
+import { SefazError } from '../src/errors/SefazError.js';
+
+const documentoBase = {
+  chaveAcesso: '35260712345678000199550010000000021000000021',
+  ambiente: 2,
+  ide: { uf: 'SP', codigoMunicipio: '3550308', serie: 1, numero: 2 },
+  emitente: {
+    cnpj: '12345678000199',
+    razaoSocial: 'EMPRESA EXEMPLO LTDA',
+    ie: '123456789012',
+    crt: '3',
+    endereco: {
+      logradouro: 'Rua Exemplo', numero: '1', bairro: 'Centro',
+      codigoMunicipio: '3550308', municipio: 'São Paulo', uf: 'SP', cep: '01001000',
+    },
+  },
+  destinatario: {
+    cpf: '12345678909',
+    razaoSocial: 'CONSUMIDOR FINAL',
+    indIEDest: 9,
+    endereco: {
+      logradouro: 'Rua B', numero: '2', bairro: 'Centro',
+      codigoMunicipio: '3550308', municipio: 'São Paulo', uf: 'SP', cep: '01001000',
+    },
+  },
+  itens: [{
+    codigo: '001', descricao: 'PRODUTO TESTE', ncm: '84713012', cfop: '5102',
+    unidade: 'UN', quantidade: 1, valorUnitario: 50, valorTotal: 50,
+  }],
+};
+
+const cenarios = ['autorizado', 'duplicidade', 'schema', 'certificado', 'paralisado'];
+
+console.log('=== GHINFE — Mock SEFAZ — Cenários de retorno ===\n');
+
+for (const cenario of cenarios) {
+  const service = new NFeService({ mock: true, mockScenario: cenario });
+  const xml = service.gerarXml(documentoBase);
+
+  try {
+    const retorno = await service.enviar(xml, documentoBase.chaveAcesso);
+    console.log(`[${cenario}] cStat=${retorno.cStat} — ${retorno.xMotivo}`);
+    if (retorno.protocolo) console.log(`  Protocolo: ${retorno.protocolo}`);
+  } catch (error) {
+    if (error instanceof SefazError) {
+      console.log(`[${cenario}] REJEIÇÃO cStat=${error.cStat} — ${error.xMotivo}`);
+    } else {
+      throw error;
+    }
+  }
+}

package/examples/nfse-eventos.js

@@ -0,0 +1,57 @@
+import { NFSeService } from '../src/index.js';
+
+const basePrestador = {
+  cnpjPrestador: '12345678000199',
+  inscricaoMunicipal: '12345678',
+  codigoMunicipio: '3550308',
+};
+
+const documento = {
+  numero: 20,
+  serie: 'NF',
+  ambiente: 2,
+  ...basePrestador,
+  optanteSimplesNacional: 1,
+  servico: {
+    itemListaServico: '01.01',
+    discriminacao: 'Servico de consultoria',
+    codigoMunicipio: '3550308',
+    valorServicos: 800,
+    aliquotaIss: 5,
+    valorIss: 40,
+  },
+  tomador: {
+    cnpj: '98765432000100',
+    razaoSocial: 'CLIENTE LTDA',
+    endereco: {
+      logradouro: 'Rua X', numero: '1', bairro: 'Centro',
+      codigoMunicipio: '3550308', uf: 'SP', cep: '01001000',
+    },
+  },
+};
+
+const service = new NFSeService({ mock: true });
+
+console.log('=== GHINFE — Cancelamento e Substituição NFS-e ===\n');
+
+const emitido = await service.emitir(documento);
+console.log('Emitida:', emitido.retorno.numeroNfse, emitido.retorno.codigoVerificacao);
+
+const cancelado = await service.cancelar({
+  ...basePrestador,
+  numeroNfse: emitido.retorno.numeroNfse,
+});
+console.log('Cancelamento:', cancelado.retorno.cancelado, '— NFS-e', cancelado.retorno.numeroNfse);
+
+const substituto = { ...documento, numero: 21, servico: { ...documento.servico, valorServicos: 900, valorIss: 45 } };
+const subst = await service.substituir({
+  ...basePrestador,
+  numeroNfseSubstituida: emitido.retorno.numeroNfse,
+  documentoSubstituto: substituto,
+});
+console.log(
+  'Substituição: nova',
+  subst.retorno.numeroNfse,
+  'substituiu',
+  subst.retorno.numeroNfseSubstituida
+);

package/examples/reforma-ibscbs.js

@@ -0,0 +1,27 @@
+import { calcularIBSCBS, buildFragmentoIBSCBS, somarTotaisReforma, REFORMA_LAYOUT } from '../src/index.js';
+
+console.log(`=== GHINFE — Reforma Tributária (${REFORMA_LAYOUT}) ===\n`);
+
+const itens = [
+  { descricao: 'Produto A', valorTotal: 100 },
+  { descricao: 'Produto B', valorTotal: 250 },
+].map((item) => ({
+  ...item,
+  reforma: calcularIBSCBS(item.valorTotal, {
+    pIBSUF: 0.1,
+    pIBSMun: 0.05,
+    pCBS: 0.9,
+    cClassTrib: '000001',
+  }),
+}));
+
+for (const item of itens) {
+  console.log(`${item.descricao}: BC=${item.reforma.vBC}`);
+  console.log(`  IBS-UF=${item.reforma.vIBSUF} IBS-Mun=${item.reforma.vIBSMun} CBS=${item.reforma.vCBS}`);
+}
+
+const totais = somarTotaisReforma(itens);
+console.log('\nTotais:', totais);
+console.log('\nFragmento XML experimental (item 1):\n');
+console.log(buildFragmentoIBSCBS(itens[0].reforma));
+console.log('\nNota: fragmento não é injetado no XML NF-e até schemas PL_010 estáveis.');

package/examples/reforma-nfe-xml.js

@@ -0,0 +1,52 @@
+import { NFeService, calcularIBSCBS } from '../src/index.js';
+
+const documento = {
+  ambiente: 2,
+  reformaTributaria: true,
+  ide: { uf: 'SP', codigoMunicipio: '3550308', serie: 1, numero: 99 },
+  emitente: {
+    cnpj: '12345678000199',
+    razaoSocial: 'EMPRESA EXEMPLO LTDA',
+    ie: '123456789012',
+    crt: '3',
+    endereco: {
+      logradouro: 'Rua A', numero: '1', bairro: 'Centro',
+      codigoMunicipio: '3550308', municipio: 'Sao Paulo', uf: 'SP', cep: '01001000',
+    },
+  },
+  destinatario: {
+    cpf: '12345678909',
+    razaoSocial: 'CONSUMIDOR',
+    indIEDest: 9,
+    endereco: {
+      logradouro: 'Rua B', numero: '2', bairro: 'Centro',
+      codigoMunicipio: '3550308', municipio: 'Sao Paulo', uf: 'SP', cep: '01001000',
+    },
+  },
+  itens: [{
+    codigo: '001',
+    descricao: 'PRODUTO COM IBS/CBS',
+    ncm: '84713012',
+    cfop: '5102',
+    unidade: 'UN',
+    quantidade: 1,
+    valorUnitario: 100,
+    valorTotal: 100,
+    cst: '00',
+    aliquotaIcms: 18,
+    valorIcms: 18,
+    reforma: calcularIBSCBS(100, { pIBSUF: 0.1, pIBSMun: 0.05, pCBS: 0.9, cClassTrib: '000001' }),
+  }],
+  frete: { modalidade: 9 },
+  pagamentos: [{ forma: '01', valor: 100 }],
+};
+
+const service = new NFeService();
+const doc = service.resolverDocumento(documento);
+const xml = service.gerarXml(doc);
+
+console.log('=== GHINFE — NF-e com IBS/CBS injetado ===\n');
+console.log('Chave:', doc.chaveAcesso);
+console.log('Contém IBSCBS:', xml.includes('<IBSCBS>'));
+console.log('Contém IBSCBSTot:', xml.includes('<IBSCBSTot>'));
+console.log('\nTrecho imposto:\n', xml.match(/<IBSCBS>[\s\S]*?<\/IBSCBS>/)?.[0]?.substring(0, 400));

package/examples/status-sefaz.js

@@ -0,0 +1,12 @@
+import { NFeService } from '../src/index.js';
+
+console.log('=== GHINFE — Status SEFAZ (mock) ===\n');
+
+const service = new NFeService({ mock: true });
+
+for (const cenario of ['ok', 'paralisado']) {
+  service.soapService.setMockStatusScenario(cenario);
+  const status = await service.consultarStatus('SP', 2);
+  console.log(`[${cenario}] cStat=${status.cStat} — ${status.xMotivo}`);
+  console.log(`  emOperacao=${status.emOperacao} tMed=${status.tMed}\n`);
+}

package/examples/validar-xsd.js

@@ -0,0 +1,48 @@
+import { NFeService } from '../src/index.js';
+
+const service = new NFeService({ validarXsd: true });
+
+const documento = {
+  ambiente: 2,
+  ide: { uf: 'SP', codigoMunicipio: '3550308', serie: 1, numero: 1 },
+  emitente: {
+    cnpj: '12345678000199',
+    razaoSocial: 'EMPRESA EXEMPLO LTDA',
+    ie: '123456789012',
+    crt: '3',
+    endereco: {
+      logradouro: 'Rua Exemplo', numero: '100', bairro: 'Centro',
+      codigoMunicipio: '3550308', municipio: 'Sao Paulo', uf: 'SP', cep: '01001000',
+    },
+  },
+  destinatario: {
+    cpf: '12345678909',
+    razaoSocial: 'NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL',
+    indIEDest: 9,
+    endereco: {
+      logradouro: 'Rua Cliente', numero: '200', bairro: 'Jardim',
+      codigoMunicipio: '3550308', municipio: 'Sao Paulo', uf: 'SP', cep: '01020000',
+    },
+  },
+  itens: [{
+    codigo: '001',
+    descricao: 'NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL',
+    ncm: '84713012', cfop: '5102', unidade: 'UN',
+    quantidade: 1, valorUnitario: 100, valorTotal: 100,
+    cst: '00', aliquotaIcms: 18, valorIcms: 18,
+  }],
+  frete: { modalidade: 9 },
+  pagamentos: [{ forma: '01', valor: 100 }],
+};
+
+console.log('=== GHINFE — Validação XSD NF-e ===\n');
+
+try {
+  const xml = service.gerarXml(documento);
+  console.log('XML gerado e validado contra XSD oficial (PL_009_V4)');
+  console.log('Chave:', service.resolverDocumento(documento).chaveAcesso);
+  console.log('Tamanho XML:', xml.length, 'bytes');
+} catch (error) {
+  console.error('Falha:', error.message);
+  if (error.erros) error.erros.forEach((e) => console.error(' -', e));
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "ghinfe",
+  "version": "0.6.0",
+  "description": "Biblioteca Node.js para emissão de NF-e, NFC-e e NFS-e — geração de XML, assinatura A1, envio SEFAZ e filas Bull/Redis",
+  "main": "src/index.js",
+  "type": "module",
+  "scripts": {
+    "start": "node src/api/server.js",
+    "example:nfe": "node examples/emitir-nfe.js",
+    "example:mock": "node examples/mock-sefaz.js",
+    "example:chave": "node examples/gerar-chave.js",
+    "example:eventos": "node examples/eventos-nfe.js",
+    "example:xsd": "node examples/validar-xsd.js",
+    "example:nfce": "node examples/emitir-nfce.js",
+    "example:nfse": "node examples/emitir-nfse.js",
+    "example:endpoints": "node examples/endpoints-sefaz.js",
+    "example:status": "node examples/status-sefaz.js",
+    "example:layouts": "node examples/layouts-nfse.js",
+    "example:reforma": "node examples/reforma-ibscbs.js",
+    "example:reforma-xml": "node examples/reforma-nfe-xml.js",
+    "example:nfse-eventos": "node examples/nfse-eventos.js",
+    "example:danfe": "node examples/gerar-danfe.js",
+    "schemas:download": "node scripts/download-schemas.js"
+  },
+  "keywords": [
+    "nfe",
+    "nfce",
+    "nfse",
+    "sefaz",
+    "nota-fiscal",
+    "fiscal",
+    "brasil",
+    "acbr"
+  ],
+  "author": "Victor Henrique Ghilardi",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@xmldom/xmldom": "^0.9.8",
+    "axios": "^1.7.9",
+    "bull": "^4.16.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "ioredis": "^5.4.2",
+    "libxmljs2": "^0.37.0",
+    "node-forge": "^1.3.1",
+    "qrcode": "^1.5.4",
+    "swagger-ui-express": "^5.0.1",
+    "xml-crypto": "^6.0.0",
+    "xmlbuilder2": "^3.1.1",
+    "yamljs": "^0.3.0"
+  },
+  "directories": {
+    "doc": "docs",
+    "example": "examples"
+  },
+  "devDependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vhghilardi/ghinfe.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vhghilardi/ghinfe/issues"
+  },
+  "homepage": "https://github.com/vhghilardi/ghinfe#readme"
+}

package/schemas/nfe/PL_009_V4/consReciNFe_v4.00.xsd

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns="http://www.portalfiscal.inf.br/nfe" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.portalfiscal.inf.br/nfe" elementFormDefault="qualified" attributeFormDefault="unqualified">
+	<xs:include schemaLocation="leiauteNFe_v4.00.xsd"/>
+	<xs:element name="consReciNFe" type="TConsReciNFe">
+		<xs:annotation>
+			<xs:documentation>Schema XML de validação do Pedido de Consulta do Recido do Lote de Notas Fiscais Eletrônicas</xs:documentation>
+		</xs:annotation>
+	</xs:element>
+</xs:schema>

package/schemas/nfe/PL_009_V4/consSitNFe_v4.00.xsd

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://www.portalfiscal.inf.br/nfe" targetNamespace="http://www.portalfiscal.inf.br/nfe" elementFormDefault="qualified" attributeFormDefault="unqualified">
+	<xs:include schemaLocation="leiauteConsSitNFe_v4.00.xsd"/>
+	<xs:element name="consSitNFe" type="TConsSitNFe">
+		<xs:annotation>
+			<xs:documentation>Schema de validação XML dp Pedido de Consulta da Situação Atual da Nota Fiscal Eletrônica</xs:documentation>
+		</xs:annotation>
+	</xs:element>
+</xs:schema>

package/schemas/nfe/PL_009_V4/consStatServ_v4.00.xsd

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns="http://www.portalfiscal.inf.br/nfe" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.portalfiscal.inf.br/nfe" elementFormDefault="qualified" attributeFormDefault="unqualified">
+	<xs:include schemaLocation="leiauteConsStatServ_v4.00.xsd"/>
+	<xs:element name="consStatServ" type="TConsStatServ">
+		<xs:annotation>
+			<xs:documentation>Schema XML de validação do Pedido de Consulta do Status do Serviço</xs:documentation>
+		</xs:annotation>
+	</xs:element>
+</xs:schema>

package/schemas/nfe/PL_009_V4/enviNFe_v3.10.xsd

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://www.portalfiscal.inf.br/nfe" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" targetNamespace="http://www.portalfiscal.inf.br/nfe" elementFormDefault="qualified" attributeFormDefault="unqualified">
+	<xs:include schemaLocation="leiauteNFe_v3.10.xsd"/>
+	<xs:element name="enviNFe" type="TEnviNFe">
+		<xs:annotation>
+			<xs:documentation>Schema XML de validação do Pedido de Concessão de Autorização da Nota Fiscal Eletrônica</xs:documentation>
+		</xs:annotation>
+	</xs:element>
+</xs:schema>

package/schemas/nfe/PL_009_V4/enviNFe_v4.00.xsd

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://www.portalfiscal.inf.br/nfe" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" targetNamespace="http://www.portalfiscal.inf.br/nfe" elementFormDefault="qualified" attributeFormDefault="unqualified">
+	<xs:include schemaLocation="leiauteNFe_v4.00.xsd"/>
+	<xs:element name="enviNFe" type="TEnviNFe">
+		<xs:annotation>
+			<xs:documentation>Schema XML de validação do Pedido de Concessão de Autorização da Nota Fiscal Eletrônica</xs:documentation>
+		</xs:annotation>
+	</xs:element>
+</xs:schema>

package/schemas/nfe/PL_009_V4/inutNFe_v4.00.xsd

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="http://www.portalfiscal.inf.br/nfe" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" targetNamespace="http://www.portalfiscal.inf.br/nfe" elementFormDefault="qualified" attributeFormDefault="unqualified">
+	<xs:include schemaLocation="leiauteInutNFe_v4.00.xsd"/>
+	<xs:element name="inutNFe" type="TInutNFe">
+		<xs:annotation>
+			<xs:documentation>Schema XML de validação do Pedido de Inutilização de Numeração da Nota Fiscal Eletrônica</xs:documentation>
+		</xs:annotation>
+	</xs:element>
+</xs:schema>