@fiado/api-invoker 5.85.0 → 5.86.0

package/bin/benefits-marketplace/api/BenefitsMarketplaceApi.d.ts

@@ -2,6 +2,7 @@ import { IBenefitsMarketplaceApi } from "./interfaces/IBenefitsMarketplaceApi.js
 import { IHttpRequest } from "@fiado/http-client";
 import { BenefitPaymentRequest, BenefitPaymentResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { RemittanceOnboardingPrefillRequest, RemittanceOnboardingPrefillResponse } from "@fiado/type-kit/bin/remittance/index.js";
 import { BenefitLeafDisplayResponse } from "./dtos/BenefitLeafDisplayResponse.js";
 import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
@@ -13,4 +14,5 @@ export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
     getLeafDisplay(benefitId: string, leafId: string): Promise<ApiGatewayResponse<BenefitLeafDisplayResponse>>;
     fundingCreate(moduleName: string, request: CreateFundingReferenceRequest): Promise<ApiGatewayResponse<CreateFundingReferenceResponse>>;
     fundingList(moduleName: string, directoryId: string, status?: string): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
+    remittanceOnboardingPrefill(request: RemittanceOnboardingPrefillRequest): Promise<ApiGatewayResponse<RemittanceOnboardingPrefillResponse>>;
 }

package/bin/benefits-marketplace/api/BenefitsMarketplaceApi.js

@@ -40,6 +40,10 @@ let BenefitsMarketplaceApi = class BenefitsMarketplaceApi {
         const url = `${this.baseUrl}/funding/${encodeURIComponent(moduleName)}/references?${params.toString()}`;
         return await this.httpRequest.get(url);
     }
+    async remittanceOnboardingPrefill(request) {
+        const url = `${this.baseUrl}/remittance/onboarding/prefill`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 BenefitsMarketplaceApi = __decorate([
     injectable(),

package/bin/benefits-marketplace/api/interfaces/IBenefitsMarketplaceApi.d.ts

@@ -1,5 +1,6 @@
 import { BenefitPaymentRequest, BenefitPaymentResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { RemittanceOnboardingPrefillRequest, RemittanceOnboardingPrefillResponse } from "@fiado/type-kit/bin/remittance/index.js";
 import { BenefitLeafDisplayResponse } from "../dtos/BenefitLeafDisplayResponse.js";
 import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
 /**
@@ -71,4 +72,11 @@ export interface IBenefitsMarketplaceApi {
      * Backend: GET /funding/{moduleName}/references?directoryId=&status=
      */
     fundingList(moduleName: string, directoryId: string, status?: string): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
+    /**
+     * Composición del onboarding de remesas de un usuario SIN ejecutarla: lo que la app
+     * mandaría hoy (datos de Fiado) o el motivo de bloqueo + direcciones candidatas.
+     * Backend: POST /remittance/onboarding/prefill (privado VPC). Lo consume remittance-business
+     * para el reintento de registro desde el backoffice.
+     */
+    remittanceOnboardingPrefill(request: RemittanceOnboardingPrefillRequest): Promise<ApiGatewayResponse<RemittanceOnboardingPrefillResponse>>;
 }

package/bin/uniteller-connector/api/UnitellerConnectorApi.d.ts

@@ -1,7 +1,7 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, KycUserDetail, KycUsersListResponse, KycOnboardingAttemptsResponse, RefreshUserProfileResponse, RegisterOnboardingBlockRequest, RegisterOnboardingBlockResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsPeriod, RemittanceBackofficeCancelCloseRequest, RemittanceBackofficeCancelCloseResponse, RemittanceBackofficeTransaction, RemittanceBackofficeTxListResponse, RemittanceBackofficeUserDetail, RemittanceBackofficeUserListResponse, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest, RemittanceUserLimits, RemittanceUserLimitsBatchResponse, RemittanceCorridor, PricingScheduleResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, KycUserDetail, KycUsersListResponse, KycOnboardingAttemptsResponse, RefreshUserProfileResponse, RegisterOnboardingBlockRequest, RegisterOnboardingBlockResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsRangeRequest, RemittanceBackofficeStatsPeriod, RemittanceBackofficeCancelCloseRequest, RemittanceBackofficeCancelCloseResponse, RemittanceBackofficeTransaction, RemittanceBackofficeTxListResponse, RemittanceBackofficeUserDetail, RemittanceBackofficeUserListResponse, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest, RemittanceUserLimits, RemittanceUserLimitsBatchResponse, RemittanceCorridor, PricingScheduleResponse } from "@fiado/type-kit/bin/remittance/index.js";
 import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi.js";
 export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     private httpRequest;
@@ -27,9 +27,9 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     }): Promise<ApiGatewayResponse<RemittancePayerAdditionalFieldDto[]>>;
     listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>>;
     getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{
+    addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    deactivateBeneficiary(directoryId: string, beneficiaryId: string, actor?: string): Promise<ApiGatewayResponse<{
         deactivated: boolean;
         beneficiaryId: string;
     }>>;
@@ -70,6 +70,7 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     backofficeSyncTransaction(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>>;
     backofficeCloseCancellation(txNumber: string, request: RemittanceBackofficeCancelCloseRequest): Promise<ApiGatewayResponse<RemittanceBackofficeCancelCloseResponse>>;
     backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
+    backofficeStatsRange(request: RemittanceBackofficeStatsRangeRequest): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
     backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>>;
     backofficeUserLimitsBatch(directoryIds: string[]): Promise<ApiGatewayResponse<RemittanceUserLimitsBatchResponse>>;
     kycListUsers(filters?: {

package/bin/uniteller-connector/api/UnitellerConnectorApi.js

@@ -65,17 +65,17 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
         return await this.httpRequest.post(url, { directoryId });
     }
-    async addBeneficiary(directoryId, request) {
+    async addBeneficiary(directoryId, request, actor) {
         const url = `${this.baseUrl}/beneficiaries`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
+        return await this.httpRequest.post(url, { directoryId, ...request, ...(actor && { actor }) });
     }
-    async updateBeneficiary(directoryId, beneficiaryId, request) {
+    async updateBeneficiary(directoryId, beneficiaryId, request, actor) {
         const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
-        return await this.httpRequest.put(url, { directoryId, ...request });
+        return await this.httpRequest.put(url, { directoryId, ...request, ...(actor && { actor }) });
     }
-    async deactivateBeneficiary(directoryId, beneficiaryId) {
+    async deactivateBeneficiary(directoryId, beneficiaryId, actor) {
         const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}/deactivate`;
-        return await this.httpRequest.post(url, { directoryId });
+        return await this.httpRequest.post(url, { directoryId, ...(actor && { actor }) });
     }
     async pricingSchedule(directoryId, corridor) {
         const url = `${this.baseUrl}/pricing/schedule`;
@@ -157,6 +157,14 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/backoffice/stats`;
         return await this.httpRequest.get(url, { period });
     }
+    async backofficeStatsRange(request) {
+        const url = `${this.baseUrl}/backoffice/stats`;
+        return await this.httpRequest.get(url, {
+            from: request.from,
+            to: request.to,
+            ...(request.tzOffsetMinutes !== undefined && { tzOffsetMinutes: String(request.tzOffsetMinutes) }),
+        });
+    }
     async backofficeUserLimits(directoryId) {
         const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}/limits`;
         return await this.httpRequest.get(url);

package/bin/uniteller-connector/api/interfaces/IUnitellerConnectorApi.d.ts

@@ -1,6 +1,6 @@
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, RemittanceCorridor, PricingScheduleResponse, KycUserDetail, KycUsersListResponse, KycOnboardingAttemptsResponse, RefreshUserProfileResponse, RegisterOnboardingBlockRequest, RegisterOnboardingBlockResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsPeriod, RemittanceBackofficeCancelCloseRequest, RemittanceBackofficeCancelCloseResponse, RemittanceBackofficeTransaction, RemittanceBackofficeTxListResponse, RemittanceBackofficeUserDetail, RemittanceBackofficeUserListResponse, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest, RemittanceUserLimits, RemittanceUserLimitsBatchResponse } from "@fiado/type-kit/bin/remittance/index.js";
+import { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, RemittanceCorridor, PricingScheduleResponse, KycUserDetail, KycUsersListResponse, KycOnboardingAttemptsResponse, RefreshUserProfileResponse, RegisterOnboardingBlockRequest, RegisterOnboardingBlockResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsRangeRequest, RemittanceBackofficeStatsPeriod, RemittanceBackofficeCancelCloseRequest, RemittanceBackofficeCancelCloseResponse, RemittanceBackofficeTransaction, RemittanceBackofficeTxListResponse, RemittanceBackofficeUserDetail, RemittanceBackofficeUserListResponse, RemittanceBeneficiary, RemittanceCancelRequest, RemittanceCancelResponse, RemittanceHomeResponse, RemittanceListBeneficiariesResponse, RemittanceOnboardRequest, RemittanceOnboardResponse, RemittancePayRequest, RemittancePayResponse, RemittancePayerAdditionalFieldDto, RemittancePayerBranchDto, RemittancePayerDto, RemittanceQuoteRequest, RemittanceQuoteResponse, RemittanceSecurityQuestionsResponse, RemittanceSendPreviewRequest, RemittanceSendPreviewResponse, RemittanceSmsRequest, RemittanceStateDto, RemittanceTransactionDetail, RemittanceTransactionReceipt, RemittanceTransactionsListRequest, RemittanceTransactionsListResponse, RemittanceUpdateBeneficiaryRequest, RemittanceUserLimits, RemittanceUserLimitsBatchResponse } from "@fiado/type-kit/bin/remittance/index.js";
 export interface IUnitellerConnectorApi {
     /** Estado del módulo remesas para un directoryId. */
     getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>>;
@@ -38,9 +38,10 @@ export interface IUnitellerConnectorApi {
     }): Promise<ApiGatewayResponse<RemittancePayerAdditionalFieldDto[]>>;
     listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>>;
     getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{
+    /** `actor` opcional ("BACKOFFICE:<email>") cuando la operación no la hace el usuario; queda en createdBy/updatedBy. */
+    addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    deactivateBeneficiary(directoryId: string, beneficiaryId: string, actor?: string): Promise<ApiGatewayResponse<{
         deactivated: boolean;
         beneficiaryId: string;
     }>>;
@@ -122,6 +123,8 @@ export interface IUnitellerConnectorApi {
     /** Cierre manual de una cancelación: UPDATE a UniTeller + credit-back. */
     backofficeCloseCancellation(txNumber: string, request: RemittanceBackofficeCancelCloseRequest): Promise<ApiGatewayResponse<RemittanceBackofficeCancelCloseResponse>>;
     backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
+    /** Stats por rango explícito (from/to ISO) agrupando los días con el desfase del operador. GET /backoffice/stats. */
+    backofficeStatsRange(request: RemittanceBackofficeStatsRangeRequest): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
     /** Límites por usuario (Operación · read-only): ventanas (límite del provider + usage) + nivel + discrepancia. */
     backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>>;
     /** Batch de límites para la tabla de Límites (CSV de directoryIds). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.85.0",
+  "version": "5.86.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.435.0",
+    "@fiado/type-kit": "^3.441.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/benefits-marketplace/api/BenefitsMarketplaceApi.ts

@@ -3,6 +3,7 @@ import {inject, injectable} from "inversify";
 import {IHttpRequest} from "@fiado/http-client";
 import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
 import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+import {RemittanceOnboardingPrefillRequest, RemittanceOnboardingPrefillResponse} from "@fiado/type-kit/bin/remittance/index.js";
 import {BenefitLeafDisplayResponse} from "./dtos/BenefitLeafDisplayResponse.js";
 import {
     CreateFundingReferenceRequest,
@@ -56,4 +57,11 @@ export default class BenefitsMarketplaceApi implements IBenefitsMarketplaceApi {
         const url = `${this.baseUrl}/funding/${encodeURIComponent(moduleName)}/references?${params.toString()}`;
         return await this.httpRequest.get(url);
     }
+
+    async remittanceOnboardingPrefill(
+        request: RemittanceOnboardingPrefillRequest,
+    ): Promise<ApiGatewayResponse<RemittanceOnboardingPrefillResponse>> {
+        const url = `${this.baseUrl}/remittance/onboarding/prefill`;
+        return await this.httpRequest.post(url, request);
+    }
 }

package/src/benefits-marketplace/api/interfaces/IBenefitsMarketplaceApi.ts

@@ -1,5 +1,6 @@
 import {BenefitPaymentRequest, BenefitPaymentResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
 import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+import {RemittanceOnboardingPrefillRequest, RemittanceOnboardingPrefillResponse} from "@fiado/type-kit/bin/remittance/index.js";
 import {BenefitLeafDisplayResponse} from "../dtos/BenefitLeafDisplayResponse.js";
 import {
     CreateFundingReferenceRequest,
@@ -90,4 +91,14 @@ export interface IBenefitsMarketplaceApi {
         directoryId: string,
         status?: string,
     ): Promise<ApiGatewayResponse<ListFundingReferencesResponse>>;
+
+    /**
+     * Composición del onboarding de remesas de un usuario SIN ejecutarla: lo que la app
+     * mandaría hoy (datos de Fiado) o el motivo de bloqueo + direcciones candidatas.
+     * Backend: POST /remittance/onboarding/prefill (privado VPC). Lo consume remittance-business
+     * para el reintento de registro desde el backoffice.
+     */
+    remittanceOnboardingPrefill(
+        request: RemittanceOnboardingPrefillRequest,
+    ): Promise<ApiGatewayResponse<RemittanceOnboardingPrefillResponse>>;
 }

package/src/uniteller-connector/api/UnitellerConnectorApi.ts

@@ -24,6 +24,7 @@ import {
     RemittanceAddBeneficiaryRequest,
     RemittanceBackofficeDashboardSummary,
     RemittanceBackofficeStats,
+    RemittanceBackofficeStatsRangeRequest,
     RemittanceBackofficeStatsPeriod,
     RemittanceBackofficeCancelCloseRequest,
     RemittanceBackofficeCancelCloseResponse,
@@ -126,19 +127,19 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         return await this.httpRequest.post(url, { directoryId });
     }
 
-    async addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
+    async addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
         const url = `${this.baseUrl}/beneficiaries`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
+        return await this.httpRequest.post(url, { directoryId, ...request, ...(actor && { actor }) });
     }
 
-    async updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
+    async updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
         const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
-        return await this.httpRequest.put(url, { directoryId, ...request });
+        return await this.httpRequest.put(url, { directoryId, ...request, ...(actor && { actor }) });
     }
 
-    async deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>> {
+    async deactivateBeneficiary(directoryId: string, beneficiaryId: string, actor?: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>> {
         const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}/deactivate`;
-        return await this.httpRequest.post(url, { directoryId });
+        return await this.httpRequest.post(url, { directoryId, ...(actor && { actor }) });
     }
 
     async pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>> {
@@ -247,6 +248,15 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         return await this.httpRequest.get(url, { period });
     }
 
+    async backofficeStatsRange(request: RemittanceBackofficeStatsRangeRequest): Promise<ApiGatewayResponse<RemittanceBackofficeStats>> {
+        const url = `${this.baseUrl}/backoffice/stats`;
+        return await this.httpRequest.get(url, {
+            from: request.from,
+            to: request.to,
+            ...(request.tzOffsetMinutes !== undefined && { tzOffsetMinutes: String(request.tzOffsetMinutes) }),
+        });
+    }
+
     async backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>> {
         const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}/limits`;
         return await this.httpRequest.get(url);

package/src/uniteller-connector/api/interfaces/IUnitellerConnectorApi.ts

@@ -24,6 +24,7 @@ import {
     RemittanceAddBeneficiaryRequest,
     RemittanceBackofficeDashboardSummary,
     RemittanceBackofficeStats,
+    RemittanceBackofficeStatsRangeRequest,
     RemittanceBackofficeStatsPeriod,
     RemittanceBackofficeCancelCloseRequest,
     RemittanceBackofficeCancelCloseResponse,
@@ -108,9 +109,10 @@ export interface IUnitellerConnectorApi {
 
     listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>>;
     getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
-    deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>>;
+    /** `actor` opcional ("BACKOFFICE:<email>") cuando la operación no la hace el usuario; queda en createdBy/updatedBy. */
+    addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
+    deactivateBeneficiary(directoryId: string, beneficiaryId: string, actor?: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>>;
     /** Schedule de tramos de service fee + promo automática por corredor (F2 app; passthrough a remittance-business). POST /pricing/schedule. */
     pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
 
@@ -198,6 +200,8 @@ export interface IUnitellerConnectorApi {
     /** Cierre manual de una cancelación: UPDATE a UniTeller + credit-back. */
     backofficeCloseCancellation(txNumber: string, request: RemittanceBackofficeCancelCloseRequest): Promise<ApiGatewayResponse<RemittanceBackofficeCancelCloseResponse>>;
     backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
+    /** Stats por rango explícito (from/to ISO) agrupando los días con el desfase del operador. GET /backoffice/stats. */
+    backofficeStatsRange(request: RemittanceBackofficeStatsRangeRequest): Promise<ApiGatewayResponse<RemittanceBackofficeStats>>;
     /** Límites por usuario (Operación · read-only): ventanas (límite del provider + usage) + nivel + discrepancia. */
     backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>>;
     /** Batch de límites para la tabla de Límites (CSV de directoryIds). */