arca-sdk 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -4,6 +4,23 @@ Todos los cambios notables de este proyecto se documentan en este archivo.
 
 ---
 
+## [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)
+
+- **Condición IVA Receptor Nativas**: Se solucionó un bug por el cual `<ar:CondicionIVAReceptorId>` no se renderizaba como nodo de primer nivel en `FECAEDetRequest`, requisito fundamental de la RG 5616 para Factura C de ciertos compradores. Ahora puede enviarse vía `buyer.vatCondition`.
+- **Fechas de Servicio**: Se añadió inyección nativa de `<ar:FchServDesde>`, `<ar:FchServHasta>` y `<ar:FchVtoPago>` para cuando se facturan Conceptos `2` o `3` (Servicios o Productos + Servicios). Se puede especificar enviando el parámetro `serviceDates` en la Request.
+
+---
+
 ## [1.1.1] — 2026-03-03
 
 ### ✨ Soporte para Opcionales y Resolución General 5616

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
@@ -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) {
@@ -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 };
   }
@@ -988,7 +1006,8 @@ var WsfeService = class _WsfeService {
       date: params.date,
       vatData,
       includesVAT,
-      optionals: params.optionals
+      optionals: params.optionals,
+      serviceDates: params.serviceDates
     });
   }
   /**
@@ -1008,7 +1027,8 @@ var WsfeService = class _WsfeService {
       },
       items: params.items,
       associatedInvoices: params.associatedInvoices,
-      optionals: params.optionals
+      optionals: params.optionals,
+      serviceDates: params.serviceDates
     });
   }
   /**
@@ -1055,6 +1075,7 @@ var WsfeService = class _WsfeService {
       date: request.date || /* @__PURE__ */ new Date(),
       buyer: request.buyer,
       associatedInvoices: request.associatedInvoices,
+      serviceDates: request.serviceDates,
       net,
       vat,
       total,
@@ -1216,6 +1237,31 @@ var WsfeService = class _WsfeService {
       });
       asocXml += "\n      </ar:CbtesAsoc>";
     }
+    let optXml = "";
+    if (params.optionals && params.optionals.length > 0) {
+      optXml = "<ar:Opcionales>";
+      params.optionals.forEach((opt) => {
+        optXml += `
+        <ar:Opcional>
+          <ar:Id>${opt.id}</ar:Id>
+          <ar:Valor>${opt.value}</ar:Valor>
+        </ar:Opcional>`;
+      });
+      optXml += "\n      </ar:Opcionales>";
+    }
+    const condicionIVAReceptorXml = params.buyer?.vatCondition !== void 0 ? `
+            <ar:CondicionIVAReceptorId>${params.buyer.vatCondition}</ar:CondicionIVAReceptorId>` : "";
+    let fechasServicioXml = "";
+    if (params.concept === 2 /* SERVICES */ || params.concept === 3 /* PRODUCTS_AND_SERVICES */) {
+      const defaultDateStr = params.date.toISOString().split("T")[0].replace(/-/g, "");
+      const startDateStr = params.serviceDates?.startDate ? params.serviceDates.startDate.toISOString().split("T")[0].replace(/-/g, "") : defaultDateStr;
+      const endDateStr = params.serviceDates?.endDate ? params.serviceDates.endDate.toISOString().split("T")[0].replace(/-/g, "") : defaultDateStr;
+      const dueDateStr = params.serviceDates?.dueDate ? params.serviceDates.dueDate.toISOString().split("T")[0].replace(/-/g, "") : defaultDateStr;
+      fechasServicioXml = `
+            <ar:FchServDesde>${startDateStr}</ar:FchServDesde>
+            <ar:FchServHasta>${endDateStr}</ar:FchServHasta>
+            <ar:FchVtoPago>${dueDateStr}</ar:FchVtoPago>`;
+    }
     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/">
@@ -1237,7 +1283,7 @@ var WsfeService = class _WsfeService {
           <ar:FECAEDetRequest>
             <ar:Concepto>${params.concept}</ar:Concepto>
             <ar:DocTipo>${params.buyer?.docType || 99}</ar:DocTipo>
-            <ar:DocNro>${params.buyer?.docNumber || 0}</ar:DocNro>
+            <ar:DocNro>${params.buyer?.docNumber || 0}</ar:DocNro>${condicionIVAReceptorXml}
             <ar:CbteDesde>${params.invoiceNumber}</ar:CbteDesde>
             <ar:CbteHasta>${params.invoiceNumber}</ar:CbteHasta>
             <ar:CbteFch>${dateStr}</ar:CbteFch>
@@ -1248,9 +1294,10 @@ var WsfeService = class _WsfeService {
             <ar:ImpIVA>${params.vat.toFixed(2)}</ar:ImpIVA>
             <ar:ImpTrib>0.00</ar:ImpTrib>
             <ar:MonId>PES</ar:MonId>
-            <ar:MonCotiz>1</ar:MonCotiz>
+            <ar:MonCotiz>1</ar:MonCotiz>${fechasServicioXml}
             ${asocXml}
             ${vatXml}
+            ${optXml}
           </ar:FECAEDetRequest>
         </ar:FeDetReq>
       </ar:FeCAEReq>
@@ -1471,6 +1518,7 @@ var PadronService = class {
   InvoiceType,
   PadronService,
   TaxIdType,
+  VatCondition,
   WsaaService,
   WsfeService,
   generateQRUrl