@ramiidv/arca-padron 0.6.0 → 0.7.0

package/llms.txt

@@ -1,86 +1,93 @@
 # @ramiidv/arca-padron
 
-> TypeScript SDK para los web services de Padron de ARCA (ex AFIP) - Constancia de Inscripcion (ex A5), A4, A10, A13 y A100, mas condicionIvaDesdePadron
+> SDK en TypeScript para los web services de Padrón de ARCA (ex AFIP): Constancia de Inscripción (ex A5), A4, A10, A13 y A100, más `condicionIvaDesdePadron` para obtener la condición frente al IVA del receptor de una factura.
 
-## Instalacion
+## Instalación
 
 ```bash
 npm install @ramiidv/arca-padron
 ```
 
-Requisitos: Node.js >= 18 (fetch nativo). Dual ESM + CommonJS.
+Requisitos: Node.js >= 20.19. Solo ESM; desde CommonJS se carga con `require()` (require(esm)). Única dependencia: `@ramiidv/arca-common`.
 
-## Configuracion
+## Configuración
 
 ```typescript
 import { ArcaPadron } from '@ramiidv/arca-padron';
 
-// ArcaPadronConfig extends ArcaBaseConfig (@ramiidv/arca-common)
+// ArcaPadronConfig extiende ArcaSdkConfig (@ramiidv/arca-common)
 const padron = new ArcaPadron({
-  cert: string,          // PEM X.509 certificate
-  key: string,           // PEM private key
-  cuit: string | number, // CUIT representada (validated: check digit). Ej: "20123456786"
-  production?: boolean,  // default: false (homologacion)
+  cert: string,          // certificado X.509 (PEM)
+  key: string,           // clave privada (PEM)
+  keyPassphrase?: string,
+  cuit: string | number, // CUIT representada (se valida el dígito verificador). Ej: "20123456786"
+  production?: boolean,  // default: false (homologación)
   timeout?: number,      // ms, default 30000
-  retries?: number,      // default: 1 (transient errors only; SOAP Faults are never retried)
-  retryDelayMs?: number, // default: 1000
+  retries?: number,      // default 1 (solo errores transitorios; un SOAP Fault nunca se reintenta)
+  retryDelayMs?: number, // default 1000
   tokenTTLMinutes?: number,
   onEvent?: (event: ArcaEvent) => void,
-  ticketStorage?: TicketStorage, // persist WSAA tickets across restarts (recommended)
-  clockOffsetMs?: number,        // ARCA clock - local clock, ms. Default: 0
-  autoClockSkew?: boolean,       // default: true
+  ticketStorage?: TicketStorage, // persiste los tickets WSAA entre reinicios (recomendado)
+  clockOffsetMs?: number,        // reloj ARCA - reloj local, ms. Default 0
+  autoClockSkew?: boolean,       // default true
   loginErrorCooldownMs?: number,
-  fetch?: typeof fetch,          // custom fetch (proxy, tests)
+  permanentErrorCooldownMs?: number,
+  fetch?: typeof fetch,          // fetch propio (proxy, tests)
   legacyTls?: 'auto' | 'never' | 'always',
-  signal?: AbortSignal,          // global cancellation
-  wsaa?: WsaaClient,             // shared WSAA client (e.g. arca.wsaa from arca-facturacion)
-  endpoints?: { wsaa?, a5?, a4?, a10?, a13?, a100? }, // override URLs
+  wsaa?: WsaaClient,             // WsaaClient compartido (ej: facturacion.wsaa de @ramiidv/arca-facturacion), mismo entorno
+  signal?: AbortSignal,          // cancela todas las llamadas de la instancia
+  endpoints?: { wsaa?, a5?, a4?, a10?, a13?, a100? }, // URLs propias
 });
 ```
 
-Every method accepts an optional last argument `{ signal?: AbortSignal }`.
-CUITs are accepted with or without dashes ('20-11111111-2', '20111111112', 20111111112), validated locally (check digit; ArcaValidationError without calling ARCA) and sent normalized.
-All Padron operations are read-only queries.
-Without `ticketStorage`, a restart loses the access ticket and WSAA rejects new logins until it expires (`ArcaTicketVigenteError`).
+Todos los métodos aceptan un último argumento opcional `{ signal?: AbortSignal }`.
+Las CUIT se aceptan con o sin guiones ('20-11111111-2', '20111111112', 20111111112), se validan localmente (dígito verificador; `ArcaValidationError` sin llamar a ARCA) y se envían normalizadas.
+Todas las operaciones de Padrón son consultas.
+Sin `ticketStorage`, un reinicio pierde el ticket de acceso y WSAA rechaza nuevos logins hasta que vence (`ArcaTicketVigenteError`).
 
-## Metodos principales
+## Métodos principales
 
 ### getConstanciaInscripcion(cuit): Promise<PersonaA5>
-Constancia de inscripcion via ws_sr_constancia_inscripcion (getPersona_v2; replaces ws_sr_padron_a5, deprecated by ARCA). PersonaA5: idPersona, tipoPersona, nombre/apellido/razonSocial, estadoClave, domicilioFiscal, dependencia, caracterizacion[], regimenGeneral { impuestos, actividades, regimenes, categoriaAutonomo }, monotributo { impuestos, actividades, actividadMonotributista, categoria, componenteDeSociedad[] }, impuestos (both regimes), errorConstancia { error[] }, errorRegimenGeneral { error[], mensaje }, errorMonotributo { error[], mensaje }. Constancia-level problems are returned in those error fields, not thrown.
+Constancia de inscripción vía ws_sr_constancia_inscripcion (`getPersona_v2`; reemplaza a ws_sr_padron_a5, deprecado por ARCA). PersonaA5: idPersona, tipoPersona, nombre/apellido/razonSocial, estadoClave, domicilioFiscal, dependencia, caracterizacion[], regimenGeneral { impuestos, actividades, regimenes, categoriaAutonomo }, monotributo { impuestos, actividades, actividadMonotributista, categoria, componenteDeSociedad[] }, impuestos (ambos regímenes), errorConstancia { error[] }, errorRegimenGeneral { error[], mensaje }, errorMonotributo { error[], mensaje }, metadata { fechaHora, servidor }. Los problemas de la constancia (CUIT limitada, domicilio incompleto...) vuelven en esos campos, no se lanzan. Excepción: CUIT inexistente (Fault, o errorConstancia "No existe persona con ese Id") → `ArcaPadronServiceError` con reason 'inexistente'.
 
-### getConstanciasInscripcion(cuits[]): Promise<PersonaA5[]>
-getPersonaList_v2: 1 to 250 CUITs per call. Non-existent CUITs come back as a PersonaA5 with errorConstancia.error = ['No existe persona con ese Id'].
+### getConstanciasInscripcion(cuits[]): Promise<ListaPadron<PersonaA5>>
+`getPersonaList_v2`: 1 a 250 CUITs por llamada (fuera de ese rango, ArcaValidationError), resultado en el orden de `cuits`. Una CUIT no hace fallar el lote: inexistente → errorConstancia.error = ['No existe persona con ese Id']; CUIT inválida → no se envía a ARCA y vuelve con idPersona = valor recibido y errorConstancia.error = ['CUIT inválido: ... No se consultó a ARCA.']; persona con datos inválidos en la respuesta → errorConstancia con el detalle (si no trae CUIT, se omite).
 
 ### condicionIvaDesdePadron(persona: PersonaA5 | PersonaA4): { condicionIva: CondicionIva | null; motivo: string }
-Pure helper. Tax states: words from A4 manual TipoEstado (ACTIVO, ACTIVO EN TRAMITE, BAJA PROVISORIA, BAJA DEFINITIVA, EXENTO, EXENTO EN TRAMITE, NO APORTANTE) or SUPA ids (AC, EX, BP, BD, NA). Active = ACTIVO / ACTIVO EN TRAMITE. Monotributo (impuesto 20 active; category only if impuesto 20 is absent; impuesto 20 in BAJA never counts) → MONOTRIBUTISTA (6); categories 61/99/100/101-104 → MONOTRIBUTO_SOCIAL (13); category description "PROMOVID" → MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO (16); category 98 (asociado cooperativa) → MONOTRIBUTISTA. IVA 30 active → RESPONSABLE_INSCRIPTO (1); IVA 30 EXENTO/EXENTO EN TRAMITE or impuesto 32 → EXENTO (4); impuesto 34 → IVA_NO_ALCANZADO (15). NO APORTANTE is NOT "no alcanzado". Otherwise null with motivo (never assumes consumidor final); errorRegimenGeneral/errorMonotributo are included in motivo. Use the result as `condicionIva` in @ramiidv/arca-facturacion.
+Función pura. Estados de impuestos: palabras de TipoEstado del manual A4 (ACTIVO, ACTIVO EN TRAMITE, BAJA PROVISORIA, BAJA DEFINITIVA, EXENTO, EXENTO EN TRAMITE, NO APORTANTE) o ids SUPA (AC, EX, BP, BD, NA). Activo = ACTIVO / ACTIVO EN TRAMITE. Monotributo (impuesto 20 activo; la categoría solo si no figura el 20; un 20 en BAJA nunca cuenta) → MONOTRIBUTISTA (6); categorías 61/99/100/101-104 → MONOTRIBUTO_SOCIAL (13); descripción de categoría con "PROMOVID" → MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO (16); categoría 98 (asociado cooperativa) → MONOTRIBUTISTA. Monotributo tiene prioridad sobre IVA. IVA 30 activo → RESPONSABLE_INSCRIPTO (1); IVA 30 EXENTO/EXENTO EN TRAMITE o impuesto 32 → EXENTO (4); impuesto 34 → IVA_NO_ALCANZADO (15); impuesto 33 (responsable no inscripto, categoría eliminada) → null con motivo propio. NO APORTANTE no es "no alcanzado". Si no, null con motivo (nunca asume consumidor final). Los errores de ARCA (errorConstancia, p. ej. CUIT limitada RG 3832/16; errorRegimenGeneral; errorMonotributo) y una CUIT no activa se advierten siempre en el motivo, también cuando la condición se determinó. Usar el resultado como `condicionIva` en @ramiidv/arca-facturacion.
 
 ### getPersonaA13(cuit): Promise<PersonaA13>
-Datos basicos via ws_sr_padron_a13 getPersona (domicilio[] with calle, numero, codigoPostal, estadoDomicilio...). Throws ArcaPadronServiceError reason 'inactiva' for inactive keys.
+Datos básicos vía ws_sr_padron_a13 `getPersona` (domicilio[] con calle, numero, codigoPostal, estadoDomicilio...). Con la clave inactiva lanza ArcaPadronServiceError reason 'inactiva'.
 
 ### getPersonaA13V2(cuit): Promise<PersonaA13>
-A13 getPersonaV2 (manual v1.4): also returns data for INACTIVE keys.
+A13 `getPersonaV2` (manual v1.4): responde también con la clave INACTIVA.
 
-### getIdPersonaListByDocumento(documento): Promise<string[]>
-CUIT/CUIL list for a document number via ws_sr_padron_a13. Accepts dots/spaces ('11.709.676'). Returns [] when ARCA reports none.
+### getIdPersonaListByDocumento(documento): Promise<ListaPadron<string>>
+CUIT/CUIL asociados a un número de documento (A13). Acepta puntos, espacios y guiones ('11.709.676'); 1 a 11 dígitos. Devuelve [] si ARCA no informa claves.
 
 ### getPersona(cuit): Promise<PersonaA4>
-Datos completos del contribuyente via ws_sr_padron_a4. Incluye: domicilios, impuestos, actividades, regimenes, relaciones, categorias, emails, telefonos.
+Datos completos vía ws_sr_padron_a4: domicilios, impuestos, actividades, regímenes, relaciones, categorías, emails, teléfonos.
 
 ### getPersonaBasic(cuit): Promise<PersonaA10>
-Datos basicos del contribuyente via ws_sr_padron_a10. Incluye: datos generales, dependencia y domicilios.
+Datos básicos vía ws_sr_padron_a10: datos generales, dependencia y domicilios.
 
-### getParametros(collection: string): Promise<ParameterRecord[]>
-Tablas de parametros via ws_sr_padron_a100 (getParameterCollectionByName). id, descripcion and attribute values are returned exactly as sent by ARCA (xs:string: "10.50" stays "10.50"). Throws ArcaPadronError if parameterCollection is missing; an empty collection returns []. CollectionName enum (manual A100 v2.1): PROVINCIA (SUPA.E_PROVINCIA), TIPO_DOCUMENTO (SUPA.TIPO_DOCUMENTO), TIPO_DOMICILIO (SUPA.TIPO_DOMICILIO), TIPO_CLAVE (SUPA.TIPO_CLAVE_IDENTIFICACION), 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 (E_SEXO), CALLE (PUC_PARAM.T_CALLE), LOCALIDAD (PUC_PARAM.T_LOCALIDAD), AUTONOMO_MONOTRIBUTO (SUPA.E_AUTONOMO_MONOTRIBUTO), REGIMEN (SUPA.E_REGIMEN), TIPO_REGIMEN (SUPA.TIPO_REGIMEN), CARACTERIZACION (SUPA.E_CARACTERIZACION), TIPO_ARCHIVO (SUPA.TIPO_ARCHIVO), ACTIVIDAD_RUBRO (SUPA.A_ACTIVIDAD_RUBRO), RUBRO_ACTIVIDAD (SUPA.E_RUBRO_ACTIVIDAD), ACTIVIDAD_OCUPACIONAL (SUPA.E_ACTIVIDAD_OCUPACIONAL).
+### getParametros(collection: string): Promise<ListaPadron<ParameterRecord>>
+Tablas de parámetros vía ws_sr_padron_a100 (`getParameterCollectionByName`). id, descripcion y los value de los atributos vuelven tal cual los envía ARCA (xs:string: "10.50" sigue siendo "10.50"). Lanza ArcaPadronError si falta parameterCollection; una colección vacía devuelve []; un nombre vacío lanza ArcaValidationError. Enum CollectionName (manual A100 v2.1): PROVINCIA (SUPA.E_PROVINCIA), TIPO_DOCUMENTO, TIPO_DOMICILIO, TIPO_CLAVE (SUPA.TIPO_CLAVE_IDENTIFICACION), 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 (E_SEXO), CALLE (PUC_PARAM.T_CALLE), LOCALIDAD (PUC_PARAM.T_LOCALIDAD), AUTONOMO_MONOTRIBUTO, REGIMEN, TIPO_REGIMEN, CARACTERIZACION, TIPO_ARCHIVO, ACTIVIDAD_RUBRO, RUBRO_ACTIVIDAD, ACTIVIDAD_OCUPACIONAL.
 
 ### status(): Promise<PadronStatus>
-Health check (dummy) of a5, a4, a10, a13, a100 in parallel. Each value is `ServiceStatus` from arca-common (`{ ok: true, status: ServerStatus } | { ok: false, error: Error }`): `if (s.a4.ok) s.a4.status.appserver`. No authentication.
+`dummy` de a5, a4, a10, a13 y a100 en paralelo, sin autenticación. Cada valor es un `ServiceStatus` de arca-common: `{ ok: true, status }` solo si los tres servidores (appserver, dbserver, authserver) están en "OK"; `{ ok: false, error, status }` si respondió con alguno en otro estado (ej: dbserver "ERROR"); `{ ok: false, error }` si no respondió. Los `dummy()` de bajo nivel devuelven el ServerStatus sin evaluar (usar `serverStatusOk` de arca-common).
+
+### metadata
+Las personas traen `metadata?: { fechaHora?, servidor? }` de la respuesta. Las listas (`ListaPadron<T> = T[] & { metadata? }`) lo traen en `lista.metadata`, propiedad no enumerable del array.
 
 ## Tipos principales
 
+Los xs:string y xs:long (CUIT, actividades, teléfonos, códigos postales) vuelven como string. Los xs:dateTime (fechaContratoSocial, fechaNacimiento, ffRelacion, metadata.fechaHora...) vuelven como el string que envía ARCA, sin convertir a Date. `TipoPersonaPadron = 'FISICA' | 'JURIDICA' | (string & {})`: el SDK no rechaza otro valor.
+
 ```typescript
 interface PersonaA4 {
   idPersona: string;
-  tipoPersona: 'FISICA' | 'JURIDICA';
+  tipoPersona: TipoPersonaPadron;
   tipoClave?: string;
   estadoClave?: string;
   apellido?: string;
@@ -117,11 +124,12 @@ interface PersonaA4 {
   categoria?: CategoriaA4[];
   email?: EmailA4[];
   telefono?: TelefonoA4[];
+  metadata?: PadronMetadata;
 }
 
 interface PersonaA10 {
   idPersona: string;
-  tipoPersona: 'FISICA' | 'JURIDICA';
+  tipoPersona: TipoPersonaPadron;
   tipoClave?: string;
   estadoClave?: string;
   nombre?: string;
@@ -134,17 +142,36 @@ interface PersonaA10 {
   dependencia?: DependenciaA10;
   claveInactivaAsociada?: string[];
   domicilio?: DomicilioA10[];
+  metadata?: PadronMetadata;
+}
+
+interface PersonaA13 {
+  idPersona: string;
+  tipoPersona: TipoPersonaPadron;
+  tipoClave?: string;
+  estadoClave?: string;
+  nombre?: string;
+  apellido?: string;
+  razonSocial?: string;
+  numeroDocumento?: string;
+  tipoDocumento?: string;
+  formaJuridica?: string;
+  mesCierre?: number;
+  fechaNacimiento?: string;
+  fechaFallecimiento?: string;
+  fechaContratoSocial?: string;
+  idActividadPrincipal?: string;
+  descripcionActividadPrincipal?: string;
+  periodoActividadPrincipal?: number;
+  claveInactivaAsociada?: string[];
+  domicilio?: DomicilioA13[];
+  metadata?: PadronMetadata;
 }
 
 interface ParameterRecord {
   id: string;
   descripcion: string;
-  atributos?: ParameterAttribute[];
-}
-
-interface ParameterAttribute {
-  name: string;
-  value?: string; // exactly as sent by ARCA
+  atributos?: { name: string; value?: string }[]; // value tal cual lo envía ARCA
 }
 
 interface ServerStatus {
@@ -156,13 +183,13 @@ interface ServerStatus {
 
 ## Errores
 
-All extend ArcaError (from @ramiidv/arca-common), have a stable `code`, and instanceof works across duplicated package copies:
-- ArcaValidationError: invalid CUIT/document (no request sent)
-- ArcaAuthError: WSAA authentication failures
-- ArcaTicketVigenteError (extends ArcaAuthError): WSAA already issued a valid TA not available in memory/storage
-- ArcaPadronServiceError (extends ArcaServiceError): business errors. ARCA reports them as SOAP Faults; known texts are converted with a typed `reason`: 'inexistente' ("La Clave (CUIT/CUIL) consultada es inexistente", "No existe persona con ese Id"), 'inactiva' ("... se encuentra INACTIVA"), 'id_invalido' ("El Id de la persona no es valido"), 'no_autorizado' (token/sign/cuitRepresentada errors), 'otro'. `errors[0].msg` has ARCA's text, `cause` is the original ArcaSoapError. Never retried.
-- ArcaPadronError: ARCA response missing a mandatory element (e.g. personaReturn without persona).
-- ArcaSoapError: HTTP/transport errors, timeouts, aborts and unrecognized SOAP Faults (statusCode?, faultCode?, faultString?, uncertain, aborted).
+Todos extienden ArcaError (de @ramiidv/arca-common), tienen un `code` estable e `instanceof` funciona aunque haya copias duplicadas del paquete:
+- ArcaValidationError: CUIT/documento inválido (no se envió el request).
+- ArcaAuthError: errores de autenticación WSAA.
+- ArcaTicketVigenteError (extiende ArcaAuthError): WSAA ya emitió un TA vigente que no está en memoria ni en el storage.
+- ArcaPadronServiceError (extiende ArcaServiceError): errores de negocio. ARCA los informa como SOAP Fault; los textos conocidos se convierten con un `reason` tipado: 'inexistente' ("La Clave (CUIT/CUIL) consultada es inexistente", "No existe persona con ese Id"; en la constancia también desde errorConstancia), 'inactiva' ("... se encuentra INACTIVA"), 'id_invalido' ("El Id de la persona no es valido"), 'no_autorizado' ("No autorizado, par token/sign invalido.", "Falta token y/o sign.", "Debe enviar la CUIT representada", "Este token no le permite actuar en representacion de la CUIT ..."), 'otro'. `errors[0].msg` tiene el texto de ARCA; `cause`, el ArcaSoapError original. Nunca se reintentan.
+- ArcaPadronError: respuesta de ARCA sin un elemento obligatorio (ej: personaReturn sin persona).
+- ArcaSoapError: errores HTTP/transporte, timeouts, cancelaciones y SOAP Faults no reconocidos (statusCode?, faultCode?, faultString?, uncertain, aborted).
 
 ```typescript
 import { ArcaPadronServiceError, ArcaSoapError, ArcaValidationError } from '@ramiidv/arca-padron';
@@ -170,33 +197,36 @@ import { ArcaPadronServiceError, ArcaSoapError, ArcaValidationError } from '@ram
 try {
   await padron.getPersona(cuit);
 } catch (error) {
-  if (error instanceof ArcaValidationError) { /* bad CUIT */ }
-  else if (error instanceof ArcaPadronServiceError && error.reason === 'inexistente') { /* CUIT does not exist */ }
-  else if (error instanceof ArcaPadronServiceError) { /* other business error: error.reason, error.errors */ }
-  else if (error instanceof ArcaSoapError) { /* HTTP/network error, error.statusCode */ }
+  if (error instanceof ArcaValidationError) { /* CUIT inválida */ }
+  else if (error instanceof ArcaPadronServiceError && error.reason === 'inexistente') { /* la CUIT no existe */ }
+  else if (error instanceof ArcaPadronServiceError) { /* otro error de negocio: error.reason, error.errors */ }
+  else if (error instanceof ArcaSoapError) { /* error HTTP/red: error.statusCode */ }
 }
 ```
 
 ## Eventos
 
-Discriminated union types: auth:login, auth:cache-hit (source: memory|storage), auth:clock-skew, auth:storage-error, request:start, request:end, request:retry, request:error.
+Unión discriminada: auth:login, auth:cache-hit (source: memory|storage), auth:clock-skew, auth:storage-error, request:start, request:end, request:retry, request:error. Por `onEvent` o `padron.on(tipo, handler)`.
+
+## Entornos
+
+Hosts: homologación `https://awshomo.afip.gov.ar`, producción `https://aws.afip.gov.ar` (rutas `/sr-padron/webservices/personaServiceA5|A4|A10|A13` y `/sr-parametros/webservices/parameterServiceA100`). El manual de la constancia v4.1 publica `awshomo.arca.gob.ar` / `aws.arca.gob.ar`; el SDK usa los `soap:address` de los WSDL oficiales (afip.gov.ar), que responden igual. Constante `ENDPOINTS`; se pueden sobrescribir con `endpoints`.
 
 ## Enums
 
-- Provincia (0-24, Argentine provinces)
+- Provincia (0-24)
 - TipoDomicilio (FISCAL, LEGAL, REAL)
 - TipoPersona (FISICA, JURIDICA)
-- ImpuestoId (GANANCIAS_PH=11, MONOTRIBUTO=20, MONOTRIBUTO_AUTONOMO=21, IVA_RESPONSABLE_INSCRIPTO=30, BIENES_PERSONALES=180, EMPLEADOR=301, AUTONOMOS=308 — from ARCA manuals; GANANCIAS_PJ=10, IVA_EXENTO=32, IVA_NO_ALCANZADO=34 are not in the padron manuals). Social monotributo is identified by category, not by tax id.
-- DocTipo (numeric WSFEv1 document codes, from common): it is NOT the padron `tipoDocumento` string ("DNI", "LC"...).
-- CondicionIva (re-exported from @ramiidv/arca-common)
-- CollectionName (see getParametros)
+- EstadoClave (ACTIVO, INACTIVO, LIMITADO)
+- ImpuestoId (GANANCIAS_PH=11, MONOTRIBUTO=20, MONOTRIBUTO_AUTONOMO=21, IVA_RESPONSABLE_INSCRIPTO=30, BIENES_PERSONALES=180, EMPLEADOR=301, AUTONOMOS=308: de los manuales de ARCA; GANANCIAS_PJ=10, IVA_EXENTO=32, IVA_RESPONSABLE_NO_INSCRIPTO=33, IVA_NO_ALCANZADO=34 no figuran en los manuales del padrón). El monotributo social se identifica por categoría, no por id de impuesto.
+- DocTipo (códigos numéricos de WSFEv1, de common): NO es el `tipoDocumento` string del padrón ("DNI", "LC"...).
+- CondicionIva (reexportado de @ramiidv/arca-common)
+- CollectionName (ver getParametros)
 
 ## Clientes de bajo nivel
 
-Accesibles como propiedades publicas: padron.wsaa, padron.a5 (constancia: getPersona, getPersonaList), padron.a4, padron.a10, padron.a13 (getPersona, getPersonaV2, getIdPersonaListByDocumento), padron.a100. They take `auth: { Token, Sign, CuitRepresentada }` as first argument.
+Propiedades públicas: padron.wsaa, padron.a5 (constancia: getPersona, getPersonaList), padron.a4, padron.a10, padron.a13 (getPersona, getPersonaV2, getIdPersonaListByDocumento), padron.a100 (getParameterCollectionByName). Reciben `auth: WsAuth = { token, sign, cuitRepresentada }` como primer argumento.
 
-## Utilidades exportadas
+## Deprecados
 
-- ensureArray<T>(value): T[] - normaliza single/array SOAP responses
-- parseXml(xml): Record<string, unknown> - parse XML with CUIT-safe options
-- buildXml(obj): string - build XML from object
+`ensureArray`, `parseXml` y `buildXml` se siguen exportando por compatibilidad: importarlos de @ramiidv/arca-common. `BasePadronClient.soapOptions` y `.onEvent` (protected) no se usan.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramiidv/arca-padron",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "TypeScript SDK para los web services de Padrón de ARCA (ex AFIP) - Constancia de Inscripción, A4, A10, A13 y A100",
   "author": "ramiidv",
   "license": "MIT",
@@ -56,6 +56,6 @@
     "node": ">=20.19.0"
   },
   "dependencies": {
-    "@ramiidv/arca-common": "^0.6.0"
+    "@ramiidv/arca-common": "^0.7.0"
   }
 }