arca-sdk 0.5.0 → 1.0.0

package/dist/index.cjs

@@ -32,14 +32,15 @@ var index_exports = {};
 __export(index_exports, {
   ArcaAuthError: () => ArcaAuthError,
   ArcaError: () => ArcaError,
+  ArcaNetworkError: () => ArcaNetworkError,
   ArcaValidationError: () => ArcaValidationError,
-  Concepto: () => Concepto,
+  BillingConcept: () => BillingConcept,
+  InvoiceType: () => InvoiceType,
   PadronService: () => PadronService,
-  TipoComprobante: () => TipoComprobante,
-  TipoDocumento: () => TipoDocumento,
+  TaxIdType: () => TaxIdType,
   WsaaService: () => WsaaService,
   WsfeService: () => WsfeService,
-  generarUrlQR: () => generarUrlQR
+  generateQRUrl: () => generateQRUrl
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -487,112 +488,124 @@ var WsaaService = class {
 };
 
 // src/types/wsfe.ts
-var TipoComprobante = /* @__PURE__ */ ((TipoComprobante2) => {
-  TipoComprobante2[TipoComprobante2["FACTURA_A"] = 1] = "FACTURA_A";
-  TipoComprobante2[TipoComprobante2["FACTURA_B"] = 6] = "FACTURA_B";
-  TipoComprobante2[TipoComprobante2["FACTURA_C"] = 11] = "FACTURA_C";
-  TipoComprobante2[TipoComprobante2["TICKET_A"] = 81] = "TICKET_A";
-  TipoComprobante2[TipoComprobante2["TICKET_B"] = 82] = "TICKET_B";
-  TipoComprobante2[TipoComprobante2["TICKET_C"] = 83] = "TICKET_C";
-  return TipoComprobante2;
-})(TipoComprobante || {});
-var Concepto = /* @__PURE__ */ ((Concepto2) => {
-  Concepto2[Concepto2["PRODUCTOS"] = 1] = "PRODUCTOS";
-  Concepto2[Concepto2["SERVICIOS"] = 2] = "SERVICIOS";
-  Concepto2[Concepto2["PRODUCTOS_Y_SERVICIOS"] = 3] = "PRODUCTOS_Y_SERVICIOS";
-  return Concepto2;
-})(Concepto || {});
-var TipoDocumento = /* @__PURE__ */ ((TipoDocumento2) => {
-  TipoDocumento2[TipoDocumento2["CUIT"] = 80] = "CUIT";
-  TipoDocumento2[TipoDocumento2["CUIL"] = 86] = "CUIL";
-  TipoDocumento2[TipoDocumento2["CDI"] = 87] = "CDI";
-  TipoDocumento2[TipoDocumento2["LE"] = 89] = "LE";
-  TipoDocumento2[TipoDocumento2["LC"] = 90] = "LC";
-  TipoDocumento2[TipoDocumento2["CI_EXTRANJERA"] = 91] = "CI_EXTRANJERA";
-  TipoDocumento2[TipoDocumento2["PASAPORTE"] = 94] = "PASAPORTE";
-  TipoDocumento2[TipoDocumento2["CI_BUENOS_AIRES"] = 95] = "CI_BUENOS_AIRES";
-  TipoDocumento2[TipoDocumento2["CI_POLICIA_FEDERAL"] = 96] = "CI_POLICIA_FEDERAL";
-  TipoDocumento2[TipoDocumento2["DNI"] = 96] = "DNI";
-  TipoDocumento2[TipoDocumento2["CONSUMIDOR_FINAL"] = 99] = "CONSUMIDOR_FINAL";
-  return TipoDocumento2;
-})(TipoDocumento || {});
+var InvoiceType = /* @__PURE__ */ ((InvoiceType2) => {
+  InvoiceType2[InvoiceType2["FACTURA_A"] = 1] = "FACTURA_A";
+  InvoiceType2[InvoiceType2["FACTURA_B"] = 6] = "FACTURA_B";
+  InvoiceType2[InvoiceType2["FACTURA_C"] = 11] = "FACTURA_C";
+  InvoiceType2[InvoiceType2["TICKET_A"] = 81] = "TICKET_A";
+  InvoiceType2[InvoiceType2["TICKET_B"] = 82] = "TICKET_B";
+  InvoiceType2[InvoiceType2["TICKET_C"] = 83] = "TICKET_C";
+  return InvoiceType2;
+})(InvoiceType || {});
+var BillingConcept = /* @__PURE__ */ ((BillingConcept2) => {
+  BillingConcept2[BillingConcept2["PRODUCTS"] = 1] = "PRODUCTS";
+  BillingConcept2[BillingConcept2["SERVICES"] = 2] = "SERVICES";
+  BillingConcept2[BillingConcept2["PRODUCTS_AND_SERVICES"] = 3] = "PRODUCTS_AND_SERVICES";
+  return BillingConcept2;
+})(BillingConcept || {});
+var TaxIdType = /* @__PURE__ */ ((TaxIdType2) => {
+  TaxIdType2[TaxIdType2["CUIT"] = 80] = "CUIT";
+  TaxIdType2[TaxIdType2["CUIL"] = 86] = "CUIL";
+  TaxIdType2[TaxIdType2["CDI"] = 87] = "CDI";
+  TaxIdType2[TaxIdType2["LE"] = 89] = "LE";
+  TaxIdType2[TaxIdType2["LC"] = 90] = "LC";
+  TaxIdType2[TaxIdType2["FOREIGN_ID"] = 91] = "FOREIGN_ID";
+  TaxIdType2[TaxIdType2["PASSPORT"] = 94] = "PASSPORT";
+  TaxIdType2[TaxIdType2["BUENOS_AIRES_ID"] = 95] = "BUENOS_AIRES_ID";
+  TaxIdType2[TaxIdType2["NATIONAL_POLICE_ID"] = 96] = "NATIONAL_POLICE_ID";
+  TaxIdType2[TaxIdType2["DNI"] = 96] = "DNI";
+  TaxIdType2[TaxIdType2["FINAL_CONSUMER"] = 99] = "FINAL_CONSUMER";
+  return TaxIdType2;
+})(TaxIdType || {});
 
 // src/utils/calculations.ts
-function calcularSubtotal(items, incluyeIva = false) {
+function calculateSubtotal(items, includesVAT = false) {
   return items.reduce((sum, item) => {
-    let precioNeto = item.precioUnitario;
-    if (incluyeIva && item.alicuotaIva) {
-      precioNeto = item.precioUnitario / (1 + item.alicuotaIva / 100);
+    let netPrice = item.unitPrice;
+    if (includesVAT && item.vatRate) {
+      netPrice = item.unitPrice / (1 + item.vatRate / 100);
     }
-    return sum + item.cantidad * precioNeto;
+    return sum + item.quantity * netPrice;
   }, 0);
 }
-function calcularIVA(items, incluyeIva = false) {
+function calculateVAT(items, includesVAT = false) {
   return items.reduce((sum, item) => {
-    const alicuota = item.alicuotaIva || 0;
-    let precioNeto = item.precioUnitario;
-    if (incluyeIva && alicuota) {
-      precioNeto = item.precioUnitario / (1 + alicuota / 100);
+    const rate = item.vatRate || 0;
+    let netPrice = item.unitPrice;
+    if (includesVAT && rate) {
+      netPrice = item.unitPrice / (1 + rate / 100);
     }
-    const subtotalNeto = item.cantidad * precioNeto;
-    return sum + subtotalNeto * alicuota / 100;
+    const netSubtotal = item.quantity * netPrice;
+    return sum + netSubtotal * rate / 100;
   }, 0);
 }
-function calcularTotal(items, incluyeIva = false) {
-  if (incluyeIva) {
-    return items.reduce((sum, item) => sum + item.cantidad * item.precioUnitario, 0);
+function calculateTotal(items, includesVAT = false) {
+  if (includesVAT) {
+    return items.reduce((sum, item) => sum + item.quantity * item.unitPrice, 0);
   }
-  const subtotal = calcularSubtotal(items, false);
-  const iva = calcularIVA(items, false);
-  return subtotal + iva;
+  const subtotal = calculateSubtotal(items, false);
+  const vat = calculateVAT(items, false);
+  return subtotal + vat;
 }
-function redondear(valor) {
-  return Math.round(valor * 100) / 100;
+function round(value) {
+  return Math.round(value * 100) / 100;
 }
 
 // src/utils/qr.ts
-function generarUrlQR(caeResponse, cuitEmisor, total, comprador) {
-  const cleanCuit = cuitEmisor.replace(/\D/g, "");
-  const cleanCae = caeResponse.cae.replace(/\D/g, "");
-  const fDate = caeResponse.fecha;
-  const fechaFormat = fDate.length === 8 ? `${fDate.substring(0, 4)}-${fDate.substring(4, 6)}-${fDate.substring(6, 8)}` : fDate;
-  const docTipo = comprador?.tipoDocumento || 99 /* CONSUMIDOR_FINAL */;
-  const docNro = comprador?.nroDocumento ? comprador.nroDocumento.replace(/\D/g, "") : "0";
-  const qrObj = {
+function generateQRUrl(caeResponse, issuerCUIT, total, buyer) {
+  const cleanCUIT = issuerCUIT.replace(/\D/g, "");
+  const cleanCAE = caeResponse.cae.replace(/\D/g, "");
+  const rawDate = caeResponse.date;
+  const formattedDate = rawDate.length === 8 ? `${rawDate.substring(0, 4)}-${rawDate.substring(4, 6)}-${rawDate.substring(6, 8)}` : rawDate;
+  const docType = buyer?.docType || 99 /* FINAL_CONSUMER */;
+  const docNumber = buyer?.docNumber ? buyer.docNumber.replace(/\D/g, "") : "0";
+  const qrData = {
     ver: 1,
-    fecha: fechaFormat,
-    cuit: Number(cleanCuit),
-    ptoVta: Number(caeResponse.puntoVenta),
-    tipoCmp: Number(caeResponse.tipoComprobante),
-    nroCmp: Number(caeResponse.nroComprobante),
+    fecha: formattedDate,
+    cuit: Number(cleanCUIT),
+    ptoVta: Number(caeResponse.pointOfSale),
+    tipoCmp: Number(caeResponse.invoiceType),
+    nroCmp: Number(caeResponse.invoiceNumber),
     importe: Number(parseFloat(total.toFixed(2))),
     moneda: "PES",
     ctz: 1
   };
-  if (docTipo !== 99 /* CONSUMIDOR_FINAL */ || Number(docNro) > 0) {
-    qrObj.tipoDocRec = Number(docTipo);
-    qrObj.nroDocRec = Number(docNro);
+  if (docType !== 99 /* FINAL_CONSUMER */ || Number(docNumber) > 0) {
+    qrData.tipoDocRec = Number(docType);
+    qrData.nroDocRec = Number(docNumber);
   }
-  qrObj.tipoCodAut = "E";
-  qrObj.codAut = Number(cleanCae);
-  const jsonString = JSON.stringify(qrObj);
-  let base64 = typeof Buffer !== "undefined" ? Buffer.from(jsonString).toString("base64") : btoa(jsonString);
+  qrData.tipoCodAut = "E";
+  qrData.codAut = Number(cleanCAE);
+  const jsonString = JSON.stringify(qrData);
+  const base64 = typeof Buffer !== "undefined" ? Buffer.from(jsonString).toString("base64") : btoa(jsonString);
   return `https://www.afip.gob.ar/fe/qr/?p=${encodeURIComponent(base64)}`;
 }
 
 // src/constants/errors.ts
 var ARCA_ERROR_HINTS = {
-  // Generales / Auth
-  501: "Error de autenticaci\xF3n: El certificado puede haber expirado o la relaci\xF3n CUIT/Servicio no est\xE1 dada de alta en la web de AFIP.",
-  502: "Error de autenticaci\xF3n: El ticket de acceso (TA) ya no es v\xE1lido o est\xE1 mal formado.",
+  // === Autenticación WSAA ===
+  501: "El certificado puede haber expirado o la relaci\xF3n CUIT/Servicio no est\xE1 habilitada en el portal de ARCA.",
+  502: "El ticket de acceso (TA) es inv\xE1lido o ya expir\xF3. Hac\xE9 wsaa.login() nuevamente.",
+  503: "Error interno del servidor de autenticaci\xF3n de ARCA. Reintent\xE1 en unos minutos.",
   1e3: "El CUIT informado no es v\xE1lido o no corresponde al certificado usado.",
-  // WSFE (Facturación)
-  10015: "Factura B: El importe total es superior al l\xEDmite para consumidores finales an\xF3nimos. Identific\xE1 al comprador.",
-  10016: "Factura C: El CUIT informado como receptor no es v\xE1lido.",
-  10048: 'Punto de Venta inv\xE1lido: Asegurate de que el punto de venta est\xE9 dado de alta como "Factuweb" o "Webservice" en AFIP.',
-  600: "No se pudo autorizar el comprobante. Revis\xE1 las observaciones para m\xE1s detalle.",
-  // Padrón
-  "PADRON_ERROR": "El servicio de Padr\xF3n suele ser inestable en homologaci\xF3n. Reintent\xE1 en unos minutos."
+  1001: "El servicio solicitado no existe o el certificado no tiene autorizaci\xF3n para usarlo.",
+  1003: "El TRA (Ticket de Requerimiento de Acceso) tiene un formato inv\xE1lido.",
+  1005: "El TRA ya expir\xF3 antes de ser presentado. Verific\xE1 la hora del sistema.",
+  // === WSFE — Puntos de venta y configuración ===
+  10048: "El punto de venta no est\xE1 dado de alta en ARCA. Dalo de alta como Webservice en el portal.",
+  10049: "El punto de venta no est\xE1 activo o est\xE1 bloqueado.",
+  // === WSFE — Comprobantes y montos ===
+  10015: "Factura B: El importe supera el l\xEDmite para consumidores finales an\xF3nimos. Identific\xE1 al comprador con CUIT/DNI.",
+  10016: "El CUIT informado como receptor no es v\xE1lido o no existe en el Padr\xF3n.",
+  600: "No se pudo autorizar el comprobante. Revis\xE1 el campo `observations` en la respuesta para m\xE1s detalle.",
+  601: "El comprobante ya fue autorizado anteriormente. No emitas dos veces el mismo n\xFAmero.",
+  602: "El n\xFAmero de comprobante es inv\xE1lido o no es el correcto seg\xFAn el \xFAltimo autorizado.",
+  // === WSFE — IVA ===
+  10043: "La al\xEDcuota de IVA informada no existe o es incorrecta. Us\xE1 3 (0%), 4 (10.5%), 5 (21%) o 6 (27%).",
+  10044: "El importe de IVA no cuadra con la base imponible \xD7 al\xEDcuota.",
+  // === Padrón ===
+  PADRON_ERROR: "El servicio de Padr\xF3n suele ser inestable en homologaci\xF3n. Reintent\xE1 en unos minutos.",
+  CUIT_NOT_FOUND: "El CUIT consultado no existe en el Padr\xF3n de ARCA."
 };
 function getArcaHint(code) {
   return ARCA_ERROR_HINTS[code];
@@ -609,35 +622,24 @@ var WsfeService = class _WsfeService {
     if (!config.ticket || !config.ticket.token) {
       throw new ArcaValidationError(
         "Ticket WSAA requerido. Ejecut\xE1 wsaa.login() primero.",
-        { hint: "El ticket se obtiene del servicio WSAA" }
+        { hint: "El ticket se obtiene del servicio WsaaService" }
       );
     }
-    if (!config.puntoVenta || config.puntoVenta < 1 || config.puntoVenta > 9999) {
+    if (!config.pointOfSale || config.pointOfSale < 1 || config.pointOfSale > 9999) {
       throw new ArcaValidationError(
         "Punto de venta inv\xE1lido: debe ser un n\xFAmero entre 1 y 9999",
-        { puntoVenta: config.puntoVenta }
+        { pointOfSale: config.pointOfSale }
       );
     }
   }
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // Estado de los servidores
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   /**
-   * Emite un Ticket C de forma simple (solo total)
-   * Tipo de comprobante: 83
-   */
-  async emitirTicketCSimple(params) {
-    return this.emitirComprobante({
-      tipo: 83 /* TICKET_C */,
-      concepto: params.concepto || 1 /* PRODUCTOS */,
-      total: params.total,
-      fecha: params.fecha,
-      comprador: {
-        tipoDocumento: 99 /* CONSUMIDOR_FINAL */,
-        nroDocumento: "0"
-      }
-    });
-  }
-  /**
-   * Verifica el estado de los servidores de ARCA (FEDummy)
-   * No requiere autenticación ni instancia configurada.
+   * Verifica el estado de los servidores de ARCA (FEDummy).
+   * No requiere autenticación. Útil para health checks.
+   *
+   * @param environment Ambiente a consultar (default: 'homologacion')
    */
   static async checkStatus(environment = "homologacion") {
     const soapRequest = `<?xml version="1.0" encoding="UTF-8"?>
@@ -668,164 +670,265 @@ var WsfeService = class _WsfeService {
       throw new ArcaError("Respuesta FEDummy inv\xE1lida", "PARSE_ERROR", { xml: responseXml });
     }
     return {
-      AppServer: data.AppServer,
-      DbServer: data.DbServer,
-      AuthServer: data.AuthServer
+      appServer: data.AppServer,
+      dbServer: data.DbServer,
+      authServer: data.AuthServer
     };
   }
   /**
-   * Verifica el estado de los servidores de ARCA (FEDummy)
-   * No requiere autenticación.
+   * Verifica el estado de los servidores de ARCA.
+   * Versión de instancia — usa el ambiente configurado.
    */
   async checkStatus() {
     return _WsfeService.checkStatus(this.config.environment);
   }
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // Emisión de comprobantes
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   /**
-   * Emite un Ticket C completo (con detalle de items)
-   * Los items no se envían a ARCA, pero se retornan en la respuesta.
+   * Emite un Ticket C simple (solo monto total, sin detalle de items).
+   * Ideal para registros mínimos, como una app móvil de punto de venta.
    */
-  async emitirTicketC(params) {
-    const total = redondear(calcularTotal(params.items));
-    const cae = await this.emitirComprobante({
-      tipo: 83 /* TICKET_C */,
-      concepto: params.concepto || 1 /* PRODUCTOS */,
+  async issueSimpleReceipt(params) {
+    return this.issueDocument({
+      type: 83 /* TICKET_C */,
+      concept: params.concept || 1 /* PRODUCTS */,
+      total: params.total,
+      date: params.date,
+      buyer: {
+        docType: 99 /* FINAL_CONSUMER */,
+        docNumber: "0"
+      }
+    });
+  }
+  /**
+   * Emite un Ticket C con detalle de items.
+   * Los items se guardan en la respuesta pero no se envían a ARCA.
+   */
+  async issueReceipt(params) {
+    const total = round(calculateTotal(params.items));
+    const cae = await this.issueDocument({
+      type: 83 /* TICKET_C */,
+      concept: params.concept || 1 /* PRODUCTS */,
       total,
-      fecha: params.fecha,
-      comprador: {
-        tipoDocumento: 99 /* CONSUMIDOR_FINAL */,
-        nroDocumento: "0"
+      date: params.date,
+      buyer: {
+        docType: 99 /* FINAL_CONSUMER */,
+        docNumber: "0"
       }
     });
-    return {
-      ...cae,
-      items: params.items
-    };
+    return { ...cae, items: params.items };
   }
   /**
-   * Emite una Factura B (monotributo a responsable inscripto)
-   * REQUIERE detalle de items con IVA discriminado
+   * Emite una Factura C (consumidor final, sin discriminación de IVA).
    */
-  async emitirFacturaB(params) {
-    this.validateItemsWithIVA(params.items);
-    const incluyeIva = params.incluyeIva || false;
-    const ivaData = this.calcularIVAPorAlicuota(params.items, incluyeIva);
-    return this.emitirComprobante({
-      tipo: 6 /* FACTURA_B */,
-      concepto: params.concepto || 1 /* PRODUCTOS */,
-      items: params.items,
-      comprador: params.comprador,
-      fecha: params.fecha,
-      ivaData,
-      incluyeIva
+  async issueInvoiceC(params) {
+    const total = round(calculateTotal(params.items));
+    return this.issueDocument({
+      type: 11 /* FACTURA_C */,
+      concept: params.concept || 1 /* PRODUCTS */,
+      total,
+      date: params.date,
+      buyer: {
+        docType: 99 /* FINAL_CONSUMER */,
+        docNumber: "0"
+      },
+      items: params.items
     });
   }
   /**
-   * Emite una Factura A (RI a RI)
-   * REQUIERE detalle de items con IVA discriminado
+   * Emite una Factura B (con IVA discriminado).
+   * REQUIERE `vatRate` en todos los items.
    */
-  async emitirFacturaA(params) {
-    this.validateItemsWithIVA(params.items);
-    const incluyeIva = params.incluyeIva || false;
-    const ivaData = this.calcularIVAPorAlicuota(params.items, incluyeIva);
-    return this.emitirComprobante({
-      tipo: 1 /* FACTURA_A */,
-      concepto: params.concepto || 1 /* PRODUCTOS */,
+  async issueInvoiceB(params) {
+    this.validateItemsWithVAT(params.items);
+    const includesVAT = params.includesVAT || false;
+    const vatData = this.calculateVATByRate(params.items, includesVAT);
+    return this.issueDocument({
+      type: 6 /* FACTURA_B */,
+      concept: params.concept || 1 /* PRODUCTS */,
       items: params.items,
-      comprador: params.comprador,
-      fecha: params.fecha,
-      ivaData,
-      incluyeIva
+      buyer: params.buyer,
+      date: params.date,
+      vatData,
+      includesVAT
     });
   }
   /**
-   * Valida que todos los items tengan alícuota IVA definida
+   * Emite una Factura A (Responsable Inscripto a Responsable Inscripto, con IVA discriminado).
+   * REQUIERE `vatRate` en todos los items.
    */
-  validateItemsWithIVA(items) {
-    const sinIva = items.filter(
-      (item) => item.alicuotaIva === void 0 || item.alicuotaIva === null
-    );
-    if (sinIva.length > 0) {
-      throw new ArcaValidationError(
-        "Esta operaci\xF3n requiere IVA discriminado en todos los items",
-        {
-          itemsSinIva: sinIva.map((i) => i.descripcion),
-          hint: "Agreg\xE1 alicuotaIva a cada item (21, 10.5, 27, o 0)"
-        }
-      );
-    }
+  async issueInvoiceA(params) {
+    this.validateItemsWithVAT(params.items);
+    const includesVAT = params.includesVAT || false;
+    const vatData = this.calculateVATByRate(params.items, includesVAT);
+    return this.issueDocument({
+      type: 1 /* FACTURA_A */,
+      concept: params.concept || 1 /* PRODUCTS */,
+      items: params.items,
+      buyer: params.buyer,
+      date: params.date,
+      vatData,
+      includesVAT
+    });
   }
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // Consultas
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   /**
-   * Calcula IVA agrupado por alícuota
-   * ARCA requiere esto para Factura B/A
+   * Consulta un comprobante ya emitido (FECompConsultar).
+   *
+   * @param type Tipo de comprobante
+   * @param invoiceNumber Número de comprobante
    */
-  calcularIVAPorAlicuota(items, incluyeIva = false) {
-    const porAlicuota = /* @__PURE__ */ new Map();
-    items.forEach((item) => {
-      const alicuota = item.alicuotaIva || 0;
-      let precioNeto = item.precioUnitario;
-      if (incluyeIva && alicuota) {
-        precioNeto = item.precioUnitario / (1 + alicuota / 100);
-      }
-      const base = item.cantidad * precioNeto;
-      const importe = base * alicuota / 100;
-      const actual = porAlicuota.get(alicuota) || { base: 0, importe: 0 };
-      porAlicuota.set(alicuota, {
-        base: actual.base + base,
-        importe: actual.importe + importe
-      });
+  async getInvoice(type, invoiceNumber) {
+    const soapRequest = `<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
+                  xmlns:ar="http://ar.gov.afip.dif.FEV1/">
+  <soapenv:Header/>
+  <soapenv:Body>
+    <ar:FECompConsultar>
+      <ar:Auth>
+        <ar:Token>${this.config.ticket.token}</ar:Token>
+        <ar:Sign>${this.config.ticket.sign}</ar:Sign>
+        <ar:Cuit>${this.config.cuit}</ar:Cuit>
+      </ar:Auth>
+      <ar:FeCompConsReq>
+        <ar:CbteTipo>${type}</ar:CbteTipo>
+        <ar:CbteNro>${invoiceNumber}</ar:CbteNro>
+        <ar:PtoVta>${this.config.pointOfSale}</ar:PtoVta>
+      </ar:FeCompConsReq>
+    </ar:FECompConsultar>
+  </soapenv:Body>
+</soapenv:Envelope>`;
+    const endpoint = getWsfeEndpoint(this.config.environment);
+    const response = await callArcaApi(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "text/xml; charset=utf-8",
+        "SOAPAction": "http://ar.gov.afip.dif.FEV1/FECompConsultar"
+      },
+      body: soapRequest,
+      timeout: this.config.timeout
     });
-    return Array.from(porAlicuota.entries()).map(([alicuota, valores]) => ({
-      alicuota,
-      baseImponible: redondear(valores.base),
-      importe: redondear(valores.importe)
-    }));
+    if (!response.ok) {
+      throw new ArcaError(`Error HTTP al consultar comprobante: ${response.status}`, "HTTP_ERROR");
+    }
+    const responseXml = await response.text();
+    const result = parseXml(responseXml);
+    const data = result?.Envelope?.Body?.FECompConsultarResponse?.FECompConsultarResult;
+    if (!data) {
+      throw new ArcaError("Respuesta FECompConsultar inv\xE1lida", "PARSE_ERROR", { xml: responseXml });
+    }
+    if (data.Errors) {
+      const error = Array.isArray(data.Errors.Err) ? data.Errors.Err[0] : data.Errors.Err;
+      const code = error?.Code || "UNKNOWN";
+      throw new ArcaError(
+        `Error ARCA: ${error?.Msg || "Error desconocido"}`,
+        "ARCA_ERROR",
+        data.Errors,
+        getArcaHint(code)
+      );
+    }
+    const det = data.ResultGet;
+    return {
+      invoiceType: Number(det.CbteTipo),
+      pointOfSale: Number(det.PtoVta),
+      invoiceNumber: Number(det.CbteDesde),
+      date: String(det.CbteFch),
+      concept: Number(det.Concepto),
+      docType: Number(det.DocTipo),
+      docNumber: Number(det.DocNro),
+      total: Number(det.ImpTotal),
+      net: Number(det.ImpNeto),
+      vat: Number(det.ImpIVA),
+      cae: String(det.CodAutorizacion),
+      caeExpiry: String(det.FchVto),
+      result: det.Resultado
+    };
   }
   /**
-   * Emite una Factura C (consumidor final)
-   * Forma simplificada sin especificar comprador
+   * Lista los puntos de venta habilitados para el CUIT autenticado (FEParamGetPtosVenta).
    */
-  async emitirFacturaC(params) {
-    const total = redondear(calcularTotal(params.items));
-    return this.emitirComprobante({
-      tipo: 11 /* FACTURA_C */,
-      concepto: params.concepto || 1 /* PRODUCTOS */,
-      total,
-      fecha: params.fecha,
-      comprador: {
-        tipoDocumento: 99 /* CONSUMIDOR_FINAL */,
-        nroDocumento: "0"
+  async getPointsOfSale() {
+    const soapRequest = `<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
+                  xmlns:ar="http://ar.gov.afip.dif.FEV1/">
+  <soapenv:Header/>
+  <soapenv:Body>
+    <ar:FEParamGetPtosVenta>
+      <ar:Auth>
+        <ar:Token>${this.config.ticket.token}</ar:Token>
+        <ar:Sign>${this.config.ticket.sign}</ar:Sign>
+        <ar:Cuit>${this.config.cuit}</ar:Cuit>
+      </ar:Auth>
+    </ar:FEParamGetPtosVenta>
+  </soapenv:Body>
+</soapenv:Envelope>`;
+    const endpoint = getWsfeEndpoint(this.config.environment);
+    const response = await callArcaApi(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "text/xml; charset=utf-8",
+        "SOAPAction": "http://ar.gov.afip.dif.FEV1/FEParamGetPtosVenta"
       },
-      items: params.items
+      body: soapRequest,
+      timeout: this.config.timeout
     });
+    if (!response.ok) {
+      throw new ArcaError(`Error HTTP al consultar puntos de venta: ${response.status}`, "HTTP_ERROR");
+    }
+    const responseXml = await response.text();
+    const result = parseXml(responseXml);
+    const data = result?.Envelope?.Body?.FEParamGetPtosVentaResponse?.FEParamGetPtosVentaResult;
+    if (!data) {
+      throw new ArcaError("Respuesta FEParamGetPtosVenta inv\xE1lida", "PARSE_ERROR", { xml: responseXml });
+    }
+    if (data.Errors) {
+      const error = Array.isArray(data.Errors.Err) ? data.Errors.Err[0] : data.Errors.Err;
+      throw new ArcaError(`Error ARCA: ${error?.Msg || "Error desconocido"}`, "ARCA_ERROR", data.Errors);
+    }
+    const raw = data.ResultGet?.PtoVenta;
+    if (!raw) return [];
+    const list = Array.isArray(raw) ? raw : [raw];
+    return list.map((pv) => ({
+      number: Number(pv.Nro),
+      type: String(pv.EmisionTipo),
+      isBlocked: pv.Bloqueado === "S",
+      blockedSince: pv.FchBaja ? String(pv.FchBaja) : void 0
+    }));
   }
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // Métodos internos
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   /**
-   * Emite un comprobante (método genérico interno)
+   * Método genérico interno para emitir cualquier tipo de comprobante.
    */
-  async emitirComprobante(request) {
-    const nroComprobante = await this.obtenerProximoNumero(request.tipo);
+  async issueDocument(request) {
+    const invoiceNumber = await this.getNextInvoiceNumber(request.type);
     let total = request.total || 0;
-    let subtotal = total;
-    let iva = 0;
+    let net = total;
+    let vat = 0;
     if (request.items && request.items.length > 0) {
-      const incluyeIva = request.incluyeIva || false;
-      subtotal = redondear(calcularSubtotal(request.items, incluyeIva));
-      iva = redondear(calcularIVA(request.items, incluyeIva));
-      total = redondear(calcularTotal(request.items, incluyeIva));
+      const includesVAT = request.includesVAT || false;
+      net = round(calculateSubtotal(request.items, includesVAT));
+      vat = round(calculateVAT(request.items, includesVAT));
+      total = round(calculateTotal(request.items, includesVAT));
     }
     if (total <= 0) {
       throw new ArcaValidationError("El monto total debe ser mayor a 0");
     }
-    const soapRequest = this.buildCAESolicitarRequest({
-      tipo: request.tipo,
-      puntoVenta: this.config.puntoVenta,
-      nroComprobante,
-      concepto: request.concepto,
-      fecha: request.fecha || /* @__PURE__ */ new Date(),
-      comprador: request.comprador,
-      subtotal,
-      iva,
+    const soapRequest = this.buildCAERequest({
+      type: request.type,
+      pointOfSale: this.config.pointOfSale,
+      invoiceNumber,
+      concept: request.concept,
+      date: request.date || /* @__PURE__ */ new Date(),
+      buyer: request.buyer,
+      net,
+      vat,
       total,
-      ivaData: request.ivaData
+      vatData: request.vatData
     });
     const endpoint = getWsfeEndpoint(this.config.environment);
     const response = await callArcaApi(endpoint, {
@@ -846,24 +949,19 @@ var WsfeService = class _WsfeService {
     }
     const responseXml = await response.text();
     const result = await this.parseCAEResponse(responseXml);
-    const urlQr = generarUrlQR(
-      result,
-      this.config.cuit,
-      total,
-      request.comprador
-    );
+    const qrUrl = generateQRUrl(result, this.config.cuit, total, request.buyer);
     return {
       ...result,
       items: request.items,
-      iva: request.ivaData,
-      urlQr
+      vat: request.vatData,
+      qrUrl
     };
   }
   /**
-   * Obtiene el próximo número de comprobante disponible
+   * Obtiene el próximo número de comprobante disponible (FECompUltimoAutorizado + 1)
    */
-  async obtenerProximoNumero(tipo) {
-    const soapRequest = this.buildProximoNumeroRequest(tipo);
+  async getNextInvoiceNumber(type) {
+    const soapRequest = this.buildLastInvoiceRequest(type);
     const endpoint = getWsfeEndpoint(this.config.environment);
     const response = await callArcaApi(endpoint, {
       method: "POST",
@@ -875,7 +973,7 @@ var WsfeService = class _WsfeService {
       timeout: this.config.timeout
     });
     if (!response.ok) {
-      throw new ArcaError(`Error HTTP al consultar pr\xF3ximo n\xFAmero: ${response.status}`, "HTTP_ERROR");
+      throw new ArcaError(`Error HTTP al consultar \xFAltimo comprobante: ${response.status}`, "HTTP_ERROR");
     }
     const responseXml = await response.text();
     const result = parseXml(responseXml);
@@ -890,23 +988,87 @@ var WsfeService = class _WsfeService {
         getArcaHint(code)
       );
     }
-    const nro = data?.CbteNro;
-    return typeof nro === "number" ? nro + 1 : 1;
+    const lastNumber = data?.CbteNro;
+    return typeof lastNumber === "number" ? lastNumber + 1 : 1;
+  }
+  /**
+   * Valida que todos los items tengan alícuota IVA definida
+   */
+  validateItemsWithVAT(items) {
+    const missingVAT = items.filter(
+      (item) => item.vatRate === void 0 || item.vatRate === null
+    );
+    if (missingVAT.length > 0) {
+      throw new ArcaValidationError(
+        "Esta operaci\xF3n requiere `vatRate` en todos los items",
+        {
+          itemsMissingVAT: missingVAT.map((i) => i.description),
+          hint: "Agreg\xE1 vatRate a cada item (21, 10.5, 27, o 0)"
+        }
+      );
+    }
+  }
+  /**
+   * Calcula el IVA agrupado por alícuota (requerido por ARCA para Factura A/B)
+   */
+  calculateVATByRate(items, includesVAT = false) {
+    const byRate = /* @__PURE__ */ new Map();
+    items.forEach((item) => {
+      const rate = item.vatRate || 0;
+      let netPrice = item.unitPrice;
+      if (includesVAT && rate) {
+        netPrice = item.unitPrice / (1 + rate / 100);
+      }
+      const base = item.quantity * netPrice;
+      const amount = base * rate / 100;
+      const current = byRate.get(rate) || { base: 0, amount: 0 };
+      byRate.set(rate, {
+        base: current.base + base,
+        amount: current.amount + amount
+      });
+    });
+    return Array.from(byRate.entries()).map(([rate, values]) => ({
+      rate,
+      taxBase: round(values.base),
+      amount: round(values.amount)
+    }));
   }
-  buildCAESolicitarRequest(params) {
-    const fechaStr = params.fecha.toISOString().split("T")[0].replace(/-/g, "");
-    let ivaXml = "";
-    if (params.ivaData && params.ivaData.length > 0) {
-      ivaXml = "<ar:Iva>";
-      params.ivaData.forEach((aliquot) => {
-        ivaXml += `
+  /**
+   * Mapea alícuota % al código interno de ARCA
+   */
+  getVATCode(percentage) {
+    const map = {
+      0: 3,
+      10.5: 4,
+      21: 5,
+      27: 6
+    };
+    const code = map[percentage];
+    if (code === void 0) {
+      throw new ArcaValidationError(
+        `Al\xEDcuota IVA inv\xE1lida: ${percentage}%`,
+        {
+          validRates: [0, 10.5, 21, 27],
+          hint: "Us\xE1 una de las al\xEDcuotas oficiales de Argentina"
+        }
+      );
+    }
+    return code;
+  }
+  buildCAERequest(params) {
+    const dateStr = params.date.toISOString().split("T")[0].replace(/-/g, "");
+    let vatXml = "";
+    if (params.vatData && params.vatData.length > 0) {
+      vatXml = "<ar:Iva>";
+      params.vatData.forEach((entry) => {
+        vatXml += `
         <ar:AlicIva>
-          <ar:Id>${this.getCodigoAlicuota(aliquot.alicuota)}</ar:Id>
-          <ar:BaseImp>${aliquot.baseImponible.toFixed(2)}</ar:BaseImp>
-          <ar:Importe>${aliquot.importe.toFixed(2)}</ar:Importe>
+          <ar:Id>${this.getVATCode(entry.rate)}</ar:Id>
+          <ar:BaseImp>${entry.taxBase.toFixed(2)}</ar:BaseImp>
+          <ar:Importe>${entry.amount.toFixed(2)}</ar:Importe>
         </ar:AlicIva>`;
       });
-      ivaXml += "\n      </ar:Iva>";
+      vatXml += "\n      </ar:Iva>";
     }
     return `<?xml version="1.0" encoding="UTF-8"?>
 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
@@ -922,26 +1084,26 @@ var WsfeService = class _WsfeService {
       <ar:FeCAEReq>
         <ar:FeCabReq>
           <ar:CantReg>1</ar:CantReg>
-          <ar:PtoVta>${params.puntoVenta}</ar:PtoVta>
-          <ar:CbteTipo>${params.tipo}</ar:CbteTipo>
+          <ar:PtoVta>${params.pointOfSale}</ar:PtoVta>
+          <ar:CbteTipo>${params.type}</ar:CbteTipo>
         </ar:FeCabReq>
         <ar:FeDetReq>
           <ar:FECAEDetRequest>
-            <ar:Concepto>${params.concepto}</ar:Concepto>
-            <ar:DocTipo>${params.comprador?.tipoDocumento || 99}</ar:DocTipo>
-            <ar:DocNro>${params.comprador?.nroDocumento || 0}</ar:DocNro>
-            <ar:CbteDesde>${params.nroComprobante}</ar:CbteDesde>
-            <ar:CbteHasta>${params.nroComprobante}</ar:CbteHasta>
-            <ar:CbteFch>${fechaStr}</ar:CbteFch>
+            <ar:Concepto>${params.concept}</ar:Concepto>
+            <ar:DocTipo>${params.buyer?.docType || 99}</ar:DocTipo>
+            <ar:DocNro>${params.buyer?.docNumber || 0}</ar:DocNro>
+            <ar:CbteDesde>${params.invoiceNumber}</ar:CbteDesde>
+            <ar:CbteHasta>${params.invoiceNumber}</ar:CbteHasta>
+            <ar:CbteFch>${dateStr}</ar:CbteFch>
             <ar:ImpTotal>${params.total.toFixed(2)}</ar:ImpTotal>
             <ar:ImpTotConc>0.00</ar:ImpTotConc>
-            <ar:ImpNeto>${params.subtotal.toFixed(2)}</ar:ImpNeto>
+            <ar:ImpNeto>${params.net.toFixed(2)}</ar:ImpNeto>
             <ar:ImpOpEx>0.00</ar:ImpOpEx>
-            <ar:ImpIVA>${params.iva.toFixed(2)}</ar:ImpIVA>
+            <ar:ImpIVA>${params.vat.toFixed(2)}</ar:ImpIVA>
             <ar:ImpTrib>0.00</ar:ImpTrib>
             <ar:MonId>PES</ar:MonId>
             <ar:MonCotiz>1</ar:MonCotiz>
-            ${ivaXml}
+            ${vatXml}
           </ar:FECAEDetRequest>
         </ar:FeDetReq>
       </ar:FeCAEReq>
@@ -949,29 +1111,7 @@ var WsfeService = class _WsfeService {
   </soapenv:Body>
 </soapenv:Envelope>`;
   }
-  /**
-   * Mapea alícuota % a código ARCA
-   */
-  getCodigoAlicuota(porcentaje) {
-    const mapa = {
-      0: 3,
-      10.5: 4,
-      21: 5,
-      27: 6
-    };
-    const codigo = mapa[porcentaje];
-    if (!codigo) {
-      throw new ArcaValidationError(
-        `Al\xEDcuota IVA inv\xE1lida: ${porcentaje}%`,
-        {
-          alicuotasValidas: [0, 10.5, 21, 27],
-          hint: "Usar una de las al\xEDcuotas oficiales de Argentina"
-        }
-      );
-    }
-    return codigo;
-  }
-  buildProximoNumeroRequest(tipo) {
+  buildLastInvoiceRequest(type) {
     return `<?xml version="1.0" encoding="UTF-8"?>
 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                   xmlns:ar="http://ar.gov.afip.dif.FEV1/">
@@ -983,8 +1123,8 @@ var WsfeService = class _WsfeService {
         <ar:Sign>${this.config.ticket.sign}</ar:Sign>
         <ar:Cuit>${this.config.cuit}</ar:Cuit>
       </ar:Auth>
-      <ar:PtoVta>${this.config.puntoVenta}</ar:PtoVta>
-      <ar:CbteTipo>${tipo}</ar:CbteTipo>
+      <ar:PtoVta>${this.config.pointOfSale}</ar:PtoVta>
+      <ar:CbteTipo>${type}</ar:CbteTipo>
     </ar:FECompUltimoAutorizado>
   </soapenv:Body>
 </soapenv:Envelope>`;
@@ -1010,20 +1150,20 @@ var WsfeService = class _WsfeService {
     if (!det) {
       throw new ArcaError("Respuesta WSFE incompleta: falta detalle del comprobante", "PARSE_ERROR");
     }
-    const observaciones = [];
+    const observations = [];
     if (det.Observaciones) {
       const obsArray = Array.isArray(det.Observaciones.Obs) ? det.Observaciones.Obs : [det.Observaciones.Obs];
-      obsArray.forEach((o) => observaciones.push(o.Msg));
+      obsArray.forEach((o) => observations.push(o.Msg));
     }
     return {
-      tipoComprobante: cab.CbteTipo,
-      puntoVenta: cab.PtoVta,
-      nroComprobante: Number(det.CbteDesde),
-      fecha: det.CbteFch,
+      invoiceType: cab.CbteTipo,
+      pointOfSale: cab.PtoVta,
+      invoiceNumber: Number(det.CbteDesde),
+      date: det.CbteFch,
       cae: String(det.CAE),
-      vencimientoCae: String(det.CAEFchVto),
-      resultado: det.Resultado,
-      observaciones: observaciones.length > 0 ? observaciones : void 0
+      caeExpiry: String(det.CAEFchVto),
+      result: det.Resultado,
+      observations: observations.length > 0 ? observations : void 0
     };
   }
 };
@@ -1045,12 +1185,12 @@ var PadronService = class {
     });
   }
   /**
-   * Consulta los datos de una persona por CUIT
-   * 
-   * @param idPersona CUIT a consultar
-   * @returns Datos de la persona o error
+   * Consulta los datos de un contribuyente por CUIT
+   *
+   * @param taxId CUIT a consultar (11 dígitos sin guiones)
+   * @returns Datos del contribuyente o mensaje de error
    */
-  async getPersona(idPersona) {
+  async getTaxpayer(taxId) {
     const ticket = await this.wsaa.login();
     const soapRequest = `<?xml version="1.0" encoding="UTF-8"?>
 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
@@ -1061,7 +1201,7 @@ var PadronService = class {
       <token>${ticket.token}</token>
       <sign>${ticket.sign}</sign>
       <cuitRepresentada>${this.config.cuit}</cuitRepresentada>
-      <idPersona>${idPersona}</idPersona>
+      <idPersona>${taxId}</idPersona>
     </a13:getPersona>
   </soapenv:Body>
 </soapenv:Envelope>`;
@@ -1071,14 +1211,13 @@ var PadronService = class {
       headers: {
         "Content-Type": "text/xml; charset=utf-8",
         "SOAPAction": ""
-        // A13 no suele requerir SOAPAction específica en el header
       },
       body: soapRequest,
       timeout: this.config.timeout || 15e3
     });
     if (!response.ok) {
       throw new ArcaNetworkError(
-        `Error HTTP al comunicarse con Padron A13: ${response.status}`,
+        `Error HTTP al comunicarse con Padr\xF3n A13: ${response.status}`,
         { status: response.status }
       );
     }
@@ -1086,7 +1225,7 @@ var PadronService = class {
     return this.parseResponse(xml);
   }
   /**
-   * Parsear la respuesta XML de getPersona
+   * Parsea la respuesta XML de getPersona
    */
   parseResponse(xml) {
     const parser = new import_fast_xml_parser2.XMLParser({
@@ -1096,7 +1235,7 @@ var PadronService = class {
     const result = parser.parse(xml);
     const body = result.Envelope?.Body;
     if (!body) {
-      throw new ArcaError("Respuesta de Padr\xF3n inv\xE1lida: No se encontr\xF3 Body", "PADRON_ERROR");
+      throw new ArcaError("Respuesta del Padr\xF3n inv\xE1lida: Body no encontrado", "PADRON_ERROR");
     }
     const response = body.getPersonaResponse?.personaReturn;
     if (!response) {
@@ -1113,82 +1252,80 @@ var PadronService = class {
     if (!p) {
       return { error: "CUIT no encontrado" };
     }
-    const persona = {
-      idPersona: Number(p.idPersona),
-      tipoPersona: p.tipoPersona,
-      nombre: p.nombre,
-      apellido: p.apellido,
-      razonSocial: p.razonSocial,
-      estadoClave: p.estadoClave,
-      domicilio: this.mapDomicilios(p.domicilio),
-      actividad: this.mapActividades(p.actividad),
-      impuesto: this.mapImpuestos(p.impuesto),
-      descripcionActividadPrincipal: p.descripcionActividadPrincipal,
-      esInscriptoIVA: this.checkImpuesto(p, 30),
+    const taxpayer = {
+      taxId: Number(p.idPersona),
+      personType: p.tipoPersona,
+      firstName: p.nombre,
+      lastName: p.apellido,
+      companyName: p.razonSocial,
+      status: p.estadoClave,
+      addresses: this.mapAddresses(p.domicilio),
+      activities: this.mapActivities(p.actividad),
+      taxes: this.mapTaxRecords(p.impuesto),
+      mainActivity: p.descripcionActividadPrincipal,
+      isVATRegistered: this.hasTaxId(p, 30),
       // 30 = IVA
-      esMonotributista: this.checkImpuesto(p, 20),
+      isMonotax: this.hasTaxId(p, 20),
       // 20 = Monotributo
-      esExento: this.checkImpuesto(p, 32)
-      // 32 = Exento
+      isVATExempt: this.hasTaxId(p, 32)
+      // 32 = IVA Exento
     };
-    return { persona };
+    return { taxpayer };
   }
-  mapDomicilios(d) {
-    if (!d) return [];
-    const list = this.ensureArray(d);
-    return list.map((item) => ({
-      direccion: item.direccion,
-      localidad: item.localidad,
-      codPostal: item.codPostal,
-      idProvincia: Number(item.idProvincia),
-      descripcionProvincia: item.descripcionProvincia,
-      tipoDomicilio: item.tipoDomicilio
+  mapAddresses(raw) {
+    if (!raw) return [];
+    return this.toArray(raw).map((item) => ({
+      street: item.direccion,
+      city: item.localidad,
+      postalCode: item.codPostal,
+      provinceId: Number(item.idProvincia),
+      province: item.descripcionProvincia,
+      type: item.tipoDomicilio
     }));
   }
-  mapActividades(a) {
-    if (!a) return [];
-    const list = this.ensureArray(a);
-    return list.map((item) => ({
-      idActividad: Number(item.idActividad),
-      descripcion: item.descripcion,
-      orden: Number(item.orden),
-      periodo: Number(item.periodo)
+  mapActivities(raw) {
+    if (!raw) return [];
+    return this.toArray(raw).map((item) => ({
+      id: Number(item.idActividad),
+      description: item.descripcion,
+      order: Number(item.orden),
+      period: Number(item.periodo)
     }));
   }
-  mapImpuestos(i) {
-    if (!i) return [];
-    const list = this.ensureArray(i);
-    return list.map((item) => ({
-      idImpuesto: Number(item.idImpuesto),
-      descripcion: item.descripcion,
-      periodo: Number(item.periodo)
+  mapTaxRecords(raw) {
+    if (!raw) return [];
+    return this.toArray(raw).map((item) => ({
+      id: Number(item.idImpuesto),
+      description: item.descripcion,
+      period: Number(item.periodo)
     }));
   }
-  checkImpuesto(p, id) {
-    const impuestos = p.impuesto;
-    if (!impuestos) return false;
-    const list = this.ensureArray(impuestos);
-    return list.some((i) => Number(i.idImpuesto) === id);
+  hasTaxId(p, id) {
+    const taxes = p.impuesto;
+    if (!taxes) return false;
+    return this.toArray(taxes).some((i) => Number(i.idImpuesto) === id);
   }
   /**
-   * Helper para normalizar la respuesta de XML que puede ser objeto único o array
+   * Normaliza un valor que puede ser un objeto único o un array (comportamiento de fast-xml-parser)
    */
-  ensureArray(data) {
+  toArray(data) {
     if (data === void 0 || data === null) return [];
-    return Array.isArray(data) ? data : [data];
+    if (Array.isArray(data)) return data;
+    return [data];
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ArcaAuthError,
   ArcaError,
+  ArcaNetworkError,
   ArcaValidationError,
-  Concepto,
+  BillingConcept,
+  InvoiceType,
   PadronService,
-  TipoComprobante,
-  TipoDocumento,
+  TaxIdType,
   WsaaService,
   WsfeService,
-  generarUrlQR
+  generateQRUrl
 });
 //# sourceMappingURL=index.cjs.map