@devlas/dte-sii 2.5.9 → 2.5.11

package/EnviadorSII.js

@@ -818,7 +818,7 @@ class EnviadorSII {
     
     switch (estado) {
       case 'EPR':
-        mensaje = '✅ Envío Procesado - ¡Listo para declarar cumplimiento!';
+        mensaje = '✅ Envío Procesado';
         esExitoso = true;
         break;
       case 'RPR':
@@ -873,50 +873,72 @@ class EnviadorSII {
         mensaje = `❌ Rechazado: ${glosa || 'Error en documento'}`;
         esRechazado = true;
         break;
-      // Códigos numéricos del SII (QueryEstUp)
+      // Códigos de schema/firma rechazados
+      case 'RSC':
+        mensaje = `❌ Rechazado por Error en Schema: ${glosa || 'XML no cumple XSD del SII'}`;
+        esRechazado = true;
+        break;
+      case 'PDR':
+        mensaje = '⏳ Envío en Proceso - Validando...';
+        esIntermedio = true;
+        break;
+      // Códigos numéricos negativos = errores del servicio de consulta SII (NO rechazo del documento)
+      // Según doc SII: son errores del sistema de consulta, el documento puede estar OK
       case '-11':
-        mensaje = `⏳ Pendiente de proceso - El sobre aún no ha sido revisado por el SII`;
+        mensaje = `⏳ Error de consulta SII (ERR/SQL/SRV_CODE) - Reintente más tarde`;
+        esIntermedio = true;
+        break;
+      case '-12':
+        mensaje = `⏳ Error retorno consulta SII - Reintente más tarde`;
+        esIntermedio = true;
+        break;
+      case '-13':
+        mensaje = `⏳ Error: RUT usuario nulo - Verificar autenticación`;
+        esIntermedio = true;
+        break;
+      case '-14':
+        mensaje = `⏳ Error XML retorno datos SII - Reintente más tarde`;
         esIntermedio = true;
         break;
       case '-10':
-        mensaje = `❌ Token inválido o no autorizado`;
-        esRechazado = true;
+        mensaje = `⏳ Error validación RUT usuario - Verificar credenciales`;
+        esIntermedio = true;
         break;
       case '-9':
-        mensaje = `❌ Firma del envío inválida - ${glosa || 'Verificar certificado'}`;
-        esRechazado = true;
+        mensaje = `⏳ Error retorno datos SII - Reintente más tarde`;
+        esIntermedio = true;
         break;
       case '-8':
-        mensaje = `❌ El envío no pertenece al firmante`;
-        esRechazado = true;
+        mensaje = `⏳ Error retorno datos SII - Reintente más tarde`;
+        esIntermedio = true;
         break;
       case '-7':
-        mensaje = `❌ Error en datos del receptor - ${glosa || 'Verificar RUT receptor'}`;
-        esRechazado = true;
+        mensaje = `⏳ Error retorno datos SII - Reintente más tarde`;
+        esIntermedio = true;
         break;
       case '-6':
-        mensaje = `❌ Error en datos del emisor - ${glosa || 'Verificar RUT emisor'}`;
-        esRechazado = true;
+        mensaje = `⏳ Error: Usuario no autorizado para consultar - Verificar credenciales`;
+        esIntermedio = true;
         break;
       case '-5':
-        mensaje = `❌ Error de certificación - ${glosa || 'Verificar proceso de certificación'}`;
-        esRechazado = true;
+        mensaje = `⏳ Error retorno datos SII - Reintente más tarde`;
+        esIntermedio = true;
         break;
       case '-4':
-        mensaje = `❌ Envío fuera de plazo - ${glosa || 'El plazo de envío ha vencido'}`;
-        esRechazado = true;
+        mensaje = `⏳ Error obtención de datos SII - Reintente más tarde`;
+        esIntermedio = true;
         break;
       case '-3':
-        mensaje = `❌ RUT emisor no coincide con el certificado`;
-        esRechazado = true;
+        mensaje = `⏳ Error: RUT usuario no existe en SII - Verificar autenticación`;
+        esIntermedio = true;
         break;
       case '-2':
-        mensaje = `❌ Error de firma en el sobre - ${glosa || 'Verificar firma digital'}`;
-        esRechazado = true;
+        mensaje = `⏳ Error retorno SII - Reintente más tarde`;
+        esIntermedio = true;
         break;
       case '-1':
-        mensaje = `❌ Error de schema XML - ${glosa || 'El XML no cumple el XSD del SII'}`;
-        esRechazado = true;
+        mensaje = `⏳ Error: Campo estado no retornado por SII - Reintente más tarde`;
+        esIntermedio = true;
         break;
       case '0':
         mensaje = `⏳ Enviado al SII, pendiente de validación`;
@@ -936,6 +958,7 @@ class EnviadorSII {
       glosa,
       mensaje,
       numAtencion: numAtencionMatch ? numAtencionMatch[1] : null,
+      xmlRaw: decoded,
     };
   }
 

package/README.md

@@ -78,6 +78,40 @@ console.log(resultado.trackId)
 
 Soporta `'certificacion'` y `'produccion'`. Pasarlo al instanciar `EnviadorSII`.
 
+## Estados SII — Interpretación de respuestas
+
+`EnviadorSII` interpreta automáticamente los códigos del SII en tres categorías:
+
+### QueryEstUp — Estado del sobre de envío
+
+| Código | Descripción | `esExitoso` | `esIntermedio` | `esRechazado` |
+|--------|-------------|:-----------:|:--------------:|:-------------:|
+| `EPR` | Envío Procesado | ✅ | | |
+| `RPR` | Procesado con Reparos | ✅ | | |
+| `REC` / `SOK` / `FOK` / `CRT` / `PRD` / `PDR` | En proceso de validación | | ✅ | |
+| `RSC` | Error en Schema XML | | | ✅ |
+| `RFR` | Error en Firma Digital | | | ✅ |
+| `RCT` | Error en Carátula | | | ✅ |
+
+### QueryEstDte — Estado del DTE individual
+
+| Código | Descripción | Clasificación |
+|--------|-------------|---------------|
+| `DOK` | Datos coinciden | ✅ Exitoso |
+| `DNK` | Datos no coinciden | ⏳ Intermedio |
+| `FAU` | Folio no autorizado | ❌ Rechazado |
+| `FNA` | Emisor no habilitado | ❌ Rechazado |
+| `FAN` / `AND` / `ANC` | Anulado | ❌ Rechazado |
+| `EMP` | Empresa sin autorización | ❌ Rechazado |
+
+### Códigos negativos (errores de consulta)
+
+Los códigos `-1` a `-14` son **errores del servidor de consulta SII**, no implican rechazo del documento. Todos resultan en `esIntermedio = true` y se pueden reintentar.
+
+> Ver `docs/README.md` en el repositorio para la tabla completa de estados con descripción detallada.
+
+---
+
 ## Licencia
 
 MIT — Copyright (c) 2026 [Devlas SpA](https://devlas.cl)

package/SiiPortalAuth.js

@@ -326,7 +326,7 @@ class SiiPortalAuth {
    * @param {string} rutEmpresa - RUT sin DV (ej: "78206276")
    * @param {string} dvEmpresa  - DV (ej: "K")
    * @param {Object} [cookieJar] - Sesión autenticada (si omite, autenticará)
-   * @returns {Promise<Object>} { rut, razonSocial, direccion, comuna, acteco, glosa }
+   * @returns {Promise<Object>} { rut, razonSocial, direccion, comuna, dirReg, acteco, glosa }
    */
   async obtenerDatosContribuyente(rutEmpresa, dvEmpresa, cookieJar = null) {
     const jar = cookieJar || await this.autenticar();
@@ -395,14 +395,20 @@ class SiiPortalAuth {
       }
     }
 
+    const dirReg = datos['DIRECCIÓN REGIONAL DEL CONTRIBUYENTE'] || datos['DIRECCION REGIONAL DEL CONTRIBUYENTE'] || null;
+    const glosa  = datos['GLOSA DESCRIPTIVA'] || null;
+
     return {
-      rut:        datos['DATOS DEL CONTRIBUYENTE RUT'] || null,
-      razonSocial: datos['NOMBRE O RAZÓN SOCIAL'] || datos['NOMBRE O RAZON SOCIAL'] || null,
+      rut:          datos['DATOS DEL CONTRIBUYENTE RUT'] || null,
+      razonSocial:  datos['NOMBRE O RAZÓN SOCIAL'] || datos['NOMBRE O RAZON SOCIAL'] || null,
+      giro:         actividades[0]?.descripcion || null,  // descripción de la primera actividad económica
       direccion,
       comuna,
-      acteco:     actividades[0]?.codigo || null,
-      actividades: actividades.length ? actividades : null,
-      glosa:      datos['GLOSA DESCRIPTIVA'] || null,
+      dirReg,
+      sucursal_sii: dirReg ? `S.I.I. - ${dirReg}` : null,
+      acteco:       actividades[0]?.codigo || null,
+      actividades:  actividades.length ? actividades : null,
+      glosa,
     };
   }
 

package/cert/MuestrasImpresas.js

@@ -1,5 +1,5 @@
-// Copyright (c) 2026 Devlas SpA — https://devlas.cl
-// Licencia MIT. Ver archivo LICENSE para mas detalles.
+// Copyright (c) 2026 Devlas SpA — https://devlas.cl
+// Licencia MIT. Ver archivo LICENSE para mas detalles.
 /**
  * MuestrasImpresas.js
  * 
@@ -208,7 +208,7 @@ class MuestrasImpresas {
    * @param {string} tedXml - XML del TED
    * @returns {Promise<string>} Data URI de la imagen PNG
    */
-  async generarPdf417(tedXml) {
+  async generarPdf417(tedXml, height = 12) {
     if (!tedXml || !tedXml.includes('<TED')) {
       throw new Error('No se encontró TED para generar PDF417');
     }
@@ -223,7 +223,7 @@ class MuestrasImpresas {
       bcid: 'pdf417',
       text: binaryString,
       scale: 3,
-      height: 12,
+      height,
       padding: 6,
       includetext: false,
       // CRÍTICO: Indicar a bwip-js que el texto ya está en formato binario 8-bit

package/package.json

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