@devlas/dte-sii 2.5.12 → 2.5.14

package/cert/SetParser.js

@@ -124,12 +124,12 @@ function mapearTipoDocLibro(tipo) {
   if (t.includes('FACTURA EXENTA ELECTRONICA') || (t.includes('NO AFECTA') && t.includes('ELECTRONICA'))) return 34;
   if (t.includes('FACTURA ELECTRONICA')) return 33;
   if (t.includes('FACTURA EXENTA') || t.includes('FACTURA NO AFECTA')) return 30; // exenta papel
-  if (t === 'FACTURA') return 30;
+  if (t === 'FACTURA') return 30; // factura afecta papel → TpoDoc=30 (regular libro); exentos libro usa lógica especial
   if (t.includes('NOTA DE CREDITO') && (t.includes('ELECTRONICA') || t.includes('ELECTRONICO'))) return 61;
   if (t.includes('NOTA DE CREDITO')) return 60;
   if (t.includes('NOTA DE DEBITO') && (t.includes('ELECTRONICA') || t.includes('ELECTRONICO'))) return 56;
   if (t.includes('NOTA DE DEBITO')) return 55;
-  return 30;
+  return null;
 }
 
 // ═══════════════════════════════════════════════════════════════
@@ -991,14 +991,26 @@ function generarEstructuraSetExportacion(set) {
 /**
  * Genera estructura para LIBRO DE COMPRAS (IECV)
  */
-function generarEstructuraLibroCompras(set) {
+function generarEstructuraLibroCompras(set, opts = {}) {
+  const esExentos = opts.esExentos === true;
   const detalle = [];
   const resumen = {};
 
   for (const doc of set.documentosLibro) {
-    const tipoDoc = mapearTipoDocLibro(doc.tipoDocumento);
+    let tipoDoc = mapearTipoDocLibro(doc.tipoDocumento);
     const tasaIva = 0.19;
 
+    // En libro de compras EXENTOS, los TpoDoc correctos son:
+    //   FACTURA (papel afecta)         → 30  (con IVANoRec)
+    //   FACTURA EXENTA (papel)         → 32  (Fac. Venta B&S No Afectos/Exentos, papel)
+    //   FACTURA ELECTRONICA            → 33  (con IVANoRec si tiene montoAfecto)
+    //   FACTURA EXENTA ELECTRONICA     → 34  (puramente exenta)
+    //   NC/NCE/ND/NDE                  → 60/61/55/56
+    // Total: 7 tipos distintos = 7 líneas de resumen
+    const esFacturaExentaPapel = esExentos && tipoDoc === 30
+      && !doc.montoAfecto && !!doc.montoExento;
+    if (esFacturaExentaPapel) tipoDoc = 32;
+
     const detalleDoc = {
       TpoDoc: tipoDoc,
       NroDoc: doc.folio,
@@ -1035,16 +1047,56 @@ function generarEstructuraLibroCompras(set) {
       detalleDoc.IVARetTotal = Math.round((doc.montoAfecto || 0) * tasaIva);
     }
 
-    // Referencia para notas de crédito
-    if (tipoDoc === 60 && doc.observacion) {
-      const matchRef = doc.observacion.match(/FACTURA(?:\s+ELECTRONICA)?\s+(\d+)/i);
-      if (matchRef) {
-        detalleDoc.TpoDocRef = doc.observacion.includes('ELECTRONICA') ? 33 : 30;
-        detalleDoc.FolioDocRef = parseInt(matchRef[1]);
+    // Referencia para notas de crédito/débito (TpoDoc 60/61/55/56)
+    const esNota = (tipoDoc === 60 || tipoDoc === 61 || tipoDoc === 55 || tipoDoc === 56);
+    if (esNota && doc.observacion) {
+      // El folio referenciado es siempre el último número de la observación
+      const matchFolio = doc.observacion.match(/(\d+)\s*$/i);
+      if (matchFolio) {
+        detalleDoc.FolioDocRef = parseInt(matchFolio[1]);
+        if (doc.observacion.match(/FACTURA EXENTA ELECTRONICA/i)) {
+          detalleDoc.TpoDocRef = 34;
+        } else if (doc.observacion.match(/FACTURA EXENTA/i)) {
+          detalleDoc.TpoDocRef = esExentos ? 32 : 30;
+        } else if (doc.observacion.match(/FACTURA.*ELECTRONICA/i)) {
+          detalleDoc.TpoDocRef = 33;
+        } else if (doc.observacion.match(/FACTURA/i)) {
+          detalleDoc.TpoDocRef = 30;
+        }
+        // Sin TpoDocRef si no se menciona FACTURA (ej. referencia a otra NC/ND)
       }
     }
 
-    detalleDoc.MntTotal = (detalleDoc.MntNeto || 0) + (detalleDoc.MntIVA || 0) + (detalleDoc.MntExe || 0);
+    // En libro de compras EXENTOS: lógica por tipo de doc
+    //   Docs con montoAfecto → IVANoRec (IVA no recuperable)
+    //   Docs puramente exentos (TpoDoc=32/34) → sin IVANoRec
+    //   TpoDoc=46 → usa IVARetTotal (no IVANoRec)
+    const esPuramenteExento = !doc.montoAfecto && !!doc.montoExento;
+    if (esExentos && tipoDoc !== 46 && !esPuramenteExento) {
+      const mntIVA = detalleDoc.MntIVA || 0;
+      detalleDoc.IVANoRec = { CodIVANoRec: 1, MntIVANoRec: mntIVA };
+      detalleDoc.MntIVA = 0;
+      if (detalleDoc.MntNeto === undefined || detalleDoc.MntNeto === null) {
+        detalleDoc.MntNeto = 0;
+      }
+    }
+    // TpoDoc=32 (Fac. Exenta papel): solo MntExe + MntTotal, sin TasaImp/MntNeto/MntIVA/IVANoRec
+    if (esFacturaExentaPapel) {
+      delete detalleDoc.TasaImp;
+      delete detalleDoc.MntNeto;
+      delete detalleDoc.MntIVA;
+      delete detalleDoc.IVANoRec;
+    }
+    // Para docs puramente exentos que NO son TpoDoc=32: TasaImp=19 + MntNeto=0 + MntIVA=0
+    if (esExentos && esPuramenteExento && !esFacturaExentaPapel) {
+      detalleDoc.TasaImp = Math.round(tasaIva * 100); // TasaImp=19 requerido
+      detalleDoc.MntNeto = 0;
+      detalleDoc.MntIVA = 0;
+    }
+
+    // MntTotal incluye IVANoRec (IVA pagado pero no deducible)
+    const mntIvaNoRecTotal = (esExentos && detalleDoc.IVANoRec) ? (detalleDoc.IVANoRec.MntIVANoRec || 0) : 0;
+    detalleDoc.MntTotal = (detalleDoc.MntNeto || 0) + (detalleDoc.MntIVA || 0) + (detalleDoc.MntExe || 0) + mntIvaNoRecTotal;
     if (doc.retencionTotal && tipoDoc === 46) {
       detalleDoc.MntTotal = detalleDoc.MntNeto || 0; // Sin IVA pagado
     }
@@ -1069,6 +1121,36 @@ function generarEstructuraLibroCompras(set) {
     resumen[tipoDoc].TotMntTotal += detalleDoc.MntTotal || 0;
   }
 
+  // Post-proceso para libro de compras EXENTOS:
+  // NC/NCE con sin montos declarados que anulan un doc con montos deben heredar esos montos
+  if (esExentos) {
+    for (const doc of detalle) {
+      const esNotaAnulacion = (doc.TpoDoc === 60 || doc.TpoDoc === 61 || doc.TpoDoc === 55 || doc.TpoDoc === 56)
+        && !doc.MntNeto && !doc.MntExe && doc.FolioDocRef;
+      if (esNotaAnulacion) {
+        const refDoc = detalle.find(d => d.NroDoc === doc.FolioDocRef);
+        if (refDoc) {
+          if (refDoc.MntExe) doc.MntExe = refDoc.MntExe;
+          if (refDoc.MntNeto) {
+            doc.MntNeto = refDoc.MntNeto;
+            // Heredar IVANoRec del doc referenciado
+            if (refDoc.IVANoRec) {
+              doc.IVANoRec = { CodIVANoRec: 1, MntIVANoRec: refDoc.IVANoRec.MntIVANoRec || 0 };
+            }
+          }
+          const mntIvaNoRecDoc = (doc.IVANoRec ? (doc.IVANoRec.MntIVANoRec || 0) : 0);
+          doc.MntTotal = (doc.MntNeto || 0) + (doc.MntExe || 0) + mntIvaNoRecDoc;
+          // Actualizar resumen para este TpoDoc
+          if (resumen[doc.TpoDoc]) {
+            resumen[doc.TpoDoc].TotMntExe += doc.MntExe || 0;
+            resumen[doc.TpoDoc].TotMntNeto += doc.MntNeto || 0;
+            resumen[doc.TpoDoc].TotMntTotal += doc.MntTotal;
+          }
+        }
+      }
+    }
+  }
+
   return {
     numeroAtencion: set.numeroAtencion,
     factorProporcionalidad: set.factorProporcionalidad || 0.6,
@@ -1136,8 +1218,9 @@ function generarEstructurasParaScripts(datosExtraidos, receptorConfig = {}) {
         estructuras.libroCompras = generarEstructuraLibroCompras(set);
         break;
       case 'LIBRO_COMPRAS_EXENTOS':
-        // Misma estructura que LIBRO_COMPRAS pero marcado como exentos
-        estructuras.libroComprasExentos = generarEstructuraLibroCompras(set);
+        // En el libro de exentos, FACTURA afecta papel usa TpoDoc=29 (Factura de Inicio)
+        // para distinguirse de FACTURA EXENTA (TpoDoc=30) en el ResumenPeriodo
+        estructuras.libroComprasExentos = generarEstructuraLibroCompras(set, { esExentos: true });
         break;
       case 'LIBRO_VENTAS':
         // El libro de ventas se genera con los datos del set básico o exento

package/cert/SetsProvider.js

@@ -105,13 +105,13 @@ class SetsProvider {
    * @returns {Promise<boolean>}
    */
   async initSession() {
-    this.logger.log('[SetsProvider] 🔐 Inicializando sesión SII...');
+    this.logger.log('[SessionSii] Inicializando sesión SII...');
     
     const siiCert = this._getSiiCert();
     
     // Intentar cargar sesión existente
     if (this.sessionPath && SiiCertificacion.isSessionValid(this.sessionPath)) {
-      this.logger.log('[SetsProvider]    ✓ Sesión existente válida');
+      this.logger.log('[SessionSii] ✓ Sesión existente válida');
       const loaded = siiCert.loadSession(this.sessionPath);
       if (loaded) {
         return true;
@@ -119,7 +119,7 @@ class SetsProvider {
     }
     
     // Crear nueva sesión
-    this.logger.log('[SetsProvider]    Estableciendo nueva sesión...');
+    this.logger.log('[SessionSii] Estableciendo nueva sesión...');
     try {
       // verAvance() fuerza el login
       await siiCert.verAvance();
@@ -128,12 +128,12 @@ class SetsProvider {
       if (this.sessionPath) {
         this._ensureDir(path.dirname(this.sessionPath));
         siiCert.saveSession(this.sessionPath);
-        this.logger.log('[SetsProvider]    ✓ Sesión guardada');
+        this.logger.log('[SessionSii] ✓ Sesión guardada');
       }
       
       return true;
     } catch (error) {
-      this.logger.error(`[SetsProvider]    ❌ Error: ${error.message}`);
+      this.logger.error(`[SessionSii] [ERR] Error: ${error.message}`);
       return false;
     }
   }
@@ -153,11 +153,11 @@ class SetsProvider {
       setsOpcionales = DEFAULT_SETS_OPCIONALES,
     } = options;
 
-    this.logger.log('\n[SetsProvider] 📦 Obteniendo sets de prueba...');
+    this.logger.log('\n[SessionSii] Obteniendo sets de prueba...');
 
     // Si hay cache y no se fuerza refresh, retornar cache
     if (!forceRefresh && this._estructurasCache) {
-      this.logger.log('[SetsProvider]    ✓ Usando cache de estructuras');
+      this.logger.log('[SetsProvider] ✓ Usando cache de estructuras');
       return {
         success: true,
         regenerated: false,
@@ -212,7 +212,7 @@ class SetsProvider {
       // Detectar si el set fue regenerado
       const regenerated = this._detectRegeneration(result);
       if (regenerated) {
-        this.logger.log('[SetsProvider]    ⚠️ Set regenerado - reiniciar proceso');
+        this.logger.log('[SetsProvider] [!] Set regenerado - reiniciar proceso');
         // Invalidar cualquier cache anterior
         this.invalidateCache();
       }
@@ -228,13 +228,13 @@ class SetsProvider {
             (htmlLower.includes('postulacion factura electronica') && !htmlLower.includes('caso'))) {
           // Distinguir: ¿es "no inscrito" o expiró la sesión?
           if (htmlLower.includes('no inscrito') || (htmlLower.includes('no est') && htmlLower.includes('inscrito'))) {
-            this.logger.log('[SetsProvider]    ℹ️  pe_generar2: empresa no inscrita en Postulación (fase avanzada).');
+            this.logger.log('[SessionSii] pe_generar2: empresa no inscrita en Postulación (fase avanzada).');
             return { success: false, error: 'El contribuyente no está inscrito en Postulación en el portal SII.' };
           }
           // Sesión expiró en el portal aunque el archivo no lo sabía → forzar re-autenticación
           // Cookies vencidas server-side: limpiar sesión guardada y pedir a
           // generarSetPruebas que re-autentique por sí mismo via pe_generar
-          this.logger.log('[SetsProvider]    ⚠️ Sesión rechazada por portal, limpiando y reintentando...');
+          this.logger.log('[SessionSii] [!] Sesión rechazada por portal, limpiando y reintentando...');
           if (this.sessionPath) {
             const SiiSession = require('../SiiSession');
             SiiSession.clearSession(this.sessionPath);
@@ -284,7 +284,7 @@ class SetsProvider {
         }
       }
 
-      this.logger.log('[SetsProvider]    ✓ Sets obtenidos correctamente');
+      this.logger.log('[SetsProvider] ✓ Sets obtenidos correctamente');
 
       return {
         success: true,
@@ -296,7 +296,7 @@ class SetsProvider {
       };
 
     } catch (error) {
-      this.logger.error(`[SetsProvider]    ❌ Error: ${error.message}`);
+      this.logger.error(`[SetsProvider] [ERR] Error: ${error.message}`);
       return {
         success: false,
         error: error.message,
@@ -329,7 +329,7 @@ class SetsProvider {
     if (result.setDescargado?.rawHtml && this._lastNumeroAtencion) {
       const match = result.setDescargado.rawHtml.match(/NUMERO DE ATENCI[^:]*:\s*(\d+)/i);
       if (match && match[1] !== this._lastNumeroAtencion) {
-        this.logger.log(`[SetsProvider]    Número de atención cambió: ${this._lastNumeroAtencion} → ${match[1]}`);
+        this.logger.log(`[SetsProvider] Número de atención cambió: ${this._lastNumeroAtencion} → ${match[1]}`);
         return true;
       }
     }
@@ -351,19 +351,16 @@ class SetsProvider {
     if (this.debugDir) {
       this._saveDebug('set-texto.txt', textoLimpio);
     }
-
-    // Usar SetParser del core
-    this.logger.log('[SetsProvider]    Usando SetParser del core...');
     
     const datosExtraidos = SetParser.extraerCasosDelSet(textoLimpio);
     
     if (datosExtraidos.sets.length === 0) {
-      this.logger.log('[SetsProvider]    ⚠️ No se encontraron sets en el contenido');
+      this.logger.log('[SetsProvider] [!] No se encontraron sets en el contenido');
       return { estructuras: null, datosExtraidos: null };
     }
 
-    this.logger.log(`[SetsProvider]    📦 Sets encontrados: ${datosExtraidos.sets.length}`);
-    this.logger.log(`[SetsProvider]    📄 Total casos: ${datosExtraidos.totalCasos}`);
+    this.logger.log(`[SetsProvider] Sets encontrados: ${datosExtraidos.sets.length}`);
+    this.logger.log(`[SetsProvider] Total casos: ${datosExtraidos.totalCasos}`);
 
     // Guardar número de atención para detectar regeneración
     if (datosExtraidos.sets[0]?.numeroAtencion) {

package/cert/Simulacion.js

@@ -53,7 +53,7 @@ class Simulacion {
     const docRefs = {};
 
     if (plan.length < 10) {
-      console.warn('⚠️  Se recomienda mínimo 10 documentos para simulación.');
+      console.warn('[!] Se recomienda mínimo 10 documentos para simulación.');
     }
 
     const envioDte = new EnvioDTE({ certificado: this.certificado });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlas/dte-sii",
-  "version": "2.5.12",
+  "version": "2.5.14",
   "description": "Facturación y boletas electrónicas para el SII de Chile. Genera, timbra, firma y envía DTEs, libros electrónicos y automatiza la certificación.",
   "main": "index.js",
   "types": "dte-sii.d.ts",
@@ -31,6 +31,7 @@
   "dependencies": {
     "@xmldom/xmldom": "^0.8.11",
     "bwip-js": "^4.8.0",
+    "dotenv": "^17.3.1",
     "fast-xml-parser": "^5.3.3",
     "got": "^11.8.6",
     "node-forge": "^1.3.3",

package/utils/progress.js

@@ -0,0 +1,78 @@
+// Copyright (c) 2026 Devlas SpA
+// Sistema de progreso estructurado para el runner de certificacion SII.
+// El runner y la libreria emiten lineas [PROGRESS]{...json...} que la API
+// parsea sin regex frágiles sobre texto libre.
+
+const STEPS = {
+  // Autenticacion
+  AUTH_INIT:          'AUTH_INIT',
+  AUTH_OK:            'AUTH_OK',
+  // Sets
+  SETS_DOWNLOADING:   'SETS_DOWNLOADING',
+  SETS_LOADED:        'SETS_LOADED',
+  // CAFs
+  CAF_REQUESTING:     'CAF_REQUESTING',   // data: { tipo }
+  CAF_OK:             'CAF_OK',           // data: { tipo }
+  // Ejecucion de sets
+  SET_START:          'SET_START',        // data: { set }
+  SET_SIGNING:        'SET_SIGNING',      // data: { set }
+  SET_SENDING:        'SET_SENDING',      // data: { set }
+  SET_OK:             'SET_OK',           // data: { set, trackId }
+  SET_ERROR:          'SET_ERROR',        // data: { set, error }
+  // Declaracion
+  SETS_DECLARING:     'SETS_DECLARING',
+  SETS_DECLARED:      'SETS_DECLARED',
+  // Polling aprobacion sets
+  POLLING:            'POLLING',          // data: { intento, max }
+  SET_APPROVED:       'SET_APPROVED',     // data: { set }
+  SETS_APPROVED:      'SETS_APPROVED',
+  SETS_REJECTED:      'SETS_REJECTED',
+  // Libros (Fase 4)
+  BOOKS_START:        'BOOKS_START',
+  BOOK_SENDING:       'BOOK_SENDING',     // data: { book }
+  BOOK_OK:            'BOOK_OK',          // data: { book, trackId }
+  BOOK_SKIPPED:       'BOOK_SKIPPED',     // data: { book }
+  BOOK_ERROR:         'BOOK_ERROR',       // data: { book, error }
+  BOOKS_DECLARING:    'BOOKS_DECLARING',
+  BOOKS_DONE:         'BOOKS_DONE',
+  // Avance (Fase 5)
+  ADVANCE_WAITING:    'ADVANCE_WAITING',
+  ADVANCE_DONE:       'ADVANCE_DONE',
+  // Simulacion (Fase 6)
+  SIM_START:          'SIM_START',
+  SIM_SENDING:        'SIM_SENDING',
+  SIM_OK:             'SIM_OK',           // data: { trackId }
+  SIM_DECLARING:      'SIM_DECLARING',
+  SIM_POLLING:        'SIM_POLLING',      // data: { intento, max }
+  SIM_DONE:           'SIM_DONE',
+  // Intercambio (Fase 7)
+  INTERCAMBIO_START:  'INTERCAMBIO_START',
+  INTERCAMBIO_DONE:   'INTERCAMBIO_DONE',
+  // Muestras impresas (Fase 8)
+  MUESTRAS_START:     'MUESTRAS_START',
+  MUESTRAS_PDFS:      'MUESTRAS_PDFS',
+  MUESTRAS_UPLOADING: 'MUESTRAS_UPLOADING',
+  MUESTRAS_DONE:      'MUESTRAS_DONE',
+  // Boleta electronica
+  BOLETA_START:       'BOLETA_START',
+  BOLETA_SENDING:     'BOLETA_SENDING',
+  BOLETA_OK:          'BOLETA_OK',
+  BOLETA_DECLARING:   'BOLETA_DECLARING',
+  BOLETA_DONE:        'BOLETA_DONE',
+  // Fin
+  CERT_DONE:          'CERT_DONE',
+  CERT_ERROR:         'CERT_ERROR',       // data: { error }
+};
+
+/**
+ * Emite una linea de progreso estructurada a stdout.
+ * Formato: [PROGRESS]{"step":"...","clave":"valor",...}
+ *
+ * @param {string} step  - Una de las constantes STEPS
+ * @param {Object} [data] - Datos adicionales opcionales
+ */
+function emitProgress(step, data = {}) {
+  process.stdout.write(`[PROGRESS]${JSON.stringify({ step, ...data })}\n`);
+}
+
+module.exports = { STEPS, emitProgress };

package/utils/xml.js

@@ -54,7 +54,7 @@ const prettyBuilder = new XMLBuilder({
   ignoreAttributes: false,
   attributeNamePrefix: '@_',
   format: true,
-  indentBy: '  ',
+  indentBy: ' ',
   suppressEmptyNode: true,
 });
 
@@ -326,7 +326,7 @@ function saveEnvioArtifacts({
       fs.writeFileSync(path.join(debugDir, `respuesta-${debugPrefix}.xml`), responseText, 'utf-8');
     }
   } catch (saveError) {
-    console.warn('⚠️ No se pudo guardar histórico/debug:', saveError.message || saveError);
+    console.warn('[!] No se pudo guardar histórico/debug:', saveError.message || saveError);
   }
 }