@devlas/dte-sii 2.13.2 → 2.14.0

package/cert/SetCompra.js

@@ -99,9 +99,7 @@ class SetCompra extends SetBase {
     const { DTE, CAF, buildDetalleCompra, buildSetReferencia } = require('../index');
     const fs = require('fs');
     
-    const cafXml = fs.readFileSync(cafPath, 'utf8');
-    const caf = new CAF(cafXml);
-    const folio = this._reservarFolio(caf, cafXml);
+    const { caf, cafXml, folio } = this._tomarFolio(cafPath);
     
     // Construir detalle con buildDetalleCompra (incluye CodImpAdic)
     const items = this._normalizarItems(caso.items);
@@ -151,9 +149,7 @@ class SetCompra extends SetBase {
     const { DTE, CAF, buildDetalleCompra, buildSetReferencia } = require('../index');
     const fs = require('fs');
     
-    const cafXml = fs.readFileSync(cafPath, 'utf8');
-    const caf = new CAF(cafXml);
-    const folio = this._reservarFolio(caf, cafXml);
+    const { caf, cafXml, folio } = this._tomarFolio(cafPath);
     
     // Obtener documento referenciado
     const docRef = this._docRefs[caso.referenciaCaso];
@@ -219,9 +215,7 @@ class SetCompra extends SetBase {
     const { DTE, CAF, buildDetalleCompra, buildSetReferencia } = require('../index');
     const fs = require('fs');
     
-    const cafXml = fs.readFileSync(cafPath, 'utf8');
-    const caf = new CAF(cafXml);
-    const folio = this._reservarFolio(caf, cafXml);
+    const { caf, cafXml, folio } = this._tomarFolio(cafPath);
     
     // Obtener documento referenciado
     const docRef = this._docRefs[caso.referenciaCaso];
@@ -394,18 +388,6 @@ class SetCompra extends SetBase {
    * Reserva el siguiente folio disponible
    * @private
    */
-  _reservarFolio(caf, cafXml) {
-    const cafFingerprint = this.folioHelper.createCafFingerprint(cafXml);
-    const folio = this.folioHelper.reserveNextFolio({
-      rutEmisor: this.config.emisor.rut,
-      tipoDte: caf.getTipoDTE(),
-      folioDesde: caf.getFolioDesde(),
-      folioHasta: caf.getFolioHasta(),
-      ambiente: this.config.ambiente || 'certificacion',
-      cafFingerprint,
-    });
-    return folio;
-  }
 
   /**
    * Obtiene la fecha de emisión

package/cert/SetExenta.js

@@ -104,9 +104,7 @@ class SetExenta extends SetBase {
     const { DTE, CAF, buildDetalle, calcularTotalesDesdeDetalle, buildSetReferencia } = require('../index');
     const fs = require('fs');
     
-    const cafXml = fs.readFileSync(cafPath, 'utf8');
-    const caf = new CAF(cafXml);
-    const folio = this._reservarFolio(caf, cafXml);
+    const { caf, cafXml, folio } = this._tomarFolio(cafPath);
     
     // Marcar todos los items como exentos
     const items = this._normalizarItemsExentos(caso.items);
@@ -156,9 +154,7 @@ class SetExenta extends SetBase {
     const { DTE, CAF, buildDetalle, calcularTotalesDesdeDetalle, buildSetReferencia } = require('../index');
     const fs = require('fs');
     
-    const cafXml = fs.readFileSync(cafPath, 'utf8');
-    const caf = new CAF(cafXml);
-    const folio = this._reservarFolio(caf, cafXml);
+    const { caf, cafXml, folio } = this._tomarFolio(cafPath);
     
     // Obtener documento referenciado
     const docRef = this._docRefs[caso.referenciaCaso];
@@ -224,9 +220,7 @@ class SetExenta extends SetBase {
     const { DTE, CAF, buildDetalle, calcularTotalesDesdeDetalle, buildSetReferencia } = require('../index');
     const fs = require('fs');
     
-    const cafXml = fs.readFileSync(cafPath, 'utf8');
-    const caf = new CAF(cafXml);
-    const folio = this._reservarFolio(caf, cafXml);
+    const { caf, cafXml, folio } = this._tomarFolio(cafPath);
     
     // Obtener documento referenciado
     const docRef = this._docRefs[caso.referenciaCaso];
@@ -412,18 +406,6 @@ class SetExenta extends SetBase {
    * Reserva el siguiente folio disponible
    * @private
    */
-  _reservarFolio(caf, cafXml) {
-    const cafFingerprint = this.folioHelper.createCafFingerprint(cafXml);
-    const folio = this.folioHelper.reserveNextFolio({
-      rutEmisor: this.config.emisor.rut,
-      tipoDte: caf.getTipoDTE(),
-      folioDesde: caf.getFolioDesde(),
-      folioHasta: caf.getFolioHasta(),
-      ambiente: this.config.ambiente || 'certificacion',
-      cafFingerprint,
-    });
-    return folio;
-  }
 
   /**
    * Obtiene la fecha de emisión

package/cert/SetGuia.js

@@ -82,11 +82,9 @@ class SetGuia extends SetBase {
     const fs = require('fs');
     
     // Cargar CAF
-    const cafXml = fs.readFileSync(cafPath, 'utf8');
-    const caf = new CAF(cafXml);
+    const { caf, cafXml, folio } = this._tomarFolio(cafPath);
     
     // Reservar folio
-    const folio = this._reservarFolio(caf, cafXml);
     
     // Construir detalle (buildDetalleGuia siempre incluye QtyItem)
     const items = this._normalizarItems(caso.items);
@@ -178,18 +176,6 @@ class SetGuia extends SetBase {
    * Reserva el siguiente folio disponible
    * @private
    */
-  _reservarFolio(caf, cafXml) {
-    const cafFingerprint = this.folioHelper.createCafFingerprint(cafXml);
-    const folio = this.folioHelper.reserveNextFolio({
-      rutEmisor: this.config.emisor.rut,
-      tipoDte: caf.getTipoDTE(),
-      folioDesde: caf.getFolioDesde(),
-      folioHasta: caf.getFolioHasta(),
-      ambiente: this.config.ambiente || 'certificacion',
-      cafFingerprint,
-    });
-    return folio;
-  }
 
   /**
    * Obtiene la fecha de emisión en formato YYYY-MM-DD

package/dte-sii.d.ts

@@ -622,6 +622,17 @@ export interface FolioTope {
   maxAutor: number | null;
   /** Folios disponibles según el SII, o null si no vino. */
   foliosDisp: number | null;
+  /** true si el SII bloqueó el timbraje para este tipo. Tiene prioridad sobre `sinTope`. */
+  bloqueado?: boolean;
+}
+
+export interface ReobtenerCafResult {
+  /** Rutas de los CAF recuperados. El SII entrega los folios de a uno, así que pueden ser varios. */
+  paths: string[];
+  /** Cantidad total de folios recuperados entre todos los rangos. */
+  folios: number;
+  /** Rangos que se descartaron por estar anulados en el SII. */
+  descartados: Array<{ desde: number; hasta: number; motivo: string }>;
 }
 
 export class FolioService {
@@ -633,6 +644,15 @@ export class FolioService {
    * anular antes de pedir, en vez de anular a ciegas.
    */
   consultarTope(options: { tipoDte: number }): Promise<FolioTope>;
+  /**
+   * Recupera CAF ya autorizados desde el portal, sin gastar cupo de timbraje.
+   *
+   * Es la salida cuando el SII bloqueó el timbraje: los folios ya están autorizados,
+   * solo se perdió el archivo. Junta tantos rangos como haga falta y descarta los que
+   * el portal reporta como anulados (los documentos emitidos con esos folios se
+   * rechazan).
+   */
+  reobtenerCaf(options: { tipoDte: number; cantidad: number }): Promise<ReobtenerCafResult | null>;
 }
 
 export interface FolioRegistryOptions {
@@ -698,6 +718,15 @@ export class CafSolicitor {
    * (`solicitar(tipoDte, cantidad)`) no coincidía con la implementación.
    */
   solicitar(options: CafSolicitarOptions): Promise<CafSolicitarResult>;
+  /**
+   * Lista los rangos de folios ya autorizados que el portal permite volver a descargar.
+   *
+   * ⚠️ El listado incluye rangos ANULADOS sin distinguirlos: solo al abrir cada uno el
+   * portal lo avisa. Por eso `reobtenerCaf` hace un request por rango.
+   */
+  listarReobtenibles(tipoDte: number): Promise<Array<{ desde: number; hasta: number; raw?: string }>>;
+  /** Descarga el CAF de un rango ya autorizado. Devuelve null si el rango está anulado. */
+  reobtenerCaf(tipoDte: number, rango: { desde: number; hasta: number }): Promise<string | null>;
 }
 
 // ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlas/dte-sii",
-  "version": "2.13.2",
+  "version": "2.14.0",
   "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",
@@ -8,7 +8,7 @@
   "author": "Devlas SpA <ti@devlas.cl> (https://devlas.cl)",
   "homepage": "https://github.com/devlas-cl/dte-sii",
   "scripts": {
-    "test": "node test/pfx.test.js"
+    "test": "node test/pfx.test.js && node test/folios-consolidados.test.js && node test/c14n-apostrofe.test.js"
   },
   "repository": {
     "type": "git",

package/utils/c14n.js

@@ -38,23 +38,29 @@ function escapeText(text) {
 }
 
 /**
- * Corrige entidades en contenido XML (apóstrofes y comillas)
- * @param {string} xml - XML a procesar
- * @returns {string} - XML con entidades corregidas
+ * ⚠️ NO agregar acá un paso que escape apóstrofes o comillas en el contenido.
+ *
+ * Existía un `fixEntities()` que recorría el XML canónico y convertía `'` en `'` y
+ * `"` en `"` dentro del texto. Canonical XML (REC-xml-c14n-20010315, §1.3 y §2.3)
+ * escapa en nodos de texto SOLO `&`, `<`, `>` y el retorno de carro; el apóstrofe y la
+ * comilla doble quedan literales. `escapeText()` acá arriba ya hace exactamente eso.
+ *
+ * Con ese paso de más, la forma canónica que firmábamos dejaba de ser la que el SII
+ * calcula al recibir el documento, así que el DigestValue no coincidía y el SII rechazaba
+ * el ENVÍO COMPLETO con `RFR - Rechazado por Error en Firma` — sin decir cuál documento ni
+ * por qué. Y solo pasaba cuando algún texto traía un apóstrofe, que es lo que lo hacía
+ * tan difícil de ver: los mismos sets pasaban o fallaban según el contenido del set.
+ *
+ * Medido el 14/08/2026 (RUT 78206276-K, maullin). Un solo ítem, "CAPACITACION USO PLC'S
+ * CNC", en un único documento del Set Factura Exenta:
+ *
+ *   Set Básico   → EPR   0 documentos con digest divergente
+ *   Set Guía     → EPR   0
+ *   Set Exenta   → RFR   1  (nota de débito 56/2616, la del apóstrofe)
+ *   Set Compra   → EPR   0
+ *
+ * El envío entero se cae por un carácter en un ítem. Ver `test/c14n-apostrofe.test.js`.
  */
-function fixEntities(xml) {
-  let out = '';
-  let inContent = false;
-  for (let i = 0; i < xml.length; i++) {
-    const ch = xml[i];
-    if (ch === '>') inContent = true;
-    if (ch === '<') inContent = false;
-    if (inContent && ch === "'") { out += '&apos;'; continue; }
-    if (inContent && ch === '"') { out += '&quot;'; continue; }
-    out += ch;
-  }
-  return out;
-}
 
 /**
  * Serializa un nodo DOM a XML canónico
@@ -257,7 +263,6 @@ module.exports = {
   // Escape/Text functions
   escapeAttr,
   escapeText,
-  fixEntities,
   // Serialization
   serializeNode,
   serializeElement,

package/utils/httpDebug.js

@@ -171,6 +171,20 @@ function registrarHttpDebug(info = {}) {
         truncado,
         archivo: nombre,
         archivoRequest: archivoReq,
+        // El cuerpo enviado va TAMBIÉN acá, no solo en el HTML.
+        //
+        // `index.jsonl` es lo único que la purga conserva siempre (ver cert-purga.ts), y
+        // el HTML con su cabecera es lo primero que se descarta. Depurando el 14/08/2026
+        // hacia atrás quedó a la vista: del día anterior se podía leer QUÉ endpoints se
+        // llamaron, pero no CON QUÉ datos, que era justo lo necesario para comparar una
+        // corrida buena contra una fallada.
+        //
+        // Se recorta a 2000 caracteres: el índice se guarda un año y tiene que seguir
+        // siendo liviano. El cuerpo completo, mientras exista, está en el HTML o en el
+        // `-request.txt`.
+        reqBody: reqTexto
+          ? (reqTexto.length > 2000 ? reqTexto.slice(0, 2000) + ` …${REDACTADO} recortado` : reqTexto)
+          : null,
         headers: redactarHeaders(headers),
       }) + '\n',
       'utf-8',