arca-sdk 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -37,7 +37,8 @@ __export(index_exports, {
   TipoComprobante: () => TipoComprobante,
   TipoDocumento: () => TipoDocumento,
   WsaaService: () => WsaaService,
-  WsfeService: () => WsfeService
+  WsfeService: () => WsfeService,
+  generarUrlQR: () => generarUrlQR
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -381,21 +382,32 @@ var TipoDocumento = /* @__PURE__ */ ((TipoDocumento2) => {
 })(TipoDocumento || {});
 
 // src/utils/calculations.ts
-function calcularSubtotal(items) {
+function calcularSubtotal(items, incluyeIva = false) {
   return items.reduce((sum, item) => {
-    return sum + item.cantidad * item.precioUnitario;
+    let precioNeto = item.precioUnitario;
+    if (incluyeIva && item.alicuotaIva) {
+      precioNeto = item.precioUnitario / (1 + item.alicuotaIva / 100);
+    }
+    return sum + item.cantidad * precioNeto;
   }, 0);
 }
-function calcularIVA(items) {
+function calcularIVA(items, incluyeIva = false) {
   return items.reduce((sum, item) => {
-    const subtotal = item.cantidad * item.precioUnitario;
     const alicuota = item.alicuotaIva || 0;
-    return sum + subtotal * alicuota / 100;
+    let precioNeto = item.precioUnitario;
+    if (incluyeIva && alicuota) {
+      precioNeto = item.precioUnitario / (1 + alicuota / 100);
+    }
+    const subtotalNeto = item.cantidad * precioNeto;
+    return sum + subtotalNeto * alicuota / 100;
   }, 0);
 }
-function calcularTotal(items) {
-  const subtotal = calcularSubtotal(items);
-  const iva = calcularIVA(items);
+function calcularTotal(items, incluyeIva = false) {
+  if (incluyeIva) {
+    return items.reduce((sum, item) => sum + item.cantidad * item.precioUnitario, 0);
+  }
+  const subtotal = calcularSubtotal(items, false);
+  const iva = calcularIVA(items, false);
   return subtotal + iva;
 }
 function redondear(valor) {
@@ -466,14 +478,16 @@ var WsfeService = class {
    */
   async emitirFacturaB(params) {
     this.validateItemsWithIVA(params.items);
-    const ivaData = this.calcularIVAPorAlicuota(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
+      ivaData,
+      incluyeIva
     });
   }
   /**
@@ -482,14 +496,16 @@ var WsfeService = class {
    */
   async emitirFacturaA(params) {
     this.validateItemsWithIVA(params.items);
-    const ivaData = this.calcularIVAPorAlicuota(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 */,
       items: params.items,
       comprador: params.comprador,
       fecha: params.fecha,
-      ivaData
+      ivaData,
+      incluyeIva
     });
   }
   /**
@@ -513,11 +529,15 @@ var WsfeService = class {
    * Calcula IVA agrupado por alícuota
    * ARCA requiere esto para Factura B/A
    */
-  calcularIVAPorAlicuota(items) {
+  calcularIVAPorAlicuota(items, incluyeIva = false) {
     const porAlicuota = /* @__PURE__ */ new Map();
     items.forEach((item) => {
       const alicuota = item.alicuotaIva || 0;
-      const base = item.cantidad * item.precioUnitario;
+      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, {
@@ -558,9 +578,10 @@ var WsfeService = class {
     let subtotal = total;
     let iva = 0;
     if (request.items && request.items.length > 0) {
-      subtotal = redondear(calcularSubtotal(request.items));
-      iva = redondear(calcularIVA(request.items));
-      total = redondear(calcularTotal(request.items));
+      const incluyeIva = request.incluyeIva || false;
+      subtotal = redondear(calcularSubtotal(request.items, incluyeIva));
+      iva = redondear(calcularIVA(request.items, incluyeIva));
+      total = redondear(calcularTotal(request.items, incluyeIva));
     }
     if (total <= 0) {
       throw new ArcaValidationError("El monto total debe ser mayor a 0");
@@ -756,6 +777,36 @@ var WsfeService = class {
     };
   }
 };
+
+// src/utils/qr.ts
+function generarUrlQR(caeResponse, cuitEmisor, total, comprador) {
+  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 ? parseInt(comprador.nroDocumento, 10) : 0;
+  const qrData = {
+    ver: 1,
+    // Versión estándar exigida por AFIP
+    fecha: fechaFormat,
+    cuit: parseInt(cuitEmisor, 10),
+    ptoVta: caeResponse.puntoVenta,
+    tipoCmp: caeResponse.tipoComprobante,
+    nroCmp: caeResponse.nroComprobante,
+    importe: parseFloat(total.toFixed(2)),
+    moneda: "PES",
+    // Por defecto PES (Pesos Argentinos)
+    ctz: 1,
+    // Cotización (siempre 1 para PES)
+    tipoDocRec: docTipo,
+    nroDocRec: docNro,
+    tipoCodAut: "E",
+    // 'E' para comprobantes electrónicos
+    codAut: parseInt(caeResponse.cae, 10)
+  };
+  const jsonString = JSON.stringify(qrData);
+  let base64 = typeof Buffer !== "undefined" ? Buffer.from(jsonString).toString("base64") : btoa(jsonString);
+  return `https://www.afip.gob.ar/fe/qr/?p=${base64}`;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ArcaAuthError,
@@ -765,5 +816,6 @@ var WsfeService = class {
   TipoComprobante,
   TipoDocumento,
   WsaaService,
-  WsfeService
+  WsfeService,
+  generarUrlQR
 });

package/dist/index.d.cts

@@ -192,6 +192,8 @@ interface EmitirFacturaRequest {
         baseImponible: number;
         importe: number;
     }[];
+    /** Indica si los preciosUnitarios de los items YA incluyen el IVA (Precio Final). Defecto: false */
+    incluyeIva?: boolean;
     /** Fecha del comprobante (default: hoy) */
     fecha?: Date;
 }
@@ -277,6 +279,7 @@ declare class WsfeService {
         comprador: Comprador;
         concepto?: Concepto;
         fecha?: Date;
+        incluyeIva?: boolean;
     }): Promise<CAEResponse>;
     /**
      * Emite una Factura A (RI a RI)
@@ -287,6 +290,7 @@ declare class WsfeService {
         comprador: Comprador;
         concepto?: Concepto;
         fecha?: Date;
+        incluyeIva?: boolean;
     }): Promise<CAEResponse>;
     /**
      * Valida que todos los items tengan alícuota IVA definida
@@ -323,4 +327,15 @@ declare class WsfeService {
     private parseCAEResponse;
 }
 
-export { ArcaAuthError, type ArcaConfig, ArcaError, ArcaValidationError, type CAEResponse, type Comprador, Concepto, type EmitirFacturaRequest, type Environment, type FacturaItem, type LoginTicket, TipoComprobante, TipoDocumento, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService };
+/**
+ * Genera la URL completa con el código QR para un comprobante emitido
+ *
+ * @param caeResponse Respuesta obtenida al emitir la factura (CAEResponse)
+ * @param cuitEmisor Tu CUIT (11 dígitos, sin guiones)
+ * @param total Importe total del comprobante
+ * @param comprador Datos del comprador (opcional, si no se pasa asume Consumidor Final)
+ * @returns La URL lista para embeber en un generador de QR
+ */
+declare function generarUrlQR(caeResponse: CAEResponse, cuitEmisor: string, total: number, comprador?: Comprador): string;
+
+export { ArcaAuthError, type ArcaConfig, ArcaError, ArcaValidationError, type CAEResponse, type Comprador, Concepto, type EmitirFacturaRequest, type Environment, type FacturaItem, type LoginTicket, TipoComprobante, TipoDocumento, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generarUrlQR };

package/dist/index.d.ts

@@ -192,6 +192,8 @@ interface EmitirFacturaRequest {
         baseImponible: number;
         importe: number;
     }[];
+    /** Indica si los preciosUnitarios de los items YA incluyen el IVA (Precio Final). Defecto: false */
+    incluyeIva?: boolean;
     /** Fecha del comprobante (default: hoy) */
     fecha?: Date;
 }
@@ -277,6 +279,7 @@ declare class WsfeService {
         comprador: Comprador;
         concepto?: Concepto;
         fecha?: Date;
+        incluyeIva?: boolean;
     }): Promise<CAEResponse>;
     /**
      * Emite una Factura A (RI a RI)
@@ -287,6 +290,7 @@ declare class WsfeService {
         comprador: Comprador;
         concepto?: Concepto;
         fecha?: Date;
+        incluyeIva?: boolean;
     }): Promise<CAEResponse>;
     /**
      * Valida que todos los items tengan alícuota IVA definida
@@ -323,4 +327,15 @@ declare class WsfeService {
     private parseCAEResponse;
 }
 
-export { ArcaAuthError, type ArcaConfig, ArcaError, ArcaValidationError, type CAEResponse, type Comprador, Concepto, type EmitirFacturaRequest, type Environment, type FacturaItem, type LoginTicket, TipoComprobante, TipoDocumento, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService };
+/**
+ * Genera la URL completa con el código QR para un comprobante emitido
+ *
+ * @param caeResponse Respuesta obtenida al emitir la factura (CAEResponse)
+ * @param cuitEmisor Tu CUIT (11 dígitos, sin guiones)
+ * @param total Importe total del comprobante
+ * @param comprador Datos del comprador (opcional, si no se pasa asume Consumidor Final)
+ * @returns La URL lista para embeber en un generador de QR
+ */
+declare function generarUrlQR(caeResponse: CAEResponse, cuitEmisor: string, total: number, comprador?: Comprador): string;
+
+export { ArcaAuthError, type ArcaConfig, ArcaError, ArcaValidationError, type CAEResponse, type Comprador, Concepto, type EmitirFacturaRequest, type Environment, type FacturaItem, type LoginTicket, TipoComprobante, TipoDocumento, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generarUrlQR };

package/dist/index.js

@@ -338,21 +338,32 @@ var TipoDocumento = /* @__PURE__ */ ((TipoDocumento2) => {
 })(TipoDocumento || {});
 
 // src/utils/calculations.ts
-function calcularSubtotal(items) {
+function calcularSubtotal(items, incluyeIva = false) {
   return items.reduce((sum, item) => {
-    return sum + item.cantidad * item.precioUnitario;
+    let precioNeto = item.precioUnitario;
+    if (incluyeIva && item.alicuotaIva) {
+      precioNeto = item.precioUnitario / (1 + item.alicuotaIva / 100);
+    }
+    return sum + item.cantidad * precioNeto;
   }, 0);
 }
-function calcularIVA(items) {
+function calcularIVA(items, incluyeIva = false) {
   return items.reduce((sum, item) => {
-    const subtotal = item.cantidad * item.precioUnitario;
     const alicuota = item.alicuotaIva || 0;
-    return sum + subtotal * alicuota / 100;
+    let precioNeto = item.precioUnitario;
+    if (incluyeIva && alicuota) {
+      precioNeto = item.precioUnitario / (1 + alicuota / 100);
+    }
+    const subtotalNeto = item.cantidad * precioNeto;
+    return sum + subtotalNeto * alicuota / 100;
   }, 0);
 }
-function calcularTotal(items) {
-  const subtotal = calcularSubtotal(items);
-  const iva = calcularIVA(items);
+function calcularTotal(items, incluyeIva = false) {
+  if (incluyeIva) {
+    return items.reduce((sum, item) => sum + item.cantidad * item.precioUnitario, 0);
+  }
+  const subtotal = calcularSubtotal(items, false);
+  const iva = calcularIVA(items, false);
   return subtotal + iva;
 }
 function redondear(valor) {
@@ -423,14 +434,16 @@ var WsfeService = class {
    */
   async emitirFacturaB(params) {
     this.validateItemsWithIVA(params.items);
-    const ivaData = this.calcularIVAPorAlicuota(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
+      ivaData,
+      incluyeIva
     });
   }
   /**
@@ -439,14 +452,16 @@ var WsfeService = class {
    */
   async emitirFacturaA(params) {
     this.validateItemsWithIVA(params.items);
-    const ivaData = this.calcularIVAPorAlicuota(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 */,
       items: params.items,
       comprador: params.comprador,
       fecha: params.fecha,
-      ivaData
+      ivaData,
+      incluyeIva
     });
   }
   /**
@@ -470,11 +485,15 @@ var WsfeService = class {
    * Calcula IVA agrupado por alícuota
    * ARCA requiere esto para Factura B/A
    */
-  calcularIVAPorAlicuota(items) {
+  calcularIVAPorAlicuota(items, incluyeIva = false) {
     const porAlicuota = /* @__PURE__ */ new Map();
     items.forEach((item) => {
       const alicuota = item.alicuotaIva || 0;
-      const base = item.cantidad * item.precioUnitario;
+      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, {
@@ -515,9 +534,10 @@ var WsfeService = class {
     let subtotal = total;
     let iva = 0;
     if (request.items && request.items.length > 0) {
-      subtotal = redondear(calcularSubtotal(request.items));
-      iva = redondear(calcularIVA(request.items));
-      total = redondear(calcularTotal(request.items));
+      const incluyeIva = request.incluyeIva || false;
+      subtotal = redondear(calcularSubtotal(request.items, incluyeIva));
+      iva = redondear(calcularIVA(request.items, incluyeIva));
+      total = redondear(calcularTotal(request.items, incluyeIva));
     }
     if (total <= 0) {
       throw new ArcaValidationError("El monto total debe ser mayor a 0");
@@ -713,6 +733,36 @@ var WsfeService = class {
     };
   }
 };
+
+// src/utils/qr.ts
+function generarUrlQR(caeResponse, cuitEmisor, total, comprador) {
+  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 ? parseInt(comprador.nroDocumento, 10) : 0;
+  const qrData = {
+    ver: 1,
+    // Versión estándar exigida por AFIP
+    fecha: fechaFormat,
+    cuit: parseInt(cuitEmisor, 10),
+    ptoVta: caeResponse.puntoVenta,
+    tipoCmp: caeResponse.tipoComprobante,
+    nroCmp: caeResponse.nroComprobante,
+    importe: parseFloat(total.toFixed(2)),
+    moneda: "PES",
+    // Por defecto PES (Pesos Argentinos)
+    ctz: 1,
+    // Cotización (siempre 1 para PES)
+    tipoDocRec: docTipo,
+    nroDocRec: docNro,
+    tipoCodAut: "E",
+    // 'E' para comprobantes electrónicos
+    codAut: parseInt(caeResponse.cae, 10)
+  };
+  const jsonString = JSON.stringify(qrData);
+  let base64 = typeof Buffer !== "undefined" ? Buffer.from(jsonString).toString("base64") : btoa(jsonString);
+  return `https://www.afip.gob.ar/fe/qr/?p=${base64}`;
+}
 export {
   ArcaAuthError,
   ArcaError,
@@ -721,5 +771,6 @@ export {
   TipoComprobante,
   TipoDocumento,
   WsaaService,
-  WsfeService
+  WsfeService,
+  generarUrlQR
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arca-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "SDK moderna en TypeScript para ARCA (ex-AFIP)",
   "type": "module",
   "main": "./dist/index.js",
@@ -8,9 +8,12 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     }
   },
   "files": [