@devlas/dte-sii 2.12.13 → 2.12.14

package/SiiCertificacion.js

@@ -1063,17 +1063,23 @@ class SiiCertificacion {
       }
 
       // El botón real (avanzar()) solo cambia el action y submitea — no valida nada del lado
-      // cliente. La respuesta del SII distingue 3 casos por texto, no por status HTTP (siempre
-      // 200) ni por la palabra "error" (aparece en el <script> de todas las páginas del portal):
-      //   "ha pasado al paso X"          → avance REAL (éxito)
-      //   "ya se encuentra en el paso X" → no-op: no avanzó nada (PASO no coincidía, o el SII
-      //                                    aún no habilita el siguiente paso) — NO es un error
-      //   cualquier otro texto           → error real
+      // cliente. La respuesta del SII distingue estos casos por texto, no por status HTTP
+      // (siempre 200) ni por la palabra "error" (aparece en el <script> de todas las páginas
+      // del portal):
+      //   "ha pasado al paso X"                    → avance REAL a otro paso intermedio
+      //   "ha finalizado con la certificación..."   → avance REAL — llegó al paso final,
+      //                                               queda pendiente declarar cumplimiento
+      //                                               (pe_avance7→8, ver declararCumplimiento())
+      //   "ya se encuentra en el paso X"            → no-op: no avanzó nada (PASO no
+      //                                               coincidía, o el SII aún no habilita el
+      //                                               siguiente paso) — NO es un error
+      //   cualquier otro texto                      → error real
       const texto = limpiarTextoPortal(body);
-      const avanzo   = /ha pasado al paso/i.test(texto);
+      const RE_AVANZO = /ha pasado al paso|ha finalizado con la certificaci/i;
+      const avanzo    = RE_AVANZO.test(texto);
       const sinCambio = /ya se encuentra en el paso/i.test(texto);
       const frases = texto.split(/(?<=\.)\s+/);
-      const mensaje = (frases.find(f => /ha pasado al paso|ya se encuentra en el paso/i.test(f)) || '').trim() || null;
+      const mensaje = (frases.find(f => RE_AVANZO.test(f) || /ya se encuentra en el paso/i.test(f)) || '').trim() || null;
 
       return {
         success: avanzo,

package/cert/CertRunner.js

@@ -168,6 +168,20 @@ class CertRunner {
    * @returns {Promise<Object>} { success, estructuras, error }
    */
   async obtenerSets(options = {}) {
+    if (options.hydrateOnly) {
+      // Solo hidrata this._estructuras desde memoria o disco — NUNCA llama al SII. Necesario
+      // como modo aparte porque el resto de esta función SIEMPRE pide un set nuevo al SII
+      // (forceRefresh: true, ver abajo), lo que REINICIA la postulación real completa. Un
+      // llamado pensado solo para "popular estado" no puede arriesgarse a tocar esa rama.
+      if (!this._estructuras) {
+        const estructurasPath = path.join(this.debugDir, 'estructuras.json');
+        if (fs.existsSync(estructurasPath)) {
+          this._estructuras = JSON.parse(fs.readFileSync(estructurasPath, 'utf8'));
+        }
+      }
+      return { success: !!this._estructuras, estructuras: this._estructuras, hydrated: true };
+    }
+
     const resultado = await this.setsProvider.obtenerSets({
       setsOpcionales: options.setsOpcionales || {
         SET03: 'S',  // SET GUIA DE DESPACHO
@@ -199,6 +213,28 @@ class CertRunner {
     return { success: true, estructuras: resultado.estructuras };
   }
 
+  /**
+   * Inyecta estructuras ya descargadas (desde BD/caché) sin pedirlas al SII. Formaliza lo que
+   * hoy hacen los callers a mano (`runner._estructuras = JSON.parse(...)`) con acceso directo
+   * a un campo "privado". Útil para reanudar en una fase posterior (libros, simulación) sin
+   * volver a llamar obtenerSets() — que SIEMPRE resetea la postulación real (forceRefresh).
+   * @param {Object} estructurasJson
+   */
+  setEstructuras(estructurasJson) {
+    this._estructuras = estructurasJson;
+  }
+
+  /**
+   * Inyecta resultados previos (trackIds de sets ya enviados) en this.resultados sin
+   * re-ejecutar los envíos. Hace merge — no borra resultados ya presentes que no vengan en
+   * resultadosJson. Formaliza `runner.resultados[k] = {...}` (acceso directo hoy en
+   * run-certificacion.js) con un método explícito.
+   * @param {Object} resultadosJson
+   */
+  setResultados(resultadosJson) {
+    Object.assign(this.resultados, resultadosJson);
+  }
+
   /**
    * Solicita CAFs frescos para los tipos especificados
    * @param {Object} cafRequired - { 33: 4, 56: 1, 61: 3 }
@@ -437,13 +473,18 @@ class CertRunner {
    * Declara avance de los sets ejecutados con reintentos automáticos
    * @param {Object} [resultadosExt] - Resultados externos (usa this.resultados si no se pasa)
    * @param {Object} [estructurasExt] - Estructuras externas (usa this._estructuras si no se pasa)
-   * @param {Object} [options] - { maxIntentos, intervalo }
+   * @param {Object} [options] - { maxIntentos, intervalo, ignorarVacio }
+   * @param {boolean} [options.ignorarVacio] - Si this.resultados no tiene trackIds (runner
+   *   recién creado, sin hidratar), en vez de devolver el error genérico "No hay sets para
+   *   declarar" consulta el estado real del portal: si la etapa ya avanzó más allá de SET DE
+   *   PRUEBAS, los sets YA fueron declarados y aprobados en una ejecución anterior — no hay
+   *   nada que hacer y no es un error. Default false — comportamiento previo sin cambios.
    * @returns {Promise<Object>} Resultado de la declaración
    */
   async declararAvance(resultadosExt, estructurasExt, options = {}) {
     const resultados = resultadosExt || this.resultados;
     const estructuras = estructurasExt || this._estructuras;
-    const { maxIntentos = 10, intervalo = 5000 } = options;
+    const { maxIntentos = 10, intervalo = 5000, ignorarVacio = false } = options;
 
     if (!estructuras) {
       throw new Error('No hay estructuras. Ejecutar obtenerSets() primero.');
@@ -470,6 +511,13 @@ class CertRunner {
     }
 
     if (Object.keys(sets).length === 0) {
+      if (ignorarVacio) {
+        const avance = await this.consultarAvance().catch(() => null);
+        const etapa = avance?.etapaActual;
+        if (etapa && etapa !== 'SET DE PRUEBAS') {
+          return { success: true, yaDeclarado: true, etapaActual: etapa };
+        }
+      }
       return { success: false, error: 'No hay sets para declarar' };
     }
 
@@ -519,6 +567,11 @@ class CertRunner {
    * @returns {Promise<Object>} Resultado con todos los libros
    */
   async ejecutarFase4Libros(options = {}) {
+    // Permite pasar las estructuras explícitamente (ej. runner recién creado, hidratado desde
+    // BD/caché en vez de obtenerSets()) — igual que ejecutarSimulacion(). Si no vienen, cae al
+    // estado interno (comportamiento previo, sin cambios para callers existentes).
+    const estructuras = options.estructuras || this._estructuras;
+
     // NOTA: Ya NO decrementamos aquí - cada libro decrementa su propio período
     emitProgress(STEPS.BOOKS_START);
     console.log('\n' + '═'.repeat(60));
@@ -580,8 +633,8 @@ class CertRunner {
     // con el mes de esas fechas. Usar currentMonth-1 causa "ENVIO CON ERRORES O REPAROS".
     let _periodoBase = null;
     const _fchDocMuestra =
-      this._estructuras?.libroCompras?.detalle?.[0]?.FchDoc ||
-      this._estructuras?.libroComprasExentos?.detalle?.[0]?.FchDoc;
+      estructuras?.libroCompras?.detalle?.[0]?.FchDoc ||
+      estructuras?.libroComprasExentos?.detalle?.[0]?.FchDoc;
     if (_fchDocMuestra) {
       const _dt = new Date(_fchDocMuestra);
       if (!isNaN(_dt.getTime())) {
@@ -729,7 +782,7 @@ class CertRunner {
     }
 
     // 4. Libro de Compras para Exentos (solo si el SII lo entregó y no está ya aprobado)
-    if (this._estructuras?.libroComprasExentos) {
+    if (estructuras?.libroComprasExentos) {
       try {
         if (_estaConforme('LIBRO DE COMPRAS PARA EXENTOS')) {
           emitProgress(STEPS.BOOK_SKIPPED, { book: 'libroComprasExentos' });
@@ -867,7 +920,7 @@ class CertRunner {
       // NO es un error de período. Solo LNC/LRH son errores reales que requieren acción.
       const _esperarAprobacion = async (librosAVerificar) => {
         const _todosCandidatos = ['LIBRO DE VENTAS', 'LIBRO DE COMPRAS', 'LIBRO DE GUIAS'];
-        if (this._estructuras?.libroComprasExentos) _todosCandidatos.push('LIBRO DE COMPRAS PARA EXENTOS');
+        if (estructuras?.libroComprasExentos) _todosCandidatos.push('LIBRO DE COMPRAS PARA EXENTOS');
         const _librosAVerif = librosAVerificar || _todosCandidatos.filter(n => !_estaConforme(n));
         console.log(`\nEsperando aprobacion del SII para: ${_librosAVerif.join(', ')}`);
         let _ss = {};
@@ -1069,7 +1122,7 @@ class CertRunner {
 
           // Construir la lista inicial de libros a verificar
           const _todosLibrosNombres = ['LIBRO DE VENTAS', 'LIBRO DE COMPRAS', 'LIBRO DE GUIAS'];
-          if (this._estructuras?.libroComprasExentos) _todosLibrosNombres.push('LIBRO DE COMPRAS PARA EXENTOS');
+          if (estructuras?.libroComprasExentos) _todosLibrosNombres.push('LIBRO DE COMPRAS PARA EXENTOS');
           let _librosAVerificar = _todosLibrosNombres.filter(n => !_estaConforme(n));
 
           // Si SOAP detectó LNC/LRH para algún libro → excluirlos de la espera portal.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlas/dte-sii",
-  "version": "2.12.13",
+  "version": "2.12.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",