@ramiidv/arca-mtxca 0.1.0 → 0.3.0

package/dist/mtxca-client.js

@@ -1,374 +1,466 @@
-import { afipSoapCall, ensureArray } from '@ramiidv/arca-common';
-import { MTXCA_ENDPOINTS, MTXCA_NAMESPACE } from './constants.js';
-function extractObservaciones(result) {
-    const obs = result['arrayObservaciones'];
-    if (!obs)
-        return [];
-    const arr = ensureArray(obs['codigoDescripcion']);
-    return arr.map((o) => ({
-        code: Number(o['codigo'] ?? 0),
-        msg: String(o['descripcion'] ?? ''),
-    }));
+import { afipSoapCall, checkServiceErrors } from '@ramiidv/arca-common';
+import { MTXCA_NAMESPACE } from './constants.js';
+import { buildComprobante, XsdFields } from './serialize.js';
+import { ResponseReader } from './parse.js';
+const SERVICE = 'WSMTXCA';
+function isResultado(value) {
+    return value === 'A' || value === 'O' || value === 'R';
 }
-function extractErrores(result) {
-    const errs = result['arrayErrores'];
-    if (!errs)
-        return [];
-    const arr = ensureArray(errs['codigoDescripcion']);
-    return arr.map((e) => ({
-        code: Number(e['codigo'] ?? 0),
-        msg: String(e['descripcion'] ?? ''),
-    }));
+function validated(build) {
+    const f = new XsdFields();
+    const value = build(f);
+    f.throwIfErrors('Parámetros inválidos');
+    return value;
 }
-function extractItems(result) {
-    const items = result['arrayItems'];
-    if (!items)
-        return [];
-    const arr = ensureArray(items['item']);
-    return arr.map((i) => ({
-        codigo: i['codigo'] != null ? String(i['codigo']) : undefined,
-        descripcion: String(i['descripcion'] ?? ''),
-        cantidad: Number(i['cantidad'] ?? 0),
-        unidadMedida: Number(i['unidadMedida'] ?? 0),
-        precioUnitario: Number(i['precioUnitario'] ?? 0),
-        importeItem: Number(i['importeItem'] ?? 0),
-        codigoCondicionIVA: Number(i['codigoCondicionIVA'] ?? 0),
-        importeIVA: Number(i['importeIVA'] ?? 0),
-        importeBonificacion: i['importeBonificacion'] != null
-            ? Number(i['importeBonificacion'])
-            : undefined,
-    }));
+function validCaea(caea) {
+    return validated((f) => f.codigoAutorizacion('caea', caea, true));
 }
 /**
- * Low-level client for the WSMTXCA web service.
- * Wraps each SOAP method. Does not handle authentication.
+ * Cliente de bajo nivel de WSMTXCA: una función por operación del WSDL. No
+ * maneja la autenticación (recibe `MtxcaAuth`) ni la numeración.
+ *
+ * - Valida los requests contra el XSD y redondea importes (`ArcaValidationError`).
+ * - Las consultas lanzan `ArcaServiceError` si ARCA devuelve `arrayErrores`.
+ * - Las emisiones (`autorizar*`, `informar*`, `solicitarCAEA`) usan
+ *   `kind: 'emision'`: no se reintentan y, si no hay respuesta, el
+ *   `ArcaSoapError` tiene `uncertain: true`.
  */
 export class MtxcaClient {
-    endpoint;
-    soapOptions;
-    onEvent;
+    config;
     constructor(config) {
-        this.endpoint = config.production
-            ? MTXCA_ENDPOINTS.production
-            : MTXCA_ENDPOINTS.testing;
-        this.soapOptions = config.soapOptions;
-        this.onEvent = config.onEvent;
+        if (!config?.endpoint)
+            throw new TypeError('MtxcaClient: endpoint es obligatorio');
+        this.config = config;
+    }
+    get endpoint() {
+        return this.config.endpoint;
+    }
+    call(method, params, kind, opts, requestElement = `${method}Request`) {
+        const { endpoint, timeout, retries, retryDelayMs, onEvent, fetch, legacyTls } = this.config;
+        return afipSoapCall(endpoint, MTXCA_NAMESPACE, method, params, {
+            timeout,
+            retries,
+            retryDelayMs,
+            onEvent,
+            fetch,
+            legacyTls,
+            kind,
+            signal: opts?.signal,
+            requestElement,
+            responseElement: `${method}Response`,
+            soapActionFromMethod: true,
+        });
+    }
+    static authRequest(auth) {
+        return { token: auth.token, sign: auth.sign, cuitRepresentada: auth.cuitRepresentada };
+    }
+    /** Llamada autenticada: `authRequest` primero, como en todos los request del XSD. */
+    callAuth(method, auth, params, kind, opts) {
+        return this.call(method, { authRequest: MtxcaClient.authRequest(auth), ...params }, kind, opts);
     }
-    call(method, params) {
-        return afipSoapCall(this.endpoint, MTXCA_NAMESPACE, method, params, { ...this.soapOptions, onEvent: this.onEvent });
+    /** Consulta: lanza `ArcaServiceError` si la respuesta trae `arrayErrores`. */
+    async consulta(method, auth, params, opts) {
+        const result = await this.callAuth(method, auth, params, 'consulta', opts);
+        checkServiceErrors(result, `${SERVICE} ${method}`);
+        return result;
     }
     // =========================================================================
-    // Facturacion
+    // Estado
+    // =========================================================================
+    /** `dummy`: estado de los servidores. No requiere autenticación. */
+    async dummy(opts) {
+        const result = await this.call('dummy', {}, 'consulta', opts, null);
+        const r = new ResponseReader('dummy', 'consulta');
+        return {
+            appserver: r.str(result, 'appserver'),
+            authserver: r.str(result, 'authserver'),
+            dbserver: r.str(result, 'dbserver'),
+        };
+    }
+    // =========================================================================
+    // CAE
     // =========================================================================
     /**
-     * Autoriza un comprobante con detalle de articulos.
+     * `autorizarComprobante`. Valida contra el XSD y redondea; no valida la
+     * coherencia de importes (eso lo hace `ArcaMtxca.autorizar`). Un rechazo
+     * devuelve `resultado: 'R'` con `errores` (no lanza).
      */
-    async autorizarComprobante(auth, request) {
-        const itemsArray = request.invoice.items.map((item) => {
-            const mapped = {
-                descripcion: item.descripcion,
-                cantidad: item.cantidad,
-                unidadMedida: item.unidadMedida,
-                precioUnitario: item.precioUnitario,
-                importeItem: item.importeItem,
-                codigoCondicionIVA: item.codigoCondicionIVA,
-                importeIVA: item.importeIVA,
-            };
-            if (item.codigo != null)
-                mapped['codigo'] = item.codigo;
-            if (item.importeBonificacion != null)
-                mapped['importeBonificacion'] = item.importeBonificacion;
-            return mapped;
-        });
-        const comprobante = {
-            codigoTipoComprobante: request.cbteTipo,
-            numeroPuntoVenta: request.ptoVta,
-            codigoConcepto: request.invoice.concepto,
-            codigoTipoDocumento: request.invoice.docTipo,
-            numeroDocumento: request.invoice.docNro,
-            fechaEmision: request.invoice.cbteFch,
-            importeTotal: request.invoice.importeTotal,
-            arrayItems: {
-                item: itemsArray,
-            },
+    async autorizarComprobante(auth, comprobante, opts) {
+        return this.autorizarCAE('autorizarComprobante', auth, comprobante, opts);
+    }
+    /** `autorizarAjusteIVA`: comprobante de ajuste de IVA con CAE (ND/NC 2, 3, 7, 8, 52, 53). */
+    async autorizarAjusteIVA(auth, comprobante, opts) {
+        return this.autorizarCAE('autorizarAjusteIVA', auth, comprobante, opts);
+    }
+    async autorizarCAE(method, auth, comprobante, opts) {
+        const comprobanteCAERequest = buildComprobante(comprobante, 'cae');
+        const result = await this.callAuth(method, auth, { comprobanteCAERequest }, 'emision', opts);
+        const r = new ResponseReader(method, 'emision');
+        const resultado = this.resultado(r, result, method);
+        const base = {
+            observaciones: r.codigosDescripciones(result['arrayObservaciones'], 'arrayObservaciones'),
+            errores: r.codigosDescripciones(result['arrayErrores'], 'arrayErrores'),
+            evento: r.evento(result),
         };
-        // Optional fields
-        if (request.invoice.codigoMoneda != null) {
-            comprobante['codigoMoneda'] = request.invoice.codigoMoneda;
-        }
-        if (request.invoice.cotizacionMoneda != null) {
-            comprobante['cotizacionMoneda'] = request.invoice.cotizacionMoneda;
-        }
-        if (request.invoice.importeGravado != null) {
-            comprobante['importeGravado'] = request.invoice.importeGravado;
-        }
-        if (request.invoice.importeNoGravado != null) {
-            comprobante['importeNoGravado'] = request.invoice.importeNoGravado;
-        }
-        if (request.invoice.importeExento != null) {
-            comprobante['importeExento'] = request.invoice.importeExento;
-        }
-        if (request.invoice.importeOtrosTributos != null) {
-            comprobante['importeOtrosTributos'] = request.invoice.importeOtrosTributos;
-        }
-        // Subtotales de IVA
-        if (request.invoice.subtotalesIVA && request.invoice.subtotalesIVA.length > 0) {
-            comprobante['arraySubtotalesIVA'] = {
-                subtotalIVA: request.invoice.subtotalesIVA.map((s) => ({
-                    codigo: s.codigo,
-                    baseImponible: s.baseImponible,
-                    importe: s.importe,
-                })),
-            };
-        }
-        // Otros tributos
-        if (request.invoice.otrosTributos && request.invoice.otrosTributos.length > 0) {
-            comprobante['arrayOtrosTributos'] = {
-                otroTributo: request.invoice.otrosTributos.map((t) => {
-                    const mapped = {
-                        codigo: t.codigoTributo,
-                        baseImponible: t.baseImponible,
-                        importe: t.importe,
-                    };
-                    if (t.descripcion != null)
-                        mapped['descripcion'] = t.descripcion;
-                    if (t.alicuota != null)
-                        mapped['alicuota'] = t.alicuota;
-                    return mapped;
-                }),
-            };
-        }
-        // Comprobantes asociados
-        if (request.invoice.comprobanteAsociado && request.invoice.comprobanteAsociado.length > 0) {
-            comprobante['arrayComprobantesAsociados'] = {
-                comprobanteAsociado: request.invoice.comprobanteAsociado.map((c) => {
-                    const mapped = {
-                        codigoTipoComprobante: c.codigoTipoComprobante,
-                        numeroPuntoVenta: c.numeroPuntoVenta,
-                        numeroComprobante: c.numeroComprobante,
-                    };
-                    if (c.cuit != null)
-                        mapped['cuit'] = c.cuit;
-                    return mapped;
-                }),
-            };
-        }
-        // Fechas de servicio
-        if (request.invoice.fechaDesde != null) {
-            comprobante['fechaDesde'] = request.invoice.fechaDesde;
-        }
-        if (request.invoice.fechaHasta != null) {
-            comprobante['fechaHasta'] = request.invoice.fechaHasta;
-        }
-        if (request.invoice.fechaVtoPago != null) {
-            comprobante['fechaVtoPago'] = request.invoice.fechaVtoPago;
-        }
-        // Observaciones
-        if (request.invoice.observaciones != null) {
-            comprobante['observaciones'] = request.invoice.observaciones;
-        }
-        const result = await this.call('autorizarComprobante', {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-            comprobanteCAERequest: comprobante,
-        });
-        const comprobanteResponse = (result['comprobanteResponse'] ?? result);
+        if (resultado === 'R')
+            return { resultado, ...base };
+        const cr = r.obj(result, 'comprobanteResponse');
         return {
-            resultado: String(comprobanteResponse['resultado'] ?? ''),
-            cae: comprobanteResponse['CAE'] != null
-                ? String(comprobanteResponse['CAE'])
-                : undefined,
-            caeFchVto: comprobanteResponse['fechaVencimientoCAE'] != null
-                ? String(comprobanteResponse['fechaVencimientoCAE'])
-                : undefined,
-            cbteNro: Number(comprobanteResponse['numeroComprobante'] ?? 0),
-            observaciones: extractObservaciones(result),
-            errores: extractErrores(result),
+            resultado,
+            comprobante: {
+                cuit: r.str(cr, 'cuit', 'comprobanteResponse.cuit'),
+                codigoTipoComprobante: r.num(cr, 'codigoTipoComprobante', 'comprobanteResponse.codigoTipoComprobante'),
+                numeroPuntoVenta: r.num(cr, 'numeroPuntoVenta', 'comprobanteResponse.numeroPuntoVenta'),
+                numeroComprobante: r.num(cr, 'numeroComprobante', 'comprobanteResponse.numeroComprobante'),
+                fechaEmision: r.str(cr, 'fechaEmision', 'comprobanteResponse.fechaEmision'),
+                cae: r.str(cr, 'CAE', 'comprobanteResponse.CAE'),
+                fechaVencimientoCAE: r.str(cr, 'fechaVencimientoCAE', 'comprobanteResponse.fechaVencimientoCAE'),
+            },
+            ...base,
         };
     }
     /**
-     * Consulta un comprobante previamente autorizado.
+     * `resultado` es obligatorio. Si falta y hay `arrayErrores`, es un rechazo
+     * (`ArcaServiceError`); si falta sin errores, la respuesta es ilegible
+     * (`ArcaSoapError` con `uncertain`).
      */
-    async consultarComprobante(auth, cbteTipo, ptoVta, cbteNro) {
-        const result = await this.call('consultarComprobante', {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-            consultaComprobanteRequest: {
-                codigoTipoComprobante: cbteTipo,
-                numeroPuntoVenta: ptoVta,
-                numeroComprobante: cbteNro,
-            },
+    resultado(r, result, method) {
+        if (!r.has(result, 'resultado')) {
+            checkServiceErrors(result, `${SERVICE} ${method}`);
+            throw r.invalid('resultado');
+        }
+        const resultado = r.str(result, 'resultado');
+        if (!isResultado(resultado))
+            throw r.invalid('resultado', `valor "${resultado}" inesperado en`);
+        return resultado;
+    }
+    // =========================================================================
+    // CAEA
+    // =========================================================================
+    /**
+     * `solicitarCAEA`. `periodo` AAAAMM, `orden` 1 (primera quincena) o 2.
+     * Lanza `ArcaServiceError` si ARCA lo rechaza. Es una emisión: si el
+     * resultado es incierto, recuperalo con `consultarCAEAEntreFechas`.
+     */
+    async solicitarCAEA(auth, periodo, orden, opts) {
+        const solicitudCAEA = validated((f) => {
+            const p = f.int('periodo', periodo, true, 190001, 999912);
+            if (p !== undefined && (p % 100 < 1 || p % 100 > 12))
+                f.fail('periodo', 'formato AAAAMM', periodo);
+            return { periodo: p, orden: f.int('orden', orden, true, 1, 2) };
         });
-        const comp = (result['comprobante'] ?? result);
+        const result = await this.callAuth('solicitarCAEA', auth, { solicitudCAEA }, 'emision', opts);
+        checkServiceErrors(result, `${SERVICE} solicitarCAEA`);
+        const r = new ResponseReader('solicitarCAEA', 'emision');
+        return this.parseCAEA(r, r.obj(result, 'CAEAResponse'), 'CAEAResponse');
+    }
+    /** `consultarCAEA`: datos de un CAEA otorgado. */
+    async consultarCAEA(auth, caea, opts) {
+        const result = await this.consulta('consultarCAEA', auth, { CAEA: validCaea(caea) }, opts);
+        const r = new ResponseReader('consultarCAEA', 'consulta');
+        return this.parseCAEA(r, r.obj(result, 'CAEAResponse'), 'CAEAResponse');
+    }
+    /** `consultarCAEAEntreFechas`: CAEAs otorgados con vigencia entre dos fechas. */
+    async consultarCAEAEntreFechas(auth, fechaDesde, fechaHasta, opts) {
+        const params = validated((f) => ({
+            fechaDesde: f.date('fechaDesde', fechaDesde, true),
+            fechaHasta: f.date('fechaHasta', fechaHasta, true),
+        }));
+        const result = await this.consulta('consultarCAEAEntreFechas', auth, params, opts);
+        const r = new ResponseReader('consultarCAEAEntreFechas', 'consulta');
+        return r.list(result['arrayCAEAResponse'], 'CAEAResponse').map((c, i) => this.parseCAEA(r, c, `arrayCAEAResponse.CAEAResponse[${i}]`));
+    }
+    parseCAEA(r, c, path) {
         return {
-            codigoTipoComprobante: Number(comp['codigoTipoComprobante'] ?? 0),
-            numeroPuntoVenta: Number(comp['numeroPuntoVenta'] ?? 0),
-            numeroComprobante: Number(comp['numeroComprobante'] ?? 0),
-            fechaEmision: String(comp['fechaEmision'] ?? ''),
-            codigoTipoDocumento: Number(comp['codigoTipoDocumento'] ?? 0),
-            numeroDocumento: Number(comp['numeroDocumento'] ?? 0),
-            importeTotal: Number(comp['importeTotal'] ?? 0),
-            importeNoGravado: Number(comp['importeNoGravado'] ?? 0),
-            importeGravado: Number(comp['importeGravado'] ?? 0),
-            importeExento: Number(comp['importeExento'] ?? 0),
-            importeOtrosTributos: Number(comp['importeOtrosTributos'] ?? 0),
-            importeSubtotal: Number(comp['importeSubtotal'] ?? 0),
-            codigoMoneda: String(comp['codigoMoneda'] ?? 'PES'),
-            cotizacionMoneda: Number(comp['cotizacionMoneda'] ?? 1),
-            resultado: String(comp['resultado'] ?? ''),
-            codigoAutorizacion: comp['codigoAutorizacion'] != null
-                ? String(comp['codigoAutorizacion'])
-                : undefined,
-            fechaVencimiento: comp['fechaVencimiento'] != null
-                ? String(comp['fechaVencimiento'])
-                : undefined,
-            observaciones: extractObservaciones(comp),
-            items: extractItems(comp),
+            fechaProceso: r.str(c, 'fechaProceso', `${path}.fechaProceso`),
+            caea: r.str(c, 'CAEA', `${path}.CAEA`),
+            periodo: r.num(c, 'periodo', `${path}.periodo`),
+            orden: r.num(c, 'orden', `${path}.orden`),
+            fechaDesde: r.str(c, 'fechaDesde', `${path}.fechaDesde`),
+            fechaHasta: r.str(c, 'fechaHasta', `${path}.fechaHasta`),
+            fechaTopeInforme: r.str(c, 'fechaTopeInforme', `${path}.fechaTopeInforme`),
+            observaciones: r.codigosDescripciones(c['arrayObservaciones'], `${path}.arrayObservaciones`),
         };
     }
-    /**
-     * Consulta el ultimo comprobante autorizado.
-     */
-    async consultarUltimoComprobanteAutorizado(auth, ptoVta, cbteTipo) {
-        const result = await this.call('consultarUltimoComprobanteAutorizado', {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-            consultaUltimoComprobanteAutorizadoRequest: {
-                codigoTipoComprobante: cbteTipo,
-                numeroPuntoVenta: ptoVta,
+    /** `informarComprobanteCAEA`. Un rechazo devuelve `resultado: 'R'` con `errores`. */
+    async informarComprobanteCAEA(auth, comprobante, opts) {
+        return this.informarCAEA('informarComprobanteCAEA', auth, comprobante, opts);
+    }
+    /** `informarAjusteIVACAEA`. Un rechazo devuelve `resultado: 'R'` con `errores`. */
+    async informarAjusteIVACAEA(auth, comprobante, opts) {
+        return this.informarCAEA('informarAjusteIVACAEA', auth, comprobante, opts);
+    }
+    async informarCAEA(method, auth, comprobante, opts) {
+        const comprobanteCAEARequest = buildComprobante(comprobante, 'caea');
+        const result = await this.callAuth(method, auth, { comprobanteCAEARequest }, 'emision', opts);
+        const r = new ResponseReader(method, 'emision');
+        const resultado = this.resultado(r, result, method);
+        const base = {
+            observaciones: r.codigosDescripciones(result['arrayObservaciones'], 'arrayObservaciones'),
+            errores: r.codigosDescripciones(result['arrayErrores'], 'arrayErrores'),
+            evento: r.evento(result),
+        };
+        if (resultado === 'R')
+            return { resultado, fechaProceso: r.optStr(result, 'fechaProceso'), ...base };
+        const cr = r.obj(result, 'comprobanteCAEAResponse');
+        return {
+            resultado,
+            fechaProceso: r.str(result, 'fechaProceso'),
+            comprobante: {
+                caea: r.str(cr, 'CAEA', 'comprobanteCAEAResponse.CAEA'),
+                codigoTipoComprobante: r.num(cr, 'codigoTipoComprobante', 'comprobanteCAEAResponse.codigoTipoComprobante'),
+                numeroPuntoVenta: r.num(cr, 'numeroPuntoVenta', 'comprobanteCAEAResponse.numeroPuntoVenta'),
+                numeroComprobante: r.num(cr, 'numeroComprobante', 'comprobanteCAEAResponse.numeroComprobante'),
             },
-        });
-        return Number(result['numeroComprobante'] ?? 0);
+            ...base,
+        };
+    }
+    /** `informarCAEANoUtilizado`: informa que un CAEA no se usó en ningún punto de venta. */
+    async informarCAEANoUtilizado(auth, caea, opts) {
+        return this.caeaNoUtilizado('informarCAEANoUtilizado', auth, { CAEA: validCaea(caea) }, opts);
+    }
+    /** `informarCAEANoUtilizadoPtoVta`: informa que un CAEA no se usó en un punto de venta. */
+    async informarCAEANoUtilizadoPtoVta(auth, caea, numeroPuntoVenta, opts) {
+        const ptoVta = validated((f) => f.int('numeroPuntoVenta', numeroPuntoVenta, true, 1, 99998));
+        return this.caeaNoUtilizado('informarCAEANoUtilizadoPtoVta', auth, { CAEA: validCaea(caea), numeroPuntoVenta: ptoVta }, opts);
+    }
+    async caeaNoUtilizado(method, auth, params, opts) {
+        const result = await this.callAuth(method, auth, params, 'emision', opts);
+        const r = new ResponseReader(method, 'emision');
+        const resultado = this.resultado(r, result, method);
+        const aprobado = resultado !== 'R';
+        const conPtoVta = 'numeroPuntoVenta' in params;
+        return {
+            resultado,
+            fechaProceso: aprobado ? r.str(result, 'fechaProceso') : r.optStr(result, 'fechaProceso'),
+            caea: aprobado ? r.str(result, 'CAEA') : r.optStr(result, 'CAEA'),
+            ...(conPtoVta ? { numeroPuntoVenta: aprobado ? r.num(result, 'numeroPuntoVenta') : r.optNum(result, 'numeroPuntoVenta') } : {}),
+            errores: r.codigosDescripciones(result['arrayErrores'], 'arrayErrores'),
+            evento: r.evento(result),
+        };
+    }
+    /** `consultarPtosVtaCAEANoInformados`: puntos de venta que todavía no informaron movimientos para el CAEA. */
+    async consultarPtosVtaCAEANoInformados(auth, caea, opts) {
+        const result = await this.consulta('consultarPtosVtaCAEANoInformados', auth, { CAEA: validCaea(caea) }, opts);
+        const r = new ResponseReader('consultarPtosVtaCAEANoInformados', 'consulta');
+        return this.parsePuntosVenta(r, r.list(result['arrayPuntosVenta'], 'puntoVenta'));
     }
     // =========================================================================
-    // Parametros
+    // Consultas de comprobantes
     // =========================================================================
     /**
-     * Health check. No requiere autenticacion.
+     * `consultarUltimoComprobanteAutorizado`. Lanza `ArcaServiceError` ante
+     * cualquier error, incluido 1502 (no hay comprobantes para ese punto de venta
+     * y tipo); `ArcaMtxca.ultimoComprobante` lo traduce a 0.
      */
-    async dummy() {
-        const result = await this.call('dummy', {});
+    async consultarUltimoComprobanteAutorizado(auth, ptoVta, cbteTipo, opts) {
+        const consultaUltimoComprobanteAutorizadoRequest = validated((f) => ({
+            codigoTipoComprobante: f.int('cbteTipo', cbteTipo, true),
+            numeroPuntoVenta: f.int('ptoVta', ptoVta, true, 1, 99998),
+        }));
+        const result = await this.consulta('consultarUltimoComprobanteAutorizado', auth, { consultaUltimoComprobanteAutorizadoRequest }, opts);
+        return new ResponseReader('consultarUltimoComprobanteAutorizado', 'consulta').num(result, 'numeroComprobante');
+    }
+    /** `consultarComprobante`: datos de un comprobante autorizado (CAE) o informado (CAEA). */
+    async consultarComprobante(auth, cbteTipo, ptoVta, cbteNro, opts) {
+        const consultaComprobanteRequest = validated((f) => ({
+            codigoTipoComprobante: f.int('cbteTipo', cbteTipo, true),
+            numeroPuntoVenta: f.int('ptoVta', ptoVta, true, 1, 99998),
+            numeroComprobante: f.int('cbteNro', cbteNro, true, 1, 99999999),
+        }));
+        const result = await this.consulta('consultarComprobante', auth, { consultaComprobanteRequest }, opts);
+        const r = new ResponseReader('consultarComprobante', 'consulta');
         return {
-            appserver: String(result['appserver'] ?? ''),
-            dbserver: String(result['dbserver'] ?? ''),
-            authserver: String(result['authserver'] ?? ''),
+            comprobante: parseComprobante(r, r.obj(result, 'comprobante')),
+            observaciones: r.codigosDescripciones(result['arrayObservaciones'], 'arrayObservaciones'),
+            evento: r.evento(result),
         };
     }
-    async consultarTiposComprobante(auth) {
-        return this.getParam(auth, 'consultarTiposComprobante', 'arrayTiposComprobante', 'codigoDescripcion');
+    // =========================================================================
+    // Parámetros
+    // =========================================================================
+    async codigos(method, container, auth, opts, params = {}) {
+        const result = await this.consulta(method, auth, params, opts);
+        const r = new ResponseReader(method, 'consulta');
+        return r.requiredList(result, container, 'codigoDescripcion').map((cd, i) => r.codigoDescripcion(cd, `${container}[${i}]`));
     }
-    async consultarTiposDocumento(auth) {
-        return this.getParam(auth, 'consultarTiposDocumento', 'arrayTiposDocumento', 'codigoDescripcion');
+    consultarTiposComprobante(auth, opts) {
+        return this.codigos('consultarTiposComprobante', 'arrayTiposComprobante', auth, opts);
     }
-    async consultarAlicuotasIVA(auth) {
-        return this.getParam(auth, 'consultarAlicuotasIVA', 'arrayAlicuotasIVA', 'codigoDescripcion');
+    consultarTiposDocumento(auth, opts) {
+        return this.codigos('consultarTiposDocumento', 'arrayTiposDocumento', auth, opts);
     }
-    async consultarCondicionesIVA(auth) {
-        return this.getParam(auth, 'consultarCondicionesIVA', 'arrayCondicionesIVA', 'codigoDescripcion');
+    consultarAlicuotasIVA(auth, opts) {
+        return this.codigos('consultarAlicuotasIVA', 'arrayAlicuotasIVA', auth, opts);
     }
-    async consultarMonedas(auth) {
-        const result = await this.call('consultarMonedas', {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-        });
-        const container = (result['arrayMonedas'] ?? result);
-        const arr = ensureArray(container['codigoDescripcion']);
-        return arr.map((m) => ({
-            Id: String(m['codigo'] ?? ''),
-            Desc: String(m['descripcion'] ?? ''),
-            FchDesde: m['fechaDesde'] != null ? String(m['fechaDesde']) : undefined,
-            FchHasta: m['fechaHasta'] != null ? String(m['fechaHasta']) : undefined,
-        }));
+    consultarCondicionesIVA(auth, opts) {
+        return this.codigos('consultarCondicionesIVA', 'arrayCondicionesIVA', auth, opts);
     }
-    async consultarUnidadesMedida(auth) {
-        const result = await this.call('consultarUnidadesMedida', {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-        });
-        const container = (result['arrayUnidadesMedida'] ?? result);
-        const arr = ensureArray(container['codigoDescripcion']);
-        return arr.map((u) => ({
-            Id: Number(u['codigo'] ?? 0),
-            Desc: String(u['descripcion'] ?? ''),
-            FchDesde: u['fechaDesde'] != null ? String(u['fechaDesde']) : undefined,
-            FchHasta: u['fechaHasta'] != null ? String(u['fechaHasta']) : undefined,
-        }));
+    /** Condiciones de IVA del receptor admitidas para un tipo de comprobante (RG 5616). */
+    async consultarCondicionesIVAReceptor(auth, cbteTipo, opts) {
+        const consultaCondicionesIVAReceptorRequest = validated((f) => ({ codigoTipoComprobante: f.int('cbteTipo', cbteTipo, true) }));
+        const result = await this.consulta('consultarCondicionesIVAReceptor', auth, { consultaCondicionesIVAReceptorRequest }, opts);
+        const r = new ResponseReader('consultarCondicionesIVAReceptor', 'consulta');
+        return r.codigosDescripciones(result['arrayCondicionesIVAReceptor'], 'arrayCondicionesIVAReceptor');
     }
-    async consultarPuntosVenta(auth) {
-        return this.getPtosVenta(auth, 'consultarPuntosVenta', 'arrayPuntosVenta');
+    consultarUnidadesMedida(auth, opts) {
+        return this.codigos('consultarUnidadesMedida', 'arrayUnidadesMedida', auth, opts);
     }
-    async consultarPuntosVentaCAE(auth) {
-        return this.getPtosVenta(auth, 'consultarPuntosVentaCAE', 'arrayPuntosVenta');
+    consultarTiposTributo(auth, opts) {
+        return this.codigos('consultarTiposTributo', 'arrayTiposTributo', auth, opts);
     }
-    async consultarPuntosVentaCAEA(auth) {
-        return this.getPtosVenta(auth, 'consultarPuntosVentaCAEA', 'arrayPuntosVenta');
+    consultarTiposDatosAdicionales(auth, opts) {
+        return this.codigos('consultarTiposDatosAdicionales', 'arrayTiposDatosAdicionales', auth, opts);
     }
-    async consultarCotizacionMoneda(auth, monedaId) {
-        const result = await this.call('consultarCotizacionMoneda', {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-            codigoMoneda: monedaId,
-        });
+    async consultarMonedas(auth, opts) {
+        const result = await this.consulta('consultarMonedas', auth, {}, opts);
+        const r = new ResponseReader('consultarMonedas', 'consulta');
+        return r.requiredList(result, 'arrayMonedas', 'codigoDescripcion').map((m, i) => ({
+            codigo: r.str(m, 'codigo', `arrayMonedas[${i}].codigo`),
+            descripcion: r.str(m, 'descripcion', `arrayMonedas[${i}].descripcion`),
+        }));
+    }
+    /**
+     * `consultarCotizacionMoneda`. `cotizacion` es `null` si ARCA no tiene
+     * cotización para la moneda en esa fecha (responde sin valor y sin error).
+     */
+    async consultarCotizacionMoneda(auth, codigoMoneda, fechaCotizacion, opts) {
+        const params = validated((f) => ({
+            codigoMoneda: f.text('codigoMoneda', codigoMoneda, true, 3),
+            fechaCotizacion: f.date('fechaCotizacion', fechaCotizacion, true),
+        }));
+        const result = await this.consulta('consultarCotizacionMoneda', auth, params, opts);
+        const r = new ResponseReader('consultarCotizacionMoneda', 'consulta');
         return {
-            monedaId: String(result['codigoMoneda'] ?? monedaId),
-            cotizacion: Number(result['cotizacionMoneda'] ?? 0),
-            fechaCotizacion: String(result['fechaCotizacion'] ?? ''),
+            codigoMoneda: params.codigoMoneda,
+            fechaCotizacion: params.fechaCotizacion,
+            cotizacion: r.optNum(result, 'cotizacionMoneda') ?? null,
         };
     }
-    // =========================================================================
-    // Private helpers
-    // =========================================================================
-    async getParam(auth, method, containerKey, itemKey) {
-        const result = await this.call(method, {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-        });
-        const container = (result[containerKey] ?? result);
-        const arr = ensureArray(container[itemKey]);
-        return arr.map((item) => ({
-            Id: Number(item['codigo'] ?? 0),
-            Desc: String(item['descripcion'] ?? ''),
-            FchDesde: item['fechaDesde'] != null ? String(item['fechaDesde']) : undefined,
-            FchHasta: item['fechaHasta'] != null ? String(item['fechaHasta']) : undefined,
+    async puntosVenta(method, auth, opts) {
+        const result = await this.consulta(method, auth, {}, opts);
+        const r = new ResponseReader(method, 'consulta');
+        return this.parsePuntosVenta(r, r.requiredList(result, 'arrayPuntosVenta', 'puntoVenta'));
+    }
+    parsePuntosVenta(r, list) {
+        return list.map((pv, i) => ({
+            numeroPuntoVenta: r.num(pv, 'numeroPuntoVenta', `puntoVenta[${i}].numeroPuntoVenta`),
+            bloqueado: r.str(pv, 'bloqueado', `puntoVenta[${i}].bloqueado`),
+            fechaBaja: r.optStr(pv, 'fechaBaja'),
         }));
     }
-    async getPtosVenta(auth, method, containerKey) {
-        const result = await this.call(method, {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-        });
-        const container = (result[containerKey] ?? result);
-        const arr = ensureArray(container['puntoVenta']);
-        return arr.map((pv) => ({
-            Nro: Number(pv['numeroPuntoVenta'] ?? 0),
-            EmisionTipo: String(pv['tipoEmision'] ?? ''),
-            Bloqueado: String(pv['bloqueado'] ?? ''),
-            FchBaja: String(pv['fechaBaja'] ?? ''),
+    consultarPuntosVenta(auth, opts) {
+        return this.puntosVenta('consultarPuntosVenta', auth, opts);
+    }
+    consultarPuntosVentaCAE(auth, opts) {
+        return this.puntosVenta('consultarPuntosVentaCAE', auth, opts);
+    }
+    consultarPuntosVentaCAEA(auth, opts) {
+        return this.puntosVenta('consultarPuntosVentaCAEA', auth, opts);
+    }
+    /** `consultarActividadesVigentes`: actividades vigentes del emisor. */
+    async consultarActividadesVigentes(auth, opts) {
+        const result = await this.consulta('consultarActividadesVigentes', auth, {}, opts);
+        const r = new ResponseReader('consultarActividadesVigentes', 'consulta');
+        return r.list(result['arrayActividades'], 'actividad').map((a, i) => ({
+            codigo: r.num(a, 'codigo', `arrayActividades[${i}].codigo`),
+            orden: r.num(a, 'orden', `arrayActividades[${i}].orden`),
+            descripcion: r.str(a, 'descripcion', `arrayActividades[${i}].descripcion`),
         }));
     }
 }
+/** Parsea un `ComprobanteType` de `consultarComprobante`. */
+function parseComprobante(r, c) {
+    const periodo = r.optObj(c, 'periodoComprobantesAsociados');
+    return {
+        codigoTipoComprobante: r.num(c, 'codigoTipoComprobante', 'comprobante.codigoTipoComprobante'),
+        numeroPuntoVenta: r.num(c, 'numeroPuntoVenta', 'comprobante.numeroPuntoVenta'),
+        numeroComprobante: r.num(c, 'numeroComprobante', 'comprobante.numeroComprobante'),
+        fechaEmision: r.optStr(c, 'fechaEmision'),
+        codigoTipoAutorizacion: r.optStr(c, 'codigoTipoAutorizacion'),
+        codigoAutorizacion: r.optStr(c, 'codigoAutorizacion'),
+        fechaVencimiento: r.optStr(c, 'fechaVencimiento'),
+        codigoTipoDocumento: r.optNum(c, 'codigoTipoDocumento'),
+        numeroDocumento: r.optStr(c, 'numeroDocumento'),
+        condicionIVAReceptor: r.optNum(c, 'condicionIVAReceptor'),
+        importeGravado: r.optNum(c, 'importeGravado'),
+        importeNoGravado: r.optNum(c, 'importeNoGravado'),
+        importeExento: r.optNum(c, 'importeExento'),
+        importeSubtotal: r.num(c, 'importeSubtotal', 'comprobante.importeSubtotal'),
+        importeOtrosTributos: r.optNum(c, 'importeOtrosTributos'),
+        importeTotal: r.num(c, 'importeTotal', 'comprobante.importeTotal'),
+        codigoMoneda: r.str(c, 'codigoMoneda', 'comprobante.codigoMoneda'),
+        cotizacionMoneda: r.optNum(c, 'cotizacionMoneda'),
+        cancelaEnMismaMonedaExtranjera: r.optStr(c, 'cancelaEnMismaMonedaExtranjera'),
+        observaciones: r.optStr(c, 'observaciones'),
+        codigoConcepto: r.num(c, 'codigoConcepto', 'comprobante.codigoConcepto'),
+        fechaServicioDesde: r.optStr(c, 'fechaServicioDesde'),
+        fechaServicioHasta: r.optStr(c, 'fechaServicioHasta'),
+        fechaVencimientoPago: r.optStr(c, 'fechaVencimientoPago'),
+        fechaHoraGen: r.optStr(c, 'fechaHoraGen'),
+        comprobantesAsociados: r.list(c['arrayComprobantesAsociados'], 'comprobanteAsociado').map((a, i) => {
+            const p = `comprobante.arrayComprobantesAsociados[${i}]`;
+            return {
+                codigoTipoComprobante: r.num(a, 'codigoTipoComprobante', `${p}.codigoTipoComprobante`),
+                numeroPuntoVenta: r.num(a, 'numeroPuntoVenta', `${p}.numeroPuntoVenta`),
+                numeroComprobante: r.num(a, 'numeroComprobante', `${p}.numeroComprobante`),
+                cuit: r.optStr(a, 'cuit'),
+                fechaEmision: r.optStr(a, 'fechaEmision'),
+            };
+        }),
+        periodoComprobantesAsociados: periodo
+            ? {
+                fechaDesde: r.str(periodo, 'fechaDesde', 'comprobante.periodoComprobantesAsociados.fechaDesde'),
+                fechaHasta: r.str(periodo, 'fechaHasta', 'comprobante.periodoComprobantesAsociados.fechaHasta'),
+            }
+            : undefined,
+        otrosTributos: r.list(c['arrayOtrosTributos'], 'otroTributo').map((t, i) => {
+            const p = `comprobante.arrayOtrosTributos[${i}]`;
+            return {
+                codigo: r.num(t, 'codigo', `${p}.codigo`),
+                descripcion: r.optStr(t, 'descripcion'),
+                baseImponible: r.num(t, 'baseImponible', `${p}.baseImponible`),
+                importe: r.num(t, 'importe', `${p}.importe`),
+            };
+        }),
+        items: r.requiredList(c, 'arrayItems', 'item').map((it, i) => {
+            const p = `comprobante.arrayItems[${i}]`;
+            return {
+                unidadesMtx: r.optNum(it, 'unidadesMtx'),
+                codigoMtx: r.optStr(it, 'codigoMtx'),
+                codigo: r.optStr(it, 'codigo'),
+                descripcion: r.str(it, 'descripcion', `${p}.descripcion`),
+                cantidad: r.optNum(it, 'cantidad'),
+                codigoUnidadMedida: r.num(it, 'codigoUnidadMedida', `${p}.codigoUnidadMedida`),
+                precioUnitario: r.optNum(it, 'precioUnitario'),
+                importeBonificacion: r.optNum(it, 'importeBonificacion'),
+                codigoCondicionIVA: r.num(it, 'codigoCondicionIVA', `${p}.codigoCondicionIVA`),
+                importeIVA: r.optNum(it, 'importeIVA'),
+                importeItem: r.num(it, 'importeItem', `${p}.importeItem`),
+            };
+        }),
+        subtotalesIVA: r.list(c['arraySubtotalesIVA'], 'subtotalIVA').map((s, i) => ({
+            codigo: r.num(s, 'codigo', `comprobante.arraySubtotalesIVA[${i}].codigo`),
+            importe: r.num(s, 'importe', `comprobante.arraySubtotalesIVA[${i}].importe`),
+        })),
+        datosAdicionales: r.list(c['arrayDatosAdicionales'], 'datoAdicional').map((d, i) => ({
+            t: r.num(d, 't', `comprobante.arrayDatosAdicionales[${i}].t`),
+            c1: r.optStr(d, 'c1'),
+            c2: r.optStr(d, 'c2'),
+            c3: r.optStr(d, 'c3'),
+            c4: r.optStr(d, 'c4'),
+            c5: r.optStr(d, 'c5'),
+            c6: r.optStr(d, 'c6'),
+        })),
+        compradores: r.list(c['arrayCompradores'], 'comprador').map((x, i) => {
+            const p = `comprobante.arrayCompradores[${i}]`;
+            return {
+                codigoTipoDocumento: r.num(x, 'codigoTipoDocumento', `${p}.codigoTipoDocumento`),
+                numeroDocumento: r.str(x, 'numeroDocumento', `${p}.numeroDocumento`),
+                porcentaje: r.num(x, 'porcentaje', `${p}.porcentaje`),
+            };
+        }),
+        actividades: r.list(c['arrayActividades'], 'actividad').map((a, i) => r.num(a, 'codigo', `comprobante.arrayActividades[${i}].codigo`)),
+    };
+}
 //# sourceMappingURL=mtxca-client.js.map