@devlas/dte-sii 2.12.25 → 2.12.26

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.

package/package.json

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