@devlas/dte-sii 2.5.11 → 2.5.12

package/cert/LibroGuias.js

@@ -1,171 +1,171 @@
 // Copyright (c) 2026 Devlas SpA — https://devlas.cl
 // Licencia MIT. Ver archivo LICENSE para mas detalles.
-/**
- * LibroGuias.js - Generador de Libro de Guías para Certificación SII
- * 
- * Construye el libro de guías a partir de los resultados del SetGuia.
- * 
- * Documentos incluidos:
- * - Guías de Despacho (52)
- * 
- * El resumen (ResumenPeriodo) se genera automáticamente por LibroGuia._buildResumenPeriodo()
- * 
- * Tipos de Operación (TpoOper):
- * - 1: Venta (incluye datos de receptor y montos)
- * - 2-9: Traslados varios (sin datos comerciales)
- * 
- * Estados especiales:
- * - Anulado=1: Folio anulado (TotFolAnulado)
- * - Anulado=2: Guía anulada (TotGuiaAnulada)
- * 
- * @module dte-sii/cert/LibroGuias
- */
-
-const { LibroGuia } = require('../index');
-
-// Valor por defecto para certificación
-const FOLIO_NOTIFICACION_DEFAULT = 3;
-
-/**
- * @typedef {Object} LibroGuiasConfig
- * @property {Object} emisor - Datos del emisor
- * @property {Object} receptor - Datos del receptor
- * @property {string} periodo - Período tributario (YYYY-MM)
- * @property {Object} certificado - Instancia de Certificado
- * @property {number} [folioNotificacion=3] - Folio de notificación SII
- */
-
-class LibroGuias {
-  /**
-   * @param {LibroGuiasConfig} config
-   */
-  constructor(config) {
-    this.config = config;
-    this.emisor = config.emisor;
-    this.receptor = config.receptor;
-    this.periodo = config.periodo;
-    this.certificado = config.certificado;
-    this.folioNotificacion = config.folioNotificacion || FOLIO_NOTIFICACION_DEFAULT;
-  }
-
-  /**
-   * Genera el libro de guías desde los resultados del SetGuia
-   * @param {Object} setGuiaResult - Resultado de SetGuia.ejecutar()
-   * @param {Object} [options] - Opciones adicionales
-   * @param {Object} [options.casosLibro] - Configuración especial por caso (anulado, operacion)
-   * @returns {Object} { libro, xml, detalle }
-   */
-  generar(setGuiaResult, options = {}) {
-    const { documentos } = setGuiaResult;
-    
-    if (!documentos || documentos.length === 0) {
-      throw new Error('LibroGuias: No hay documentos del SetGuia para generar libro');
-    }
-
-    const casosLibro = options.casosLibro || this._getDefaultCasosLibro(documentos.length);
-    const detalles = [];
-
-    // Procesar cada documento del set guía
-    for (let i = 0; i < documentos.length; i++) {
-      const doc = documentos[i];
-      const casoConfig = casosLibro[i] || {};
-      const detalle = this._buildDetalle(doc, casoConfig);
-      detalles.push(detalle);
-    }
-
-    // Crear libro (el resumen se genera automáticamente en LibroGuia._buildResumenPeriodo)
-    const libro = new LibroGuia(this.certificado);
-    libro.setCaratula({
-      RutEmisorLibro: this.emisor.rut,
-      RutEnvia: this.certificado.rut || this.emisor.rut,
-      PeriodoTributario: this.periodo,
-      FchResol: this.emisor.fch_resol,
-      NroResol: this.emisor.nro_resol,
-      TipoLibro: 'ESPECIAL',
-      TipoEnvio: 'TOTAL',
-      FolioNotificacion: this.folioNotificacion,
-    });
-    libro.setDetalle(detalles);
-    libro.generar();
-
-    return {
-      libro,
-      xml: libro.getXML(),
-      detalle: detalles,
-    };
-  }
-
-  /**
-   * Configuración por defecto para casos de certificación:
-   * - Caso 1 (índice 0): Normal
-   * - Caso 2 (índice 1): Operacion=1 (modificación)
-   * - Caso 3 (índice 2): Anulado=2 (guía anulada)
-   * @private
-   */
-  _getDefaultCasosLibro(count) {
-    const casos = [];
-    for (let i = 0; i < count; i++) {
-      const caso = {};
-      if (i === 1) caso.operacion = 1; // Segundo caso: modificación
-      if (i === 2) caso.anulado = 2;   // Tercer caso: anulado
-      casos.push(caso);
-    }
-    return casos;
-  }
-
-  /**
-   * Construye un registro de detalle desde un documento
-   * @private
-   */
-  _buildDetalle(doc, casoConfig) {
-    const totales = doc.totales || {};
-    const fechaDoc = doc.fecha || `${this.periodo}-15`;
-    
-    // Determinar tipo de operación desde el documento o caso
-    // IndTraslado=1 (venta) => TpoOper=1
-    const indTraslado = doc.indTraslado || 1;
-    const tpoOper = indTraslado === 1 ? 1 : indTraslado;
-
-    const detalle = {
-      Folio: doc.folio,
-      TpoOper: tpoOper,
-      FchDoc: fechaDoc,
-    };
-
-    // Anulado (1=folio anulado, 2=guía anulada)
-    if (casoConfig.anulado) {
-      detalle.Anulado = casoConfig.anulado;
-      detalle.MntTotal = 0;
-      // No incluir otros campos en guías anuladas
-      return detalle;
-    }
-
-    // Operación (1=modificación de texto)
-    if (casoConfig.operacion) {
-      detalle.Operacion = casoConfig.operacion;
-    }
-
-    // Para ventas (TpoOper=1), incluir datos comerciales
-    if (tpoOper === 1) {
-      if (this.receptor.rut) detalle.RUTDoc = this.receptor.rut;
-      if (this.receptor.razon_social) detalle.RznSoc = this.receptor.razon_social;
-      
-      const mntNeto = Number(totales.MntNeto || 0);
-      const tasaIva = Number(totales.TasaIVA || 19);
-      const iva = Number(totales.IVA || 0);
-      
-      if (mntNeto > 0) {
-        detalle.MntNeto = mntNeto;
-        detalle.TasaImp = tasaIva;
-        detalle.IVA = iva > 0 ? iva : Math.round(mntNeto * (tasaIva / 100));
-      }
-    }
-
-    // Monto Total
-    detalle.MntTotal = Number(totales.MntTotal || 0);
-
-    return detalle;
-  }
-}
-
-module.exports = LibroGuias;
+/**
+ * LibroGuias.js - Generador de Libro de Guías para Certificación SII
+ * 
+ * Construye el libro de guías a partir de los resultados del SetGuia.
+ * 
+ * Documentos incluidos:
+ * - Guías de Despacho (52)
+ * 
+ * El resumen (ResumenPeriodo) se genera automáticamente por LibroGuia._buildResumenPeriodo()
+ * 
+ * Tipos de Operación (TpoOper):
+ * - 1: Venta (incluye datos de receptor y montos)
+ * - 2-9: Traslados varios (sin datos comerciales)
+ * 
+ * Estados especiales:
+ * - Anulado=1: Folio anulado (TotFolAnulado)
+ * - Anulado=2: Guía anulada (TotGuiaAnulada)
+ * 
+ * @module dte-sii/cert/LibroGuias
+ */
+
+const { LibroGuia } = require('../index');
+
+// Valor por defecto para certificación
+const FOLIO_NOTIFICACION_DEFAULT = 3;
+
+/**
+ * @typedef {Object} LibroGuiasConfig
+ * @property {Object} emisor - Datos del emisor
+ * @property {Object} receptor - Datos del receptor
+ * @property {string} periodo - Período tributario (YYYY-MM)
+ * @property {Object} certificado - Instancia de Certificado
+ * @property {number} [folioNotificacion=3] - Folio de notificación SII
+ */
+
+class LibroGuias {
+  /**
+   * @param {LibroGuiasConfig} config
+   */
+  constructor(config) {
+    this.config = config;
+    this.emisor = config.emisor;
+    this.receptor = config.receptor;
+    this.periodo = config.periodo;
+    this.certificado = config.certificado;
+    this.folioNotificacion = config.folioNotificacion || FOLIO_NOTIFICACION_DEFAULT;
+  }
+
+  /**
+   * Genera el libro de guías desde los resultados del SetGuia
+   * @param {Object} setGuiaResult - Resultado de SetGuia.ejecutar()
+   * @param {Object} [options] - Opciones adicionales
+   * @param {Object} [options.casosLibro] - Configuración especial por caso (anulado, operacion)
+   * @returns {Object} { libro, xml, detalle }
+   */
+  generar(setGuiaResult, options = {}) {
+    const { documentos } = setGuiaResult;
+    
+    if (!documentos || documentos.length === 0) {
+      throw new Error('LibroGuias: No hay documentos del SetGuia para generar libro');
+    }
+
+    const casosLibro = options.casosLibro || this._getDefaultCasosLibro(documentos.length);
+    const detalles = [];
+
+    // Procesar cada documento del set guía
+    for (let i = 0; i < documentos.length; i++) {
+      const doc = documentos[i];
+      const casoConfig = casosLibro[i] || {};
+      const detalle = this._buildDetalle(doc, casoConfig);
+      detalles.push(detalle);
+    }
+
+    // Crear libro (el resumen se genera automáticamente en LibroGuia._buildResumenPeriodo)
+    const libro = new LibroGuia(this.certificado);
+    libro.setCaratula({
+      RutEmisorLibro: this.emisor.rut,
+      RutEnvia: this.certificado.rut || this.emisor.rut,
+      PeriodoTributario: this.periodo,
+      FchResol: this.emisor.fch_resol,
+      NroResol: this.emisor.nro_resol,
+      TipoLibro: 'ESPECIAL',
+      TipoEnvio: 'TOTAL',
+      FolioNotificacion: this.folioNotificacion,
+    });
+    libro.setDetalle(detalles);
+    libro.generar();
+
+    return {
+      libro,
+      xml: libro.getXML(),
+      detalle: detalles,
+    };
+  }
+
+  /**
+   * Configuración por defecto para casos de certificación:
+   * - Caso 1 (índice 0): Normal
+   * - Caso 2 (índice 1): Operacion=1 (modificación)
+   * - Caso 3 (índice 2): Anulado=2 (guía anulada)
+   * @private
+   */
+  _getDefaultCasosLibro(count) {
+    const casos = [];
+    for (let i = 0; i < count; i++) {
+      const caso = {};
+      if (i === 1) caso.operacion = 1; // Segundo caso: modificación
+      if (i === 2) caso.anulado = 2;   // Tercer caso: anulado
+      casos.push(caso);
+    }
+    return casos;
+  }
+
+  /**
+   * Construye un registro de detalle desde un documento
+   * @private
+   */
+  _buildDetalle(doc, casoConfig) {
+    const totales = doc.totales || {};
+    const fechaDoc = doc.fecha || `${this.periodo}-15`;
+    
+    // Determinar tipo de operación desde el documento o caso
+    // IndTraslado=1 (venta) => TpoOper=1
+    const indTraslado = doc.indTraslado || 1;
+    const tpoOper = indTraslado === 1 ? 1 : indTraslado;
+
+    const detalle = {
+      Folio: doc.folio,
+      TpoOper: tpoOper,
+      FchDoc: fechaDoc,
+    };
+
+    // Anulado (1=folio anulado, 2=guía anulada)
+    if (casoConfig.anulado) {
+      detalle.Anulado = casoConfig.anulado;
+      detalle.MntTotal = 0;
+      // No incluir otros campos en guías anuladas
+      return detalle;
+    }
+
+    // Operación (1=modificación de texto)
+    if (casoConfig.operacion) {
+      detalle.Operacion = casoConfig.operacion;
+    }
+
+    // Para ventas (TpoOper=1), incluir datos comerciales
+    if (tpoOper === 1) {
+      if (this.receptor.rut) detalle.RUTDoc = this.receptor.rut;
+      if (this.receptor.razon_social) detalle.RznSoc = this.receptor.razon_social;
+      
+      const mntNeto = Number(totales.MntNeto || 0);
+      const tasaIva = Number(totales.TasaIVA || 19);
+      const iva = Number(totales.IVA || 0);
+      
+      if (mntNeto > 0) {
+        detalle.MntNeto = mntNeto;
+        detalle.TasaImp = tasaIva;
+        detalle.IVA = iva > 0 ? iva : Math.round(mntNeto * (tasaIva / 100));
+      }
+    }
+
+    // Monto Total
+    detalle.MntTotal = Number(totales.MntTotal || 0);
+
+    return detalle;
+  }
+}
+
+module.exports = LibroGuias;

package/cert/LibroVentas.js

@@ -1,153 +1,153 @@
 // Copyright (c) 2026 Devlas SpA — https://devlas.cl
 // Licencia MIT. Ver archivo LICENSE para mas detalles.
-/**
- * LibroVentas.js - Generador de Libro de Ventas para Certificación SII
- * 
- * Construye el libro de ventas a partir de los resultados del SetBasico.
- * 
- * Documentos incluidos:
- * - Facturas (33)
- * - Notas de Crédito (61)
- * - Notas de Débito (56)
- * 
- * @module dte-sii/cert/LibroVentas
- */
-
-const { LibroCompraVenta } = require('../index');
-
-/**
- * @typedef {Object} LibroVentasConfig
- * @property {Object} emisor - Datos del emisor
- * @property {Object} receptor - Datos del receptor (para RUTDoc/RznSoc)
- * @property {string} periodo - Período tributario (YYYY-MM)
- * @property {Object} certificado - Instancia de Certificado
- * @property {string} [signoNC='POSITIVO'] - 'POSITIVO' o 'NEGATIVO' para NC
- */
-
-class LibroVentas {
-  /**
-   * @param {LibroVentasConfig} config
-   */
-  constructor(config) {
-    this.config = config;
-    this.emisor = config.emisor;
-    this.receptor = config.receptor;
-    this.periodo = config.periodo;
-    this.certificado = config.certificado;
-    this.signoNC = (config.signoNC || 'POSITIVO').toUpperCase();
-  }
-
-  /**
-   * Genera el libro de ventas desde los resultados del SetBasico
-   * @param {Object} setBasicoResult - Resultado de SetBasico.ejecutar()
-   * @returns {Object} { libro, xml, detalle, resumen }
-   */
-  generar(setBasicoResult) {
-    const { documentos } = setBasicoResult;
-    
-    if (!documentos || documentos.length === 0) {
-      throw new Error('LibroVentas: No hay documentos del SetBasico para generar libro');
-    }
-
-    const fechaBase = `${this.periodo}-15`;
-    const detalles = [];
-    const resumenMap = new Map();
-
-    // Procesar cada documento del set básico
-    for (const doc of documentos) {
-      const tipoDte = doc.tipoDte;
-      const folio = doc.folio;
-      const totales = doc.totales || {};
-
-      // Calcular signo (NC puede ser negativa según configuración)
-      const sign = this._getSignByTipoDte(tipoDte);
-
-      // Construir detalle
-      const detalle = {
-        TpoDoc: tipoDte,
-        NroDoc: folio,
-        FchDoc: fechaBase,
-        RUTDoc: this.receptor.rut,
-        RznSoc: this.receptor.razon_social,
-        MntExe: Math.round(Number(totales.MntExe || 0) * sign),
-        MntNeto: Math.round(Number(totales.MntNeto || 0) * sign),
-        MntIVA: Math.round(Number(totales.IVA || 0) * sign),
-        MntTotal: Math.round(Number(totales.MntTotal || 0) * sign),
-      };
-
-      // Agregar TasaImp si hay IVA
-      if (totales.TasaIVA !== undefined && totales.TasaIVA > 0) {
-        detalle.TasaImp = Number(totales.TasaIVA);
-      }
-
-      detalles.push(detalle);
-
-      // Acumular resumen por tipo de documento
-      this._addToResumen(resumenMap, tipoDte, totales, sign);
-    }
-
-    // Convertir resumen a array
-    const resumen = Array.from(resumenMap.values());
-
-    // Crear libro
-    const libro = new LibroCompraVenta(this.certificado);
-    libro.setCaratula({
-      RutEmisorLibro: this.emisor.rut,
-      RutEnvia: this.certificado.rut || this.emisor.rut,
-      PeriodoTributario: this.periodo,
-      FchResol: this.emisor.fch_resol,
-      NroResol: this.emisor.nro_resol,
-      TipoOperacion: 'VENTA',
-      TipoLibro: 'MENSUAL',
-      TipoEnvio: 'TOTAL',
-    });
-    libro.setResumen(resumen);
-    libro.setDetalle(detalles);
-    libro.generar();
-
-    return {
-      libro,
-      xml: libro.getXML(),
-      detalle: detalles,
-      resumen,
-    };
-  }
-
-  /**
-   * Obtiene el signo para un tipo de DTE
-   * @private
-   */
-  _getSignByTipoDte(tipoDte) {
-    // NC (61) puede tener signo negativo según configuración
-    if (tipoDte === 61 && this.signoNC === 'NEGATIVO') {
-      return -1;
-    }
-    return 1;
-  }
-
-  /**
-   * Agrega totales al resumen acumulado
-   * @private
-   */
-  _addToResumen(resumenMap, tipoDte, totales, sign) {
-    if (!resumenMap.has(tipoDte)) {
-      resumenMap.set(tipoDte, {
-        TpoDoc: tipoDte,
-        TotDoc: 0,
-        TotMntExe: 0,
-        TotMntNeto: 0,
-        TotMntIVA: 0,
-        TotMntTotal: 0,
-      });
-    }
-
-    const r = resumenMap.get(tipoDte);
-    r.TotDoc += 1;
-    r.TotMntExe += Math.round(Number(totales.MntExe || 0) * sign);
-    r.TotMntNeto += Math.round(Number(totales.MntNeto || 0) * sign);
-    r.TotMntIVA += Math.round(Number(totales.IVA || 0) * sign);
-    r.TotMntTotal += Math.round(Number(totales.MntTotal || 0) * sign);
-  }
-}
-
-module.exports = LibroVentas;
+/**
+ * LibroVentas.js - Generador de Libro de Ventas para Certificación SII
+ * 
+ * Construye el libro de ventas a partir de los resultados del SetBasico.
+ * 
+ * Documentos incluidos:
+ * - Facturas (33)
+ * - Notas de Crédito (61)
+ * - Notas de Débito (56)
+ * 
+ * @module dte-sii/cert/LibroVentas
+ */
+
+const { LibroCompraVenta } = require('../index');
+
+/**
+ * @typedef {Object} LibroVentasConfig
+ * @property {Object} emisor - Datos del emisor
+ * @property {Object} receptor - Datos del receptor (para RUTDoc/RznSoc)
+ * @property {string} periodo - Período tributario (YYYY-MM)
+ * @property {Object} certificado - Instancia de Certificado
+ * @property {string} [signoNC='POSITIVO'] - 'POSITIVO' o 'NEGATIVO' para NC
+ */
+
+class LibroVentas {
+  /**
+   * @param {LibroVentasConfig} config
+   */
+  constructor(config) {
+    this.config = config;
+    this.emisor = config.emisor;
+    this.receptor = config.receptor;
+    this.periodo = config.periodo;
+    this.certificado = config.certificado;
+    this.signoNC = (config.signoNC || 'POSITIVO').toUpperCase();
+  }
+
+  /**
+   * Genera el libro de ventas desde los resultados del SetBasico
+   * @param {Object} setBasicoResult - Resultado de SetBasico.ejecutar()
+   * @returns {Object} { libro, xml, detalle, resumen }
+   */
+  generar(setBasicoResult) {
+    const { documentos } = setBasicoResult;
+    
+    if (!documentos || documentos.length === 0) {
+      throw new Error('LibroVentas: No hay documentos del SetBasico para generar libro');
+    }
+
+    const fechaBase = `${this.periodo}-15`;
+    const detalles = [];
+    const resumenMap = new Map();
+
+    // Procesar cada documento del set básico
+    for (const doc of documentos) {
+      const tipoDte = doc.tipoDte;
+      const folio = doc.folio;
+      const totales = doc.totales || {};
+
+      // Calcular signo (NC puede ser negativa según configuración)
+      const sign = this._getSignByTipoDte(tipoDte);
+
+      // Construir detalle
+      const detalle = {
+        TpoDoc: tipoDte,
+        NroDoc: folio,
+        FchDoc: fechaBase,
+        RUTDoc: this.receptor.rut,
+        RznSoc: this.receptor.razon_social,
+        MntExe: Math.round(Number(totales.MntExe || 0) * sign),
+        MntNeto: Math.round(Number(totales.MntNeto || 0) * sign),
+        MntIVA: Math.round(Number(totales.IVA || 0) * sign),
+        MntTotal: Math.round(Number(totales.MntTotal || 0) * sign),
+      };
+
+      // Agregar TasaImp si hay IVA
+      if (totales.TasaIVA !== undefined && totales.TasaIVA > 0) {
+        detalle.TasaImp = Number(totales.TasaIVA);
+      }
+
+      detalles.push(detalle);
+
+      // Acumular resumen por tipo de documento
+      this._addToResumen(resumenMap, tipoDte, totales, sign);
+    }
+
+    // Convertir resumen a array
+    const resumen = Array.from(resumenMap.values());
+
+    // Crear libro
+    const libro = new LibroCompraVenta(this.certificado);
+    libro.setCaratula({
+      RutEmisorLibro: this.emisor.rut,
+      RutEnvia: this.certificado.rut || this.emisor.rut,
+      PeriodoTributario: this.periodo,
+      FchResol: this.emisor.fch_resol,
+      NroResol: this.emisor.nro_resol,
+      TipoOperacion: 'VENTA',
+      TipoLibro: 'MENSUAL',
+      TipoEnvio: 'TOTAL',
+    });
+    libro.setResumen(resumen);
+    libro.setDetalle(detalles);
+    libro.generar();
+
+    return {
+      libro,
+      xml: libro.getXML(),
+      detalle: detalles,
+      resumen,
+    };
+  }
+
+  /**
+   * Obtiene el signo para un tipo de DTE
+   * @private
+   */
+  _getSignByTipoDte(tipoDte) {
+    // NC (61) puede tener signo negativo según configuración
+    if (tipoDte === 61 && this.signoNC === 'NEGATIVO') {
+      return -1;
+    }
+    return 1;
+  }
+
+  /**
+   * Agrega totales al resumen acumulado
+   * @private
+   */
+  _addToResumen(resumenMap, tipoDte, totales, sign) {
+    if (!resumenMap.has(tipoDte)) {
+      resumenMap.set(tipoDte, {
+        TpoDoc: tipoDte,
+        TotDoc: 0,
+        TotMntExe: 0,
+        TotMntNeto: 0,
+        TotMntIVA: 0,
+        TotMntTotal: 0,
+      });
+    }
+
+    const r = resumenMap.get(tipoDte);
+    r.TotDoc += 1;
+    r.TotMntExe += Math.round(Number(totales.MntExe || 0) * sign);
+    r.TotMntNeto += Math.round(Number(totales.MntNeto || 0) * sign);
+    r.TotMntIVA += Math.round(Number(totales.IVA || 0) * sign);
+    r.TotMntTotal += Math.round(Number(totales.MntTotal || 0) * sign);
+  }
+}
+
+module.exports = LibroVentas;