@ramiidv/arca-mtxca 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ramiidv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,387 @@
+# @ramiidv/arca-mtxca
+
+SDK de TypeScript para el web service WSMTXCA de ARCA (ex AFIP). Facturacion electronica con detalle de articulos (item-level detail: codigos de barras, cantidades, precios unitarios, descripciones por linea).
+
+## Caracteristicas
+
+- Zero dependencias SOAP: construye los envelopes SOAP manualmente
+- Zero dependencias HTTP: usa `fetch` nativo (Node 18+)
+- Firma CMS/PKCS#7 con node-forge (via arca-common)
+- ESM only
+- TypeScript estricto con tipos completos
+- Cache automatico de tokens WSAA
+- Reintentos con backoff exponencial
+- Sistema de eventos para monitoreo
+
+## Instalacion
+
+```bash
+npm install @ramiidv/arca-mtxca
+```
+
+## WSMTXCA vs WSFEv1
+
+| Caracteristica | WSFEv1 (`arca-facturacion`) | WSMTXCA (`arca-mtxca`) |
+|---|---|---|
+| Detalle de items | No | Si (codigo, descripcion, cantidad, precio unitario por linea) |
+| Protocolo | SOAP (.NET) | SOAP (Java) |
+| Formato fechas | YYYYMMDD | YYYY-MM-DD |
+| IVA por item | No (subtotales globales) | Si (codigoCondicionIVA + importeIVA por item) |
+| Tipos cbte | A, B, C, E, M, FCE | A, B, M |
+| Uso tipico | Facturas sin detalle de productos | Facturas con detalle de productos (ej: retail, e-commerce) |
+
+## Inicio rapido
+
+```typescript
+import { readFileSync } from 'fs';
+import { ArcaMtxca, CbteTipo, CodigoCondicionIVA } from '@ramiidv/arca-mtxca';
+
+const mtxca = new ArcaMtxca({
+  cert: readFileSync('./cert.pem', 'utf-8'),
+  key: readFileSync('./key.pem', 'utf-8'),
+  cuit: 20123456789,
+  production: false, // false = homologacion
+});
+
+// Autorizar factura B con detalle de articulos
+const result = await mtxca.autorizar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_B,
+  invoice: {
+    concepto: 1, // Productos
+    docTipo: 99, // Consumidor Final
+    docNro: 0,
+    cbteFch: '2026-03-31',
+    importeTotal: 121,
+    importeGravado: 100,
+    importeNoGravado: 0,
+    importeExento: 0,
+    subtotalesIVA: [
+      { codigo: CodigoCondicionIVA.IVA_21, baseImponible: 100, importe: 21 },
+    ],
+    items: [
+      {
+        codigo: '7790001000012',
+        descripcion: 'Producto de ejemplo',
+        cantidad: 2,
+        unidadMedida: 7, // unidades
+        precioUnitario: 50,
+        importeItem: 100,
+        codigoCondicionIVA: CodigoCondicionIVA.IVA_21,
+        importeIVA: 21,
+      },
+    ],
+  },
+});
+
+if (result.resultado === 'A') {
+  console.log('CAE:', result.cae);
+  console.log('Vencimiento:', result.caeFchVto);
+  console.log('Cbte Nro:', result.cbteNro);
+}
+```
+
+## Configuracion
+
+```typescript
+interface ArcaMtxcaConfig {
+  /** Certificado X.509 en formato PEM */
+  cert: string;
+  /** Clave privada RSA en formato PEM */
+  key: string;
+  /** CUIT del contribuyente (sin guiones) */
+  cuit: number;
+  /** Usar endpoints de produccion (default: false) */
+  production?: boolean;
+  /** Timeout en ms (default: 30000) */
+  timeout?: number;
+  /** Cantidad de reintentos en errores 5xx/red (default: 1) */
+  retries?: number;
+  /** Delay base en ms para backoff exponencial (default: 1000) */
+  retryDelayMs?: number;
+  /** Callback de eventos para monitoreo */
+  onEvent?: (event: ArcaEvent) => void;
+}
+```
+
+## API
+
+### Metodos principales
+
+#### `autorizar(request: AutorizarRequest): Promise<MtxcaInvoiceResult>`
+
+Autoriza un comprobante con detalle de articulos. Retorna CAE si fue aprobado.
+
+```typescript
+const result = await mtxca.autorizar({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_A,
+  invoice: {
+    concepto: 1,
+    docTipo: 80, // CUIT
+    docNro: 30123456789,
+    cbteFch: '2026-03-31',
+    importeTotal: 242,
+    importeGravado: 200,
+    subtotalesIVA: [
+      { codigo: CodigoCondicionIVA.IVA_21, baseImponible: 200, importe: 42 },
+    ],
+    items: [
+      {
+        codigo: '001',
+        descripcion: 'Servicio de consultoria',
+        cantidad: 1,
+        unidadMedida: 7,
+        precioUnitario: 200,
+        importeItem: 200,
+        codigoCondicionIVA: CodigoCondicionIVA.IVA_21,
+        importeIVA: 42,
+      },
+    ],
+  },
+});
+```
+
+#### `ultimoComprobante(ptoVta, cbteTipo): Promise<number>`
+
+Ultimo numero de comprobante autorizado.
+
+```typescript
+const ultimo = await mtxca.ultimoComprobante(1, CbteTipo.FACTURA_B);
+```
+
+#### `siguienteComprobante(ptoVta, cbteTipo): Promise<number>`
+
+Siguiente numero de comprobante (ultimo + 1).
+
+```typescript
+const siguiente = await mtxca.siguienteComprobante(1, CbteTipo.FACTURA_B);
+```
+
+#### `consultarComprobante(cbteTipo, ptoVta, cbteNro): Promise<MtxcaComprobante>`
+
+Consulta un comprobante previamente autorizado, incluyendo el detalle de items.
+
+```typescript
+const comprobante = await mtxca.consultarComprobante(CbteTipo.FACTURA_B, 1, 150);
+console.log(comprobante.items); // Detalle de articulos
+```
+
+#### `status(): Promise<ServerStatus>`
+
+Health check del servicio. No requiere autenticacion.
+
+```typescript
+const estado = await mtxca.status();
+console.log(estado.appserver); // "OK"
+```
+
+### Consulta de parametros
+
+```typescript
+const tiposCbte = await mtxca.getTiposComprobante();
+const tiposDoc = await mtxca.getTiposDocumento();
+const alicuotas = await mtxca.getAlicuotasIVA();
+const condiciones = await mtxca.getCondicionesIVA();
+const monedas = await mtxca.getMonedas();
+const unidades = await mtxca.getUnidadesMedida();
+const ptosVenta = await mtxca.getPuntosVenta();
+const ptosVentaCAE = await mtxca.getPuntosVentaCAE();
+const ptosVentaCAEA = await mtxca.getPuntosVentaCAEA();
+const cotizacion = await mtxca.getCotizacionMoneda('DOL');
+```
+
+### Acceso a clientes de bajo nivel
+
+Para casos avanzados, se pueden usar los clientes individuales directamente:
+
+```typescript
+const mtxca = new ArcaMtxca({ /* ... */ });
+
+// Obtener ticket de acceso manualmente
+const ticket = await mtxca.wsaa.getAccessTicket('wsmtxca');
+
+const auth = {
+  Token: ticket.token,
+  Sign: ticket.sign,
+  Cuit: 20123456789,
+};
+
+// Llamar directamente al servicio
+const result = await mtxca.client.autorizarComprobante(auth, request);
+```
+
+## Tipos principales
+
+### MtxcaItem
+
+```typescript
+interface MtxcaItem {
+  codigo?: string;         // Codigo/barcode del producto
+  descripcion: string;     // Descripcion del producto/servicio
+  cantidad: number;        // Cantidad
+  unidadMedida: number;    // Codigo unidad de medida
+  precioUnitario: number;  // Precio unitario
+  importeItem: number;     // Importe total del item
+  codigoCondicionIVA: number; // Condicion de IVA del item
+  importeIVA: number;      // Importe de IVA del item
+  importeBonificacion?: number; // Descuento
+}
+```
+
+### MtxcaInvoiceResult
+
+```typescript
+interface MtxcaInvoiceResult {
+  resultado: string;     // "A" = Aprobado, "R" = Rechazado
+  cae?: string;          // CAE otorgado
+  caeFchVto?: string;    // Vencimiento del CAE (YYYY-MM-DD)
+  cbteNro: number;       // Numero de comprobante
+  observaciones: MtxcaObservacion[];
+  errores: MtxcaObservacion[];
+}
+```
+
+### MtxcaComprobante
+
+```typescript
+interface MtxcaComprobante {
+  codigoTipoComprobante: number;
+  numeroPuntoVenta: number;
+  numeroComprobante: number;
+  fechaEmision: string;
+  codigoTipoDocumento: number;
+  numeroDocumento: number;
+  importeTotal: number;
+  importeNoGravado: number;
+  importeGravado: number;
+  importeExento: number;
+  importeOtrosTributos: number;
+  importeSubtotal: number;
+  codigoMoneda: string;
+  cotizacionMoneda: number;
+  resultado: string;
+  codigoAutorizacion?: string;
+  fechaVencimiento?: string;
+  observaciones: MtxcaObservacion[];
+  items: MtxcaItem[];
+}
+```
+
+## Manejo de errores
+
+El SDK usa la jerarquia de errores de `@ramiidv/arca-common`:
+
+```
+Error
+  └── ArcaError (base)
+        ├── ArcaAuthError (errores de WSAA)
+        ├── ArcaServiceError (errores de negocio)
+        └── ArcaSoapError (errores HTTP/transporte)
+```
+
+```typescript
+import { ArcaAuthError, ArcaServiceError, ArcaSoapError } from '@ramiidv/arca-mtxca';
+
+try {
+  await mtxca.autorizar(request);
+} catch (error) {
+  if (error instanceof ArcaAuthError) {
+    // Certificado vencido, servicio no autorizado, WSAA caido
+    console.error('Error de autenticacion:', error.message);
+  } else if (error instanceof ArcaServiceError) {
+    // Errores de negocio (comprobante rechazado, etc.)
+    for (const detalle of error.errors) {
+      console.error(`[${detalle.code}] ${detalle.msg}`);
+    }
+  } else if (error instanceof ArcaSoapError) {
+    // Errores HTTP/red
+    console.error('Error HTTP:', error.statusCode, error.message);
+  }
+}
+```
+
+Ademas, las respuestas de `autorizar()` pueden tener `resultado === 'R'` con observaciones/errores sin lanzar excepcion. Siempre verificar `result.resultado`:
+
+```typescript
+const result = await mtxca.autorizar(request);
+if (result.resultado !== 'A') {
+  console.error('Rechazado:', result.errores);
+  console.warn('Observaciones:', result.observaciones);
+}
+```
+
+## Eventos
+
+```typescript
+const mtxca = new ArcaMtxca({
+  // ...
+  onEvent: (evento) => {
+    switch (evento.type) {
+      case 'auth:login':
+        console.log(`Login para ${evento.service}`);
+        break;
+      case 'auth:cache-hit':
+        console.log(`Token cacheado para ${evento.service}`);
+        break;
+      case 'request:start':
+        console.log(`Inicio ${evento.method}`);
+        break;
+      case 'request:end':
+        console.log(`Fin ${evento.method} (${evento.durationMs}ms)`);
+        break;
+      case 'request:retry':
+        console.log(`Reintento #${evento.attempt}`);
+        break;
+      case 'request:error':
+        console.error(`Error: ${evento.error}`);
+        break;
+    }
+  },
+});
+```
+
+## Enums utiles
+
+```typescript
+import { CbteTipo, Concepto, CodigoCondicionIVA, Moneda } from '@ramiidv/arca-mtxca';
+
+// Tipos de comprobante
+CbteTipo.FACTURA_A     // 1
+CbteTipo.NOTA_DEBITO_A // 2
+CbteTipo.NOTA_CREDITO_A // 3
+CbteTipo.FACTURA_B     // 6
+CbteTipo.NOTA_DEBITO_B // 7
+CbteTipo.NOTA_CREDITO_B // 8
+
+// Concepto
+Concepto.PRODUCTOS     // 1
+Concepto.SERVICIOS     // 2
+Concepto.PRODUCTOS_Y_SERVICIOS // 3
+
+// Condicion IVA del item
+CodigoCondicionIVA.NO_GRAVADO // 1
+CodigoCondicionIVA.EXENTO     // 2
+CodigoCondicionIVA.IVA_0      // 3
+CodigoCondicionIVA.IVA_10_5   // 4
+CodigoCondicionIVA.IVA_21     // 5
+CodigoCondicionIVA.IVA_27     // 6
+CodigoCondicionIVA.GRAVADO    // 7
+CodigoCondicionIVA.IVA_5      // 8
+CodigoCondicionIVA.IVA_2_5    // 9
+
+// Monedas
+Moneda.PESOS   // "PES"
+Moneda.DOLARES // "DOL"
+Moneda.EUROS   // "060"
+```
+
+## Requisitos
+
+- Node.js >= 18 (soporte nativo de `fetch`)
+- Certificado digital emitido por ARCA/AFIP
+- Autorizacion para el servicio `wsmtxca`
+
+## Licencia
+
+MIT

package/dist/arca-mtxca.d.ts

@@ -0,0 +1,99 @@
+import { WsaaClient } from '@ramiidv/arca-common';
+import type { ServerStatus } from '@ramiidv/arca-common';
+import { MtxcaClient } from './mtxca-client.js';
+import type { ArcaMtxcaConfig, AutorizarRequest, MtxcaInvoiceResult, MtxcaComprobante, ParamItem, MonedaItem, UnidadMedidaItem, PtoVentaItem, CotizacionResult } from './types.js';
+/**
+ * Main orchestrator class for the WSMTXCA web service.
+ *
+ * Provides high-level methods that handle WSAA authentication automatically.
+ * WSMTXCA is used for electronic invoicing WITH item-level detail (barcodes,
+ * quantities, unit prices, product descriptions per line).
+ *
+ * @example
+ * ```ts
+ * import { ArcaMtxca, CbteTipo, CodigoCondicionIVA } from '@ramiidv/arca-mtxca';
+ * import { readFileSync } from 'fs';
+ *
+ * const mtxca = new ArcaMtxca({
+ *   cert: readFileSync('cert.pem', 'utf-8'),
+ *   key: readFileSync('key.pem', 'utf-8'),
+ *   cuit: 20123456789,
+ *   production: false,
+ * });
+ *
+ * const result = await mtxca.autorizar({
+ *   ptoVta: 1,
+ *   cbteTipo: CbteTipo.FACTURA_B,
+ *   invoice: {
+ *     concepto: 1,
+ *     docTipo: 99,
+ *     docNro: 0,
+ *     cbteFch: '2026-03-31',
+ *     importeTotal: 121,
+ *     items: [{
+ *       descripcion: 'Producto de ejemplo',
+ *       cantidad: 1,
+ *       unidadMedida: 7,
+ *       precioUnitario: 100,
+ *       importeItem: 100,
+ *       codigoCondicionIVA: CodigoCondicionIVA.IVA_21,
+ *       importeIVA: 21,
+ *     }],
+ *   },
+ * });
+ * ```
+ */
+export declare class ArcaMtxca {
+    /** Low-level WSAA client for direct access */
+    readonly wsaa: WsaaClient;
+    /** Low-level MTXCA SOAP client for direct access */
+    readonly client: MtxcaClient;
+    private readonly cuit;
+    private readonly onEvent?;
+    constructor(config: ArcaMtxcaConfig);
+    private getAuth;
+    /**
+     * Autoriza un comprobante con detalle de articulos.
+     * Obtiene automaticamente el numero de comprobante siguiente.
+     */
+    autorizar(request: AutorizarRequest): Promise<MtxcaInvoiceResult>;
+    /**
+     * Ultimo numero de comprobante autorizado para un punto de venta y tipo.
+     */
+    ultimoComprobante(ptoVta: number, cbteTipo: number): Promise<number>;
+    /**
+     * Siguiente numero de comprobante (ultimo + 1).
+     */
+    siguienteComprobante(ptoVta: number, cbteTipo: number): Promise<number>;
+    /**
+     * Consulta un comprobante previamente autorizado.
+     */
+    consultarComprobante(cbteTipo: number, ptoVta: number, cbteNro: number): Promise<MtxcaComprobante>;
+    /**
+     * Health check del servicio WSMTXCA. No requiere autenticacion.
+     */
+    status(): Promise<ServerStatus>;
+    /** Tipos de comprobante disponibles. */
+    getTiposComprobante(): Promise<ParamItem[]>;
+    /** Tipos de documento disponibles. */
+    getTiposDocumento(): Promise<ParamItem[]>;
+    /** Alicuotas de IVA disponibles. */
+    getAlicuotasIVA(): Promise<ParamItem[]>;
+    /** Condiciones de IVA disponibles. */
+    getCondicionesIVA(): Promise<ParamItem[]>;
+    /** Monedas disponibles. */
+    getMonedas(): Promise<MonedaItem[]>;
+    /** Unidades de medida disponibles. */
+    getUnidadesMedida(): Promise<UnidadMedidaItem[]>;
+    /** Puntos de venta habilitados. */
+    getPuntosVenta(): Promise<PtoVentaItem[]>;
+    /** Puntos de venta habilitados para CAE. */
+    getPuntosVentaCAE(): Promise<PtoVentaItem[]>;
+    /** Puntos de venta habilitados para CAEA. */
+    getPuntosVentaCAEA(): Promise<PtoVentaItem[]>;
+    /** Cotizacion de una moneda. */
+    getCotizacionMoneda(monedaId: string): Promise<CotizacionResult>;
+    /** Invalida el ticket de acceso cacheado. */
+    clearAuthCache(): void;
+}
+//# sourceMappingURL=arca-mtxca.d.ts.map

package/dist/arca-mtxca.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arca-mtxca.d.ts","sourceRoot":"","sources":["../src/arca-mtxca.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAa,YAAY,EAAmB,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EACV,eAAe,EAEf,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,SAAS;IACpB,8CAA8C;IAC9C,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,oDAAoD;IACpD,SAAgB,MAAM,EAAE,WAAW,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA6B;gBAE1C,MAAM,EAAE,eAAe;YAgCrB,OAAO;IAarB;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAMvE;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1E;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7E;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC;IAS5B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAQrC,wCAAwC;IAClC,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjD,sCAAsC;IAChC,iBAAiB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK/C,oCAAoC;IAC9B,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK7C,sCAAsC;IAChC,iBAAiB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK/C,2BAA2B;IACrB,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKzC,sCAAsC;IAChC,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKtD,mCAAmC;IAC7B,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK/C,4CAA4C;IACtC,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKlD,6CAA6C;IACvC,kBAAkB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKnD,gCAAgC;IAC1B,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAStE,6CAA6C;IAC7C,cAAc,IAAI,IAAI;CAGvB"}

package/dist/arca-mtxca.js

@@ -0,0 +1,191 @@
+import { WsaaClient } from '@ramiidv/arca-common';
+import { MTXCA_SERVICE_ID } from './constants.js';
+import { MtxcaClient } from './mtxca-client.js';
+import { validateAutorizarRequest } from './validation.js';
+/**
+ * Main orchestrator class for the WSMTXCA web service.
+ *
+ * Provides high-level methods that handle WSAA authentication automatically.
+ * WSMTXCA is used for electronic invoicing WITH item-level detail (barcodes,
+ * quantities, unit prices, product descriptions per line).
+ *
+ * @example
+ * ```ts
+ * import { ArcaMtxca, CbteTipo, CodigoCondicionIVA } from '@ramiidv/arca-mtxca';
+ * import { readFileSync } from 'fs';
+ *
+ * const mtxca = new ArcaMtxca({
+ *   cert: readFileSync('cert.pem', 'utf-8'),
+ *   key: readFileSync('key.pem', 'utf-8'),
+ *   cuit: 20123456789,
+ *   production: false,
+ * });
+ *
+ * const result = await mtxca.autorizar({
+ *   ptoVta: 1,
+ *   cbteTipo: CbteTipo.FACTURA_B,
+ *   invoice: {
+ *     concepto: 1,
+ *     docTipo: 99,
+ *     docNro: 0,
+ *     cbteFch: '2026-03-31',
+ *     importeTotal: 121,
+ *     items: [{
+ *       descripcion: 'Producto de ejemplo',
+ *       cantidad: 1,
+ *       unidadMedida: 7,
+ *       precioUnitario: 100,
+ *       importeItem: 100,
+ *       codigoCondicionIVA: CodigoCondicionIVA.IVA_21,
+ *       importeIVA: 21,
+ *     }],
+ *   },
+ * });
+ * ```
+ */
+export class ArcaMtxca {
+    /** Low-level WSAA client for direct access */
+    wsaa;
+    /** Low-level MTXCA SOAP client for direct access */
+    client;
+    cuit;
+    onEvent;
+    constructor(config) {
+        const isProduction = config.production ?? false;
+        this.cuit = config.cuit;
+        this.onEvent = config.onEvent;
+        const soapOptions = {
+            timeout: config.timeout,
+            retries: config.retries,
+            retryDelayMs: config.retryDelayMs,
+        };
+        this.wsaa = new WsaaClient({
+            cert: config.cert,
+            key: config.key,
+            production: isProduction,
+            timeout: config.timeout,
+            retries: config.retries,
+            retryDelayMs: config.retryDelayMs,
+            onEvent: config.onEvent,
+        });
+        this.client = new MtxcaClient({
+            production: isProduction,
+            soapOptions,
+            onEvent: config.onEvent,
+        });
+    }
+    // =========================================================================
+    // Auth helper
+    // =========================================================================
+    async getAuth() {
+        const ticket = await this.wsaa.getAccessTicket(MTXCA_SERVICE_ID);
+        return {
+            Token: ticket.token,
+            Sign: ticket.sign,
+            Cuit: this.cuit,
+        };
+    }
+    // =========================================================================
+    // Facturacion
+    // =========================================================================
+    /**
+     * Autoriza un comprobante con detalle de articulos.
+     * Obtiene automaticamente el numero de comprobante siguiente.
+     */
+    async autorizar(request) {
+        validateAutorizarRequest(request);
+        const auth = await this.getAuth();
+        return this.client.autorizarComprobante(auth, request);
+    }
+    /**
+     * Ultimo numero de comprobante autorizado para un punto de venta y tipo.
+     */
+    async ultimoComprobante(ptoVta, cbteTipo) {
+        const auth = await this.getAuth();
+        return this.client.consultarUltimoComprobanteAutorizado(auth, ptoVta, cbteTipo);
+    }
+    /**
+     * Siguiente numero de comprobante (ultimo + 1).
+     */
+    async siguienteComprobante(ptoVta, cbteTipo) {
+        const ultimo = await this.ultimoComprobante(ptoVta, cbteTipo);
+        return ultimo + 1;
+    }
+    /**
+     * Consulta un comprobante previamente autorizado.
+     */
+    async consultarComprobante(cbteTipo, ptoVta, cbteNro) {
+        const auth = await this.getAuth();
+        return this.client.consultarComprobante(auth, cbteTipo, ptoVta, cbteNro);
+    }
+    // =========================================================================
+    // Estado del servicio
+    // =========================================================================
+    /**
+     * Health check del servicio WSMTXCA. No requiere autenticacion.
+     */
+    async status() {
+        return this.client.dummy();
+    }
+    // =========================================================================
+    // Parametros
+    // =========================================================================
+    /** Tipos de comprobante disponibles. */
+    async getTiposComprobante() {
+        const auth = await this.getAuth();
+        return this.client.consultarTiposComprobante(auth);
+    }
+    /** Tipos de documento disponibles. */
+    async getTiposDocumento() {
+        const auth = await this.getAuth();
+        return this.client.consultarTiposDocumento(auth);
+    }
+    /** Alicuotas de IVA disponibles. */
+    async getAlicuotasIVA() {
+        const auth = await this.getAuth();
+        return this.client.consultarAlicuotasIVA(auth);
+    }
+    /** Condiciones de IVA disponibles. */
+    async getCondicionesIVA() {
+        const auth = await this.getAuth();
+        return this.client.consultarCondicionesIVA(auth);
+    }
+    /** Monedas disponibles. */
+    async getMonedas() {
+        const auth = await this.getAuth();
+        return this.client.consultarMonedas(auth);
+    }
+    /** Unidades de medida disponibles. */
+    async getUnidadesMedida() {
+        const auth = await this.getAuth();
+        return this.client.consultarUnidadesMedida(auth);
+    }
+    /** Puntos de venta habilitados. */
+    async getPuntosVenta() {
+        const auth = await this.getAuth();
+        return this.client.consultarPuntosVenta(auth);
+    }
+    /** Puntos de venta habilitados para CAE. */
+    async getPuntosVentaCAE() {
+        const auth = await this.getAuth();
+        return this.client.consultarPuntosVentaCAE(auth);
+    }
+    /** Puntos de venta habilitados para CAEA. */
+    async getPuntosVentaCAEA() {
+        const auth = await this.getAuth();
+        return this.client.consultarPuntosVentaCAEA(auth);
+    }
+    /** Cotizacion de una moneda. */
+    async getCotizacionMoneda(monedaId) {
+        const auth = await this.getAuth();
+        return this.client.consultarCotizacionMoneda(auth, monedaId);
+    }
+    // =========================================================================
+    // Cache management
+    // =========================================================================
+    /** Invalida el ticket de acceso cacheado. */
+    clearAuthCache() {
+        this.wsaa.clearTicket(MTXCA_SERVICE_ID);
+    }
+}
+//# sourceMappingURL=arca-mtxca.js.map