facturas 0.5.2 → 0.6.1

package/dist/wsmtxca.mjs

@@ -7,158 +7,306 @@ var ArcaError = class extends Error {
     this.code = code;
   }
 };
+var ArcaInputError = class extends ArcaError {
+  name = "ArcaInputError";
+  detail;
+  constructor(message, options) {
+    super(message, "ARCA_INPUT_ERROR", options);
+    this.detail = options?.detail;
+  }
+};
+var ArcaTransportError = class extends ArcaError {
+  name = "ArcaTransportError";
+  statusCode;
+  contentType;
+  responseBody;
+  constructor(message, options) {
+    super(message, "ARCA_TRANSPORT_ERROR", options);
+    this.statusCode = options?.statusCode;
+    this.contentType = options?.contentType;
+    this.responseBody = options?.responseBody;
+  }
+};
+var ArcaSoapFaultError = class extends ArcaError {
+  name = "ArcaSoapFaultError";
+  faultCode;
+  detail;
+  constructor(message, options) {
+    super(message, "ARCA_SOAP_FAULT", options);
+    this.faultCode = options?.faultCode;
+    this.detail = options?.detail;
+  }
+};
+var ArcaInvalidSoapResponseError = class extends ArcaError {
+  name = "ArcaInvalidSoapResponseError";
+  service;
+  operation;
+  endpointUrl;
+  statusCode;
+  contentType;
+  responseBodyLength;
+  responseBodyPreview;
+  parsedDetail;
+  constructor(message, options) {
+    super(message, "ARCA_INVALID_SOAP_RESPONSE", options);
+    this.service = options?.service;
+    this.operation = options?.operation;
+    this.endpointUrl = options?.endpointUrl;
+    this.statusCode = options?.statusCode;
+    this.contentType = options?.contentType;
+    this.responseBodyLength = options?.responseBodyLength;
+    this.responseBodyPreview = options?.responseBodyPreview;
+    this.parsedDetail = options?.parsedDetail;
+  }
+};
 var ArcaServiceError = class extends ArcaError {
   name = "ArcaServiceError";
   serviceCode;
+  service;
+  operation;
+  result;
+  resultLevel;
+  results;
+  cae;
+  issues;
   detail;
   constructor(message, options) {
     super(message, "ARCA_SERVICE_ERROR", options);
     this.serviceCode = options?.serviceCode;
+    this.service = options?.service;
+    this.operation = options?.operation;
+    this.result = options?.result;
+    this.resultLevel = options?.resultLevel;
+    this.results = options?.results;
+    this.cae = options?.cae;
+    this.issues = options?.issues;
     this.detail = options?.detail;
   }
 };
 
 // src/services/wsmtxca.ts
 function createWsmtxcaService(options) {
-  return {
-    async authorizeVoucher({ representedTaxId, data, forceRefresh }) {
-      const auth = await options.auth.login("wsmtxca", {
-        representedTaxId,
-        forceRefresh
-      });
-      const response = await options.soap.execute({
-        service: "wsmtxca",
-        operation: "autorizarComprobante",
-        bodyElementName: "autorizarComprobanteRequest",
-        bodyElementNamespaceMode: "prefix",
-        body: {
-          authRequest: createWsmtxcaAuth(
-            representedTaxId ?? options.config.taxId,
-            auth.token,
-            auth.sign
-          ),
-          ...data
-        }
-      });
-      const raw = unwrapWsmtxcaOperationResponse(
-        response.result,
-        "autorizarComprobante"
-      );
-      const authorizationPayload = extractWsmtxcaAuthorizationPayload(raw);
-      const messages = extractWsmtxcaMessages(raw);
-      const resultado = raw.resultado ?? authorizationPayload.resultado;
-      const caeValue = authorizationPayload.CAE ?? authorizationPayload.codigoAutorizacion ?? raw.codigoAutorizacion;
-      if (resultado === "R" || caeValue == null) {
-        throw new ArcaServiceError(
-          messages.join(" | ") || "WSMTXCA rejected the voucher authorization",
-          { detail: raw }
-        );
+  async function executeWsmtxcaAuthenticatedOperation(operation, input, body = {}, retries) {
+    const auth = await options.auth.login("wsmtxca", {
+      representedTaxId: input.representedTaxId,
+      forceRefresh: input.forceRefresh
+    });
+    const response = await options.soap.execute({
+      service: "wsmtxca",
+      operation,
+      ...retries === void 0 ? {} : { retries },
+      bodyElementName: `${operation}Request`,
+      bodyElementNamespaceMode: "prefix",
+      body: {
+        ...body,
+        authRequest: createWsmtxcaAuth(
+          input.representedTaxId ?? options.config.taxId,
+          auth.token,
+          auth.sign
+        )
       }
+    });
+    return unwrapWsmtxcaOperationResponse(response.result, operation);
+  }
+  async function executeWsmtxcaAuthorization({
+    representedTaxId,
+    data,
+    forceRefresh
+  }) {
+    if (Object.hasOwn(data, "authRequest")) {
+      throw new ArcaInputError(
+        'WSMTXCA authorization data cannot include the reserved top-level field "authRequest".'
+      );
+    }
+    try {
+      const raw = await executeWsmtxcaAuthenticatedOperation(
+        "autorizarComprobante",
+        { representedTaxId, forceRefresh },
+        data,
+        0
+      );
+      return { outcome: classifyWsmtxcaAuthorization(raw) };
+    } catch (error) {
       return {
-        cae: String(caeValue),
-        caeExpiry: normalizeWsmtxcaResponseDate(
-          authorizationPayload.fechaVencimientoCAE ?? authorizationPayload.fechaVencimiento ?? raw.fechaVencimiento
-        ),
-        voucherNumber: parseWsmtxcaVoucherNumber(
-          authorizationPayload.numeroComprobante ?? raw.numeroComprobante,
-          "WSMTXCA did not return the authorized voucher number",
-          raw
-        ),
-        messages,
-        raw
+        outcome: createWsmtxcaIndeterminateOutcome(error),
+        error
       };
-    },
-    async getLastAuthorizedVoucher({
-      representedTaxId,
-      voucherType,
-      salesPoint,
-      forceRefresh
-    }) {
-      const auth = await options.auth.login("wsmtxca", {
-        representedTaxId,
-        forceRefresh
-      });
-      const response = await options.soap.execute({
-        service: "wsmtxca",
-        operation: "consultarUltimoComprobanteAutorizado",
-        bodyElementName: "consultarUltimoComprobanteAutorizadoRequest",
-        bodyElementNamespaceMode: "prefix",
-        body: {
-          authRequest: createWsmtxcaAuth(
-            representedTaxId ?? options.config.taxId,
-            auth.token,
-            auth.sign
-          ),
-          consultaUltimoComprobanteAutorizadoRequest: {
-            codigoTipoComprobante: voucherType,
-            numeroPuntoVenta: salesPoint
-          }
+    }
+  }
+  async function authorizeVoucherOutcome(input) {
+    return (await executeWsmtxcaAuthorization(input)).outcome;
+  }
+  async function authorizeVoucher(input) {
+    const execution = await executeWsmtxcaAuthorization(input);
+    if (execution.error) {
+      throw execution.error;
+    }
+    if (execution.outcome.kind !== "authorized") {
+      throw createWsmtxcaOutcomeError(execution.outcome);
+    }
+    const { outcome } = execution;
+    return {
+      cae: outcome.cae,
+      ...outcome.caeExpiry === void 0 ? {} : { caeExpiry: outcome.caeExpiry },
+      voucherNumber: outcome.voucherNumber,
+      messages: formatWsmtxcaIssues([
+        ...outcome.errors,
+        ...outcome.observations
+      ]),
+      raw: outcome.raw ?? {}
+    };
+  }
+  async function getLastAuthorizedVoucher({
+    representedTaxId,
+    voucherType,
+    salesPoint,
+    forceRefresh
+  }) {
+    const operation = "consultarUltimoComprobanteAutorizado";
+    const raw = await executeWsmtxcaAuthenticatedOperation(
+      operation,
+      { representedTaxId, forceRefresh },
+      {
+        consultaUltimoComprobanteAutorizadoRequest: {
+          codigoTipoComprobante: voucherType,
+          numeroPuntoVenta: salesPoint
         }
-      });
-      const raw = unwrapWsmtxcaOperationResponse(
-        response.result,
-        "consultarUltimoComprobanteAutorizado"
-      );
+      }
+    );
+    const errors = extractWsmtxcaIssues(raw, operation, "error");
+    if (errors.length > 0 && errors.every((issue) => issue.code === "1502")) {
+      return { voucherNumber: 0, raw };
+    }
+    if (errors.length > 0) {
+      throw createWsmtxcaServiceError(operation, raw, errors);
+    }
+    return {
+      voucherNumber: parseWsmtxcaVoucherNumber(
+        raw.numeroComprobante ?? raw.cbteNro ?? raw.nroComprobante,
+        "WSMTXCA did not return the last authorized voucher number",
+        raw,
+        true
+      ),
+      raw
+    };
+  }
+  async function getSalesPoints({
+    representedTaxId,
+    forceRefresh
+  }) {
+    const raw = await executeWsmtxcaAuthenticatedOperation(
+      "consultarPuntosVenta",
+      { representedTaxId, forceRefresh }
+    );
+    const rawSalesPoints = toRecord(raw.arrayPuntosVenta)?.puntoVenta;
+    const entries = Array.isArray(rawSalesPoints) ? rawSalesPoints : rawSalesPoints ? [rawSalesPoints] : [];
+    const salesPoints = entries.flatMap((entry) => {
+      const record = toRecord(entry);
+      const number = parseOptionalPositiveInteger(record?.numeroPuntoVenta);
+      if (number === void 0) {
+        return [];
+      }
+      const deletedAt = normalizeWsmtxcaResponseDate(record?.fechaBaja);
+      return [
+        {
+          number,
+          blocked: String(record?.bloqueado ?? "N").toUpperCase() === "S",
+          ...deletedAt === void 0 ? {} : { deletedAt }
+        }
+      ];
+    });
+    return { salesPoints, raw };
+  }
+  async function lookupVoucher({
+    representedTaxId,
+    voucherType,
+    salesPoint,
+    voucherNumber,
+    forceRefresh
+  }) {
+    const operation = "consultarComprobante";
+    const raw = await executeWsmtxcaAuthenticatedOperation(
+      operation,
+      { representedTaxId, forceRefresh },
+      {
+        consultaComprobanteRequest: {
+          codigoTipoComprobante: voucherType,
+          numeroPuntoVenta: salesPoint,
+          numeroComprobante: voucherNumber
+        }
+      }
+    );
+    const errors = extractWsmtxcaIssues(raw, operation, "error");
+    const observations = extractWsmtxcaIssues(raw, operation, "observation");
+    if (errors.length > 0 && errors.every((issue) => issue.code === "1503")) {
       return {
-        voucherNumber: parseWsmtxcaVoucherNumber(
-          raw.numeroComprobante ?? raw.cbteNro ?? raw.nroComprobante,
-          extractWsmtxcaMessages(raw).join(" | ") || "WSMTXCA did not return the last authorized voucher number",
-          raw
-        ),
+        kind: "not_found",
+        service: "wsmtxca",
+        operation,
+        errors,
+        observations,
         raw
       };
-    },
-    async getVoucher({
-      representedTaxId,
-      voucherType,
-      salesPoint,
-      voucherNumber,
-      forceRefresh
-    }) {
-      const auth = await options.auth.login("wsmtxca", {
-        representedTaxId,
-        forceRefresh
-      });
-      const response = await options.soap.execute({
-        service: "wsmtxca",
-        operation: "consultarComprobante",
-        bodyElementName: "consultarComprobanteRequest",
-        bodyElementNamespaceMode: "prefix",
-        body: {
-          authRequest: createWsmtxcaAuth(
-            representedTaxId ?? options.config.taxId,
-            auth.token,
-            auth.sign
-          ),
-          consultaComprobanteRequest: {
-            codigoTipoComprobante: voucherType,
-            numeroPuntoVenta: salesPoint,
-            numeroComprobante: voucherNumber
-          }
+    }
+    if (errors.length > 0) {
+      throw createWsmtxcaServiceError(operation, raw, errors);
+    }
+    const voucher = extractWsmtxcaVoucherPayload(raw);
+    if (voucher === raw && !toRecord(raw.comprobante)) {
+      throw new ArcaServiceError(
+        "WSMTXCA did not return the voucher issue date",
+        {
+          service: "wsmtxca",
+          operation,
+          issues: observations,
+          detail: raw
         }
-      });
-      const raw = unwrapWsmtxcaOperationResponse(
-        response.result,
-        "consultarComprobante"
       );
-      const voucher = extractWsmtxcaVoucherPayload(raw);
-      const messages = extractWsmtxcaMessages(raw);
-      const invoiceDate = normalizeWsmtxcaResponseDate(
-        voucher.fechaEmision ?? voucher.fecha ?? voucher.CbteFch
+    }
+    return {
+      kind: "found",
+      service: "wsmtxca",
+      operation,
+      voucher: mapWsmtxcaVoucherInfo(voucher),
+      observations,
+      raw
+    };
+  }
+  async function getVoucher(input) {
+    const lookup = await lookupVoucher(input);
+    if (lookup.kind === "not_found") {
+      throw createWsmtxcaServiceError(
+        lookup.operation,
+        lookup.raw,
+        lookup.errors
       );
-      if (!invoiceDate) {
-        throw new ArcaServiceError(
-          messages[0] ?? "WSMTXCA did not return the voucher issue date",
-          { detail: raw }
-        );
-      }
-      return {
-        invoiceDate,
-        voucher,
-        messages,
-        raw
-      };
     }
+    const invoiceDate = lookup.voucher.invoiceDate;
+    if (!invoiceDate) {
+      throw new ArcaServiceError(
+        formatWsmtxcaIssues(lookup.observations)[0] ?? "WSMTXCA did not return the voucher issue date",
+        {
+          service: "wsmtxca",
+          operation: lookup.operation,
+          issues: lookup.observations,
+          detail: lookup.raw
+        }
+      );
+    }
+    return {
+      invoiceDate,
+      voucher: lookup.voucher.raw,
+      messages: formatWsmtxcaIssues(lookup.observations),
+      raw: lookup.raw
+    };
+  }
+  return {
+    authorizeVoucherOutcome,
+    authorizeVoucher,
+    getLastAuthorizedVoucher,
+    getSalesPoints,
+    lookupVoucher,
+    getVoucher
   };
 }
 function createWsmtxcaAuth(representedTaxId, token, sign) {
@@ -169,7 +317,7 @@ function createWsmtxcaAuth(representedTaxId, token, sign) {
   };
 }
 function toRecord(value) {
-  return value && typeof value === "object" ? value : void 0;
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
 function unwrapWsmtxcaOperationResponse(response, operation) {
   const responseRecord = toRecord(response) ?? {};
@@ -179,6 +327,9 @@ function unwrapWsmtxcaOperationResponse(response, operation) {
   if (operation === "consultarComprobante") {
     return toRecord(responseRecord.consultarComprobanteResponse) ?? toRecord(responseRecord.consultaComprobanteResponse) ?? toRecord(responseRecord.consultarComprobanteResult) ?? responseRecord;
   }
+  if (operation === "consultarPuntosVenta") {
+    return toRecord(responseRecord.consultarPuntosVentaResponse) ?? toRecord(responseRecord.consultarPuntosVentaResult) ?? responseRecord;
+  }
   return toRecord(responseRecord.consultarUltimoComprobanteAutorizadoResponse) ?? toRecord(responseRecord.consultaUltimoComprobanteAutorizadoResponse) ?? toRecord(responseRecord.consultarUltimoComprobanteAutorizadoResult) ?? responseRecord;
 }
 function extractWsmtxcaAuthorizationPayload(raw) {
@@ -187,42 +338,291 @@ function extractWsmtxcaAuthorizationPayload(raw) {
 function extractWsmtxcaVoucherPayload(raw) {
   return toRecord(raw.comprobanteResponse) ?? toRecord(raw.comprobante) ?? toRecord(raw.cmp) ?? raw;
 }
-function extractWsmtxcaMessages(raw) {
-  const rawErrors = raw.arrayErrores;
-  const rawObservations = raw.arrayObservaciones;
-  const toEntries = (value) => {
-    if (!value) {
-      return [];
-    }
-    if (Array.isArray(value)) {
-      return value;
+function classifyWsmtxcaAuthorization(raw) {
+  const operation = "autorizarComprobante";
+  const payload = extractWsmtxcaAuthorizationPayload(raw);
+  const result = normalizeWsmtxcaResult(raw.resultado ?? payload.resultado);
+  const cae = normalizeWsmtxcaString(
+    payload.CAE ?? payload.codigoAutorizacion ?? raw.codigoAutorizacion
+  );
+  const caeExpiry = normalizeWsmtxcaResponseDate(
+    payload.fechaVencimientoCAE ?? payload.fechaVencimiento ?? raw.fechaVencimiento
+  );
+  const voucherNumber = parseOptionalPositiveInteger(
+    payload.numeroComprobante ?? raw.numeroComprobante
+  );
+  const errors = extractWsmtxcaIssues(raw, operation, "error");
+  const observations = extractWsmtxcaIssues(raw, operation, "observation");
+  const base = {
+    service: "wsmtxca",
+    operation,
+    results: createWsmtxcaResults(result),
+    errors,
+    observations,
+    raw
+  };
+  if ((result === "A" || result === "O") && cae && voucherNumber !== void 0 && errors.length === 0) {
+    return {
+      ...base,
+      kind: "authorized",
+      result,
+      resultLevel: "operation",
+      cae,
+      ...caeExpiry === void 0 ? {} : { caeExpiry },
+      voucherNumber
+    };
+  }
+  if (result === "R" && !cae && errors.length > 0) {
+    return {
+      ...base,
+      kind: "rejected",
+      result: "R",
+      resultLevel: "operation"
+    };
+  }
+  const outcome = {
+    ...base,
+    kind: "indeterminate",
+    reason: result === "R" && Boolean(cae) || (result === "A" || result === "O") && Boolean(errors.length) ? "contradictory_response" : "incomplete_response",
+    ...result === void 0 ? {} : { result },
+    ...result === void 0 ? {} : { resultLevel: "operation" }
+  };
+  assignWsmtxcaValue(outcome, "cae", cae);
+  assignWsmtxcaValue(outcome, "caeExpiry", caeExpiry);
+  assignWsmtxcaValue(outcome, "voucherNumber", voucherNumber);
+  return outcome;
+}
+function createWsmtxcaIndeterminateOutcome(error) {
+  return {
+    kind: "indeterminate",
+    service: "wsmtxca",
+    operation: "autorizarComprobante",
+    results: {},
+    reason: getWsmtxcaIndeterminateReason(error),
+    errors: [],
+    observations: []
+  };
+}
+function getWsmtxcaIndeterminateReason(error) {
+  if (error instanceof ArcaTransportError) {
+    return "transport_error";
+  }
+  if (error instanceof ArcaSoapFaultError) {
+    return "soap_fault";
+  }
+  if (error instanceof ArcaInvalidSoapResponseError) {
+    return "invalid_response";
+  }
+  return "unexpected_error";
+}
+function createWsmtxcaOutcomeError(outcome) {
+  const issues = [...outcome.errors, ...outcome.observations];
+  const messages = formatWsmtxcaIssues(issues);
+  const firstIssue = issues[0];
+  return new ArcaServiceError(
+    messages.join(" | ") || (outcome.kind === "rejected" ? "WSMTXCA rejected the voucher authorization" : "WSMTXCA did not return conclusive voucher authorization data"),
+    {
+      service: "wsmtxca",
+      operation: outcome.operation,
+      ...firstIssue?.code === void 0 ? {} : { serviceCode: firstIssue.code },
+      ...outcome.result === void 0 ? {} : { result: outcome.result },
+      ...outcome.resultLevel === void 0 ? {} : { resultLevel: outcome.resultLevel },
+      results: outcome.results,
+      ...outcome.kind === "indeterminate" && outcome.cae ? { cae: outcome.cae } : {},
+      issues,
+      detail: outcome.raw
     }
-    if (typeof value === "object") {
-      return [value];
+  );
+}
+function createWsmtxcaResults(operationResult) {
+  const results = {};
+  assignWsmtxcaValue(results, "operation", operationResult);
+  return results;
+}
+function createWsmtxcaServiceError(operation, raw, issues) {
+  const firstIssue = issues[0];
+  return new ArcaServiceError(
+    formatWsmtxcaIssues(issues).join(" | ") || "WSMTXCA returned a service error",
+    {
+      service: "wsmtxca",
+      operation,
+      ...firstIssue?.code === void 0 ? {} : { serviceCode: firstIssue.code },
+      issues,
+      detail: raw
     }
-    return [];
-  };
-  const errors = toEntries(rawErrors?.codigoDescripcion).map((entry) => {
-    const code = entry.codigo == null ? "N/A" : String(entry.codigo);
-    const description = entry.descripcion == null ? "Unknown WSMTXCA error" : String(entry.descripcion);
-    return `Error ${code}: ${description}`;
+  );
+}
+function extractWsmtxcaIssues(raw, operation, source) {
+  const container = toRecord(
+    source === "error" ? raw.arrayErrores : raw.arrayObservaciones
+  );
+  return normalizeWsmtxcaIssueEntries(container?.codigoDescripcion).map(
+    (entry) => ({
+      service: "wsmtxca",
+      operation,
+      source,
+      category: source === "observation" ? "observation" : operation === "autorizarComprobante" ? "business" : "unknown",
+      ...entry.code === void 0 ? {} : { code: entry.code },
+      message: entry.message,
+      ...operation === "autorizarComprobante" ? { resultLevel: "operation" } : {}
+    })
+  );
+}
+function normalizeWsmtxcaIssueEntries(value) {
+  const entries = Array.isArray(value) ? value : value ? [value] : [];
+  return entries.map((entry) => {
+    const record = toRecord(entry) ?? {};
+    const code = record.codigo;
+    const description = record.descripcion;
+    return {
+      ...code === void 0 || code === null ? {} : { code: String(code) },
+      message: description === void 0 || description === null ? "Unknown WSMTXCA issue" : String(description)
+    };
   });
-  const observations = toEntries(rawObservations?.codigoDescripcion).map(
-    (entry) => {
-      const code = entry.codigo == null ? "N/A" : String(entry.codigo);
-      const description = entry.descripcion == null ? "" : String(entry.descripcion);
-      return `Obs ${code}: ${description}`.trim();
-    }
+}
+function formatWsmtxcaIssues(issues) {
+  return issues.map((issue) => {
+    const prefix = issue.source === "error" ? "Error" : "Obs";
+    return `${prefix}${issue.code ? ` ${issue.code}` : ""}: ${issue.message}`;
+  });
+}
+function mapWsmtxcaVoucherInfo(raw) {
+  const voucher = { raw };
+  const invoiceDate = normalizeWsmtxcaResponseDate(
+    raw.fechaEmision ?? raw.fecha ?? raw.CbteFch
+  );
+  const cae = normalizeWsmtxcaString(raw.codigoAutorizacion ?? raw.CAE);
+  const caeExpiry = normalizeWsmtxcaResponseDate(
+    raw.fechaVencimiento ?? raw.fechaVencimientoCAE
+  );
+  const vatAmount = sumWsmtxcaVatAmounts(raw.arraySubtotalesIVA);
+  assignWsmtxcaValue(
+    voucher,
+    "voucherNumber",
+    parseOptionalPositiveInteger(raw.numeroComprobante)
   );
-  return [...errors, ...observations];
+  assignWsmtxcaValue(voucher, "invoiceDate", invoiceDate);
+  assignWsmtxcaValue(
+    voucher,
+    "salesPoint",
+    parseOptionalPositiveInteger(raw.numeroPuntoVenta)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "voucherType",
+    parseOptionalPositiveInteger(raw.codigoTipoComprobante)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "concept",
+    parseOptionalNumber(raw.codigoConcepto)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "documentType",
+    parseOptionalNumber(raw.codigoTipoDocumento)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "documentNumber",
+    normalizeWsmtxcaString(raw.numeroDocumento)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "receiverVatConditionId",
+    parseOptionalNumber(raw.condicionIVAReceptor)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "totalAmount",
+    parseOptionalNumber(raw.importeTotal)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "subtotalAmount",
+    parseOptionalNumber(raw.importeSubtotal)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "taxableAmount",
+    parseOptionalNumber(raw.importeGravado)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "nonTaxableAmount",
+    parseOptionalNumber(raw.importeNoGravado)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "exemptAmount",
+    parseOptionalNumber(raw.importeExento)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "taxAmount",
+    parseOptionalNumber(raw.importeOtrosTributos)
+  );
+  assignWsmtxcaValue(voucher, "vatAmount", vatAmount);
+  assignWsmtxcaValue(
+    voucher,
+    "currencyId",
+    normalizeWsmtxcaString(raw.codigoMoneda)
+  );
+  assignWsmtxcaValue(
+    voucher,
+    "exchangeRate",
+    parseOptionalNumber(raw.cotizacionMoneda)
+  );
+  assignWsmtxcaValue(voucher, "cae", cae);
+  assignWsmtxcaValue(voucher, "caeExpiry", caeExpiry);
+  return voucher;
+}
+function sumWsmtxcaVatAmounts(value) {
+  const subtotals = toRecord(value)?.subtotalIVA;
+  const entries = Array.isArray(subtotals) ? subtotals : subtotals ? [subtotals] : [];
+  const amounts = entries.map((entry) => parseOptionalNumber(toRecord(entry)?.importe)).filter((amount) => amount !== void 0);
+  return amounts.length > 0 ? amounts.reduce((total, amount) => total + amount, 0) : void 0;
 }
-function parseWsmtxcaVoucherNumber(value, message, detail) {
+function parseWsmtxcaVoucherNumber(value, message, detail, allowZero = false) {
   const parsed = Number.parseInt(String(value ?? ""), 10);
-  if (!Number.isFinite(parsed) || parsed <= 0) {
-    throw new ArcaServiceError(message, { detail });
+  if (!Number.isFinite(parsed) || (allowZero ? parsed < 0 : parsed <= 0)) {
+    throw new ArcaServiceError(message, {
+      service: "wsmtxca",
+      detail
+    });
   }
   return parsed;
 }
+function parseOptionalPositiveInteger(value) {
+  const parsed = Number.parseInt(String(value ?? ""), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : void 0;
+}
+function parseOptionalNumber(value) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function normalizeWsmtxcaResult(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const normalized = value.trim().toUpperCase();
+  return normalized || void 0;
+}
+function normalizeWsmtxcaString(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  const normalized = String(value).trim();
+  return normalized || void 0;
+}
+function assignWsmtxcaValue(target, key, value) {
+  if (value !== void 0) {
+    target[key] = value;
+  }
+}
 function normalizeWsmtxcaResponseDate(value) {
   if (typeof value === "number" && Number.isInteger(value)) {
     return formatCompactDateToIso(value);