@ramiidv/arca-fecred 0.2.0 → 0.4.0

package/dist/arca-fecred.d.ts

@@ -1,129 +1,83 @@
-import { WsaaClient } from '@ramiidv/arca-common';
-import type { ServerStatus } from '@ramiidv/arca-common';
+import { ArcaSdkBase } from '@ramiidv/arca-common';
+import type { CallOptions, ServerStatus } from '@ramiidv/arca-common';
 import { FecredClient } from './fecred-client.js';
-import type { ArcaFecredConfig, MontoObligadoResult, CtaCte, ComprobanteFecred, ConsultarCtasCtesParams, ConsultarComprobantesParams, AceptarFecredResult, RechazarFecredResult, InformarCanceladaParams, InformarCanceladaResult, TipoRetencionItem, TipoFormaCancelacionItem, TipoAjusteOperacionItem, TipoMotivoRechazoItem } from './types.js';
+import type { AceptarFecredParams, ArcaFecredConfig, CodigoDescripcion, ConsultarComprobantesParams, ConsultarComprobantesResult, ConsultarCtaCteResult, ConsultarCtasCtesParams, ConsultarCtasCtesResult, ConsultarCuentasEnAgtDptoCltvResult, ConsultarFacturasAgtDptoCltvParams, ConsultarFacturasAgtDptoCltvResult, ConsultarMontoObligadoRecepcionParams, HistorialEstadosComprobanteResult, HistorialEstadosCtaCteResult, IdComprobante, IdComprobanteInput, IdCtaCteInput, InformarCancelacionTotalParams, InformarFacturaAgtDptoCltvParams, ModificarOpcionTransferenciaParams, MontoObligadoRecepcionResult, ObligadoRecepcionResult, OperacionFecredResult, RechazarFecredParams, RechazarNotaDCParams, RechazarNotaDCResult, TipoRetencion } from './types.js';
 /**
- * Main orchestrator class for ARCA WSFECRED (Factura de Credito Electronica MiPyME).
- *
- * Provides high-level methods that handle WSAA authentication automatically
- * and expose results from the WSFECRED web service for managing FCE
- * (Electronic Credit Invoices) under Law 27440.
+ * Cliente de alto nivel de WSFECRED (Factura de Crédito Electrónica MiPyME,
+ * Ley 27.440). Obtiene y cachea el Ticket de Acceso de WSAA automáticamente.
  *
  * @example
  * ```ts
- * import { ArcaFecred } from '@ramiidv/arca-fecred';
- * import { readFileSync } from 'fs';
- *
  * const fecred = new ArcaFecred({
  *   cert: readFileSync('cert.pem', 'utf-8'),
  *   key: readFileSync('key.pem', 'utf-8'),
- *   cuit: '20123456789',
- *   production: false,
+ *   cuit: '20123456786',
  * });
  *
- * // Check if a CUIT is obligated to receive FCE
- * const obligado = await fecred.consultarMontoObligadoRecepcion('30712345678');
- * console.log(obligado.obligado); // true/false
+ * const { obligado, montoDesde } = await fecred.consultarMontoObligadoRecepcion({
+ *   cuitConsultada: '30712345674',
+ *   fechaEmision: '2026-11-01',
+ * });
  *
- * // Query current accounts
- * const cuentas = await fecred.consultarCtasCtes({
+ * const { ctasCtes, hayMas } = await fecred.consultarCtasCtes({
  *   rol: 'Receptor',
- *   fechaDesde: '2026-01-01',
- *   fechaHasta: '2026-03-31',
+ *   fecha: { tipo: 'Emision', desde: '2026-10-01', hasta: '2026-10-31' },
  * });
  * ```
  */
-export declare class ArcaFecred {
-    /** Low-level WSAA client for direct access */
-    readonly wsaa: WsaaClient;
-    /** Low-level WSFECRED client for direct access */
-    readonly fecred: FecredClient;
-    private readonly cuit;
-    private readonly onEvent?;
+export declare class ArcaFecred extends ArcaSdkBase<'wsfecred'> {
+    /** Cliente de bajo nivel de FECredService. */
+    readonly client: FecredClient;
+    /** @deprecated Usá `client` (mismo objeto; mismo nombre que en el resto de los SDKs). */
+    get fecred(): FecredClient;
     constructor(config: ArcaFecredConfig);
+    /** Estado de los servidores de WSFECRED (`dummy`, sin autenticación). */
+    status(opts?: CallOptions): Promise<ServerStatus>;
+    /** Si una CUIT está obligada a recibir FCE para una fecha de emisión, y desde qué monto. */
+    consultarMontoObligadoRecepcion(params: ConsultarMontoObligadoRecepcionParams, opts?: CallOptions): Promise<MontoObligadoRecepcionResult>;
+    /** Si una CUIT está obligada a recibir FCE y desde qué fecha. */
+    consultarObligadoRecepcion(cuitConsultada: number | string, opts?: CallOptions): Promise<ObligadoRecepcionResult>;
+    /** Cuentas corrientes de FCE (paginado: ver `hayMas` / `nroPagina`). */
+    consultarCtasCtes(params: ConsultarCtasCtesParams, opts?: CallOptions): Promise<ConsultarCtasCtesResult>;
+    /** Detalle de una cuenta corriente. */
+    consultarCtaCte(idCtaCte: IdCtaCteInput, opts?: CallOptions): Promise<ConsultarCtaCteResult>;
+    /** Comprobantes FCE (paginado: ver `hayMas` / `nroPagina`). */
+    consultarComprobantes(params: ConsultarComprobantesParams, opts?: CallOptions): Promise<ConsultarComprobantesResult>;
+    /** Historial de estados de un comprobante. */
+    consultarHistorialEstadosComprobante(idComprobante: IdComprobanteInput, opts?: CallOptions): Promise<HistorialEstadosComprobanteResult>;
+    /** Historial de estados de una cuenta corriente. */
+    consultarHistorialEstadosCtaCte(idCtaCte: IdCtaCteInput, opts?: CallOptions): Promise<HistorialEstadosCtaCteResult>;
+    /** Remitos asociados a un comprobante. */
+    obtenerRemitos(idComprobante: IdComprobanteInput, opts?: CallOptions): Promise<IdComprobante[]>;
     /**
-     * Health check for the WSFECRED service.
-     * Does not require authentication.
-     */
-    status(): Promise<ServerStatus>;
-    /**
-     * Check if a CUIT is obligated to receive FCE (Factura de Credito Electronica).
-     * Authenticates automatically via WSAA.
-     *
-     * @param cuitConsultada - CUIT to check
-     * @returns Result indicating if the CUIT is obligated and the threshold amount
-     */
-    consultarMontoObligadoRecepcion(cuitConsultada: string): Promise<MontoObligadoResult>;
-    /**
-     * Query current accounts from FCE activity.
-     * Authenticates automatically via WSAA.
-     *
-     * @param params - Query filters (role, CUITs, date range)
-     * @returns Array of current account records
-     */
-    consultarCtasCtes(params: ConsultarCtasCtesParams): Promise<CtaCte[]>;
-    /**
-     * Search FCE invoices by filters.
-     * Authenticates automatically via WSAA.
-     *
-     * @param params - Query filters
-     * @returns Array of FCE invoice records
-     */
-    consultarComprobantes(params: ConsultarComprobantesParams): Promise<ComprobanteFecred[]>;
-    /**
-     * Accept an FCE (Factura de Credito Electronica).
-     * Authenticates automatically via WSAA.
-     *
-     * @param codCtaCte - Current account code of the FCE to accept
-     * @returns Result of the acceptance operation
-     */
-    aceptarFECred(codCtaCte: number): Promise<AceptarFecredResult>;
-    /**
-     * Reject an FCE (Factura de Credito Electronica).
-     * Authenticates automatically via WSAA.
-     *
-     * @param codCtaCte - Current account code of the FCE to reject
-     * @param codMotivoRechazo - Rejection reason code (use MotivoRechazo enum)
-     * @returns Result of the rejection operation
-     */
-    rechazarFECred(codCtaCte: number, codMotivoRechazo: number): Promise<RechazarFecredResult>;
-    /**
-     * Inform that an accepted FCE was paid/cancelled.
-     * Authenticates automatically via WSAA.
-     *
-     * @param params - Cancellation details (account code, payment method, optional observations)
-     * @returns Result of the cancellation notification
-     */
-    informarFacturaAceptadaCancelada(params: InformarCanceladaParams): Promise<InformarCanceladaResult>;
-    /**
-     * Query available retention types.
-     * Authenticates automatically via WSAA.
-     */
-    consultarTiposRetenciones(): Promise<TipoRetencionItem[]>;
-    /**
-     * Query available payment method types for cancelling accepted FCE.
-     * Authenticates automatically via WSAA.
-     */
-    consultarTiposFormasCancelacion(): Promise<TipoFormaCancelacionItem[]>;
-    /**
-     * Query available operation adjustment types.
-     * Authenticates automatically via WSAA.
-     */
-    consultarTiposAjustesOperacion(): Promise<TipoAjusteOperacionItem[]>;
-    /**
-     * Query available rejection reason types.
-     * Authenticates automatically via WSAA.
-     */
-    consultarTiposMotivoRechazo(): Promise<TipoMotivoRechazoItem[]>;
-    /** Invalidate the cached WSAA access ticket for WSFECRED. */
-    clearAuthCache(): void;
-    private getAuth;
-    private parseCtaCte;
-    private parseComprobante;
-    /**
-     * Generic parser for parameter arrays from WSFECRED responses.
-     * Handles varying SOAP response structures (different key names, namespaces).
+     * Acepta una FCE. Un rechazo de ARCA (errores o `resultado = 'R'`) se lanza
+     * como `ArcaServiceError`. Si la respuesta se pierde (`ArcaSoapError` con
+     * `uncertain`), consultá el estado con `consultarCtaCte` antes de reintentar.
      */
-    private parseParamArray;
+    aceptarFECred(params: AceptarFecredParams, opts?: CallOptions): Promise<OperacionFecredResult>;
+    /** Rechaza una FCE (motivos de `consultarTiposMotivosRechazo`). */
+    rechazarFECred(params: RechazarFecredParams, opts?: CallOptions): Promise<OperacionFecredResult>;
+    /** Informa la cancelación total de una FCE aceptada. */
+    informarCancelacionTotalFECred(params: InformarCancelacionTotalParams, opts?: CallOptions): Promise<OperacionFecredResult>;
+    /** Rechaza una nota de débito/crédito asociada a una FCE. */
+    rechazarNotaDC(params: RechazarNotaDCParams, opts?: CallOptions): Promise<RechazarNotaDCResult>;
+    /** Cambia la opción de transferencia (SCA/ADC) de una cuenta corriente. */
+    modificarOpcionTransferencia(params: ModificarOpcionTransferenciaParams, opts?: CallOptions): Promise<OperacionFecredResult>;
+    /** Informa una factura a un Agente de Depósito Colectivo. */
+    informarFacturaAgtDptoCltv(params: InformarFacturaAgtDptoCltvParams, opts?: CallOptions): Promise<OperacionFecredResult>;
+    /** Cuentas de la CUIT representada en Agentes de Depósito Colectivo. */
+    consultarCuentasEnAgtDptoCltv(opts?: CallOptions): Promise<ConsultarCuentasEnAgtDptoCltvResult>;
+    /** Facturas informadas a Agentes de Depósito Colectivo. */
+    consultarFacturasAgtDptoCltv(params?: ConsultarFacturasAgtDptoCltvParams, opts?: CallOptions): Promise<ConsultarFacturasAgtDptoCltvResult>;
+    /** Tipos de retenciones (jurisdicción y porcentaje). */
+    consultarTiposRetenciones(opts?: CallOptions): Promise<TipoRetencion[]>;
+    /** Formas de cancelación (para `aceptarFECred` / `informarCancelacionTotalFECred`). */
+    consultarTiposFormasCancelacion(opts?: CallOptions): Promise<CodigoDescripcion[]>;
+    /** Motivos de rechazo (para `rechazarFECred` / `rechazarNotaDC`). */
+    consultarTiposMotivosRechazo(opts?: CallOptions): Promise<CodigoDescripcion[]>;
+    /** Tipos de ajustes de operación (para `aceptarFECred`). */
+    consultarTiposAjustesOperacion(opts?: CallOptions): Promise<CodigoDescripcion[]>;
+    /** Credenciales diferidas: el cliente las pide después de validar los parámetros. */
+    private auth;
 }
 //# sourceMappingURL=arca-fecred.d.ts.map

package/dist/arca-fecred.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arca-fecred.d.ts","sourceRoot":"","sources":["../src/arca-fecred.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAe,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAA8B,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EACV,gBAAgB,EAEhB,mBAAmB,EACnB,MAAM,EACN,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,UAAU;IACrB,8CAA8C;IAC9C,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,kDAAkD;IAClD,SAAgB,MAAM,EAAE,YAAY,CAAC;IAErC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA6B;gBAE1C,MAAM,EAAE,gBAAgB;IAkCpC;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAQrC;;;;;;OAMG;IACG,+BAA+B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAe3F;;;;;;OAMG;IACG,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB3E;;;;;;OAMG;IACG,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAyB9F;;;;;;OAMG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAYpE;;;;;;;OAOG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAYhG;;;;;;OAMG;IACG,gCAAgC,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAoBzG;;;OAGG;IACG,yBAAyB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAc/D;;;OAGG;IACG,+BAA+B,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAc5E;;;OAGG;IACG,8BAA8B,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAc1E;;;OAGG;IACG,2BAA2B,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAkBrE,6DAA6D;IAC7D,cAAc,IAAI,IAAI;YAQR,OAAO;IASrB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,gBAAgB;IA4CxB;;;OAGG;IACH,OAAO,CAAC,eAAe;CA6BxB"}
+{"version":3,"file":"arca-fecred.d.ts","sourceRoot":"","sources":["../src/arca-fecred.ts"],"names":[],"mappings":"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"}