@fiado/api-invoker 5.134.0 → 5.136.0

package/bin/retailCommission/RetailCommissionBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import type { StandardResponse } from "@fiado/gateway-adapter";
-import type { PrivateLatestClosedPayoutResponse } from "@fiado/type-kit/bin/retailCommission/index.js";
+import type { PrivateLatestClosedPayoutResponse, PrivateTriggerSellerPaymentResponse } from "@fiado/type-kit/bin/retailCommission/index.js";
 import type { IRetailCommissionBusinessApi } from "./interfaces/IRetailCommissionBusinessApi.js";
 /** Publisher HTTP de `retail-commission-business`. Contrato → `IRetailCommissionBusinessApi`. */
 export declare class RetailCommissionBusinessApi implements IRetailCommissionBusinessApi {
@@ -9,4 +9,5 @@ export declare class RetailCommissionBusinessApi implements IRetailCommissionBus
     /** La URL del SSM termina en `/v1/`; se quita la barra final para no duplicarla. */
     private get baseUrl();
     getLatestClosedPayout(retailerId: string, tenantId: string): Promise<StandardResponse<PrivateLatestClosedPayoutResponse>>;
+    triggerSellerPayment(retailerId: string, sellerId: string, tenantId: string): Promise<StandardResponse<PrivateTriggerSellerPaymentResponse>>;
 }

package/bin/retailCommission/RetailCommissionBusinessApi.js

@@ -26,6 +26,11 @@ let RetailCommissionBusinessApi = class RetailCommissionBusinessApi {
         const query = new URLSearchParams({ tenantId });
         return await this.httpRequest.get(`${this.baseUrl}${path}?${query.toString()}`);
     }
+    async triggerSellerPayment(retailerId, sellerId, tenantId) {
+        const path = `/private/retailers/${encodeURIComponent(retailerId)}/sellers/${encodeURIComponent(sellerId)}/payments/trigger`;
+        const query = new URLSearchParams({ tenantId });
+        return await this.httpRequest.post(`${this.baseUrl}${path}?${query.toString()}`, {});
+    }
 };
 RetailCommissionBusinessApi = __decorate([
     injectable(),

package/bin/retailCommission/interfaces/IRetailCommissionBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import type { StandardResponse } from "@fiado/gateway-adapter";
-import type { PrivateLatestClosedPayoutResponse } from "@fiado/type-kit/bin/retailCommission/index.js";
+import type { PrivateLatestClosedPayoutResponse, PrivateTriggerSellerPaymentResponse } from "@fiado/type-kit/bin/retailCommission/index.js";
 /**
  * Publisher de los endpoints privados de `retail-commission-business` (motor de comisiones de
  * VentasLuga). No confundir con `commission-business`, que es otro servicio.
@@ -13,4 +13,10 @@ export interface IRetailCommissionBusinessApi {
      * de la cadena, con lo que le pagó a cada vendedor. Sin corte cerrado reciente: `period: null`.
      */
     getLatestClosedPayout(retailerId: string, tenantId: string): Promise<StandardResponse<PrivateLatestClosedPayoutResponse>>;
+    /**
+     * `POST /private/retailers/{retailerId}/sellers/{sellerId}/payments/trigger` — pide al motor
+     * intentar pagar el saldo pendiente del vendedor. Lo usa retail-org al vincular una wallet.
+     * Va con cuerpo vacío (`{}`) y responde 202 `{ enqueued }`; rechaza si el motor responde con error.
+     */
+    triggerSellerPayment(retailerId: string, sellerId: string, tenantId: string): Promise<StandardResponse<PrivateTriggerSellerPaymentResponse>>;
 }

package/bin/retailCustomer/api/RetailCustomerBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, EnsureCustomerByPhoneRequest, EnsureCustomerByPhoneResponse, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
+import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { CustomersBatchRequest, CustomersBatchResponse } from "./dtos/CustomersBatch.js";
 import { CustomersPageQuery, PrivateCustomerListItem } from "./dtos/CustomersPage.js";
 import { PaginatedResult } from "@fiado/type-kit/bin/retailOrg/index.js";
@@ -24,7 +24,6 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     upsertCustomerFromKyc(payload: UpsertCustomerFromKycRequest, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
-    ensureCustomerByPhone(payload: EnsureCustomerByPhoneRequest, tenantId: string): Promise<StandardResponse<EnsureCustomerByPhoneResponse>>;
     setAccountResult(customerId: string, payload: AccountResultRequest, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
     getCustomerByPhone(phone: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
     getCustomer(customerId: string, tenantId: string): Promise<StandardResponse<CustomerResponse>>;

package/bin/retailCustomer/api/RetailCustomerBusinessApi.js

@@ -35,10 +35,6 @@ let RetailCustomerBusinessApi = class RetailCustomerBusinessApi {
         const url = `${this.baseUrl}/private/customers/upsert-from-kyc?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, payload);
     }
-    async ensureCustomerByPhone(payload, tenantId) {
-        const url = `${this.baseUrl}/private/customers/ensure-by-phone?tenantId=${encodeURIComponent(tenantId)}`;
-        return await this.httpRequest.post(url, payload);
-    }
     async setAccountResult(customerId, payload, tenantId) {
         const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/account-result?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.put(url, payload);

package/bin/retailCustomer/api/interfaces/IRetailCustomerBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, EnsureCustomerByPhoneRequest, EnsureCustomerByPhoneResponse, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
+import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, PromotionBonusEntryResponse, UpsertPromotionBonusRequest, WelcomeAccreditationRequest, WelcomeAccreditationResponse, WelcomeAccreditationResultRequest, WelcomeBonusResponse } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { CustomersBatchRequest, CustomersBatchResponse } from "../dtos/CustomersBatch.js";
 import { CustomersPageQuery, PrivateCustomerListItem } from "../dtos/CustomersPage.js";
 import { PaginatedResult } from "@fiado/type-kit/bin/retailOrg/index.js";
@@ -54,15 +54,6 @@ export interface IRetailCustomerBusinessApi {
      * aditivo al type-kit (backlog) — no acá.
      */
     upsertCustomerFromKyc(payload: UpsertCustomerFromKycRequest, tenantId: string): Promise<StandardResponse<CustomerResponse>>;
-    /**
-     * POST /private/customers/ensure-by-phone?tenantId= — devuelve el cliente de ese celular o lo da
-     * de alta solo con el celular (ya verificado por OTP). Idempotente: dos llamadas con el mismo
-     * número devuelven el mismo cliente. `created=true` solo cuando esta llamada lo dio de alta.
-     *
-     * @throws `422 CUSTOMER_INACTIVE` si el número es de un cliente dado de baja.
-     * @throws `400 VALIDATION_ERROR` si el celular no trae 10 dígitos o falta la tienda.
-     */
-    ensureCustomerByPhone(payload: EnsureCustomerByPhoneRequest, tenantId: string): Promise<StandardResponse<EnsureCustomerByPhoneResponse>>;
     /**
      * PUT /private/customers/{customerId}/account-result?tenantId= — aterriza el resultado terminal de
      * la apertura de cuenta async (D35). Solo acepta OPEN/FAILED (nunca el intermedio OPENING). OPEN

package/bin/retailOrg/api/RetailOrgBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { RetailerValidationDto, StoreValidationDto, RetailUserValidationDto, CollectorValidationDto, PrivateSellerListResponse, PrivateGoalListResponse, GoalTargetTypeEnum, RetailUserStatusEnum } from "@fiado/type-kit/bin/retailOrg/index.js";
+import { RetailerValidationDto, StoreValidationDto, RetailUserValidationDto, CollectorValidationDto, PrivateSellerListResponse, PrivateGoalListResponse, GoalTargetTypeEnum, RetailUserStatusEnum, PrivateRetailUserWalletResponse } from "@fiado/type-kit/bin/retailOrg/index.js";
 import type { ApplyRetailUserEventRequest, ApplyRetailUserEventResponse, ApplyStoreEventRequest, ApplyStoreEventResponse } from "@fiado/type-kit/bin/retailIntegration/index.js";
 import { IRetailOrgBusinessApi, RetailerRosterStatusFilter, StoreRosterStatusFilter } from "./interfaces/IRetailOrgBusinessApi.js";
 /**
@@ -52,6 +52,8 @@ export default class RetailOrgBusinessApi implements IRetailOrgBusinessApi {
     listSellers(retailerId: string, tenantId: string, callerService: string, status?: RetailUserStatusEnum, includePhone?: boolean): Promise<StandardResponse<PrivateSellerListResponse>>;
     /** Metas del periodo de una cadena. Contrato → `IRetailOrgBusinessApi.listGoals`. */
     listGoals(retailerId: string, tenantId: string, periodId: string, targetType?: GoalTargetTypeEnum): Promise<StandardResponse<PrivateGoalListResponse>>;
+    /** Wallet PCF del vendedor para el motor. Contrato → `IRetailOrgBusinessApi.getRetailUserWallet`. */
+    getRetailUserWallet(retailerId: string, retailUserId: string, tenantId: string): Promise<StandardResponse<PrivateRetailUserWalletResponse>>;
     privateApplyStoreEvent(request: ApplyStoreEventRequest): Promise<StandardResponse<ApplyStoreEventResponse>>;
     privateApplyRetailUserEvent(request: ApplyRetailUserEventRequest): Promise<StandardResponse<ApplyRetailUserEventResponse>>;
     private applyRetailEvent;

package/bin/retailOrg/api/RetailOrgBusinessApi.js

@@ -110,6 +110,14 @@ let RetailOrgBusinessApi = class RetailOrgBusinessApi {
         const path = `/private/retailers/${encodeURIComponent(retailerId)}/goals`;
         return await this.httpRequest.get(`${this.baseUrl}${path}?${query.toString()}`);
     }
+    /** Wallet PCF del vendedor para el motor. Contrato → `IRetailOrgBusinessApi.getRetailUserWallet`. */
+    async getRetailUserWallet(retailerId, retailUserId, tenantId) {
+        // La URL del SSM termina en "/"; se quita para no duplicarla.
+        const base = this.baseUrl.replace(/\/+$/, "");
+        const path = `/private/retailers/${encodeURIComponent(retailerId)}/users/${encodeURIComponent(retailUserId)}/wallet`;
+        const query = new URLSearchParams({ tenantId });
+        return await this.httpRequest.get(`${base}${path}?${query.toString()}`);
+    }
     async privateApplyStoreEvent(request) {
         return await this.applyRetailEvent("/private/integration/store-events", request);
     }

package/bin/retailOrg/api/interfaces/IRetailOrgBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { RetailerValidationDto, StoreValidationDto, RetailUserValidationDto, CollectorValidationDto, PrivateSellerListResponse, PrivateGoalListResponse, GoalTargetTypeEnum, RetailUserStatusEnum, RetailerStatusEnum, StoreStatusEnum } from "@fiado/type-kit/bin/retailOrg/index.js";
+import { RetailerValidationDto, StoreValidationDto, RetailUserValidationDto, CollectorValidationDto, PrivateSellerListResponse, PrivateGoalListResponse, GoalTargetTypeEnum, RetailUserStatusEnum, RetailerStatusEnum, StoreStatusEnum, PrivateRetailUserWalletResponse } from "@fiado/type-kit/bin/retailOrg/index.js";
 import type { ApplyRetailUserEventRequest, ApplyRetailUserEventResponse, ApplyStoreEventRequest, ApplyStoreEventResponse } from "@fiado/type-kit/bin/retailIntegration/index.js";
 /**
  * Filtro de `listStoresByRetailer`. `"ALL"` no es un estado de tienda: es la ausencia de filtro, y
@@ -228,6 +228,15 @@ export interface IRetailOrgBusinessApi {
      * @throws `400 VALIDATION_ERROR` con un periodo o tipo inválido · `400 UNKNOWN_TENANT` sin tenant.
      */
     listGoals(retailerId: string, tenantId: string, periodId: string, targetType?: GoalTargetTypeEnum): Promise<StandardResponse<PrivateGoalListResponse>>;
+    /**
+     * `GET /private/retailers/{retailerId}/users/{retailUserId}/wallet` — la wallet PCF del vendedor
+     * para el motor de comisiones. `directoryId` y `pcfAccountId` vienen en `null` si no tiene; la
+     * CLABE no viaja.
+     *
+     * @throws `404 RETAIL_USER_NOT_FOUND` si el vendedor no existe o es de otra cadena ·
+     *   `400 UNKNOWN_TENANT` sin `tenantId`.
+     */
+    getRetailUserWallet(retailerId: string, retailUserId: string, tenantId: string): Promise<StandardResponse<PrivateRetailUserWalletResponse>>;
     /** `POST /private/integration/store-events?tenantId=` — aplica un evento de tienda del retailer. */
     privateApplyStoreEvent(request: ApplyStoreEventRequest): Promise<StandardResponse<ApplyStoreEventResponse>>;
     /** `POST /private/integration/retail-user-events?tenantId=` — aplica un evento de usuario del retailer. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.134.0",
+  "version": "5.136.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.14.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.550.0",
+    "@fiado/type-kit": "^3.551.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/retailCommission/RetailCommissionBusinessApi.ts

@@ -1,7 +1,10 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import type { StandardResponse } from "@fiado/gateway-adapter";
-import type { PrivateLatestClosedPayoutResponse } from "@fiado/type-kit/bin/retailCommission/index.js";
+import type {
+    PrivateLatestClosedPayoutResponse,
+    PrivateTriggerSellerPaymentResponse,
+} from "@fiado/type-kit/bin/retailCommission/index.js";
 import type { IRetailCommissionBusinessApi } from "./interfaces/IRetailCommissionBusinessApi.js";
 
 /** Publisher HTTP de `retail-commission-business`. Contrato → `IRetailCommissionBusinessApi`. */
@@ -22,4 +25,14 @@ export class RetailCommissionBusinessApi implements IRetailCommissionBusinessApi
         const query = new URLSearchParams({ tenantId });
         return await this.httpRequest.get(`${this.baseUrl}${path}?${query.toString()}`);
     }
+
+    async triggerSellerPayment(
+        retailerId: string,
+        sellerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<PrivateTriggerSellerPaymentResponse>> {
+        const path = `/private/retailers/${encodeURIComponent(retailerId)}/sellers/${encodeURIComponent(sellerId)}/payments/trigger`;
+        const query = new URLSearchParams({ tenantId });
+        return await this.httpRequest.post(`${this.baseUrl}${path}?${query.toString()}`, {});
+    }
 }

package/src/retailCommission/interfaces/IRetailCommissionBusinessApi.ts

@@ -1,5 +1,8 @@
 import type { StandardResponse } from "@fiado/gateway-adapter";
-import type { PrivateLatestClosedPayoutResponse } from "@fiado/type-kit/bin/retailCommission/index.js";
+import type {
+    PrivateLatestClosedPayoutResponse,
+    PrivateTriggerSellerPaymentResponse,
+} from "@fiado/type-kit/bin/retailCommission/index.js";
 
 /**
  * Publisher de los endpoints privados de `retail-commission-business` (motor de comisiones de
@@ -17,4 +20,15 @@ export interface IRetailCommissionBusinessApi {
         retailerId: string,
         tenantId: string,
     ): Promise<StandardResponse<PrivateLatestClosedPayoutResponse>>;
+
+    /**
+     * `POST /private/retailers/{retailerId}/sellers/{sellerId}/payments/trigger` — pide al motor
+     * intentar pagar el saldo pendiente del vendedor. Lo usa retail-org al vincular una wallet.
+     * Va con cuerpo vacío (`{}`) y responde 202 `{ enqueued }`; rechaza si el motor responde con error.
+     */
+    triggerSellerPayment(
+        retailerId: string,
+        sellerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<PrivateTriggerSellerPaymentResponse>>;
 }

package/src/retailCustomer/api/RetailCustomerBusinessApi.ts

@@ -3,8 +3,6 @@ import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     UpsertCustomerFromKycRequest,
-    EnsureCustomerByPhoneRequest,
-    EnsureCustomerByPhoneResponse,
     AccountResultRequest,
     CustomerResponse,
     PromotionBonusEntryResponse,
@@ -47,14 +45,6 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
         return await this.httpRequest.post(url, payload);
     }
 
-    async ensureCustomerByPhone(
-        payload: EnsureCustomerByPhoneRequest,
-        tenantId: string,
-    ): Promise<StandardResponse<EnsureCustomerByPhoneResponse>> {
-        const url = `${this.baseUrl}/private/customers/ensure-by-phone?tenantId=${encodeURIComponent(tenantId)}`;
-        return await this.httpRequest.post(url, payload);
-    }
-
     async setAccountResult(
         customerId: string,
         payload: AccountResultRequest,

package/src/retailCustomer/api/interfaces/IRetailCustomerBusinessApi.ts

@@ -1,8 +1,6 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
     UpsertCustomerFromKycRequest,
-    EnsureCustomerByPhoneRequest,
-    EnsureCustomerByPhoneResponse,
     AccountResultRequest,
     CustomerResponse,
     PromotionBonusEntryResponse,
@@ -71,19 +69,6 @@ export interface IRetailCustomerBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<CustomerResponse>>;
 
-    /**
-     * POST /private/customers/ensure-by-phone?tenantId= — devuelve el cliente de ese celular o lo da
-     * de alta solo con el celular (ya verificado por OTP). Idempotente: dos llamadas con el mismo
-     * número devuelven el mismo cliente. `created=true` solo cuando esta llamada lo dio de alta.
-     *
-     * @throws `422 CUSTOMER_INACTIVE` si el número es de un cliente dado de baja.
-     * @throws `400 VALIDATION_ERROR` si el celular no trae 10 dígitos o falta la tienda.
-     */
-    ensureCustomerByPhone(
-        payload: EnsureCustomerByPhoneRequest,
-        tenantId: string,
-    ): Promise<StandardResponse<EnsureCustomerByPhoneResponse>>;
-
     /**
      * PUT /private/customers/{customerId}/account-result?tenantId= — aterriza el resultado terminal de
      * la apertura de cuenta async (D35). Solo acepta OPEN/FAILED (nunca el intermedio OPENING). OPEN

package/src/retailOrg/api/RetailOrgBusinessApi.ts

@@ -10,6 +10,7 @@ import {
     PrivateGoalListResponse,
     GoalTargetTypeEnum,
     RetailUserStatusEnum,
+    PrivateRetailUserWalletResponse,
 } from "@fiado/type-kit/bin/retailOrg/index.js";
 import type {
     ApplyRetailEventRequest,
@@ -167,6 +168,19 @@ export default class RetailOrgBusinessApi implements IRetailOrgBusinessApi {
         return await this.httpRequest.get(`${this.baseUrl}${path}?${query.toString()}`);
     }
 
+    /** Wallet PCF del vendedor para el motor. Contrato → `IRetailOrgBusinessApi.getRetailUserWallet`. */
+    async getRetailUserWallet(
+        retailerId: string,
+        retailUserId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<PrivateRetailUserWalletResponse>> {
+        // La URL del SSM termina en "/"; se quita para no duplicarla.
+        const base = this.baseUrl.replace(/\/+$/, "");
+        const path = `/private/retailers/${encodeURIComponent(retailerId)}/users/${encodeURIComponent(retailUserId)}/wallet`;
+        const query = new URLSearchParams({ tenantId });
+        return await this.httpRequest.get(`${base}${path}?${query.toString()}`);
+    }
+
     async privateApplyStoreEvent(request: ApplyStoreEventRequest): Promise<StandardResponse<ApplyStoreEventResponse>> {
         return await this.applyRetailEvent("/private/integration/store-events", request);
     }

package/src/retailOrg/api/interfaces/IRetailOrgBusinessApi.ts

@@ -10,6 +10,7 @@ import {
     RetailUserStatusEnum,
     RetailerStatusEnum,
     StoreStatusEnum,
+    PrivateRetailUserWalletResponse,
 } from "@fiado/type-kit/bin/retailOrg/index.js";
 import type {
     ApplyRetailUserEventRequest,
@@ -295,6 +296,20 @@ export interface IRetailOrgBusinessApi {
         targetType?: GoalTargetTypeEnum,
     ): Promise<StandardResponse<PrivateGoalListResponse>>;
 
+    /**
+     * `GET /private/retailers/{retailerId}/users/{retailUserId}/wallet` — la wallet PCF del vendedor
+     * para el motor de comisiones. `directoryId` y `pcfAccountId` vienen en `null` si no tiene; la
+     * CLABE no viaja.
+     *
+     * @throws `404 RETAIL_USER_NOT_FOUND` si el vendedor no existe o es de otra cadena ·
+     *   `400 UNKNOWN_TENANT` sin `tenantId`.
+     */
+    getRetailUserWallet(
+        retailerId: string,
+        retailUserId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<PrivateRetailUserWalletResponse>>;
+
     /** `POST /private/integration/store-events?tenantId=` — aplica un evento de tienda del retailer. */
     privateApplyStoreEvent(request: ApplyStoreEventRequest): Promise<StandardResponse<ApplyStoreEventResponse>>;