@ramiidv/arca-mtxca 0.2.0 → 0.4.0

package/dist/mtxca-client.js

@@ -1,374 +1,349 @@
-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 { ArcaSoapError, checkServiceErrors, parseServerStatus, SoapServiceClient } from '@ramiidv/arca-common';
+import { decodeResponse, encodeRequest } from '@ramiidv/arca-common/schema';
+import { MTXCA_NAMESPACE } from './constants.js';
+import { ACTIVIDADES_VIGENTES_RESPONSE, CAEA_ENTRE_FECHAS_RESPONSE, CAEA_NO_UTILIZADO, CAEA_NO_UTILIZADO_PTO_VTA, CAEA_RESPONSE, COMPROBANTE_CAE_RESPONSE, COMPROBANTE_CAEA_RESPONSE, CON_CAEA, CON_CAEA_PTO_VTA, CONDICIONES_IVA_RECEPTOR_RESPONSE, CONSULTA_COMPROBANTE, CONSULTA_COMPROBANTE_RESPONSE, CONSULTA_CONDICIONES_IVA, CONSULTA_ULTIMO, COTIZACION, COTIZACION_RESPONSE, ENTRE_FECHAS, FECHA_PROCESO, PARAMETROS, PUNTOS_VENTA_RESPONSE, RESULTADO, SOLICITUD_CAEA, ULTIMO_RESPONSE, } from './schemas.js';
+import { buildComprobante, encodeConCaea } from './serialize.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'] ?? ''),
-    }));
+/**
+ * Respuesta ilegible: `ArcaSoapError` (`uncertain` en emisiones: el
+ * comprobante pudo haberse procesado aunque la respuesta no se pueda leer).
+ */
+function invalid(message, kind) {
+    return new ArcaSoapError(message, { uncertain: kind === 'emision' });
+}
+function decode(node, schema, path, kind) {
+    return decodeResponse(node, schema, path, { error: (m) => invalid(m, kind) });
+}
+/**
+ * Elemento obligatorio del XSD que el DSL no verifica: un contenedor de lista
+ * (`[]` si viene vacío) o un elemento complejo (`complex`: tiene que tener hijos).
+ */
+function requerido(node, key, path, kind, complex = false) {
+    const v = node[key];
+    const ok = complex ? v !== null && typeof v === 'object' && !Array.isArray(v) : v !== undefined && v !== null;
+    if (!ok)
+        throw invalid(`Respuesta inválida: falta ${path}.${key}`, kind);
 }
-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 toCAEA({ CAEA, arrayObservaciones, ...rest }) {
+    return { ...rest, caea: CAEA, observaciones: arrayObservaciones };
 }
 /**
- * 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;
+export class MtxcaClient extends SoapServiceClient {
     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');
+        const { endpoint, timeout, retries, retryDelayMs, onEvent, fetch, legacyTls } = config;
+        super({
+            endpoint,
+            namespace: MTXCA_NAMESPACE,
+            transport: { timeout, retries, retryDelayMs, onEvent, fetch, legacyTls },
+        });
+    }
+    call(method, params, kind, opts, requestElement = `${method}Request`) {
+        return this.soapCall(method, params, {
+            kind,
+            signal: opts?.signal,
+            requestElement,
+            responseElement: `${method}Response`,
+            soapActionFromMethod: true,
+            // Todo como texto: los schemas convierten cada campo según el XSD.
+            parseNumbers: false,
+        });
+    }
+    static authRequest(auth) {
+        return { token: auth.token, sign: auth.sign, cuitRepresentada: auth.cuitRepresentada };
     }
-    call(method, params) {
-        return afipSoapCall(this.endpoint, MTXCA_NAMESPACE, method, params, { ...this.soapOptions, onEvent: this.onEvent });
+    /** 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);
     }
+    /** 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;
+    }
+    // =========================================================================
+    // Estado
     // =========================================================================
-    // Facturacion
+    /** `dummy`: estado de los servidores. No requiere autenticación. */
+    async dummy(opts) {
+        return parseServerStatus(await this.call('dummy', {}, 'consulta', opts, null));
+    }
+    // =========================================================================
+    // 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,
-            },
-        };
-        // 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;
+    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 { resultado, base } = this.resultado(result, method);
+        if (resultado === 'R')
+            return { resultado, ...base };
+        requerido(result, 'comprobanteResponse', method, 'emision', true);
+        const { CAE, ...cr } = decode(result['comprobanteResponse'], COMPROBANTE_CAE_RESPONSE, `${method}.comprobanteResponse`, 'emision');
+        return { resultado, comprobante: { ...cr, cae: CAE }, ...base };
+    }
+    /**
+     * Decodifica `resultado`, `arrayObservaciones`, `arrayErrores` y `evento`.
+     * `resultado` es obligatorio: si falta y hay `arrayErrores`, es un rechazo
+     * (`ArcaServiceError`); si falta sin errores, la respuesta es ilegible
+     * (`ArcaSoapError` con `uncertain`).
+     */
+    resultado(result, method, schema = RESULTADO) {
+        const r = decode(result, schema, method, 'emision');
+        if (!r.resultado) {
+            checkServiceErrors(result, `${SERVICE} ${method}`);
+            throw invalid(`Respuesta inválida: falta ${method}.resultado`, 'emision');
         }
-        // Observaciones
-        if (request.invoice.observaciones != null) {
-            comprobante['observaciones'] = request.invoice.observaciones;
+        if (!isResultado(r.resultado)) {
+            throw invalid(`Respuesta inválida: valor "${r.resultado}" inesperado en ${method}.resultado`, 'emision');
         }
-        const result = await this.call('autorizarComprobante', {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-            comprobanteCAERequest: comprobante,
-        });
-        const comprobanteResponse = (result['comprobanteResponse'] ?? result);
         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: r.resultado,
+            base: { observaciones: r.arrayObservaciones, errores: r.arrayErrores, evento: r.evento },
         };
     }
+    // =========================================================================
+    // CAEA
+    // =========================================================================
     /**
-     * Consulta un comprobante previamente autorizado.
+     * `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 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,
-            },
+    async solicitarCAEA(auth, periodo, orden, opts) {
+        const solicitudCAEA = encodeRequest({ periodo, orden }, SOLICITUD_CAEA, 'solicitarCAEA', (i, errors) => {
+            const p = i['periodo'];
+            if (Number.isInteger(p) && (p % 100 < 1 || p % 100 > 12)) {
+                errors.push({ field: 'periodo', message: 'periodo: debe tener formato AAAAMM (mes 01 a 12)', value: p });
+            }
         });
-        const comp = (result['comprobante'] ?? result);
+        const result = await this.callAuth('solicitarCAEA', auth, { solicitudCAEA }, 'emision', opts);
+        checkServiceErrors(result, `${SERVICE} solicitarCAEA`);
+        return this.parseCAEA(result, 'solicitarCAEA', 'emision');
+    }
+    /** `consultarCAEA`: datos de un CAEA otorgado. */
+    async consultarCAEA(auth, caea, opts) {
+        const params = encodeConCaea({ caea }, CON_CAEA, 'consultarCAEA');
+        const result = await this.consulta('consultarCAEA', auth, params, opts);
+        return this.parseCAEA(result, 'consultarCAEA', 'consulta');
+    }
+    /** `CAEAResponse` obligatorio de `solicitarCAEA` / `consultarCAEA`. */
+    parseCAEA(result, method, kind) {
+        requerido(result, 'CAEAResponse', method, kind, true);
+        return toCAEA(decode(result['CAEAResponse'], CAEA_RESPONSE, `${method}.CAEAResponse`, kind));
+    }
+    /** `consultarCAEAEntreFechas`: CAEAs otorgados con vigencia entre dos fechas. */
+    async consultarCAEAEntreFechas(auth, fechaDesde, fechaHasta, opts) {
+        const params = encodeRequest({ fechaDesde, fechaHasta }, ENTRE_FECHAS, 'consultarCAEAEntreFechas');
+        const result = await this.consulta('consultarCAEAEntreFechas', auth, params, opts);
+        const { arrayCAEAResponse } = decode(result, CAEA_ENTRE_FECHAS_RESPONSE, 'consultarCAEAEntreFechas', 'consulta');
+        return arrayCAEAResponse.map(toCAEA);
+    }
+    /** `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 { resultado, base } = this.resultado(result, method);
+        const { fechaProceso } = decode(result, FECHA_PROCESO, method, 'emision');
+        if (resultado === 'R')
+            return { resultado, fechaProceso, ...base };
+        if (fechaProceso === undefined)
+            throw invalid(`Respuesta inválida: falta ${method}.fechaProceso`, 'emision');
+        requerido(result, 'comprobanteCAEAResponse', method, 'emision', true);
+        const { CAEA, ...cr } = decode(result['comprobanteCAEAResponse'], COMPROBANTE_CAEA_RESPONSE, `${method}.comprobanteCAEAResponse`, 'emision');
+        return { resultado, fechaProceso, comprobante: { caea: CAEA, ...cr }, ...base };
+    }
+    /** `informarCAEANoUtilizado`: informa que un CAEA no se usó en ningún punto de venta. */
+    async informarCAEANoUtilizado(auth, caea, opts) {
+        const method = 'informarCAEANoUtilizado';
+        return this.caeaNoUtilizado(method, auth, encodeConCaea({ caea }, CON_CAEA, method), CAEA_NO_UTILIZADO, opts);
+    }
+    /** `informarCAEANoUtilizadoPtoVta`: informa que un CAEA no se usó en un punto de venta. */
+    async informarCAEANoUtilizadoPtoVta(auth, caea, numeroPuntoVenta, opts) {
+        const method = 'informarCAEANoUtilizadoPtoVta';
+        const params = encodeConCaea({ caea, numeroPuntoVenta }, CON_CAEA_PTO_VTA, method);
+        return this.caeaNoUtilizado(method, auth, params, CAEA_NO_UTILIZADO_PTO_VTA, opts);
+    }
+    async caeaNoUtilizado(method, auth, params, schema, opts) {
+        const result = await this.callAuth(method, auth, params, 'emision', opts);
+        const { resultado, base } = this.resultado(result, method, schema);
+        const r = decode(result, schema, method, 'emision');
+        const conPtoVta = 'numeroPuntoVenta' in params;
+        // Obligatorios en el XSD; en un rechazo se toleran ausentes.
+        const faltante = [
+            r.fechaProceso === undefined && 'fechaProceso',
+            r.CAEA === undefined && 'CAEA',
+            conPtoVta && r.numeroPuntoVenta === undefined && 'numeroPuntoVenta',
+        ].find(Boolean);
+        if (resultado !== 'R' && faltante)
+            throw invalid(`Respuesta inválida: falta ${method}.${faltante}`, 'emision');
         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),
+            resultado,
+            fechaProceso: r.fechaProceso,
+            caea: r.CAEA,
+            ...(conPtoVta ? { numeroPuntoVenta: r.numeroPuntoVenta } : {}),
+            errores: base.errores,
+            evento: base.evento,
         };
     }
+    /** `consultarPtosVtaCAEANoInformados`: puntos de venta que todavía no informaron movimientos para el CAEA. */
+    async consultarPtosVtaCAEANoInformados(auth, caea, opts) {
+        const method = 'consultarPtosVtaCAEANoInformados';
+        const result = await this.consulta(method, auth, encodeConCaea({ caea }, CON_CAEA, method), opts);
+        return this.parsePuntosVenta(result, method);
+    }
+    // =========================================================================
+    // Consultas de comprobantes
+    // =========================================================================
     /**
-     * Consulta el ultimo comprobante autorizado.
+     * `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 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,
+    async consultarUltimoComprobanteAutorizado(auth, ptoVta, cbteTipo, opts) {
+        const method = 'consultarUltimoComprobanteAutorizado';
+        const consultaUltimoComprobanteAutorizadoRequest = encodeRequest({ codigoTipoComprobante: cbteTipo, numeroPuntoVenta: ptoVta }, CONSULTA_ULTIMO, method);
+        const result = await this.consulta(method, auth, { consultaUltimoComprobanteAutorizadoRequest }, opts);
+        return decode(result, ULTIMO_RESPONSE, method, 'consulta').numeroComprobante;
+    }
+    /** `consultarComprobante`: datos de un comprobante autorizado (CAE) o informado (CAEA). */
+    async consultarComprobante(auth, cbteTipo, ptoVta, cbteNro, opts) {
+        const method = 'consultarComprobante';
+        const consultaComprobanteRequest = encodeRequest({ codigoTipoComprobante: cbteTipo, numeroPuntoVenta: ptoVta, numeroComprobante: cbteNro }, CONSULTA_COMPROBANTE, method);
+        const result = await this.consulta(method, auth, { consultaComprobanteRequest }, opts);
+        requerido(result, 'comprobante', method, 'consulta', true);
+        requerido(result['comprobante'], 'arrayItems', `${method}.comprobante`, 'consulta');
+        const r = decode(result, CONSULTA_COMPROBANTE_RESPONSE, method, 'consulta');
+        const { arrayComprobantesAsociados, arrayOtrosTributos, arrayItems, arraySubtotalesIVA, arrayDatosAdicionales, arrayCompradores, arrayActividades, ...c } = r.comprobante;
+        return {
+            comprobante: {
+                ...c,
+                comprobantesAsociados: arrayComprobantesAsociados,
+                otrosTributos: arrayOtrosTributos,
+                items: arrayItems,
+                subtotalesIVA: arraySubtotalesIVA,
+                datosAdicionales: arrayDatosAdicionales,
+                compradores: arrayCompradores,
+                actividades: arrayActividades.map((a) => a.codigo),
             },
-        });
-        return Number(result['numeroComprobante'] ?? 0);
+            observaciones: r.arrayObservaciones,
+            evento: r.evento,
+        };
     }
     // =========================================================================
-    // Parametros
+    // Parámetros
     // =========================================================================
+    /** Consulta cuya respuesta es un `ArrayCodigosDescripciones[String]Type` obligatorio (ver `PARAMETROS`). */
+    async codigos(method, auth, opts) {
+        const schema = PARAMETROS[method];
+        const [container] = Object.keys(schema);
+        const result = await this.consulta(method, auth, {}, opts);
+        requerido(result, container, method, 'consulta');
+        return decode(result, schema, method, 'consulta')[container];
+    }
+    consultarTiposComprobante(auth, opts) {
+        return this.codigos('consultarTiposComprobante', auth, opts);
+    }
+    consultarTiposDocumento(auth, opts) {
+        return this.codigos('consultarTiposDocumento', auth, opts);
+    }
+    consultarAlicuotasIVA(auth, opts) {
+        return this.codigos('consultarAlicuotasIVA', auth, opts);
+    }
+    consultarCondicionesIVA(auth, opts) {
+        return this.codigos('consultarCondicionesIVA', auth, opts);
+    }
+    /** Condiciones de IVA del receptor admitidas para un tipo de comprobante (RG 5616). */
+    async consultarCondicionesIVAReceptor(auth, cbteTipo, opts) {
+        const method = 'consultarCondicionesIVAReceptor';
+        const consultaCondicionesIVAReceptorRequest = encodeRequest({ codigoTipoComprobante: cbteTipo }, CONSULTA_CONDICIONES_IVA, method);
+        const result = await this.consulta(method, auth, { consultaCondicionesIVAReceptorRequest }, opts);
+        return decode(result, CONDICIONES_IVA_RECEPTOR_RESPONSE, method, 'consulta').arrayCondicionesIVAReceptor;
+    }
+    consultarUnidadesMedida(auth, opts) {
+        return this.codigos('consultarUnidadesMedida', auth, opts);
+    }
+    consultarTiposTributo(auth, opts) {
+        return this.codigos('consultarTiposTributo', auth, opts);
+    }
+    consultarTiposDatosAdicionales(auth, opts) {
+        return this.codigos('consultarTiposDatosAdicionales', auth, opts);
+    }
+    consultarMonedas(auth, opts) {
+        return this.codigos('consultarMonedas', auth, opts);
+    }
     /**
-     * Health check. No requiere autenticacion.
+     * `consultarCotizacionMoneda`. `cotizacion` es `null` si ARCA no tiene
+     * cotización para la moneda en esa fecha (responde sin valor y sin error).
      */
-    async dummy() {
-        const result = await this.call('dummy', {});
+    async consultarCotizacionMoneda(auth, codigoMoneda, fechaCotizacion, opts) {
+        const method = 'consultarCotizacionMoneda';
+        const params = encodeRequest({ codigoMoneda, fechaCotizacion }, COTIZACION, method);
+        const result = await this.consulta(method, auth, params, opts);
+        const { cotizacionMoneda } = decode(result, COTIZACION_RESPONSE, method, 'consulta');
         return {
-            appserver: String(result['appserver'] ?? ''),
-            dbserver: String(result['dbserver'] ?? ''),
-            authserver: String(result['authserver'] ?? ''),
+            codigoMoneda: params['codigoMoneda'],
+            fechaCotizacion: params['fechaCotizacion'],
+            cotizacion: cotizacionMoneda ?? null,
         };
     }
-    async consultarTiposComprobante(auth) {
-        return this.getParam(auth, 'consultarTiposComprobante', 'arrayTiposComprobante', 'codigoDescripcion');
+    /** `ArrayPuntosVentaType` (obligatorio salvo en `consultarPtosVtaCAEANoInformados`). */
+    parsePuntosVenta(result, method, obligatorio = false) {
+        if (obligatorio)
+            requerido(result, 'arrayPuntosVenta', method, 'consulta');
+        return decode(result, PUNTOS_VENTA_RESPONSE, method, 'consulta')
+            .arrayPuntosVenta;
     }
-    async consultarTiposDocumento(auth) {
-        return this.getParam(auth, 'consultarTiposDocumento', 'arrayTiposDocumento', 'codigoDescripcion');
+    async puntosVenta(method, auth, opts) {
+        return this.parsePuntosVenta(await this.consulta(method, auth, {}, opts), method, true);
     }
-    async consultarAlicuotasIVA(auth) {
-        return this.getParam(auth, 'consultarAlicuotasIVA', 'arrayAlicuotasIVA', 'codigoDescripcion');
+    consultarPuntosVenta(auth, opts) {
+        return this.puntosVenta('consultarPuntosVenta', auth, opts);
     }
-    async consultarCondicionesIVA(auth) {
-        return this.getParam(auth, 'consultarCondicionesIVA', 'arrayCondicionesIVA', 'codigoDescripcion');
+    consultarPuntosVentaCAE(auth, opts) {
+        return this.puntosVenta('consultarPuntosVentaCAE', 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,
-        }));
-    }
-    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,
-        }));
-    }
-    async consultarPuntosVenta(auth) {
-        return this.getPtosVenta(auth, 'consultarPuntosVenta', 'arrayPuntosVenta');
-    }
-    async consultarPuntosVentaCAE(auth) {
-        return this.getPtosVenta(auth, 'consultarPuntosVentaCAE', 'arrayPuntosVenta');
-    }
-    async consultarPuntosVentaCAEA(auth) {
-        return this.getPtosVenta(auth, 'consultarPuntosVentaCAEA', 'arrayPuntosVenta');
-    }
-    async consultarCotizacionMoneda(auth, monedaId) {
-        const result = await this.call('consultarCotizacionMoneda', {
-            authRequest: {
-                token: auth.Token,
-                sign: auth.Sign,
-                cuitRepresentada: auth.Cuit,
-            },
-            codigoMoneda: monedaId,
-        });
-        return {
-            monedaId: String(result['codigoMoneda'] ?? monedaId),
-            cotizacion: Number(result['cotizacionMoneda'] ?? 0),
-            fechaCotizacion: String(result['fechaCotizacion'] ?? ''),
-        };
+    consultarPuntosVentaCAEA(auth, opts) {
+        return this.puntosVenta('consultarPuntosVentaCAEA', auth, opts);
     }
-    // =========================================================================
-    // 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 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'] ?? ''),
-        }));
+    /** `consultarActividadesVigentes`: actividades vigentes del emisor. */
+    async consultarActividadesVigentes(auth, opts) {
+        const method = 'consultarActividadesVigentes';
+        const result = await this.consulta(method, auth, {}, opts);
+        return decode(result, ACTIVIDADES_VIGENTES_RESPONSE, method, 'consulta')
+            .arrayActividades;
     }
 }
 //# sourceMappingURL=mtxca-client.js.map