@ramiidv/arca-padron 0.3.0 → 0.5.0

package/dist/arca-padron.js

@@ -0,0 +1,178 @@
+import { ArcaSdkBase } from '@ramiidv/arca-common';
+import { ENDPOINTS } from './constants.js';
+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';
+/**
+ * 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 class ArcaPadron extends ArcaSdkBase {
+    /** 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;
+    /** @throws ArcaValidationError si la CUIT representada es inválida. */
+    constructor(config) {
+        super(config, {
+            a5: ENDPOINTS.a5.serviceId,
+            a4: ENDPOINTS.a4.serviceId,
+            a10: ENDPOINTS.a10.serviceId,
+            a13: ENDPOINTS.a13.serviceId,
+            a100: ENDPOINTS.a100.serviceId,
+        });
+        const { onEvent, ...soapOptions } = this.transport;
+        const clientConfig = (svc) => ({
+            endpoint: this.endpoint(ENDPOINTS[svc], config.endpoints?.[svc]),
+            namespace: ENDPOINTS[svc].namespace,
+            soapOptions,
+            onEvent,
+        });
+        this.a5 = new PadronA5Client(clientConfig('a5'));
+        this.a4 = new PadronA4Client(clientConfig('a4'));
+        this.a10 = new PadronA10Client(clientConfig('a10'));
+        this.a13 = new PadronA13Client(clientConfig('a13'));
+        this.a100 = new PadronA100Client(clientConfig('a100'));
+    }
+    /**
+     * Constancia de inscripción (ws_sr_constancia_inscripcion, ex Padrón A5,
+     * `getPersona_v2`): datos generales, domicilio fiscal, impuestos del régimen
+     * general y monotributo. Combinar con `condicionIvaDesdePadron` para facturar.
+     * @param cuit - CUIT a consultar (con o sin guiones)
+     * @throws ArcaValidationError si la CUIT es inválida (dígito verificador)
+     * @throws ArcaPadronServiceError si ARCA informa la CUIT inexistente, inactiva, etc.
+     */
+    async getConstanciaInscripcion(cuit, call) {
+        const opts = this.callOptions(call);
+        const auth = await this.getAuth('a5', call);
+        return this.a5.getPersona(auth, cuit, opts);
+    }
+    /**
+     * Constancias de inscripción de hasta 250 CUITs en una llamada
+     * (`getPersonaList_v2`). Las CUITs inexistentes vuelven con `errorConstancia`
+     * ("No existe persona con ese Id") en lugar de hacer fallar la consulta.
+     */
+    async getConstanciasInscripcion(cuits, call) {
+        const opts = this.callOptions(call);
+        const auth = await this.getAuth('a5', call);
+        return this.a5.getPersonaList(auth, cuits, opts);
+    }
+    /**
+     * Datos completos de un contribuyente (Padrón A4).
+     * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
+     */
+    async getPersona(cuit, call) {
+        const opts = this.callOptions(call);
+        const auth = await this.getAuth('a4', call);
+        return this.a4.getPersona(auth, cuit, opts);
+    }
+    /**
+     * Datos básicos de un contribuyente (Padrón A10).
+     * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
+     */
+    async getPersonaBasic(cuit, call) {
+        const opts = this.callOptions(call);
+        const auth = await this.getAuth('a10', call);
+        return this.a10.getPersona(auth, cuit, opts);
+    }
+    /**
+     * Datos básicos de un contribuyente (Padrón A13, `getPersona`). Con la clave
+     * inactiva ARCA responde con error (`reason: 'inactiva'`): ver `getPersonaA13V2`.
+     * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
+     */
+    async getPersonaA13(cuit, call) {
+        const opts = this.callOptions(call);
+        const auth = await this.getAuth('a13', call);
+        return this.a13.getPersona(auth, cuit, opts);
+    }
+    /**
+     * Datos básicos de un contribuyente (Padrón A13, `getPersonaV2`): responde
+     * también si la clave está INACTIVA (manual A13 v1.4).
+     */
+    async getPersonaA13V2(cuit, call) {
+        const opts = this.callOptions(call);
+        const auth = await this.getAuth('a13', call);
+        return this.a13.getPersonaV2(auth, cuit, opts);
+    }
+    /**
+     * CUITs/CUILs asociados a un número de documento (Padrón A13).
+     * @param documento - Número de documento (DNI); se aceptan puntos y espacios
+     */
+    async getIdPersonaListByDocumento(documento, call) {
+        const opts = this.callOptions(call);
+        const auth = await this.getAuth('a13', call);
+        return this.a13.getIdPersonaListByDocumento(auth, documento, opts);
+    }
+    /**
+     * Tabla de parámetros (Padrón A100) por nombre de colección.
+     * @param collection - Nombre de la colección (ej: CollectionName.PROVINCIA)
+     */
+    async getParametros(collection, call) {
+        const opts = this.callOptions(call);
+        const auth = await this.getAuth('a100', call);
+        return this.a100.getParameterCollectionByName(auth, collection, opts);
+    }
+    /**
+     * Estado de los servicios de Padrón (`dummy`, sin autenticación). Consulta
+     * todos en paralelo y devuelve el resultado de cada uno por separado: un
+     * servicio caído no oculta el estado de los demás.
+     *
+     * @example
+     * ```ts
+     * const s = await padron.status();
+     * if (s.a4.status === 'fulfilled') console.log(s.a4.value.appserver);
+     * else console.error(s.a4.reason);
+     * ```
+     */
+    async status(call) {
+        const opts = this.callOptions(call);
+        const [a5, a4, a10, a13, a100] = await Promise.allSettled([
+            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
+    // -------------------------------------------------------------------------
+    async getAuth(service, call) {
+        const ticket = await this.ticket(service, call);
+        return {
+            Token: ticket.token,
+            Sign: ticket.sign,
+            CuitRepresentada: this.cuit,
+        };
+    }
+}
+//# sourceMappingURL=arca-padron.js.map

package/dist/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

@@ -0,0 +1,45 @@
+import { SoapServiceClient } from '@ramiidv/arca-common';
+import type { ArcaEvent, CallOptions, ServerStatus, SoapCallOptions } from '@ramiidv/arca-common';
+import type { WsAuth } from './types.js';
+/** Opciones de transporte que se pasan a cada llamada SOAP. */
+export type PadronSoapOptions = Pick<SoapCallOptions, 'timeout' | 'retries' | 'retryDelayMs' | 'fetch' | 'legacyTls'>;
+/** Shared configuration for all Padrón service clients. */
+export interface PadronClientConfig {
+    /** SOAP endpoint URL */
+    endpoint: string;
+    /** SOAP namespace */
+    namespace: string;
+    /** Opciones de transporte (timeout, reintentos, fetch, TLS legacy) */
+    soapOptions?: PadronSoapOptions;
+    /** Optional event callback */
+    onEvent?: (event: ArcaEvent) => void;
+}
+/**
+ * Base de los clientes de Padrón.
+ *
+ * Los WS de Padrón declaran los parámetros sin namespace
+ * (`elementFormDefault="unqualified"`) y `soapAction=""`: `afipSoapCall` de
+ * arca-common prefija el método y deja los parámetros sin namespace. Todas las
+ * operaciones son consultas: se reintentan ante errores transitorios (nunca
+ * ante un SOAP Fault). Los Faults de negocio conocidos (CUIT inexistente,
+ * clave inactiva, token no autorizado...) se lanzan como `ArcaPadronServiceError`.
+ *
+ * Las respuestas se parsean con `parseNumbers: false`: todos los valores llegan
+ * como string tal cual los envía ARCA, y los schemas de cada servicio (DSL de
+ * `@ramiidv/arca-common/schema`, ver `mapping.ts`) convierten los campos
+ * numéricos del WSDL. Así los `xs:string`
+ * con contenido numérico (`datoAdicional`, `codPostal`, `piso`, los campos del
+ * A100...) no pierden ceros ni decimales (`"10.50"`, `"1E3"`).
+ */
+export declare abstract class BasePadronClient extends SoapServiceClient {
+    protected readonly soapOptions?: PadronSoapOptions;
+    protected readonly onEvent?: (event: ArcaEvent) => void;
+    constructor(config: PadronClientConfig);
+    /** Llama a un método del servicio y traduce los Faults de negocio. */
+    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(opts?: CallOptions): Promise<ServerStatus>;
+}
+//# sourceMappingURL=base-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../src/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAmC,MAAM,sBAAsB,CAAC;AAC1F,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAElG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC,CAAC;AAEtH,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,gBAAiB,SAAQ,iBAAiB;IAC9D,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;gBAE5C,MAAM,EAAE,kBAAkB;IAUtC,sEAAsE;cACtD,IAAI,CAClB,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;CAGvD"}

package/dist/base-client.js

@@ -0,0 +1,54 @@
+import { SoapServiceClient, parseServerStatus, validateCuit } from '@ramiidv/arca-common';
+import { toPadronError } from './errors.js';
+/**
+ * Base de los clientes de Padrón.
+ *
+ * Los WS de Padrón declaran los parámetros sin namespace
+ * (`elementFormDefault="unqualified"`) y `soapAction=""`: `afipSoapCall` de
+ * arca-common prefija el método y deja los parámetros sin namespace. Todas las
+ * operaciones son consultas: se reintentan ante errores transitorios (nunca
+ * ante un SOAP Fault). Los Faults de negocio conocidos (CUIT inexistente,
+ * clave inactiva, token no autorizado...) se lanzan como `ArcaPadronServiceError`.
+ *
+ * Las respuestas se parsean con `parseNumbers: false`: todos los valores llegan
+ * como string tal cual los envía ARCA, y los schemas de cada servicio (DSL de
+ * `@ramiidv/arca-common/schema`, ver `mapping.ts`) convierten los campos
+ * numéricos del WSDL. Así los `xs:string`
+ * con contenido numérico (`datoAdicional`, `codPostal`, `piso`, los campos del
+ * A100...) no pierden ceros ni decimales (`"10.50"`, `"1E3"`).
+ */
+export class BasePadronClient extends SoapServiceClient {
+    soapOptions;
+    onEvent;
+    constructor(config) {
+        super({
+            endpoint: config.endpoint,
+            namespace: config.namespace,
+            transport: { ...config.soapOptions, onEvent: config.onEvent },
+        });
+        this.soapOptions = config.soapOptions;
+        this.onEvent = config.onEvent;
+    }
+    /** Llama a un método del servicio y traduce los Faults de negocio. */
+    async call(method, params, opts) {
+        try {
+            return await this.soapCall(method, params, { parseNumbers: false, signal: opts?.signal });
+        }
+        catch (err) {
+            throw toPadronError(err, method);
+        }
+    }
+    /** Parámetros de autenticación en el orden del WSDL: token, sign, cuitRepresentada. */
+    authParams(auth) {
+        return {
+            token: auth.Token,
+            sign: auth.Sign,
+            cuitRepresentada: validateCuit(auth.CuitRepresentada),
+        };
+    }
+    /** Health check for this service. */
+    async dummy(opts) {
+        return parseServerStatus(await this.call('dummy', {}, opts));
+    }
+}
+//# sourceMappingURL=base-client.js.map

package/dist/base-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.js","sourceRoot":"","sources":["../src/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkB5C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,iBAAiB;IAC3C,WAAW,CAAqB;IAChC,OAAO,CAA8B;IAExD,YAAY,MAA0B;QACpC,KAAK,CAAC;YACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;SAC9D,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,sEAAsE;IAC5D,KAAK,CAAC,IAAI,CAClB,MAAc,EACd,MAA+B,EAC/B,IAAkB;QAElB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,uFAAuF;IAC7E,UAAU,CAAC,IAAY;QAC/B,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,gBAAgB,EAAE,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC;SACtD,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,KAAK,CAAC,IAAkB;QAC5B,OAAO,iBAAiB,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/{esm/condicion-iva.d.ts → condicion-iva.d.ts}

@@ -4,13 +4,17 @@ import type { CondicionIvaPadron, PersonaA4, PersonaA5 } from './types.js';
  * (constancia de inscripción / A5, o A4), para usarla como `condicionIva` al
  * facturarle.
  *
- * - Monotributo activo (impuesto 20 o categoría de monotributo) → MONOTRIBUTISTA,
- *   o MONOTRIBUTO_SOCIAL / MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO según la categoría.
- * - IVA activo (impuesto 30) → RESPONSABLE_INSCRIPTO.
- * - IVA exento (32) → EXENTO. IVA no alcanzado (34) → IVA_NO_ALCANZADO.
+ * - Monotributo activo (impuesto 20 activo; o, si el impuesto 20 no figura, la
+ *   categoría de monotributo) → MONOTRIBUTISTA, o MONOTRIBUTO_SOCIAL /
+ *   MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO según la categoría. Un impuesto 20 en
+ *   baja no cuenta aunque haya categoría.
+ * - IVA activo (impuesto 30, ACTIVO o ACTIVO EN TRAMITE) → RESPONSABLE_INSCRIPTO.
+ * - IVA (30) en estado EXENTO / EXENTO EN TRAMITE, o impuesto 32 → EXENTO.
+ * - Impuesto 34 → IVA_NO_ALCANZADO.
  * - Si no figura ninguno, devuelve `condicionIva: null`: el padrón no alcanza
  *   para decidir (puede ser consumidor final o sujeto no categorizado según la
- *   operación). No adivina.
+ *   operación). Si ARCA informó errores de la constancia (`errorConstancia`,
+ *   `errorRegimenGeneral`, `errorMonotributo`), el motivo los incluye. No adivina.
  *
  * Es una función pura: no consulta ARCA.
  *

package/dist/condicion-iva.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condicion-iva.d.ts","sourceRoot":"","sources":["../src/condicion-iva.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAuG3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,CAgF1F"}

package/dist/condicion-iva.js

@@ -0,0 +1,170 @@
+import { CondicionIva } from '@ramiidv/arca-common';
+import { ImpuestoId } from './constants.js';
+/*
+ * Fuentes:
+ * - Manual ws_sr_constancia_inscripcion v4.1: impuesto 20 = MONOTRIBUTO
+ *   (datosMonotributo), impuesto 30 = IVA (datosRegimenGeneral), estadoImpuesto
+ *   "AC" = activo. Categorías de monotributo (anexo 5.3): 61, 99, 100
+ *   "B MONOTRIBUTO SOCIAL ..."; 101 a 104 "D/E 2/3 SOCIOS PROY. SERVICIOS /
+ *   PRODUCTIVO" (proyectos productivos de efectores sociales, Ley 25.865: también
+ *   monotributo social); 98 "B ASOCIADO COOPERATIVA" (monotributo común: no
+ *   es necesariamente efector social).
+ * - Manual ws_sr_padron_a4 v1.3 §5.3 (TipoEstado): ACTIVO, ACTIVO EN TRAMITE,
+ *   BAJA PROVISORIA, BAJA DEFINITIVA, EXENTO, EXENTO EN TRAMITE, NO APORTANTE.
+ *   La constancia informa el id del estado (`estadoImpuesto`, ej: "AC"); solo
+ *   "AC" figura en los manuales. Las demás abreviaturas que se reconocen son
+ *   las iniciales de TipoEstado (EX, BP, BD, NA = NO APORTANTE). "NO APORTANTE"
+ *   no es "IVA no alcanzado": no se mapea a ninguna condición.
+ * - IVA exento (32) e IVA no alcanzado (34) no figuran en los manuales: se
+ *   reconocen por id o por la descripción del impuesto.
+ * - Valores de CondicionIva: FEParamGetCondicionIvaReceptor (WSFEv1, RG 5616).
+ */
+const CATEGORIAS_MONOTRIBUTO_SOCIAL = new Set([61, 99, 100, 101, 102, 103, 104]);
+const ABREVIATURAS = {
+    AC: 'ACTIVO',
+    EX: 'EXENTO',
+    BP: 'BAJA PROVISORIA',
+    BD: 'BAJA DEFINITIVA',
+    NA: 'NO APORTANTE',
+};
+/** Normaliza el estado de un impuesto (palabras de TipoEstado o abreviatura SUPA). `''` si no vino. */
+function normalizarEstado(estado) {
+    const e = (estado ?? '').trim().toUpperCase().normalize('NFD').replace(/[̀-ͯ]/g, '').replace(/\s+/g, ' ');
+    return ABREVIATURAS[e] ?? e;
+}
+/** Activo: ACTIVO o ACTIVO EN TRAMITE. Sin estado (respuestas anteriores a la v3.6 de la constancia) cuenta como activo. */
+function esActivo(estado) {
+    return estado === '' || estado === 'ACTIVO' || estado === 'ACTIVO EN TRAMITE';
+}
+function esExento(estado) {
+    return estado === 'EXENTO' || estado === 'EXENTO EN TRAMITE';
+}
+function esA5(persona) {
+    return Array.isArray(persona.impuestos);
+}
+function impuesto(id, descripcion, estadoRaw) {
+    const estado = normalizarEstado(estadoRaw);
+    return { id, descripcion: descripcion ?? '', estado, activo: esActivo(estado) };
+}
+function impuestosDe(persona) {
+    if (esA5(persona))
+        return persona.impuestos.map((i) => impuesto(i.idImpuesto, i.descripcionImpuesto, i.estadoImpuesto));
+    return (persona.impuesto ?? []).map((i) => impuesto(i.idImpuesto, i.descripcionImpuesto, i.estado));
+}
+function categoriaMonotributo(persona) {
+    if (esA5(persona)) {
+        const c = persona.monotributo?.categoria;
+        return c ? { id: c.idCategoria, descripcion: c.descripcionCategoria ?? '' } : undefined;
+    }
+    const c = (persona.categoria ?? []).find((x) => x.idImpuesto === ImpuestoId.MONOTRIBUTO && esActivo(normalizarEstado(x.estado)));
+    return c ? { id: c.idCategoria, descripcion: c.descripcionCategoria ?? '' } : undefined;
+}
+/** Errores que informó la constancia (régimen general / monotributo), para el motivo. */
+function erroresConstancia(persona) {
+    if (!esA5(persona))
+        return [];
+    const out = [];
+    const add = (nombre, e) => {
+        if (!e)
+            return;
+        const detalle = e.error.length > 0 ? e.error.join('; ') : (e.mensaje ?? 'sin detalle');
+        out.push(`${nombre}: ${detalle}`);
+    };
+    add('régimen general', persona.errorRegimenGeneral);
+    add('monotributo', persona.errorMonotributo);
+    return out;
+}
+/**
+ * Determina la condición frente al IVA de un contribuyente a partir del padrón
+ * (constancia de inscripción / A5, o A4), para usarla como `condicionIva` al
+ * facturarle.
+ *
+ * - Monotributo activo (impuesto 20 activo; o, si el impuesto 20 no figura, la
+ *   categoría de monotributo) → MONOTRIBUTISTA, o MONOTRIBUTO_SOCIAL /
+ *   MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO según la categoría. Un impuesto 20 en
+ *   baja no cuenta aunque haya categoría.
+ * - IVA activo (impuesto 30, ACTIVO o ACTIVO EN TRAMITE) → RESPONSABLE_INSCRIPTO.
+ * - IVA (30) en estado EXENTO / EXENTO EN TRAMITE, o impuesto 32 → EXENTO.
+ * - Impuesto 34 → IVA_NO_ALCANZADO.
+ * - Si no figura ninguno, devuelve `condicionIva: null`: el padrón no alcanza
+ *   para decidir (puede ser consumidor final o sujeto no categorizado según la
+ *   operación). Si ARCA informó errores de la constancia (`errorConstancia`,
+ *   `errorRegimenGeneral`, `errorMonotributo`), el motivo los incluye. No adivina.
+ *
+ * Es una función pura: no consulta ARCA.
+ *
+ * @example
+ * ```ts
+ * const persona = await padron.getConstanciaInscripcion('30712345674');
+ * const { condicionIva, motivo } = condicionIvaDesdePadron(persona);
+ * ```
+ */
+export function condicionIvaDesdePadron(persona) {
+    const impuestos = impuestosDe(persona);
+    const tiene = (pred) => impuestos.find((i) => i.activo && pred(i));
+    const errores = erroresConstancia(persona);
+    const notaErrores = errores.length > 0 ? ` ARCA informó errores en la constancia (${errores.join(' | ')}).` : '';
+    const avisoClave = persona.estadoClave && persona.estadoClave.toUpperCase() !== 'ACTIVO'
+        ? ` Atención: la CUIT tiene estado ${persona.estadoClave}.`
+        : '';
+    const advertencia = avisoClave + notaErrores;
+    const categoria = categoriaMonotributo(persona);
+    const impuesto20 = impuestos.find((i) => i.id === ImpuestoId.MONOTRIBUTO);
+    const monotributo = impuesto20 ? impuesto20.activo : categoria !== undefined;
+    if (monotributo) {
+        const desc = categoria ? ` (categoría ${categoria.id} - ${categoria.descripcion.trim()})` : '';
+        if (categoria &&
+            (CATEGORIAS_MONOTRIBUTO_SOCIAL.has(categoria.id) || /MONOTRIBUTO SOCIAL/i.test(categoria.descripcion))) {
+            return { condicionIva: CondicionIva.MONOTRIBUTO_SOCIAL, motivo: `Monotributo social${desc}.${advertencia}` };
+        }
+        if (categoria && /PROMOVID/i.test(categoria.descripcion)) {
+            return {
+                condicionIva: CondicionIva.MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO,
+                motivo: `Monotributo trabajador independiente promovido${desc}.${advertencia}`,
+            };
+        }
+        return {
+            condicionIva: CondicionIva.MONOTRIBUTISTA,
+            motivo: `Inscripto en monotributo (impuesto 20)${desc}.${advertencia}`,
+        };
+    }
+    if (tiene((i) => i.id === ImpuestoId.IVA_RESPONSABLE_INSCRIPTO)) {
+        return {
+            condicionIva: CondicionIva.RESPONSABLE_INSCRIPTO,
+            motivo: `Inscripto en IVA (impuesto 30).${advertencia}`,
+        };
+    }
+    const ivaExento = impuestos.find((i) => i.id === ImpuestoId.IVA_RESPONSABLE_INSCRIPTO && esExento(i.estado));
+    if (ivaExento) {
+        return {
+            condicionIva: CondicionIva.EXENTO,
+            motivo: `IVA (impuesto 30) en estado ${ivaExento.estado}.${advertencia}`,
+        };
+    }
+    if (tiene((i) => i.id === ImpuestoId.IVA_EXENTO || /IVA\s+EXENTO/i.test(i.descripcion))) {
+        return { condicionIva: CondicionIva.EXENTO, motivo: `IVA exento (impuesto 32).${advertencia}` };
+    }
+    if (tiene((i) => i.id === ImpuestoId.IVA_NO_ALCANZADO || /IVA.*NO\s+ALCANZADO/i.test(i.descripcion))) {
+        return { condicionIva: CondicionIva.IVA_NO_ALCANZADO, motivo: `IVA no alcanzado (impuesto 34).${advertencia}` };
+    }
+    if (esA5(persona) && persona.errorConstancia && impuestos.length === 0) {
+        return {
+            condicionIva: null,
+            motivo: `ARCA no emitió la constancia: ${persona.errorConstancia.error.join('; ')}.${advertencia}`,
+        };
+    }
+    if (errores.length > 0) {
+        return {
+            condicionIva: null,
+            motivo: `No se puede determinar: ARCA no informó datos de ${errores.map((e) => e.split(':')[0]).join(' ni de ')} ` +
+                `(${errores.join(' | ')}).${avisoClave}`,
+        };
+    }
+    return {
+        condicionIva: null,
+        motivo: 'No figura inscripto en IVA ni en monotributo: el padrón no alcanza para determinar la condición ' +
+            '(puede ser consumidor final o sujeto no categorizado según la operación).' +
+            advertencia,
+    };
+}
+//# sourceMappingURL=condicion-iva.js.map

package/dist/condicion-iva.js.map

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

package/dist/{esm/constants.d.ts → constants.d.ts}

@@ -1,4 +1,14 @@
-export { Provincia, DocTipo as TipoDocumento, CondicionIva } from '@ramiidv/arca-common';
+import { DocTipo } from '@ramiidv/arca-common';
+export { Provincia, DocTipo, CondicionIva } from '@ramiidv/arca-common';
+/**
+ * @deprecated Es `DocTipo` de arca-common: los códigos numéricos de tipo de
+ * documento de WSFEv1 (80 = CUIT, 96 = DNI...). No sirve para interpretar el
+ * campo `tipoDocumento` del padrón, que es un string ("DNI", "LC", "LE"...;
+ * ver la colección A100 `SUPA.TIPO_DOCUMENTO`). Usá `DocTipo`.
+ */
+export declare const TipoDocumento: typeof DocTipo;
+/** @deprecated Usá `DocTipo` (ver la constante `TipoDocumento`). */
+export type TipoDocumento = DocTipo;
 export declare const ENDPOINTS: {
     readonly wsaa: {
         readonly testing: "https://wsaahomo.afip.gov.ar/ws/services/LoginCms";
@@ -47,23 +57,36 @@ export declare enum TipoPersona {
     FISICA = "FISICA",
     JURIDICA = "JURIDICA"
 }
-/** IDs de impuestos comunes (SUPA) */
+/**
+ * IDs de impuestos de SUPA.
+ *
+ * Respaldados por los manuales de ARCA: 11, 20, 21, 30, 180, 301, 308
+ * (ejemplos y validaciones de los manuales de constancia de inscripción v4.1 y
+ * A4 v1.3). Los marcados "sin respaldo" no figuran en esos manuales.
+ */
 export declare enum ImpuestoId {
+    /** Ganancias sociedades. Sin respaldo en los manuales del padrón. */
     GANANCIAS_PJ = 10,
+    /** Ganancias personas físicas. */
     GANANCIAS_PH = 11,
-    /** Monotributo (manual ws_sr_constancia_inscripcion v4.1). */
+    /** Monotributo. */
     MONOTRIBUTO = 20,
-    /**
-     * @deprecated El impuesto 20 es Monotributo (antes estaba mal rotulado). El
-     * monotributo social se identifica por la categoría (61, 99, 100), no por el impuesto.
-     */
-    MONOTRIBUTO_SOCIAL = 20,
+    /** Monotributo autónomo (manual A4 v1.3). */
+    MONOTRIBUTO_AUTONOMO = 21,
+    /** IVA. */
     IVA_RESPONSABLE_INSCRIPTO = 30,
-    BIENES_PERSONALES = 31,
+    /** IVA exento. Sin respaldo en los manuales del padrón: el A4 informa la exención como impuesto 30 con estado EXENTO. */
     IVA_EXENTO = 32,
+    /** @deprecated Sin respaldo en los manuales del padrón y sin uso en el SDK. */
     IVA_NO_INSCRIPTO = 33,
+    /** IVA no alcanzado. Sin respaldo en los manuales del padrón. */
     IVA_NO_ALCANZADO = 34,
-    EMPLEADOR = 301
+    /** Bienes personales (manual de constancia v4.1: "180 – Bs Ps"). Antes figuraba, mal, como 31. */
+    BIENES_PERSONALES = 180,
+    /** Empleador - aportes de la seguridad social. */
+    EMPLEADOR = 301,
+    /** Aportes de la seguridad social - autónomos. */
+    AUTONOMOS = 308
 }
 /** Estado de la clave fiscal del contribuyente */
 export declare enum EstadoClave {
@@ -71,7 +94,13 @@ export declare enum EstadoClave {
     INACTIVO = "INACTIVO",
     LIMITADO = "LIMITADO"
 }
-/** Nombres de colecciones disponibles en ws_sr_padron_a100 */
+/**
+ * Nombres de colecciones de ws_sr_padron_a100 (manual v2.1, anexo 5.1).
+ *
+ * La fila de "Categorías de Monotributo según F.184" está cortada en el manual
+ * (solo se lee el atributo `COD_CATEGORIA_MONOTRIBUTO`), así que no se incluye:
+ * pasá el nombre como string si lo conocés.
+ */
 export declare enum CollectionName {
     PROVINCIA = "SUPA.E_PROVINCIA",
     TIPO_DOCUMENTO = "SUPA.TIPO_DOCUMENTO",
@@ -92,6 +121,22 @@ export declare enum CollectionName {
     PROVINCIA_SOCIEDAD_ORG = "SUPA.A_PROVINCIA_SOCIEDAD_ORG",
     SEXO = "E_SEXO",
     CALLE = "PUC_PARAM.T_CALLE",
-    LOCALIDAD = "PUC_PARAM.T_LOCALIDAD"
+    LOCALIDAD = "PUC_PARAM.T_LOCALIDAD",
+    /** Tipología de autónomos de monotributo según F.184. */
+    AUTONOMO_MONOTRIBUTO = "SUPA.E_AUTONOMO_MONOTRIBUTO",
+    /** Nómina de regímenes vigentes y no vigentes. */
+    REGIMEN = "SUPA.E_REGIMEN",
+    /** Clasificaciones de regímenes. */
+    TIPO_REGIMEN = "SUPA.TIPO_REGIMEN",
+    /** Atributos y características de los contribuyentes. */
+    CARACTERIZACION = "SUPA.E_CARACTERIZACION",
+    /** Tipos de documento válidos para el sistema. */
+    TIPO_ARCHIVO = "SUPA.TIPO_ARCHIVO",
+    /** Relaciones entre actividades y rubros de todos los nomencladores. */
+    ACTIVIDAD_RUBRO = "SUPA.A_ACTIVIDAD_RUBRO",
+    /** Rubros de los nomencladores de actividades económicas. */
+    RUBRO_ACTIVIDAD = "SUPA.E_RUBRO_ACTIVIDAD",
+    /** Actividades ocupacionales no incluidas en el nomenclador F.150. */
+    ACTIVIDAD_OCUPACIONAL = "SUPA.E_ACTIVIDAD_OCUPACIONAL"
 }
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,gBAAU,CAAC;AACrC,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAMpC,eAAO,MAAM,SAAS;;;;;IAEpB,yFAAyF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjF,CAAC;AAMX,yBAAyB;AACzB,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED,uBAAuB;AACvB,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED;;;;;;GAMG;AACH,oBAAY,UAAU;IACpB,qEAAqE;IACrE,YAAY,KAAK;IACjB,kCAAkC;IAClC,YAAY,KAAK;IACjB,mBAAmB;IACnB,WAAW,KAAK;IAChB,6CAA6C;IAC7C,oBAAoB,KAAK;IACzB,WAAW;IACX,yBAAyB,KAAK;IAC9B,yHAAyH;IACzH,UAAU,KAAK;IACf,+EAA+E;IAC/E,gBAAgB,KAAK;IACrB,iEAAiE;IACjE,gBAAgB,KAAK;IACrB,kGAAkG;IAClG,iBAAiB,MAAM;IACvB,kDAAkD;IAClD,SAAS,MAAM;IACf,kDAAkD;IAClD,SAAS,MAAM;CAChB;AAED,kDAAkD;AAClD,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAED;;;;;;GAMG;AACH,oBAAY,cAAc;IACxB,SAAS,qBAAqB;IAC9B,cAAc,wBAAwB;IACtC,cAAc,wBAAwB;IACtC,UAAU,mCAAmC;IAC7C,qBAAqB,+BAA+B;IACpD,8BAA8B,oCAAoC;IAClE,aAAa,uBAAuB;IACpC,qBAAqB,+BAA+B;IACpD,wBAAwB,kCAAkC;IAC1D,4BAA4B,sCAAsC;IAClE,UAAU,oBAAoB;IAC9B,aAAa,uBAAuB;IACpC,eAAe,yBAAyB;IACxC,6BAA6B,uCAAuC;IACpE,oBAAoB,gCAAgC;IACpD,iBAAiB,6BAA6B;IAC9C,sBAAsB,kCAAkC;IACxD,IAAI,WAAW;IACf,KAAK,sBAAsB;IAC3B,SAAS,0BAA0B;IACnC,yDAAyD;IACzD,oBAAoB,gCAAgC;IACpD,kDAAkD;IAClD,OAAO,mBAAmB;IAC1B,oCAAoC;IACpC,YAAY,sBAAsB;IAClC,yDAAyD;IACzD,eAAe,2BAA2B;IAC1C,kDAAkD;IAClD,YAAY,sBAAsB;IAClC,wEAAwE;IACxE,eAAe,2BAA2B;IAC1C,6DAA6D;IAC7D,eAAe,2BAA2B;IAC1C,sEAAsE;IACtE,qBAAqB,iCAAiC;CACvD"}