arca-sdk 1.1.0 → 1.1.2

package/dist/index.d.cts

@@ -216,6 +216,8 @@ interface Buyer {
     docType: TaxIdType;
     /** Número de documento (sin guiones) */
     docNumber: string;
+    /** Opcional: Condición frente al IVA del receptor (ej: 5 para Consumidor Final, 2 para Monotributo) */
+    vatCondition?: number;
 }
 /**
  * Comprobante asociado (Requerido al emitir Notas de Crédito/Débito)
@@ -232,6 +234,23 @@ interface AssociatedInvoice {
     /** Fecha de emisión del comprobante original */
     date?: Date;
 }
+/**
+ * Campo opcional de AFIP (ej. Condición IVA Receptor RG 5616)
+ */
+interface InvoiceOptional {
+    /** ID del dato opcional (ej. 1010) */
+    id: string | number;
+    /** Valor del dato opcional */
+    value: string;
+}
+/**
+ * Fechas de servicio (Obligatorio si concept es 2 o 3)
+ */
+interface ServiceDates {
+    startDate: Date;
+    endDate: Date;
+    dueDate: Date;
+}
 /**
  * Request para emitir comprobante
  */
@@ -246,6 +265,8 @@ interface IssueInvoiceRequest {
     items?: InvoiceItem[];
     /** Comprobantes asociados (Obligatorio para Nota de Crédito/Débito) */
     associatedInvoices?: AssociatedInvoice[];
+    /** Fechas de servicio (Obligatorio si concept es 2 o 3) */
+    serviceDates?: ServiceDates;
     /** Monto total (requerido si no hay items) */
     total?: number;
     /** Desglose de IVA (requerido para Factura A/B) */
@@ -258,6 +279,8 @@ interface IssueInvoiceRequest {
     includesVAT?: boolean;
     /** Fecha del comprobante (default: hoy) */
     date?: Date;
+    /** Campos opcionales adjuntos (ej: Condición IVA receptor ID 1010) */
+    optionals?: InvoiceOptional[];
 }
 /**
  * Respuesta CAE (Código de Autorización Electrónico)
@@ -320,6 +343,8 @@ interface InvoiceDetails {
     caeExpiry: string;
     /** Resultado */
     result: 'A' | 'R';
+    /** Campos opcionales adjuntos */
+    optionals?: InvoiceOptional[];
 }
 /**
  * Punto de venta habilitado en ARCA
@@ -394,6 +419,7 @@ declare class WsfeService {
         total: number;
         concept?: BillingConcept;
         date?: Date;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite un Ticket C con detalle de items.
@@ -403,6 +429,7 @@ declare class WsfeService {
         items: InvoiceItem[];
         concept?: BillingConcept;
         date?: Date;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Factura A (Responsable Inscripto a Responsable Inscripto, con IVA discriminado).
@@ -414,6 +441,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Factura B (con IVA discriminado).
@@ -425,6 +453,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Factura C (consumidor final, sin discriminación de IVA).
@@ -434,6 +463,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         buyer?: Buyer;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite un Recibo A (con IVA discriminado).
@@ -444,6 +474,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite un Recibo B (con IVA discriminado).
@@ -454,6 +485,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite un Recibo C (sin discriminación de IVA).
@@ -463,6 +495,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         buyer?: Buyer;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Crédito A.
@@ -475,6 +508,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Crédito B.
@@ -487,6 +521,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Crédito C.
@@ -498,6 +533,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         buyer?: Buyer;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Débito A.
@@ -510,6 +546,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Débito B.
@@ -522,6 +559,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Débito C.
@@ -533,6 +571,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         buyer?: Buyer;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Consulta un comprobante ya emitido (FECompConsultar).

package/dist/index.d.ts

@@ -216,6 +216,8 @@ interface Buyer {
     docType: TaxIdType;
     /** Número de documento (sin guiones) */
     docNumber: string;
+    /** Opcional: Condición frente al IVA del receptor (ej: 5 para Consumidor Final, 2 para Monotributo) */
+    vatCondition?: number;
 }
 /**
  * Comprobante asociado (Requerido al emitir Notas de Crédito/Débito)
@@ -232,6 +234,23 @@ interface AssociatedInvoice {
     /** Fecha de emisión del comprobante original */
     date?: Date;
 }
+/**
+ * Campo opcional de AFIP (ej. Condición IVA Receptor RG 5616)
+ */
+interface InvoiceOptional {
+    /** ID del dato opcional (ej. 1010) */
+    id: string | number;
+    /** Valor del dato opcional */
+    value: string;
+}
+/**
+ * Fechas de servicio (Obligatorio si concept es 2 o 3)
+ */
+interface ServiceDates {
+    startDate: Date;
+    endDate: Date;
+    dueDate: Date;
+}
 /**
  * Request para emitir comprobante
  */
@@ -246,6 +265,8 @@ interface IssueInvoiceRequest {
     items?: InvoiceItem[];
     /** Comprobantes asociados (Obligatorio para Nota de Crédito/Débito) */
     associatedInvoices?: AssociatedInvoice[];
+    /** Fechas de servicio (Obligatorio si concept es 2 o 3) */
+    serviceDates?: ServiceDates;
     /** Monto total (requerido si no hay items) */
     total?: number;
     /** Desglose de IVA (requerido para Factura A/B) */
@@ -258,6 +279,8 @@ interface IssueInvoiceRequest {
     includesVAT?: boolean;
     /** Fecha del comprobante (default: hoy) */
     date?: Date;
+    /** Campos opcionales adjuntos (ej: Condición IVA receptor ID 1010) */
+    optionals?: InvoiceOptional[];
 }
 /**
  * Respuesta CAE (Código de Autorización Electrónico)
@@ -320,6 +343,8 @@ interface InvoiceDetails {
     caeExpiry: string;
     /** Resultado */
     result: 'A' | 'R';
+    /** Campos opcionales adjuntos */
+    optionals?: InvoiceOptional[];
 }
 /**
  * Punto de venta habilitado en ARCA
@@ -394,6 +419,7 @@ declare class WsfeService {
         total: number;
         concept?: BillingConcept;
         date?: Date;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite un Ticket C con detalle de items.
@@ -403,6 +429,7 @@ declare class WsfeService {
         items: InvoiceItem[];
         concept?: BillingConcept;
         date?: Date;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Factura A (Responsable Inscripto a Responsable Inscripto, con IVA discriminado).
@@ -414,6 +441,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Factura B (con IVA discriminado).
@@ -425,6 +453,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Factura C (consumidor final, sin discriminación de IVA).
@@ -434,6 +463,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         buyer?: Buyer;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite un Recibo A (con IVA discriminado).
@@ -444,6 +474,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite un Recibo B (con IVA discriminado).
@@ -454,6 +485,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite un Recibo C (sin discriminación de IVA).
@@ -463,6 +495,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         buyer?: Buyer;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Crédito A.
@@ -475,6 +508,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Crédito B.
@@ -487,6 +521,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Crédito C.
@@ -498,6 +533,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         buyer?: Buyer;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Débito A.
@@ -510,6 +546,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Débito B.
@@ -522,6 +559,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         includesVAT?: boolean;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Emite una Nota de Débito C.
@@ -533,6 +571,7 @@ declare class WsfeService {
         concept?: BillingConcept;
         date?: Date;
         buyer?: Buyer;
+        optionals?: InvoiceOptional[];
     }): Promise<CAEResponse>;
     /**
      * Consulta un comprobante ya emitido (FECompConsultar).

package/dist/index.js

@@ -678,7 +678,8 @@ var WsfeService = class _WsfeService {
       buyer: {
         docType: 99 /* FINAL_CONSUMER */,
         docNumber: "0"
-      }
+      },
+      optionals: params.optionals
     });
   }
   /**
@@ -695,7 +696,8 @@ var WsfeService = class _WsfeService {
       buyer: {
         docType: 99 /* FINAL_CONSUMER */,
         docNumber: "0"
-      }
+      },
+      optionals: params.optionals
     });
     return { ...cae, items: params.items };
   }
@@ -847,6 +849,11 @@ var WsfeService = class _WsfeService {
       );
     }
     const det = data.ResultGet;
+    let optionals;
+    if (det.Opcionales && det.Opcionales.Opcional) {
+      const optList = Array.isArray(det.Opcionales.Opcional) ? det.Opcionales.Opcional : [det.Opcionales.Opcional];
+      optionals = optList.map((o) => ({ id: String(o.Id), value: String(o.Valor) }));
+    }
     return {
       invoiceType: Number(det.CbteTipo),
       pointOfSale: Number(det.PtoVta),
@@ -860,7 +867,8 @@ var WsfeService = class _WsfeService {
       vat: Number(det.ImpIVA),
       cae: String(det.CodAutorizacion),
       caeExpiry: String(det.FchVto),
-      result: det.Resultado
+      result: det.Resultado,
+      optionals
     };
   }
   /**
@@ -933,7 +941,9 @@ var WsfeService = class _WsfeService {
       associatedInvoices: params.associatedInvoices,
       date: params.date,
       vatData,
-      includesVAT
+      includesVAT,
+      optionals: params.optionals,
+      serviceDates: params.serviceDates
     });
   }
   /**
@@ -952,7 +962,9 @@ var WsfeService = class _WsfeService {
         docNumber: "0"
       },
       items: params.items,
-      associatedInvoices: params.associatedInvoices
+      associatedInvoices: params.associatedInvoices,
+      optionals: params.optionals,
+      serviceDates: params.serviceDates
     });
   }
   /**
@@ -999,10 +1011,12 @@ var WsfeService = class _WsfeService {
       date: request.date || /* @__PURE__ */ new Date(),
       buyer: request.buyer,
       associatedInvoices: request.associatedInvoices,
+      serviceDates: request.serviceDates,
       net,
       vat,
       total,
-      vatData: request.vatData
+      vatData: request.vatData,
+      optionals: request.optionals
     });
     const endpoint = getWsfeEndpoint(this.config.environment);
     const response = await callArcaApi(endpoint, {
@@ -1159,6 +1173,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/">
@@ -1180,7 +1219,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>
@@ -1191,9 +1230,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>