@ramiidv/arca-sdk 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,273 @@
+# arca-sdk
+
+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).
+
+## Instalación
+
+```bash
+npm install arca-sdk
+```
+
+## Requisitos
+
+- Node.js >= 18
+- Certificado digital X.509 y clave privada de ARCA
+  - **Testing**: generalo desde [WSASS Homologación](https://wsass-homo.afip.gob.ar/wsass/portal/main.aspx)
+  - **Producción**: generalo desde [Administrador de Certificados](https://auth.afip.gob.ar/contribuyente_/certificados/)
+
+## Uso rápido
+
+```typescript
+import fs from "fs";
+import { Arca, CbteTipo, Concepto, DocTipo, IvaTipo, Moneda } from "arca-sdk";
+
+const arca = new Arca({
+  cuit: 20123456789,
+  cert: fs.readFileSync("./cert.crt", "utf-8"),
+  key: fs.readFileSync("./key.key", "utf-8"),
+  production: false, // true para producción
+});
+
+// Crear factura B para consumidor final (obtiene el número automáticamente)
+const result = await arca.crearFacturaAuto(1, CbteTipo.FACTURA_B, {
+  Concepto: Concepto.PRODUCTOS,
+  DocTipo: DocTipo.CONSUMIDOR_FINAL,
+  DocNro: 0,
+  CbteFch: Arca.formatDate(new Date()),
+  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 }],
+});
+
+const { approved, cae, caeFchVto } = Arca.extractCAE(result);
+console.log(approved ? `CAE: ${cae}` : "Rechazada");
+```
+
+## Tipos de comprobante soportados
+
+| Enum | Código | Descripción |
+| --- | --- | --- |
+| `FACTURA_A` | 1 | Factura A |
+| `NOTA_DEBITO_A` | 2 | Nota de Débito A |
+| `NOTA_CREDITO_A` | 3 | Nota de Crédito A |
+| `RECIBO_A` | 4 | Recibo A |
+| `FACTURA_B` | 6 | Factura B |
+| `NOTA_DEBITO_B` | 7 | Nota de Débito B |
+| `NOTA_CREDITO_B` | 8 | Nota de Crédito B |
+| `RECIBO_B` | 9 | Recibo B |
+| `FACTURA_C` | 11 | Factura C |
+| `NOTA_DEBITO_C` | 12 | Nota de Débito C |
+| `NOTA_CREDITO_C` | 13 | Nota de Crédito C |
+| `RECIBO_C` | 15 | Recibo C |
+| `FACTURA_E` | 19 | Factura de Exportación |
+| `NOTA_DEBITO_E` | 20 | Nota de Débito E |
+| `NOTA_CREDITO_E` | 21 | Nota de Crédito E |
+| `FACTURA_M` | 51 | Factura M |
+| `NOTA_DEBITO_M` | 52 | Nota de Débito M |
+| `NOTA_CREDITO_M` | 53 | Nota de Crédito M |
+| `RECIBO_M` | 54 | Recibo M |
+| `FCE_FACTURA_A` | 201 | Factura de Crédito Electrónica MiPyME A |
+| `FCE_NOTA_DEBITO_A` | 202 | Nota de Débito FCE MiPyME A |
+| `FCE_NOTA_CREDITO_A` | 203 | Nota de Crédito FCE MiPyME A |
+| `FCE_FACTURA_B` | 206 | Factura de Crédito Electrónica MiPyME B |
+| `FCE_NOTA_DEBITO_B` | 207 | Nota de Débito FCE MiPyME B |
+| `FCE_NOTA_CREDITO_B` | 208 | Nota de Crédito FCE MiPyME B |
+| `FCE_FACTURA_C` | 211 | Factura de Crédito Electrónica MiPyME C |
+| `FCE_NOTA_DEBITO_C` | 212 | Nota de Débito FCE MiPyME C |
+| `FCE_NOTA_CREDITO_C` | 213 | Nota de Crédito FCE MiPyME C |
+
+Tambien se incluyen tipos especiales: `COMPRA_BIENES_USADOS` (49), `CTA_VTA_LIQ_PROD_A/B` (60/61), `LIQUIDACION_A/B` (63/64), y comprobantes RG 1415 (34, 35, 39, 40).
+
+## Ejemplos
+
+### Factura A por servicios
+
+Para servicios (`Concepto.SERVICIOS` o `Concepto.PRODUCTOS_Y_SERVICIOS`), es obligatorio incluir las fechas de servicio y vencimiento de pago.
+
+```typescript
+const result = await arca.crearFacturaAuto(1, CbteTipo.FACTURA_A, {
+  Concepto: Concepto.SERVICIOS,
+  DocTipo: DocTipo.CUIT,
+  DocNro: 30712345678,
+  CbteFch: Arca.formatDate(new Date()),
+  ImpTotal: 60500,
+  ImpTotConc: 0,
+  ImpNeto: 50000,
+  ImpOpEx: 0,
+  ImpTrib: 0,
+  ImpIVA: 10500,
+  MonId: Moneda.PESOS,
+  MonCotiz: 1,
+  FchServDesde: "20260301",
+  FchServHasta: "20260331",
+  FchVtoPago: "20260415",
+  Iva: [{ Id: IvaTipo.IVA_21, BaseImp: 50000, Importe: 10500 }],
+});
+```
+
+### Nota de crédito
+
+```typescript
+const result = await arca.crearFacturaAuto(1, CbteTipo.NOTA_CREDITO_B, {
+  Concepto: Concepto.PRODUCTOS,
+  DocTipo: DocTipo.CONSUMIDOR_FINAL,
+  DocNro: 0,
+  CbteFch: Arca.formatDate(new Date()),
+  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 }],
+  // Asociar con la factura original
+  CbtesAsoc: [{ Tipo: CbteTipo.FACTURA_B, PtoVta: 1, Nro: 150 }],
+});
+```
+
+### Factura con múltiples alícuotas de IVA
+
+```typescript
+const result = await arca.crearFacturaAuto(1, CbteTipo.FACTURA_A, {
+  Concepto: Concepto.PRODUCTOS,
+  DocTipo: DocTipo.CUIT,
+  DocNro: 30712345678,
+  CbteFch: Arca.formatDate(new Date()),
+  ImpTotal: 1352.5,
+  ImpTotConc: 0,
+  ImpNeto: 1100, // 1000 + 100
+  ImpOpEx: 0,
+  ImpTrib: 0,
+  ImpIVA: 252.5, // 210 + 42.5 (nota: no incluye el IVA 0%)
+  MonId: Moneda.PESOS,
+  MonCotiz: 1,
+  Iva: [
+    { Id: IvaTipo.IVA_21, BaseImp: 1000, Importe: 210 },
+    { Id: IvaTipo.IVA_10_5, BaseImp: 100, Importe: 10.5 },
+    // Para incluir items al 0%, se debe declarar también:
+    // { Id: IvaTipo.IVA_0, BaseImp: 500, Importe: 0 },
+  ],
+});
+```
+
+### Factura MiPyME (FCE)
+
+```typescript
+const result = await arca.crearFacturaAuto(1, CbteTipo.FCE_FACTURA_A, {
+  Concepto: Concepto.PRODUCTOS,
+  DocTipo: DocTipo.CUIT,
+  DocNro: 30712345678,
+  CbteFch: Arca.formatDate(new Date()),
+  ImpTotal: 121000,
+  ImpTotConc: 0,
+  ImpNeto: 100000,
+  ImpOpEx: 0,
+  ImpTrib: 0,
+  ImpIVA: 21000,
+  MonId: Moneda.PESOS,
+  MonCotiz: 1,
+  Iva: [{ Id: IvaTipo.IVA_21, BaseImp: 100000, Importe: 21000 }],
+  // Dato obligatorio para FCE: CBU del emisor
+  Opcionales: [{ Id: "2101", Valor: "0110012345678901234567" }],
+});
+```
+
+## Consultas
+
+```typescript
+// Estado del servidor
+const status = await arca.serverStatus();
+
+// Último comprobante autorizado
+const ultimo = await arca.ultimoComprobante(1, CbteTipo.FACTURA_B);
+
+// Consultar un comprobante
+const cbte = await arca.consultarComprobante(CbteTipo.FACTURA_B, 1, 150);
+
+// Puntos de venta habilitados
+const ptosVenta = await arca.getPuntosVenta();
+
+// Cotización del dólar
+const cotiz = await arca.getCotizacion(Moneda.DOLARES);
+
+// Tipos de comprobante, documento, IVA, monedas, tributos
+const tiposCbte = await arca.getTiposComprobante();
+const tiposDoc = await arca.getTiposDocumento();
+const tiposIva = await arca.getTiposIva();
+const monedas = await arca.getMonedas();
+const tiposTrib = await arca.getTiposTributo();
+```
+
+## API
+
+### `new Arca(config)`
+
+| Parámetro | Tipo | Descripción |
+| --- | --- | --- |
+| `cuit` | `number` | CUIT del contribuyente (sin guiones) |
+| `cert` | `string` | Contenido del certificado X.509 (PEM) |
+| `key` | `string` | Contenido de la clave privada (PEM) |
+| `production` | `boolean` | `false` = testing (default), `true` = producción |
+| `tokenTTLMinutes` | `number` | TTL del token en minutos (default: 720 = 12h) |
+
+### Facturación
+
+| Método | Descripción |
+| --- | --- |
+| `crearFactura(request)` | Solicita CAE para uno o más comprobantes |
+| `crearFacturaAuto(ptoVta, cbteTipo, invoice)` | Obtiene el número automáticamente y crea la factura |
+| `ultimoComprobante(ptoVta, cbteTipo)` | Último número autorizado |
+| `siguienteComprobante(ptoVta, cbteTipo)` | Siguiente número (último + 1) |
+| `consultarComprobante(cbteTipo, ptoVta, cbteNro)` | Consulta un comprobante existente |
+
+### Parámetros
+
+| Método | Descripción |
+| --- | --- |
+| `serverStatus()` | Estado de los servidores |
+| `getTiposComprobante()` | Lista de tipos de comprobante |
+| `getTiposDocumento()` | Lista de tipos de documento |
+| `getTiposIva()` | Lista de alícuotas de IVA |
+| `getMonedas()` | Lista de monedas |
+| `getTiposTributo()` | Lista de tipos de tributo |
+| `getTiposOpcional()` | Lista de datos opcionales |
+| `getPuntosVenta()` | Puntos de venta habilitados |
+| `getCotizacion(monedaId)` | Cotización de una moneda |
+| `getCantMaxRegistros()` | Máx registros por request |
+
+### Utilidades estáticas
+
+| Método | Descripción |
+| --- | --- |
+| `Arca.extractCAE(result)` | Extrae CAE y estado del resultado |
+| `Arca.formatDate(date)` | Formatea `Date` a `YYYYMMDD` |
+
+## Enums disponibles
+
+- `CbteTipo` — Tipos de comprobante
+- `Concepto` — Tipos de concepto (Productos, Servicios, Ambos)
+- `DocTipo` — Tipos de documento (CUIT, DNI, etc.)
+- `IvaTipo` — Alícuotas de IVA (0%, 2.5%, 5%, 10.5%, 21%, 27%)
+- `Moneda` — Códigos de moneda (PES, DOL, EUR, etc.)
+- `TributoTipo` — Tipos de tributo
+
+## Entornos
+
+| Entorno | WSAA | WSFE |
+| --- | --- | --- |
+| Testing | `wsaahomo.afip.gov.ar` | `wswhomo.afip.gov.ar` |
+| Producción | `wsaa.afip.gov.ar` | `servicios1.afip.gov.ar` |
+
+## Licencia
+
+MIT

package/dist/arca.d.ts

@@ -0,0 +1,101 @@
+import type { ArcaConfig, InvoiceRequest, InvoiceDetail, FECAESolicitarResult, FECAEDetResponse, FECompConsultarResult, ServerStatus, ParamItem, MonedaItem, PtoVentaItem, CotizacionResult } from "./types.js";
+export declare class Arca {
+    private wsaa;
+    private wsfe;
+    private cuit;
+    private production;
+    constructor(config: ArcaConfig);
+    /**
+     * Obtiene las credenciales de autenticación para WSFE.
+     */
+    private getAuth;
+    /**
+     * Crea una factura y obtiene el CAE.
+     *
+     * @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 }],
+     *   }],
+     * });
+     * ```
+     */
+    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.
+     */
+    ultimoComprobante(ptoVta: number, cbteTipo: number): Promise<number>;
+    /**
+     * Obtiene el 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.
+     */
+    crearFacturaAuto(ptoVta: number, cbteTipo: number, invoice: Omit<InvoiceDetail, "CbteDesde" | "CbteHasta">): Promise<FECAESolicitarResult>;
+    /**
+     * Consulta un comprobante previamente autorizado.
+     */
+    consultarComprobante(cbteTipo: number, ptoVta: number, cbteNro: number): Promise<FECompConsultarResult>;
+    /**
+     * Verifica el estado de los servidores de ARCA.
+     * No requiere autenticación.
+     */
+    serverStatus(): Promise<ServerStatus>;
+    /** Obtiene los tipos de comprobante disponibles. */
+    getTiposComprobante(): 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.
+     */
+    static extractCAE(result: FECAESolicitarResult): {
+        approved: boolean;
+        details: FECAEDetResponse[];
+        cae?: string;
+        caeFchVto?: string;
+    };
+    /**
+     * Formatea una fecha Date a formato YYYYMMDD requerido por ARCA.
+     */
+    static formatDate(date: Date): string;
+    /**
+     * Invalida los tickets de acceso cacheados.
+     */
+    clearAuthCache(): void;
+}
+//# sourceMappingURL=arca.d.ts.map

package/dist/arca.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arca.d.ts","sourceRoot":"","sources":["../src/arca.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAGpB,qBAAa,IAAI;IACf,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAU;gBAEhB,MAAM,EAAE,UAAU;IAkB9B;;OAEG;YACW,OAAO;IAarB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAK1E;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1E;;OAEG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAKlB;;;OAGG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,WAAW,CAAC,GACtD,OAAO,CAAC,oBAAoB,CAAC;IAgBhC;;OAEG;IACG,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IASjC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAI3C,oDAAoD;IAC9C,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjD,kDAAkD;IAC5C,iBAAiB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK/C,4CAA4C;IACtC,WAAW,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAKzC,uCAAuC;IACjC,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKzC,gDAAgD;IAC1C,eAAe,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK7C,yDAAyD;IACnD,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAK9C,+CAA+C;IACzC,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK/C,2CAA2C;IACrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKhE,2DAA2D;IACrD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAS5C;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG;QAC/C,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAgBD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAOrC;;OAEG;IACH,cAAc,IAAI,IAAI;CAGvB"}

package/dist/arca.js

@@ -0,0 +1,199 @@
+import { WsaaClient } from "./wsaa.js";
+import { WsfeClient } from "./wsfe.js";
+export class Arca {
+    wsaa;
+    wsfe;
+    cuit;
+    production;
+    constructor(config) {
+        this.cuit = config.cuit;
+        this.production = config.production ?? false;
+        this.wsaa = new WsaaClient({
+            cert: config.cert,
+            key: config.key,
+            production: this.production,
+            tokenTTLMinutes: config.tokenTTLMinutes ?? 720,
+        });
+        this.wsfe = new WsfeClient(this.production);
+    }
+    // ============================================================
+    // Auth helpers
+    // ============================================================
+    /**
+     * Obtiene las credenciales de autenticación para WSFE.
+     */
+    async getAuth() {
+        const ticket = await this.wsaa.getAccessTicket("wsfe");
+        return {
+            Token: ticket.token,
+            Sign: ticket.sign,
+            Cuit: this.cuit,
+        };
+    }
+    // ============================================================
+    // Facturación - Métodos principales
+    // ============================================================
+    /**
+     * Crea una factura y obtiene el CAE.
+     *
+     * @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 }],
+     *   }],
+     * });
+     * ```
+     */
+    async crearFactura(request) {
+        const auth = await this.getAuth();
+        return this.wsfe.solicitarCAE(auth, request);
+    }
+    /**
+     * Obtiene el último número de comprobante autorizado.
+     * Útil para calcular el siguiente número antes de crear una factura.
+     */
+    async ultimoComprobante(ptoVta, cbteTipo) {
+        const auth = await this.getAuth();
+        return this.wsfe.ultimoComprobante(auth, ptoVta, cbteTipo);
+    }
+    /**
+     * Obtiene el siguiente número de comprobante (último + 1).
+     */
+    async siguienteComprobante(ptoVta, cbteTipo) {
+        const ultimo = await this.ultimoComprobante(ptoVta, cbteTipo);
+        return ultimo + 1;
+    }
+    /**
+     * Crea una factura automáticamente calculando el siguiente número de comprobante.
+     * Simplifica el flujo más común: obtener número → crear factura.
+     */
+    async crearFacturaAuto(ptoVta, cbteTipo, invoice) {
+        const nextNum = await this.siguienteComprobante(ptoVta, cbteTipo);
+        return this.crearFactura({
+            PtoVta: ptoVta,
+            CbteTipo: cbteTipo,
+            invoices: [
+                {
+                    ...invoice,
+                    CbteDesde: nextNum,
+                    CbteHasta: nextNum,
+                },
+            ],
+        });
+    }
+    /**
+     * Consulta un comprobante previamente autorizado.
+     */
+    async consultarComprobante(cbteTipo, ptoVta, cbteNro) {
+        const auth = await this.getAuth();
+        return this.wsfe.consultarComprobante(auth, cbteTipo, ptoVta, cbteNro);
+    }
+    // ============================================================
+    // Estado y parámetros
+    // ============================================================
+    /**
+     * Verifica el estado de los servidores de ARCA.
+     * No requiere autenticación.
+     */
+    async serverStatus() {
+        return this.wsfe.serverStatus();
+    }
+    /** Obtiene los tipos de comprobante disponibles. */
+    async getTiposComprobante() {
+        const auth = await this.getAuth();
+        return this.wsfe.getTiposComprobante(auth);
+    }
+    /** Obtiene los tipos de documento disponibles. */
+    async getTiposDocumento() {
+        const auth = await this.getAuth();
+        return this.wsfe.getTiposDocumento(auth);
+    }
+    /** Obtiene los tipos de IVA disponibles. */
+    async getTiposIva() {
+        const auth = await this.getAuth();
+        return this.wsfe.getTiposIva(auth);
+    }
+    /** Obtiene las monedas disponibles. */
+    async getMonedas() {
+        const auth = await this.getAuth();
+        return this.wsfe.getMonedas(auth);
+    }
+    /** Obtiene los tipos de tributo disponibles. */
+    async getTiposTributo() {
+        const auth = await this.getAuth();
+        return this.wsfe.getTiposTributo(auth);
+    }
+    /** Obtiene los tipos de datos opcionales disponibles. */
+    async getTiposOpcional() {
+        const auth = await this.getAuth();
+        return this.wsfe.getTiposOpcional(auth);
+    }
+    /** Obtiene los puntos de venta habilitados. */
+    async getPuntosVenta() {
+        const auth = await this.getAuth();
+        return this.wsfe.getPuntosVenta(auth);
+    }
+    /** Obtiene la cotización de una moneda. */
+    async getCotizacion(monedaId) {
+        const auth = await this.getAuth();
+        return this.wsfe.getCotizacion(auth, monedaId);
+    }
+    /** Obtiene la cantidad máxima de registros por request. */
+    async getCantMaxRegistros() {
+        const auth = await this.getAuth();
+        return this.wsfe.getCantMaxRegistros(auth);
+    }
+    // ============================================================
+    // Utilidades
+    // ============================================================
+    /**
+     * Extrae el CAE y detalles de respuesta de FECAESolicitar.
+     * Helper para simplificar el procesamiento del resultado.
+     */
+    static extractCAE(result) {
+        const detArr = Array.isArray(result.FeDetResp.FECAEDetResponse)
+            ? result.FeDetResp.FECAEDetResponse
+            : [result.FeDetResp.FECAEDetResponse];
+        const approved = result.FeCabResp.Resultado === "A";
+        const firstApproved = detArr.find((d) => d.Resultado === "A");
+        return {
+            approved,
+            details: detArr,
+            cae: firstApproved?.CAE,
+            caeFchVto: firstApproved?.CAEFchVto,
+        };
+    }
+    /**
+     * Formatea una fecha Date a formato YYYYMMDD requerido por ARCA.
+     */
+    static formatDate(date) {
+        const y = date.getFullYear();
+        const m = String(date.getMonth() + 1).padStart(2, "0");
+        const d = String(date.getDate()).padStart(2, "0");
+        return `${y}${m}${d}`;
+    }
+    /**
+     * Invalida los tickets de acceso cacheados.
+     */
+    clearAuthCache() {
+        this.wsaa.clearTicket("wsfe");
+    }
+}
+//# sourceMappingURL=arca.js.map

package/dist/arca.js.map

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