dgii-ts 0.1.3 → 0.2.1

package/README.en.md

@@ -135,9 +135,43 @@ 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: `ScrapingClient.getNCF` throws
+`DgiiServiceError` and `DgiiClient.getNCF` wraps it in
+`AllStrategiesFailedError` after exhausting retries and the fallback
+(the message keeps DGII's text). 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 +189,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 +197,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)
 

package/README.md

@@ -138,9 +138,45 @@ 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: `ScrapingClient.getNCF`
+lanza `DgiiServiceError` y `DgiiClient.getNCF` lo envuelve en
+`AllStrategiesFailedError` tras agotar reintentos y fallback (el
+mensaje conserva el texto de la DGII). 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 +194,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 +202,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)
 

package/dist/bulk.d.cts

@@ -1,4 +1,4 @@
-import { B as BulkContribuyente } from './index-KNOaUG34.cjs';
+import { B as BulkContribuyente } from './index-BPvMDXya.cjs';
 export { BulkFormatError } from './errors.cjs';
 
 interface DownloadOptions {

package/dist/bulk.d.ts

@@ -1,4 +1,4 @@
-import { B as BulkContribuyente } from './index-KNOaUG34.js';
+import { B as BulkContribuyente } from './index-BPvMDXya.js';
 export { BulkFormatError } from './errors.js';
 
 interface DownloadOptions {

package/dist/{chunk-KJXLES3I.js → chunk-ABNHQAWP.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-QTN5ZT4P.js";
 import {
   ScrapingClient
-} from "./chunk-YTX4QOLE.js";
+} from "./chunk-KMSKQH4U.js";
 import {
   AllStrategiesFailedError,
   DgiiConnectionError,
@@ -150,11 +150,21 @@ 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.
+   *
+   * Para un e-NCF sin `rncComprador` la DGII responde con un mensaje de
+   * campo requerido: `ScrapingClient.getNCF` lanza `DgiiServiceError` y
+   * este método lo envuelve en `AllStrategiesFailedError` tras agotar
+   * reintentos y fallback (el mensaje conserva el texto de la DGII).
    */
-  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) {

package/dist/{chunk-AML7LZBU.cjs → chunk-D6DU6PD3.cjs}

@@ -1,5 +1,8 @@
 "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 _chunkOSGHCQFAcjs = require('./chunk-OSGHCQFA.cjs');
+
+
 var _chunkWMFHPNFPcjs = require('./chunk-WMFHPNFP.cjs');
 
 
@@ -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 ? _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, 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 (0, _chunkNASWEFHNcjs.DgiiServiceError)(`La DGII respondi\xF3: ${info}`);
+  }
+  if (!html.includes("cphMain_PResultadoFE")) {
+    throw new (0, _chunkNASWEFHNcjs.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 (0, _chunkNASWEFHNcjs.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: _chunkQH4BK5X3cjs.stripNonDigits.call(void 0, rncEmisor),
+    ncf: _chunkQH4BK5X3cjs.collapseSpaces.call(void 0, ncf),
+    rncComprador: rncComprador ? _chunkQH4BK5X3cjs.stripNonDigits.call(void 0, 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) {
@@ -141,13 +210,13 @@ function extractTableFields(tableHtml) {
   const fields = /* @__PURE__ */ new Map();
   for (const match of tableHtml.matchAll(BOLD_STYLE_PATTERN)) {
     const label = normalizeLabel(_nullishCoalesce(match[1], () => ( "")));
-    const value = stripHtmlTags(_nullishCoalesce(match[2], () => ( "")));
+    const value = decodeHtmlEntities(stripHtmlTags(_nullishCoalesce(match[2], () => ( ""))));
     if (label) fields.set(label, value);
   }
   if (fields.size === 0) {
     for (const match of tableHtml.matchAll(BOLD_TAG_PATTERN)) {
       const label = normalizeLabel(_nullishCoalesce(match[1], () => ( "")));
-      const value = stripHtmlTags(_nullishCoalesce(match[2], () => ( "")));
+      const value = decodeHtmlEntities(stripHtmlTags(_nullishCoalesce(match[2], () => ( ""))));
       if (label) fields.set(label, value);
     }
   }
@@ -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 (0, _chunkNASWEFHNcjs.DgiiServiceError)("El par\xE1metro rnc es requerido");
     }
     if (typeof ncf !== "string" || ncf.trim() === "") {
       throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)("El par\xE1metro ncf es requerido");
     }
+    const rncComprador = _optionalChain([options, 'optionalAccess', _6 => _6.rncComprador]);
+    if (rncComprador !== void 0 && (typeof rncComprador !== "string" || rncComprador.trim() === "")) {
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
+        "La opci\xF3n rncComprador debe ser un string no vac\xEDo"
+      );
+    }
+    const codigoSeguridad = _optionalChain([options, 'optionalAccess', _7 => _7.codigoSeguridad]);
+    if (codigoSeguridad !== void 0 && (typeof codigoSeguridad !== "string" || codigoSeguridad.trim() === "")) {
+      throw new (0, _chunkNASWEFHNcjs.DgiiServiceError)(
+        "La opci\xF3n codigoSeguridad debe ser un string no vac\xEDo"
+      );
+    }
+    const isEcf = _chunkOSGHCQFAcjs.validateEcf.call(void 0, 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;

package/dist/chunk-H42U4GI5.js

@@ -0,0 +1,49 @@
+// src/validators/ecf.ts
+var ECF_TYPES = /* @__PURE__ */ Object.freeze({
+  "31": "CREDITO_FISCAL_ELECTRONICA",
+  "32": "CONSUMO_ELECTRONICA",
+  "33": "NOTA_DE_DEBITO_ELECTRONICA",
+  "34": "NOTA_DE_CREDITO_ELECTRONICA",
+  "41": "COMPRAS_ELECTRONICO",
+  "43": "GASTOS_MENORES_ELECTRONICO",
+  "44": "REGIMENES_ESPECIALES_ELECTRONICO",
+  "45": "GUBERNAMENTAL_ELECTRONICO",
+  "46": "EXPORTACIONES_ELECTRONICO",
+  "47": "PAGOS_AL_EXTERIOR_ELECTRONICO"
+});
+var ECF_TYPE_NAMES = /* @__PURE__ */ Object.freeze({
+  "31": "Factura de cr\xE9dito fiscal electr\xF3nica",
+  "32": "Factura de consumo electr\xF3nica",
+  "33": "Nota de d\xE9bito electr\xF3nica",
+  "34": "Nota de cr\xE9dito electr\xF3nica",
+  "41": "Comprobante electr\xF3nico de compras",
+  "43": "Comprobante electr\xF3nico para gastos menores",
+  "44": "Comprobante electr\xF3nico para reg\xEDmenes especiales",
+  "45": "Comprobante electr\xF3nico gubernamental",
+  "46": "Comprobante electr\xF3nico para exportaciones",
+  "47": "Comprobante electr\xF3nico para pagos al exterior"
+});
+var ECF_PATTERN = /^E(\d{2})(\d{10})$/;
+function validateEcf(value) {
+  if (typeof value !== "string") return { valid: false };
+  const normalized = value.toUpperCase().trim();
+  const match = ECF_PATTERN.exec(normalized);
+  if (!match) {
+    return { valid: false };
+  }
+  const typeCode = match[1];
+  const type = ECF_TYPES[typeCode];
+  if (!type) {
+    return { valid: false };
+  }
+  return {
+    valid: true,
+    type,
+    serie: `E${typeCode}`
+  };
+}
+
+export {
+  ECF_TYPE_NAMES,
+  validateEcf
+};

package/dist/{chunk-YTX4QOLE.js → chunk-KMSKQH4U.js}

@@ -1,3 +1,6 @@
+import {
+  validateEcf
+} from "./chunk-H42U4GI5.js";
 import {
   wrapFetchError
 } from "./chunk-KW4ZV6FJ.js";
@@ -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) {
@@ -141,13 +210,13 @@ function extractTableFields(tableHtml) {
   const fields = /* @__PURE__ */ new Map();
   for (const match of tableHtml.matchAll(BOLD_STYLE_PATTERN)) {
     const label = normalizeLabel(match[1] ?? "");
-    const value = stripHtmlTags(match[2] ?? "");
+    const value = decodeHtmlEntities(stripHtmlTags(match[2] ?? ""));
     if (label) fields.set(label, value);
   }
   if (fields.size === 0) {
     for (const match of tableHtml.matchAll(BOLD_TAG_PATTERN)) {
       const label = normalizeLabel(match[1] ?? "");
-      const value = stripHtmlTags(match[2] ?? "");
+      const value = decodeHtmlEntities(stripHtmlTags(match[2] ?? ""));
       if (label) fields.set(label, value);
     }
   }
@@ -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;

package/dist/chunk-OSGHCQFA.cjs

@@ -0,0 +1,49 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/validators/ecf.ts
+var ECF_TYPES = /* @__PURE__ */ Object.freeze({
+  "31": "CREDITO_FISCAL_ELECTRONICA",
+  "32": "CONSUMO_ELECTRONICA",
+  "33": "NOTA_DE_DEBITO_ELECTRONICA",
+  "34": "NOTA_DE_CREDITO_ELECTRONICA",
+  "41": "COMPRAS_ELECTRONICO",
+  "43": "GASTOS_MENORES_ELECTRONICO",
+  "44": "REGIMENES_ESPECIALES_ELECTRONICO",
+  "45": "GUBERNAMENTAL_ELECTRONICO",
+  "46": "EXPORTACIONES_ELECTRONICO",
+  "47": "PAGOS_AL_EXTERIOR_ELECTRONICO"
+});
+var ECF_TYPE_NAMES = /* @__PURE__ */ Object.freeze({
+  "31": "Factura de cr\xE9dito fiscal electr\xF3nica",
+  "32": "Factura de consumo electr\xF3nica",
+  "33": "Nota de d\xE9bito electr\xF3nica",
+  "34": "Nota de cr\xE9dito electr\xF3nica",
+  "41": "Comprobante electr\xF3nico de compras",
+  "43": "Comprobante electr\xF3nico para gastos menores",
+  "44": "Comprobante electr\xF3nico para reg\xEDmenes especiales",
+  "45": "Comprobante electr\xF3nico gubernamental",
+  "46": "Comprobante electr\xF3nico para exportaciones",
+  "47": "Comprobante electr\xF3nico para pagos al exterior"
+});
+var ECF_PATTERN = /^E(\d{2})(\d{10})$/;
+function validateEcf(value) {
+  if (typeof value !== "string") return { valid: false };
+  const normalized = value.toUpperCase().trim();
+  const match = ECF_PATTERN.exec(normalized);
+  if (!match) {
+    return { valid: false };
+  }
+  const typeCode = match[1];
+  const type = ECF_TYPES[typeCode];
+  if (!type) {
+    return { valid: false };
+  }
+  return {
+    valid: true,
+    type,
+    serie: `E${typeCode}`
+  };
+}
+
+
+
+
+exports.ECF_TYPE_NAMES = ECF_TYPE_NAMES; exports.validateEcf = validateEcf;

package/dist/{chunk-MUAPXS3H.cjs → chunk-QWP5FSCN.cjs}

@@ -3,7 +3,7 @@
 var _chunkDLB5RJ7Ecjs = require('./chunk-DLB5RJ7E.cjs');
 
 
-var _chunkAML7LZBUcjs = require('./chunk-AML7LZBU.cjs');
+var _chunkD6DU6PD3cjs = require('./chunk-D6DU6PD3.cjs');
 
 
 
@@ -123,7 +123,7 @@ async function withRetry(fn, options = DEFAULT_RETRY_OPTIONS) {
 var DgiiClient = class {
   constructor(options) {
     const timeout = _optionalChain([options, 'optionalAccess', _ => _.timeout]);
-    this._scraping = new (0, _chunkAML7LZBUcjs.ScrapingClient)(
+    this._scraping = new (0, _chunkD6DU6PD3cjs.ScrapingClient)(
       timeout ? { timeout } : void 0
     );
     this._soap = new (0, _chunkDLB5RJ7Ecjs.DgiiSoapClient)(
@@ -150,11 +150,21 @@ 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.
+   *
+   * Para un e-NCF sin `rncComprador` la DGII responde con un mensaje de
+   * campo requerido: `ScrapingClient.getNCF` lanza `DgiiServiceError` y
+   * este método lo envuelve en `AllStrategiesFailedError` tras agotar
+   * reintentos y fallback (el mensaje conserva el texto de la DGII).
    */
-  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) {

package/dist/{chunk-TZC6RSWL.js → chunk-RTI3CLHV.js}

@@ -729,56 +729,9 @@ function validateNcf(value) {
   };
 }
 
-// src/validators/ecf.ts
-var ECF_TYPES = /* @__PURE__ */ Object.freeze({
-  "31": "CREDITO_FISCAL_ELECTRONICA",
-  "32": "CONSUMO_ELECTRONICA",
-  "33": "NOTA_DE_DEBITO_ELECTRONICA",
-  "34": "NOTA_DE_CREDITO_ELECTRONICA",
-  "41": "COMPRAS_ELECTRONICO",
-  "43": "GASTOS_MENORES_ELECTRONICO",
-  "44": "REGIMENES_ESPECIALES_ELECTRONICO",
-  "45": "GUBERNAMENTAL_ELECTRONICO",
-  "46": "EXPORTACIONES_ELECTRONICO",
-  "47": "PAGOS_AL_EXTERIOR_ELECTRONICO"
-});
-var ECF_TYPE_NAMES = /* @__PURE__ */ Object.freeze({
-  "31": "Factura de cr\xE9dito fiscal electr\xF3nica",
-  "32": "Factura de consumo electr\xF3nica",
-  "33": "Nota de d\xE9bito electr\xF3nica",
-  "34": "Nota de cr\xE9dito electr\xF3nica",
-  "41": "Comprobante electr\xF3nico de compras",
-  "43": "Comprobante electr\xF3nico para gastos menores",
-  "44": "Comprobante electr\xF3nico para reg\xEDmenes especiales",
-  "45": "Comprobante electr\xF3nico gubernamental",
-  "46": "Comprobante electr\xF3nico para exportaciones",
-  "47": "Comprobante electr\xF3nico para pagos al exterior"
-});
-var ECF_PATTERN = /^E(\d{2})(\d{10})$/;
-function validateEcf(value) {
-  if (typeof value !== "string") return { valid: false };
-  const normalized = value.toUpperCase().trim();
-  const match = ECF_PATTERN.exec(normalized);
-  if (!match) {
-    return { valid: false };
-  }
-  const typeCode = match[1];
-  const type = ECF_TYPES[typeCode];
-  if (!type) {
-    return { valid: false };
-  }
-  return {
-    valid: true,
-    type,
-    serie: `E${typeCode}`
-  };
-}
-
 export {
   validateRnc,
   validateCedula,
   NCF_TYPE_NAMES,
-  validateNcf,
-  ECF_TYPE_NAMES,
-  validateEcf
+  validateNcf
 };

package/dist/{chunk-SUSDEKID.cjs → chunk-UW6W2JHW.cjs}

@@ -729,56 +729,9 @@ function validateNcf(value) {
   };
 }
 
-// src/validators/ecf.ts
-var ECF_TYPES = /* @__PURE__ */ Object.freeze({
-  "31": "CREDITO_FISCAL_ELECTRONICA",
-  "32": "CONSUMO_ELECTRONICA",
-  "33": "NOTA_DE_DEBITO_ELECTRONICA",
-  "34": "NOTA_DE_CREDITO_ELECTRONICA",
-  "41": "COMPRAS_ELECTRONICO",
-  "43": "GASTOS_MENORES_ELECTRONICO",
-  "44": "REGIMENES_ESPECIALES_ELECTRONICO",
-  "45": "GUBERNAMENTAL_ELECTRONICO",
-  "46": "EXPORTACIONES_ELECTRONICO",
-  "47": "PAGOS_AL_EXTERIOR_ELECTRONICO"
-});
-var ECF_TYPE_NAMES = /* @__PURE__ */ Object.freeze({
-  "31": "Factura de cr\xE9dito fiscal electr\xF3nica",
-  "32": "Factura de consumo electr\xF3nica",
-  "33": "Nota de d\xE9bito electr\xF3nica",
-  "34": "Nota de cr\xE9dito electr\xF3nica",
-  "41": "Comprobante electr\xF3nico de compras",
-  "43": "Comprobante electr\xF3nico para gastos menores",
-  "44": "Comprobante electr\xF3nico para reg\xEDmenes especiales",
-  "45": "Comprobante electr\xF3nico gubernamental",
-  "46": "Comprobante electr\xF3nico para exportaciones",
-  "47": "Comprobante electr\xF3nico para pagos al exterior"
-});
-var ECF_PATTERN = /^E(\d{2})(\d{10})$/;
-function validateEcf(value) {
-  if (typeof value !== "string") return { valid: false };
-  const normalized = value.toUpperCase().trim();
-  const match = ECF_PATTERN.exec(normalized);
-  if (!match) {
-    return { valid: false };
-  }
-  const typeCode = match[1];
-  const type = ECF_TYPES[typeCode];
-  if (!type) {
-    return { valid: false };
-  }
-  return {
-    valid: true,
-    type,
-    serie: `E${typeCode}`
-  };
-}
-
-
-
 
 
 
 
 
-exports.validateRnc = validateRnc; exports.validateCedula = validateCedula; exports.NCF_TYPE_NAMES = NCF_TYPE_NAMES; exports.validateNcf = validateNcf; exports.ECF_TYPE_NAMES = ECF_TYPE_NAMES; exports.validateEcf = validateEcf;
+exports.validateRnc = validateRnc; exports.validateCedula = validateCedula; exports.NCF_TYPE_NAMES = NCF_TYPE_NAMES; exports.validateNcf = validateNcf;

package/dist/client.cjs

@@ -3,9 +3,10 @@
 
 
 
-var _chunkMUAPXS3Hcjs = require('./chunk-MUAPXS3H.cjs');
+var _chunkQWP5FSCNcjs = require('./chunk-QWP5FSCN.cjs');
 require('./chunk-DLB5RJ7E.cjs');
-require('./chunk-AML7LZBU.cjs');
+require('./chunk-D6DU6PD3.cjs');
+require('./chunk-OSGHCQFA.cjs');
 require('./chunk-WMFHPNFP.cjs');
 require('./chunk-QH4BK5X3.cjs');
 require('./chunk-NASWEFHN.cjs');
@@ -14,4 +15,4 @@ require('./chunk-NASWEFHN.cjs');
 
 
 
-exports.ConsecutiveBreaker = _chunkMUAPXS3Hcjs.ConsecutiveBreaker; exports.DgiiClient = _chunkMUAPXS3Hcjs.DgiiClient; exports.isRetryableError = _chunkMUAPXS3Hcjs.isRetryableError; exports.withRetry = _chunkMUAPXS3Hcjs.withRetry;
+exports.ConsecutiveBreaker = _chunkQWP5FSCNcjs.ConsecutiveBreaker; exports.DgiiClient = _chunkQWP5FSCNcjs.DgiiClient; exports.isRetryableError = _chunkQWP5FSCNcjs.isRetryableError; exports.withRetry = _chunkQWP5FSCNcjs.withRetry;

package/dist/client.d.cts

@@ -1,4 +1,4 @@
-import { C as Contribuyente, N as NcfQueryResult } from './index-KNOaUG34.cjs';
+import { C as Contribuyente, N as NcfQueryOptions, a as NcfQueryResult } from './index-BPvMDXya.cjs';
 
 interface RetryOptions {
     /** Número máximo de reintentos (por defecto: 2) */
@@ -86,9 +86,19 @@ declare class DgiiClient {
      */
     getContribuyente(rnc: string): Promise<Contribuyente>;
     /**
-     * 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.
+     *
+     * Para un e-NCF sin `rncComprador` la DGII responde con un mensaje de
+     * campo requerido: `ScrapingClient.getNCF` lanza `DgiiServiceError` y
+     * este método lo envuelve en `AllStrategiesFailedError` tras agotar
+     * reintentos y fallback (el mensaje conserva el texto de la DGII).
      */
-    getNCF(rnc: string, ncf: string): Promise<NcfQueryResult>;
+    getNCF(rnc: string, ncf: string, options?: NcfQueryOptions): Promise<NcfQueryResult>;
     private _executeWithFallback;
 }
 

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { C as Contribuyente, N as NcfQueryResult } from './index-KNOaUG34.js';
+import { C as Contribuyente, N as NcfQueryOptions, a as NcfQueryResult } from './index-BPvMDXya.js';
 
 interface RetryOptions {
     /** Número máximo de reintentos (por defecto: 2) */
@@ -86,9 +86,19 @@ declare class DgiiClient {
      */
     getContribuyente(rnc: string): Promise<Contribuyente>;
     /**
-     * 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.
+     *
+     * Para un e-NCF sin `rncComprador` la DGII responde con un mensaje de
+     * campo requerido: `ScrapingClient.getNCF` lanza `DgiiServiceError` y
+     * este método lo envuelve en `AllStrategiesFailedError` tras agotar
+     * reintentos y fallback (el mensaje conserva el texto de la DGII).
      */
-    getNCF(rnc: string, ncf: string): Promise<NcfQueryResult>;
+    getNCF(rnc: string, ncf: string, options?: NcfQueryOptions): Promise<NcfQueryResult>;
     private _executeWithFallback;
 }
 

package/dist/client.js

@@ -3,9 +3,10 @@ import {
   DgiiClient,
   isRetryableError,
   withRetry
-} from "./chunk-KJXLES3I.js";
+} from "./chunk-ABNHQAWP.js";
 import "./chunk-QTN5ZT4P.js";
-import "./chunk-YTX4QOLE.js";
+import "./chunk-KMSKQH4U.js";
+import "./chunk-H42U4GI5.js";
 import "./chunk-KW4ZV6FJ.js";
 import "./chunk-D26S6EXD.js";
 import "./chunk-IRQX4WNQ.js";

package/dist/{index-KNOaUG34.d.cts → index-BPvMDXya.d.cts}

@@ -38,14 +38,45 @@ interface Contribuyente {
     regimenDePagos?: string;
     administracionLocal?: string;
 }
+/**
+ * Datos adicionales para consultar un e-NCF (serie E) en la DGII.
+ *
+ * La DGII exige el RNC del comprador (o el ID extranjero) para
+ * responder el estado de un e-NCF. Se ignoran al consultar un NCF
+ * de serie B.
+ */
+interface NcfQueryOptions {
+    /** RNC del comprador tal como aparece en la factura. */
+    rncComprador?: string;
+    /** Código de seguridad de 6 caracteres impreso en la factura. */
+    codigoSeguridad?: string;
+}
 /**
  * Resultado de validación de un comprobante fiscal contra la DGII.
+ *
+ * `valid` significa que la DGII encontró el comprobante, no que esté
+ * aceptado: para un e-NCF hay que revisar `estado` (por ejemplo
+ * `Aceptado`).
+ *
+ * Los campos de la sección e-NCF (`rncComprador`, `codigoSeguridad`,
+ * `estado`, `montoTotal`, `totalItbis`, `fechaEmision`, `fechaFirma`)
+ * solo se llenan cuando el comprobante es un e-NCF (serie E).
+ * `nombreComercial` no se llena para la serie E porque la DGII no lo
+ * muestra en esa consulta. `fechaEmision` y `fechaFirma` son strings
+ * exactamente como la DGII los renderiza.
  */
 interface NcfQueryResult {
     valid: boolean;
     rnc: string;
     ncf: string;
     nombreComercial?: string;
+    rncComprador?: string;
+    codigoSeguridad?: string;
+    estado?: string;
+    montoTotal?: number;
+    totalItbis?: number;
+    fechaEmision?: string;
+    fechaFirma?: string;
 }
 /**
  * Registro del archivo masivo de contribuyentes (DGII_RNC.zip).
@@ -67,4 +98,4 @@ interface BulkContribuyente {
     fechaConstitucion: string;
 }
 
-export type { BulkContribuyente as B, Contribuyente as C, NcfQueryResult as N, ValidationResult as V, NcfValidationResult as a };
+export type { BulkContribuyente as B, Contribuyente as C, NcfQueryOptions as N, ValidationResult as V, NcfQueryResult as a, NcfValidationResult as b };

package/dist/{index-KNOaUG34.d.ts → index-BPvMDXya.d.ts}

@@ -38,14 +38,45 @@ interface Contribuyente {
     regimenDePagos?: string;
     administracionLocal?: string;
 }
+/**
+ * Datos adicionales para consultar un e-NCF (serie E) en la DGII.
+ *
+ * La DGII exige el RNC del comprador (o el ID extranjero) para
+ * responder el estado de un e-NCF. Se ignoran al consultar un NCF
+ * de serie B.
+ */
+interface NcfQueryOptions {
+    /** RNC del comprador tal como aparece en la factura. */
+    rncComprador?: string;
+    /** Código de seguridad de 6 caracteres impreso en la factura. */
+    codigoSeguridad?: string;
+}
 /**
  * Resultado de validación de un comprobante fiscal contra la DGII.
+ *
+ * `valid` significa que la DGII encontró el comprobante, no que esté
+ * aceptado: para un e-NCF hay que revisar `estado` (por ejemplo
+ * `Aceptado`).
+ *
+ * Los campos de la sección e-NCF (`rncComprador`, `codigoSeguridad`,
+ * `estado`, `montoTotal`, `totalItbis`, `fechaEmision`, `fechaFirma`)
+ * solo se llenan cuando el comprobante es un e-NCF (serie E).
+ * `nombreComercial` no se llena para la serie E porque la DGII no lo
+ * muestra en esa consulta. `fechaEmision` y `fechaFirma` son strings
+ * exactamente como la DGII los renderiza.
  */
 interface NcfQueryResult {
     valid: boolean;
     rnc: string;
     ncf: string;
     nombreComercial?: string;
+    rncComprador?: string;
+    codigoSeguridad?: string;
+    estado?: string;
+    montoTotal?: number;
+    totalItbis?: number;
+    fechaEmision?: string;
+    fechaFirma?: string;
 }
 /**
  * Registro del archivo masivo de contribuyentes (DGII_RNC.zip).
@@ -67,4 +98,4 @@ interface BulkContribuyente {
     fechaConstitucion: string;
 }
 
-export type { BulkContribuyente as B, Contribuyente as C, NcfQueryResult as N, ValidationResult as V, NcfValidationResult as a };
+export type { BulkContribuyente as B, Contribuyente as C, NcfQueryOptions as N, ValidationResult as V, NcfQueryResult as a, NcfValidationResult as b };

package/dist/index.cjs

@@ -3,9 +3,7 @@
 
 
 
-
-
-var _chunkSUSDEKIDcjs = require('./chunk-SUSDEKID.cjs');
+var _chunkUW6W2JHWcjs = require('./chunk-UW6W2JHW.cjs');
 require('./chunk-QOSGH7F5.cjs');
 
 
@@ -19,7 +17,7 @@ require('./chunk-2ST6QKHA.cjs');
 
 
 
-var _chunkMUAPXS3Hcjs = require('./chunk-MUAPXS3H.cjs');
+var _chunkQWP5FSCNcjs = require('./chunk-QWP5FSCN.cjs');
 
 
 
@@ -29,7 +27,11 @@ var _chunkDLB5RJ7Ecjs = require('./chunk-DLB5RJ7E.cjs');
 
 
 
-var _chunkAML7LZBUcjs = require('./chunk-AML7LZBU.cjs');
+var _chunkD6DU6PD3cjs = require('./chunk-D6DU6PD3.cjs');
+
+
+
+var _chunkOSGHCQFAcjs = require('./chunk-OSGHCQFA.cjs');
 require('./chunk-WMFHPNFP.cjs');
 require('./chunk-QH4BK5X3.cjs');
 
@@ -67,4 +69,4 @@ var _chunkNASWEFHNcjs = require('./chunk-NASWEFHN.cjs');
 
 
 
-exports.AllStrategiesFailedError = _chunkNASWEFHNcjs.AllStrategiesFailedError; exports.BulkFormatError = _chunkNASWEFHNcjs.BulkFormatError; exports.ConsecutiveBreaker = _chunkMUAPXS3Hcjs.ConsecutiveBreaker; exports.DGII_BULK_URL = _chunkVIZWYFHPcjs.DGII_BULK_URL; exports.DGII_ESTADOS = _chunkVIZWYFHPcjs.DGII_ESTADOS; exports.DGII_NCF_URL = _chunkAML7LZBUcjs.DGII_NCF_URL; exports.DGII_RNC_URL = _chunkAML7LZBUcjs.DGII_RNC_URL; exports.DGII_SOAP_BASE_URL = _chunkDLB5RJ7Ecjs.DGII_SOAP_BASE_URL; exports.DgiiClient = _chunkMUAPXS3Hcjs.DgiiClient; exports.DgiiConnectionError = _chunkNASWEFHNcjs.DgiiConnectionError; exports.DgiiError = _chunkNASWEFHNcjs.DgiiError; exports.DgiiNotFoundError = _chunkNASWEFHNcjs.DgiiNotFoundError; exports.DgiiServiceError = _chunkNASWEFHNcjs.DgiiServiceError; exports.DgiiSoapClient = _chunkDLB5RJ7Ecjs.DgiiSoapClient; exports.ECF_TYPE_NAMES = _chunkSUSDEKIDcjs.ECF_TYPE_NAMES; exports.NCF_TYPE_NAMES = _chunkSUSDEKIDcjs.NCF_TYPE_NAMES; exports.SOAP_ACTIONS = _chunkDLB5RJ7Ecjs.SOAP_ACTIONS; exports.ScrapingClient = _chunkAML7LZBUcjs.ScrapingClient; exports.downloadBulkFile = _chunkVIZWYFHPcjs.downloadBulkFile; exports.isRetryableError = _chunkMUAPXS3Hcjs.isRetryableError; exports.parseBulkFile = _chunkVIZWYFHPcjs.parseBulkFile; exports.validateCedula = _chunkSUSDEKIDcjs.validateCedula; exports.validateEcf = _chunkSUSDEKIDcjs.validateEcf; exports.validateNcf = _chunkSUSDEKIDcjs.validateNcf; exports.validateRnc = _chunkSUSDEKIDcjs.validateRnc; exports.withRetry = _chunkMUAPXS3Hcjs.withRetry;
+exports.AllStrategiesFailedError = _chunkNASWEFHNcjs.AllStrategiesFailedError; exports.BulkFormatError = _chunkNASWEFHNcjs.BulkFormatError; exports.ConsecutiveBreaker = _chunkQWP5FSCNcjs.ConsecutiveBreaker; exports.DGII_BULK_URL = _chunkVIZWYFHPcjs.DGII_BULK_URL; exports.DGII_ESTADOS = _chunkVIZWYFHPcjs.DGII_ESTADOS; exports.DGII_NCF_URL = _chunkD6DU6PD3cjs.DGII_NCF_URL; exports.DGII_RNC_URL = _chunkD6DU6PD3cjs.DGII_RNC_URL; exports.DGII_SOAP_BASE_URL = _chunkDLB5RJ7Ecjs.DGII_SOAP_BASE_URL; exports.DgiiClient = _chunkQWP5FSCNcjs.DgiiClient; exports.DgiiConnectionError = _chunkNASWEFHNcjs.DgiiConnectionError; exports.DgiiError = _chunkNASWEFHNcjs.DgiiError; exports.DgiiNotFoundError = _chunkNASWEFHNcjs.DgiiNotFoundError; exports.DgiiServiceError = _chunkNASWEFHNcjs.DgiiServiceError; exports.DgiiSoapClient = _chunkDLB5RJ7Ecjs.DgiiSoapClient; exports.ECF_TYPE_NAMES = _chunkOSGHCQFAcjs.ECF_TYPE_NAMES; exports.NCF_TYPE_NAMES = _chunkUW6W2JHWcjs.NCF_TYPE_NAMES; exports.SOAP_ACTIONS = _chunkDLB5RJ7Ecjs.SOAP_ACTIONS; exports.ScrapingClient = _chunkD6DU6PD3cjs.ScrapingClient; exports.downloadBulkFile = _chunkVIZWYFHPcjs.downloadBulkFile; exports.isRetryableError = _chunkQWP5FSCNcjs.isRetryableError; exports.parseBulkFile = _chunkVIZWYFHPcjs.parseBulkFile; exports.validateCedula = _chunkUW6W2JHWcjs.validateCedula; exports.validateEcf = _chunkOSGHCQFAcjs.validateEcf; exports.validateNcf = _chunkUW6W2JHWcjs.validateNcf; exports.validateRnc = _chunkUW6W2JHWcjs.validateRnc; exports.withRetry = _chunkQWP5FSCNcjs.withRetry;

package/dist/index.d.cts

@@ -4,4 +4,4 @@ export { AllStrategiesFailedError, BulkFormatError, DgiiConnectionError, DgiiErr
 export { DGII_NCF_URL, DGII_RNC_URL, ScrapingClient, ScrapingClientOptions } from './scraping.cjs';
 export { CircuitBreakerOptions, ClientOptions, ConsecutiveBreaker, DgiiClient, RetryOptions, isRetryableError, withRetry } from './client.cjs';
 export { DGII_BULK_URL, DGII_ESTADOS, DgiiEstado, DownloadOptions, ParseOptions, downloadBulkFile, parseBulkFile } from './bulk.cjs';
-export { B as BulkContribuyente, C as Contribuyente, N as NcfQueryResult, a as NcfValidationResult, V as ValidationResult } from './index-KNOaUG34.cjs';
+export { B as BulkContribuyente, C as Contribuyente, N as NcfQueryOptions, a as NcfQueryResult, b as NcfValidationResult, V as ValidationResult } from './index-BPvMDXya.cjs';

package/dist/index.d.ts

@@ -4,4 +4,4 @@ export { AllStrategiesFailedError, BulkFormatError, DgiiConnectionError, DgiiErr
 export { DGII_NCF_URL, DGII_RNC_URL, ScrapingClient, ScrapingClientOptions } from './scraping.js';
 export { CircuitBreakerOptions, ClientOptions, ConsecutiveBreaker, DgiiClient, RetryOptions, isRetryableError, withRetry } from './client.js';
 export { DGII_BULK_URL, DGII_ESTADOS, DgiiEstado, DownloadOptions, ParseOptions, downloadBulkFile, parseBulkFile } from './bulk.js';
-export { B as BulkContribuyente, C as Contribuyente, N as NcfQueryResult, a as NcfValidationResult, V as ValidationResult } from './index-KNOaUG34.js';
+export { B as BulkContribuyente, C as Contribuyente, N as NcfQueryOptions, a as NcfQueryResult, b as NcfValidationResult, V as ValidationResult } from './index-BPvMDXya.js';

package/dist/index.js

@@ -1,11 +1,9 @@
 import {
-  ECF_TYPE_NAMES,
   NCF_TYPE_NAMES,
   validateCedula,
-  validateEcf,
   validateNcf,
   validateRnc
-} from "./chunk-TZC6RSWL.js";
+} from "./chunk-RTI3CLHV.js";
 import "./chunk-ERBXSS64.js";
 import {
   DGII_BULK_URL,
@@ -19,7 +17,7 @@ import {
   DgiiClient,
   isRetryableError,
   withRetry
-} from "./chunk-KJXLES3I.js";
+} from "./chunk-ABNHQAWP.js";
 import {
   DGII_SOAP_BASE_URL,
   DgiiSoapClient,
@@ -29,7 +27,11 @@ import {
   DGII_NCF_URL,
   DGII_RNC_URL,
   ScrapingClient
-} from "./chunk-YTX4QOLE.js";
+} from "./chunk-KMSKQH4U.js";
+import {
+  ECF_TYPE_NAMES,
+  validateEcf
+} from "./chunk-H42U4GI5.js";
 import "./chunk-KW4ZV6FJ.js";
 import "./chunk-D26S6EXD.js";
 import {

package/dist/scraping.cjs

@@ -4,7 +4,8 @@
 
 
 
-var _chunkAML7LZBUcjs = require('./chunk-AML7LZBU.cjs');
+var _chunkD6DU6PD3cjs = require('./chunk-D6DU6PD3.cjs');
+require('./chunk-OSGHCQFA.cjs');
 require('./chunk-WMFHPNFP.cjs');
 require('./chunk-QH4BK5X3.cjs');
 require('./chunk-NASWEFHN.cjs');
@@ -13,4 +14,4 @@ require('./chunk-NASWEFHN.cjs');
 
 
 
-exports.DGII_NCF_URL = _chunkAML7LZBUcjs.DGII_NCF_URL; exports.DGII_RNC_URL = _chunkAML7LZBUcjs.DGII_RNC_URL; exports.FORM_FIELDS = _chunkAML7LZBUcjs.FORM_FIELDS; exports.ScrapingClient = _chunkAML7LZBUcjs.ScrapingClient;
+exports.DGII_NCF_URL = _chunkD6DU6PD3cjs.DGII_NCF_URL; exports.DGII_RNC_URL = _chunkD6DU6PD3cjs.DGII_RNC_URL; exports.FORM_FIELDS = _chunkD6DU6PD3cjs.FORM_FIELDS; exports.ScrapingClient = _chunkD6DU6PD3cjs.ScrapingClient;

package/dist/scraping.d.cts

@@ -1,4 +1,4 @@
-import { C as Contribuyente, N as NcfQueryResult } from './index-KNOaUG34.cjs';
+import { C as Contribuyente, N as NcfQueryOptions, a as NcfQueryResult } from './index-BPvMDXya.cjs';
 
 interface ScrapingClientOptions {
     /** Tiempo de espera en milisegundos (por defecto: 15000) */
@@ -23,9 +23,18 @@ declare class ScrapingClient {
      */
     getContribuyente(rnc: string): Promise<Contribuyente>;
     /**
-     * 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.
      */
-    getNCF(rnc: string, ncf: string): Promise<NcfQueryResult>;
+    getNCF(rnc: string, ncf: string, options?: NcfQueryOptions): Promise<NcfQueryResult>;
     private _fetchTokens;
     private _post;
     private _wrapFetchError;
@@ -42,6 +51,8 @@ declare const FORM_FIELDS: Readonly<{
     readonly ncfRncInput: "ctl00$cphMain$txtRNC";
     readonly ncfInput: "ctl00$cphMain$txtNCF";
     readonly ncfSubmit: "ctl00$cphMain$btnConsultar";
+    readonly ncfRncCompradorInput: "ctl00$cphMain$txtRncComprador";
+    readonly ncfCodigoSeguridadInput: "ctl00$cphMain$txtCodigoSeg";
 }>;
 
 export { DGII_NCF_URL, DGII_RNC_URL, FORM_FIELDS, ScrapingClient, type ScrapingClientOptions };

package/dist/scraping.d.ts

@@ -1,4 +1,4 @@
-import { C as Contribuyente, N as NcfQueryResult } from './index-KNOaUG34.js';
+import { C as Contribuyente, N as NcfQueryOptions, a as NcfQueryResult } from './index-BPvMDXya.js';
 
 interface ScrapingClientOptions {
     /** Tiempo de espera en milisegundos (por defecto: 15000) */
@@ -23,9 +23,18 @@ declare class ScrapingClient {
      */
     getContribuyente(rnc: string): Promise<Contribuyente>;
     /**
-     * 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.
      */
-    getNCF(rnc: string, ncf: string): Promise<NcfQueryResult>;
+    getNCF(rnc: string, ncf: string, options?: NcfQueryOptions): Promise<NcfQueryResult>;
     private _fetchTokens;
     private _post;
     private _wrapFetchError;
@@ -42,6 +51,8 @@ declare const FORM_FIELDS: Readonly<{
     readonly ncfRncInput: "ctl00$cphMain$txtRNC";
     readonly ncfInput: "ctl00$cphMain$txtNCF";
     readonly ncfSubmit: "ctl00$cphMain$btnConsultar";
+    readonly ncfRncCompradorInput: "ctl00$cphMain$txtRncComprador";
+    readonly ncfCodigoSeguridadInput: "ctl00$cphMain$txtCodigoSeg";
 }>;
 
 export { DGII_NCF_URL, DGII_RNC_URL, FORM_FIELDS, ScrapingClient, type ScrapingClientOptions };

package/dist/scraping.js

@@ -4,7 +4,8 @@ import {
   DGII_RNC_URL,
   FORM_FIELDS,
   ScrapingClient
-} from "./chunk-YTX4QOLE.js";
+} from "./chunk-KMSKQH4U.js";
+import "./chunk-H42U4GI5.js";
 import "./chunk-KW4ZV6FJ.js";
 import "./chunk-D26S6EXD.js";
 import "./chunk-IRQX4WNQ.js";

package/dist/soap.d.cts

@@ -1,4 +1,4 @@
-import { C as Contribuyente, N as NcfQueryResult } from './index-KNOaUG34.cjs';
+import { C as Contribuyente, a as NcfQueryResult } from './index-BPvMDXya.cjs';
 export { DgiiConnectionError, DgiiError, DgiiNotFoundError, DgiiServiceError } from './errors.cjs';
 
 interface SoapClientOptions {

package/dist/soap.d.ts

@@ -1,4 +1,4 @@
-import { C as Contribuyente, N as NcfQueryResult } from './index-KNOaUG34.js';
+import { C as Contribuyente, a as NcfQueryResult } from './index-BPvMDXya.js';
 export { DgiiConnectionError, DgiiError, DgiiNotFoundError, DgiiServiceError } from './errors.js';
 
 interface SoapClientOptions {

package/dist/validators.cjs

@@ -3,9 +3,11 @@
 
 
 
+var _chunkUW6W2JHWcjs = require('./chunk-UW6W2JHW.cjs');
 
 
-var _chunkSUSDEKIDcjs = require('./chunk-SUSDEKID.cjs');
+
+var _chunkOSGHCQFAcjs = require('./chunk-OSGHCQFA.cjs');
 require('./chunk-QH4BK5X3.cjs');
 
 
@@ -14,4 +16,4 @@ require('./chunk-QH4BK5X3.cjs');
 
 
 
-exports.ECF_TYPE_NAMES = _chunkSUSDEKIDcjs.ECF_TYPE_NAMES; exports.NCF_TYPE_NAMES = _chunkSUSDEKIDcjs.NCF_TYPE_NAMES; exports.validateCedula = _chunkSUSDEKIDcjs.validateCedula; exports.validateEcf = _chunkSUSDEKIDcjs.validateEcf; exports.validateNcf = _chunkSUSDEKIDcjs.validateNcf; exports.validateRnc = _chunkSUSDEKIDcjs.validateRnc;
+exports.ECF_TYPE_NAMES = _chunkOSGHCQFAcjs.ECF_TYPE_NAMES; exports.NCF_TYPE_NAMES = _chunkUW6W2JHWcjs.NCF_TYPE_NAMES; exports.validateCedula = _chunkUW6W2JHWcjs.validateCedula; exports.validateEcf = _chunkOSGHCQFAcjs.validateEcf; exports.validateNcf = _chunkUW6W2JHWcjs.validateNcf; exports.validateRnc = _chunkUW6W2JHWcjs.validateRnc;

package/dist/validators.d.cts

@@ -1,4 +1,4 @@
-import { V as ValidationResult, a as NcfValidationResult } from './index-KNOaUG34.cjs';
+import { V as ValidationResult, b as NcfValidationResult } from './index-BPvMDXya.cjs';
 
 /**
  * Valida un RNC (Registro Nacional de Contribuyentes) dominicano.

package/dist/validators.d.ts

@@ -1,4 +1,4 @@
-import { V as ValidationResult, a as NcfValidationResult } from './index-KNOaUG34.js';
+import { V as ValidationResult, b as NcfValidationResult } from './index-BPvMDXya.js';
 
 /**
  * Valida un RNC (Registro Nacional de Contribuyentes) dominicano.

package/dist/validators.js

@@ -1,11 +1,13 @@
 import {
-  ECF_TYPE_NAMES,
   NCF_TYPE_NAMES,
   validateCedula,
-  validateEcf,
   validateNcf,
   validateRnc
-} from "./chunk-TZC6RSWL.js";
+} from "./chunk-RTI3CLHV.js";
+import {
+  ECF_TYPE_NAMES,
+  validateEcf
+} from "./chunk-H42U4GI5.js";
 import "./chunk-D26S6EXD.js";
 export {
   ECF_TYPE_NAMES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dgii-ts",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "Librería TypeScript para validación e integración con la DGII de República Dominicana — RNC, Cédula, NCF, e-NCF",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -115,7 +115,7 @@
     "node": ">=18"
   },
   "overrides": {
-    "vite": "^7.3.2"
+    "vite": "^7.3.6"
   },
   "devDependencies": {
     "@types/node": "^18.19.130",