arca-sdk 1.0.4 → 1.1.1

package/dist/index.cjs

@@ -507,8 +507,17 @@ var WsaaService = class {
 // src/types/wsfe.ts
 var InvoiceType = /* @__PURE__ */ ((InvoiceType2) => {
   InvoiceType2[InvoiceType2["FACTURA_A"] = 1] = "FACTURA_A";
+  InvoiceType2[InvoiceType2["NOTA_DEBITO_A"] = 2] = "NOTA_DEBITO_A";
+  InvoiceType2[InvoiceType2["NOTA_CREDITO_A"] = 3] = "NOTA_CREDITO_A";
+  InvoiceType2[InvoiceType2["RECIBO_A"] = 4] = "RECIBO_A";
   InvoiceType2[InvoiceType2["FACTURA_B"] = 6] = "FACTURA_B";
+  InvoiceType2[InvoiceType2["NOTA_DEBITO_B"] = 7] = "NOTA_DEBITO_B";
+  InvoiceType2[InvoiceType2["NOTA_CREDITO_B"] = 8] = "NOTA_CREDITO_B";
+  InvoiceType2[InvoiceType2["RECIBO_B"] = 9] = "RECIBO_B";
   InvoiceType2[InvoiceType2["FACTURA_C"] = 11] = "FACTURA_C";
+  InvoiceType2[InvoiceType2["NOTA_DEBITO_C"] = 12] = "NOTA_DEBITO_C";
+  InvoiceType2[InvoiceType2["NOTA_CREDITO_C"] = 13] = "NOTA_CREDITO_C";
+  InvoiceType2[InvoiceType2["RECIBO_C"] = 15] = "RECIBO_C";
   InvoiceType2[InvoiceType2["TICKET_A"] = 81] = "TICKET_A";
   InvoiceType2[InvoiceType2["TICKET_B"] = 82] = "TICKET_B";
   InvoiceType2[InvoiceType2["TICKET_C"] = 83] = "TICKET_C";
@@ -715,7 +724,8 @@ var WsfeService = class _WsfeService {
       buyer: {
         docType: 99 /* FINAL_CONSUMER */,
         docNumber: "0"
-      }
+      },
+      optionals: params.optionals
     });
   }
   /**
@@ -732,62 +742,99 @@ var WsfeService = class _WsfeService {
       buyer: {
         docType: 99 /* FINAL_CONSUMER */,
         docNumber: "0"
-      }
+      },
+      optionals: params.optionals
     });
     return { ...cae, items: params.items };
   }
   /**
-   * Emite una Factura C (consumidor final, sin discriminación de IVA).
+   * Emite una Factura A (Responsable Inscripto a Responsable Inscripto, con IVA discriminado).
+   * REQUIERE `vatRate` en todos los items.
    */
-  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
-    });
+  async issueInvoiceA(params) {
+    return this.issueInvoiceWithVAT(1 /* FACTURA_A */, params);
   }
   /**
    * Emite una Factura B (con IVA discriminado).
    * REQUIERE `vatRate` en todos los items.
    */
   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,
-      buyer: params.buyer,
-      date: params.date,
-      vatData,
-      includesVAT
-    });
+    return this.issueInvoiceWithVAT(6 /* FACTURA_B */, params);
   }
   /**
-   * Emite una Factura A (Responsable Inscripto a Responsable Inscripto, con IVA discriminado).
-   * REQUIERE `vatRate` en todos los items.
+   * Emite una Factura C (consumidor final, sin discriminación de IVA).
    */
-  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
-    });
+  async issueInvoiceC(params) {
+    return this.issueInvoiceWithoutVAT(11 /* FACTURA_C */, params);
+  }
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // Recibos
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  /**
+   * Emite un Recibo A (con IVA discriminado).
+   */
+  async issueReceiptA(params) {
+    return this.issueInvoiceWithVAT(4 /* RECIBO_A */, params);
+  }
+  /**
+   * Emite un Recibo B (con IVA discriminado).
+   */
+  async issueReceiptB(params) {
+    return this.issueInvoiceWithVAT(9 /* RECIBO_B */, params);
+  }
+  /**
+   * Emite un Recibo C (sin discriminación de IVA).
+   */
+  async issueReceiptC(params) {
+    return this.issueInvoiceWithoutVAT(15 /* RECIBO_C */, params);
+  }
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // Notas de Crédito
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  /**
+   * Emite una Nota de Crédito A.
+   * REQUIERE especificar la Factura A original en `associatedInvoices`.
+   */
+  async issueCreditNoteA(params) {
+    return this.issueInvoiceWithVAT(3 /* NOTA_CREDITO_A */, params);
+  }
+  /**
+   * Emite una Nota de Crédito B.
+   * REQUIERE especificar la Factura B original en `associatedInvoices`.
+   */
+  async issueCreditNoteB(params) {
+    return this.issueInvoiceWithVAT(8 /* NOTA_CREDITO_B */, params);
+  }
+  /**
+   * Emite una Nota de Crédito C.
+   * REQUIERE especificar la Factura C original en `associatedInvoices`.
+   */
+  async issueCreditNoteC(params) {
+    return this.issueInvoiceWithoutVAT(13 /* NOTA_CREDITO_C */, params);
+  }
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  // Notas de Débito
+  // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  /**
+   * Emite una Nota de Débito A.
+   * REQUIERE especificar la Factura A original en `associatedInvoices`.
+   */
+  async issueDebitNoteA(params) {
+    return this.issueInvoiceWithVAT(2 /* NOTA_DEBITO_A */, params);
+  }
+  /**
+   * Emite una Nota de Débito B.
+   * REQUIERE especificar la Factura B original en `associatedInvoices`.
+   */
+  async issueDebitNoteB(params) {
+    return this.issueInvoiceWithVAT(7 /* NOTA_DEBITO_B */, params);
+  }
+  /**
+   * Emite una Nota de Débito C.
+   * REQUIERE especificar la Factura C original en `associatedInvoices`.
+   */
+  async issueDebitNoteC(params) {
+    return this.issueInvoiceWithoutVAT(12 /* NOTA_DEBITO_C */, params);
   }
   // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   // Consultas
@@ -848,6 +895,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),
@@ -861,7 +913,8 @@ var WsfeService = class _WsfeService {
       vat: Number(det.ImpIVA),
       cae: String(det.CodAutorizacion),
       caeExpiry: String(det.FchVto),
-      result: det.Resultado
+      result: det.Resultado,
+      optionals
     };
   }
   /**
@@ -918,6 +971,65 @@ var WsfeService = class _WsfeService {
   // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   // Métodos internos
   // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  /**
+   * Helper para emitir comprobantes tipo A/B que requieren IVA
+   */
+  async issueInvoiceWithVAT(type, params) {
+    this.validateItemsWithVAT(params.items);
+    this.validateAssociatedInvoices(type, params.associatedInvoices);
+    const includesVAT = params.includesVAT || false;
+    const vatData = this.calculateVATByRate(params.items, includesVAT);
+    return this.issueDocument({
+      type,
+      concept: params.concept || 1 /* PRODUCTS */,
+      items: params.items,
+      buyer: params.buyer,
+      associatedInvoices: params.associatedInvoices,
+      date: params.date,
+      vatData,
+      includesVAT,
+      optionals: params.optionals
+    });
+  }
+  /**
+   * Helper para emitir comprobantes tipo C que no discriminan IVA
+   */
+  async issueInvoiceWithoutVAT(type, params) {
+    this.validateAssociatedInvoices(type, params.associatedInvoices);
+    const total = round(calculateTotal(params.items));
+    return this.issueDocument({
+      type,
+      concept: params.concept || 1 /* PRODUCTS */,
+      total,
+      date: params.date,
+      buyer: params.buyer || {
+        docType: 99 /* FINAL_CONSUMER */,
+        docNumber: "0"
+      },
+      items: params.items,
+      associatedInvoices: params.associatedInvoices,
+      optionals: params.optionals
+    });
+  }
+  /**
+   * Validación obligatoria para NC/ND
+   */
+  validateAssociatedInvoices(type, associatedInvoices) {
+    const needsAssociation = [
+      3 /* NOTA_CREDITO_A */,
+      2 /* NOTA_DEBITO_A */,
+      8 /* NOTA_CREDITO_B */,
+      7 /* NOTA_DEBITO_B */,
+      13 /* NOTA_CREDITO_C */,
+      12 /* NOTA_DEBITO_C */
+    ].includes(type);
+    if (needsAssociation && (!associatedInvoices || associatedInvoices.length === 0)) {
+      throw new ArcaValidationError(
+        "Las Notas de Cr\xE9dito y D\xE9bito requieren al menos un comprobante asociado.",
+        { hint: "Debes enviar el arreglo `associatedInvoices` con la factura original a la cual haces referencia" }
+      );
+    }
+  }
   /**
    * Método genérico interno para emitir cualquier tipo de comprobante.
    */
@@ -942,10 +1054,12 @@ var WsfeService = class _WsfeService {
       concept: request.concept,
       date: request.date || /* @__PURE__ */ new Date(),
       buyer: request.buyer,
+      associatedInvoices: request.associatedInvoices,
       net,
       vat,
       total,
-      vatData: request.vatData
+      vatData: request.vatData,
+      optionals: request.optionals
     });
     const endpoint = getWsfeEndpoint(this.config.environment);
     const response = await callArcaApi(endpoint, {
@@ -1087,6 +1201,21 @@ var WsfeService = class _WsfeService {
       });
       vatXml += "\n      </ar:Iva>";
     }
+    let asocXml = "";
+    if (params.associatedInvoices && params.associatedInvoices.length > 0) {
+      asocXml = "<ar:CbtesAsoc>";
+      params.associatedInvoices.forEach((asoc) => {
+        asocXml += `
+        <ar:CbteAsoc>
+          <ar:Tipo>${asoc.type}</ar:Tipo>
+          <ar:PtoVta>${asoc.pointOfSale}</ar:PtoVta>
+          <ar:Nro>${asoc.invoiceNumber}</ar:Nro>
+          ${asoc.cuit ? `<ar:Cuit>${asoc.cuit}</ar:Cuit>` : ""}
+          ${asoc.date ? `<ar:CbteFch>${asoc.date.toISOString().split("T")[0].replace(/-/g, "")}</ar:CbteFch>` : ""}
+        </ar:CbteAsoc>`;
+      });
+      asocXml += "\n      </ar:CbtesAsoc>";
+    }
     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/">
@@ -1120,6 +1249,7 @@ var WsfeService = class _WsfeService {
             <ar:ImpTrib>0.00</ar:ImpTrib>
             <ar:MonId>PES</ar:MonId>
             <ar:MonCotiz>1</ar:MonCotiz>
+            ${asocXml}
             ${vatXml}
           </ar:FECAEDetRequest>
         </ar:FeDetReq>