@devlas/dte-sii 2.12.24 → 2.12.26

package/CafSolicitor.js

@@ -238,6 +238,37 @@ class CafSolicitor {
     return /NO\s+(SE\s+)?AUTORIZA\s+TIMBRAJE/i.test(String(html || ''));
   }
 
+  /**
+   * Detecta el rechazo genérico "no está autorizado para ingresar a esta opción" en
+   * palena (producción). A diferencia de maullin/certificación, donde el bloqueo por
+   * Verificación de Actividades sale explícito ("no registra Verificación de
+   * Actividades..."), en producción el SII solo dice esto — mismo texto para tipo 39
+   * (boleta) y 33 (factura), sin indicar la causa real. Verificado 2026-07-24 contra
+   * 78441936-3, en ambos tipos, con el mismo request real repetido dos veces.
+   *
+   * Sin esta detección caía en el genérico `UNKNOWN: No se obtuvo CAF en la
+   * respuesta`, que no distingue este caso (probable Verificación de Actividades,
+   * no confirmado por el mensaje) de un fallo real desconocido.
+   */
+  static esNoAutorizadoIngresarOpcion(html) {
+    return /no\s+est.\s+autorizado\s+para\s+ingresar\s+a\s+esta\s+opci.n/i.test(String(html || ''));
+  }
+
+  /**
+   * Detecta el rechazo por permisos del usuario (estado 106 del SII).
+   *
+   * El RUT dueño del certificado puede estar enrolado en la empresa pero sin los
+   * permisos de firmar/enviar/solicitar folios marcados — el SII responde con esta
+   * página en vez de entregar el CAF. Sin detectarla caía en el genérico
+   * `UNKNOWN: No se obtuvo CAF en la respuesta`, que no dice qué arreglar; el remedio
+   * es reenviar los permisos del usuario (Paso 5 de la inscripción) EN EL MISMO
+   * AMBIENTE donde se está pidiendo el folio.
+   */
+  static esUsuarioSinPermiso(html) {
+    return /no\s+tiene\s+permiso\s+en\s+(la\s+)?empresa|usuario\s+no\s+autorizado\s+para\s+(la\s+)?empresa|no\s+est.\s+autorizado\s+para\s+operar\s+en\s+la\s+empresa/i
+      .test(String(html || ''));
+  }
+
   /**
    * Solicita un CAF al SII
    * @param {Object} params - Parámetros
@@ -314,7 +345,7 @@ class CafSolicitor {
         return {
           success: false,
           errorCode: 'VERIFICACION_ACTIVIDADES_PENDIENTE',
-          error: 'SII: El RUT no tiene registrada la Verificación de Actividades para este tipo de documento. Solicítala en el sitio SII → Peticiones Administrativas → Verificación de actividad, o en oficinas del SII.',
+          error: 'SII: El RUT no tiene registrada la Verificación de Actividades para este tipo de documento. Realízala en https://www4.sii.cl/verificacionactividadesinternetui/?opcion=1#/ingreso (Verificación de Actividades online).',
         };
       }
 
@@ -364,13 +395,29 @@ class CafSolicitor {
         return { success: false, errorCode: 'TIMBRAJE_BLOQUEADO', error: 'SII: No se autoriza timbraje. Folios acumulados excesivos o situaciones tributarias pendientes. Revisa el portal SII → Factura Electrónica → Solicitud de Timbraje.' };
       }
 
+      if (response.body && CafSolicitor.esNoAutorizadoIngresarOpcion(response.body)) {
+        return {
+          success: false,
+          errorCode: 'NO_AUTORIZADO_INGRESAR_OPCION',
+          error: `SII (${this.ambiente}): "No está autorizado para ingresar a esta opción" — el SII no indica la causa exacta, pero el patrón coincide con la Verificación de Actividades pendiente para este RUT. Verifícala en https://www4.sii.cl/verificacionactividadesinternetui/?opcion=1#/ingreso`,
+        };
+      }
+
+      if (response.body && CafSolicitor.esUsuarioSinPermiso(response.body)) {
+        return {
+          success: false,
+          errorCode: 'USUARIO_SIN_PERMISO',
+          error: `SII (106): el RUT del certificado no tiene permisos para solicitar folios en la empresa (ambiente ${this.ambiente}). Vuelve a ejecutar la inscripción para reasignar permisos de firmar, enviar y obtener folios.`,
+        };
+      }
+
       // Rechazo por Verificación de Actividades detectado en un paso posterior del flujo
       // multi-paso (ver guarda defensiva en _processMultiStepFlow).
       if (response.body && response.body.includes('no registra Verificacion de Actividades')) {
         return {
           success: false,
           errorCode: 'VERIFICACION_ACTIVIDADES_PENDIENTE',
-          error: 'SII: El RUT no tiene registrada la Verificación de Actividades para este tipo de documento. Solicítala en el sitio SII → Peticiones Administrativas → Verificación de actividad, o en oficinas del SII.',
+          error: 'SII: El RUT no tiene registrada la Verificación de Actividades para este tipo de documento. Realízala en https://www4.sii.cl/verificacionactividadesinternetui/?opcion=1#/ingreso (Verificación de Actividades online).',
         };
       }
 

package/DTE.js

@@ -350,6 +350,13 @@ class DTE {
       format: false,
     });
 
+    // NO QUITAR estos dos xmlns del <DTE>. NO son redundantes aunque el sobre
+    // <EnvioBOLETA>/<EnvioDTE> también los declare.
+    // El DigestValue de la firma se calcula en _c14nDocumento(), que lee el xmlns
+    // desde el <DTE> y lo hereda al <Documento> canonicalizado. Si se quita, se
+    // firma un <Documento> sin namespace, pero el SII lo canonicaliza CON
+    // xmlns="http://www.sii.cl/SiiDte" (lo hereda igual) → los digests no coinciden
+    // → "firma inválida" / rechazo. Tampoco stripearlos después en Envio.js.
     const dteConVersion = {
       '@_xmlns': 'http://www.sii.cl/SiiDte',
       '@_xmlns:xsi': 'http://www.w3.org/2001/XMLSchema-instance',

package/Envio.js

@@ -81,6 +81,11 @@ class EnvioBase {
   
   /**
    * Extraer XML de DTEs sin declaration
+   *
+   * NO stripear el xmlns del <DTE> aquí (aunque el sobre ya lo declare). Ese
+   * namespace es parte del documento firmado: el DigestValue de la firma se
+   * calculó heredándolo al <Documento>. Si se quita, el SII recalcula el digest
+   * CON el namespace y no coincide → "firma inválida". Solo quitar el prolog XML.
    */
   _extractDTEsXml() {
     return this.dtes.map(dte => {

package/README.md

@@ -197,6 +197,21 @@ const estadoDte = await enviador.consultarEstadoDte({
 
 ## Boletas electrónicas
 
+> **Recomendado para CERTIFICAR boletas: usar `CertRunner` + `BoletaCert`, no el camino manual.**
+>
+> Para el proceso de certificación de boletas ante el SII, use el orquestador de
+> alto nivel (`require('@devlas/dte-sii/cert')` → `CertRunner` / `BoletaCert`). Ese
+> camino descarga el set, genera y firma las boletas, arma el `EnvioBOLETA` + RCOF,
+> obtiene el TrackId y declara el cumplimiento. Es el flujo probado end-to-end.
+>
+> El camino manual de bajo nivel (`DTE` + `EnvioBOLETA` + `EnviadorSII`) que se
+> muestra más abajo funciona, pero es fácil romperlo. **Error frecuente:** "optimizar"
+> quitando los `xmlns` del `<DTE>` por parecer redundantes con el sobre. NO lo haga:
+> el `xmlns="http://www.sii.cl/SiiDte"` del `<DTE>` es parte del documento firmado
+> (se hereda al `<Documento>` al calcular el DigestValue). Si lo quita, el SII
+> recalcula el digest con el namespace y no coincide → rechazo por "firma inválida".
+> Ver [Certificación SII](#certificación-sii).
+
 > **Diferencia crítica por ambiente**
 >
 > - **Producción** → usar la API **REST** del SII (`enviarBoleta`) con los datos reales de resolución de la empresa.

package/cert/BoletaCert.js

@@ -12,6 +12,12 @@
  * 3. Se genera RCOF (ConsumoFolio) para reportar los folios usados
  * 4. Se envían ambos documentos al SII
  * 5. SII valida y aprueba
+ *
+ * NOTA sobre el RCOF (ConsumoFolio):
+ * El RCOF está deprecado en producción y ya no se usa en la operación normal.
+ * Solo se mantiene aquí porque este paso de certificación todavía lo exige.
+ * Al enviarlo, el SII puede devolver reparos: eso es esperado en certificación
+ * y no bloquea el avance del proceso.
  */
 
 const path = require('path');
@@ -482,6 +488,8 @@ class BoletaCert {
     }
 
     process.stderr.write(`[PROGRESS]${JSON.stringify({ step: 'BOLETA_RCOF' })}\n`);
+    // RCOF deprecado en producción: solo se envía aquí porque la certificación aún
+    // lo exige. Reparos del SII en este envío son esperados y NO bloquean el avance.
     // 5 & 6. Generar y enviar RCOF — loop hasta que SII lo acepte o se agoten intentos.
     // Estrategia: enviar → si ok, esperar 30s → consultar estado (EPR o RPR = éxito).
     // Si DUPLICADO: el SII ya tiene un RCOF para este RUT/período. El entorno de certificación

package/cert/CertRunner.js

@@ -3073,6 +3073,20 @@ class CertRunner {
   // ═══════════════════════════════════════════════════════════════
   // BOLETA ELECTRÓNICA — automatización portal certBolElectDteInternet
   // ═══════════════════════════════════════════════════════════════
+  //
+  // Métodos que se usan para la CERTIFICACIÓN DE BOLETAS (flujo, en orden):
+  //   1. obtenerSetBoletaPortal          → descarga el Set de Pruebas (?SET=1)
+  //   2. (BoletaCert.ejecutarCertificacion emite EnvioBOLETA + RCOF → devuelve trackId)
+  //   3. solicitarValidacionBoletaPortal → declara el trackId del envío (?SET=2)
+  //   4. completarDeclaracionBoletaPortal→ declara cumplimiento y autoriza producción
+  //
+  // Apoyo (solo lectura / recuperación de estado):
+  //   - consultarEstadoBoletaPortal      → estado en el portal GWT de boleta
+  //   - verificarAutorizacionBoleta      → confirma si la empresa ya emite tipo 39
+  //
+  // El portal de boleta usa GWT-RPC (certBolElectDteInternet), distinto del portal
+  // pe_avance usado para facturas/DTE. La certificación de boletas NO usa las fases
+  // de sets/libros/simulación/intercambio/muestras; esas son solo del track DTE.
 
   /**
    * Descarga el Set de Pruebas de Boleta Electrónica desde el portal SII.
@@ -3240,25 +3254,20 @@ class CertRunner {
    * @param {string} opts.correoProveedor
    * @returns {Promise<{success: boolean, mensaje?: string, error?: string}>}
    */
-  async completarDeclaracionBoletaPortal({
-    linkConsulta    = 'www.sii.cl',
-    rutProveedor    = '',
-    nombreProveedor = '',
-    correoProveedor = '',
-  } = {}) {
+  /**
+   * Constantes y helper GWT compartidos por las llamadas al portal de Certificación
+   * de Boleta Electrónica (certBolElectDteInternet — GWT-RPC, distinto de pe_avance
+   * que es HTML). Factorizado para no duplicar la construcción del request entre
+   * el chequeo de solo-lectura y la declaración real.
+   */
+  _gwtBoletaClient(cookieJar) {
     const https  = require('https');
     const crypto = require('crypto');
     const CBE_BASE   = 'https://www4.sii.cl/certBolElectDteInternet/';
     const CBE_PERM   = '0FC3D987613537E6E13E9BB93A406F13';
     const CBE_POLICY = '082D0AC4BC4D75A5DF38F116C53877D4';
     const CBE_SVC    = 'cl.sii.sdi.diii.certBolElectDte.web.client.service.Facade';
-
-    const cookieJar = await this._obtenerCookiesSII();
     const cookieStr = Object.entries(cookieJar).map(([k, v]) => `${k}=${v}`).join('; ');
-    const [rutNum, dvChar] = this.config.emisor.rut.replace(/\./g, '').split('-');
-    const dvUp       = dvChar.toUpperCase();
-    const razonSocial = this.config.emisor.razon_social || this.config.emisor.razonSocial || '';
-
     const tlsOpts = {
       rejectUnauthorized: false,
       maxVersion: 'TLSv1.2',
@@ -3279,11 +3288,32 @@ class CertRunner {
         ...tlsOpts,
       }, (res) => { const ch = []; res.on('data', c => ch.push(c)); res.on('end', () => resolve(Buffer.concat(ch).toString('utf-8'))); });
       req.on('error', reject);
-      req.setTimeout(30000, () => { req.destroy(); reject(new Error('timeout gwtPost CBE declaracion')); });
+      req.setTimeout(30000, () => { req.destroy(); reject(new Error('timeout gwtPost CBE')); });
       req.write(buf); req.end();
     });
+    return { CBE_BASE, CBE_POLICY, CBE_SVC, gwtPost };
+  }
+
+  /**
+   * Chequeo de SOLO LECTURA del estado de la certificación de Boleta en el portal
+   * certBolElectDteInternet. No declara nada — sirve para:
+   *  - gatear el botón "Declarar cumplimiento" (evita el viaje fallido si aún no hay P90)
+   *  - recuperar el estado de boleta cuando las banderas locales se resetearon (ese
+   *    portal NO aparece en pe_avance, así que consultarEstadoAvance no lo cubre)
+   *
+   * Verificado 2026-07-24 contra 78441936-3 con curl crudo (independiente de este
+   * código) — misma respuesta `//OK[0,[],0,7]` cuando no hay P90 todavía.
+   *
+   * @returns {Promise<{success: boolean, inscrita: boolean, listaParaDeclarar: boolean, estado: string|null, error?: string}>}
+   */
+  async consultarEstadoBoletaPortal() {
+    const cookieJar = await this._obtenerCookiesSII();
+    const [rutNum, dvChar] = this.config.emisor.rut.replace(/\./g, '').split('-');
+    const dvUp = dvChar.toUpperCase();
+    const { CBE_BASE, CBE_POLICY, CBE_SVC, gwtPost } = this._gwtBoletaClient(cookieJar);
 
-    // 1. Obtener representante legal vigente
+    // 1. Representante legal vigente ⇒ si hay uno, la empresa está postulada/inscrita
+    //    en el portal de boleta (aunque aún no tenga P90).
     const reprResp = await gwtPost(
       `7|0|7|${CBE_BASE}|${CBE_POLICY}|${CBE_SVC}|recuperarRepresentantesVigentesUsuariosAutorizados|java.lang.Integer/3438268394|java.lang.String/2004016611|${dvUp}|1|2|3|4|2|5|6|5|${rutNum}|7|`
     );
@@ -3293,17 +3323,67 @@ class CertRunner {
       const reprTable = JSON.parse(reprTableStr);
       rutRepreNum = reprTable.filter(s => /^\d{7,8}$/.test(s)).pop() || '';
     } catch {}
-    if (!rutRepreNum) return { success: false, error: 'No se pudo obtener representante vigente (facade CBE)' };
+    const inscrita = !!rutRepreNum;
+    if (!inscrita) {
+      return { success: true, inscrita: false, listaParaDeclarar: false, estado: null };
+    }
 
-    // 2. Verificar estado portal — debe ser P90 (SOK recibido, listo para declarar)
+    // 2. Estado — P90 = SOK recibido, lista para declarar. Lista vacía = SII aún no
+    //    creó el registro (SOK pendiente). Cualquier otro P\d+ = otro estado del flujo.
     const estadoResp = await gwtPost(
       `7|0|7|${CBE_BASE}|${CBE_POLICY}|${CBE_SVC}|obtenerEstadoAutorizaEmp|java.lang.Integer/3438268394|java.lang.String/2004016611|${dvUp}|1|2|3|4|4|5|6|5|6|5|${rutNum}|7|5|90|0|`
     );
-    if (!estadoResp.includes('P90')) {
-      const estadoMatch = estadoResp.match(/"(P\d+)"/);
-      const estado = estadoMatch ? estadoMatch[1] : '(desconocido)';
-      return { success: false, pendingSok: true, error: `Estado portal no es P90 (es ${estado}) — espere SOK del SII` };
-    }
+    const listaParaDeclarar = estadoResp.includes('P90');
+    const estadoMatch = estadoResp.match(/"(P\d+)"/);
+    const listaVacia = /\/\/OK\[0,\[\]/.test(estadoResp);
+    const estado = listaParaDeclarar ? 'P90'
+                 : estadoMatch ? estadoMatch[1]
+                 : listaVacia ? 'sin_estado_sok_pendiente'
+                 : 'desconocido';
+
+    return { success: true, inscrita: true, listaParaDeclarar, estado };
+  }
+
+  async completarDeclaracionBoletaPortal({
+    linkConsulta    = 'www.sii.cl',
+    rutProveedor    = '',
+    nombreProveedor = '',
+    correoProveedor = '',
+  } = {}) {
+    const cookieJar = await this._obtenerCookiesSII();
+    const [rutNum, dvChar] = this.config.emisor.rut.replace(/\./g, '').split('-');
+    const dvUp       = dvChar.toUpperCase();
+    const razonSocial = this.config.emisor.razon_social || this.config.emisor.razonSocial || '';
+    const { CBE_BASE, CBE_POLICY, CBE_SVC, gwtPost } = this._gwtBoletaClient(cookieJar);
+
+    // Chequeo de solo-lectura primero: evita el viaje de autorizarEmpresaBolProd
+    // (que escribe en el SII) cuando ya sabemos que no va a poder completarse.
+    const estadoActual = await this.consultarEstadoBoletaPortal();
+    if (!estadoActual.success) {
+      return { success: false, error: 'No se pudo consultar el estado en el portal de boleta.' };
+    }
+    if (!estadoActual.inscrita) {
+      return { success: false, error: 'No se pudo obtener representante vigente (facade CBE)' };
+    }
+    if (!estadoActual.listaParaDeclarar) {
+      const legible = estadoActual.estado === 'sin_estado_sok_pendiente'
+        ? 'sin estado registrado (SOK aún no emitido)'
+        : (estadoActual.estado ?? '(desconocido)');
+      return { success: false, pendingSok: true, error: `El SII aún no habilita la declaración: ${legible}. Espere el SOK del set de boleta enviado.` };
+    }
+    // Representante legal vigente. Se vuelve a pedir (no se reusa el de
+    // consultarEstadoBoletaPortal) porque autorizarEmpresaBolProd necesita el dato
+    // fresco justo antes de escribir, sin depender de estado interno de otra llamada.
+    const reprResp = await gwtPost(
+      `7|0|7|${CBE_BASE}|${CBE_POLICY}|${CBE_SVC}|recuperarRepresentantesVigentesUsuariosAutorizados|java.lang.Integer/3438268394|java.lang.String/2004016611|${dvUp}|1|2|3|4|2|5|6|5|${rutNum}|7|`
+    );
+    const reprTableStr = reprResp.substring(reprResp.lastIndexOf(',[') + 1, reprResp.lastIndexOf('],0,7]') + 1);
+    let rutRepreNum = '';
+    try {
+      const reprTable = JSON.parse(reprTableStr);
+      rutRepreNum = reprTable.filter(s => /^\d{7,8}$/.test(s)).pop() || '';
+    } catch {}
+    if (!rutRepreNum) return { success: false, error: 'No se pudo obtener representante vigente (facade CBE)' };
 
     // 3. Obtener datos de postulacion: fchAutorizacion y longCharValue
     const postulResp = await gwtPost(

package/package.json

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

package/utils/sanitize.js

@@ -15,7 +15,16 @@
 /**
  * Sanitizar texto para DTE SII
  * Elimina caracteres que causan problemas de firma XML
- * 
+ *
+ * El envío al SII codifica el XML como ISO-8859-1 vía `Buffer.from(xml, 'latin1')`
+ * (EnviadorSII.js), que trunca cada code point a su byte bajo (code & 0xFF) en vez de
+ * transliterar. Cualquier caracter fuera del rango Latin-1 (ej. em dash — = U+2014)
+ * se corrompe en un byte de control arbitrario (0x2014 & 0xFF = 0x14), lo que el SII
+ * rechaza como "invalid character" a nivel de schema — un error genérico que no apunta
+ * a la causa real. Por eso se reemplazan primero los casos comunes (guiones/puntos
+ * suspensivos tipográficos) por su equivalente ASCII, y como red de seguridad se
+ * elimina cualquier otro caracter fuera de Latin-1 antes de que llegue a esa conversión.
+ *
  * @param {string} text - Texto a sanitizar
  * @returns {string} - Texto sanitizado
  */
@@ -25,6 +34,9 @@ function sanitizeSiiText(text) {
     .replace(/[''´`]/g, '')     // Eliminar apóstrofes
     .replace(/[""]/g, '')       // Eliminar comillas tipográficas
     .replace(/"/g, '')          // Eliminar comillas dobles ASCII
+    .replace(/[—–]/g, '-')      // Guion largo/corto tipográfico -> guion ASCII
+    .replace(/…/g, '...')       // Puntos suspensivos tipográficos -> ASCII
+    .replace(/[^\x00-\xFF]/g, '') // Cualquier otro caracter fuera de Latin-1 (emojis, etc.)
     .trim();
 }