@devlas/dte-sii 2.5.0

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 Devlas SpA — https://devlas.cl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Esta librería implementa el protocolo XML del Servicio de Impuestos Internos (SII)
+de Chile tal como está documentado públicamente por el propio SII.
+Inspirada conceptualmente en LibreDTE de SASCO SpA (https://libredte.cl).

package/LibroBase.js

@@ -0,0 +1,134 @@
+// Copyright (c) 2026 Devlas SpA — https://devlas.cl
+// Licencia MIT. Ver archivo LICENSE para mas detalles.
+/**
+ * LibroBase.js
+ * 
+ * Clase base para libros electrónicos (LibroCompraVenta, LibroGuia).
+ * Contiene lógica común de C14N, firma digital y serialización XML.
+ */
+
+const crypto = require('crypto');
+const { DOMParser } = require('@xmldom/xmldom');
+const { serializeElement, escapeText, escapeAttr } = require('./utils/c14n');
+
+class LibroBase {
+  constructor(certificado) {
+    this.certificado = certificado;
+    this.caratula = null;
+    this.resumen = [];
+    this.detalle = [];
+    this.xml = null;
+    this.id = null;
+  }
+
+  setResumen(resumen) {
+    this.resumen = Array.isArray(resumen) ? resumen : [];
+  }
+
+  setDetalle(detalle) {
+    this.detalle = Array.isArray(detalle) ? detalle : [];
+  }
+
+  /**
+   * Firma el XML del libro.
+   * Método genérico que puede ser usado por subclases.
+   * 
+   * @param {string} xml - XML sin firmar
+   * @param {string} envioTagName - Nombre del tag de envío (ej: 'EnvioLibro')
+   * @param {string} rootTagName - Nombre del tag raíz (ej: 'LibroCompraVenta', 'LibroGuia')
+   * @returns {string} - XML firmado
+   */
+  firmar(xml, envioTagName = 'EnvioLibro', rootTagName = null) {
+    const parser = new DOMParser();
+    const doc = parser.parseFromString(xml, 'text/xml');
+    const envioLibro = doc.getElementsByTagName(envioTagName)[0];
+    
+    // Detectar rootTagName si no se proporciona
+    const detectedRootTagName = rootTagName || doc.documentElement.tagName;
+    const root = doc.getElementsByTagName(detectedRootTagName)[0];
+    const nsDefault = root.getAttribute('xmlns') || 'http://www.sii.cl/SiiDte';
+
+    const c14nEnvio = this._c14nEnvioLibro(envioLibro, nsDefault, envioTagName);
+    const digest = crypto.createHash('sha1').update(c14nEnvio).digest('base64');
+
+    const signedInfoParaFirmar = `<SignedInfo xmlns="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"></CanonicalizationMethod><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"></SignatureMethod><Reference URI="#${this.id}"><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"></Transform></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"></DigestMethod><DigestValue>${digest}</DigestValue></Reference></SignedInfo>`;
+
+    const sign = crypto.createSign('RSA-SHA1');
+    sign.update(signedInfoParaFirmar);
+    const signatureValue = sign.sign(this.certificado.getPrivateKeyPem(), 'base64');
+    const formattedSignatureValue = signatureValue.match(/.{1,76}/g).join('\n');
+
+    const certBase64 = this.certificado.getCertificatePem()
+      .replace('-----BEGIN CERTIFICATE-----', '')
+      .replace('-----END CERTIFICATE-----', '')
+      .replace(/\s/g, '');
+    const modulus = this.certificado.getModulus();
+    const exponent = this.certificado.getExponent();
+
+    const signedInfoParaGuardar = `<SignedInfo xmlns="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/><Reference URI="#${this.id}"><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>${digest}</DigestValue></Reference></SignedInfo>`;
+
+    const signatureXml = `<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">${signedInfoParaGuardar}<SignatureValue>\n${formattedSignatureValue}</SignatureValue><KeyInfo><KeyValue><RSAKeyValue><Modulus>${modulus}</Modulus><Exponent>${exponent}</Exponent></RSAKeyValue></KeyValue><X509Data><X509Certificate>${certBase64}</X509Certificate></X509Data></KeyInfo></Signature>`;
+
+    // Insertar firma antes del cierre del root tag
+    const closeTag = `</${envioTagName}></${detectedRootTagName}>`;
+    const closeTagWithSignature = `</${envioTagName}>${signatureXml}</${detectedRootTagName}>`;
+    
+    // Manejar variaciones de formato (con/sin espacios)
+    return xml
+      .replace(new RegExp(`</${envioTagName}>\\s*</${detectedRootTagName}>`), closeTagWithSignature);
+  }
+
+  /**
+   * Canonicaliza un elemento de envío de libro - Usa utils/c14n.js
+   */
+  _c14nEnvioLibro(elemento, nsDefault, tagName = 'EnvioLibro') {
+    const id = elemento.getAttribute('ID');
+    let c14n = `<${tagName}`;
+    c14n += ` xmlns="${nsDefault}"`;
+    c14n += ` xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"`;
+    c14n += ` ID="${id}">`;
+
+    for (let i = 0; i < elemento.childNodes.length; i++) {
+      const child = elemento.childNodes[i];
+      if (child.nodeType === 1) {
+        c14n += serializeElement(child, { omitRootNs: true });
+      } else if (child.nodeType === 3) {
+        c14n += escapeText(child.nodeValue);
+      }
+    }
+
+    c14n += `</${tagName}>`;
+    return c14n;
+  }
+
+  getXML() {
+    return this.xml;
+  }
+
+  /**
+   * Escapa texto XML (método de conveniencia para subclases)
+   * Usa la función centralizada de utils/c14n.js
+   */
+  _escapeXmlText(text) {
+    return escapeText(text);
+  }
+
+  /**
+   * Escapa atributos XML (método de conveniencia para subclases)
+   * Usa la función centralizada de utils/c14n.js
+   */
+  _escapeXmlAttr(text) {
+    return escapeAttr(text);
+  }
+
+  /**
+   * Obtener timestamp de firma en formato ISO
+   */
+  _getTmstFirma() {
+    const now = new Date();
+    const pad = n => n.toString().padStart(2, '0');
+    return `${now.getFullYear()}-${pad(now.getMonth()+1)}-${pad(now.getDate())}T${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}`;
+  }
+}
+
+module.exports = LibroBase;

package/LibroCompraVenta.js

@@ -0,0 +1,205 @@
+// Copyright (c) 2026 Devlas SpA — https://devlas.cl
+// Licencia MIT. Ver archivo LICENSE para mas detalles.
+/**
+ * LibroCompraVenta.js
+ * 
+ * Genera Libro de Compra/Venta electrónico para el SII.
+ * 
+ * Hereda de LibroBase: C14N, firma digital y serialización XML.
+ */
+
+const LibroBase = require('./LibroBase');
+
+class LibroCompraVenta extends LibroBase {
+  constructor(certificado) {
+    super(certificado);
+  }
+
+  setCaratula(caratula) {
+    this.caratula = { ...caratula };
+    this.id = this.caratula.ID || `LCV_${(caratula.RutEmisorLibro || '').replace('-', '')}_${Date.now()}`;
+  }
+
+  generar() {
+    if (!this.caratula) {
+      throw new Error('Debe establecer la carátula antes de generar');
+    }
+    
+    const caratulaXml = this._renderCaratula();
+    const resumenXml = this._renderResumen();
+    const detalleXml = this._renderDetalle();
+    const envioLibroId = this.id;
+    const tmstFirma = this._getTmstFirma();
+    
+    const xmlSinFirma = `<?xml version="1.0" encoding="ISO-8859-1"?>\n` +
+      `<LibroCompraVenta xmlns="http://www.sii.cl/SiiDte" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sii.cl/SiiDte LibroCV_v10.xsd" version="1.0">` +
+      `<EnvioLibro ID="${envioLibroId}">${caratulaXml}${resumenXml}${detalleXml}<TmstFirma>${tmstFirma}</TmstFirma></EnvioLibro>` +
+      `</LibroCompraVenta>`;
+    
+    const xmlConSaltos = xmlSinFirma.replace(/></g, '><').replace(/></g, '>\n<');
+    // Usar firmar() heredado de LibroBase
+    this.xml = this.firmar(xmlConSaltos, 'EnvioLibro', 'LibroCompraVenta');
+    return this.xml;
+  }
+
+  _renderCaratula() {
+    const c = this.caratula || {};
+    let xml = '<Caratula>';
+    
+    if (c.RutEmisorLibro) xml += `<RutEmisorLibro>${this._escapeXmlText(String(c.RutEmisorLibro))}</RutEmisorLibro>`;
+    if (c.RutEnvia) xml += `<RutEnvia>${this._escapeXmlText(String(c.RutEnvia))}</RutEnvia>`;
+    if (c.PeriodoTributario) xml += `<PeriodoTributario>${this._escapeXmlText(String(c.PeriodoTributario))}</PeriodoTributario>`;
+    if (c.FchResol) xml += `<FchResol>${this._escapeXmlText(String(c.FchResol))}</FchResol>`;
+    // NroResol SIEMPRE presente (aunque sea 0)
+    xml += `<NroResol>${this._escapeXmlText(String(c.NroResol !== undefined ? c.NroResol : '0'))}</NroResol>`;
+    if (c.TipoOperacion) xml += `<TipoOperacion>${this._escapeXmlText(String(c.TipoOperacion))}</TipoOperacion>`;
+    if (c.TipoLibro) xml += `<TipoLibro>${this._escapeXmlText(String(c.TipoLibro))}</TipoLibro>`;
+    if (c.TipoEnvio) xml += `<TipoEnvio>${this._escapeXmlText(String(c.TipoEnvio))}</TipoEnvio>`;
+    if (c.FolioNotificacion) xml += `<FolioNotificacion>${this._escapeXmlText(String(c.FolioNotificacion))}</FolioNotificacion>`;
+    if (c.TmstFirmaEnv) xml += `<TmstFirmaEnv>${this._escapeXmlText(String(c.TmstFirmaEnv))}</TmstFirmaEnv>`;
+    
+    xml += '</Caratula>';
+    return xml;
+  }
+
+  _renderResumen() {
+    if (!this.resumen.length) return '';
+    
+    const tipoEnvio = String(this.caratula?.TipoEnvio || '').toUpperCase();
+    const useSegmento = tipoEnvio && tipoEnvio !== 'TOTAL';
+    const resumenTag = useSegmento ? 'ResumenSegmento' : 'ResumenPeriodo';
+    const totalesTag = useSegmento ? 'TotalesSegmento' : 'TotalesPeriodo';
+    
+    const order = [
+      'TpoDoc', 'TpoImp', 'TotDoc', 'TotAnulado', 'TotOpExe', 'TotMntExe',
+      'TotMntNeto', 'TotOpIVARec', 'TotMntIVA', 'TotOpActivoFijo',
+      'TotMntActivoFijo', 'TotMntIVAActivoFijo', 'TotIVANoRec',
+      'TotOpIVAUsoComun', 'TotIVAUsoComun', 'FctProp', 'TotCredIVAUsoComun',
+      'TotIVAFueraPlazo', 'TotIVAPropio', 'TotIVATerceros', 'TotLey18211',
+      'TotOtrosImp', 'TotImpSinCredito', 'TotOpIVARetTotal', 'TotIVARetTotal',
+      'TotOpIVARetParcial', 'TotIVARetParcial', 'TotCredEC', 'TotDepEnvase',
+      'TotLiquidaciones', 'TotMntTotal', 'TotOpIVANoRetenido', 'TotIVANoRetenido',
+      'TotMntNoFact', 'TotMntPeriodo', 'TotPsjNac', 'TotPsjInt', 'TotTabPuros',
+      'TotTabCigarrillos', 'TotTabElaborado', 'TotImpVehiculo',
+    ];
+    
+    let xml = `<${resumenTag}>`;
+    for (const r of this.resumen) {
+      const normalized = { ...r };
+      if (
+        normalized.TotMntExe === undefined &&
+        (normalized.TotMntNeto !== undefined ||
+          normalized.TotMntIVA !== undefined ||
+          normalized.TotMntTotal !== undefined)
+      ) {
+        normalized.TotMntExe = 0;
+      }
+      
+      xml += `<${totalesTag}>`;
+      order.forEach((key) => {
+        const value = normalized[key];
+        if (value === undefined || value === null || value === '') return;
+        
+        if (Array.isArray(value)) {
+          value.forEach((item) => {
+            if (item && typeof item === 'object') {
+              xml += `<${key}>`;
+              Object.keys(item).forEach((itemKey) => {
+                if (item[itemKey] !== undefined && item[itemKey] !== null && item[itemKey] !== '') {
+                  xml += `<${itemKey}>${this._escapeXmlText(String(item[itemKey]))}</${itemKey}>`;
+                }
+              });
+              xml += `</${key}>`;
+            } else {
+              xml += `<${key}>${this._escapeXmlText(String(item))}</${key}>`;
+            }
+          });
+        } else if (value && typeof value === 'object') {
+          xml += `<${key}>`;
+          Object.keys(value).forEach((itemKey) => {
+            if (value[itemKey] !== undefined && value[itemKey] !== null && value[itemKey] !== '') {
+              xml += `<${itemKey}>${this._escapeXmlText(String(value[itemKey]))}</${itemKey}>`;
+            }
+          });
+          xml += `</${key}>`;
+        } else {
+          xml += `<${key}>${this._escapeXmlText(String(value))}</${key}>`;
+        }
+      });
+      xml += `</${totalesTag}>`;
+    }
+    xml += `</${resumenTag}>`;
+    return xml;
+  }
+
+  _renderDetalle() {
+    if (!this.detalle.length) return '';
+    
+    const order = [
+      'TpoDoc', 'Emisor', 'IndFactCompra', 'NroDoc', 'Anulado', 'Operacion',
+      'TpoImp', 'TasaImp', 'NumInt', 'IndServicio', 'IndSinCosto', 'FchDoc',
+      'CdgSIISucur', 'RUTDoc', 'RznSoc', 'Extranjero', 'TpoDocRef', 'FolioDocRef',
+      'MntExe', 'MntNeto', 'MntIVA', 'MntActivoFijo', 'MntIVAActivoFijo',
+      'IVANoRec', 'IVAUsoComun', 'IVAFueraPlazo', 'IVAPropio', 'IVATerceros',
+      'Ley18211', 'OtrosImp', 'MntSinCred', 'IVARetTotal', 'IVARetParcial',
+      'CredEC', 'DepEnvase', 'Liquidaciones', 'MntTotal', 'IVANoRetenido',
+      'MntNoFact', 'MntPeriodo', 'PsjNac', 'PsjInt', 'TabPuros', 'TabCigarrillos',
+      'TabElaborado', 'ImpVehiculo',
+    ];
+    
+    let xml = '';
+    for (const d of this.detalle) {
+      const normalized = { ...d };
+      
+      // Calcular TasaImp si no existe
+      if (
+        (normalized.TasaImp === undefined || normalized.TasaImp === null || normalized.TasaImp === '') &&
+        normalized.MntNeto !== undefined &&
+        normalized.MntIVA !== undefined
+      ) {
+        const neto = Number(normalized.MntNeto);
+        const iva = Number(normalized.MntIVA);
+        if (Number.isFinite(neto) && Number.isFinite(iva) && neto > 0 && iva > 0) {
+          const tasa = (iva / neto) * 100;
+          normalized.TasaImp = tasa.toFixed(2).replace(/\.00$/, '.0');
+        }
+      }
+      
+      xml += '<Detalle>';
+      order.forEach((key) => {
+        const value = normalized[key];
+        if (value === undefined || value === null || value === '') return;
+        
+        if (Array.isArray(value)) {
+          value.forEach((item) => {
+            if (item && typeof item === 'object') {
+              xml += `<${key}>`;
+              Object.keys(item).forEach((itemKey) => {
+                if (item[itemKey] !== undefined && item[itemKey] !== null && item[itemKey] !== '') {
+                  xml += `<${itemKey}>${this._escapeXmlText(String(item[itemKey]))}</${itemKey}>`;
+                }
+              });
+              xml += `</${key}>`;
+            } else {
+              xml += `<${key}>${this._escapeXmlText(String(item))}</${key}>`;
+            }
+          });
+        } else if (value && typeof value === 'object') {
+          xml += `<${key}>`;
+          Object.keys(value).forEach((itemKey) => {
+            if (value[itemKey] !== undefined && value[itemKey] !== null && value[itemKey] !== '') {
+              xml += `<${itemKey}>${this._escapeXmlText(String(value[itemKey]))}</${itemKey}>`;
+            }
+          });
+          xml += `</${key}>`;
+        } else {
+          xml += `<${key}>${this._escapeXmlText(String(value))}</${key}>`;
+        }
+      });
+      xml += '</Detalle>';
+    }
+    return xml;
+  }
+}
+
+module.exports = LibroCompraVenta;

package/LibroGuia.js

@@ -0,0 +1,225 @@
+// Copyright (c) 2026 Devlas SpA — https://devlas.cl
+// Licencia MIT. Ver archivo LICENSE para mas detalles.
+/**
+ * LibroGuia.js
+ * 
+ * Genera Libro de Guías de Despacho electrónico para el SII.
+ * 
+ * Hereda de LibroBase: C14N, firma digital y serialización XML.
+ */
+
+const LibroBase = require('./LibroBase');
+
+class LibroGuia extends LibroBase {
+  constructor(certificado) {
+    super(certificado);
+  }
+
+  setCaratula(caratula) {
+    this.caratula = {
+      RutEmisorLibro: null,
+      RutEnvia: this.certificado?.rut || null,
+      PeriodoTributario: null,
+      FchResol: null,
+      NroResol: 0,
+      TipoLibro: 'ESPECIAL',
+      TipoEnvio: 'TOTAL',
+      FolioNotificacion: null,
+      ...caratula,
+    };
+    
+    if (this.caratula.TipoEnvio === 'ESPECIAL') {
+      this.caratula.FolioNotificacion = null;
+    }
+    
+    this.id = this.caratula.ID || `LIBRO_GUIA_${(this.caratula.RutEmisorLibro || '').replace('-', '')}_${String(this.caratula.PeriodoTributario || '').replace(/-/g, '')}_${Date.now()}`;
+  }
+
+  generar() {
+    if (!this.caratula) {
+      throw new Error('Debe establecer la carátula antes de generar');
+    }
+
+    const caratulaXml = this._renderCaratula();
+    const resumenXml = this._renderResumen();
+    const detalleXml = this._renderDetalle();
+
+    const schemaLoc = 'http://www.sii.cl/SiiDte LibroGuia_v10.xsd';
+    const tmstFirma = this._getTmstFirma();
+    
+    const xmlSinFirma = `<?xml version="1.0" encoding="ISO-8859-1"?>\n` +
+      `<LibroGuia xmlns="http://www.sii.cl/SiiDte" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="${schemaLoc}" version="1.0">` +
+      `<EnvioLibro ID="${this.id}">${caratulaXml}${resumenXml}${detalleXml}<TmstFirma>${tmstFirma}</TmstFirma></EnvioLibro>` +
+      `</LibroGuia>`;
+
+    // Usar firmar() heredado de LibroBase
+    this.xml = this.firmar(xmlSinFirma, 'EnvioLibro', 'LibroGuia');
+    return this.xml;
+  }
+
+  _renderCaratula(includeVersion = false) {
+    const c = this.caratula || {};
+    const fields = [
+      'RutEmisorLibro',
+      'RutEnvia',
+      'PeriodoTributario',
+      'FchResol',
+      'NroResol',
+      'TipoLibro',
+      'TipoEnvio',
+      'FolioNotificacion',
+    ];
+    
+    let xml = includeVersion ? '<Caratula version="1.0">' : '<Caratula>';
+    for (const f of fields) {
+      if (f === 'NroResol') {
+        xml += `<NroResol>${this._escapeXmlText(String(c.NroResol !== undefined ? c.NroResol : '0'))}</NroResol>`;
+        continue;
+      }
+      if (c[f] !== undefined && c[f] !== null && c[f] !== '') {
+        xml += `<${f}>${this._escapeXmlText(String(c[f]))}</${f}>`;
+      }
+    }
+    xml += '</Caratula>';
+    return xml;
+  }
+
+  _renderResumen() {
+    const resumen = this._buildResumenPeriodo();
+    if (!resumen) return '';
+    
+    const order = [
+      'TotFolAnulado',
+      'TotGuiaAnulada',
+      'TotGuiaVenta',
+      'TotMntGuiaVta',
+      'TotTraslado',
+    ];
+    
+    let xml = '<ResumenPeriodo>';
+    order.forEach((key) => {
+      const value = resumen[key];
+      if (value === undefined || value === null || value === '' || value === false) return;
+      
+      if (Array.isArray(value)) {
+        value.forEach((item) => {
+          if (item && typeof item === 'object') {
+            xml += `<${key}>`;
+            Object.keys(item).forEach((itemKey) => {
+              if (item[itemKey] !== undefined && item[itemKey] !== null && item[itemKey] !== '') {
+                xml += `<${itemKey}>${this._escapeXmlText(String(item[itemKey]))}</${itemKey}>`;
+              }
+            });
+            xml += `</${key}>`;
+          }
+        });
+      } else {
+        xml += `<${key}>${this._escapeXmlText(String(value))}</${key}>`;
+      }
+    });
+    xml += '</ResumenPeriodo>';
+    return xml;
+  }
+
+  _renderDetalle() {
+    if (!this.detalle.length) return '';
+    
+    const order = [
+      'Folio', 'Anulado', 'Operacion', 'TpoOper', 'FchDoc', 'RUTDoc',
+      'RznSoc', 'MntNeto', 'TasaImp', 'IVA', 'MntTotal', 'MntModificado',
+      'TpoDocRef', 'FolioDocRef', 'FchDocRef',
+    ];
+    
+    let xml = '';
+    for (const d of this.detalle) {
+      const normalized = {
+        Folio: null,
+        Anulado: null,
+        Operacion: null,
+        TpoOper: null,
+        FchDoc: null,
+        RUTDoc: null,
+        RznSoc: null,
+        MntNeto: null,
+        TasaImp: 0,
+        IVA: 0,
+        MntTotal: null,
+        MntModificado: null,
+        TpoDocRef: null,
+        FolioDocRef: null,
+        FchDocRef: null,
+        ...d,
+      };
+      
+      // Calcular IVA si no existe
+      if ((!normalized.IVA || Number(normalized.IVA) === 0) && normalized.TasaImp && normalized.MntNeto) {
+        const neto = Number(normalized.MntNeto);
+        const tasa = Number(normalized.TasaImp);
+        if (Number.isFinite(neto) && Number.isFinite(tasa)) {
+          normalized.IVA = Math.round(neto * (tasa / 100));
+        }
+      }
+      
+      // Calcular MntTotal si no existe
+      if (normalized.MntTotal === null || normalized.MntTotal === undefined || normalized.MntTotal === '') {
+        const neto = Number(normalized.MntNeto) || 0;
+        const iva = Number(normalized.IVA) || 0;
+        normalized.MntTotal = neto + iva;
+      }
+
+      xml += '<Detalle>';
+      order.forEach((key) => {
+        const value = normalized[key];
+        if (value === undefined || value === null || value === '' || value === false) return;
+        xml += `<${key}>${this._escapeXmlText(String(value))}</${key}>`;
+      });
+      xml += '</Detalle>';
+    }
+    return xml;
+  }
+
+  _buildResumenPeriodo() {
+    if (!this.detalle.length) return null;
+    
+    const resumen = {
+      TotFolAnulado: false,
+      TotGuiaAnulada: false,
+      TotGuiaVenta: 0,
+      TotMntGuiaVta: 0,
+      TotTraslado: false,
+    };
+
+    for (const d of this.detalle) {
+      const anulado = Number(d.Anulado);
+      if (anulado === 1 || anulado === 2) {
+        if (anulado === 1) {
+          resumen.TotFolAnulado = (resumen.TotFolAnulado || 0) + 1;
+        } else {
+          resumen.TotGuiaAnulada = (resumen.TotGuiaAnulada || 0) + 1;
+        }
+        continue;
+      }
+
+      const tpoOper = Number(d.TpoOper);
+      const mntTotal = Number(d.MntTotal || 0);
+      
+      if (tpoOper === 1) {
+        resumen.TotGuiaVenta += 1;
+        resumen.TotMntGuiaVta += mntTotal;
+      } else if (!Number.isNaN(tpoOper)) {
+        if (!resumen.TotTraslado) resumen.TotTraslado = [];
+        let item = resumen.TotTraslado.find((t) => Number(t.TpoTraslado) === tpoOper);
+        if (!item) {
+          item = { TpoTraslado: tpoOper, CantGuia: 0, MntGuia: 0 };
+          resumen.TotTraslado.push(item);
+        }
+        item.CantGuia += 1;
+        item.MntGuia += mntTotal;
+      }
+    }
+
+    return resumen;
+  }
+}
+
+module.exports = LibroGuia;