@devlas/dte-sii 2.22.0 → 2.24.0

package/README.md

@@ -606,6 +606,16 @@ SiiPortalAuth.limpiarSesionCache()           // borra todas
 El **límite de sesiones nunca se reintenta** (cada intento empeora el bloqueo) y se distingue por
 `err.code === 'SII_LIMITE_SESIONES'`.
 
+Dos códigos más indican un trámite pendiente del contribuyente, no un problema de la
+librería ni de la conexión:
+
+| `err.code` | Qué significa | Qué hacer |
+|---|---|---|
+| `CERTIFICADO_NO_HABILITADO` | El certificado nunca se habilitó como método de autenticación. El SII responde 200 con un `alert()` de JavaScript, no con un error HTTP. No se reintenta. | En sii.cl: Clave Tributaria, Cambiar clave, y habilitar la autenticación con Certificado Digital. |
+| `EMPRESA_NO_AUTORIZADA` | La empresa no está autorizada a operar en ese ambiente. Aparece al leer los datos del contribuyente. | Terminar la certificación (en producción no queda autorizada antes) o correr la Postulación/Enrolamiento. |
+
+`CafSolicitor.solicitar()` devuelve `EMPRESA_NO_AUTORIZADA` en `errorCode` por el mismo motivo.
+
 ### SiiSession: sesiones HTTP autenticadas
 
 ```javascript

package/SiiPortalAuth.js

@@ -821,7 +821,37 @@ class SiiPortalAuth {
    * El HTML tiene filas <tr><td>Label</td><td>&nbsp;Valor</td></tr>
    * @private
    */
+  /**
+   * "el Contribuyente no está autorizado para operar en esta modalidad" — la empresa nunca
+   * quedó postulada (y/o enrolada) como emisor electrónico ante el SII, así que ad_empresa2
+   * ni siquiera devuelve la tabla de datos que `_parsearTablaEmpresa` espera: devuelve esta
+   * página de rechazo. Mismo patrón y mismo código de error que `CafSolicitor.esEmpresaNoAutorizada`
+   * (`EMPRESA_NO_AUTORIZADA`) — ahí ya existía para otro flujo, acá faltaba. Sin esto caía en
+   * el genérico "no se encontraron datos de resolución", que no dice qué falta. Caso real
+   * verificado el 2026-09-10 (RUT anonimizado en los tests).
+   */
+  static esEmpresaNoAutorizada(html) {
+    const texto = String(html || '').replace(/<[^>]+>/g, ' ');
+    // El SII usa dos sujetos distintos para el mismo rechazo, segun la pagina: "la empresa
+    // no esta autorizada" (ver CafSolicitor.esEmpresaNoAutorizada) y "el Contribuyente no
+    // esta autorizado" (ad_empresa2, caso real 2026-09-10) -- distinto genero tambien
+    // (autorizada/autorizado), por eso el [oa] al final en vez de repetir todo el patron.
+    return /(empresa|contribuyente)\s+no\s+est.{0,8}\s*autorizad[oa]\s+para\s+operar/i.test(texto);
+  }
+
   static _parsearTablaEmpresa(html) {
+    if (SiiPortalAuth.esEmpresaNoAutorizada(html)) {
+      const err = new Error(
+        'SiiPortalAuth: la empresa no está autorizada para operar en esta modalidad. ' +
+        'No es un problema de datos ni de sesión: el SII no reconoce a la empresa como ' +
+        'emisor electrónico en este ambiente. Las dos causas habituales son que todavía ' +
+        'no complete la certificación (en producción no queda autorizada hasta entonces) ' +
+        'o que nunca se haya corrido la Postulación/Enrolamiento.'
+      );
+      err.code = 'EMPRESA_NO_AUTORIZADA';
+      throw err;
+    }
+
     const datos = {};
     const decode = s => s
       .replace(/<[^>]+>/g, '')

package/dte-sii.d.ts

@@ -606,6 +606,60 @@ export class EnviadorSII {
   consultarEstadoDte(params: object): Promise<object>;
 }
 
+/** Estado de un DTE recibido según su último evento en el Registro de Aceptación/Reclamo. */
+export type EstadoReceptorDte = 'aceptada' | 'acuse_recibo' | 'reclamada' | 'sin_accion';
+
+/**
+ * Acción a registrar sobre un DTE recibido. ACD acepta el contenido, ERM otorga recibo de
+ * mercaderías o servicios, RCD reclama el contenido, RFP y RFT reclaman falta parcial o
+ * total de mercaderías.
+ */
+export type AccionReclamoDte = 'ACD' | 'ERM' | 'RCD' | 'RFP' | 'RFT';
+
+export interface EventoReclamoDte {
+  codEvento: string;
+  descEvento: string;
+  rutResponsable: string;
+  dvResponsable: string;
+  fechaEvento: string;
+}
+
+/** Respuesta del web service, con `codResp` numérico y `descResp` en texto, tal como los entrega el SII. */
+export interface RespuestaReclamoDte {
+  codResp: number;
+  descResp: string;
+}
+
+/**
+ * Cliente del web service de Registro de Aceptación/Reclamo de DTE (WSRECLAMO).
+ * Se exporta desde index.js.
+ */
+export class WsReclamo {
+  constructor(
+    certificado: Certificado,
+    ambiente: 'certificacion' | 'produccion',
+    options?: { useTokenCache?: boolean },
+  );
+  /** Historial de eventos de un DTE recibido. */
+  listarEventosHistDoc(
+    rutEmisor: number | string, dvEmisor: string, tipoDoc: number | string, folio: number | string,
+  ): Promise<RespuestaReclamoDte & { eventos: EventoReclamoDte[] }>;
+  /** Estado resumido según el último evento. 'sin_accion' cuando ningún evento lo determina. */
+  consultarEstadoReceptor(
+    rutEmisor: number | string, dvEmisor: string, tipoDoc: number | string, folio: number | string,
+  ): Promise<EstadoReceptorDte>;
+  /** Registra una acción sobre un DTE recibido. Lanza si `accionDoc` no es una acción válida. */
+  ingresarAceptacion(
+    rutEmisor: number | string, dvEmisor: string, tipoDoc: number | string, folio: number | string,
+    accionDoc: AccionReclamoDte,
+  ): Promise<RespuestaReclamoDte>;
+  /**
+   * Descarta el token SOAP en memoria de esta instancia. No limpia el caché compartido de
+   * tokens, que expira por TTL.
+   */
+  invalidarToken(): void;
+}
+
 // ============================================
 // FOLIO MANAGEMENT
 // ============================================
@@ -808,11 +862,32 @@ export interface CafSolicitarOptions {
   soloConsultarTope?: boolean;
 }
 
+/**
+ * Códigos que puede traer `CafSolicitarResult.errorCode`.
+ *
+ * Lista cerrada. test/contrato-estaticos-dts.test.js la compara contra los literales que
+ * emite `solicitar()` en las dos direcciones: si el código agrega o saca un valor sin
+ * actualizar esto, el test falla.
+ */
+export type CafSolicitarErrorCode =
+  | 'TIMBRAJE_BLOQUEADO'
+  | 'MAX_AUTOR_INSUFICIENTE'
+  | 'MAX_AUTOR_EXCEEDED'
+  | 'RANGO_YA_AUTORIZADO'
+  | 'EMPRESA_NO_AUTORIZADA'
+  | 'USUARIO_SIN_PERMISO'
+  | 'NO_AUTORIZADO_INGRESAR_OPCION'
+  | 'REQUIERE_TRAMITE_PRESENCIAL'
+  | 'VERIFICACION_ACTIVIDADES_PENDIENTE'
+  | 'SESSION_EXPIRED'
+  | 'WAAP_BLOCKED'
+  | 'UNKNOWN';
+
 export interface CafSolicitarResult {
   success: boolean;
   xml?: string;
   error?: string;
-  errorCode?: string;
+  errorCode?: CafSolicitarErrorCode;
   folioDesde?: number;
   folioHasta?: number;
 }
@@ -841,6 +916,38 @@ export class CafSolicitor {
    * **No devuelve el XML ni null**, devuelve un objeto con `success`.
    */
   reobtenerCaf(tipoDte: number, rango: RangoReobtenible): Promise<ReobtenerRangoResult>;
+  /** true si la página del portal es el aviso "NO SE AUTORIZA TIMBRAJE". */
+  static esBloqueoTimbraje(html: string): boolean;
+  /**
+   * Motivo que el SII escribe en la página de bloqueo de timbraje, aislado del resto para
+   * mostrarlo tal cual. null si no lo encuentra; nunca lanza.
+   */
+  static extraerMotivoBloqueoTimbraje(html: string): string | null;
+  /** true si el portal responde que no está autorizado para ingresar a esa opción. */
+  static esNoAutorizadoIngresarOpcion(html: string): boolean;
+  /** true si el SII exige presentarse en una oficina: trámite presencial. */
+  static esRequiereTramitePresencial(html: string): boolean;
+  /** true si la página dice que la empresa no está autorizada para operar. */
+  static esEmpresaNoAutorizada(html: string): boolean;
+  /**
+   * true si la página es uno de los rechazos que no se resuelven reintentando: bloqueo de
+   * timbraje, trámite presencial, empresa no autorizada, sin acceso a la opción, usuario
+   * sin permiso o verificación de actividades pendiente.
+   */
+  static esRechazoDuro(html: string): boolean;
+  /** true si el usuario del certificado no tiene permiso o autorización en la empresa. */
+  static esUsuarioSinPermiso(html: string): boolean;
+  /**
+   * Texto visible de un HTML del portal: sin etiquetas, scripts ni estilos, con las
+   * entidades de vocales acentuadas pasadas a vocal simple y recortado a `max` caracteres
+   * (400 por defecto). Lo usan los detectores de arriba.
+   */
+  static textoVisible(html: string, max?: number): string;
+  /**
+   * Cierra con logout todas las sesiones SII en caché. Conviene llamarlo al apagar el
+   * proceso, para no dejar sesiones que cuenten contra el límite de sesiones del SII.
+   */
+  static closeAllSessions(): Promise<void>;
 }
 
 // ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlas/dte-sii",
-  "version": "2.22.0",
+  "version": "2.24.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",
@@ -38,11 +38,10 @@
     "bwip-js": "^4.11.4",
     "dotenv": "^17.3.1",
     "fast-xml-parser": "^5.3.3",
+    "form-data": "^4.0.6",
     "got": "^11.8.6",
     "node-forge": "^1.3.3",
     "pdf-lib": "^1.17.1",
-    "soap": "^1.6.3",
-    "xml-c14n": "^0.0.6",
     "xml-crypto": "^6.1.2"
   },
   "files": [