dgii-ts 0.1.2 → 0.2.0

package/README.en.md

@@ -135,9 +135,41 @@ const result = await client.getContribuyente('131098193');
 
 ```typescript
 const ncfResult = await client.getNCF('131098193', 'B0100000001');
-// { rnc: '131098193', ncf: 'B0100000001', estado: '...', ... }
+// { valid: true, rnc: '131098193', ncf: 'B0100000001', nombreComercial: '...' }
 ```
 
+### Validate an e-NCF online
+
+For an e-NCF (E-series) DGII requires the buyer's RNC. Without it DGII
+answers with a required-field message and `getNCF` throws
+`DgiiServiceError`. The security code is optional.
+
+```typescript
+const ecfResult = await client.getNCF('101010632', 'E310125217173', {
+  rncComprador: '131262414',
+  codigoSeguridad: 'KrOLI0',
+});
+// {
+//   valid: true,
+//   rnc: '101010632',
+//   ncf: 'E310125217173',
+//   rncComprador: '131262414',
+//   codigoSeguridad: 'KrOLI0',
+//   estado: 'Aceptado',
+//   montoTotal: 230677.74,
+//   totalItbis: 35188.13,
+//   fechaEmision: '2026-02-11',
+//   fechaFirma: '2026-02-11',
+// }
+```
+
+`valid: true` means DGII found the document, not that it is accepted:
+check `estado`. The fields `rncComprador`, `codigoSeguridad`, `estado`,
+`montoTotal`, `totalItbis`, `fechaEmision` and `fechaFirma` are only
+filled for the E-series, and `nombreComercial` is not filled for that
+series. Dates are strings exactly as DGII renders them. The options are
+ignored for a B-series NCF.
+
 ## API reference
 
 ### Validators
@@ -155,7 +187,7 @@ const ncfResult = await client.getNCF('131098193', 'B0100000001');
 | --- | --- |
 | `DgiiClient` | Scraping + SOAP fallback, circuit breaker, retry |
 | `client.getContribuyente(rnc)` | Looks up taxpayer data by RNC |
-| `client.getNCF(rnc, ncf)` | Validates a fiscal receipt against DGII |
+| `client.getNCF(rnc, ncf, options?)` | Validates a fiscal receipt against DGII (`options` for e-NCF) |
 
 ### Scraping
 
@@ -163,7 +195,7 @@ const ncfResult = await client.getNCF('131098193', 'B0100000001');
 | --- | --- |
 | `ScrapingClient` | Queries DGII's ASP.NET pages |
 | `client.getContribuyente(rnc)` | Looks up taxpayer data by RNC |
-| `client.getNCF(rnc, ncf)` | Validates a fiscal receipt |
+| `client.getNCF(rnc, ncf, options?)` | Validates a fiscal receipt (`options` for e-NCF) |
 
 ### SOAP client (deprecated)
 
@@ -180,6 +212,10 @@ const ncfResult = await client.getNCF('131098193', 'B0100000001');
 | `downloadBulkFile(options)` | Downloads DGII\_RNC.zip to the given directory |
 | `parseBulkFile(options)` | Parses the taxpayer TXT file |
 
+`parseBulkFile` throws `BulkFormatError` if the file doesn't match the
+expected 11-column layout (for example, if DGII changes the format). It
+accepts an `encoding` option (defaults to `latin1`).
+
 ## Architecture
 
 ```text

package/README.md

@@ -138,9 +138,42 @@ const result = await client.getContribuyente('131098193');
 
 ```typescript
 const ncfResult = await client.getNCF('131098193', 'B0100000001');
-// { rnc: '131098193', ncf: 'B0100000001', estado: '...', ... }
+// { valid: true, rnc: '131098193', ncf: 'B0100000001', nombreComercial: '...' }
 ```
 
+### Validar e-NCF en línea
+
+Para un e-NCF (serie E) la DGII exige el RNC del comprador. Sin él
+responde con un mensaje de campo requerido y `getNCF` lanza
+`DgiiServiceError`. El código de seguridad es opcional.
+
+```typescript
+const ecfResult = await client.getNCF('101010632', 'E310125217173', {
+  rncComprador: '131262414',
+  codigoSeguridad: 'KrOLI0',
+});
+// {
+//   valid: true,
+//   rnc: '101010632',
+//   ncf: 'E310125217173',
+//   rncComprador: '131262414',
+//   codigoSeguridad: 'KrOLI0',
+//   estado: 'Aceptado',
+//   montoTotal: 230677.74,
+//   totalItbis: 35188.13,
+//   fechaEmision: '2026-02-11',
+//   fechaFirma: '2026-02-11',
+// }
+```
+
+`valid: true` significa que la DGII encontró el comprobante, no que
+esté aceptado: revisa `estado`. Los campos `rncComprador`,
+`codigoSeguridad`, `estado`, `montoTotal`, `totalItbis`,
+`fechaEmision` y `fechaFirma` solo se llenan para la serie E, y
+`nombreComercial` no se llena para esa serie. Las fechas son strings
+tal como la DGII las renderiza. Las opciones se ignoran para un NCF de
+serie B.
+
 ## Referencia del API
 
 ### Validadores
@@ -158,7 +191,7 @@ const ncfResult = await client.getNCF('131098193', 'B0100000001');
 | --- | --- |
 | `DgiiClient` | Cliente con scraping + SOAP fallback, circuit breaker y retry |
 | `client.getContribuyente(rnc)` | Consulta datos de un contribuyente por RNC |
-| `client.getNCF(rnc, ncf)` | Valida un comprobante fiscal contra la DGII |
+| `client.getNCF(rnc, ncf, options?)` | Valida un comprobante fiscal contra la DGII (`options` para e-NCF) |
 
 ### Scraping
 
@@ -166,7 +199,7 @@ const ncfResult = await client.getNCF('131098193', 'B0100000001');
 | --- | --- |
 | `ScrapingClient` | Consulta páginas ASP.NET de la DGII |
 | `client.getContribuyente(rnc)` | Consulta contribuyente por RNC |
-| `client.getNCF(rnc, ncf)` | Valida comprobante fiscal |
+| `client.getNCF(rnc, ncf, options?)` | Valida comprobante fiscal (`options` para e-NCF) |
 
 ### Cliente SOAP (deprecated)
 
@@ -183,6 +216,10 @@ const ncfResult = await client.getNCF('131098193', 'B0100000001');
 | `downloadBulkFile(options)` | Descarga DGII\_RNC.zip |
 | `parseBulkFile(options)` | Parsea el archivo TXT |
 
+`parseBulkFile` lanza `BulkFormatError` si el archivo no coincide con el
+layout de 11 columnas esperado (por ejemplo, si la DGII cambia el formato).
+Acepta `encoding` en las opciones (`latin1` por defecto).
+
 ## Arquitectura
 
 ```text

package/dist/bulk.cjs

@@ -2,10 +2,16 @@
 
 
 
-var _chunkFZ6QDTC4cjs = require('./chunk-FZ6QDTC4.cjs');
+
+var _chunkVIZWYFHPcjs = require('./chunk-VIZWYFHP.cjs');
 require('./chunk-QH4BK5X3.cjs');
 
 
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
+
+
+
+
 
 
-exports.DGII_BULK_URL = _chunkFZ6QDTC4cjs.DGII_BULK_URL; exports.downloadBulkFile = _chunkFZ6QDTC4cjs.downloadBulkFile; exports.parseBulkFile = _chunkFZ6QDTC4cjs.parseBulkFile;
+exports.BulkFormatError = _chunkNASWEFHNcjs.BulkFormatError; exports.DGII_BULK_URL = _chunkVIZWYFHPcjs.DGII_BULK_URL; exports.DGII_ESTADOS = _chunkVIZWYFHPcjs.DGII_ESTADOS; exports.downloadBulkFile = _chunkVIZWYFHPcjs.downloadBulkFile; exports.parseBulkFile = _chunkVIZWYFHPcjs.parseBulkFile;

package/dist/bulk.d.cts

@@ -1,4 +1,5 @@
-import { B as BulkContribuyente } from './index-BE6Wfozd.cjs';
+import { B as BulkContribuyente } from './index-BPvMDXya.cjs';
+export { BulkFormatError } from './errors.cjs';
 
 interface DownloadOptions {
     /** Directorio de destino para el archivo ZIP */
@@ -9,8 +10,27 @@ interface DownloadOptions {
 interface ParseOptions {
     /** Ruta al archivo TXT extraído del ZIP */
     filePath: string;
+    /**
+     * Codificación del archivo. La DGII publica el TXT en latin-1
+     * (ISO-8859-1), que es el valor por defecto. Permite anularla si una
+     * futura versión del archivo llega en otra codificación (p. ej. UTF-8).
+     */
+    encoding?: BufferEncoding;
 }
 declare const DGII_BULK_URL: string;
+/**
+ * Valores conocidos de la columna `estado` (col 9) en el archivo masivo,
+ * verificados contra ~778k filas en producción. El parser usa este
+ * vocabulario para detectar un cambio de layout: si ninguna fila de una
+ * muestra trae un `estado` reconocido, el formato de la DGII cambió.
+ */
+declare const DGII_ESTADOS: readonly ["ACTIVO", "SUSPENDIDO", "DADO DE BAJA", "CESE TEMPORAL", "ANULADO", "RECHAZADO"];
+/**
+ * Valor de la columna `estado` del archivo masivo: uno de
+ * {@link DGII_ESTADOS}. Vocabulario completo de la DGII, distinto del
+ * `estado` binario (ACTIVO/INACTIVO) que exponen el scraping y el SOAP.
+ */
+type DgiiEstado = (typeof DGII_ESTADOS)[number];
 
 /**
  * Descarga el archivo masivo DGII_RNC.zip desde el portal de la DGII.
@@ -20,11 +40,34 @@ declare const DGII_BULK_URL: string;
 declare function downloadBulkFile(options: DownloadOptions): Promise<string>;
 
 /**
- * Parsea el archivo TXT de contribuyentes extraido de DGII_RNC.zip.
+ * Parsea el archivo TXT de contribuyentes extraído de DGII_RNC.zip.
+ *
+ * El archivo usa delimitador pipe (|) con 11 columnas y viene codificado
+ * en latin-1 (ISO-8859-1); leerlo como UTF-8 corrompe los nombres con
+ * ñ/acentos (p. ej. MUÑOZ, PEÑA). Usa {@link ParseOptions.encoding} para
+ * anular la codificación si una futura versión del archivo cambia.
+ *
+ * Layout verificado contra el archivo en producción (~778k filas):
+ *
+ *   col  0   rnc                (100% dígitos)
+ *   col  1   nombre             (razón social)
+ *   col  2   nombreComercial
+ *   col  3   actividad
+ *   col  4-7 reservadas/vacías en el archivo actual
+ *   col  8   fechaConstitucion  (dd/mm/yyyy)
+ *   col  9   estado             (ACTIVO / SUSPENDIDO / DADO DE BAJA / ...)
+ *   col 10   regimen            (NORMAL / RST / PST)
+ *
+ * `estado` se normaliza a mayúsculas para que coincida con
+ * {@link DGII_ESTADOS} sin importar la capitalización de la fuente.
  *
- * El archivo usa delimitador pipe (|) con 9 columnas.
- * Los registros pueden tener espacios dobles que se limpian.
+ * Las filas cuyo número de columnas no sea exactamente 11 se descartan por
+ * malformadas (formato viejo más corto, o una columna añadida/insertada).
+ * Si el archivo trae filas pero la mayoría de la muestra no trae un
+ * `estado` reconocido, se lanza {@link BulkFormatError}: un cambio de
+ * layout de la DGII debe fallar ruidosamente en vez de devolver `estado`
+ * vacío o mapeado a la columna equivocada en silencio.
  */
 declare function parseBulkFile(options: ParseOptions): Promise<BulkContribuyente[]>;
 
-export { BulkContribuyente, DGII_BULK_URL, type DownloadOptions, type ParseOptions, downloadBulkFile, parseBulkFile };
+export { BulkContribuyente, DGII_BULK_URL, DGII_ESTADOS, type DgiiEstado, type DownloadOptions, type ParseOptions, downloadBulkFile, parseBulkFile };

package/dist/bulk.d.ts

@@ -1,4 +1,5 @@
-import { B as BulkContribuyente } from './index-BE6Wfozd.js';
+import { B as BulkContribuyente } from './index-BPvMDXya.js';
+export { BulkFormatError } from './errors.js';
 
 interface DownloadOptions {
     /** Directorio de destino para el archivo ZIP */
@@ -9,8 +10,27 @@ interface DownloadOptions {
 interface ParseOptions {
     /** Ruta al archivo TXT extraído del ZIP */
     filePath: string;
+    /**
+     * Codificación del archivo. La DGII publica el TXT en latin-1
+     * (ISO-8859-1), que es el valor por defecto. Permite anularla si una
+     * futura versión del archivo llega en otra codificación (p. ej. UTF-8).
+     */
+    encoding?: BufferEncoding;
 }
 declare const DGII_BULK_URL: string;
+/**
+ * Valores conocidos de la columna `estado` (col 9) en el archivo masivo,
+ * verificados contra ~778k filas en producción. El parser usa este
+ * vocabulario para detectar un cambio de layout: si ninguna fila de una
+ * muestra trae un `estado` reconocido, el formato de la DGII cambió.
+ */
+declare const DGII_ESTADOS: readonly ["ACTIVO", "SUSPENDIDO", "DADO DE BAJA", "CESE TEMPORAL", "ANULADO", "RECHAZADO"];
+/**
+ * Valor de la columna `estado` del archivo masivo: uno de
+ * {@link DGII_ESTADOS}. Vocabulario completo de la DGII, distinto del
+ * `estado` binario (ACTIVO/INACTIVO) que exponen el scraping y el SOAP.
+ */
+type DgiiEstado = (typeof DGII_ESTADOS)[number];
 
 /**
  * Descarga el archivo masivo DGII_RNC.zip desde el portal de la DGII.
@@ -20,11 +40,34 @@ declare const DGII_BULK_URL: string;
 declare function downloadBulkFile(options: DownloadOptions): Promise<string>;
 
 /**
- * Parsea el archivo TXT de contribuyentes extraido de DGII_RNC.zip.
+ * Parsea el archivo TXT de contribuyentes extraído de DGII_RNC.zip.
+ *
+ * El archivo usa delimitador pipe (|) con 11 columnas y viene codificado
+ * en latin-1 (ISO-8859-1); leerlo como UTF-8 corrompe los nombres con
+ * ñ/acentos (p. ej. MUÑOZ, PEÑA). Usa {@link ParseOptions.encoding} para
+ * anular la codificación si una futura versión del archivo cambia.
+ *
+ * Layout verificado contra el archivo en producción (~778k filas):
+ *
+ *   col  0   rnc                (100% dígitos)
+ *   col  1   nombre             (razón social)
+ *   col  2   nombreComercial
+ *   col  3   actividad
+ *   col  4-7 reservadas/vacías en el archivo actual
+ *   col  8   fechaConstitucion  (dd/mm/yyyy)
+ *   col  9   estado             (ACTIVO / SUSPENDIDO / DADO DE BAJA / ...)
+ *   col 10   regimen            (NORMAL / RST / PST)
+ *
+ * `estado` se normaliza a mayúsculas para que coincida con
+ * {@link DGII_ESTADOS} sin importar la capitalización de la fuente.
  *
- * El archivo usa delimitador pipe (|) con 9 columnas.
- * Los registros pueden tener espacios dobles que se limpian.
+ * Las filas cuyo número de columnas no sea exactamente 11 se descartan por
+ * malformadas (formato viejo más corto, o una columna añadida/insertada).
+ * Si el archivo trae filas pero la mayoría de la muestra no trae un
+ * `estado` reconocido, se lanza {@link BulkFormatError}: un cambio de
+ * layout de la DGII debe fallar ruidosamente en vez de devolver `estado`
+ * vacío o mapeado a la columna equivocada en silencio.
  */
 declare function parseBulkFile(options: ParseOptions): Promise<BulkContribuyente[]>;
 
-export { BulkContribuyente, DGII_BULK_URL, type DownloadOptions, type ParseOptions, downloadBulkFile, parseBulkFile };
+export { BulkContribuyente, DGII_BULK_URL, DGII_ESTADOS, type DgiiEstado, type DownloadOptions, type ParseOptions, downloadBulkFile, parseBulkFile };

package/dist/bulk.js

@@ -1,11 +1,17 @@
 import {
   DGII_BULK_URL,
+  DGII_ESTADOS,
   downloadBulkFile,
   parseBulkFile
-} from "./chunk-KIS7MVIW.js";
+} from "./chunk-Z72T6CZG.js";
 import "./chunk-D26S6EXD.js";
+import {
+  BulkFormatError
+} from "./chunk-IRQX4WNQ.js";
 export {
+  BulkFormatError,
   DGII_BULK_URL,
+  DGII_ESTADOS,
   downloadBulkFile,
   parseBulkFile
 };

package/dist/{chunk-5FZ4F5UR.cjs → chunk-6ZRPVQPP.cjs}

@@ -1,15 +1,15 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkJBKAE66Ccjs = require('./chunk-JBKAE66C.cjs');
+var _chunkDLB5RJ7Ecjs = require('./chunk-DLB5RJ7E.cjs');
 
 
-var _chunkBQPH3JDZcjs = require('./chunk-BQPH3JDZ.cjs');
+var _chunkFRM5XREFcjs = require('./chunk-FRM5XREF.cjs');
 
 
 
 
 
-var _chunk7RJWFPCZcjs = require('./chunk-7RJWFPCZ.cjs');
+var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
 
 // src/client/circuit-breaker.ts
 var DEFAULT_CIRCUIT_BREAKER_OPTIONS = /* @__PURE__ */ Object.freeze({
@@ -39,7 +39,7 @@ var ConsecutiveBreaker = class {
   async execute(fn) {
     const currentState = this.state;
     if (currentState === "OPEN") {
-      throw new (0, _chunk7RJWFPCZcjs.DgiiServiceError)(
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
         "Circuito abierto: estrategia deshabilitada temporalmente"
       );
     }
@@ -89,9 +89,9 @@ var DEFAULT_RETRY_OPTIONS = /* @__PURE__ */ Object.freeze({
   maxDelayMs: 1e4
 });
 function isRetryableError(error) {
-  if (error instanceof _chunk7RJWFPCZcjs.DgiiNotFoundError) return false;
-  if (error instanceof _chunk7RJWFPCZcjs.DgiiConnectionError) return true;
-  if (error instanceof _chunk7RJWFPCZcjs.DgiiServiceError) {
+  if (error instanceof _chunkNASWEFHNcjs.DgiiNotFoundError) return false;
+  if (error instanceof _chunkNASWEFHNcjs.DgiiConnectionError) return true;
+  if (error instanceof _chunkNASWEFHNcjs.DgiiServiceError) {
     const code = error.statusCode;
     if (code !== void 0 && code >= 500) return true;
     return false;
@@ -123,10 +123,10 @@ async function withRetry(fn, options = DEFAULT_RETRY_OPTIONS) {
 var DgiiClient = class {
   constructor(options) {
     const timeout = _optionalChain([options, 'optionalAccess', _ => _.timeout]);
-    this._scraping = new (0, _chunkBQPH3JDZcjs.ScrapingClient)(
+    this._scraping = new (0, _chunkFRM5XREFcjs.ScrapingClient)(
       timeout ? { timeout } : void 0
     );
-    this._soap = new (0, _chunkJBKAE66Ccjs.DgiiSoapClient)(
+    this._soap = new (0, _chunkDLB5RJ7Ecjs.DgiiSoapClient)(
       timeout ? { timeout } : void 0
     );
     this._scrapingBreaker = new ConsecutiveBreaker(
@@ -150,11 +150,16 @@ var DgiiClient = class {
     );
   }
   /**
-   * Valida un comprobante fiscal (NCF) contra la DGII.
+   * Valida un comprobante fiscal contra la DGII.
+   *
+   * @param rnc - RNC del emisor
+   * @param ncf - NCF o e-NCF a validar
+   * @param options - Datos adicionales del e-NCF (`rncComprador`,
+   *   `codigoSeguridad`). Se ignoran cuando `ncf` no es un e-NCF válido.
    */
-  async getNCF(rnc, ncf) {
+  async getNCF(rnc, ncf, options) {
     return this._executeWithFallback(
-      (client) => client.getNCF(rnc, ncf)
+      (client) => client.getNCF(rnc, ncf, options)
     );
   }
   async _executeWithFallback(operation) {
@@ -167,7 +172,7 @@ var DgiiClient = class {
         )
       );
     } catch (error) {
-      if (error instanceof _chunk7RJWFPCZcjs.DgiiNotFoundError) throw error;
+      if (error instanceof _chunkNASWEFHNcjs.DgiiNotFoundError) throw error;
       errors.push(error instanceof Error ? error : new Error(String(error)));
     }
     if (this._soapFallback) {
@@ -179,11 +184,11 @@ var DgiiClient = class {
           )
         );
       } catch (error) {
-        if (error instanceof _chunk7RJWFPCZcjs.DgiiNotFoundError) throw error;
+        if (error instanceof _chunkNASWEFHNcjs.DgiiNotFoundError) throw error;
         errors.push(error instanceof Error ? error : new Error(String(error)));
       }
     }
-    throw new (0, _chunk7RJWFPCZcjs.AllStrategiesFailedError)(
+    throw new (0, _chunkNASWEFHNcjs.AllStrategiesFailedError)(
       `Todas las estrategias de consulta fallaron. \xDAltimo error: ${_nullishCoalesce(_optionalChain([errors, 'access', _6 => _6[errors.length - 1], 'optionalAccess', _7 => _7.message]), () => ( "desconocido"))}`,
       errors
     );

package/dist/{chunk-HRRYZUKI.js → chunk-7ILLRYE4.js}

@@ -1,6 +1,9 @@
+import {
+  validateEcf
+} from "./chunk-H42U4GI5.js";
 import {
   wrapFetchError
-} from "./chunk-53A7IG4Y.js";
+} from "./chunk-KW4ZV6FJ.js";
 import {
   collapseSpaces,
   stripNonDigits
@@ -8,7 +11,7 @@ import {
 import {
   DgiiNotFoundError,
   DgiiServiceError
-} from "./chunk-DMGDJEUY.js";
+} from "./chunk-IRQX4WNQ.js";
 
 // src/scraping/endpoints.ts
 var DGII_RNC_URL = "https://dgii.gov.do/app/WebApps/ConsultasWeb2/ConsultasWeb/consultas/rnc.aspx";
@@ -21,10 +24,24 @@ var FORM_FIELDS = /* @__PURE__ */ Object.freeze({
   rncSubmit: "ctl00$cphMain$btnBuscarPorRNC",
   ncfRncInput: "ctl00$cphMain$txtRNC",
   ncfInput: "ctl00$cphMain$txtNCF",
-  ncfSubmit: "ctl00$cphMain$btnConsultar"
+  ncfSubmit: "ctl00$cphMain$btnConsultar",
+  // Campos adicionales para e-NCF (serie E)
+  ncfRncCompradorInput: "ctl00$cphMain$txtRncComprador",
+  ncfCodigoSeguridadInput: "ctl00$cphMain$txtCodigoSeg"
 });
 
 // src/scraping/html-parser.ts
+var NCF_INVALID_PHRASES = /* @__PURE__ */ Object.freeze([
+  "no es v",
+  "no se encuentra",
+  "no existe",
+  // Respuesta de la DGII a un e-NCF con código de seguridad incorrecto
+  "no encontrado"
+]);
+function isKnownInvalidMessage(message) {
+  const normalized = message.toLowerCase();
+  return NCF_INVALID_PHRASES.some((phrase) => normalized.includes(phrase));
+}
 function extractViewStateTokens(html) {
   const viewState = extractInputValue(html, "__VIEWSTATE");
   const viewStateGenerator = extractInputValue(html, "__VIEWSTATEGENERATOR");
@@ -91,7 +108,7 @@ function parseNcfHtml(html) {
     const infoEnd = html.indexOf("</span>", infoStart);
     if (infoEnd !== -1) {
       const infoBlock = html.slice(infoStart, infoEnd);
-      if (infoBlock.includes("no es v") || infoBlock.includes("no se encuentra") || infoBlock.includes("no existe")) {
+      if (isKnownInvalidMessage(infoBlock)) {
         return { valid: false, rnc: "", ncf: "", nombreComercial: void 0 };
       }
     }
@@ -121,6 +138,58 @@ function parseNcfHtml(html) {
     nombreComercial: nombreComercial ? collapseSpaces(nombreComercial) : void 0
   };
 }
+function parseEcfHtml(html) {
+  const info = extractSpanValue(html, "cphMain_lblInformacion");
+  if (info && isKnownInvalidMessage(info)) {
+    return { valid: false, rnc: "", ncf: "" };
+  }
+  if (info) {
+    throw new DgiiServiceError(`La DGII respondi\xF3: ${info}`);
+  }
+  if (!html.includes("cphMain_PResultadoFE")) {
+    throw new DgiiServiceError(
+      "Formato de respuesta HTML inesperado: panel de resultado e-NCF no encontrado"
+    );
+  }
+  const rncEmisor = extractSpanValue(html, "cphMain_lblrncemisor");
+  const ncf = extractSpanValue(html, "cphMain_lblencf");
+  if (!rncEmisor && !ncf) {
+    throw new DgiiServiceError(
+      "Formato de respuesta HTML inesperado: panel e-NCF sin emisor ni e-NCF"
+    );
+  }
+  const rncComprador = extractSpanValue(html, "cphMain_lblrnccomprador");
+  const codigoSeguridad = extractSpanValue(html, "cphMain_lblCodSeguridad");
+  const estado = extractSpanValue(html, "cphMain_lblEstadoFe");
+  const fechaEmision = extractSpanValue(html, "cphMain_lblFechaEmision");
+  const fechaFirma = extractSpanValue(html, "cphMain_lblFechaFirma");
+  return {
+    valid: true,
+    rnc: stripNonDigits(rncEmisor),
+    ncf: collapseSpaces(ncf),
+    rncComprador: rncComprador ? stripNonDigits(rncComprador) : void 0,
+    codigoSeguridad: codigoSeguridad || void 0,
+    estado: estado || void 0,
+    montoTotal: parseAmount(extractSpanValue(html, "cphMain_lblMontoTotal")),
+    totalItbis: parseAmount(extractSpanValue(html, "cphMain_lblTotalItbis")),
+    fechaEmision: fechaEmision || void 0,
+    fechaFirma: fechaFirma || void 0
+  };
+}
+function parseAmount(raw) {
+  if (!raw) return void 0;
+  const value = Number(raw.replace(/,/g, ""));
+  return Number.isFinite(value) ? value : void 0;
+}
+function extractSpanValue(html, spanId) {
+  const idx = html.indexOf(`id="${spanId}"`);
+  if (idx === -1) return "";
+  const tagEnd = html.indexOf(">", idx);
+  if (tagEnd === -1) return "";
+  const closeTag = html.indexOf("</span>", tagEnd);
+  if (closeTag === -1) return "";
+  return decodeHtmlEntities(stripHtmlTags(html.slice(tagEnd + 1, closeTag)));
+}
 function extractInputValue(html, name) {
   let idx = html.indexOf(`id="${name}"`);
   if (idx === -1) {
@@ -201,26 +270,60 @@ var ScrapingClient = class {
     return parseContribuyenteHtml(html);
   }
   /**
-   * Valida un comprobante fiscal (NCF) contra la DGII.
+   * Valida un comprobante fiscal contra la DGII.
+   *
+   * Soporta NCF (serie B) y e-NCF (serie E). Para un e-NCF la DGII
+   * exige el RNC del comprador; sin él responde con un mensaje de campo
+   * requerido y este método lanza `DgiiServiceError`.
+   *
+   * @param rnc - RNC del emisor
+   * @param ncf - NCF o e-NCF a validar
+   * @param options - Datos adicionales del e-NCF (`rncComprador`,
+   *   `codigoSeguridad`). Se ignoran cuando `ncf` no es un e-NCF válido.
    */
-  async getNCF(rnc, ncf) {
+  async getNCF(rnc, ncf, options) {
     if (typeof rnc !== "string" || rnc.trim() === "") {
       throw new DgiiServiceError("El par\xE1metro rnc es requerido");
     }
     if (typeof ncf !== "string" || ncf.trim() === "") {
       throw new DgiiServiceError("El par\xE1metro ncf es requerido");
     }
+    const rncComprador = options?.rncComprador;
+    if (rncComprador !== void 0 && (typeof rncComprador !== "string" || rncComprador.trim() === "")) {
+      throw new DgiiServiceError(
+        "La opci\xF3n rncComprador debe ser un string no vac\xEDo"
+      );
+    }
+    const codigoSeguridad = options?.codigoSeguridad;
+    if (codigoSeguridad !== void 0 && (typeof codigoSeguridad !== "string" || codigoSeguridad.trim() === "")) {
+      throw new DgiiServiceError(
+        "La opci\xF3n codigoSeguridad debe ser un string no vac\xEDo"
+      );
+    }
+    const isEcf = validateEcf(ncf).valid;
     const tokens = await this._fetchTokens(this._ncfUrl);
-    const body = buildFormBody([
+    const fields = [
       [FORM_FIELDS.viewState, tokens.viewState],
       [FORM_FIELDS.viewStateGenerator, tokens.viewStateGenerator],
       [FORM_FIELDS.eventValidation, tokens.eventValidation],
       [FORM_FIELDS.ncfRncInput, rnc.trim()],
-      [FORM_FIELDS.ncfInput, ncf.trim()],
-      [FORM_FIELDS.ncfSubmit, "Buscar"]
-    ]);
+      [FORM_FIELDS.ncfInput, ncf.trim()]
+    ];
+    if (isEcf) {
+      if (rncComprador !== void 0) {
+        fields.push([FORM_FIELDS.ncfRncCompradorInput, rncComprador.trim()]);
+      }
+      if (codigoSeguridad !== void 0) {
+        fields.push([
+          FORM_FIELDS.ncfCodigoSeguridadInput,
+          codigoSeguridad.trim()
+        ]);
+      }
+    }
+    fields.push([FORM_FIELDS.ncfSubmit, "Buscar"]);
+    const body = buildFormBody(fields);
     const html = await this._post(this._ncfUrl, body);
-    return parseNcfHtml(html);
+    return isEcf ? parseEcfHtml(html) : parseNcfHtml(html);
   }
   async _fetchTokens(url) {
     let response;