@ramiidv/arca-fecred 0.1.0

package/dist/validation.js

@@ -0,0 +1,161 @@
+import { ArcaValidationError } from '@ramiidv/arca-common';
+// ---------------------------------------------------------------------------
+// CUIT validation
+// ---------------------------------------------------------------------------
+/**
+ * Validates a CUIT value. Must be a positive number or a non-empty numeric string.
+ * @param cuit - Value to validate
+ * @param fieldName - Field name for error messages (default: "cuit")
+ * @returns The CUIT as a string
+ * @throws ArcaValidationError if the CUIT is invalid
+ */
+export function validateCuit(cuit, fieldName = 'cuit') {
+    if (typeof cuit === 'number') {
+        if (!Number.isFinite(cuit) || cuit <= 0 || !Number.isInteger(cuit)) {
+            throw new ArcaValidationError(`${fieldName} debe ser un numero entero positivo.`, [{ field: fieldName, message: 'Debe ser un numero entero positivo', value: cuit }], fieldName);
+        }
+        return String(cuit);
+    }
+    if (typeof cuit === 'string') {
+        const trimmed = cuit.trim();
+        if (trimmed.length === 0) {
+            throw new ArcaValidationError(`${fieldName} no puede estar vacio.`, [{ field: fieldName, message: 'No puede estar vacio', value: cuit }], fieldName);
+        }
+        // Allow formats: 20123456789 or 20-12345678-9
+        const normalized = trimmed.replace(/-/g, '');
+        if (!/^\d+$/.test(normalized)) {
+            throw new ArcaValidationError(`${fieldName} debe contener solo digitos (opcionalmente separados por guiones).`, [{ field: fieldName, message: 'Debe contener solo digitos', value: cuit }], fieldName);
+        }
+        return trimmed;
+    }
+    throw new ArcaValidationError(`${fieldName} debe ser un numero o string.`, [{ field: fieldName, message: 'Debe ser un numero o string', value: cuit }], fieldName);
+}
+// ---------------------------------------------------------------------------
+// CodCtaCte validation
+// ---------------------------------------------------------------------------
+/**
+ * Validates a CodCtaCte (current account code).
+ * Must be a non-empty string or a positive number.
+ * @param cod - Value to validate
+ * @returns The code as a number
+ * @throws ArcaValidationError if the code is invalid
+ */
+export function validateCodCtaCte(cod) {
+    if (typeof cod === 'number') {
+        if (!Number.isFinite(cod) || cod <= 0 || !Number.isInteger(cod)) {
+            throw new ArcaValidationError('codCtaCte debe ser un numero entero positivo.', [{ field: 'codCtaCte', message: 'Debe ser un numero entero positivo', value: cod }], 'codCtaCte');
+        }
+        return cod;
+    }
+    if (typeof cod === 'string') {
+        const trimmed = cod.trim();
+        if (trimmed.length === 0) {
+            throw new ArcaValidationError('codCtaCte no puede estar vacio.', [{ field: 'codCtaCte', message: 'No puede estar vacio', value: cod }], 'codCtaCte');
+        }
+        const num = Number(trimmed);
+        if (!Number.isFinite(num) || num <= 0 || !Number.isInteger(num)) {
+            throw new ArcaValidationError('codCtaCte debe ser un numero entero positivo.', [{ field: 'codCtaCte', message: 'Debe ser un numero entero positivo', value: cod }], 'codCtaCte');
+        }
+        return num;
+    }
+    throw new ArcaValidationError('codCtaCte es requerido.', [{ field: 'codCtaCte', message: 'Es requerido', value: cod }], 'codCtaCte');
+}
+// ---------------------------------------------------------------------------
+// ConsultarCtasCtes params validation
+// ---------------------------------------------------------------------------
+/**
+ * Validates parameters for consultarCtasCtes.
+ * Requires rol, fechaDesde, fechaHasta, and at least one of CUITEmisor or CUITReceptor
+ * (depending on the role).
+ * @param params - Parameters to validate
+ * @throws ArcaValidationError if required fields are missing or invalid
+ */
+export function validateConsultaCtasCtes(params) {
+    const errors = [];
+    // Validate rol
+    if (!params.rol || typeof params.rol !== 'string' || params.rol.trim().length === 0) {
+        errors.push({
+            field: 'rol',
+            message: 'rol es requerido (debe ser "Emisor" o "Receptor")',
+            value: params.rol,
+        });
+    }
+    else {
+        const rolNorm = params.rol.trim();
+        if (rolNorm !== 'Emisor' && rolNorm !== 'Receptor') {
+            errors.push({
+                field: 'rol',
+                message: 'rol debe ser "Emisor" o "Receptor"',
+                value: params.rol,
+            });
+        }
+    }
+    // Validate fechaDesde
+    if (!params.fechaDesde || typeof params.fechaDesde !== 'string' || params.fechaDesde.trim().length === 0) {
+        errors.push({
+            field: 'fechaDesde',
+            message: 'fechaDesde es requerido',
+            value: params.fechaDesde,
+        });
+    }
+    else if (!isValidDateString(params.fechaDesde)) {
+        errors.push({
+            field: 'fechaDesde',
+            message: 'fechaDesde debe ser una fecha valida (YYYY-MM-DD)',
+            value: params.fechaDesde,
+        });
+    }
+    // Validate fechaHasta
+    if (!params.fechaHasta || typeof params.fechaHasta !== 'string' || params.fechaHasta.trim().length === 0) {
+        errors.push({
+            field: 'fechaHasta',
+            message: 'fechaHasta es requerido',
+            value: params.fechaHasta,
+        });
+    }
+    else if (!isValidDateString(params.fechaHasta)) {
+        errors.push({
+            field: 'fechaHasta',
+            message: 'fechaHasta debe ser una fecha valida (YYYY-MM-DD)',
+            value: params.fechaHasta,
+        });
+    }
+    // Validate date range
+    if (params.fechaDesde && params.fechaHasta && isValidDateString(params.fechaDesde) && isValidDateString(params.fechaHasta)) {
+        if (params.fechaDesde > params.fechaHasta) {
+            errors.push({
+                field: 'fechaHasta',
+                message: 'fechaHasta debe ser igual o posterior a fechaDesde',
+                value: { fechaDesde: params.fechaDesde, fechaHasta: params.fechaHasta },
+            });
+        }
+    }
+    // Validate that at least one CUIT is present
+    const hasCuitEmisor = params.cuitEmisor != null && String(params.cuitEmisor).trim().length > 0;
+    const hasCuitReceptor = params.cuitReceptor != null && String(params.cuitReceptor).trim().length > 0;
+    if (!hasCuitEmisor && !hasCuitReceptor) {
+        // While the WS may accept queries without CUITs in some cases,
+        // at least one is typically needed depending on the role
+        // We allow it but do not error - the service will return its own error if needed
+    }
+    if (errors.length > 0) {
+        throw new ArcaValidationError(`Parametros de consultarCtasCtes invalidos: ${errors.map((e) => e.message).join('; ')}`, errors);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Checks if a string is a valid YYYY-MM-DD date.
+ */
+function isValidDateString(dateStr) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(dateStr))
+        return false;
+    const date = new Date(dateStr + 'T00:00:00Z');
+    if (isNaN(date.getTime()))
+        return false;
+    // Verify the parsed date matches input (catches e.g. 2026-02-30)
+    const [y, m, d] = dateStr.split('-').map(Number);
+    return date.getUTCFullYear() === y && date.getUTCMonth() + 1 === m && date.getUTCDate() === d;
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/llms.txt

@@ -0,0 +1,173 @@
+# @ramiidv/arca-fecred
+
+> TypeScript SDK para el web service WSFECRED de ARCA (ex AFIP) - Factura de Credito Electronica MiPyME (Ley 27440)
+
+## Instalacion
+
+```bash
+npm install @ramiidv/arca-fecred
+```
+
+Requisitos: Node.js >= 18 (fetch nativo). ESM only.
+
+## Configuracion
+
+```typescript
+import { ArcaFecred } from '@ramiidv/arca-fecred';
+
+const fecred = new ArcaFecred({
+  cert: string,          // PEM X.509 certificate
+  key: string,           // PEM RSA private key
+  cuit: string,          // CUIT representada (ej: "20123456789")
+  production?: boolean,  // default: false (homologacion)
+  timeout?: number,      // default: 30000
+  retries?: number,      // default: 1
+  retryDelayMs?: number, // default: 1000
+  onEvent?: (event: ArcaEvent) => void,
+});
+```
+
+## Metodos principales
+
+### consultarMontoObligadoRecepcion(cuit: string): Promise<MontoObligadoResult>
+Verifica si una CUIT esta obligada a recibir FCE. Retorna: { cuitConsultada, obligado: boolean, montoDesde?: number, raw }.
+
+### consultarCtasCtes(params: ConsultarCtasCtesParams): Promise<CtaCte[]>
+Consulta cuentas corrientes de actividad FCE. Params: { rol: "Emisor"|"Receptor", cuitEmisor?, cuitReceptor?, fechaDesde, fechaHasta }. Retorna array de CtaCte.
+
+### consultarComprobantes(params: ConsultarComprobantesParams): Promise<ComprobanteFecred[]>
+Busca comprobantes FCE. Params: { cuitEmisor?, cuitReceptor?, codCtaCte?, fechaDesde?, fechaHasta? }. Retorna array de ComprobanteFecred.
+
+### aceptarFECred(codCtaCte: number): Promise<AceptarFecredResult>
+Acepta una FCE. Retorna: { codCtaCte, resultado, raw }.
+
+### rechazarFECred(codCtaCte: number, codMotivoRechazo: number): Promise<RechazarFecredResult>
+Rechaza una FCE. Usar MotivoRechazo enum para codMotivoRechazo. Retorna: { codCtaCte, resultado, raw }.
+
+### informarFacturaAceptadaCancelada(params: InformarCanceladaParams): Promise<InformarCanceladaResult>
+Informa que una FCE aceptada fue pagada. Params: { codCtaCte, codFormaCancelacion, observaciones? }. Usar FormaCancelacion enum.
+
+### consultarTiposRetenciones(): Promise<TipoRetencionItem[]>
+Tipos de retenciones disponibles. Retorna: { codTipoRetencion, descTipoRetencion }[].
+
+### consultarTiposFormasCancelacion(): Promise<TipoFormaCancelacionItem[]>
+Formas de cancelacion disponibles. Retorna: { codFormaCancelacion, descFormaCancelacion }[].
+
+### consultarTiposAjustesOperacion(): Promise<TipoAjusteOperacionItem[]>
+Tipos de ajustes de operacion. Retorna: { codTipoAjuste, descTipoAjuste }[].
+
+### consultarTiposMotivoRechazo(): Promise<TipoMotivoRechazoItem[]>
+Motivos de rechazo disponibles. Retorna: { codMotivoRechazo, descMotivoRechazo }[].
+
+### status(): Promise<ServerStatus>
+Health check. No requiere autenticacion. Retorna: { appserver, dbserver, authserver }.
+
+### clearAuthCache(): void
+Invalida el ticket de acceso cacheado para WSFECRED.
+
+## Tipos principales
+
+```typescript
+interface CtaCte {
+  codCtaCte: number;
+  cuitEmisor: string;
+  denominacionEmisor?: string;
+  cuitReceptor: string;
+  denominacionReceptor?: string;
+  tipoComprobante?: number;
+  puntoVenta?: number;
+  nroComprobante?: number;
+  codMoneda?: string;
+  importeTotal?: number;
+  saldo?: number;
+  estado?: string;
+  fechaEmision?: string;
+  fechaVencimientoPago?: string;
+  fechaVencimientoAceptacion?: string;
+  cae?: string;
+}
+
+interface ComprobanteFecred {
+  codCtaCte: number;
+  tipoComprobante?: number;
+  puntoVenta?: number;
+  nroComprobante?: number;
+  cuitEmisor: string;
+  cuitReceptor: string;
+  codMoneda?: string;
+  importeTotal?: number;
+  importeNeto?: number;
+  saldo?: number;
+  estado?: string;
+  fechaEmision?: string;
+  fechaVencimientoPago?: string;
+  cae?: string;
+  retenciones?: RetencionFecred[];
+}
+
+interface MontoObligadoResult {
+  cuitConsultada: string;
+  obligado: boolean;
+  montoDesde?: number;
+  raw: Record<string, unknown>;
+}
+
+interface ServerStatus {
+  appserver: string;
+  dbserver: string;
+  authserver: string;
+}
+```
+
+## Errores
+
+3-class hierarchy from @ramiidv/arca-common:
+- ArcaError: base class
+- ArcaAuthError: WSAA authentication failures
+- ArcaServiceError: business errors from WSFECRED (has errors: {code: number, msg: string}[])
+- ArcaSoapError: HTTP/transport errors (has statusCode?: number)
+
+```typescript
+import { ArcaAuthError, ArcaServiceError, ArcaSoapError } from '@ramiidv/arca-fecred';
+
+try {
+  await fecred.aceptarFECred(codCtaCte);
+} catch (error) {
+  if (error instanceof ArcaAuthError) { /* auth failure */ }
+  if (error instanceof ArcaServiceError) { /* business error, check error.errors */ }
+  if (error instanceof ArcaSoapError) { /* HTTP/network error, check error.statusCode */ }
+}
+```
+
+## Eventos
+
+Discriminated union types: auth:login, auth:cache-hit, request:start, request:end, request:retry, request:error.
+
+## Enums
+
+- RolCtaCte (EMISOR="Emisor", RECEPTOR="Receptor")
+- EstadoCtaCte (PENDIENTE_ACEPTACION, ACEPTADA, RECHAZADA, CANCELADA, ANULADA)
+- MotivoRechazo (NOTA_CREDITO_DEBITO=1, CUIT_INCORRECTO=2, FECHA_INCORRECTA=3, CBU_INCORRECTO=4, OTROS=5)
+- FormaCancelacion (ACREDITACION_CUENTA=1, TRANSFERENCIA=2, CHEQUE=3, PAGO_ELECTRONICO=4, COMPENSACION=5, ENDOSO=6, OTRO=99)
+- TipoAjusteOperacion (NOTA_CREDITO=1, NOTA_DEBITO=2)
+- TipoRetencion (GANANCIAS=1, IVA=2, SUSS=3, INGRESOS_BRUTOS=4, OTRAS=99)
+
+## Clientes de bajo nivel
+
+Accesibles como propiedades publicas: fecred.wsaa, fecred.fecred.
+
+## SOAP details
+
+- WSAA service ID: "wsfecred"
+- Production endpoint: https://serviciosjava.afip.gob.ar/wsfecred/FECredService
+- Homologation endpoint: https://fwshomo.afip.gob.ar/wsfecred/FECredService
+- Namespace: https://serviciosjava.afip.gob.ar/wsfecred/FECredService?wsdl
+- Uses ser: prefix (Java-based, like padron services)
+- Auth passed as authRequest: { Token, Sign, Cuit }
+
+## Utilidades re-exportadas de arca-common
+
+- ensureArray<T>(value): T[] - normaliza single/array SOAP responses
+- parseXml(xml): Record<string, unknown> - parse XML
+- buildXml(obj): string - build XML from object
+- checkServiceErrors(result, serviceName): void - throws ArcaServiceError if errors found

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@ramiidv/arca-fecred",
+  "version": "0.1.0",
+  "description": "TypeScript SDK para el web service WSFECRED de ARCA (ex AFIP) - Factura de Credito Electronica MiPyME",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "arca",
+    "afip",
+    "wsfecred",
+    "fce",
+    "factura-credito-electronica",
+    "mipyme",
+    "argentina",
+    "sdk",
+    "typescript",
+    "soap"
+  ],
+  "author": "ramiidv",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ramiidv/arca-fecred.git"
+  },
+  "homepage": "https://github.com/ramiidv/arca-fecred#readme",
+  "bugs": {
+    "url": "https://github.com/ramiidv/arca-fecred/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@ramiidv/arca-common": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.2.4"
+  }
+}