arca-sdk 1.1.2 → 1.2.1

package/CHANGELOG.md

@@ -4,6 +4,26 @@ Todos los cambios notables de este proyecto se documentan en este archivo.
 
 ---
 
+## [1.2.1] — 2026-05-29
+
+### 🌐 Normativas ARCA 2026 & Actualizaciones de Infraestructura
+
+- **Migración a Dominios ARCA**: Se actualizaron todos los endpoints predeterminados SOAP del SDK (`WSAA`, `WSFE` y `Padrón A13`) reemplazando los antiguos servidores `*.afip.gov.ar` / `*.afip.gob.ar` por la infraestructura oficial y definitiva de ARCA (`*.arca.gob.ar`).
+- **URL del Código QR Oficial**: Se actualizó la URL de validación del QR de comprobantes electrónicos a `https://www.arca.gob.ar/fe/qr/?p=...` según la normativa vigente en 2026.
+- **Documentación de Normativas Recientes**:
+  - **Identificación de Comprador (RG 5824/2026)**: Se documentó en el `README.md` el nuevo tope legal de **$10.000.000** a partir del cual es obligatorio identificar al receptor en facturas de Consumidores Finales.
+  - **Facturación A con Leyenda (RG 5762/2025)**: Se documentó cómo utilizar el campo `optionals` del SDK para dar cumplimiento a la disolución de la Factura Clase "M" mediante la emisión de Facturas A tradicionales con leyendas de retención impositivas ("OPERACIÓN SUJETA A RETENCIÓN" o "PAGO EN CBU INFORMADA").
+
+---
+
+## [1.2.0] — 2026-03-18
+
+### ✨ Developer Experience (DX) y Normativas 2025
+
+- **VatCondition Enum**: Se introdujo el enumerador fuertemente tipado `VatCondition` para facilitar el envío del parámetro `<ar:CondicionIVAReceptorId>` (obligatorio para ciertas Facturas C según la RG 5616/2024 efectiva desde 2025). Ahora la interfaz `Buyer` acepta este enum en su propiedad `vatCondition`, previniendo errores por el uso de números mágicos (ej. `VatCondition.CONSUMIDOR_FINAL` en lugar de `5`).
+
+---
+
 ## [1.1.2] — 2026-03-04
 
 ### 🐛 Fixes en Nodos para Facturas de Servicios (RG 5616)

package/README.md

@@ -104,7 +104,7 @@ const result = await wsfe.issueSimpleReceipt({ total: 1500 });
 
 console.log('CAE:', result.cae);              // '75157992335329'
 console.log('Vto:', result.caeExpiry);        // '20260302'
-console.log('QR:', result.qrUrl);             // 'https://www.afip.gob.ar/fe/qr/?p=...'
+console.log('QR:', result.qrUrl);             // 'https://www.arca.gob.ar/fe/qr/?p=...'
 ```
 
 > Los certificados se obtienen en el [portal de ARCA](https://auth.afip.gob.ar/contribuyente_/login.xhtml) (CLAVE FISCAL nivel 3+).
@@ -283,7 +283,38 @@ console.log(result.qrUrl); // listo para embeber en un generador de QR
 const url = generateQRUrl(caeResponse, '20123456789', 1500.00);
 ```
 
-> **Nota:** La URL usa base64 crudo sin `encodeURIComponent`. Es un quirk documentado del spec de ARCA — su scanner no acepta caracteres URL-encoded.
+> **Nota:** La URL usa base64 crudo sin `encodeURIComponent`. Es un quirk del spec oficial de ARCA — su scanner no acepta caracteres URL-encoded.
+
+### 📋 Normativas ARCA 2026 & Buenas Prácticas
+
+`arca-sdk` está completamente adaptada a las últimas directivas de la **Agencia de Recaudación y Control Aduanero (ARCA)**:
+
+#### 1. Identificación del Comprador (RG 5824/2026)
+* A partir de 2026, el monto límite para compras de **Consumidores Finales** sin identificar se elevó a **$10.000.000**.
+* Si el importe acumulado del comprobante es **igual o mayor a $10.000.000**, es **obligatorio** identificar al comprador mediante su DNI, CUIT, CUIL o CDI en el objeto `buyer`.
+* Si el cliente solicita el comprobante para deducir el gasto en el Impuesto a las Ganancias, es obligatorio identificarlo con su CUIT sin importar el monto.
+
+#### 2. Emisión de Facturas Clase "A" con Leyenda (RG 5762/2025)
+Con la eliminación total de la Factura Clase "M", ARCA instruyó el uso de Facturas Clase "A" tradicionales acompañadas de leyendas impositivas obligatorias. La SDK permite resolver este requerimiento utilizando el bloque de campos opcionales del protocolo SOAP:
+
+* **Operación Sujeta a Retención (Reemplazo de Factura M):**
+  Para emitir una Factura A sujeta al régimen de retención, debés pasar en la propiedad `optionals` el identificador oficial provisto por ARCA:
+  ```typescript
+  const result = await wsfe.issueInvoiceA({
+    items: [...],
+    buyer: { docType: TaxIdType.CUIT, docNumber: '30716024941' },
+    optionals: [
+      {
+        id: 5, // ID opcional para indicar la condicion
+        value: '1' // Valor segun catalogo de ARCA
+      }
+    ]
+  });
+  ```
+* **Pago en CBU Informada:**
+  De igual modo, si te corresponde emitir con la leyenda de obligatoriedad de CBU, se adjunta el opcional correspondiente declarando tu cuenta bancaria asociada.
+
+---
 
 ### Manejo de errores
 

package/dist/index.cjs

@@ -38,6 +38,7 @@ __export(index_exports, {
   InvoiceType: () => InvoiceType,
   PadronService: () => PadronService,
   TaxIdType: () => TaxIdType,
+  VatCondition: () => VatCondition,
   WsaaService: () => WsaaService,
   WsfeService: () => WsfeService,
   generateQRUrl: () => generateQRUrl
@@ -46,16 +47,16 @@ module.exports = __toCommonJS(index_exports);
 
 // src/constants/endpoints.ts
 var WSAA_ENDPOINTS = {
-  homologacion: "https://wsaahomo.afip.gov.ar/ws/services/LoginCms",
-  produccion: "https://wsaa.afip.gov.ar/ws/services/LoginCms"
+  homologacion: "https://wsaahomo.arca.gob.ar/ws/services/LoginCms",
+  produccion: "https://wsaa.arca.gob.ar/ws/services/LoginCms"
 };
 var WSFE_ENDPOINTS = {
-  homologacion: "https://wswhomo.afip.gov.ar/wsfev1/service.asmx",
-  produccion: "https://servicios1.afip.gov.ar/wsfev1/service.asmx"
+  homologacion: "https://wswhomo.arca.gob.ar/wsfev1/service.asmx",
+  produccion: "https://servicios1.arca.gob.ar/wsfev1/service.asmx"
 };
 var PADRON_A13_ENDPOINTS = {
-  homologacion: "https://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA13",
-  produccion: "https://aws.afip.gov.ar/sr-padron/webservices/personaServiceA13"
+  homologacion: "https://awshomo.arca.gob.ar/sr-padron/webservices/personaServiceA13",
+  produccion: "https://aws.arca.gob.ar/sr-padron/webservices/personaServiceA13"
 };
 function getWsaaEndpoint(environment) {
   return WSAA_ENDPOINTS[environment];
@@ -543,6 +544,21 @@ var TaxIdType = /* @__PURE__ */ ((TaxIdType2) => {
   TaxIdType2[TaxIdType2["FINAL_CONSUMER"] = 99] = "FINAL_CONSUMER";
   return TaxIdType2;
 })(TaxIdType || {});
+var VatCondition = /* @__PURE__ */ ((VatCondition2) => {
+  VatCondition2[VatCondition2["IVA_RESPONSABLE_INSCRIPTO"] = 1] = "IVA_RESPONSABLE_INSCRIPTO";
+  VatCondition2[VatCondition2["IVA_RESPONSABLE_NO_INSCRIPTO"] = 2] = "IVA_RESPONSABLE_NO_INSCRIPTO";
+  VatCondition2[VatCondition2["IVA_NO_RESPONSABLE"] = 3] = "IVA_NO_RESPONSABLE";
+  VatCondition2[VatCondition2["IVA_SUJETO_EXENTO"] = 4] = "IVA_SUJETO_EXENTO";
+  VatCondition2[VatCondition2["CONSUMIDOR_FINAL"] = 5] = "CONSUMIDOR_FINAL";
+  VatCondition2[VatCondition2["RESPONSABLE_MONOTRIBUTO"] = 6] = "RESPONSABLE_MONOTRIBUTO";
+  VatCondition2[VatCondition2["SUJETO_NO_CATEGORIZADO"] = 7] = "SUJETO_NO_CATEGORIZADO";
+  VatCondition2[VatCondition2["PROVEEDOR_DEL_EXTERIOR"] = 8] = "PROVEEDOR_DEL_EXTERIOR";
+  VatCondition2[VatCondition2["CLIENTE_DEL_EXTERIOR"] = 9] = "CLIENTE_DEL_EXTERIOR";
+  VatCondition2[VatCondition2["IVA_LIBERADO_LEY_19640"] = 10] = "IVA_LIBERADO_LEY_19640";
+  VatCondition2[VatCondition2["IVA_RESPONSABLE_INSCRIPTO_AGENTE_PERCEPCION"] = 11] = "IVA_RESPONSABLE_INSCRIPTO_AGENTE_PERCEPCION";
+  VatCondition2[VatCondition2["MONOTRIBUTISTA_SOCIAL"] = 13] = "MONOTRIBUTISTA_SOCIAL";
+  return VatCondition2;
+})(VatCondition || {});
 
 // src/utils/calculations.ts
 function calculateSubtotal(items, includesVAT = false) {
@@ -604,7 +620,7 @@ function generateQRUrl(caeResponse, issuerCUIT, total, buyer) {
   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=${base64}`;
+  return `https://www.arca.gob.ar/fe/qr/?p=${base64}`;
 }
 
 // src/constants/errors.ts
@@ -725,7 +741,8 @@ var WsfeService = class _WsfeService {
         docType: 99 /* FINAL_CONSUMER */,
         docNumber: "0"
       },
-      optionals: params.optionals
+      optionals: params.optionals,
+      serviceDates: params.serviceDates
     });
   }
   /**
@@ -743,7 +760,8 @@ var WsfeService = class _WsfeService {
         docType: 99 /* FINAL_CONSUMER */,
         docNumber: "0"
       },
-      optionals: params.optionals
+      optionals: params.optionals,
+      serviceDates: params.serviceDates
     });
     return { ...cae, items: params.items };
   }
@@ -1500,6 +1518,7 @@ var PadronService = class {
   InvoiceType,
   PadronService,
   TaxIdType,
+  VatCondition,
   WsaaService,
   WsfeService,
   generateQRUrl