@ramiidv/arca-sdk 0.3.0 → 1.1.3

package/README.md

@@ -2,7 +2,7 @@
 
 SDK en TypeScript para interactuar con los Web Services de **ARCA** (ex AFIP) — Facturación Electrónica Argentina.
 
-Soporta **todos los tipos de comprobante** de WSFEv1: Facturas, Notas de Débito/Crédito, Recibos (A, B, C, E, M) y Facturas de Crédito Electrónica MiPyME (FCE).
+Soporta **todos los tipos de comprobante** de WSFEv1 y WSFEX: Facturas, Notas de Débito/Crédito, Recibos (A, B, C, E, M), Facturas de Crédito Electrónica MiPyME (FCE) y Facturas de Exportación.
 
 ## Instalación
 
@@ -60,6 +60,11 @@ const arca = new Arca({
   production: false,           // Default: false (testing/homologación)
   tokenTTLMinutes: 720,        // Default: 720 (12 horas)
   requestTimeoutMs: 30_000,    // Default: 30000 (30 segundos)
+  retries: 1,                  // Default: 1 (reintentos en errores transitorios)
+  retryDelayMs: 1_000,         // Default: 1000 (backoff exponencial: 1s, 2s, ...)
+  onEvent: (e) => {            // Opcional: callback para logging/debugging
+    console.log(e.type, e);
+  },
 });
 ```
 
@@ -174,6 +179,77 @@ const result = await arca.facturar({
 });
 ```
 
+### Factura de exportación (WSFEX)
+
+ID, número de comprobante y total por item se calculan automáticamente.
+
+```typescript
+const result = await arca.facturarExpo({
+  ptoVta: 1,
+  cbteTipo: CbteTipo.FACTURA_E,
+  tipoExpo: 1, // 1=Bienes, 2=Servicios, 4=Otros
+  pais: 203,   // País destino (203 = Estados Unidos)
+  cliente: {
+    nombre: "ACME Corp",
+    cuitPais: 50000000016,
+    domicilio: "123 Main St, New York",
+    idImpositivo: "12-3456789",
+  },
+  moneda: "DOL",
+  cotizacion: 1200,
+  formaPago: "Wire Transfer",
+  incoterms: "FOB",
+  idioma: 2, // 1=Español, 2=Inglés, 3=Portugués
+  items: [{
+    codigo: "SKU001",
+    descripcion: "Widget",
+    cantidad: 100,
+    unidad: 7,
+    precioUnitario: 10,
+  }],
+});
+
+if (result.aprobada) {
+  console.log(`CAE: ${result.cae}, Cbte #${result.cbteNro}`);
+}
+```
+
+### Consultar contribuyente (Padrón)
+
+```typescript
+// Consulta básica por CUIT (padrón A13)
+const persona = await arca.consultarCuit(30712345678);
+console.log(persona.nombre);       // "EMPRESA SA"
+console.log(persona.tipoPersona);  // "JURIDICA"
+console.log(persona.estadoClave);  // "ACTIVO"
+console.log(persona.impuestos);    // [{ id: 30, descripcion: "IVA", estado: "AC" }]
+
+// Consulta detallada (padrón A5 — requiere autorización adicional)
+const detalle = await arca.consultarCuitDetalle(20123456789);
+console.log(detalle.domicilioFiscal); // { direccion, localidad, codPostal }
+```
+
+### CAEA — Facturación offline / contingencia
+
+```typescript
+// 1. Solicitar CAEA para un período (antes de que empiece)
+const caea = await arca.solicitarCAEA("202604", 1); // abril, 1ra quincena
+console.log(`CAEA: ${caea.CAEA}, vigencia: ${caea.FchVigDesde} - ${caea.FchVigHasta}`);
+
+// 2. Emitir facturas offline usando el CAEA (misma interfaz que facturar())
+const result = await arca.registrarFacturaCAEA(caea.CAEA, {
+  ptoVta: 5,
+  cbteTipo: CbteTipo.FACTURA_B,
+  items: [{ neto: 100, iva: IvaTipo.IVA_21 }],
+});
+
+// 3. Si no hubo movimientos en el período
+await arca.sinMovimientoCAEA(caea.CAEA, 5);
+
+// Consultar un CAEA existente
+const existente = await arca.consultarCAEA("202604", 1);
+```
+
 ### Previsualizar totales sin enviar
 
 ```typescript
@@ -185,6 +261,25 @@ console.log(importes);
 // { total: 1762.5, neto: 1500, iva: 262.5, exento: 0, noGravado: 0, tributos: 0 }
 ```
 
+### QR para factura impresa
+
+```typescript
+const url = Arca.generateQRUrl({
+  fecha: "2026-03-28",
+  cuit: 20123456789,
+  ptoVta: 1,
+  tipoCmp: CbteTipo.FACTURA_B,
+  nroCmp: 150,
+  importe: 121,
+  moneda: "PES",
+  ctz: 1,
+  tipoDocRec: DocTipo.CONSUMIDOR_FINAL,
+  nroDocRec: 0,
+  codAut: 73429843294823, // CAE
+});
+// → "https://www.afip.gob.ar/fe/qr/?p=<base64>"
+```
+
 ### Factura en moneda extranjera
 
 ```typescript
@@ -201,6 +296,55 @@ const result = await arca.facturar({
 });
 ```
 
+## Retry automático
+
+El SDK reintenta automáticamente en errores transitorios (timeout, HTTP 5xx, errores de red). No reintenta en errores de negocio (4xx, errores de ARCA).
+
+- **Default**: 1 reintento con backoff exponencial (1s, 2s, ...)
+- **Configurable**: `retries: 0` para desactivar, `retries: 3` para más intentos
+
+```typescript
+const arca = new Arca({
+  ...config,
+  retries: 2,         // 2 reintentos (3 intentos totales)
+  retryDelayMs: 2000, // empezar con 2s → 4s → 8s
+});
+```
+
+## Eventos / Logging
+
+El SDK emite eventos para debugging y monitoreo sin forzar un logger específico.
+
+```typescript
+// Opción 1: callback en config
+const arca = new Arca({
+  ...config,
+  onEvent: (e) => console.log(`[${e.type}]`, e),
+});
+
+// Opción 2: suscripción por tipo de evento
+arca.on("request:end", (e) => {
+  if (e.type === "request:end") {
+    metrics.histogram("arca.request.duration", e.durationMs);
+  }
+});
+
+arca.on("request:retry", (e) => {
+  if (e.type === "request:retry") {
+    logger.warn(`Retry #${e.attempt} for ${e.method}: ${e.error}`);
+  }
+});
+```
+
+| Evento | Cuándo | Datos |
+| --- | --- | --- |
+| `auth:login` | Nuevo token obtenido | `service`, `durationMs` |
+| `auth:cache-hit` | Token cacheado reutilizado | `service` |
+| `request:start` | Antes de una llamada SOAP | `method`, `endpoint` |
+| `request:end` | Llamada SOAP completada | `method`, `durationMs` |
+| `request:retry` | Reintentando tras error | `method`, `attempt`, `delayMs`, `error` |
+| `request:error` | Llamada SOAP falló | `method`, `error` |
+
 ## Manejo de errores
 
 El SDK provee clases de error específicas para catch granular:
@@ -223,7 +367,7 @@ try {
   }
 
   if (e instanceof ArcaWSFEError) {
-    // Error de WSFE con códigos de ARCA
+    // Error de WSFE/WSFEX con códigos de ARCA
     for (const err of e.errors) {
       console.error(`[${err.code}] ${err.msg}`);
     }
@@ -239,7 +383,7 @@ try {
 | Clase | Cuándo se lanza |
 | --- | --- |
 | `ArcaAuthError` | Falla en login WSAA, respuesta inesperada, token/sign inválidos |
-| `ArcaWSFEError` | Error devuelto por WSFE (campos inválidos, CUIT no autorizado, etc.). Contiene `errors: { code, msg }[]` |
+| `ArcaWSFEError` | Error devuelto por WSFE/WSFEX (campos inválidos, CUIT no autorizado, etc.). Contiene `errors: { code, msg }[]` |
 | `ArcaSoapError` | Error HTTP, timeout, SOAP Fault. Contiene `statusCode?: number` |
 | `ArcaError` | Clase base para todos los errores del SDK |
 
@@ -284,6 +428,9 @@ const maxRegs = await arca.getCantMaxRegistros();
 | `production` | `boolean` | `false` | Entorno de producción |
 | `tokenTTLMinutes` | `number` | `720` | TTL del token en minutos |
 | `requestTimeoutMs` | `number` | `30000` | Timeout HTTP en milisegundos |
+| `retries` | `number` | `1` | Reintentos en errores transitorios |
+| `retryDelayMs` | `number` | `1000` | Delay inicial entre reintentos (exponencial) |
+| `onEvent` | `function` | — | Callback para eventos del SDK |
 
 ### Facturación — API simplificada
 
@@ -292,8 +439,10 @@ const maxRegs = await arca.getCantMaxRegistros();
 | `facturar(opts)` | Crea un comprobante con cálculo automático de IVA y totales |
 | `notaCredito(opts)` | Crea nota de crédito asociada (tipo NC inferido automáticamente) |
 | `notaDebito(opts)` | Crea nota de débito asociada (tipo ND inferido automáticamente) |
+| `facturarExpo(opts)` | Factura de exportación con auto ID, numeración y cálculo de totales |
+| `registrarFacturaCAEA(caea, opts)` | Registra factura con CAEA (misma interfaz que `facturar()`) |
 
-Retornan `FacturaResult` con: `aprobada`, `cae`, `caeVencimiento`, `cbteNro`, `importes`, `observaciones`, `raw`.
+Retornan `FacturaResult` / `FacturaExpoResult` con: `aprobada`, `cae`, `caeVencimiento`, `cbteNro`, `importes`/`obs`, `raw`.
 
 ### Facturación — API raw
 
@@ -305,7 +454,46 @@ Retornan `FacturaResult` con: `aprobada`, `cae`, `caeVencimiento`, `cbteNro`, `i
 | `siguienteComprobante(ptoVta, cbteTipo)` | Siguiente número (último + 1) |
 | `consultarComprobante(cbteTipo, ptoVta, cbteNro)` | Consulta un comprobante existente |
 
-### Parámetros
+### Exportación (WSFEX)
+
+| Método | Descripción |
+| --- | --- |
+| `facturarExpo(opts)` | Factura de exportación simplificada (auto ID y numeración) |
+| `crearFacturaExportacion(invoice)` | Autoriza un comprobante de exportación (API raw) |
+| `ultimoComprobanteExpo(ptoVta, cbteTipo)` | Último número autorizado (WSFEX) |
+| `siguienteComprobanteExpo(ptoVta, cbteTipo)` | Siguiente número (WSFEX) |
+| `ultimoIdExpo()` | Último ID de request WSFEX |
+| `consultarComprobanteExpo(cbteTipo, ptoVta, cbteNro)` | Consulta comprobante de exportación |
+| `serverStatusExpo()` | Estado de los servidores WSFEX |
+| `getTiposCbteExpo()` | Tipos de comprobante de exportación |
+| `getMonedasExpo()` | Monedas (WSFEX) |
+| `getPaisesExpo()` | Países destino |
+| `getIdiomasExpo()` | Idiomas disponibles |
+| `getIncotermsExpo()` | Incoterms |
+| `getUMedExpo()` | Unidades de medida |
+| `getTiposExpo()` | Tipos de exportación |
+| `getCuitsPaisExpo()` | CUITs de países |
+
+### CAEA (Autorización Anticipada)
+
+| Método | Descripción |
+| --- | --- |
+| `solicitarCAEA(periodo, orden)` | Solicita un CAEA para un período y quincena |
+| `consultarCAEA(periodo, orden)` | Consulta un CAEA existente |
+| `registrarFacturaCAEA(caea, opts)` | Registra factura con CAEA (API simplificada) |
+| `registrarCAEA(request)` | Informa comprobantes con CAEA (API raw) |
+| `sinMovimientoCAEA(caea, ptoVta)` | Informa sin movimientos para un CAEA |
+
+### Padrón (Consulta de contribuyentes)
+
+| Método | Descripción |
+| --- | --- |
+| `consultarCuit(cuit)` | Datos básicos de un contribuyente (padrón A13) |
+| `consultarCuitDetalle(cuit)` | Datos detallados con domicilio (padrón A5) |
+
+Retornan `Contribuyente` con: `cuit`, `nombre`, `tipoPersona`, `estadoClave`, `domicilioFiscal?`, `impuestos?`, `raw`.
+
+### Parámetros WSFE
 
 | Método | Descripción |
 | --- | --- |
@@ -321,11 +509,19 @@ Retornan `FacturaResult` con: `aprobada`, `cae`, `caeVencimiento`, `cbteNro`, `i
 | `getCotizacion(monedaId)` | Cotización de una moneda |
 | `getCantMaxRegistros()` | Máx registros por request |
 
+### Eventos
+
+| Método | Descripción |
+| --- | --- |
+| `on(event, handler)` | Suscribirse a un tipo de evento |
+| `off(event, handler)` | Desuscribirse de un evento |
+
 ### Utilidades estáticas
 
 | Método | Descripción |
 | --- | --- |
 | `Arca.calcularTotales(items, opts?)` | Calcula importes e IVA sin enviar a ARCA |
+| `Arca.generateQRUrl(input)` | Genera la URL del QR oficial de ARCA |
 | `Arca.extractCAE(result)` | Extrae CAE del resultado raw |
 | `Arca.formatDate(date)` | Formatea `Date` a `YYYYMMDD` (timezone Argentina) |
 
@@ -378,10 +574,10 @@ Tambien se incluyen tipos especiales: `COMPRA_BIENES_USADOS` (49), `CTA_VTA_LIQ_
 
 ## Entornos
 
-| Entorno | WSAA | WSFE |
-| --- | --- | --- |
-| Testing | `wsaahomo.afip.gov.ar` | `wswhomo.afip.gov.ar` |
-| Producción | `wsaa.afip.gov.ar` | `servicios1.afip.gov.ar` |
+| Entorno | WSAA | WSFE | WSFEX | Padrón |
+| --- | --- | --- | --- | --- |
+| Testing | `wsaahomo.afip.gov.ar` | `wswhomo.afip.gov.ar` | `wswhomo.afip.gov.ar` | `awshomo.afip.gov.ar` |
+| Producción | `wsaa.afip.gov.ar` | `servicios1.afip.gov.ar` | `servicios1.afip.gov.ar` | `aws.afip.gov.ar` |
 
 ## Licencia
 

package/dist/arca.d.ts

@@ -1,175 +1,168 @@
-import type { ArcaConfig, InvoiceRequest, InvoiceDetail, FECAESolicitarResult, FECAEDetResponse, FECompConsultarResult, ServerStatus, ParamItem, MonedaItem, PtoVentaItem, CotizacionResult, FacturarOpts, NotaCreditoOpts, NotaDebitoOpts, FacturaResult, LineItem } from "./types.js";
+import type { ArcaConfig, ArcaEvent, InvoiceRequest, InvoiceDetail, FECAESolicitarResult, FECAEDetResponse, FECompConsultarResult, ServerStatus, ParamItem, MonedaItem, PtoVentaItem, CotizacionResult, FacturarOpts, NotaCreditoOpts, NotaDebitoOpts, FacturaResult, LineItem, QRInput, WsfexInvoice, WsfexAuthResult, WsfexGetCmpResult, WsfexParamItem, FacturarExpoOpts, FacturaExpoResult, CaeaSolicitarResult, CaeaRegInfRequest, CaeaSinMovResult, Contribuyente } from "./types.js";
 export declare class Arca {
     private wsaa;
     private wsfe;
+    private wsfex;
+    private padron;
     private cuit;
     private production;
+    private emitter;
+    private onEventCb?;
     constructor(config: ArcaConfig);
     /**
-     * Obtiene las credenciales de autenticación para WSFE.
-     */
-    private getAuth;
-    /**
-     * Crea una factura y obtiene el CAE.
+     * Suscribirse a eventos del SDK.
      *
      * @example
      * ```ts
-     * const result = await arca.crearFactura({
-     *   PtoVta: 1,
-     *   CbteTipo: CbteTipo.FACTURA_B,
-     *   invoices: [{
-     *     Concepto: Concepto.PRODUCTOS,
-     *     DocTipo: DocTipo.CONSUMIDOR_FINAL,
-     *     DocNro: 0,
-     *     CbteDesde: nextNum,
-     *     CbteHasta: nextNum,
-     *     CbteFch: "20260328",
-     *     ImpTotal: 121,
-     *     ImpTotConc: 0,
-     *     ImpNeto: 100,
-     *     ImpOpEx: 0,
-     *     ImpTrib: 0,
-     *     ImpIVA: 21,
-     *     MonId: Moneda.PESOS,
-     *     MonCotiz: 1,
-     *     Iva: [{ Id: IvaTipo.IVA_21, BaseImp: 100, Importe: 21 }],
-     *   }],
-     * });
+     * arca.on("request:end", (e) => console.log(`${e.method} took ${e.durationMs}ms`));
+     * arca.on("auth:login", (e) => console.log(`Login ${e.service} in ${e.durationMs}ms`));
+     * arca.on("request:retry", (e) => console.warn(`Retry #${e.attempt}: ${e.error}`));
      * ```
      */
+    on(event: ArcaEvent["type"], handler: (event: ArcaEvent) => void): this;
+    /** Desuscribirse de un evento. */
+    off(event: ArcaEvent["type"], handler: (event: ArcaEvent) => void): this;
+    private getAuth;
+    /** Solicita CAE para uno o más comprobantes (API raw). */
     crearFactura(request: InvoiceRequest): Promise<FECAESolicitarResult>;
-    /**
-     * Obtiene el último número de comprobante autorizado.
-     * Útil para calcular el siguiente número antes de crear una factura.
-     */
+    /** Último número de comprobante autorizado. */
     ultimoComprobante(ptoVta: number, cbteTipo: number): Promise<number>;
-    /**
-     * Obtiene el siguiente número de comprobante (último + 1).
-     */
+    /** Siguiente número de comprobante (último + 1). */
     siguienteComprobante(ptoVta: number, cbteTipo: number): Promise<number>;
-    /**
-     * Crea una factura automáticamente calculando el siguiente número de comprobante.
-     * Simplifica el flujo más común: obtener número → crear factura.
-     */
+    /** Crea factura obteniendo el número automáticamente (API raw). */
     crearFacturaAuto(ptoVta: number, cbteTipo: number, invoice: Omit<InvoiceDetail, "CbteDesde" | "CbteHasta">): Promise<FECAESolicitarResult>;
     /**
      * Crea una factura con API simplificada.
      * Calcula automáticamente IVA, totales, y número de comprobante.
-     *
-     * @example
-     * ```ts
-     * const result = await arca.facturar({
-     *   ptoVta: 1,
-     *   cbteTipo: CbteTipo.FACTURA_B,
-     *   items: [
-     *     { neto: 1000, iva: IvaTipo.IVA_21 },
-     *     { neto: 500, iva: IvaTipo.IVA_10_5 },
-     *   ],
-     * });
-     *
-     * if (result.aprobada) {
-     *   console.log(`CAE: ${result.cae}, Cbte: ${result.cbteNro}`);
-     * }
-     * ```
      */
     facturar(opts: FacturarOpts): Promise<FacturaResult>;
     /**
-     * Crea una nota de crédito asociada a un comprobante original.
-     * El tipo de NC se infiere automáticamente del tipo del comprobante original.
-     *
-     * @example
-     * ```ts
-     * const result = await arca.notaCredito({
-     *   ptoVta: 1,
-     *   comprobanteOriginal: {
-     *     tipo: CbteTipo.FACTURA_B,
-     *     ptoVta: 1,
-     *     nro: 5,
-     *   },
-     *   items: [{ neto: 500, iva: IvaTipo.IVA_21 }],
-     * });
-     * ```
+     * Crea una nota de crédito. Tipo de NC inferido del comprobante original.
      */
     notaCredito(opts: NotaCreditoOpts): Promise<FacturaResult>;
     /**
-     * Crea una nota de débito asociada a un comprobante original.
-     * El tipo de ND se infiere automáticamente del tipo del comprobante original.
+     * Crea una nota de débito. Tipo de ND inferido del comprobante original.
+     */
+    notaDebito(opts: NotaDebitoOpts): Promise<FacturaResult>;
+    private facturarConAsociado;
+    /** Consulta un comprobante previamente autorizado. */
+    consultarComprobante(cbteTipo: number, ptoVta: number, cbteNro: number): Promise<FECompConsultarResult>;
+    /** Autoriza un comprobante de exportación (WSFEX). */
+    crearFacturaExportacion(invoice: WsfexInvoice): Promise<WsfexAuthResult>;
+    /** Último número de comprobante de exportación autorizado. */
+    ultimoComprobanteExpo(ptoVta: number, cbteTipo: number): Promise<number>;
+    /** Siguiente número de comprobante de exportación. */
+    siguienteComprobanteExpo(ptoVta: number, cbteTipo: number): Promise<number>;
+    /** Último ID de request WSFEX. */
+    ultimoIdExpo(): Promise<number>;
+    /** Consulta un comprobante de exportación. */
+    consultarComprobanteExpo(cbteTipo: number, ptoVta: number, cbteNro: number): Promise<WsfexGetCmpResult>;
+    /** Estado de los servidores WSFEX. */
+    serverStatusExpo(): Promise<ServerStatus>;
+    /** Tipos de comprobante de exportación. */
+    getTiposCbteExpo(): Promise<WsfexParamItem[]>;
+    /** Monedas (WSFEX). */
+    getMonedasExpo(): Promise<WsfexParamItem[]>;
+    /** Países destino de exportación. */
+    getPaisesExpo(): Promise<WsfexParamItem[]>;
+    /** Idiomas disponibles (WSFEX). */
+    getIdiomasExpo(): Promise<WsfexParamItem[]>;
+    /** Incoterms disponibles. */
+    getIncotermsExpo(): Promise<WsfexParamItem[]>;
+    /** Unidades de medida (WSFEX). */
+    getUMedExpo(): Promise<WsfexParamItem[]>;
+    /** Tipos de exportación. */
+    getTiposExpo(): Promise<WsfexParamItem[]>;
+    /** CUITs de países. */
+    getCuitsPaisExpo(): Promise<WsfexParamItem[]>;
+    /**
+     * Crea una factura de exportación con API simplificada.
+     * Obtiene automáticamente el ID y número de comprobante.
+     */
+    facturarExpo(opts: FacturarExpoOpts): Promise<FacturaExpoResult>;
+    /**
+     * Solicita un CAEA para un período y quincena.
+     * @param periodo - Período en formato YYYYMM
+     * @param orden - 1 = primera quincena, 2 = segunda quincena
+     */
+    solicitarCAEA(periodo: string, orden: number): Promise<CaeaSolicitarResult>;
+    /** Consulta un CAEA previamente solicitado. */
+    consultarCAEA(periodo: string, orden: number): Promise<CaeaSolicitarResult>;
+    /** Informa comprobantes emitidos con un CAEA. */
+    registrarCAEA(request: CaeaRegInfRequest): Promise<FECAESolicitarResult>;
+    /**
+     * Registra una factura emitida con CAEA (API simplificada).
+     * Equivale a `facturar()` pero usando un CAEA pre-solicitado.
+     * Calcula automáticamente IVA, totales, y número de comprobante.
      *
      * @example
      * ```ts
-     * const result = await arca.notaDebito({
+     * const caea = await arca.solicitarCAEA("202604", 1);
+     *
+     * const result = await arca.registrarFacturaCAEA(caea.CAEA, {
      *   ptoVta: 1,
-     *   comprobanteOriginal: {
-     *     tipo: CbteTipo.FACTURA_A,
-     *     ptoVta: 1,
-     *     nro: 10,
-     *     fecha: "20260301",
-     *   },
-     *   docTipo: DocTipo.CUIT,
-     *   docNro: 20123456789,
-     *   items: [{ neto: 200, iva: IvaTipo.IVA_21 }],
+     *   cbteTipo: CbteTipo.FACTURA_B,
+     *   items: [{ neto: 100, iva: IvaTipo.IVA_21 }],
      * });
      * ```
      */
-    notaDebito(opts: NotaDebitoOpts): Promise<FacturaResult>;
-    private facturarConAsociado;
+    registrarFacturaCAEA(caea: string, opts: FacturarOpts): Promise<FacturaResult>;
+    /** Informa que no hubo movimientos para un CAEA en un punto de venta. */
+    sinMovimientoCAEA(caea: string, ptoVta: number): Promise<CaeaSinMovResult>;
     /**
-     * Consulta un comprobante previamente autorizado.
+     * Consulta datos de un contribuyente por CUIT (padrón A13 - básico).
+     * Retorna nombre, tipo de persona, estado, impuestos.
      */
-    consultarComprobante(cbteTipo: number, ptoVta: number, cbteNro: number): Promise<FECompConsultarResult>;
+    consultarCuit(cuit: number): Promise<Contribuyente>;
     /**
-     * Verifica el estado de los servidores de ARCA.
-     * No requiere autenticación.
+     * Consulta datos detallados de un contribuyente (padrón A5).
+     * Requiere autorización adicional en el certificado.
+     * Incluye domicilio fiscal, actividades, etc.
      */
+    consultarCuitDetalle(cuit: number): Promise<Contribuyente>;
+    /** Estado de los servidores WSFE. No requiere autenticación. */
     serverStatus(): Promise<ServerStatus>;
-    /** Obtiene los tipos de comprobante disponibles. */
     getTiposComprobante(): Promise<ParamItem[]>;
-    /** Obtiene los tipos de concepto disponibles (Productos, Servicios, Productos y Servicios). */
     getTiposConcepto(): Promise<ParamItem[]>;
-    /** Obtiene los tipos de documento disponibles. */
     getTiposDocumento(): Promise<ParamItem[]>;
-    /** Obtiene los tipos de IVA disponibles. */
     getTiposIva(): Promise<ParamItem[]>;
-    /** Obtiene las monedas disponibles. */
     getMonedas(): Promise<MonedaItem[]>;
-    /** Obtiene los tipos de tributo disponibles. */
     getTiposTributo(): Promise<ParamItem[]>;
-    /** Obtiene los tipos de datos opcionales disponibles. */
     getTiposOpcional(): Promise<ParamItem[]>;
-    /** Obtiene los puntos de venta habilitados. */
     getPuntosVenta(): Promise<PtoVentaItem[]>;
-    /** Obtiene la cotización de una moneda. */
     getCotizacion(monedaId: string): Promise<CotizacionResult>;
-    /** Obtiene la cantidad máxima de registros por request. */
     getCantMaxRegistros(): Promise<number>;
     /**
-     * Extrae el CAE y detalles de respuesta de FECAESolicitar.
-     * Helper para simplificar el procesamiento del resultado.
+     * Genera la URL del QR oficial de ARCA para un comprobante autorizado.
+     *
+     * @example
+     * ```ts
+     * const url = Arca.generateQRUrl({
+     *   fecha: "2026-03-28",
+     *   cuit: 20123456789,
+     *   ptoVta: 1,
+     *   tipoCmp: CbteTipo.FACTURA_B,
+     *   nroCmp: 150,
+     *   importe: 121,
+     *   moneda: "PES",
+     *   ctz: 1,
+     *   tipoDocRec: DocTipo.CONSUMIDOR_FINAL,
+     *   nroDocRec: 0,
+     *   codAut: 73429843294823,
+     * });
+     * ```
      */
+    static generateQRUrl(input: QRInput): string;
+    /** Extrae CAE del resultado raw de FECAESolicitar. */
     static extractCAE(result: FECAESolicitarResult): {
         approved: boolean;
         details: FECAEDetResponse[];
         cae?: string;
         caeFchVto?: string;
     };
-    /**
-     * Formatea una fecha Date a formato YYYYMMDD requerido por ARCA.
-     * Usa timezone America/Argentina/Buenos_Aires.
-     */
+    /** Formatea Date a YYYYMMDD (timezone Argentina). */
     static formatDate(date: Date | string): string;
-    /**
-     * Calcula los importes de una factura a partir de line items.
-     * Útil para previsualizar totales antes de enviar a ARCA.
-     *
-     * @example
-     * ```ts
-     * const { importes } = Arca.calcularTotales([
-     *   { neto: 1000, iva: IvaTipo.IVA_21 },
-     *   { neto: 500, iva: IvaTipo.IVA_10_5 },
-     * ]);
-     * console.log(importes.total); // 1762.5
-     * ```
-     */
+    /** Calcula importes e IVA desde line items. Para previsualizar sin enviar. */
     static calcularTotales(items: LineItem[], opts?: {
         tributos?: {
             Importe: number;
@@ -179,9 +172,7 @@ export declare class Arca {
         importes: import("./types.js").Importes;
         iva: import("./types.js").AlicuotaIva[];
     };
-    /**
-     * Invalida los tickets de acceso cacheados.
-     */
+    /** Invalida los tickets de acceso cacheados. */
     clearAuthCache(): void;
 }
 //# sourceMappingURL=arca.d.ts.map

package/dist/arca.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arca.d.ts","sourceRoot":"","sources":["../src/arca.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"arca.d.ts","sourceRoot":"","sources":["../src/arca.ts"],"names":[],"mappings":"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"}