facturas 0.9.0 → 0.10.0

package/dist/index.mjs

@@ -10,7 +10,7 @@ import {
   normalizeWsfeDateInput,
   normalizeWsfeVoucherInput,
   serializeArcaExchangeRate
-} from "./chunk-RCM4NAAG.mjs";
+} from "./chunk-QHHLHSBW.mjs";
 import {
   ARCA_CURRENCY_IDS,
   ARCA_DOCUMENT_TYPES,
@@ -22,8 +22,8 @@ import {
 } from "./chunk-76WU5BVI.mjs";
 import {
   createWsmtxcaService
-} from "./chunk-XNBD5NVL.mjs";
-import "./chunk-4QVFXT35.mjs";
+} from "./chunk-ALH5IPSY.mjs";
+import "./chunk-UDX6HLAU.mjs";
 import {
   ArcaAuthenticationError,
   ArcaConfigurationError,
@@ -379,18 +379,15 @@ function deriveWsfeInvoice(input, now = /* @__PURE__ */ new Date()) {
     ],
     "input"
   );
-  if (typeof input.issuer !== "string" || !Object.hasOwn(ARCA_ISSUER_CONDITION_IDS, input.issuer)) {
-    invalid(
-      "issuer",
-      "responsable_inscripto, monotributo, exento, or no_alcanzado"
-    );
-  }
-  if (!Number.isSafeInteger(input.salesPoint) || input.salesPoint < 1 || input.salesPoint > 99999) {
-    invalid("salesPoint", "an integer from 1 through 99999");
-  }
+  assertIssuerCondition(input.issuer);
+  assertSalesPoint(input.salesPoint);
   const receiver = deriveReceiver(input.to);
-  const voucherClass = ARCA_INVOICE_CLASS_BY_ISSUER[input.issuer][input.to.condition];
-  const { data: amountsData, amounts } = calculateWsfeAmounts(input);
+  const voucherClass = resolveInvoiceClass(input.issuer, input.to.condition);
+  const { data: amountsData, amounts } = calculateWsfeAmounts({
+    voucherClass,
+    items: input.items,
+    total: input.total
+  });
   const currency = deriveCurrency(input);
   if (input.to.condition === "consumidor_final" && receiver.documentType === ARCA_DOCUMENT_TYPES.CONSUMIDOR_FINAL) {
     const [whole, fraction = ""] = currency.exchangeRate.split(".");
@@ -430,6 +427,22 @@ function deriveWsfeInvoice(input, now = /* @__PURE__ */ new Date()) {
   }
   return { data, voucherClass, amounts };
 }
+function assertIssuerCondition(issuer) {
+  if (typeof issuer !== "string" || !Object.hasOwn(ARCA_ISSUER_CONDITION_IDS, issuer)) {
+    invalid(
+      "issuer",
+      "responsable_inscripto, monotributo, exento, or no_alcanzado"
+    );
+  }
+}
+function assertSalesPoint(salesPoint) {
+  if (!Number.isSafeInteger(salesPoint) || salesPoint < 1 || salesPoint > 99999) {
+    invalid("salesPoint", "an integer from 1 through 99999");
+  }
+}
+function resolveInvoiceClass(issuer, condition) {
+  return ARCA_INVOICE_CLASS_BY_ISSUER[issuer][condition];
+}
 function deriveReceiver(to) {
   assertIssueObject(to, "to");
   assertIssueKeys(to, ["condition", "cuit", "dni"], "to");
@@ -544,11 +557,11 @@ function assertIssueObject(value, field) {
     invalid(field, "an object");
   }
 }
-function assertIssueKeys(value, keys, prefix) {
+function assertIssueKeys(value, keys, prefix, method = "issue()") {
   for (const key of Object.keys(value)) {
     if (!keys.includes(key)) {
       const field = prefix === "input" ? key : `${prefix}.${key}`;
-      throw new ArcaInputError(`${field} is not supported by issue().`, {
+      throw new ArcaInputError(`${field} is not supported by ${method}.`, {
         code: "ARCA_INPUT_RESERVED_FIELD",
         field,
         expected: "a supported facade field; use the exact API for other fiscal fields"
@@ -564,7 +577,7 @@ function invalid(field, expected) {
   });
 }
 
-// src/services/wsfe-cancel.ts
+// src/services/wsfe-credit-note.ts
 var NOTES = {
   1: { voucherType: 3, voucherClass: "A" },
   6: { voucherType: 8, voucherClass: "B" },
@@ -572,7 +585,7 @@ var NOTES = {
 };
 function invalid2(reason) {
   throw new ArcaInputError(
-    `Cannot cancel: ${reason}. Use wsfe.issue() for exact control.`,
+    `issueCreditNote cannot proceed: ${reason}. Use wsfe.issue() for exact control.`,
     { code: "ARCA_INPUT_INVALID_VALUE" }
   );
 }
@@ -582,7 +595,52 @@ function required(value, field) {
   }
   return value;
 }
-function deriveWsfeCancellation(original, date, now = /* @__PURE__ */ new Date()) {
+function deriveWsfeFullCreditNote(original, input, now = /* @__PURE__ */ new Date()) {
+  const { note, header } = prepareCreditNote(original, input, now);
+  const data = {
+    ...header,
+    totalAmount: required(original.totalAmount, "totalAmount"),
+    netAmount: required(original.netAmount, "netAmount"),
+    vatAmount: required(original.vatAmount, "vatAmount"),
+    exemptAmount: required(original.exemptAmount, "exemptAmount"),
+    nonTaxableAmount: required(original.nonTaxableAmount, "nonTaxableAmount"),
+    taxAmount: required(original.taxAmount, "taxAmount"),
+    ...original.vatRates === void 0 ? {} : { vatRates: original.vatRates.map((rate) => ({ ...rate })) }
+  };
+  normalizeWsfeVoucherInput(data);
+  const total = Number(
+    normalizeArcaAmountToMinorUnits(data.totalAmount, "totalAmount")
+  );
+  return {
+    data,
+    voucherClass: note.voucherClass,
+    amounts: { computedTotal: total, sentTotal: total, vatAdjustment: 0 }
+  };
+}
+function deriveWsfePartialCreditNote(original, input, now = /* @__PURE__ */ new Date()) {
+  if (input.items === void 0) {
+    invalid2("items is required to credit chosen lines");
+  }
+  const { note, header } = prepareCreditNote(original, input, now);
+  const { data: amountsData, amounts } = calculateWsfeAmounts({
+    voucherClass: note.voucherClass,
+    items: input.items,
+    total: input.total
+  });
+  const originalTotal = normalizeArcaAmountToMinorUnits(
+    required(original.totalAmount, "totalAmount"),
+    "totalAmount"
+  );
+  if (BigInt(amounts.sentTotal) > originalTotal) {
+    invalid2(
+      "the note total is greater than the original; the SDK does not track earlier notes against an original"
+    );
+  }
+  const data = { ...header, ...amountsData };
+  normalizeWsfeVoucherInput(data);
+  return { data, voucherClass: note.voucherClass, amounts };
+}
+function prepareCreditNote(original, input, now) {
   const note = NOTES[original.voucherType ?? 0];
   if (!note) {
     invalid2("original must be an invoice of type 1, 6 or 11");
@@ -595,7 +653,7 @@ function deriveWsfeCancellation(original, date, now = /* @__PURE__ */ new Date()
     invalid2("unsupported currency; only ARS and USD are supported");
   }
   const voucherDate = normalizeWsfeDateInput(
-    date ?? buenosAiresDate(now),
+    input.date ?? buenosAiresDate(now),
     "date"
   );
   const originalDate = normalizeWsfeDateInput(
@@ -607,8 +665,8 @@ function deriveWsfeCancellation(original, date, now = /* @__PURE__ */ new Date()
       "original date is later than the note and outside its month (10210)"
     );
   }
-  const data = {
-    salesPoint: required(original.salesPoint, "salesPoint"),
+  const header = {
+    salesPoint: input.salesPoint ?? required(original.salesPoint, "salesPoint"),
     voucherType: note.voucherType,
     concept: required(original.concept, "concept"),
     documentType: required(original.documentType, "documentType"),
@@ -620,13 +678,6 @@ function deriveWsfeCancellation(original, date, now = /* @__PURE__ */ new Date()
     currencyId: original.currencyId,
     exchangeRate: required(original.exchangeRate, "exchangeRate"),
     voucherDate,
-    totalAmount: required(original.totalAmount, "totalAmount"),
-    netAmount: required(original.netAmount, "netAmount"),
-    vatAmount: required(original.vatAmount, "vatAmount"),
-    exemptAmount: required(original.exemptAmount, "exemptAmount"),
-    nonTaxableAmount: required(original.nonTaxableAmount, "nonTaxableAmount"),
-    taxAmount: required(original.taxAmount, "taxAmount"),
-    ...original.vatRates === void 0 ? {} : { vatRates: original.vatRates.map((rate) => ({ ...rate })) },
     associatedVouchers: [
       {
         type: required(original.voucherType, "voucherType"),
@@ -636,16 +687,8 @@ function deriveWsfeCancellation(original, date, now = /* @__PURE__ */ new Date()
       }
     ]
   };
-  copyServiceDates(original, data);
-  normalizeWsfeVoucherInput(data);
-  const total = Number(
-    normalizeArcaAmountToMinorUnits(data.totalAmount, "totalAmount")
-  );
-  return {
-    data,
-    voucherClass: note.voucherClass,
-    amounts: { computedTotal: total, sentTotal: total, vatAdjustment: 0 }
-  };
+  copyServiceDates(original, header);
+  return { note, header };
 }
 function rejectExtensions(original) {
   for (const [field, rawField] of [
@@ -668,15 +711,15 @@ function rejectExtensions(original) {
 function present(value) {
   return value !== void 0 && value !== null && value !== "" && (!Array.isArray(value) || value.length > 0);
 }
-function copyServiceDates(original, data) {
-  if (data.concept !== 2 && data.concept !== 3) {
+function copyServiceDates(original, header) {
+  if (header.concept !== 2 && header.concept !== 3) {
     return;
   }
-  data.serviceStartDate = required(
+  header.serviceStartDate = required(
     original.serviceStartDate,
     "serviceStartDate"
   );
-  data.serviceEndDate = required(
+  header.serviceEndDate = required(
     original.serviceEndDate,
     "serviceEndDate"
   );
@@ -684,7 +727,134 @@ function copyServiceDates(original, data) {
     required(original.paymentDueDate, "paymentDueDate"),
     "original.paymentDueDate"
   );
-  data.paymentDueDate = due < data.voucherDate ? data.voucherDate : due;
+  header.paymentDueDate = due < header.voucherDate ? header.voucherDate : due;
+}
+var CREDIT_NOTE_KEYS = ["for", "salesPoint", "date", "items", "total", "all"];
+var TARGET_BOUNDS = [
+  ["salesPoint", 99999],
+  ["voucherType", 999],
+  ["number", 99999999]
+];
+function assertCreditNoteInput(input) {
+  assertIssueObject(input, "input");
+  if ("associatedPeriod" in input) {
+    throw new ArcaInputError(
+      "issueCreditNote does not support associatedPeriod; a note against a period is exact-layer work. Use wsfe.issue() for exact control.",
+      {
+        code: "ARCA_INPUT_RESERVED_FIELD",
+        field: "associatedPeriod",
+        expected: "an associated invoice through for"
+      }
+    );
+  }
+  assertIssueKeys(input, CREDIT_NOTE_KEYS, "input", "issueCreditNote()");
+  const target = assertCreditNoteTarget(input.for);
+  if (input.salesPoint !== void 0) {
+    assertCreditNoteBound(input.salesPoint, 99999, "salesPoint");
+  }
+  const date = input.date === void 0 ? void 0 : normalizeWsfeDateInput(input.date, "date");
+  const common = {
+    for: target,
+    ...input.salesPoint === void 0 ? {} : { salesPoint: input.salesPoint },
+    ...date === void 0 ? {} : { date }
+  };
+  if (input.items === void 0 === (input.all === void 0)) {
+    throw new ArcaInputError(
+      "issueCreditNote needs exactly one mode: items for the credited lines, or all: true for the whole original.",
+      {
+        code: "ARCA_INPUT_INVALID_VALUE",
+        field: input.items === void 0 ? "input.items" : "input.all",
+        expected: "either items or all: true, never both and never neither"
+      }
+    );
+  }
+  if (input.all !== void 0) {
+    if (input.all !== true) {
+      throw new ArcaInputError(
+        "issueCreditNote accepts only all: true; pass items to credit chosen lines.",
+        {
+          code: "ARCA_INPUT_INVALID_VALUE",
+          field: "input.all",
+          expected: "the literal true"
+        }
+      );
+    }
+    if (input.total !== void 0) {
+      throw new ArcaInputError(
+        "issueCreditNote takes total only with items; all: true credits the original's own total.",
+        {
+          code: "ARCA_INPUT_INVALID_VALUE",
+          field: "input.total",
+          expected: "no total when all is true"
+        }
+      );
+    }
+    return { ...common, all: true };
+  }
+  return {
+    ...common,
+    items: copyCreditNoteItems(input.items),
+    ...input.total === void 0 ? {} : { total: input.total }
+  };
+}
+function assertCreditNoteTarget(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new ArcaInputError(
+      "issueCreditNote requires for: the coordinates of the authorized invoice the note corrects.",
+      {
+        code: "ARCA_INPUT_MISSING_FIELD",
+        field: "input.for",
+        expected: "{ salesPoint, voucherType, number }"
+      }
+    );
+  }
+  assertIssueKeys(
+    value,
+    ["salesPoint", "voucherType", "number"],
+    "input.for",
+    "issueCreditNote()"
+  );
+  for (const [field, max] of TARGET_BOUNDS) {
+    assertCreditNoteBound(value[field], max, `for.${field}`);
+  }
+  if (![1, 6, 11].includes(value.voucherType)) {
+    throw new ArcaInputError(
+      "issueCreditNote requires an authorized invoice of type 1, 6 or 11 in for.voucherType. Use wsfe.issue() for exact control.",
+      {
+        code: "ARCA_INPUT_INVALID_VALUE",
+        field: "input.for.voucherType",
+        expected: "1, 6 or 11"
+      }
+    );
+  }
+  return {
+    salesPoint: value.salesPoint,
+    voucherType: value.voucherType,
+    number: value.number
+  };
+}
+function assertCreditNoteBound(value, max, path) {
+  if (!Number.isSafeInteger(value) || value < 1 || value > max) {
+    throw new ArcaInputError(
+      `issueCreditNote requires input.${path} to be an integer from 1 through ${max}.`,
+      { code: "ARCA_INPUT_INVALID_VALUE", field: `input.${path}` }
+    );
+  }
+}
+function copyCreditNoteItems(items) {
+  if (!Array.isArray(items)) {
+    throw new ArcaInputError(
+      "issueCreditNote requires items to be a non-empty array of items.",
+      {
+        code: "ARCA_INPUT_INVALID_VALUE",
+        field: "input.items",
+        expected: "a non-empty array of items"
+      }
+    );
+  }
+  return items.map(
+    (item) => item === null || typeof item !== "object" ? item : { ...item }
+  );
 }
 
 // src/services/wsfe-identity.ts
@@ -932,8 +1102,13 @@ function associationIdentity(vouchers) {
 // src/services/vouchers.ts
 function createVouchersService(wsfe, context) {
   return {
-    cancel: async (target, options) => {
-      const result = await cancelInvoice(wsfe, target, options ?? {}, context);
+    issueCreditNote: async (input, options) => {
+      const result = await issueCreditNote(
+        wsfe,
+        input,
+        options === void 0 ? {} : options,
+        context
+      );
       return result;
     },
     issue: async (input, options) => {
@@ -944,7 +1119,27 @@ function createVouchersService(wsfe, context) {
         context
       );
       return result;
-    }
+    },
+    preview: (input, options) => previewInvoice(input, options === void 0 ? {} : options)
+  };
+}
+function previewInvoice(input, options) {
+  assertIssueObject(options, "options");
+  assertIssueKeys(options, ["representedTaxId"], "options");
+  if (options.representedTaxId !== void 0) {
+    issueDocumentNumber(
+      options.representedTaxId,
+      "options.representedTaxId",
+      11,
+      11
+    );
+  }
+  const { data, voucherClass, amounts } = deriveWsfeInvoice(input);
+  return {
+    voucherClass,
+    voucherType: data.voucherType,
+    amounts,
+    request: data
   };
 }
 async function issueInvoice(wsfe, input, options, context) {
@@ -1042,7 +1237,7 @@ function validateKeyStore(options, context) {
 function readRecord(json) {
   try {
     const record = JSON.parse(json);
-    if (!record || record.v !== 1 || !["issue", "cancel"].includes(record.operation) || typeof record.inputHash !== "string" || !record.sent || !Number.isSafeInteger(record.number) || record.number < 1 || record.number > 99999999 || record.sent.salesPoint !== record.salesPoint || record.sent.voucherType !== record.voucherType) {
+    if (!record || record.v !== 1 || !["issue", "creditNote"].includes(record.operation) || typeof record.inputHash !== "string" || !record.sent || !Number.isSafeInteger(record.number) || record.number < 1 || record.number > 99999999 || record.sent.salesPoint !== record.salesPoint || record.sent.voucherType !== record.voucherType) {
       throw new Error("Invalid reservation structure");
     }
     normalizeWsfeVoucherInput(record.sent);
@@ -1339,59 +1534,41 @@ function replayEvidence() {
     observations: []
   };
 }
-async function cancelInvoice(wsfe, target, options, context) {
-  assertIssueObject(options, "options");
-  const { date, ...issueOptions } = options;
-  validateOptions(issueOptions);
-  validateKeyStore(issueOptions, context);
-  assertIssueObject(target, "target");
-  for (const [field, max] of [
-    ["salesPoint", 99999],
-    ["voucherType", 999],
-    ["number", 99999999]
-  ]) {
-    if (!Number.isSafeInteger(target[field]) || target[field] < 1 || target[field] > max) {
-      throw new ArcaInputError(`Invalid cancel target ${field}.`, {
-        code: "ARCA_INPUT_INVALID_VALUE",
-        field
-      });
-    }
-  }
-  if (![1, 6, 11].includes(target.voucherType)) {
-    throw new ArcaInputError(
-      "cancel requires an invoice of type 1, 6 or 11; use wsfe.issue() for exact control.",
-      { code: "ARCA_INPUT_INVALID_VALUE" }
-    );
-  }
-  if (date !== void 0) {
-    normalizeWsfeDateInput(date, "date");
-  }
+async function issueCreditNote(wsfe, input, options, context) {
+  validateOptions(options);
+  validateKeyStore(options, context);
+  const note = assertCreditNoteInput(input);
+  const target = note.for;
   return await runOperation(
     wsfe,
-    "cancel",
-    { target, date },
+    "creditNote",
+    note,
     async () => {
       const original = await wsfe.lookupVoucher({
-        representedTaxId: issueOptions.representedTaxId,
-        forceRefresh: issueOptions.forceRefresh,
+        representedTaxId: options.representedTaxId,
+        forceRefresh: options.forceRefresh,
         salesPoint: target.salesPoint,
         voucherType: target.voucherType,
         number: target.number
       });
       if (original.kind === "not_found") {
-        throw new ArcaInputError("original voucher not found", {
-          code: "ARCA_INPUT_INVALID_VALUE"
-        });
+        throw new ArcaInputError(
+          "issueCreditNote failed: original voucher not found.",
+          {
+            code: "ARCA_INPUT_INVALID_VALUE",
+            field: "input.for"
+          }
+        );
       }
       if (original.voucher.salesPoint !== target.salesPoint || original.voucher.voucherType !== target.voucherType || original.voucher.voucherNumber !== target.number) {
         throw new ArcaInputError(
-          "Original lookup coordinates do not match the cancel target.",
-          { code: "ARCA_INPUT_INVALID_VALUE" }
+          "issueCreditNote failed: the original lookup coordinates do not match input.for.",
+          { code: "ARCA_INPUT_INVALID_VALUE", field: "input.for" }
         );
       }
-      return deriveWsfeCancellation(original.voucher, date);
+      return note.all === true ? deriveWsfeFullCreditNote(original.voucher, note) : deriveWsfePartialCreditNote(original.voucher, note);
     },
-    issueOptions,
+    options,
     context
   );
 }
@@ -2278,7 +2455,8 @@ function createArcaClient(config = {}) {
   return {
     config: publicConfig,
     issue: vouchers.issue,
-    cancel: vouchers.cancel,
+    preview: vouchers.preview,
+    issueCreditNote: vouchers.issueCreditNote,
     wsfe,
     wsmtxca: createWsmtxcaService({ config: normalizedConfig, auth, soap }),
     padron: createPadronService({ config: normalizedConfig, auth, soap })