@ramiidv/arca-padron 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/CHANGELOG.md +116 -0
  2. package/README.md +205 -65
  3. package/dist/cjs/arca-padron.d.ts +111 -0
  4. package/dist/cjs/arca-padron.d.ts.map +1 -0
  5. package/dist/cjs/arca-padron.js +211 -0
  6. package/dist/cjs/arca-padron.js.map +1 -0
  7. package/dist/cjs/base-client.d.ts +45 -0
  8. package/dist/cjs/base-client.d.ts.map +1 -0
  9. package/dist/cjs/base-client.js +68 -0
  10. package/dist/cjs/base-client.js.map +1 -0
  11. package/dist/cjs/condicion-iva.d.ts +28 -0
  12. package/dist/cjs/condicion-iva.d.ts.map +1 -0
  13. package/dist/cjs/condicion-iva.js +166 -0
  14. package/dist/cjs/condicion-iva.js.map +1 -0
  15. package/dist/cjs/constants.d.ts +142 -0
  16. package/dist/cjs/constants.d.ts.map +1 -0
  17. package/dist/cjs/constants.js +155 -0
  18. package/dist/cjs/constants.js.map +1 -0
  19. package/dist/cjs/errors.d.ts +50 -0
  20. package/dist/cjs/errors.d.ts.map +1 -0
  21. package/dist/cjs/errors.js +62 -0
  22. package/dist/cjs/errors.js.map +1 -0
  23. package/dist/cjs/index.d.ts +24 -0
  24. package/dist/cjs/index.d.ts.map +1 -0
  25. package/dist/cjs/index.js +66 -0
  26. package/dist/cjs/index.js.map +1 -0
  27. package/dist/cjs/mapping.d.ts +52 -0
  28. package/dist/cjs/mapping.d.ts.map +1 -0
  29. package/dist/cjs/mapping.js +135 -0
  30. package/dist/cjs/mapping.js.map +1 -0
  31. package/dist/cjs/package.json +1 -0
  32. package/dist/cjs/padron-a10.d.ts +21 -0
  33. package/dist/cjs/padron-a10.d.ts.map +1 -0
  34. package/dist/cjs/padron-a10.js +38 -0
  35. package/dist/cjs/padron-a10.js.map +1 -0
  36. package/dist/cjs/padron-a100.d.ts +20 -0
  37. package/dist/cjs/padron-a100.d.ts.map +1 -0
  38. package/dist/cjs/padron-a100.js +48 -0
  39. package/dist/cjs/padron-a100.js.map +1 -0
  40. package/dist/cjs/padron-a13.d.ts +34 -0
  41. package/dist/cjs/padron-a13.d.ts.map +1 -0
  42. package/dist/cjs/padron-a13.js +100 -0
  43. package/dist/cjs/padron-a13.js.map +1 -0
  44. package/dist/cjs/padron-a4.d.ts +21 -0
  45. package/dist/cjs/padron-a4.d.ts.map +1 -0
  46. package/dist/cjs/padron-a4.js +119 -0
  47. package/dist/cjs/padron-a4.js.map +1 -0
  48. package/dist/cjs/padron-a5.d.ts +37 -0
  49. package/dist/cjs/padron-a5.d.ts.map +1 -0
  50. package/dist/cjs/padron-a5.js +181 -0
  51. package/dist/cjs/padron-a5.js.map +1 -0
  52. package/dist/cjs/types.d.ts +337 -0
  53. package/dist/cjs/types.d.ts.map +1 -0
  54. package/dist/cjs/types.js +3 -0
  55. package/dist/cjs/types.js.map +1 -0
  56. package/dist/esm/arca-padron.d.ts +111 -0
  57. package/dist/esm/arca-padron.d.ts.map +1 -0
  58. package/dist/esm/arca-padron.js +207 -0
  59. package/dist/esm/arca-padron.js.map +1 -0
  60. package/dist/esm/base-client.d.ts +45 -0
  61. package/dist/esm/base-client.d.ts.map +1 -0
  62. package/dist/esm/base-client.js +64 -0
  63. package/dist/esm/base-client.js.map +1 -0
  64. package/dist/esm/condicion-iva.d.ts +28 -0
  65. package/dist/esm/condicion-iva.d.ts.map +1 -0
  66. package/dist/esm/condicion-iva.js +163 -0
  67. package/dist/esm/condicion-iva.js.map +1 -0
  68. package/dist/esm/constants.d.ts +142 -0
  69. package/dist/esm/constants.d.ts.map +1 -0
  70. package/dist/{constants.js → esm/constants.js} +67 -7
  71. package/dist/esm/constants.js.map +1 -0
  72. package/dist/esm/errors.d.ts +50 -0
  73. package/dist/esm/errors.d.ts.map +1 -0
  74. package/dist/esm/errors.js +55 -0
  75. package/dist/esm/errors.js.map +1 -0
  76. package/dist/esm/index.d.ts +24 -0
  77. package/dist/esm/index.d.ts.map +1 -0
  78. package/dist/esm/index.js +30 -0
  79. package/dist/esm/index.js.map +1 -0
  80. package/dist/esm/mapping.d.ts +52 -0
  81. package/dist/esm/mapping.d.ts.map +1 -0
  82. package/dist/esm/mapping.js +118 -0
  83. package/dist/esm/mapping.js.map +1 -0
  84. package/dist/esm/padron-a10.d.ts +21 -0
  85. package/dist/esm/padron-a10.d.ts.map +1 -0
  86. package/dist/esm/padron-a10.js +33 -0
  87. package/dist/esm/padron-a10.js.map +1 -0
  88. package/dist/esm/padron-a100.d.ts +20 -0
  89. package/dist/esm/padron-a100.d.ts.map +1 -0
  90. package/dist/esm/padron-a100.js +44 -0
  91. package/dist/esm/padron-a100.js.map +1 -0
  92. package/dist/esm/padron-a13.d.ts +34 -0
  93. package/dist/esm/padron-a13.d.ts.map +1 -0
  94. package/dist/esm/padron-a13.js +94 -0
  95. package/dist/esm/padron-a13.js.map +1 -0
  96. package/dist/esm/padron-a4.d.ts +21 -0
  97. package/dist/esm/padron-a4.d.ts.map +1 -0
  98. package/dist/esm/padron-a4.js +114 -0
  99. package/dist/esm/padron-a4.js.map +1 -0
  100. package/dist/esm/padron-a5.d.ts +37 -0
  101. package/dist/esm/padron-a5.d.ts.map +1 -0
  102. package/dist/esm/padron-a5.js +176 -0
  103. package/dist/esm/padron-a5.js.map +1 -0
  104. package/dist/esm/types.d.ts +337 -0
  105. package/dist/esm/types.d.ts.map +1 -0
  106. package/dist/esm/types.js.map +1 -0
  107. package/llms.txt +69 -28
  108. package/package.json +25 -17
  109. package/dist/arca-padron.d.ts +0 -70
  110. package/dist/arca-padron.d.ts.map +0 -1
  111. package/dist/arca-padron.js +0 -129
  112. package/dist/arca-padron.js.map +0 -1
  113. package/dist/base-client.d.ts +0 -26
  114. package/dist/base-client.d.ts.map +0 -1
  115. package/dist/base-client.js +0 -27
  116. package/dist/base-client.js.map +0 -1
  117. package/dist/constants.d.ts +0 -79
  118. package/dist/constants.d.ts.map +0 -1
  119. package/dist/constants.js.map +0 -1
  120. package/dist/errors.d.ts +0 -20
  121. package/dist/errors.d.ts.map +0 -1
  122. package/dist/errors.js +0 -24
  123. package/dist/errors.js.map +0 -1
  124. package/dist/index.d.ts +0 -12
  125. package/dist/index.d.ts.map +0 -1
  126. package/dist/index.js +0 -16
  127. package/dist/index.js.map +0 -1
  128. package/dist/padron-a10.d.ts +0 -16
  129. package/dist/padron-a10.d.ts.map +0 -1
  130. package/dist/padron-a10.js +0 -74
  131. package/dist/padron-a10.js.map +0 -1
  132. package/dist/padron-a100.d.ts +0 -15
  133. package/dist/padron-a100.d.ts.map +0 -1
  134. package/dist/padron-a100.js +0 -40
  135. package/dist/padron-a100.js.map +0 -1
  136. package/dist/padron-a4.d.ts +0 -16
  137. package/dist/padron-a4.d.ts.map +0 -1
  138. package/dist/padron-a4.js +0 -174
  139. package/dist/padron-a4.js.map +0 -1
  140. package/dist/soap-client.d.ts +0 -2
  141. package/dist/soap-client.d.ts.map +0 -1
  142. package/dist/soap-client.js +0 -3
  143. package/dist/soap-client.js.map +0 -1
  144. package/dist/types.d.ts +0 -172
  145. package/dist/types.d.ts.map +0 -1
  146. package/dist/types.js.map +0 -1
  147. package/dist/wsaa.d.ts +0 -3
  148. package/dist/wsaa.d.ts.map +0 -1
  149. package/dist/wsaa.js +0 -2
  150. package/dist/wsaa.js.map +0 -1
  151. /package/dist/{types.js → esm/types.js} +0 -0
@@ -0,0 +1,111 @@
1
+ import { WsaaClient } from '@ramiidv/arca-common';
2
+ import type { CallOptions } from '@ramiidv/arca-common';
3
+ import { PadronA4Client } from './padron-a4.js';
4
+ import { PadronA5Client } from './padron-a5.js';
5
+ import { PadronA10Client } from './padron-a10.js';
6
+ import { PadronA13Client } from './padron-a13.js';
7
+ import { PadronA100Client } from './padron-a100.js';
8
+ import type { ArcaPadronConfig, PadronStatus, ParameterRecord, PersonaA4, PersonaA5, PersonaA10, PersonaA13 } from './types.js';
9
+ /**
10
+ * Main orchestrator class for ARCA Padrón web services.
11
+ *
12
+ * Provides high-level methods that handle WSAA authentication automatically
13
+ * and expose results from the Constancia de Inscripción (ex A5), A4 (full),
14
+ * A10 (basic), A13 (basic) and A100 (parameters) web services.
15
+ *
16
+ * @example
17
+ * ```ts
18
+ * import { ArcaPadron, condicionIvaDesdePadron, FileTicketStorage } from '@ramiidv/arca-padron';
19
+ * import { readFileSync } from 'fs';
20
+ *
21
+ * const client = new ArcaPadron({
22
+ * cert: readFileSync('cert.pem', 'utf-8'),
23
+ * key: readFileSync('key.pem', 'utf-8'),
24
+ * cuit: '20123456789',
25
+ * production: false,
26
+ * ticketStorage: new FileTicketStorage('./.arca-tickets'),
27
+ * });
28
+ *
29
+ * const persona = await client.getConstanciaInscripcion('30712345674');
30
+ * const { condicionIva, motivo } = condicionIvaDesdePadron(persona);
31
+ * ```
32
+ */
33
+ export declare class ArcaPadron {
34
+ /** Low-level WSAA client for direct access (se puede compartir con arca-facturacion) */
35
+ readonly wsaa: WsaaClient;
36
+ /** Low-level Constancia de Inscripción (ex Padrón A5) client */
37
+ readonly a5: PadronA5Client;
38
+ /** Low-level Padrón A4 client for direct access */
39
+ readonly a4: PadronA4Client;
40
+ /** Low-level Padrón A10 client for direct access */
41
+ readonly a10: PadronA10Client;
42
+ /** Low-level Padrón A13 client for direct access */
43
+ readonly a13: PadronA13Client;
44
+ /** Low-level Padrón A100 client for direct access */
45
+ readonly a100: PadronA100Client;
46
+ private readonly cuit;
47
+ private readonly signal?;
48
+ constructor(config: ArcaPadronConfig);
49
+ /**
50
+ * Constancia de inscripción (ws_sr_constancia_inscripcion, ex Padrón A5,
51
+ * `getPersona_v2`): datos generales, domicilio fiscal, impuestos del régimen
52
+ * general y monotributo. Combinar con `condicionIvaDesdePadron` para facturar.
53
+ * @param cuit - CUIT a consultar (con o sin guiones)
54
+ * @throws ArcaValidationError si la CUIT es inválida (dígito verificador)
55
+ * @throws ArcaPadronServiceError si ARCA informa la CUIT inexistente, inactiva, etc.
56
+ */
57
+ getConstanciaInscripcion(cuit: string | number, call?: CallOptions): Promise<PersonaA5>;
58
+ /**
59
+ * Constancias de inscripción de hasta 250 CUITs en una llamada
60
+ * (`getPersonaList_v2`). Las CUITs inexistentes vuelven con `errorConstancia`
61
+ * ("No existe persona con ese Id") en lugar de hacer fallar la consulta.
62
+ */
63
+ getConstanciasInscripcion(cuits: Array<string | number>, call?: CallOptions): Promise<PersonaA5[]>;
64
+ /**
65
+ * Datos completos de un contribuyente (Padrón A4).
66
+ * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
67
+ */
68
+ getPersona(cuit: string | number, call?: CallOptions): Promise<PersonaA4>;
69
+ /**
70
+ * Datos básicos de un contribuyente (Padrón A10).
71
+ * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
72
+ */
73
+ getPersonaBasic(cuit: string | number, call?: CallOptions): Promise<PersonaA10>;
74
+ /**
75
+ * Datos básicos de un contribuyente (Padrón A13, `getPersona`). Con la clave
76
+ * inactiva ARCA responde con error (`reason: 'inactiva'`): ver `getPersonaA13V2`.
77
+ * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
78
+ */
79
+ getPersonaA13(cuit: string | number, call?: CallOptions): Promise<PersonaA13>;
80
+ /**
81
+ * Datos básicos de un contribuyente (Padrón A13, `getPersonaV2`): responde
82
+ * también si la clave está INACTIVA (manual A13 v1.4).
83
+ */
84
+ getPersonaA13V2(cuit: string | number, call?: CallOptions): Promise<PersonaA13>;
85
+ /**
86
+ * CUITs/CUILs asociados a un número de documento (Padrón A13).
87
+ * @param documento - Número de documento (DNI); se aceptan puntos y espacios
88
+ */
89
+ getIdPersonaListByDocumento(documento: string | number, call?: CallOptions): Promise<string[]>;
90
+ /**
91
+ * Tabla de parámetros (Padrón A100) por nombre de colección.
92
+ * @param collection - Nombre de la colección (ej: CollectionName.PROVINCIA)
93
+ */
94
+ getParametros(collection: string, call?: CallOptions): Promise<ParameterRecord[]>;
95
+ /**
96
+ * Estado de los servicios de Padrón (`dummy`, sin autenticación). Consulta
97
+ * todos en paralelo y devuelve el resultado de cada uno por separado: un
98
+ * servicio caído no oculta el estado de los demás.
99
+ *
100
+ * @example
101
+ * ```ts
102
+ * const s = await padron.status();
103
+ * if (s.a4.status === 'fulfilled') console.log(s.a4.value.appserver);
104
+ * else console.error(s.a4.reason);
105
+ * ```
106
+ */
107
+ status(call?: CallOptions): Promise<PadronStatus>;
108
+ private opts;
109
+ private getAuth;
110
+ }
111
+ //# sourceMappingURL=arca-padron.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"arca-padron.d.ts","sourceRoot":"","sources":["../../src/arca-padron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnE,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,EAEhB,YAAY,EACZ,eAAe,EACf,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EAEX,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;IAiDpC;;;;;;;OAOG;IACG,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAM7F;;;;OAIG;IACG,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAMxG;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAM/E;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAMrF;;;;OAIG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAMnF;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAMrF;;;OAGG;IACG,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMpG;;;OAGG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAMvF;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBvD,OAAO,CAAC,IAAI;YAIE,OAAO;CAQtB"}
@@ -0,0 +1,207 @@
1
+ import { WsaaClient, anySignal, validateCuit } from '@ramiidv/arca-common';
2
+ import { ENDPOINTS } from './constants.js';
3
+ import { PadronA4Client } from './padron-a4.js';
4
+ import { PadronA5Client } from './padron-a5.js';
5
+ import { PadronA10Client } from './padron-a10.js';
6
+ import { PadronA13Client } from './padron-a13.js';
7
+ import { PadronA100Client } from './padron-a100.js';
8
+ /**
9
+ * Main orchestrator class for ARCA Padrón web services.
10
+ *
11
+ * Provides high-level methods that handle WSAA authentication automatically
12
+ * and expose results from the Constancia de Inscripción (ex A5), A4 (full),
13
+ * A10 (basic), A13 (basic) and A100 (parameters) web services.
14
+ *
15
+ * @example
16
+ * ```ts
17
+ * import { ArcaPadron, condicionIvaDesdePadron, FileTicketStorage } from '@ramiidv/arca-padron';
18
+ * import { readFileSync } from 'fs';
19
+ *
20
+ * const client = new ArcaPadron({
21
+ * cert: readFileSync('cert.pem', 'utf-8'),
22
+ * key: readFileSync('key.pem', 'utf-8'),
23
+ * cuit: '20123456789',
24
+ * production: false,
25
+ * ticketStorage: new FileTicketStorage('./.arca-tickets'),
26
+ * });
27
+ *
28
+ * const persona = await client.getConstanciaInscripcion('30712345674');
29
+ * const { condicionIva, motivo } = condicionIvaDesdePadron(persona);
30
+ * ```
31
+ */
32
+ export class ArcaPadron {
33
+ /** Low-level WSAA client for direct access (se puede compartir con arca-facturacion) */
34
+ wsaa;
35
+ /** Low-level Constancia de Inscripción (ex Padrón A5) client */
36
+ a5;
37
+ /** Low-level Padrón A4 client for direct access */
38
+ a4;
39
+ /** Low-level Padrón A10 client for direct access */
40
+ a10;
41
+ /** Low-level Padrón A13 client for direct access */
42
+ a13;
43
+ /** Low-level Padrón A100 client for direct access */
44
+ a100;
45
+ cuit;
46
+ signal;
47
+ constructor(config) {
48
+ const isProduction = config.production ?? false;
49
+ const env = isProduction ? 'production' : 'testing';
50
+ this.cuit = validateCuit(config.cuit);
51
+ this.signal = config.signal;
52
+ const onEvent = config.onEvent;
53
+ const soapOptions = {
54
+ timeout: config.timeout,
55
+ retries: config.retries,
56
+ retryDelayMs: config.retryDelayMs,
57
+ fetch: config.fetch,
58
+ legacyTls: config.legacyTls,
59
+ };
60
+ this.wsaa =
61
+ config.wsaa ??
62
+ new WsaaClient({
63
+ cert: config.cert,
64
+ key: config.key,
65
+ production: isProduction,
66
+ endpoint: config.endpoints?.wsaa,
67
+ tokenTTLMinutes: config.tokenTTLMinutes,
68
+ timeout: config.timeout,
69
+ retries: config.retries,
70
+ retryDelayMs: config.retryDelayMs,
71
+ onEvent,
72
+ ticketStorage: config.ticketStorage,
73
+ clockOffsetMs: config.clockOffsetMs,
74
+ autoClockSkew: config.autoClockSkew,
75
+ loginErrorCooldownMs: config.loginErrorCooldownMs,
76
+ fetch: config.fetch,
77
+ legacyTls: config.legacyTls,
78
+ });
79
+ const clientConfig = (svc) => ({
80
+ endpoint: config.endpoints?.[svc] ?? ENDPOINTS[svc][env],
81
+ namespace: ENDPOINTS[svc].namespace,
82
+ soapOptions,
83
+ onEvent,
84
+ });
85
+ this.a5 = new PadronA5Client(clientConfig('a5'));
86
+ this.a4 = new PadronA4Client(clientConfig('a4'));
87
+ this.a10 = new PadronA10Client(clientConfig('a10'));
88
+ this.a13 = new PadronA13Client(clientConfig('a13'));
89
+ this.a100 = new PadronA100Client(clientConfig('a100'));
90
+ }
91
+ /**
92
+ * Constancia de inscripción (ws_sr_constancia_inscripcion, ex Padrón A5,
93
+ * `getPersona_v2`): datos generales, domicilio fiscal, impuestos del régimen
94
+ * general y monotributo. Combinar con `condicionIvaDesdePadron` para facturar.
95
+ * @param cuit - CUIT a consultar (con o sin guiones)
96
+ * @throws ArcaValidationError si la CUIT es inválida (dígito verificador)
97
+ * @throws ArcaPadronServiceError si ARCA informa la CUIT inexistente, inactiva, etc.
98
+ */
99
+ async getConstanciaInscripcion(cuit, call) {
100
+ const opts = this.opts(call);
101
+ const auth = await this.getAuth(ENDPOINTS.a5.serviceId, opts);
102
+ return this.a5.getPersona(auth, cuit, opts);
103
+ }
104
+ /**
105
+ * Constancias de inscripción de hasta 250 CUITs en una llamada
106
+ * (`getPersonaList_v2`). Las CUITs inexistentes vuelven con `errorConstancia`
107
+ * ("No existe persona con ese Id") en lugar de hacer fallar la consulta.
108
+ */
109
+ async getConstanciasInscripcion(cuits, call) {
110
+ const opts = this.opts(call);
111
+ const auth = await this.getAuth(ENDPOINTS.a5.serviceId, opts);
112
+ return this.a5.getPersonaList(auth, cuits, opts);
113
+ }
114
+ /**
115
+ * Datos completos de un contribuyente (Padrón A4).
116
+ * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
117
+ */
118
+ async getPersona(cuit, call) {
119
+ const opts = this.opts(call);
120
+ const auth = await this.getAuth(ENDPOINTS.a4.serviceId, opts);
121
+ return this.a4.getPersona(auth, cuit, opts);
122
+ }
123
+ /**
124
+ * Datos básicos de un contribuyente (Padrón A10).
125
+ * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
126
+ */
127
+ async getPersonaBasic(cuit, call) {
128
+ const opts = this.opts(call);
129
+ const auth = await this.getAuth(ENDPOINTS.a10.serviceId, opts);
130
+ return this.a10.getPersona(auth, cuit, opts);
131
+ }
132
+ /**
133
+ * Datos básicos de un contribuyente (Padrón A13, `getPersona`). Con la clave
134
+ * inactiva ARCA responde con error (`reason: 'inactiva'`): ver `getPersonaA13V2`.
135
+ * @param cuit - CUIT/CUIL a consultar (con o sin guiones)
136
+ */
137
+ async getPersonaA13(cuit, call) {
138
+ const opts = this.opts(call);
139
+ const auth = await this.getAuth(ENDPOINTS.a13.serviceId, opts);
140
+ return this.a13.getPersona(auth, cuit, opts);
141
+ }
142
+ /**
143
+ * Datos básicos de un contribuyente (Padrón A13, `getPersonaV2`): responde
144
+ * también si la clave está INACTIVA (manual A13 v1.4).
145
+ */
146
+ async getPersonaA13V2(cuit, call) {
147
+ const opts = this.opts(call);
148
+ const auth = await this.getAuth(ENDPOINTS.a13.serviceId, opts);
149
+ return this.a13.getPersonaV2(auth, cuit, opts);
150
+ }
151
+ /**
152
+ * CUITs/CUILs asociados a un número de documento (Padrón A13).
153
+ * @param documento - Número de documento (DNI); se aceptan puntos y espacios
154
+ */
155
+ async getIdPersonaListByDocumento(documento, call) {
156
+ const opts = this.opts(call);
157
+ const auth = await this.getAuth(ENDPOINTS.a13.serviceId, opts);
158
+ return this.a13.getIdPersonaListByDocumento(auth, documento, opts);
159
+ }
160
+ /**
161
+ * Tabla de parámetros (Padrón A100) por nombre de colección.
162
+ * @param collection - Nombre de la colección (ej: CollectionName.PROVINCIA)
163
+ */
164
+ async getParametros(collection, call) {
165
+ const opts = this.opts(call);
166
+ const auth = await this.getAuth(ENDPOINTS.a100.serviceId, opts);
167
+ return this.a100.getParameterCollectionByName(auth, collection, opts);
168
+ }
169
+ /**
170
+ * Estado de los servicios de Padrón (`dummy`, sin autenticación). Consulta
171
+ * todos en paralelo y devuelve el resultado de cada uno por separado: un
172
+ * servicio caído no oculta el estado de los demás.
173
+ *
174
+ * @example
175
+ * ```ts
176
+ * const s = await padron.status();
177
+ * if (s.a4.status === 'fulfilled') console.log(s.a4.value.appserver);
178
+ * else console.error(s.a4.reason);
179
+ * ```
180
+ */
181
+ async status(call) {
182
+ const opts = this.opts(call);
183
+ const [a5, a4, a10, a13, a100] = await Promise.allSettled([
184
+ this.a5.dummy(opts),
185
+ this.a4.dummy(opts),
186
+ this.a10.dummy(opts),
187
+ this.a13.dummy(opts),
188
+ this.a100.dummy(opts),
189
+ ]);
190
+ return { a5, a4, a10, a13, a100 };
191
+ }
192
+ // -------------------------------------------------------------------------
193
+ // Private helpers
194
+ // -------------------------------------------------------------------------
195
+ opts(call) {
196
+ return { signal: anySignal(this.signal, call?.signal) };
197
+ }
198
+ async getAuth(serviceId, opts) {
199
+ const ticket = await this.wsaa.getAccessTicket(serviceId, opts);
200
+ return {
201
+ Token: ticket.token,
202
+ Sign: ticket.sign,
203
+ CuitRepresentada: this.cuit,
204
+ };
205
+ }
206
+ }
207
+ //# sourceMappingURL=arca-padron.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"arca-padron.js","sourceRoot":"","sources":["../../src/arca-padron.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ import type { ArcaEvent, CallOptions, ServerStatus, SoapCallOptions } from '@ramiidv/arca-common';
2
+ import type { WsAuth } from './types.js';
3
+ /** Opciones de transporte que se pasan a cada llamada SOAP. */
4
+ export type PadronSoapOptions = Pick<SoapCallOptions, 'timeout' | 'retries' | 'retryDelayMs' | 'fetch' | 'legacyTls'>;
5
+ /** Shared configuration for all Padrón service clients. */
6
+ export interface PadronClientConfig {
7
+ /** SOAP endpoint URL */
8
+ endpoint: string;
9
+ /** SOAP namespace */
10
+ namespace: string;
11
+ /** Opciones de transporte (timeout, reintentos, fetch, TLS legacy) */
12
+ soapOptions?: PadronSoapOptions;
13
+ /** Optional event callback */
14
+ onEvent?: (event: ArcaEvent) => void;
15
+ }
16
+ /**
17
+ * Base de los clientes de Padrón.
18
+ *
19
+ * Los WS de Padrón declaran los parámetros sin namespace
20
+ * (`elementFormDefault="unqualified"`) y `soapAction=""`: `afipSoapCall` de
21
+ * arca-common prefija el método y deja los parámetros sin namespace. Todas las
22
+ * operaciones son consultas: se reintentan ante errores transitorios (nunca
23
+ * ante un SOAP Fault). Los Faults de negocio conocidos (CUIT inexistente,
24
+ * clave inactiva, token no autorizado...) se lanzan como `ArcaPadronServiceError`.
25
+ *
26
+ * Las respuestas se parsean con `parseNumbers: false`: todos los valores llegan
27
+ * como string tal cual los envía ARCA, y `mapping.ts` convierte explícitamente
28
+ * los campos numéricos del WSDL (`optNumber`/`reqNumber`). Así los `xs:string`
29
+ * con contenido numérico (`datoAdicional`, `codPostal`, `piso`, los campos del
30
+ * A100...) no pierden ceros ni decimales (`"10.50"`, `"1E3"`).
31
+ */
32
+ export declare abstract class BasePadronClient {
33
+ protected readonly endpoint: string;
34
+ protected readonly namespace: string;
35
+ protected readonly soapOptions?: PadronSoapOptions;
36
+ protected readonly onEvent?: (event: ArcaEvent) => void;
37
+ constructor(config: PadronClientConfig);
38
+ /** Llama a un método del servicio y traduce los Faults de negocio. */
39
+ protected call(method: string, params: Record<string, unknown>, opts?: CallOptions): Promise<Record<string, unknown>>;
40
+ /** Parámetros de autenticación en el orden del WSDL: token, sign, cuitRepresentada. */
41
+ protected authParams(auth: WsAuth): Record<string, unknown>;
42
+ /** Health check for this service. */
43
+ dummy(opts?: CallOptions): Promise<ServerStatus>;
44
+ }
45
+ //# sourceMappingURL=base-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../../src/base-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAG9B,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;;;;;;;;;;;;;;;GAeG;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,iBAAiB,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;gBAE5C,MAAM,EAAE,kBAAkB;IAOtC,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;IAcnC,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;CAQvD"}
@@ -0,0 +1,64 @@
1
+ import { afipSoapCall, validateCuit } from '@ramiidv/arca-common';
2
+ import { toPadronError } from './errors.js';
3
+ import { reqString } from './mapping.js';
4
+ /**
5
+ * Base de los clientes de Padrón.
6
+ *
7
+ * Los WS de Padrón declaran los parámetros sin namespace
8
+ * (`elementFormDefault="unqualified"`) y `soapAction=""`: `afipSoapCall` de
9
+ * arca-common prefija el método y deja los parámetros sin namespace. Todas las
10
+ * operaciones son consultas: se reintentan ante errores transitorios (nunca
11
+ * ante un SOAP Fault). Los Faults de negocio conocidos (CUIT inexistente,
12
+ * clave inactiva, token no autorizado...) se lanzan como `ArcaPadronServiceError`.
13
+ *
14
+ * Las respuestas se parsean con `parseNumbers: false`: todos los valores llegan
15
+ * como string tal cual los envía ARCA, y `mapping.ts` convierte explícitamente
16
+ * los campos numéricos del WSDL (`optNumber`/`reqNumber`). Así los `xs:string`
17
+ * con contenido numérico (`datoAdicional`, `codPostal`, `piso`, los campos del
18
+ * A100...) no pierden ceros ni decimales (`"10.50"`, `"1E3"`).
19
+ */
20
+ export class BasePadronClient {
21
+ endpoint;
22
+ namespace;
23
+ soapOptions;
24
+ onEvent;
25
+ constructor(config) {
26
+ this.endpoint = config.endpoint;
27
+ this.namespace = config.namespace;
28
+ this.soapOptions = config.soapOptions;
29
+ this.onEvent = config.onEvent;
30
+ }
31
+ /** Llama a un método del servicio y traduce los Faults de negocio. */
32
+ async call(method, params, opts) {
33
+ try {
34
+ return await afipSoapCall(this.endpoint, this.namespace, method, params, {
35
+ ...this.soapOptions,
36
+ parseNumbers: false,
37
+ kind: 'consulta',
38
+ onEvent: this.onEvent,
39
+ signal: opts?.signal,
40
+ });
41
+ }
42
+ catch (err) {
43
+ throw toPadronError(err, method);
44
+ }
45
+ }
46
+ /** Parámetros de autenticación en el orden del WSDL: token, sign, cuitRepresentada. */
47
+ authParams(auth) {
48
+ return {
49
+ token: auth.Token,
50
+ sign: auth.Sign,
51
+ cuitRepresentada: validateCuit(auth.CuitRepresentada),
52
+ };
53
+ }
54
+ /** Health check for this service. */
55
+ async dummy(opts) {
56
+ const result = await this.call('dummy', {}, opts);
57
+ return {
58
+ appserver: reqString(result['appserver'], 'dummy.appserver'),
59
+ dbserver: reqString(result['dbserver'], 'dummy.dbserver'),
60
+ authserver: reqString(result['authserver'], 'dummy.authserver'),
61
+ };
62
+ }
63
+ }
64
+ //# sourceMappingURL=base-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base-client.js","sourceRoot":"","sources":["../../src/base-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOlE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAkBzC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAgB,gBAAgB;IACjB,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,WAAW,CAAqB;IAChC,OAAO,CAA8B;IAExD,YAAY,MAA0B;QACpC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,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,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE;gBACvE,GAAG,IAAI,CAAC,WAAW;gBACnB,YAAY,EAAE,KAAK;gBACnB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,EAAE,MAAM;aACrB,CAAC,CAAC;QACL,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,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO;YACL,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;YAC5D,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;YACzD,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;SAChE,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,28 @@
1
+ import type { CondicionIvaPadron, PersonaA4, PersonaA5 } from './types.js';
2
+ /**
3
+ * Determina la condición frente al IVA de un contribuyente a partir del padrón
4
+ * (constancia de inscripción / A5, o A4), para usarla como `condicionIva` al
5
+ * facturarle.
6
+ *
7
+ * - Monotributo activo (impuesto 20 activo; o, si el impuesto 20 no figura, la
8
+ * categoría de monotributo) → MONOTRIBUTISTA, o MONOTRIBUTO_SOCIAL /
9
+ * MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO según la categoría. Un impuesto 20 en
10
+ * baja no cuenta aunque haya categoría.
11
+ * - IVA activo (impuesto 30, ACTIVO o ACTIVO EN TRAMITE) → RESPONSABLE_INSCRIPTO.
12
+ * - IVA (30) en estado EXENTO / EXENTO EN TRAMITE, o impuesto 32 → EXENTO.
13
+ * - Impuesto 34 → IVA_NO_ALCANZADO.
14
+ * - Si no figura ninguno, devuelve `condicionIva: null`: el padrón no alcanza
15
+ * para decidir (puede ser consumidor final o sujeto no categorizado según la
16
+ * operación). Si ARCA informó errores de la constancia (`errorConstancia`,
17
+ * `errorRegimenGeneral`, `errorMonotributo`), el motivo los incluye. No adivina.
18
+ *
19
+ * Es una función pura: no consulta ARCA.
20
+ *
21
+ * @example
22
+ * ```ts
23
+ * const persona = await padron.getConstanciaInscripcion('30712345674');
24
+ * const { condicionIva, motivo } = condicionIvaDesdePadron(persona);
25
+ * ```
26
+ */
27
+ export declare function condicionIvaDesdePadron(persona: PersonaA5 | PersonaA4): CondicionIvaPadron;
28
+ //# sourceMappingURL=condicion-iva.d.ts.map
@@ -0,0 +1 @@
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;AAsG3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,CAuE1F"}
@@ -0,0 +1,163 @@
1
+ import { CondicionIva } from '@ramiidv/arca-common';
2
+ import { ImpuestoId } from './constants.js';
3
+ /*
4
+ * Fuentes:
5
+ * - Manual ws_sr_constancia_inscripcion v4.1: impuesto 20 = MONOTRIBUTO
6
+ * (datosMonotributo), impuesto 30 = IVA (datosRegimenGeneral), estadoImpuesto
7
+ * "AC" = activo. Categorías de monotributo (anexo 5.3): 61, 99, 100
8
+ * "B MONOTRIBUTO SOCIAL ..."; 101 a 104 "D/E 2/3 SOCIOS PROY. SERVICIOS /
9
+ * PRODUCTIVO" (proyectos productivos de efectores sociales, Ley 25.865: también
10
+ * monotributo social); 98 "B ASOCIADO COOPERATIVA" (monotributo común: no
11
+ * es necesariamente efector social).
12
+ * - Manual ws_sr_padron_a4 v1.3 §5.3 (TipoEstado): ACTIVO, ACTIVO EN TRAMITE,
13
+ * BAJA PROVISORIA, BAJA DEFINITIVA, EXENTO, EXENTO EN TRAMITE, NO APORTANTE.
14
+ * La constancia informa el id del estado (`estadoImpuesto`, ej: "AC"); solo
15
+ * "AC" figura en los manuales. Las demás abreviaturas que se reconocen son
16
+ * las iniciales de TipoEstado (EX, BP, BD, NA = NO APORTANTE). "NO APORTANTE"
17
+ * no es "IVA no alcanzado": no se mapea a ninguna condición.
18
+ * - IVA exento (32) e IVA no alcanzado (34) no figuran en los manuales: se
19
+ * reconocen por id o por la descripción del impuesto.
20
+ * - Valores de CondicionIva: FEParamGetCondicionIvaReceptor (WSFEv1, RG 5616).
21
+ */
22
+ const CATEGORIAS_MONOTRIBUTO_SOCIAL = new Set([61, 99, 100, 101, 102, 103, 104]);
23
+ const ABREVIATURAS = {
24
+ AC: 'ACTIVO',
25
+ EX: 'EXENTO',
26
+ BP: 'BAJA PROVISORIA',
27
+ BD: 'BAJA DEFINITIVA',
28
+ NA: 'NO APORTANTE',
29
+ };
30
+ /** Normaliza el estado de un impuesto (palabras de TipoEstado o abreviatura SUPA). `''` si no vino. */
31
+ function normalizarEstado(estado) {
32
+ const e = (estado ?? '').trim().toUpperCase().normalize('NFD').replace(/[̀-ͯ]/g, '').replace(/\s+/g, ' ');
33
+ return ABREVIATURAS[e] ?? e;
34
+ }
35
+ /** Activo: ACTIVO o ACTIVO EN TRAMITE. Sin estado (respuestas anteriores a la v3.6 de la constancia) cuenta como activo. */
36
+ function esActivo(estado) {
37
+ return estado === '' || estado === 'ACTIVO' || estado === 'ACTIVO EN TRAMITE';
38
+ }
39
+ function esExento(estado) {
40
+ return estado === 'EXENTO' || estado === 'EXENTO EN TRAMITE';
41
+ }
42
+ function esA5(persona) {
43
+ return Array.isArray(persona.impuestos);
44
+ }
45
+ function impuesto(id, descripcion, estadoRaw) {
46
+ const estado = normalizarEstado(estadoRaw);
47
+ return { id, descripcion: descripcion ?? '', estado, activo: esActivo(estado) };
48
+ }
49
+ function impuestosDe(persona) {
50
+ if (esA5(persona))
51
+ return persona.impuestos.map((i) => impuesto(i.idImpuesto, i.descripcionImpuesto, i.estadoImpuesto));
52
+ return (persona.impuesto ?? []).map((i) => impuesto(i.idImpuesto, i.descripcionImpuesto, i.estado));
53
+ }
54
+ function categoriaMonotributo(persona) {
55
+ if (esA5(persona)) {
56
+ const c = persona.monotributo?.categoria;
57
+ return c ? { id: c.idCategoria, descripcion: c.descripcionCategoria ?? '' } : undefined;
58
+ }
59
+ const c = (persona.categoria ?? []).find((x) => x.idImpuesto === ImpuestoId.MONOTRIBUTO && esActivo(normalizarEstado(x.estado)));
60
+ return c ? { id: c.idCategoria, descripcion: c.descripcionCategoria ?? '' } : undefined;
61
+ }
62
+ /** Errores que informó la constancia (régimen general / monotributo), para el motivo. */
63
+ function erroresConstancia(persona) {
64
+ if (!esA5(persona))
65
+ return [];
66
+ const out = [];
67
+ const add = (nombre, e) => {
68
+ if (!e)
69
+ return;
70
+ const detalle = e.error.length > 0 ? e.error.join('; ') : (e.mensaje ?? 'sin detalle');
71
+ out.push(`${nombre}: ${detalle}`);
72
+ };
73
+ add('régimen general', persona.errorRegimenGeneral);
74
+ add('monotributo', persona.errorMonotributo);
75
+ return out;
76
+ }
77
+ /**
78
+ * Determina la condición frente al IVA de un contribuyente a partir del padrón
79
+ * (constancia de inscripción / A5, o A4), para usarla como `condicionIva` al
80
+ * facturarle.
81
+ *
82
+ * - Monotributo activo (impuesto 20 activo; o, si el impuesto 20 no figura, la
83
+ * categoría de monotributo) → MONOTRIBUTISTA, o MONOTRIBUTO_SOCIAL /
84
+ * MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO según la categoría. Un impuesto 20 en
85
+ * baja no cuenta aunque haya categoría.
86
+ * - IVA activo (impuesto 30, ACTIVO o ACTIVO EN TRAMITE) → RESPONSABLE_INSCRIPTO.
87
+ * - IVA (30) en estado EXENTO / EXENTO EN TRAMITE, o impuesto 32 → EXENTO.
88
+ * - Impuesto 34 → IVA_NO_ALCANZADO.
89
+ * - Si no figura ninguno, devuelve `condicionIva: null`: el padrón no alcanza
90
+ * para decidir (puede ser consumidor final o sujeto no categorizado según la
91
+ * operación). Si ARCA informó errores de la constancia (`errorConstancia`,
92
+ * `errorRegimenGeneral`, `errorMonotributo`), el motivo los incluye. No adivina.
93
+ *
94
+ * Es una función pura: no consulta ARCA.
95
+ *
96
+ * @example
97
+ * ```ts
98
+ * const persona = await padron.getConstanciaInscripcion('30712345674');
99
+ * const { condicionIva, motivo } = condicionIvaDesdePadron(persona);
100
+ * ```
101
+ */
102
+ export function condicionIvaDesdePadron(persona) {
103
+ const impuestos = impuestosDe(persona);
104
+ const tiene = (pred) => impuestos.find((i) => i.activo && pred(i));
105
+ const errores = erroresConstancia(persona);
106
+ const notaErrores = errores.length > 0 ? ` ARCA informó errores en la constancia (${errores.join(' | ')}).` : '';
107
+ const avisoClave = persona.estadoClave && persona.estadoClave.toUpperCase() !== 'ACTIVO'
108
+ ? ` Atención: la CUIT tiene estado ${persona.estadoClave}.`
109
+ : '';
110
+ const advertencia = avisoClave + notaErrores;
111
+ const categoria = categoriaMonotributo(persona);
112
+ const impuesto20 = impuestos.find((i) => i.id === ImpuestoId.MONOTRIBUTO);
113
+ const monotributo = impuesto20 ? impuesto20.activo : categoria !== undefined;
114
+ if (monotributo) {
115
+ const desc = categoria ? ` (categoría ${categoria.id} - ${categoria.descripcion.trim()})` : '';
116
+ if (categoria && (CATEGORIAS_MONOTRIBUTO_SOCIAL.has(categoria.id) || /MONOTRIBUTO SOCIAL/i.test(categoria.descripcion))) {
117
+ return { condicionIva: CondicionIva.MONOTRIBUTO_SOCIAL, motivo: `Monotributo social${desc}.${advertencia}` };
118
+ }
119
+ if (categoria && /PROMOVID/i.test(categoria.descripcion)) {
120
+ return {
121
+ condicionIva: CondicionIva.MONOTRIBUTO_INDEPENDIENTE_PROMOVIDO,
122
+ motivo: `Monotributo trabajador independiente promovido${desc}.${advertencia}`,
123
+ };
124
+ }
125
+ return { condicionIva: CondicionIva.MONOTRIBUTISTA, motivo: `Inscripto en monotributo (impuesto 20)${desc}.${advertencia}` };
126
+ }
127
+ if (tiene((i) => i.id === ImpuestoId.IVA_RESPONSABLE_INSCRIPTO)) {
128
+ return { condicionIva: CondicionIva.RESPONSABLE_INSCRIPTO, motivo: `Inscripto en IVA (impuesto 30).${advertencia}` };
129
+ }
130
+ const ivaExento = impuestos.find((i) => i.id === ImpuestoId.IVA_RESPONSABLE_INSCRIPTO && esExento(i.estado));
131
+ if (ivaExento) {
132
+ return {
133
+ condicionIva: CondicionIva.EXENTO,
134
+ motivo: `IVA (impuesto 30) en estado ${ivaExento.estado}.${advertencia}`,
135
+ };
136
+ }
137
+ if (tiene((i) => i.id === ImpuestoId.IVA_EXENTO || /IVA\s+EXENTO/i.test(i.descripcion))) {
138
+ return { condicionIva: CondicionIva.EXENTO, motivo: `IVA exento (impuesto 32).${advertencia}` };
139
+ }
140
+ if (tiene((i) => i.id === ImpuestoId.IVA_NO_ALCANZADO || /IVA.*NO\s+ALCANZADO/i.test(i.descripcion))) {
141
+ return { condicionIva: CondicionIva.IVA_NO_ALCANZADO, motivo: `IVA no alcanzado (impuesto 34).${advertencia}` };
142
+ }
143
+ if (esA5(persona) && persona.errorConstancia && impuestos.length === 0) {
144
+ return {
145
+ condicionIva: null,
146
+ motivo: `ARCA no emitió la constancia: ${persona.errorConstancia.error.join('; ')}.${advertencia}`,
147
+ };
148
+ }
149
+ if (errores.length > 0) {
150
+ return {
151
+ condicionIva: null,
152
+ motivo: `No se puede determinar: ARCA no informó datos de ${errores.map((e) => e.split(':')[0]).join(' ni de ')} ` +
153
+ `(${errores.join(' | ')}).${avisoClave}`,
154
+ };
155
+ }
156
+ return {
157
+ condicionIva: null,
158
+ motivo: 'No figura inscripto en IVA ni en monotributo: el padrón no alcanza para determinar la condición ' +
159
+ '(puede ser consumidor final o sujeto no categorizado según la operación).' +
160
+ advertencia,
161
+ };
162
+ }
163
+ //# sourceMappingURL=condicion-iva.js.map