ghinfe 0.6.0

package/src/danfe/DanfeService.js

@@ -0,0 +1,205 @@
+import QRCode from 'qrcode';
+import { extrairDadosDanfe, formatarChaveAcesso } from './xml-extract.js';
+import { GhinfeError } from '../errors/GhinfeError.js';
+
+/**
+ * Gera DANFE (NF-e) e DANFCE (NFC-e) em HTML imprimível.
+ * PDF: imprima o HTML ou use um conversor no sistema consumidor (puppeteer, etc.).
+ */
+export class DanfeService {
+  /**
+   * @param {string} xmlNFe XML autorizado (nfeProc) ou NFe assinada
+   * @param {{ protocolo?: string, titulo?: string }} [opcoes]
+   * @returns {Promise<{ html: string, dados: object, tipo: 'DANFE' }>}
+   */
+  async gerarDanfe(xmlNFe, opcoes = {}) {
+    const dados = extrairDadosDanfe(xmlNFe);
+    if (!dados.chaveAcesso) {
+      throw new GhinfeError('Chave de acesso não encontrada no XML', 'DANFE_CHAVE_MISSING');
+    }
+    if (opcoes.protocolo) dados.protocolo = opcoes.protocolo;
+
+    const html = this.#renderDanfe(dados, opcoes.titulo ?? 'DANFE — Documento Auxiliar da NF-e');
+    return { html, dados, tipo: 'DANFE' };
+  }
+
+  /**
+   * @param {string} xmlNFCe
+   * @param {{ protocolo?: string, qrCodeUrl?: string, titulo?: string }} [opcoes]
+   * @returns {Promise<{ html: string, dados: object, tipo: 'DANFCE', qrCodeDataUrl?: string }>}
+   */
+  async gerarDanfce(xmlNFCe, opcoes = {}) {
+    const dados = extrairDadosDanfe(xmlNFCe);
+    if (!dados.chaveAcesso) {
+      throw new GhinfeError('Chave de acesso não encontrada no XML', 'DANFCE_CHAVE_MISSING');
+    }
+    if (opcoes.protocolo) dados.protocolo = opcoes.protocolo;
+    if (opcoes.qrCodeUrl) dados.qrCode = opcoes.qrCodeUrl;
+
+    let qrCodeDataUrl = '';
+    if (dados.qrCode) {
+      qrCodeDataUrl = await QRCode.toDataURL(dados.qrCode, { width: 180, margin: 1 });
+    }
+
+    const html = this.#renderDanfce(dados, qrCodeDataUrl, opcoes.titulo ?? 'NFC-e — Cupom Fiscal Eletrônico');
+    return { html, dados, tipo: 'DANFCE', qrCodeDataUrl };
+  }
+
+  /**
+   * Detecta modelo e gera o documento adequado.
+   * @param {string} xml
+   * @param {object} [opcoes]
+   */
+  async gerar(xml, opcoes = {}) {
+    const dados = extrairDadosDanfe(xml);
+    if (dados.modelo === '65') return this.gerarDanfce(xml, opcoes);
+    return this.gerarDanfe(xml, opcoes);
+  }
+
+  #esc(s) {
+    return String(s ?? '')
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;');
+  }
+
+  #renderDanfe(d, titulo) {
+    const chaveFmt = formatarChaveAcesso(d.chaveAcesso);
+    const linhas = d.itens.map((i, idx) => `
+      <tr>
+        <td>${idx + 1}</td>
+        <td>${this.#esc(i.codigo)}</td>
+        <td>${this.#esc(i.descricao)}</td>
+        <td>${this.#esc(i.ncm)}</td>
+        <td>${this.#esc(i.cfop)}</td>
+        <td>${this.#esc(i.unidade)}</td>
+        <td class="r">${this.#esc(i.quantidade)}</td>
+        <td class="r">${this.#esc(i.valorUnitario)}</td>
+        <td class="r">${this.#esc(i.valorTotal)}</td>
+      </tr>`).join('');
+
+    return `<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+<meta charset="UTF-8"/>
+<title>${this.#esc(titulo)}</title>
+<style>
+  * { box-sizing: border-box; }
+  body { font-family: Arial, Helvetica, sans-serif; font-size: 11px; color: #111; margin: 16px; }
+  h1 { font-size: 14px; margin: 0 0 8px; text-align: center; }
+  .box { border: 1px solid #333; padding: 8px; margin-bottom: 8px; }
+  .row { display: flex; gap: 8px; }
+  .col { flex: 1; }
+  .label { color: #555; font-size: 9px; text-transform: uppercase; }
+  .val { font-weight: 600; }
+  table { width: 100%; border-collapse: collapse; margin-top: 6px; }
+  th, td { border: 1px solid #999; padding: 4px; }
+  th { background: #eee; font-size: 9px; }
+  .r { text-align: right; }
+  .chave { letter-spacing: 1px; font-size: 12px; font-weight: bold; word-break: break-all; }
+  .homolog { color: #b00; font-weight: bold; text-align: center; }
+  @media print { body { margin: 0; } }
+</style>
+</head>
+<body>
+  <h1>${this.#esc(titulo)}</h1>
+  ${d.ambiente === '2' ? '<p class="homolog">NF-e EMITIDA EM AMBIENTE DE HOMOLOGAÇÃO — SEM VALOR FISCAL</p>' : ''}
+  <div class="box row">
+    <div class="col">
+      <div class="label">Emitente</div>
+      <div class="val">${this.#esc(d.emitente.razaoSocial)}</div>
+      <div>CNPJ ${this.#esc(d.emitente.cnpj)} — IE ${this.#esc(d.emitente.ie)}</div>
+      <div>${this.#esc(d.emitente.municipio)} / ${this.#esc(d.emitente.uf)}</div>
+    </div>
+    <div class="col">
+      <div class="label">Documento</div>
+      <div>NF-e nº <strong>${this.#esc(d.numero)}</strong> — Série ${this.#esc(d.serie)}</div>
+      <div>Emissão: ${this.#esc(d.dhEmi)}</div>
+      <div>Nat. Op.: ${this.#esc(d.naturezaOperacao)}</div>
+      <div>Protocolo: ${this.#esc(d.protocolo || '—')}</div>
+    </div>
+  </div>
+  <div class="box">
+    <div class="label">Destinatário</div>
+    <div class="val">${this.#esc(d.destinatario.razaoSocial)}</div>
+    <div>CPF/CNPJ ${this.#esc(d.destinatario.doc)}</div>
+  </div>
+  <div class="box">
+    <div class="label">Chave de acesso</div>
+    <div class="chave">${this.#esc(chaveFmt)}</div>
+  </div>
+  <table>
+    <thead>
+      <tr>
+        <th>#</th><th>Cód.</th><th>Descrição</th><th>NCM</th><th>CFOP</th>
+        <th>Un</th><th>Qtd</th><th>V. Unit</th><th>V. Total</th>
+      </tr>
+    </thead>
+    <tbody>${linhas}</tbody>
+  </table>
+  <div class="box row" style="margin-top:8px">
+    <div class="col"><div class="label">Produtos</div><div class="val">R$ ${this.#esc(d.totais.vProd)}</div></div>
+    <div class="col"><div class="label">ICMS</div><div class="val">R$ ${this.#esc(d.totais.vICMS)}</div></div>
+    <div class="col"><div class="label">Frete</div><div class="val">R$ ${this.#esc(d.totais.vFrete)}</div></div>
+    <div class="col"><div class="label">Total NF</div><div class="val">R$ ${this.#esc(d.totais.vNF)}</div></div>
+  </div>
+  ${d.informacoesComplementares ? `<div class="box"><div class="label">Informações complementares</div>${this.#esc(d.informacoesComplementares)}</div>` : ''}
+  <p style="text-align:center;color:#666;margin-top:12px">Documento gerado por GHINFE — representação auxiliar</p>
+</body>
+</html>`;
+  }
+
+  #renderDanfce(d, qrDataUrl, titulo) {
+    const chaveFmt = formatarChaveAcesso(d.chaveAcesso);
+    const linhas = d.itens.map((i) => `
+      <tr>
+        <td>${this.#esc(i.descricao)}</td>
+        <td class="r">${this.#esc(i.quantidade)}</td>
+        <td class="r">${this.#esc(i.valorUnitario)}</td>
+        <td class="r">${this.#esc(i.valorTotal)}</td>
+      </tr>`).join('');
+
+    return `<!DOCTYPE html>
+<html lang="pt-BR">
+<head>
+<meta charset="UTF-8"/>
+<title>${this.#esc(titulo)}</title>
+<style>
+  body { font-family: 'Courier New', monospace; font-size: 12px; width: 302px; margin: 8px auto; color: #000; }
+  h1 { font-size: 13px; text-align: center; margin: 0 0 6px; }
+  .c { text-align: center; }
+  .r { text-align: right; }
+  hr { border: none; border-top: 1px dashed #000; margin: 8px 0; }
+  table { width: 100%; border-collapse: collapse; }
+  td { padding: 2px 0; vertical-align: top; }
+  img.qr { display: block; margin: 8px auto; }
+  .homolog { color: #b00; font-weight: bold; text-align: center; font-size: 11px; }
+  @media print { body { margin: 0; width: 80mm; } }
+</style>
+</head>
+<body>
+  <h1>${this.#esc(d.emitente.razaoSocial)}</h1>
+  <div class="c">CNPJ ${this.#esc(d.emitente.cnpj)} IE ${this.#esc(d.emitente.ie)}</div>
+  <div class="c">${this.#esc(d.emitente.municipio)}/${this.#esc(d.emitente.uf)}</div>
+  <hr/>
+  <div class="c"><strong>${this.#esc(titulo)}</strong></div>
+  ${d.ambiente === '2' ? '<p class="homolog">EMITIDA EM HOMOLOGAÇÃO — SEM VALOR FISCAL</p>' : ''}
+  <div class="c">NFC-e nº ${this.#esc(d.numero)} Série ${this.#esc(d.serie)}</div>
+  <div class="c">${this.#esc(d.dhEmi)}</div>
+  <hr/>
+  <table>
+    <thead><tr><td>Item</td><td class="r">Qtd</td><td class="r">Vl Un</td><td class="r">Total</td></tr></thead>
+    <tbody>${linhas}</tbody>
+  </table>
+  <hr/>
+  <div class="c"><strong>TOTAL R$ ${this.#esc(d.totais.vNF)}</strong></div>
+  <div class="c">Protocolo: ${this.#esc(d.protocolo || '—')}</div>
+  <hr/>
+  <div class="c" style="font-size:10px;word-break:break-all">${this.#esc(chaveFmt)}</div>
+  ${qrDataUrl ? `<img class="qr" src="${qrDataUrl}" alt="QR Code NFC-e" width="160" height="160"/>` : '<p class="c">(QR Code indisponível — assine e adicione infNFeSupl)</p>'}
+  <p class="c" style="font-size:10px">Consulte pela chave de acesso no portal da SEFAZ</p>
+</body>
+</html>`;
+  }
+}

package/src/danfe/xml-extract.js

@@ -0,0 +1,69 @@
+/**
+ * Extrai campos úteis de XML NF-e/NFC-e para montagem do DANFE/DANFCE.
+ * @param {string} xml
+ */
+export function extrairDadosDanfe(xml) {
+  const get = (tag) => xml.match(new RegExp(`<${tag}[^>]*>([^<]*)</${tag}>`))?.[1]?.trim() ?? '';
+  const getAll = (tag) => [...xml.matchAll(new RegExp(`<${tag}[^>]*>([^<]*)</${tag}>`, 'g'))].map((m) => m[1]);
+
+  const chave = get('chNFe') || (xml.match(/Id="NFe(\d{44})"/)?.[1] ?? '');
+  const protocolo = get('nProt');
+  const qrCode = xml.match(/<!\[CDATA\[(https?:\/\/[^\]]+)\]\]>/)?.[1]
+    || xml.match(/<qrCode[^>]*>([^<]+)<\/qrCode>/)?.[1]
+    || '';
+
+  const itens = [];
+  const detBlocks = xml.match(/<det[\s\S]*?<\/det>/g) ?? [];
+  for (const block of detBlocks) {
+    const g = (t) => block.match(new RegExp(`<${t}[^>]*>([^<]*)</${t}>`))?.[1] ?? '';
+    itens.push({
+      codigo: g('cProd'),
+      descricao: g('xProd'),
+      ncm: g('NCM'),
+      cfop: g('CFOP'),
+      unidade: g('uCom'),
+      quantidade: g('qCom'),
+      valorUnitario: g('vUnCom'),
+      valorTotal: g('vProd'),
+    });
+  }
+
+  return {
+    chaveAcesso: chave,
+    protocolo,
+    modelo: get('mod') || (chave.substring(20, 22) || '55'),
+    serie: get('serie'),
+    numero: get('nNF'),
+    dhEmi: get('dhEmi'),
+    naturezaOperacao: get('natOp'),
+    ambiente: get('tpAmb'),
+    emitente: {
+      cnpj: get('CNPJ'),
+      razaoSocial: get('xNome'),
+      ie: get('IE'),
+      municipio: (xml.match(/<enderEmit>[\s\S]*?<xMun>([^<]+)/)?.[1]) ?? '',
+      uf: (xml.match(/<enderEmit>[\s\S]*?<UF>([^<]+)/)?.[1]) ?? '',
+    },
+    destinatario: {
+      doc: xml.match(/<dest>[\s\S]*?<(?:CNPJ|CPF)>([^<]+)/)?.[1] ?? '',
+      razaoSocial: xml.match(/<dest>[\s\S]*?<xNome>([^<]+)/)?.[1] ?? '',
+    },
+    totais: {
+      vProd: get('vProd'),
+      vNF: get('vNF'),
+      vICMS: get('vICMS'),
+      vFrete: get('vFrete'),
+    },
+    itens,
+    qrCode,
+    informacoesComplementares: get('infCpl'),
+  };
+}
+
+/**
+ * Formata chave de acesso com espaços a cada 4 dígitos.
+ * @param {string} chave
+ */
+export function formatarChaveAcesso(chave) {
+  return (chave || '').replace(/\D/g, '').replace(/(\d{4})(?=\d)/g, '$1 ');
+}

package/src/errors/GhinfeError.js

@@ -0,0 +1,13 @@
+export class GhinfeError extends Error {
+  /**
+   * @param {string} message
+   * @param {string} [code]
+   * @param {unknown} [details]
+   */
+  constructor(message, code = 'GHINFE_ERROR', details = null) {
+    super(message);
+    this.name = 'GhinfeError';
+    this.code = code;
+    this.details = details;
+  }
+}

package/src/errors/SefazError.js

@@ -0,0 +1,25 @@
+import { GhinfeError } from './GhinfeError.js';
+
+export class SefazError extends GhinfeError {
+  /**
+   * @param {string} cStat
+   * @param {string} xMotivo
+   * @param {Record<string, unknown>} [raw]
+   */
+  constructor(cStat, xMotivo, raw = {}) {
+    super(`SEFAZ [${cStat}]: ${xMotivo}`, `SEFAZ_${cStat}`, { cStat, xMotivo, ...raw });
+    this.name = 'SefazError';
+    this.cStat = cStat;
+    this.xMotivo = xMotivo;
+  }
+
+  /** @returns {boolean} */
+  isAutorizado() {
+    return this.cStat === '100';
+  }
+
+  /** @returns {boolean} */
+  isRejeicao() {
+    return this.cStat.length === 3 && this.cStat.startsWith('2');
+  }
+}

package/src/errors/XsdValidationError.js

@@ -0,0 +1,15 @@
+import { GhinfeError } from './GhinfeError.js';
+
+export class XsdValidationError extends GhinfeError {
+  /**
+   * @param {string[]} erros
+   * @param {string} [schema]
+   */
+  constructor(erros, schema = 'unknown') {
+    const resumo = erros[0] ?? 'XML não conforme ao schema XSD';
+    super(`Validação XSD falhou: ${resumo}`, 'XSD_VALIDATION_FAILED', { erros, schema });
+    this.name = 'XsdValidationError';
+    this.erros = erros;
+    this.schema = schema;
+  }
+}

package/src/index.js

@@ -0,0 +1,60 @@
+export { NFeService } from './nfe/services/NFeService.js';
+export { NFeXmlService } from './nfe/services/NFeXmlService.js';
+export { NFeSignService } from './nfe/services/NFeSignService.js';
+export { NFeSoapService } from './nfe/services/NFeSoapService.js';
+export { NFeEventoService } from './nfe/services/NFeEventoService.js';
+export { NFeXsdService } from './nfe/services/NFeXsdService.js';
+export { NFeXmlBuilder } from './nfe/builders/NFeXmlBuilder.js';
+export { NFeEventoXmlBuilder } from './nfe/builders/NFeEventoXmlBuilder.js';
+export { NFeQueue } from './queue/NFeQueue.js';
+
+export { NFCeService } from './nfce/services/NFCeService.js';
+export { NFCeXmlService } from './nfce/services/NFCeXmlService.js';
+export { NFCeXmlBuilder } from './nfce/builders/NFCeXmlBuilder.js';
+export { NFCeQueue } from './queue/NFCeQueue.js';
+export { gerarUrlQrCodeV3, gerarHashQrCodeV3, inserirInfNFeSupl } from './nfce/utils/qrcode.utils.js';
+
+export { NFSeService } from './nfse/services/NFSeService.js';
+export { NFSeXmlService } from './nfse/services/NFSeXmlService.js';
+export { NFSeXmlBuilder } from './nfse/builders/NFSeXmlBuilder.js';
+export { NFSeEventoXmlBuilder } from './nfse/builders/NFSeEventoXmlBuilder.js';
+export { NFSeSoapService, NFSeSoapError } from './nfse/services/NFSeSoapService.js';
+export { NFSeMunicipioResolver } from './nfse/NFSeMunicipioResolver.js';
+export { NFSeQueue } from './queue/NFSeQueue.js';
+export { NFSE_LAYOUTS, NFSE_MUNICIPIOS } from './nfse/constants/municipios.js';
+export { obterAdapter, NFSeLayoutAdapters } from './nfse/layouts/adapters.js';
+
+export { DanfeService } from './danfe/DanfeService.js';
+export { extrairDadosDanfe, formatarChaveAcesso } from './danfe/xml-extract.js';
+
+export { SefazEndpointResolver, SEFAZ_SERVICO } from './sefaz/SefazEndpointResolver.js';
+export { UF_AUTORIZADOR, AUTORIZADOR_ENDPOINTS } from './sefaz/endpoints.registry.js';
+
+export {
+  calcularIBSCBS,
+  buildFragmentoIBSCBS,
+  somarTotaisReforma,
+  reformaHabilitada,
+  appendIBSCBS,
+  appendTotaisIBSCBS,
+  CST_IBSCBS,
+  REFORMA_LAYOUT,
+} from './reforma/ibscbs.js';
+
+export { XsdValidator } from './validation/XsdValidator.js';
+export { XSD_SCHEMAS } from './validation/schemas.js';
+
+export { GhinfeError } from './errors/GhinfeError.js';
+export { SefazError } from './errors/SefazError.js';
+export { XsdValidationError } from './errors/XsdValidationError.js';
+
+export { SEFAZ_STATUS, SEFAZ_URLS, AMBIENTE, NFE_VERSAO, UF_IBGE } from './constants/sefaz.js';
+export { NFE_EVENTOS } from './nfe/types/NFeEvento.js';
+export { loadPfxCertificate } from './utils/certificate.utils.js';
+export {
+  gerarChaveAcesso,
+  calcularDigitoVerificador,
+  validarChaveAcesso,
+  parseChaveAcesso,
+  gerarCodigoNumerico,
+} from './utils/chave.utils.js';

package/src/nfce/builders/NFCeXmlBuilder.js

@@ -0,0 +1,178 @@
+import { create } from 'xmlbuilder2';
+import { NFE_VERSAO } from '../../constants/sefaz.js';
+import { formatSefazDateTime } from '../../utils/date.utils.js';
+import { GhinfeError } from '../../errors/GhinfeError.js';
+import { codigoUf, formatDecimal, appendEndereco, appendImpostosItem } from '../../shared/fiscal.helpers.js';
+
+/**
+ * Monta XML da NFC-e (modelo 65, layout 4.00).
+ */
+export class NFCeXmlBuilder {
+  /**
+   * @param {import('../types/NFCeDocument.js').NFCeDocumento} documento
+   * @returns {string}
+   */
+  build(documento) {
+    this.#validar(documento);
+
+    const dhEmi = formatSefazDateTime();
+    const idInfNFe = `NFe${documento.chaveAcesso}`;
+    const ambiente = documento.ambiente ?? 2;
+
+    const totalProdutos = documento.itens.reduce((s, i) => s + i.valorTotal, 0);
+    const valorIcms = documento.itens.reduce((s, i) => s + (i.valorIcms ?? 0), 0);
+    const valorDesc = documento.itens.reduce((s, i) => s + (i.valorDesconto ?? 0), 0);
+    const valorNf = totalProdutos - valorDesc;
+
+    const root = create({ version: '1.0', encoding: 'UTF-8' })
+      .ele('NFe', { xmlns: 'http://www.portalfiscal.inf.br/nfe' })
+      .ele('infNFe', { versao: NFE_VERSAO, Id: idInfNFe });
+
+    const inf = root;
+
+    // ide — NFC-e modelo 65
+    inf
+      .ele('ide')
+      .ele('cUF').txt(codigoUf(documento.ide.uf)).up()
+      .ele('cNF').txt(documento.chaveAcesso.substring(35, 43)).up()
+      .ele('natOp').txt(documento.ide.naturezaOperacao ?? 'VENDA').up()
+      .ele('mod').txt('65').up()
+      .ele('serie').txt(String(documento.ide.serie ?? 1)).up()
+      .ele('nNF').txt(String(documento.ide.numero)).up()
+      .ele('dhEmi').txt(dhEmi).up()
+      .ele('tpNF').txt('1').up()
+      .ele('idDest').txt('1').up()
+      .ele('cMunFG').txt(documento.ide.codigoMunicipio).up()
+      .ele('tpImp').txt('4').up()
+      .ele('tpEmis').txt('1').up()
+      .ele('cDV').txt(documento.chaveAcesso.slice(-1)).up()
+      .ele('tpAmb').txt(String(ambiente)).up()
+      .ele('finNFe').txt('1').up()
+      .ele('indFinal').txt('1').up()
+      .ele('indPres').txt(String(documento.ide.presenca ?? 1)).up()
+      .ele('procEmi').txt('0').up()
+      .ele('verProc').txt('ghinfe-0.3.0').up()
+      .up();
+
+    // emit
+    const emit = inf.ele('emit');
+    emit.ele('CNPJ').txt(documento.emitente.cnpj.replace(/\D/g, '')).up();
+    emit.ele('xNome').txt(documento.emitente.razaoSocial).up();
+    if (documento.emitente.nomeFantasia) {
+      emit.ele('xFant').txt(documento.emitente.nomeFantasia).up();
+    }
+    appendEndereco(emit, 'enderEmit', documento.emitente.endereco);
+    emit.ele('IE').txt(documento.emitente.ie).up();
+    emit.ele('CRT').txt(documento.emitente.crt).up();
+    emit.up();
+
+    // dest — opcional na NFC-e (se informado CPF/CNPJ, exige indIEDest ou enderDest)
+    if (documento.destinatario?.cpf || documento.destinatario?.cnpj) {
+      const dest = inf.ele('dest');
+      const docDest = (documento.destinatario.cnpj ?? documento.destinatario.cpf ?? '').replace(/\D/g, '');
+      if (docDest.length === 14) dest.ele('CNPJ').txt(docDest).up();
+      else if (docDest.length === 11) dest.ele('CPF').txt(docDest).up();
+      if (documento.destinatario.razaoSocial) {
+        dest.ele('xNome').txt(documento.destinatario.razaoSocial).up();
+      }
+      if (documento.destinatario.endereco) {
+        appendEndereco(dest, 'enderDest', documento.destinatario.endereco);
+      } else {
+        dest.ele('indIEDest').txt('9').up();
+      }
+      dest.up();
+    }
+
+    // det — itens
+    documento.itens.forEach((item, index) => {
+      const det = inf.ele('det', { nItem: String(index + 1) });
+      const prod = det.ele('prod');
+      prod.ele('cProd').txt(item.codigo).up();
+      prod.ele('cEAN').txt(item.ean ?? 'SEM GTIN').up();
+      prod.ele('xProd').txt(item.descricao).up();
+      prod.ele('NCM').txt(item.ncm).up();
+      prod.ele('CFOP').txt(item.cfop).up();
+      prod.ele('uCom').txt(item.unidade).up();
+      prod.ele('qCom').txt(formatDecimal(item.quantidade, 4)).up();
+      prod.ele('vUnCom').txt(formatDecimal(item.valorUnitario, 10)).up();
+      prod.ele('vProd').txt(formatDecimal(item.valorTotal, 2)).up();
+      prod.ele('cEANTrib').txt(item.ean ?? 'SEM GTIN').up();
+      prod.ele('uTrib').txt(item.unidade).up();
+      prod.ele('qTrib').txt(formatDecimal(item.quantidade, 4)).up();
+      prod.ele('vUnTrib').txt(formatDecimal(item.valorUnitario, 10)).up();
+      prod.ele('indTot').txt('1').up();
+      prod.up();
+
+      appendImpostosItem(det.ele('imposto'), item);
+      det.up();
+    });
+
+    // total
+    const total = inf.ele('total').ele('ICMSTot');
+    total
+      .ele('vBC').txt(formatDecimal(totalProdutos, 2)).up()
+      .ele('vICMS').txt(formatDecimal(valorIcms, 2)).up()
+      .ele('vICMSDeson').txt('0.00').up()
+      .ele('vFCP').txt('0.00').up()
+      .ele('vBCST').txt('0.00').up()
+      .ele('vST').txt('0.00').up()
+      .ele('vFCPST').txt('0.00').up()
+      .ele('vFCPSTRet').txt('0.00').up()
+      .ele('vProd').txt(formatDecimal(totalProdutos, 2)).up()
+      .ele('vFrete').txt('0.00').up()
+      .ele('vSeg').txt('0.00').up()
+      .ele('vDesc').txt(formatDecimal(valorDesc, 2)).up()
+      .ele('vII').txt('0.00').up()
+      .ele('vIPI').txt('0.00').up()
+      .ele('vIPIDevol').txt('0.00').up()
+      .ele('vPIS').txt('0.00').up()
+      .ele('vCOFINS').txt('0.00').up()
+      .ele('vOutro').txt('0.00').up()
+      .ele('vNF').txt(formatDecimal(valorNf, 2)).up();
+    total.up().up();
+
+    // transp — NFC-e sem frete
+    inf.ele('transp').ele('modFrete').txt('9').up().up();
+
+    // pag
+    const pag = inf.ele('pag');
+    const pagamentos = documento.pagamentos ?? [{ forma: '01', valor: valorNf }];
+    pagamentos.forEach((p) => {
+      const detPag = pag.ele('detPag');
+      detPag.ele('tPag').txt(p.forma).up();
+      detPag.ele('vPag').txt(formatDecimal(p.valor, 2)).up();
+      detPag.up();
+    });
+    pag.up();
+
+    // infAdic
+    if (documento.informacoesComplementares || documento.informacoesFisco) {
+      const infAdic = inf.ele('infAdic');
+      if (documento.informacoesFisco) {
+        infAdic.ele('infAdFisco').txt(documento.informacoesFisco).up();
+      }
+      if (documento.informacoesComplementares) {
+        infAdic.ele('infCpl').txt(documento.informacoesComplementares).up();
+      }
+      infAdic.up();
+    }
+
+    return root.end({ prettyPrint: false, headless: false });
+  }
+
+  /** @param {import('../types/NFCeDocument.js').NFCeDocumento} documento */
+  #validar(documento) {
+    if (!documento.chaveAcesso || documento.chaveAcesso.length !== 44) {
+      throw new GhinfeError('chaveAcesso deve conter 44 dígitos', 'INVALID_CHAVE');
+    }
+    if (!documento.emitente?.cnpj) {
+      throw new GhinfeError('emitente.cnpj é obrigatório', 'INVALID_EMITENTE');
+    }
+    if (!documento.itens?.length) {
+      throw new GhinfeError('A NFC-e deve conter ao menos um item', 'INVALID_ITENS');
+    }
+    if (!documento.csc?.idCSC || !documento.csc?.codigo) {
+      throw new GhinfeError('csc.idCSC e csc.codigo são obrigatórios para QR Code', 'INVALID_CSC');
+    }
+  }
+}

package/src/nfce/constants/qrcode.js

@@ -0,0 +1,26 @@
+/** URLs de consulta QR Code NFC-e por UF e ambiente. */
+export const NFCE_QRCODE_URLS = {
+  SP: {
+    1: 'https://www.nfce.fazenda.sp.gov.br/NFCeConsultaPublica/Paginas/ConsultaQRCode.aspx',
+    2: 'https://www.homologacao.nfce.fazenda.sp.gov.br/NFCeConsultaPublica/Paginas/ConsultaQRCode.aspx',
+  },
+  PR: {
+    1: 'http://www.fazenda.pr.gov.br/nfce/qrcode',
+    2: 'http://www.fazenda.pr.gov.br/nfce/qrcode',
+  },
+  RS: {
+    1: 'https://www.sefaz.rs.gov.br/NFCE/NFCE-COM-QRCode',
+    2: 'https://www.sefaz.rs.gov.br/NFCE/NFCE-COM-QRCode',
+  },
+};
+
+/** URLs de consulta por chave (portal SEFAZ). */
+export const NFCE_URL_CHAVE = {
+  SP: {
+    1: 'https://www.nfce.fazenda.sp.gov.br/consulta',
+    2: 'https://www.homologacao.nfce.fazenda.sp.gov.br/consulta',
+  },
+};
+
+/** Versão do QR Code NFC-e (2 = atual). */
+export const NFCE_QRCODE_VERSAO = '2';