arca-sdk 0.2.8 → 0.4.0

package/dist/index.d.cts

@@ -37,6 +37,23 @@ declare class ArcaValidationError extends ArcaError {
     constructor(message: string, details?: unknown);
 }
 
+/**
+ * Interface for token persistence.
+ * Allows the SDK to automatically handle TA (Ticket de Acceso) lifecycle
+ * by delegating storage to an external system (DB, Cache, etc).
+ */
+interface TokenStorage {
+    /**
+     * Retrieves a stored ticket for a specific CUIT and environment.
+     * Should return null if not found or expired.
+     */
+    get(cuit: string, env: string): Promise<LoginTicket | null>;
+    /**
+     * Persists a new ticket.
+     */
+    save(cuit: string, env: string, ticket: LoginTicket): Promise<void>;
+}
+
 /**
  * Configuración para WSAA
  */
@@ -47,6 +64,8 @@ interface WsaaConfig extends ArcaConfig {
     key: string;
     /** Servicio ARCA a autenticar (ej: 'wsfe', 'wsmtxca') */
     service: string;
+    /** Adaptador opcional para persistencia de tokens */
+    storage?: TokenStorage;
 }
 /**
  * Ticket de acceso obtenido de WSAA
@@ -88,8 +107,12 @@ declare class WsaaService {
      */
     private validateConfig;
     /**
-     * Obtiene un ticket de acceso válido
-     * Usa cache si el ticket actual es válido
+     * Obtiene un ticket de acceso válido.
+     *
+     * Prioridad de búsqueda:
+     * 1. Memoria (TicketManager cache)
+     * 2. Persistencia (si config.storage está definido)
+     * 3. Nueva solicitud a WSAA
      *
      * @returns Ticket de acceso
      */
@@ -350,6 +373,85 @@ declare class WsfeService {
     private parseCAEResponse;
 }
 
+/**
+ * Configuración para PadronService
+ */
+interface PadronConfig extends ArcaConfig {
+    /** CUIT del emisor (quien consulta) */
+    cuit: string;
+    /** Certificado X.509 en formato PEM */
+    cert: string;
+    /** Clave privada en formato PEM */
+    key: string;
+    /** Adaptador opcional para persistencia de tokens */
+    storage?: TokenStorage;
+}
+/**
+ * Representa una persona (física o jurídica) obtenida del Padrón A13
+ */
+interface Persona {
+    idPersona: number;
+    tipoPersona: string;
+    nombre?: string;
+    apellido?: string;
+    razonSocial?: string;
+    estadoClave: string;
+    domicilio: Domicilio[];
+    descripcionActividadPrincipal?: string;
+    monotributo?: {
+        actividad?: string[];
+        categoria?: string;
+        impuestos?: number[];
+    };
+    regimenGeneral?: {
+        impuestos?: number[];
+        actividades?: string[];
+    };
+    esInscriptoIVA: boolean;
+    esMonotributista: boolean;
+    esExento: boolean;
+}
+/**
+ * Domicilio registrado en AFIP
+ */
+interface Domicilio {
+    direccion: string;
+    localidad?: string;
+    codPostal?: string;
+    idProvincia: number;
+    descripcionProvincia: string;
+    tipoDomicilio: string;
+}
+/**
+ * Respuesta del servicio de Padrón
+ */
+interface PadronResponse {
+    persona?: Persona;
+    error?: string;
+}
+
+/**
+ * Servicio para consultar el Padrón de AFIP (ws_sr_padron_a13)
+ */
+declare class PadronService {
+    private wsaa;
+    private config;
+    constructor(config: PadronConfig);
+    /**
+     * Consulta los datos de una persona por CUIT
+     *
+     * @param idPersona CUIT a consultar
+     * @returns Datos de la persona o error
+     */
+    getPersona(idPersona: string): Promise<PadronResponse>;
+    /**
+     * Parsear la respuesta XML de getPersona
+     */
+    private parseResponse;
+    private mapDomicilios;
+    private checkImpuesto;
+}
+
 /**
  * Genera la URL completa con el código QR para un comprobante emitido.
  * Implementación robusta (Versión 11) que limpia inputs y asegura compatibilidad total con AFIP.
@@ -362,4 +464,4 @@ declare class WsfeService {
  */
 declare function generarUrlQR(caeResponse: CAEResponse, cuitEmisor: string, total: number, comprador?: Comprador): string;
 
-export { ArcaAuthError, type ArcaConfig, ArcaError, ArcaValidationError, type CAEResponse, type Comprador, Concepto, type EmitirFacturaRequest, type Environment, type FacturaItem, type LoginTicket, TipoComprobante, TipoDocumento, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generarUrlQR };
+export { ArcaAuthError, type ArcaConfig, ArcaError, ArcaValidationError, type CAEResponse, type Comprador, Concepto, type Domicilio, type EmitirFacturaRequest, type Environment, type FacturaItem, type LoginTicket, type PadronConfig, type PadronResponse, PadronService, type Persona, TipoComprobante, TipoDocumento, type TokenStorage, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generarUrlQR };

package/dist/index.d.ts

@@ -37,6 +37,23 @@ declare class ArcaValidationError extends ArcaError {
     constructor(message: string, details?: unknown);
 }
 
+/**
+ * Interface for token persistence.
+ * Allows the SDK to automatically handle TA (Ticket de Acceso) lifecycle
+ * by delegating storage to an external system (DB, Cache, etc).
+ */
+interface TokenStorage {
+    /**
+     * Retrieves a stored ticket for a specific CUIT and environment.
+     * Should return null if not found or expired.
+     */
+    get(cuit: string, env: string): Promise<LoginTicket | null>;
+    /**
+     * Persists a new ticket.
+     */
+    save(cuit: string, env: string, ticket: LoginTicket): Promise<void>;
+}
+
 /**
  * Configuración para WSAA
  */
@@ -47,6 +64,8 @@ interface WsaaConfig extends ArcaConfig {
     key: string;
     /** Servicio ARCA a autenticar (ej: 'wsfe', 'wsmtxca') */
     service: string;
+    /** Adaptador opcional para persistencia de tokens */
+    storage?: TokenStorage;
 }
 /**
  * Ticket de acceso obtenido de WSAA
@@ -88,8 +107,12 @@ declare class WsaaService {
      */
     private validateConfig;
     /**
-     * Obtiene un ticket de acceso válido
-     * Usa cache si el ticket actual es válido
+     * Obtiene un ticket de acceso válido.
+     *
+     * Prioridad de búsqueda:
+     * 1. Memoria (TicketManager cache)
+     * 2. Persistencia (si config.storage está definido)
+     * 3. Nueva solicitud a WSAA
      *
      * @returns Ticket de acceso
      */
@@ -350,6 +373,85 @@ declare class WsfeService {
     private parseCAEResponse;
 }
 
+/**
+ * Configuración para PadronService
+ */
+interface PadronConfig extends ArcaConfig {
+    /** CUIT del emisor (quien consulta) */
+    cuit: string;
+    /** Certificado X.509 en formato PEM */
+    cert: string;
+    /** Clave privada en formato PEM */
+    key: string;
+    /** Adaptador opcional para persistencia de tokens */
+    storage?: TokenStorage;
+}
+/**
+ * Representa una persona (física o jurídica) obtenida del Padrón A13
+ */
+interface Persona {
+    idPersona: number;
+    tipoPersona: string;
+    nombre?: string;
+    apellido?: string;
+    razonSocial?: string;
+    estadoClave: string;
+    domicilio: Domicilio[];
+    descripcionActividadPrincipal?: string;
+    monotributo?: {
+        actividad?: string[];
+        categoria?: string;
+        impuestos?: number[];
+    };
+    regimenGeneral?: {
+        impuestos?: number[];
+        actividades?: string[];
+    };
+    esInscriptoIVA: boolean;
+    esMonotributista: boolean;
+    esExento: boolean;
+}
+/**
+ * Domicilio registrado en AFIP
+ */
+interface Domicilio {
+    direccion: string;
+    localidad?: string;
+    codPostal?: string;
+    idProvincia: number;
+    descripcionProvincia: string;
+    tipoDomicilio: string;
+}
+/**
+ * Respuesta del servicio de Padrón
+ */
+interface PadronResponse {
+    persona?: Persona;
+    error?: string;
+}
+
+/**
+ * Servicio para consultar el Padrón de AFIP (ws_sr_padron_a13)
+ */
+declare class PadronService {
+    private wsaa;
+    private config;
+    constructor(config: PadronConfig);
+    /**
+     * Consulta los datos de una persona por CUIT
+     *
+     * @param idPersona CUIT a consultar
+     * @returns Datos de la persona o error
+     */
+    getPersona(idPersona: string): Promise<PadronResponse>;
+    /**
+     * Parsear la respuesta XML de getPersona
+     */
+    private parseResponse;
+    private mapDomicilios;
+    private checkImpuesto;
+}
+
 /**
  * Genera la URL completa con el código QR para un comprobante emitido.
  * Implementación robusta (Versión 11) que limpia inputs y asegura compatibilidad total con AFIP.
@@ -362,4 +464,4 @@ declare class WsfeService {
  */
 declare function generarUrlQR(caeResponse: CAEResponse, cuitEmisor: string, total: number, comprador?: Comprador): string;
 
-export { ArcaAuthError, type ArcaConfig, ArcaError, ArcaValidationError, type CAEResponse, type Comprador, Concepto, type EmitirFacturaRequest, type Environment, type FacturaItem, type LoginTicket, TipoComprobante, TipoDocumento, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generarUrlQR };
+export { ArcaAuthError, type ArcaConfig, ArcaError, ArcaValidationError, type CAEResponse, type Comprador, Concepto, type Domicilio, type EmitirFacturaRequest, type Environment, type FacturaItem, type LoginTicket, type PadronConfig, type PadronResponse, PadronService, type Persona, TipoComprobante, TipoDocumento, type TokenStorage, type WsaaConfig, WsaaService, type WsfeConfig, WsfeService, generarUrlQR };

package/dist/index.js

@@ -7,12 +7,19 @@ var WSFE_ENDPOINTS = {
   homologacion: "https://wswhomo.afip.gov.ar/wsfev1/service.asmx",
   produccion: "https://servicios1.afip.gov.ar/wsfev1/service.asmx"
 };
+var PADRON_A13_ENDPOINTS = {
+  homologacion: "https://awshomo.afip.gov.ar/sr-padron/webservices/personaServiceA13",
+  produccion: "https://aws.afip.gov.ar/sr-padron/webservices/personaServiceA13"
+};
 function getWsaaEndpoint(environment) {
   return WSAA_ENDPOINTS[environment];
 }
 function getWsfeEndpoint(environment) {
   return WSFE_ENDPOINTS[environment];
 }
+function getPadronEndpoint(environment) {
+  return PADRON_A13_ENDPOINTS[environment];
+}
 
 // src/types/common.ts
 var ArcaError = class extends Error {
@@ -338,8 +345,12 @@ var WsaaService = class {
     }
   }
   /**
-   * Obtiene un ticket de acceso válido
-   * Usa cache si el ticket actual es válido
+   * Obtiene un ticket de acceso válido.
+   * 
+   * Prioridad de búsqueda:
+   * 1. Memoria (TicketManager cache)
+   * 2. Persistencia (si config.storage está definido)
+   * 3. Nueva solicitud a WSAA
    * 
    * @returns Ticket de acceso
    */
@@ -348,8 +359,29 @@ var WsaaService = class {
     if (cachedTicket) {
       return cachedTicket;
     }
+    if (this.config.storage) {
+      try {
+        const storedTicket = await this.config.storage.get(this.config.cuit, this.config.environment);
+        if (storedTicket) {
+          const now = /* @__PURE__ */ new Date();
+          if (new Date(storedTicket.expirationTime) > new Date(now.getTime() + 5 * 6e4)) {
+            this.ticketManager.setTicket(storedTicket);
+            return storedTicket;
+          }
+        }
+      } catch (error) {
+        console.warn("[ARCA-SDK] TokenStorage.get fall\xF3, intentando login directo:", error);
+      }
+    }
     const ticket = await this.requestNewTicket();
     this.ticketManager.setTicket(ticket);
+    if (this.config.storage) {
+      try {
+        await this.config.storage.save(this.config.cuit, this.config.environment, ticket);
+      } catch (error) {
+        console.warn("[ARCA-SDK] TokenStorage.save fall\xF3:", error);
+      }
+    }
     return ticket;
   }
   /**
@@ -883,6 +915,129 @@ var WsfeService = class _WsfeService {
   }
 };
 
+// src/services/padron.ts
+import { XMLParser as XMLParser2 } from "fast-xml-parser";
+var PadronService = class {
+  wsaa;
+  config;
+  constructor(config) {
+    this.config = config;
+    this.wsaa = new WsaaService({
+      environment: config.environment,
+      cuit: config.cuit,
+      cert: config.cert,
+      key: config.key,
+      service: "ws_sr_padron_a13",
+      storage: config.storage
+    });
+  }
+  /**
+   * Consulta los datos de una persona por CUIT
+   * 
+   * @param idPersona CUIT a consultar
+   * @returns Datos de la persona o error
+   */
+  async getPersona(idPersona) {
+    const ticket = await this.wsaa.login();
+    const soapRequest = `<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
+                  xmlns:a13="http://a13.soap.ws.server.puc.sr/">
+  <soapenv:Header/>
+  <soapenv:Body>
+    <a13:getPersona>
+      <token>${ticket.token}</token>
+      <sign>${ticket.sign}</sign>
+      <cuitRepresentada>${this.config.cuit}</cuitRepresentada>
+      <idPersona>${idPersona}</idPersona>
+    </a13:getPersona>
+  </soapenv:Body>
+</soapenv:Envelope>`;
+    const endpoint = getPadronEndpoint(this.config.environment);
+    const response = await callArcaApi(endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "text/xml; charset=utf-8",
+        "SOAPAction": ""
+        // A13 no suele requerir SOAPAction específica en el header
+      },
+      body: soapRequest,
+      timeout: this.config.timeout || 15e3
+    });
+    if (!response.ok) {
+      throw new ArcaNetworkError(
+        `Error HTTP al comunicarse con Padron A13: ${response.status}`,
+        { status: response.status }
+      );
+    }
+    const xml = await response.text();
+    return this.parseResponse(xml);
+  }
+  /**
+   * Parsear la respuesta XML de getPersona
+   */
+  parseResponse(xml) {
+    const parser = new XMLParser2({
+      ignoreAttributes: false,
+      removeNSPrefix: true
+    });
+    const result = parser.parse(xml);
+    const body = result.Envelope?.Body;
+    if (!body) {
+      throw new ArcaError("Respuesta de Padr\xF3n inv\xE1lida: No se encontr\xF3 Body", "PADRON_ERROR");
+    }
+    const response = body.getPersonaResponse?.personaReturn;
+    if (!response) {
+      const fault = body.Fault;
+      if (fault) {
+        return { error: fault.faultstring || "Error desconocido en AFIP" };
+      }
+      return { error: "No se encontraron datos para el CUIT informado" };
+    }
+    if (response.errorConstancia) {
+      return { error: response.errorConstancia };
+    }
+    const p = response.persona;
+    if (!p) {
+      return { error: "CUIT no encontrado" };
+    }
+    const persona = {
+      idPersona: Number(p.idPersona),
+      tipoPersona: p.tipoPersona,
+      nombre: p.nombre,
+      apellido: p.apellido,
+      razonSocial: p.razonSocial,
+      estadoClave: p.estadoClave,
+      domicilio: this.mapDomicilios(p.domicilio),
+      descripcionActividadPrincipal: p.descripcionActividadPrincipal,
+      esInscriptoIVA: this.checkImpuesto(p, 30),
+      // 30 = IVA
+      esMonotributista: this.checkImpuesto(p, 20),
+      // 20 = Monotributo
+      esExento: this.checkImpuesto(p, 32)
+      // 32 = Exento
+    };
+    return { persona };
+  }
+  mapDomicilios(d) {
+    if (!d) return [];
+    const list = Array.isArray(d) ? d : [d];
+    return list.map((item) => ({
+      direccion: item.direccion,
+      localidad: item.localidad,
+      codPostal: item.codPostal,
+      idProvincia: Number(item.idProvincia),
+      descripcionProvincia: item.descripcionProvincia,
+      tipoDomicilio: item.tipoDomicilio
+    }));
+  }
+  checkImpuesto(p, id) {
+    const impuestos = p.impuesto;
+    if (!impuestos) return false;
+    const list = Array.isArray(impuestos) ? impuestos : [impuestos];
+    return list.some((i) => Number(i.idImpuesto) === id);
+  }
+};
+
 // src/utils/qr.ts
 function generarUrlQR(caeResponse, cuitEmisor, total, comprador) {
   const cleanCuit = cuitEmisor.replace(/\D/g, "");
@@ -917,6 +1072,7 @@ export {
   ArcaError,
   ArcaValidationError,
   Concepto,
+  PadronService,
   TipoComprobante,
   TipoDocumento,
   WsaaService,