@devlas/dte-sii 2.18.2 → 2.19.1

package/Certificado.js

@@ -7,6 +7,7 @@
  */
 
 const forge = require('node-forge');
+const { formatRutSii } = require('./utils/rut');
 const { 
   certError, 
   ERROR_CODES, 
@@ -55,7 +56,7 @@ class Certificado {
     }
     
     // Usar datos extraídos por la utilidad centralizada
-    this.rut = pfxData.rut;
+    this.rut = formatRutSii(pfxData.rut);
     this.nombre = pfxData.cn;
     
 

package/Envio.js

@@ -170,8 +170,8 @@ class EnvioDTE extends EnvioBase {
     });
     
     this.caratula = {
-      RutEmisor: caratula.RutEmisor,
-      RutEnvia: caratula.RutEnvia,
+      RutEmisor: formatRutSii(caratula.RutEmisor),
+      RutEnvia: formatRutSii(caratula.RutEnvia),
       RutReceptor: caratula.RutReceptor || '',
       FchResol: caratula.FchResol,
       NroResol: caratula.NroResol,

package/README.md

@@ -38,6 +38,8 @@ npm install @devlas/dte-sii
 - [Certificación SII](#certificación-sii)
 - [Depuración: captura de llamadas al SII](#depuración-captura-de-llamadas-al-sii)
 - [Ambientes](#ambientes)
+- [Contribuir](#contribuir)
+- [Seguridad](#seguridad)
 - [Licencia](#licencia)
 
 ---
@@ -1078,6 +1080,33 @@ se ven correctos. Si generas el PDF417 por tu cuenta, respeta esa misma regla.
 
 ---
 
+## Contribuir
+
+Los PRs son bienvenidos. Antes de escribir código, lee
+[CONTRIBUTING.md](CONTRIBUTING.md).
+
+Esta librería emite documentos tributarios reales, así que el estándar de evidencia
+es más alto que en una librería común. En resumen: un PR por cambio, evidencia
+declarada por nivel (lectura, test, artefacto adjunto, respuesta del SII), y trazar
+el radio de impacto, porque un valor que entra acá sale por siete lugares distintos
+y el código de barras firmado es uno de ellos.
+
+```bash
+npm test        # suite completa, sin red ni SII
+npm run scan    # barrido de datos reales (este repo es público)
+npm run types   # verificación de dte-sii.d.ts
+```
+
+Las tres corren en CI sobre cada PR, en Node 18, 20 y 22.
+
+Si trabajas con un agente de código, el repo trae la skill
+[`pr-dte-sii`](.claude/skills/pr-dte-sii/) con estas reglas en formato ejecutable.
+
+## Seguridad
+
+Si encuentras un problema de seguridad, **no abras un issue público**. Ver
+[SECURITY.md](SECURITY.md) para el canal privado y el alcance.
+
 ## Licencia
 
 MIT - Copyright (c) 2026 [Devlas SpA](https://devlas.cl)

package/dte-sii.d.ts

@@ -626,14 +626,73 @@ export interface FolioTope {
   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 }>;
-}
+/** Un rango ya autorizado que el portal ofrece para reobtener. */
+export interface RangoReobtenible {
+  /** Campos ocultos del formulario del portal. Hay que devolverlos tal cual para bajar el CAF. */
+  campos: Record<string, string>;
+  folioDesde: number;
+  folioHasta: number;
+  /** Folios que cubre el rango. */
+  cantidad: number;
+  /**
+   * true si el SII anuló el rango. Los documentos emitidos con esos folios se
+   * rechazan, así que hay que saltarlo.
+   *
+   * Ojo: el portal marca los ANULADOS y nada más. Un folio ya emitido aparece
+   * como reobtenible igual, y por eso `FolioService.reobtenerCaf` recibe
+   * `yaEmitido`: ese dato el SII no lo publica.
+   */
+  anulado: boolean;
+}
+
+/** Resultado de `CafSolicitor.reobtenerCaf`, para un solo rango. */
+export type ReobtenerRangoResult =
+  | {
+      success: true;
+      /** Ruta donde quedó el CAF descargado. */
+      cafPath: string;
+      /** El XML del CAF tal como lo entregó el portal. */
+      xml: string;
+      reobtenido: true;
+      folioDesde: number;
+      folioHasta: number;
+      otorgados: number;
+    }
+  | {
+      success: false;
+      errorCode:
+        | 'RANGO_ANULADO'
+        | 'REOBTENCION_SIN_FORMULARIO'
+        | 'REOBTENCION_SIN_DESCARGA'
+        | 'REOBTENCION_SIN_CAF';
+      [extra: string]: unknown;
+    };
+
+/**
+ * Resultado de `FolioService.reobtenerCaf`.
+ *
+ * Union discriminada por `ok` a propósito: obliga a comprobarlo antes de leer
+ * las rutas. El método **nunca devuelve null**, ni siquiera al fallar, así que
+ * `if (!resultado)` no detecta nada.
+ */
+export type ReobtenerCafResult =
+  | {
+      ok: true;
+      /** Rutas de los CAF recuperados. El SII entrega los rangos de a uno, así que pueden ser varios. */
+      cafPaths: string[];
+      /** Atajo al primero de `cafPaths`. */
+      cafPath: string;
+    }
+  | {
+      ok: false;
+      /** Qué impidió completar la reobtención, en texto legible. */
+      motivo: string;
+      /**
+       * Folios que sí se alcanzaron a cubrir, cuando el fallo es por cantidad.
+       * Ausente si el fallo fue antes de mirar los rangos.
+       */
+      disponibles?: number;
+    };
 
 export class FolioService {
   constructor(config?: FolioServiceConfig);
@@ -661,7 +720,7 @@ export class FolioService {
      * cada documento vuelve rechazado con `DTE-3-101`.
      */
     yaEmitido?: (rango: { folioDesde: number; folioHasta: number }) => boolean;
-  }): Promise<ReobtenerCafResult | null>;
+  }): Promise<ReobtenerCafResult>;
   /** El CAF más reciente de un tipo para este RUT y ambiente, o null. */
   findLatestCaf(tipoDte: number): string | null;
   /**
@@ -771,9 +830,17 @@ export class CafSolicitor {
    * ⚠️ 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>;
+  listarReobtenibles(tipoDte: number): Promise<RangoReobtenible[]>;
+  /**
+   * Descarga el CAF de un rango ya autorizado.
+   *
+   * `rango` es un elemento tal cual sale de `listarReobtenibles`: lleva los
+   * campos ocultos del formulario del portal en `campos`, que el portal exige de
+   * vuelta. No se puede construir a mano con solo los folios.
+   *
+   * **No devuelve el XML ni null**, devuelve un objeto con `success`.
+   */
+  reobtenerCaf(tipoDte: number, rango: RangoReobtenible): Promise<ReobtenerRangoResult>;
 }
 
 // ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlas/dte-sii",
-  "version": "2.18.2",
+  "version": "2.19.1",
   "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,9 @@
   "author": "Devlas SpA <ti@devlas.cl> (https://devlas.cl)",
   "homepage": "https://github.com/devlas-cl/dte-sii",
   "scripts": {
-    "test": "node test/pfx.test.js && node test/folios-consolidados.test.js && node test/c14n-apostrofe.test.js && node test/precargar-plan-corrida.test.js && node test/respaldo-mipyme.test.js"
+    "test": "for f in test/*.test.js; do echo \"\n── $f\"; node \"$f\" || exit 1; done",
+    "scan": "node scripts/scan-datos-reales.js",
+    "types": "tsc --noEmit --strict --types node dte-sii.d.ts"
   },
   "repository": {
     "type": "git",
@@ -49,5 +51,9 @@
     "*.js",
     "utils/",
     "cert/"
-  ]
+  ],
+  "devDependencies": {
+    "@types/node": "^26.3.0",
+    "typescript": "^7.0.2"
+  }
 }

package/utils/rut.js

@@ -31,7 +31,10 @@ function formatRut(rut) {
  */
 function cleanRut(rut) {
   if (!rut) return '';
-  return rut.replace(/[^0-9kK]/g, '').toUpperCase();
+  const cleaned = rut.replace(/[^0-9kK]/g, '').toUpperCase();
+  if (cleaned.length < 2) return cleaned;
+  const numero = cleaned.slice(0, -1).replace(/^0+(?=\d)/, '');
+  return `${numero || '0'}${cleaned.slice(-1)}`;
 }
 
 /**
@@ -74,7 +77,8 @@ function formatRutWithDots(rut) {
  */
 function formatRutSii(rut) {
   const { numero, dv } = splitRut(rut);
-  if (!numero) return '';
+  if (!numero && !dv) return '';
+  if (!dv) throw new Error('RUT demasiado corto para formato SII');
   return `${numero}-${dv}`;
 }