ghinfe 0.6.0 → 0.6.2

package/src/nfce/utils/qrcode.utils.js

@@ -1,92 +1,92 @@
-import crypto from 'crypto';
-import { NFCE_QRCODE_URLS, NFCE_URL_CHAVE } from '../constants/qrcode.js';
-import { GhinfeError } from '../../errors/GhinfeError.js';
-
-/**
- * Extrai DigestValue da assinatura XML para compor QR Code v3.
- * @param {string} xmlAssinado
- */
-export function extrairDigestValor(xmlAssinado) {
-  const match = xmlAssinado.match(/<DigestValue>([^<]+)<\/DigestValue>/);
-  return match?.[1] ?? '';
-}
-
-/**
- * Gera hash QR Code NFC-e versão 3.
- * SHA1(chave + versao + tpAmb + cDest + vNF + vICMS + digVal + idCSC + CSC)
- */
-export function gerarHashQrCodeV3(chaveAcesso, ambiente, cDest, vNF, vICMS, digVal, idCSC, csc) {
-  const vNFStr = Number(vNF).toFixed(2);
-  const vICMSStr = Number(vICMS).toFixed(2);
-  const id = idCSC.padStart(6, '0');
-  const input = `${chaveAcesso}3${ambiente}${cDest}${vNFStr}${vICMSStr}${digVal}${id}${csc}`;
-  return crypto.createHash('sha1').update(input).digest('hex').toUpperCase();
-}
-
-/**
- * Monta URL do QR Code NFC-e versão 3 (layout exigido pelo XSD PL_009_V4).
- * @param {{
- *   chaveAcesso: string,
- *   uf: string,
- *   ambiente?: number,
- *   cDest?: string,
- *   valorNF: number,
- *   valorICMS?: number,
- *   digVal: string,
- *   idCSC: string,
- *   csc: string,
- * }} params
- */
-export function gerarUrlQrCodeV3(params) {
-  const ambiente = params.ambiente ?? 2;
-  const uf = params.uf.toUpperCase();
-  const baseUrl = NFCE_QRCODE_URLS[uf]?.[ambiente];
-
-  if (!baseUrl) {
-    throw new GhinfeError(
-      `URL de QR Code NFC-e não configurada para UF ${uf} ambiente ${ambiente}`,
-      'NFCE_QRCODE_URL_MISSING'
-    );
-  }
-
-  const cDest = (params.cDest ?? '').replace(/\D/g, '');
-  const vNFStr = Number(params.valorNF).toFixed(2);
-  const vICMSStr = Number(params.valorICMS ?? 0).toFixed(2);
-  const idCSC = params.idCSC.padStart(6, '0');
-  const hash = gerarHashQrCodeV3(
-    params.chaveAcesso,
-    ambiente,
-    cDest,
-    params.valorNF,
-    params.valorICMS ?? 0,
-    params.digVal,
-    idCSC,
-    params.csc
-  );
-
-  const p = `${params.chaveAcesso}|3|${ambiente}|${cDest}|${vNFStr}|${vICMSStr}|${params.digVal}|${idCSC}|${hash}`;
-  return `${baseUrl}?p=${p}`;
-}
-
-/**
- * @param {string} uf
- * @param {number} [ambiente]
- */
-export function obterUrlChave(uf, ambiente = 2) {
-  const url = NFCE_URL_CHAVE[uf.toUpperCase()]?.[ambiente];
-  if (!url) {
-    return NFCE_QRCODE_URLS[uf.toUpperCase()]?.[ambiente] ?? 'https://www.nfce.fazenda.sp.gov.br/consulta';
-  }
-  return url;
-}
-
-/**
- * Insere infNFeSupl no XML assinado da NFC-e.
- * @param {string} xmlAssinado
- * @param {string} qrCodeUrl
- * @param {string} urlChave
- */
-export function inserirInfNFeSupl(xmlAssinado, qrCodeUrl, urlChave) {
-  const supl = `<infNFeSupl><qrCode><![CDATA[${qrCodeUrl}]]></qrCode><urlChave>${urlChave}</urlChave></infNFeSupl>`;
-  return xmlAssinado.replace('</NFe>', `${supl}</NFe>`);
-}
+import crypto from 'crypto';
+import { NFCE_QRCODE_URLS, NFCE_URL_CHAVE } from '../constants/qrcode.js';
+import { GhinfeError } from '../../errors/GhinfeError.js';
+
+/**
+ * Extrai DigestValue da assinatura XML para compor QR Code v3.
+ * @param {string} xmlAssinado
+ */
+export function extrairDigestValor(xmlAssinado) {
+  const match = xmlAssinado.match(/<DigestValue>([^<]+)<\/DigestValue>/);
+  return match?.[1] ?? '';
+}
+
+/**
+ * Gera hash QR Code NFC-e versão 3.
+ * SHA1(chave + versao + tpAmb + cDest + vNF + vICMS + digVal + idCSC + CSC)
+ */
+export function gerarHashQrCodeV3(chaveAcesso, ambiente, cDest, vNF, vICMS, digVal, idCSC, csc) {
+  const vNFStr = Number(vNF).toFixed(2);
+  const vICMSStr = Number(vICMS).toFixed(2);
+  const id = idCSC.padStart(6, '0');
+  const input = `${chaveAcesso}3${ambiente}${cDest}${vNFStr}${vICMSStr}${digVal}${id}${csc}`;
+  return crypto.createHash('sha1').update(input).digest('hex').toUpperCase();
+}
+
+/**
+ * Monta URL do QR Code NFC-e versão 3 (layout exigido pelo XSD PL_009_V4).
+ * @param {{
+ *   chaveAcesso: string,
+ *   uf: string,
+ *   ambiente?: number,
+ *   cDest?: string,
+ *   valorNF: number,
+ *   valorICMS?: number,
+ *   digVal: string,
+ *   idCSC: string,
+ *   csc: string,
+ * }} params
+ */
+export function gerarUrlQrCodeV3(params) {
+  const ambiente = params.ambiente ?? 2;
+  const uf = params.uf.toUpperCase();
+  const baseUrl = NFCE_QRCODE_URLS[uf]?.[ambiente];
+
+  if (!baseUrl) {
+    throw new GhinfeError(
+      `URL de QR Code NFC-e não configurada para UF ${uf} ambiente ${ambiente}`,
+      'NFCE_QRCODE_URL_MISSING'
+    );
+  }
+
+  const cDest = (params.cDest ?? '').replace(/\D/g, '');
+  const vNFStr = Number(params.valorNF).toFixed(2);
+  const vICMSStr = Number(params.valorICMS ?? 0).toFixed(2);
+  const idCSC = params.idCSC.padStart(6, '0');
+  const hash = gerarHashQrCodeV3(
+    params.chaveAcesso,
+    ambiente,
+    cDest,
+    params.valorNF,
+    params.valorICMS ?? 0,
+    params.digVal,
+    idCSC,
+    params.csc
+  );
+
+  const p = `${params.chaveAcesso}|3|${ambiente}|${cDest}|${vNFStr}|${vICMSStr}|${params.digVal}|${idCSC}|${hash}`;
+  return `${baseUrl}?p=${p}`;
+}
+
+/**
+ * @param {string} uf
+ * @param {number} [ambiente]
+ */
+export function obterUrlChave(uf, ambiente = 2) {
+  const url = NFCE_URL_CHAVE[uf.toUpperCase()]?.[ambiente];
+  if (!url) {
+    return NFCE_QRCODE_URLS[uf.toUpperCase()]?.[ambiente] ?? 'https://www.nfce.fazenda.sp.gov.br/consulta';
+  }
+  return url;
+}
+
+/**
+ * Insere infNFeSupl no XML assinado da NFC-e.
+ * @param {string} xmlAssinado
+ * @param {string} qrCodeUrl
+ * @param {string} urlChave
+ */
+export function inserirInfNFeSupl(xmlAssinado, qrCodeUrl, urlChave) {
+  const supl = `<infNFeSupl><qrCode><![CDATA[${qrCodeUrl}]]></qrCode><urlChave>${urlChave}</urlChave></infNFeSupl>`;
+  return xmlAssinado.replace('</NFe>', `${supl}</NFe>`);
+}

package/src/nfe/builders/NFeEventoXmlBuilder.js

@@ -1,110 +1,110 @@
-import { create } from 'xmlbuilder2';
-import { UF_IBGE } from '../../constants/sefaz.js';
-import { NFE_EVENTOS, CCE_COND_USO } from '../types/NFeEvento.js';
-import { formatSefazDateTime } from '../../utils/date.utils.js';
-import { GhinfeError } from '../../errors/GhinfeError.js';
-
-const VERSAO_EVENTO = '1.00';
-
-/**
- * Monta XML de eventos NF-e (cancelamento, CC-e, etc.).
- */
-export class NFeEventoXmlBuilder {
-  /**
-   * @param {import('../types/NFeEvento.js').NFeCancelamento} dados
-   * @returns {string}
-   */
-  buildCancelamento(dados) {
-    this.#validarBase(dados);
-    if (!dados.protocolo) {
-      throw new GhinfeError('protocolo é obrigatório para cancelamento', 'CANCEL_PROTOCOLO_REQUIRED');
-    }
-    if (!dados.justificativa || dados.justificativa.trim().length < 15) {
-      throw new GhinfeError(
-        'justificativa deve ter no mínimo 15 caracteres',
-        'CANCEL_JUSTIFICATIVA_MIN'
-      );
-    }
-
-    return this.#buildEvento(dados, NFE_EVENTOS.CANCELAMENTO, (det) => {
-      det.ele('descEvento').txt('Cancelamento').up();
-      det.ele('nProt').txt(dados.protocolo).up();
-      det.ele('xJust').txt(dados.justificativa.trim()).up();
-    });
-  }
-
-  /**
-   * @param {import('../types/NFeEvento.js').NFeCartaCorrecao} dados
-   * @returns {string}
-   */
-  buildCartaCorrecao(dados) {
-    this.#validarBase(dados);
-    if (!dados.correcao || dados.correcao.trim().length < 15) {
-      throw new GhinfeError(
-        'correcao deve ter no mínimo 15 caracteres',
-        'CCE_TEXTO_MIN'
-      );
-    }
-    if (dados.correcao.length > 1000) {
-      throw new GhinfeError('correcao não pode exceder 1000 caracteres', 'CCE_TEXTO_MAX');
-    }
-
-    return this.#buildEvento(dados, NFE_EVENTOS.CARTA_CORRECAO, (det) => {
-      det.ele('descEvento').txt('Carta de Correcao').up();
-      det.ele('xCorrecao').txt(dados.correcao.trim()).up();
-      det.ele('xCondUso').txt(CCE_COND_USO).up();
-    });
-  }
-
-  /**
-   * @param {import('../types/NFeEvento.js').NFeEventoBase} dados
-   * @param {string} tpEvento
-   * @param {(det: import('xmlbuilder2').XMLBuilder) => void} buildDetEvento
-   */
-  #buildEvento(dados, tpEvento, buildDetEvento) {
-    const sequencia = dados.sequencia ?? 1;
-    const idLote = dados.idLote ?? '1';
-    const cOrgao = UF_IBGE[dados.uf.toUpperCase()] ?? '35';
-    const dhEvento = formatSefazDateTime();
-    const idInfEvento = `ID${tpEvento}${dados.chaveAcesso}${String(sequencia).padStart(2, '0')}`;
-
-    const root = create({ version: '1.0', encoding: 'UTF-8' })
-      .ele('envEvento', { xmlns: 'http://www.portalfiscal.inf.br/nfe', versao: VERSAO_EVENTO })
-      .ele('idLote').txt(idLote).up();
-
-    const evento = root.ele('evento', { versao: VERSAO_EVENTO });
-    const infEvento = evento.ele('infEvento', { Id: idInfEvento });
-
-    infEvento
-      .ele('cOrgao').txt(cOrgao).up()
-      .ele('tpAmb').txt(String(dados.ambiente ?? 2)).up()
-      .ele('CNPJ').txt(dados.cnpj.replace(/\D/g, '')).up()
-      .ele('chNFe').txt(dados.chaveAcesso).up()
-      .ele('dhEvento').txt(dhEvento).up()
-      .ele('tpEvento').txt(tpEvento).up()
-      .ele('nSeqEvento').txt(String(sequencia)).up()
-      .ele('verEvento').txt(VERSAO_EVENTO).up();
-
-    const detEvento = infEvento.ele('detEvento', { versao: VERSAO_EVENTO });
-    buildDetEvento(detEvento);
-    detEvento.up();
-    infEvento.up();
-    evento.up();
-
-    return root.end({ prettyPrint: false, headless: false });
-  }
-
-  /** @param {import('../types/NFeEvento.js').NFeEventoBase} dados */
-  #validarBase(dados) {
-    const chave = dados.chaveAcesso?.replace(/\D/g, '');
-    if (!chave || chave.length !== 44) {
-      throw new GhinfeError('chaveAcesso deve conter 44 dígitos', 'INVALID_CHAVE');
-    }
-    if (!dados.cnpj) {
-      throw new GhinfeError('cnpj do autor do evento é obrigatório', 'INVALID_CNPJ');
-    }
-    if (!dados.uf) {
-      throw new GhinfeError('uf é obrigatória', 'INVALID_UF');
-    }
-  }
-}
+import { create } from 'xmlbuilder2';
+import { UF_IBGE } from '../../constants/sefaz.js';
+import { NFE_EVENTOS, CCE_COND_USO } from '../types/NFeEvento.js';
+import { formatSefazDateTime } from '../../utils/date.utils.js';
+import { GhinfeError } from '../../errors/GhinfeError.js';
+
+const VERSAO_EVENTO = '1.00';
+
+/**
+ * Monta XML de eventos NF-e (cancelamento, CC-e, etc.).
+ */
+export class NFeEventoXmlBuilder {
+  /**
+   * @param {import('../types/NFeEvento.js').NFeCancelamento} dados
+   * @returns {string}
+   */
+  buildCancelamento(dados) {
+    this.#validarBase(dados);
+    if (!dados.protocolo) {
+      throw new GhinfeError('protocolo é obrigatório para cancelamento', 'CANCEL_PROTOCOLO_REQUIRED');
+    }
+    if (!dados.justificativa || dados.justificativa.trim().length < 15) {
+      throw new GhinfeError(
+        'justificativa deve ter no mínimo 15 caracteres',
+        'CANCEL_JUSTIFICATIVA_MIN'
+      );
+    }
+
+    return this.#buildEvento(dados, NFE_EVENTOS.CANCELAMENTO, (det) => {
+      det.ele('descEvento').txt('Cancelamento').up();
+      det.ele('nProt').txt(dados.protocolo).up();
+      det.ele('xJust').txt(dados.justificativa.trim()).up();
+    });
+  }
+
+  /**
+   * @param {import('../types/NFeEvento.js').NFeCartaCorrecao} dados
+   * @returns {string}
+   */
+  buildCartaCorrecao(dados) {
+    this.#validarBase(dados);
+    if (!dados.correcao || dados.correcao.trim().length < 15) {
+      throw new GhinfeError(
+        'correcao deve ter no mínimo 15 caracteres',
+        'CCE_TEXTO_MIN'
+      );
+    }
+    if (dados.correcao.length > 1000) {
+      throw new GhinfeError('correcao não pode exceder 1000 caracteres', 'CCE_TEXTO_MAX');
+    }
+
+    return this.#buildEvento(dados, NFE_EVENTOS.CARTA_CORRECAO, (det) => {
+      det.ele('descEvento').txt('Carta de Correcao').up();
+      det.ele('xCorrecao').txt(dados.correcao.trim()).up();
+      det.ele('xCondUso').txt(CCE_COND_USO).up();
+    });
+  }
+
+  /**
+   * @param {import('../types/NFeEvento.js').NFeEventoBase} dados
+   * @param {string} tpEvento
+   * @param {(det: import('xmlbuilder2').XMLBuilder) => void} buildDetEvento
+   */
+  #buildEvento(dados, tpEvento, buildDetEvento) {
+    const sequencia = dados.sequencia ?? 1;
+    const idLote = dados.idLote ?? '1';
+    const cOrgao = UF_IBGE[dados.uf.toUpperCase()] ?? '35';
+    const dhEvento = formatSefazDateTime();
+    const idInfEvento = `ID${tpEvento}${dados.chaveAcesso}${String(sequencia).padStart(2, '0')}`;
+
+    const root = create({ version: '1.0', encoding: 'UTF-8' })
+      .ele('envEvento', { xmlns: 'http://www.portalfiscal.inf.br/nfe', versao: VERSAO_EVENTO })
+      .ele('idLote').txt(idLote).up();
+
+    const evento = root.ele('evento', { versao: VERSAO_EVENTO });
+    const infEvento = evento.ele('infEvento', { Id: idInfEvento });
+
+    infEvento
+      .ele('cOrgao').txt(cOrgao).up()
+      .ele('tpAmb').txt(String(dados.ambiente ?? 2)).up()
+      .ele('CNPJ').txt(dados.cnpj.replace(/\D/g, '')).up()
+      .ele('chNFe').txt(dados.chaveAcesso).up()
+      .ele('dhEvento').txt(dhEvento).up()
+      .ele('tpEvento').txt(tpEvento).up()
+      .ele('nSeqEvento').txt(String(sequencia)).up()
+      .ele('verEvento').txt(VERSAO_EVENTO).up();
+
+    const detEvento = infEvento.ele('detEvento', { versao: VERSAO_EVENTO });
+    buildDetEvento(detEvento);
+    detEvento.up();
+    infEvento.up();
+    evento.up();
+
+    return root.end({ prettyPrint: false, headless: false });
+  }
+
+  /** @param {import('../types/NFeEvento.js').NFeEventoBase} dados */
+  #validarBase(dados) {
+    const chave = dados.chaveAcesso?.replace(/\D/g, '');
+    if (!chave || chave.length !== 44) {
+      throw new GhinfeError('chaveAcesso deve conter 44 dígitos', 'INVALID_CHAVE');
+    }
+    if (!dados.cnpj) {
+      throw new GhinfeError('cnpj do autor do evento é obrigatório', 'INVALID_CNPJ');
+    }
+    if (!dados.uf) {
+      throw new GhinfeError('uf é obrigatória', 'INVALID_UF');
+    }
+  }
+}