@ramiidv/arca-padron 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,51 @@
+# Changelog
+
+## 0.3.0 (2026-10-30)
+
+### Breaking changes
+- Requiere `@ramiidv/arca-common` ^0.3.0 (`AccessTicket.expirationTime` es un string ISO).
+- `ImpuestoId.MONOTRIBUTO` es `20` (estaba como `21`, incorrecto según el manual de
+  `ws_sr_constancia_inscripcion`). `ImpuestoId.MONOTRIBUTO_SOCIAL` queda deprecado (mismo valor 20):
+  el monotributo social se identifica por la categoría.
+- `status()` devuelve también `a5` y `a13`.
+
+### Features
+- `getConstanciaInscripcion(cuit)`: constancia de inscripción (`ws_sr_constancia_inscripcion`,
+  `getPersona_v2`), que reemplaza a Padrón A5 (deprecado por ARCA). Tipo `PersonaA5` con datos
+  generales, domicilio fiscal, caracterizaciones, régimen general, monotributo y errores.
+- `getPersonaA13(cuit)` y `getIdPersonaListByDocumento(dni)` (`ws_sr_padron_a13`).
+- `condicionIvaDesdePadron(persona)`: condición frente al IVA para `CondicionIVAReceptorId` (también
+  reconoce el impuesto 30 en estado `EX` / `NA`).
+- `ticketStorage`, `clockOffsetMs`, `autoClockSkew`, `signal` y `wsaa` en `ArcaPadronConfig`; `signal`
+  por llamada en todos los métodos.
+- `ArcaPadronError` y `ArcaPadronServiceError` tienen `code` propio (`ARCA_PADRON_ERROR`,
+  `ARCA_PADRON_SERVICE_ERROR`).
+- Re-exporta `CondicionIva`, `MemoryTicketStorage`, `FileTicketStorage` y `ArcaTicketVigenteError`.
+- Build dual ESM + CommonJS con `exports` condicional, y smoke test CommonJS/ESM en CI.
+
+### Fixes
+- Se quitaron dependencias que no se usaban (`fast-xml-parser`, `node-forge`): todo pasa por arca-common.
+- A4, A10 y A100 no desenvolvían `personaReturn` / `parameterCollectionReturn`: con respuestas reales de
+  ARCA los datos quedaban vacíos y A100 devolvía `[]`.
+- Documentación: el paquete es `@ramiidv/arca-padron` (decía `@ramiidv/arca-padron-sdk`, que da 404).
+- Ejemplo de eventos: los campos son `service` y `source` (decía `serviceId`).
+
+### Estado de los servicios
+Según el catálogo de web services de ARCA (consultado el 24/10/2026), A4, A10, A13 y A100 no están
+deprecados; A5 sí (reemplazado por la constancia de inscripción).
+
+## 0.2.0
+
+- Migración de WSAA/SOAP a `@ramiidv/arca-common`.
+
+## 0.1.0 (2026-03-31)
+
+### Features
+- Initial release
+- Padrón A4: full taxpayer data (domicilios, impuestos, actividades, regímenes, relaciones, categorías, emails, teléfonos)
+- Padrón A10: minimal taxpayer data (name, status, domicilio fiscal)
+- Padrón A100: parameter tables lookup (provincias, tipos documento, etc.)
+- Auto-handles WSAA authentication
+- Shared infrastructure from @ramiidv/arca-common
+- Retry with exponential backoff on transient errors
+- Event system for logging/debugging

package/README.md

@@ -1,37 +1,48 @@
-# @ramiidv/arca-padron-sdk
+# @ramiidv/arca-padron
 
-SDK de TypeScript para los web services de Padron de ARCA (ex AFIP). Soporta los alcances A4 (datos completos), A10 (datos basicos) y A100 (tablas de parametros).
+SDK de TypeScript para los web services de Padron de ARCA (ex AFIP): Constancia de Inscripcion
+(`ws_sr_constancia_inscripcion`, ex A5), A4 (datos completos), A10 y A13 (datos basicos) y A100
+(tablas de parametros). Incluye `condicionIvaDesdePadron` para obtener la condicion frente al IVA
+que pide la factura electronica (`CondicionIVAReceptorId`).
 
 ## Caracteristicas
 
 - Zero dependencias SOAP: construye los envelopes SOAP manualmente
 - Zero dependencias HTTP: usa `fetch` nativo (Node 18+)
 - Firma CMS/PKCS#7 con node-forge
-- ESM only
+- ESM y CommonJS (funciona con `import` y con `require`, incluido TypeScript con `"module": "CommonJS"`)
 - TypeScript estricto con tipos completos
-- Cache automatico de tokens WSAA
+- Cache automatico de tokens WSAA, con persistencia opcional (`ticketStorage`) y ajuste de reloj
+- Cancelacion con `AbortSignal` (global o por llamada)
 - Reintentos con backoff exponencial
 - Sistema de eventos para monitoreo
 
 ## Instalacion
 
 ```bash
-npm install @ramiidv/arca-padron-sdk
+npm install @ramiidv/arca-padron
 ```
 
 ## Inicio rapido
 
 ```typescript
 import { readFileSync } from 'fs';
-import { ArcaPadron } from '@ramiidv/arca-padron-sdk';
+import { ArcaPadron, FileTicketStorage } from '@ramiidv/arca-padron';
 
 const padron = new ArcaPadron({
   cert: readFileSync('./cert.pem', 'utf-8'),
   key: readFileSync('./key.pem', 'utf-8'),
   cuit: '20123456789',
   production: false, // false = homologacion
+  ticketStorage: new FileTicketStorage('./.arca-tickets'), // recomendado
 });
 
+// Constancia de inscripcion (ex A5) + condicion frente al IVA para facturar
+import { condicionIvaDesdePadron } from '@ramiidv/arca-padron';
+const constancia = await padron.getConstanciaInscripcion('30712345674');
+const { condicionIva, motivo } = condicionIvaDesdePadron(constancia);
+// condicionIva: CondicionIva.RESPONSABLE_INSCRIPTO (1), motivo: "Inscripto en IVA (impuesto 30)."
+
 // Consulta completa (A4)
 const contribuyente = await padron.getPersona('20123456789');
 console.log(contribuyente.tipoPersona, contribuyente.nombre);
@@ -41,7 +52,7 @@ const contribuyenteBasico = await padron.getPersonaBasic('20123456789');
 console.log(contribuyenteBasico.domicilio?.[0]?.direccion);
 
 // Tablas de parametros (A100)
-import { CollectionName } from '@ramiidv/arca-padron-sdk';
+import { CollectionName } from '@ramiidv/arca-padron';
 const provincias = await padron.getParametros(CollectionName.PROVINCIA);
 console.log(provincias.length, 'provincias');
 ```
@@ -63,14 +74,75 @@ interface ArcaPadronConfig {
   /** Delay base en ms para backoff exponencial (default: 1000) */
   retryDelayMs?: number;
   /** Callback de eventos para monitoreo */
-  onEvent?: (event: ArcaPadronEvent) => void;
+  onEvent?: (event: ArcaEvent) => void;
+  /** Persistencia de tickets WSAA entre reinicios (recomendado) */
+  ticketStorage?: TicketStorage;
+  /** Desfase relojARCA - relojLocal en ms (default: 0) */
+  clockOffsetMs?: number;
+  /** Ajustar el desfase si WSAA rechaza el login por reloj (default: true) */
+  autoClockSkew?: boolean;
+  /** Cancela todas las llamadas de la instancia */
+  signal?: AbortSignal;
+  /** WsaaClient compartido (ej: `arca.wsaa` de arca-facturacion con el mismo certificado) */
+  wsaa?: WsaaClient;
 }
 ```
 
+> **Persisti el Ticket de Acceso.** WSAA rechaza el login si ya hay un TA vigente para el
+> certificado y servicio. Sin `ticketStorage`, un reinicio del proceso te deja sin poder consultar
+> hasta que venza (hasta 12 horas, `ArcaTicketVigenteError`). Ver `TicketStorage` en
+> [`@ramiidv/arca-common`](https://github.com/ramiidv/arca-common).
+
+Si usas tambien `@ramiidv/arca-facturacion` con el mismo certificado, comparti el cliente WSAA:
+
+```typescript
+const arca = new Arca({ cuit, cert, key, ticketStorage });
+const padron = new ArcaPadron({ cuit: String(cuit), cert, key, wsaa: arca.wsaa });
+```
+
+Todos los metodos aceptan un ultimo parametro opcional `{ signal }`.
+
 ## API
 
 ### Metodos de alto nivel
 
+#### `getConstanciaInscripcion(cuit: string): Promise<PersonaA5>`
+
+Constancia de inscripcion via `ws_sr_constancia_inscripcion` (metodo `getPersona_v2`). Reemplaza a
+Padron A5 (`ws_sr_padron_a5`), deprecado por ARCA. Incluye datos generales, domicilio fiscal,
+caracterizaciones, regimen general (impuestos, actividades, regimenes), monotributo (categoria,
+impuestos, actividad) y, si ARCA no puede emitir la constancia, `errorConstancia`.
+
+```typescript
+const constancia = await padron.getConstanciaInscripcion('30712345674');
+constancia.domicilioFiscal;        // { direccion, localidad, codPostal, idProvincia, ... }
+constancia.impuestos;              // impuestos de ambos regimenes
+constancia.monotributo?.categoria; // { idCategoria, descripcionCategoria, ... }
+```
+
+#### `condicionIvaDesdePadron(persona): { condicionIva: CondicionIva | null; motivo: string }`
+
+Funcion pura (no consulta ARCA). Acepta una constancia (`PersonaA5`) o una persona de A4:
+
+| Padron | `condicionIva` |
+| --- | --- |
+| Monotributo activo (impuesto 20 o categoria) | `MONOTRIBUTISTA` (6) |
+| Monotributo social (categorias 61, 99, 100) | `MONOTRIBUTO_SOCIAL` (13) |
+| Trabajador independiente promovido | `MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO` (16) |
+| IVA activo (impuesto 30) | `RESPONSABLE_INSCRIPTO` (1) |
+| IVA exento (impuesto 32) | `EXENTO` (4) |
+| IVA no alcanzado (impuesto 34) | `IVA_NO_ALCANZADO` (15) |
+| Ninguno de los anteriores, o constancia no emitida | `null` (con el motivo) |
+
+Si el padron no alcanza, devuelve `null` en lugar de asumir consumidor final: decidilo segun la
+operacion. Fuente: manual de `ws_sr_constancia_inscripcion` v4.1 (impuestos 20 y 30, estado `AC`,
+categorias de monotributo social). Los impuestos 32 y 34 se reconocen tambien por su descripcion.
+
+#### `getPersonaA13(cuit: string): Promise<PersonaA13>`
+
+Datos basicos via `ws_sr_padron_a13`. Tambien `getIdPersonaListByDocumento(dni)` devuelve los
+CUIT/CUIL asociados a un documento.
+
 #### `getPersona(cuit: string): Promise<PersonaA4>`
 
 Obtiene los datos completos de un contribuyente via ws_sr_padron_a4. Autentica automaticamente con WSAA.
@@ -92,7 +164,7 @@ const contribuyenteBasico = await padron.getPersonaBasic('20123456789');
 Obtiene una tabla de parametros via ws_sr_padron_a100.
 
 ```typescript
-import { CollectionName } from '@ramiidv/arca-padron-sdk';
+import { CollectionName } from '@ramiidv/arca-padron';
 
 const provincias = await padron.getParametros(CollectionName.PROVINCIA);
 const tiposDocumento = await padron.getParametros(CollectionName.TIPO_DOCUMENTO);
@@ -101,9 +173,9 @@ const tiposRelacion = await padron.getParametros(CollectionName.TIPO_RELACION);
 
 Colecciones disponibles (enum `CollectionName`, valores SUPA.\* prefijados): `PROVINCIA`, `TIPO_DOCUMENTO`, `TIPO_DOMICILIO`, `TIPO_CLAVE`, `TIPO_EMPRESA_JURIDICA`, `TIPO_EMPRESA_JURIDICA_SUBGRUPO`, `TIPO_RELACION`, `TIPO_SUBTIPO_RELACION`, `TIPO_COMPONENTE_SOCIEDAD`, `TIPO_RELACION_COMPONENTE_SOC`, `TIPO_EMAIL`, `TIPO_TELEFONO`, `TIPO_RESIDENCIA`, `TIPO_DATO_ADICIONAL_DOMICILIO`, `ORGANISMO_INFORMANTE`, `ORGANISMO_CONTROL`, `PROVINCIA_SOCIEDAD_ORG`, `SEXO`, `CALLE`, `LOCALIDAD`.
 
-#### `status(): Promise<{ a4: ServerStatus, a10: ServerStatus, a100: ServerStatus }>`
+#### `status(): Promise<{ a5, a4, a10, a13, a100 }>`
 
-Verifica el estado de los tres servicios (no requiere autenticacion).
+Verifica el estado de los servicios (no requiere autenticacion).
 
 ```typescript
 const estadoServicios = await padron.status();
@@ -130,6 +202,9 @@ const credenciales = {
 const contribuyente = await padron.a4.getPersona(credenciales, '20123456789');
 ```
 
+Clientes disponibles: `padron.wsaa`, `padron.a5` (constancia), `padron.a4`, `padron.a10`,
+`padron.a13`, `padron.a100`.
+
 ## Tipos de respuesta
 
 ### PersonaA4 (datos completos)
@@ -219,18 +294,25 @@ El SDK usa una jerarquia de errores de 4 clases:
 
 ```
 Error
-  └── ArcaPadronError (base)
+  └── ArcaError (base, de @ramiidv/arca-common)
+        ├── ArcaPadronError
         ├── ArcaAuthError (errores de WSAA)
-        ├── ArcaPadronServiceError (errores de negocio)
-        └── ArcaSoapError (errores HTTP/transporte)
+        │     └── ArcaTicketVigenteError (TA vigente que no esta en memoria ni en el storage)
+        ├── ArcaServiceError
+        │     └── ArcaPadronServiceError (errores de negocio)
+        └── ArcaSoapError (errores HTTP/transporte, SOAP Faults)
 ```
 
+Todos tienen un `code` estable y `instanceof` funciona aunque haya mas de una copia del paquete
+cargada. ARCA informa "persona inexistente" y similares como SOAP Fault (`ArcaSoapError` con
+`faultString`).
+
 ```typescript
 import {
   ArcaAuthError,
   ArcaPadronServiceError,
   ArcaSoapError,
-} from '@ramiidv/arca-padron-sdk';
+} from '@ramiidv/arca-padron';
 
 try {
   await padron.getPersona('20123456789');
@@ -260,10 +342,10 @@ const padron = new ArcaPadron({
   onEvent: (evento) => {
     switch (evento.type) {
       case 'auth:login':
-        console.log(`Login para ${evento.serviceId}`);
+        console.log(`Login para ${evento.service}`);
         break;
       case 'auth:cache-hit':
-        console.log(`Token cacheado para ${evento.serviceId}`);
+        console.log(`Token reutilizado para ${evento.service} (${evento.source})`);
         break;
       case 'request:start':
         console.log(`Inicio ${evento.method}`);
@@ -291,19 +373,22 @@ import {
   TipoPersona,
   ImpuestoId,
   CollectionName,
-} from '@ramiidv/arca-padron-sdk';
+} from '@ramiidv/arca-padron';
 
-// Verificar si el contribuyente esta inscripto en IVA
+// Verificar si el contribuyente esta inscripto en IVA (mejor: condicionIvaDesdePadron)
 const tieneIva = contribuyente.impuesto?.some(
-  (imp) => imp.idImpuesto === ImpuestoId.IVA_RESPONSABLE_INSCRIPTO && imp.estado === 'AC'
+  (imp) => imp.idImpuesto === ImpuestoId.IVA_RESPONSABLE_INSCRIPTO && imp.estado === 'ACTIVO'
 );
+
+// ImpuestoId.MONOTRIBUTO = 20 (antes figuraba como 21, que era incorrecto)
 ```
 
 ## Requisitos
 
 - Node.js >= 18 (soporte nativo de `fetch`)
 - Certificado digital emitido por ARCA/AFIP
-- Autorizacion para los servicios web correspondientes
+- Autorizacion para los servicios web correspondientes: `ws_sr_constancia_inscripcion`,
+  `ws_sr_padron_a4`, `ws_sr_padron_a10`, `ws_sr_padron_a13`, `ws_sr_padron_a100` (cada uno por separado)
 
 ## Licencia
 

package/dist/cjs/arca-padron.d.ts

@@ -0,0 +1,98 @@
+import { WsaaClient } from '@ramiidv/arca-common';
+import type { CallOptions } from '@ramiidv/arca-common';
+import { PadronA4Client } from './padron-a4.js';
+import { PadronA5Client } from './padron-a5.js';
+import { PadronA10Client } from './padron-a10.js';
+import { PadronA13Client } from './padron-a13.js';
+import { PadronA100Client } from './padron-a100.js';
+import type { ArcaPadronConfig, ParameterRecord, PersonaA4, PersonaA5, PersonaA10, PersonaA13, ServerStatus } from './types.js';
+/**
+ * Main orchestrator class for ARCA Padrón web services.
+ *
+ * Provides high-level methods that handle WSAA authentication automatically
+ * and expose results from the Constancia de Inscripción (ex A5), A4 (full),
+ * A10 (basic), A13 (basic) and A100 (parameters) web services.
+ *
+ * @example
+ * ```ts
+ * import { ArcaPadron, condicionIvaDesdePadron, FileTicketStorage } from '@ramiidv/arca-padron';
+ * import { readFileSync } from 'fs';
+ *
+ * const client = new ArcaPadron({
+ *   cert: readFileSync('cert.pem', 'utf-8'),
+ *   key: readFileSync('key.pem', 'utf-8'),
+ *   cuit: '20123456789',
+ *   production: false,
+ *   ticketStorage: new FileTicketStorage('./.arca-tickets'),
+ * });
+ *
+ * const persona = await client.getConstanciaInscripcion('30712345674');
+ * const { condicionIva, motivo } = condicionIvaDesdePadron(persona);
+ * ```
+ */
+export declare class ArcaPadron {
+    /** Low-level WSAA client for direct access (se puede compartir con arca-facturacion) */
+    readonly wsaa: WsaaClient;
+    /** Low-level Constancia de Inscripción (ex Padrón A5) client */
+    readonly a5: PadronA5Client;
+    /** Low-level Padrón A4 client for direct access */
+    readonly a4: PadronA4Client;
+    /** Low-level Padrón A10 client for direct access */
+    readonly a10: PadronA10Client;
+    /** Low-level Padrón A13 client for direct access */
+    readonly a13: PadronA13Client;
+    /** Low-level Padrón A100 client for direct access */
+    readonly a100: PadronA100Client;
+    private readonly cuit;
+    private readonly signal?;
+    constructor(config: ArcaPadronConfig);
+    /**
+     * Constancia de inscripción (ws_sr_constancia_inscripcion, ex Padrón A5):
+     * datos generales, domicilio fiscal, impuestos del régimen general y
+     * monotributo. Combinar con `condicionIvaDesdePadron` para facturar.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    getConstanciaInscripcion(cuit: string, call?: CallOptions): Promise<PersonaA5>;
+    /**
+     * Get full taxpayer data (Padrón A4) for a given CUIT.
+     * Authenticates automatically via WSAA.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    getPersona(cuit: string, call?: CallOptions): Promise<PersonaA4>;
+    /**
+     * Get basic taxpayer data (Padrón A10) for a given CUIT.
+     * Authenticates automatically via WSAA.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    getPersonaBasic(cuit: string, call?: CallOptions): Promise<PersonaA10>;
+    /**
+     * Get basic taxpayer data (Padrón A13) for a given CUIT.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    getPersonaA13(cuit: string, call?: CallOptions): Promise<PersonaA13>;
+    /**
+     * CUITs/CUILs asociados a un número de documento (Padrón A13).
+     * @param documento - Número de documento (DNI)
+     */
+    getIdPersonaListByDocumento(documento: string, call?: CallOptions): Promise<string[]>;
+    /**
+     * Get a parameter table (Padrón A100) by collection name.
+     * Authenticates automatically via WSAA.
+     * @param collection - Name of the collection (e.g. CollectionName.PROVINCIA, CollectionName.TIPO_DOCUMENTO)
+     */
+    getParametros(collection: string, call?: CallOptions): Promise<ParameterRecord[]>;
+    /**
+     * Health check for the Padrón services.
+     * Does not require authentication.
+     */
+    status(call?: CallOptions): Promise<{
+        a5: ServerStatus;
+        a4: ServerStatus;
+        a10: ServerStatus;
+        a13: ServerStatus;
+        a100: ServerStatus;
+    }>;
+    private opts;
+    private getAuth;
+}
+//# sourceMappingURL=arca-padron.d.ts.map

package/dist/cjs/arca-padron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arca-padron.d.ts","sourceRoot":"","sources":["../../src/arca-padron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAa,WAAW,EAAmB,MAAM,sBAAsB,CAAC;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,UAAU;IACrB,wFAAwF;IACxF,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,gEAAgE;IAChE,SAAgB,EAAE,EAAE,cAAc,CAAC;IACnC,mDAAmD;IACnD,SAAgB,EAAE,EAAE,cAAc,CAAC;IACnC,oDAAoD;IACpD,SAAgB,GAAG,EAAE,eAAe,CAAC;IACrC,oDAAoD;IACpD,SAAgB,GAAG,EAAE,eAAe,CAAC;IACrC,qDAAqD;IACrD,SAAgB,IAAI,EAAE,gBAAgB,CAAC;IAEvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAc;gBAE1B,MAAM,EAAE,gBAAgB;IA0CpC;;;;;OAKG;IACG,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAMpF;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAMtE;;;;OAIG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAM5E;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAM1E;;;OAGG;IACG,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAM3F;;;;OAIG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAMvF;;;OAGG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QACxC,EAAE,EAAE,YAAY,CAAC;QACjB,EAAE,EAAE,YAAY,CAAC;QACjB,GAAG,EAAE,YAAY,CAAC;QAClB,GAAG,EAAE,YAAY,CAAC;QAClB,IAAI,EAAE,YAAY,CAAC;KACpB,CAAC;IAgBF,OAAO,CAAC,IAAI;YAIE,OAAO;CAQtB"}

package/dist/cjs/arca-padron.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArcaPadron = void 0;
+const arca_common_1 = require("@ramiidv/arca-common");
+const constants_js_1 = require("./constants.js");
+const padron_a4_js_1 = require("./padron-a4.js");
+const padron_a5_js_1 = require("./padron-a5.js");
+const padron_a10_js_1 = require("./padron-a10.js");
+const padron_a13_js_1 = require("./padron-a13.js");
+const padron_a100_js_1 = require("./padron-a100.js");
+/**
+ * Main orchestrator class for ARCA Padrón web services.
+ *
+ * Provides high-level methods that handle WSAA authentication automatically
+ * and expose results from the Constancia de Inscripción (ex A5), A4 (full),
+ * A10 (basic), A13 (basic) and A100 (parameters) web services.
+ *
+ * @example
+ * ```ts
+ * import { ArcaPadron, condicionIvaDesdePadron, FileTicketStorage } from '@ramiidv/arca-padron';
+ * import { readFileSync } from 'fs';
+ *
+ * const client = new ArcaPadron({
+ *   cert: readFileSync('cert.pem', 'utf-8'),
+ *   key: readFileSync('key.pem', 'utf-8'),
+ *   cuit: '20123456789',
+ *   production: false,
+ *   ticketStorage: new FileTicketStorage('./.arca-tickets'),
+ * });
+ *
+ * const persona = await client.getConstanciaInscripcion('30712345674');
+ * const { condicionIva, motivo } = condicionIvaDesdePadron(persona);
+ * ```
+ */
+class ArcaPadron {
+    /** Low-level WSAA client for direct access (se puede compartir con arca-facturacion) */
+    wsaa;
+    /** Low-level Constancia de Inscripción (ex Padrón A5) client */
+    a5;
+    /** Low-level Padrón A4 client for direct access */
+    a4;
+    /** Low-level Padrón A10 client for direct access */
+    a10;
+    /** Low-level Padrón A13 client for direct access */
+    a13;
+    /** Low-level Padrón A100 client for direct access */
+    a100;
+    cuit;
+    signal;
+    constructor(config) {
+        const isProduction = config.production ?? false;
+        const env = isProduction ? 'production' : 'testing';
+        this.cuit = config.cuit;
+        this.signal = config.signal;
+        const onEvent = config.onEvent;
+        const soapOptions = {
+            timeout: config.timeout,
+            retries: config.retries,
+            retryDelayMs: config.retryDelayMs,
+        };
+        this.wsaa =
+            config.wsaa ??
+                new arca_common_1.WsaaClient({
+                    cert: config.cert,
+                    key: config.key,
+                    production: isProduction,
+                    timeout: config.timeout,
+                    retries: config.retries,
+                    retryDelayMs: config.retryDelayMs,
+                    onEvent,
+                    ticketStorage: config.ticketStorage,
+                    clockOffsetMs: config.clockOffsetMs,
+                    autoClockSkew: config.autoClockSkew,
+                });
+        const clientConfig = (svc) => ({
+            endpoint: svc[env],
+            namespace: svc.namespace,
+            soapOptions,
+            onEvent,
+        });
+        this.a5 = new padron_a5_js_1.PadronA5Client(clientConfig(constants_js_1.ENDPOINTS.a5));
+        this.a4 = new padron_a4_js_1.PadronA4Client(clientConfig(constants_js_1.ENDPOINTS.a4));
+        this.a10 = new padron_a10_js_1.PadronA10Client(clientConfig(constants_js_1.ENDPOINTS.a10));
+        this.a13 = new padron_a13_js_1.PadronA13Client(clientConfig(constants_js_1.ENDPOINTS.a13));
+        this.a100 = new padron_a100_js_1.PadronA100Client(clientConfig(constants_js_1.ENDPOINTS.a100));
+    }
+    /**
+     * Constancia de inscripción (ws_sr_constancia_inscripcion, ex Padrón A5):
+     * datos generales, domicilio fiscal, impuestos del régimen general y
+     * monotributo. Combinar con `condicionIvaDesdePadron` para facturar.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    async getConstanciaInscripcion(cuit, call) {
+        const opts = this.opts(call);
+        const auth = await this.getAuth(constants_js_1.ENDPOINTS.a5.serviceId, opts);
+        return this.a5.getPersona(auth, cuit, opts);
+    }
+    /**
+     * Get full taxpayer data (Padrón A4) for a given CUIT.
+     * Authenticates automatically via WSAA.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    async getPersona(cuit, call) {
+        const opts = this.opts(call);
+        const auth = await this.getAuth(constants_js_1.ENDPOINTS.a4.serviceId, opts);
+        return this.a4.getPersona(auth, cuit, opts);
+    }
+    /**
+     * Get basic taxpayer data (Padrón A10) for a given CUIT.
+     * Authenticates automatically via WSAA.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    async getPersonaBasic(cuit, call) {
+        const opts = this.opts(call);
+        const auth = await this.getAuth(constants_js_1.ENDPOINTS.a10.serviceId, opts);
+        return this.a10.getPersona(auth, cuit, opts);
+    }
+    /**
+     * Get basic taxpayer data (Padrón A13) for a given CUIT.
+     * @param cuit - CUIT of the taxpayer to query
+     */
+    async getPersonaA13(cuit, call) {
+        const opts = this.opts(call);
+        const auth = await this.getAuth(constants_js_1.ENDPOINTS.a13.serviceId, opts);
+        return this.a13.getPersona(auth, cuit, opts);
+    }
+    /**
+     * CUITs/CUILs asociados a un número de documento (Padrón A13).
+     * @param documento - Número de documento (DNI)
+     */
+    async getIdPersonaListByDocumento(documento, call) {
+        const opts = this.opts(call);
+        const auth = await this.getAuth(constants_js_1.ENDPOINTS.a13.serviceId, opts);
+        return this.a13.getIdPersonaListByDocumento(auth, documento, opts);
+    }
+    /**
+     * Get a parameter table (Padrón A100) by collection name.
+     * Authenticates automatically via WSAA.
+     * @param collection - Name of the collection (e.g. CollectionName.PROVINCIA, CollectionName.TIPO_DOCUMENTO)
+     */
+    async getParametros(collection, call) {
+        const opts = this.opts(call);
+        const auth = await this.getAuth(constants_js_1.ENDPOINTS.a100.serviceId, opts);
+        return this.a100.getParameterCollectionByName(auth, collection, opts);
+    }
+    /**
+     * Health check for the Padrón services.
+     * Does not require authentication.
+     */
+    async status(call) {
+        const opts = this.opts(call);
+        const [a5, a4, a10, a13, a100] = await Promise.all([
+            this.a5.dummy(opts),
+            this.a4.dummy(opts),
+            this.a10.dummy(opts),
+            this.a13.dummy(opts),
+            this.a100.dummy(opts),
+        ]);
+        return { a5, a4, a10, a13, a100 };
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    opts(call) {
+        return { signal: (0, arca_common_1.anySignal)(this.signal, call?.signal) };
+    }
+    async getAuth(serviceId, opts) {
+        const ticket = await this.wsaa.getAccessTicket(serviceId, opts);
+        return {
+            Token: ticket.token,
+            Sign: ticket.sign,
+            CuitRepresentada: this.cuit,
+        };
+    }
+}
+exports.ArcaPadron = ArcaPadron;
+//# sourceMappingURL=arca-padron.js.map

package/dist/cjs/arca-padron.js.map

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

package/dist/{base-client.d.ts → cjs/base-client.d.ts}

@@ -1,4 +1,5 @@
-import type { ArcaEvent, SoapCallOptions, ServerStatus } from '@ramiidv/arca-common';
+import type { ArcaEvent, CallOptions, SoapCallOptions, ServerStatus } from '@ramiidv/arca-common';
+import type { WsAuth } from './types.js';
 /** Shared configuration for all Padrón service clients. */
 export interface PadronClientConfig {
     /** SOAP endpoint URL */
@@ -13,6 +14,11 @@ export interface PadronClientConfig {
 /**
  * Abstract base class for Padrón web service clients.
  * Provides shared constructor logic and health-check method.
+ *
+ * Los WS de Padrón declaran los parámetros sin namespace
+ * (`elementFormDefault="unqualified"`): `afipSoapCall` de arca-common prefija
+ * el método y deja los parámetros sin namespace. Todas las consultas se
+ * reintentan ante errores transitorios.
  */
 export declare abstract class BasePadronClient {
     protected readonly endpoint: string;
@@ -20,7 +26,11 @@ export declare abstract class BasePadronClient {
     protected readonly soapOptions?: Pick<SoapCallOptions, 'timeout' | 'retries' | 'retryDelayMs'>;
     protected readonly onEvent?: (event: ArcaEvent) => void;
     constructor(config: PadronClientConfig);
+    /** Llama a un método del servicio. */
+    protected call(method: string, params: Record<string, unknown>, opts?: CallOptions): Promise<Record<string, unknown>>;
+    /** Parámetros de autenticación en el orden del WSDL: token, sign, cuitRepresentada. */
+    protected authParams(auth: WsAuth): Record<string, unknown>;
     /** Health check for this service. */
-    dummy(): Promise<ServerStatus>;
+    dummy(opts?: CallOptions): Promise<ServerStatus>;
 }
 //# sourceMappingURL=base-client.d.ts.map

package/dist/cjs/base-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../../src/base-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC,CAAC;IAC5E,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,8BAAsB,gBAAgB;IACpC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC,CAAC;IAC/F,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;gBAE5C,MAAM,EAAE,kBAAkB;IAOtC,sCAAsC;IACtC,SAAS,CAAC,IAAI,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQnC,uFAAuF;IACvF,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQ3D,qCAAqC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CASvD"}