@fiado/api-invoker 5.139.0 → 5.141.0

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, 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, CreateCustomerReferralsRequest, CreateCustomerReferralsResponse, UpdateCustomerReferralRequest, UpdateCustomerReferralResponse, ListCustomerReferralsResponse, GetReferralsByPhoneQuery, ReferralsByPhoneResponse, GetCustomersByPhonesRequest, CustomersByPhonesResponse } 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";
@@ -32,4 +32,9 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
     upsertPromotionBonus(customerId: string, payload: UpsertPromotionBonusRequest, tenantId: string): Promise<StandardResponse<PromotionBonusEntryResponse>>;
     getCustomersBatch(payload: CustomersBatchRequest, tenantId: string): Promise<StandardResponse<CustomersBatchResponse>>;
     listCustomersPage(query: CustomersPageQuery, tenantId: string): Promise<StandardResponse<PaginatedResult<PrivateCustomerListItem>>>;
+    createCustomerReferrals(customerId: string, payload: CreateCustomerReferralsRequest, tenantId: string): Promise<StandardResponse<CreateCustomerReferralsResponse>>;
+    updateCustomerReferral(customerId: string, referralId: string, payload: UpdateCustomerReferralRequest, tenantId: string): Promise<StandardResponse<UpdateCustomerReferralResponse>>;
+    listCustomerReferrals(customerId: string, tenantId: string): Promise<StandardResponse<ListCustomerReferralsResponse>>;
+    getReferralsByPhone(query: GetReferralsByPhoneQuery, tenantId: string): Promise<StandardResponse<ReferralsByPhoneResponse>>;
+    getCustomersByPhones(payload: GetCustomersByPhonesRequest, tenantId: string): Promise<StandardResponse<CustomersByPhonesResponse>>;
 }

package/bin/retailCustomer/api/RetailCustomerBusinessApi.js

@@ -75,6 +75,27 @@ let RetailCustomerBusinessApi = class RetailCustomerBusinessApi {
         const url = `${this.baseUrl}/private/customers?${params.toString()}`;
         return await this.httpRequest.get(url);
     }
+    async createCustomerReferrals(customerId, payload, tenantId) {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/referrals?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, payload);
+    }
+    async updateCustomerReferral(customerId, referralId, payload, tenantId) {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/referrals/${encodeURIComponent(referralId)}?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.put(url, payload);
+    }
+    async listCustomerReferrals(customerId, tenantId) {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/referrals?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
+    async getReferralsByPhone(query, tenantId) {
+        // POST para que el teléfono no quede en la URL ni en los logs de API Gateway.
+        const url = `${this.baseUrl}/private/referrals/by-phone?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, query);
+    }
+    async getCustomersByPhones(payload, tenantId) {
+        const url = `${this.baseUrl}/private/customers/by-phones?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, payload);
+    }
 };
 RetailCustomerBusinessApi = __decorate([
     injectable(),

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

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { UpsertCustomerFromKycRequest, 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, CreateCustomerReferralsRequest, CreateCustomerReferralsResponse, UpdateCustomerReferralRequest, UpdateCustomerReferralResponse, ListCustomerReferralsResponse, GetReferralsByPhoneQuery, ReferralsByPhoneResponse, GetCustomersByPhonesRequest, CustomersByPhonesResponse } 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";
@@ -159,4 +159,20 @@ export interface IRetailCustomerBusinessApi {
      * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
      */
     listCustomersPage(query: CustomersPageQuery, tenantId: string): Promise<StandardResponse<PaginatedResult<PrivateCustomerListItem>>>;
+    /**
+     * `POST /private/customers/{id}/referrals` (`privateCreateCustomerReferrals`): lote de referidos del cliente.
+     * Rechaza con `DUPLICATE_REFERRAL_PHONE` si un teléfono ya está referido en la cadena.
+     */
+    createCustomerReferrals(customerId: string, payload: CreateCustomerReferralsRequest, tenantId: string): Promise<StandardResponse<CreateCustomerReferralsResponse>>;
+    /** `PUT /private/customers/{id}/referrals/{referralId}` (`privateUpdateCustomerReferral`): corrige nombre, teléfono o correo. */
+    updateCustomerReferral(customerId: string, referralId: string, payload: UpdateCustomerReferralRequest, tenantId: string): Promise<StandardResponse<UpdateCustomerReferralResponse>>;
+    /** `GET /private/customers/{id}/referrals` (`privateListCustomerReferrals`): referidos que capturó el cliente. */
+    listCustomerReferrals(customerId: string, tenantId: string): Promise<StandardResponse<ListCustomerReferralsResponse>>;
+    /**
+     * `POST /private/referrals/by-phone` (`privateGetReferralsByPhone`): quién recomendó el teléfono en la cadena
+     * antes de `before`, del más antiguo al más reciente. Es POST para que el teléfono no viaje en la URL.
+     */
+    getReferralsByPhone(query: GetReferralsByPhoneQuery, tenantId: string): Promise<StandardResponse<ReferralsByPhoneResponse>>;
+    /** `POST /private/customers/by-phones` (`privateGetCustomersByPhones`): qué teléfonos del lote ya son clientes. */
+    getCustomersByPhones(payload: GetCustomersByPhonesRequest, tenantId: string): Promise<StandardResponse<CustomersByPhonesResponse>>;
 }

package/bin/retailPromotions/api/RetailPromotionsBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { ActiveSalePromotionsBySkusRequest, ActiveSalePromotionsBySkusResponse, CheckSalePromotionPaymentRequest, PrivateSalePromotionPaymentCheckResponse, PrivateReleaseSalePromotionResponse, WelcomeBonusPromotionResponse } from "@fiado/type-kit/bin/retailPromotions/index.js";
+import type { ActiveSalePromotionsBySkusRequest, ActiveSalePromotionsBySkusResponse, CheckSalePromotionPaymentRequest, GetReferralRewardsByPhonesRequest, ReferralRewardsByPhonesResponse, PrivateSalePromotionPaymentCheckResponse, PrivateReleaseSalePromotionResponse, WelcomeBonusPromotionResponse } from "@fiado/type-kit/bin/retailPromotions/index.js";
 import { IRetailPromotionsBusinessApi } from "./interfaces/IRetailPromotionsBusinessApi.js";
 /** Publisher HTTP de los privados de `retail-promotions-business`. Contrato -> `IRetailPromotionsBusinessApi`. */
 export default class RetailPromotionsBusinessApi implements IRetailPromotionsBusinessApi {
@@ -11,4 +11,5 @@ export default class RetailPromotionsBusinessApi implements IRetailPromotionsBus
     checkSalePromotionPayment(tenantId: string, sessionId: string, input: CheckSalePromotionPaymentRequest): Promise<StandardResponse<PrivateSalePromotionPaymentCheckResponse>>;
     listActiveSalePromotionsBySkus(input: ActiveSalePromotionsBySkusRequest): Promise<StandardResponse<ActiveSalePromotionsBySkusResponse>>;
     getWelcomeBonus(retailerId: string): Promise<StandardResponse<WelcomeBonusPromotionResponse>>;
+    getReferralRewardsByPhones(tenantId: string, input: GetReferralRewardsByPhonesRequest): Promise<StandardResponse<ReferralRewardsByPhonesResponse>>;
 }

package/bin/retailPromotions/api/RetailPromotionsBusinessApi.js

@@ -35,6 +35,10 @@ let RetailPromotionsBusinessApi = class RetailPromotionsBusinessApi {
     async getWelcomeBonus(retailerId) {
         return await this.httpRequest.get(`${this.baseUrl}/private/retailers/${encodeURIComponent(retailerId)}/welcome-bonus`);
     }
+    async getReferralRewardsByPhones(tenantId, input) {
+        const query = new URLSearchParams({ tenantId });
+        return await this.httpRequest.post(`${this.baseUrl}/private/referral-rewards/by-phones?${query.toString()}`, input);
+    }
 };
 RetailPromotionsBusinessApi = __decorate([
     injectable(),

package/bin/retailPromotions/api/interfaces/IRetailPromotionsBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { ActiveSalePromotionsBySkusRequest, ActiveSalePromotionsBySkusResponse, CheckSalePromotionPaymentRequest, PrivateSalePromotionPaymentCheckResponse, PrivateReleaseSalePromotionResponse, WelcomeBonusPromotionResponse } from "@fiado/type-kit/bin/retailPromotions/index.js";
+import type { ActiveSalePromotionsBySkusRequest, ActiveSalePromotionsBySkusResponse, CheckSalePromotionPaymentRequest, GetReferralRewardsByPhonesRequest, ReferralRewardsByPhonesResponse, PrivateSalePromotionPaymentCheckResponse, PrivateReleaseSalePromotionResponse, WelcomeBonusPromotionResponse } from "@fiado/type-kit/bin/retailPromotions/index.js";
 export interface IRetailPromotionsBusinessApi {
     /**
      * `DELETE /private/sessions/{sessionId}/sale-promotion`: suelta el apartado de la promo de venta.
@@ -7,8 +7,9 @@ export interface IRetailPromotionsBusinessApi {
      */
     releaseSalePromotion(tenantId: string, sessionId: string): Promise<StandardResponse<PrivateReleaseSalePromotionResponse>>;
     /**
-     * `POST /private/sessions/{sessionId}/sale-promotion/payment-check`: antes del cobro de contado.
-     * 422 `PROMOTION_PAYMENT_NOT_ELIGIBLE` si alguna promo apartada no acepta el medio.
+     * `POST /private/sessions/{sessionId}/sale-promotion/payment-check`: antes del cobro de contado (con `method`)
+     * o del enganche y cierre a crédito (sin `method`, contra la forma de pago de la sesión).
+     * 422 `PROMOTION_PAYMENT_NOT_ELIGIBLE` si alguna promo apartada no la acepta.
      */
     checkSalePromotionPayment(tenantId: string, sessionId: string, input: CheckSalePromotionPaymentRequest): Promise<StandardResponse<PrivateSalePromotionPaymentCheckResponse>>;
     /**
@@ -21,4 +22,9 @@ export interface IRetailPromotionsBusinessApi {
      * Sin `tenantId`; la siembra si no existe. `active=false` = pausada, el wizard no paga bono.
      */
     getWelcomeBonus(retailerId: string): Promise<StandardResponse<WelcomeBonusPromotionResponse>>;
+    /**
+     * `POST /private/referral-rewards/by-phones`: premios de referido por cadena y lote de teléfonos, para el cajón.
+     * Un renglón por teléfono pedido; `rewards` vacío si no tiene.
+     */
+    getReferralRewardsByPhones(tenantId: string, input: GetReferralRewardsByPhonesRequest): Promise<StandardResponse<ReferralRewardsByPhonesResponse>>;
 }

package/bin/retailWizard/queue/RetailPromotionInboundPublisher.d.ts

@@ -1,6 +1,6 @@
-import type { RetailPromotionInboundMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
+import type { RetailPromotionQueueMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
 import { IRetailPromotionInboundPublisher } from "./interfaces/IRetailPromotionInboundPublisher.js";
 export declare class RetailPromotionInboundPublisher implements IRetailPromotionInboundPublisher {
     private readonly RETAIL_PROMOTION_INBOUND_QUEUE_URL;
-    publish(message: RetailPromotionInboundMessage): Promise<void>;
+    publish(message: RetailPromotionQueueMessage): Promise<void>;
 }

package/bin/retailWizard/queue/RetailPromotionInboundPublisher.js

@@ -11,7 +11,7 @@ let RetailPromotionInboundPublisher = class RetailPromotionInboundPublisher {
     async publish(message) {
         try {
             const client = new SQSClient();
-            // Cola estándar: sin MessageGroupId; el consumidor deduplica por venta.
+            // Cola estándar: sin MessageGroupId; el consumidor deduplica por evento.
             const sendMessageRequest = {
                 QueueUrl: this.RETAIL_PROMOTION_INBOUND_QUEUE_URL,
                 MessageBody: JSON.stringify(message),

package/bin/retailWizard/queue/interfaces/IRetailPromotionInboundPublisher.d.ts

@@ -1,8 +1,8 @@
-import type { RetailPromotionInboundMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
+import type { RetailPromotionQueueMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
 /**
- * Publisher hacia `RetailPromotionInboundQueue` (SALE_CONFIRMED | SALE_CANCELLED), que consume `retail-promotions`.
+ * Publisher hacia `RetailPromotionInboundQueue`, que consume `retail-promotions`: venta, ACCOUNT_OPENED o CREDIT_INSTALLMENT_PAID.
  * Env var requerida en el productor: `RETAIL_PROMOTION_INBOUND_QUEUE_URL`.
  */
 export interface IRetailPromotionInboundPublisher {
-    publish(message: RetailPromotionInboundMessage): Promise<void>;
+    publish(message: RetailPromotionQueueMessage): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.139.0",
+  "version": "5.141.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",

package/src/retailCustomer/api/RetailCustomerBusinessApi.ts

@@ -11,6 +11,15 @@ import {
     WelcomeAccreditationResponse,
     WelcomeAccreditationResultRequest,
     WelcomeBonusResponse,
+    CreateCustomerReferralsRequest,
+    CreateCustomerReferralsResponse,
+    UpdateCustomerReferralRequest,
+    UpdateCustomerReferralResponse,
+    ListCustomerReferralsResponse,
+    GetReferralsByPhoneQuery,
+    ReferralsByPhoneResponse,
+    GetCustomersByPhonesRequest,
+    CustomersByPhonesResponse,
 } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { CustomersBatchRequest, CustomersBatchResponse } from "./dtos/CustomersBatch.js";
 import { CustomersPageQuery, PrivateCustomerListItem } from "./dtos/CustomersPage.js";
@@ -118,4 +127,48 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
         const url = `${this.baseUrl}/private/customers?${params.toString()}`;
         return await this.httpRequest.get(url);
     }
+
+    async createCustomerReferrals(
+        customerId: string,
+        payload: CreateCustomerReferralsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CreateCustomerReferralsResponse>> {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/referrals?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, payload);
+    }
+
+    async updateCustomerReferral(
+        customerId: string,
+        referralId: string,
+        payload: UpdateCustomerReferralRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<UpdateCustomerReferralResponse>> {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/referrals/${encodeURIComponent(referralId)}?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.put(url, payload);
+    }
+
+    async listCustomerReferrals(
+        customerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<ListCustomerReferralsResponse>> {
+        const url = `${this.baseUrl}/private/customers/${encodeURIComponent(customerId)}/referrals?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getReferralsByPhone(
+        query: GetReferralsByPhoneQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<ReferralsByPhoneResponse>> {
+        // POST para que el teléfono no quede en la URL ni en los logs de API Gateway.
+        const url = `${this.baseUrl}/private/referrals/by-phone?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, query);
+    }
+
+    async getCustomersByPhones(
+        payload: GetCustomersByPhonesRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CustomersByPhonesResponse>> {
+        const url = `${this.baseUrl}/private/customers/by-phones?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, payload);
+    }
 }

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

@@ -9,6 +9,15 @@ import {
     WelcomeAccreditationResponse,
     WelcomeAccreditationResultRequest,
     WelcomeBonusResponse,
+    CreateCustomerReferralsRequest,
+    CreateCustomerReferralsResponse,
+    UpdateCustomerReferralRequest,
+    UpdateCustomerReferralResponse,
+    ListCustomerReferralsResponse,
+    GetReferralsByPhoneQuery,
+    ReferralsByPhoneResponse,
+    GetCustomersByPhonesRequest,
+    CustomersByPhonesResponse,
 } from "@fiado/type-kit/bin/retailCustomer/index.js";
 import { CustomersBatchRequest, CustomersBatchResponse } from "../dtos/CustomersBatch.js";
 import { CustomersPageQuery, PrivateCustomerListItem } from "../dtos/CustomersPage.js";
@@ -209,4 +218,43 @@ export interface IRetailCustomerBusinessApi {
         query: CustomersPageQuery,
         tenantId: string,
     ): Promise<StandardResponse<PaginatedResult<PrivateCustomerListItem>>>;
+
+    /**
+     * `POST /private/customers/{id}/referrals` (`privateCreateCustomerReferrals`): lote de referidos del cliente.
+     * Rechaza con `DUPLICATE_REFERRAL_PHONE` si un teléfono ya está referido en la cadena.
+     */
+    createCustomerReferrals(
+        customerId: string,
+        payload: CreateCustomerReferralsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CreateCustomerReferralsResponse>>;
+
+    /** `PUT /private/customers/{id}/referrals/{referralId}` (`privateUpdateCustomerReferral`): corrige nombre, teléfono o correo. */
+    updateCustomerReferral(
+        customerId: string,
+        referralId: string,
+        payload: UpdateCustomerReferralRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<UpdateCustomerReferralResponse>>;
+
+    /** `GET /private/customers/{id}/referrals` (`privateListCustomerReferrals`): referidos que capturó el cliente. */
+    listCustomerReferrals(
+        customerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<ListCustomerReferralsResponse>>;
+
+    /**
+     * `POST /private/referrals/by-phone` (`privateGetReferralsByPhone`): quién recomendó el teléfono en la cadena
+     * antes de `before`, del más antiguo al más reciente. Es POST para que el teléfono no viaje en la URL.
+     */
+    getReferralsByPhone(
+        query: GetReferralsByPhoneQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<ReferralsByPhoneResponse>>;
+
+    /** `POST /private/customers/by-phones` (`privateGetCustomersByPhones`): qué teléfonos del lote ya son clientes. */
+    getCustomersByPhones(
+        payload: GetCustomersByPhonesRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CustomersByPhonesResponse>>;
 }

package/src/retailPromotions/api/RetailPromotionsBusinessApi.ts

@@ -5,6 +5,8 @@ import type {
     ActiveSalePromotionsBySkusRequest,
     ActiveSalePromotionsBySkusResponse,
     CheckSalePromotionPaymentRequest,
+    GetReferralRewardsByPhonesRequest,
+    ReferralRewardsByPhonesResponse,
     PrivateSalePromotionPaymentCheckResponse,
     PrivateReleaseSalePromotionResponse,
     WelcomeBonusPromotionResponse,
@@ -47,4 +49,12 @@ export default class RetailPromotionsBusinessApi implements IRetailPromotionsBus
     async getWelcomeBonus(retailerId: string): Promise<StandardResponse<WelcomeBonusPromotionResponse>> {
         return await this.httpRequest.get(`${this.baseUrl}/private/retailers/${encodeURIComponent(retailerId)}/welcome-bonus`);
     }
+
+    async getReferralRewardsByPhones(
+        tenantId: string,
+        input: GetReferralRewardsByPhonesRequest,
+    ): Promise<StandardResponse<ReferralRewardsByPhonesResponse>> {
+        const query = new URLSearchParams({ tenantId });
+        return await this.httpRequest.post(`${this.baseUrl}/private/referral-rewards/by-phones?${query.toString()}`, input);
+    }
 }

package/src/retailPromotions/api/interfaces/IRetailPromotionsBusinessApi.ts

@@ -3,6 +3,8 @@ import type {
     ActiveSalePromotionsBySkusRequest,
     ActiveSalePromotionsBySkusResponse,
     CheckSalePromotionPaymentRequest,
+    GetReferralRewardsByPhonesRequest,
+    ReferralRewardsByPhonesResponse,
     PrivateSalePromotionPaymentCheckResponse,
     PrivateReleaseSalePromotionResponse,
     WelcomeBonusPromotionResponse,
@@ -21,8 +23,9 @@ export interface IRetailPromotionsBusinessApi {
     ): Promise<StandardResponse<PrivateReleaseSalePromotionResponse>>;
 
     /**
-     * `POST /private/sessions/{sessionId}/sale-promotion/payment-check`: antes del cobro de contado.
-     * 422 `PROMOTION_PAYMENT_NOT_ELIGIBLE` si alguna promo apartada no acepta el medio.
+     * `POST /private/sessions/{sessionId}/sale-promotion/payment-check`: antes del cobro de contado (con `method`)
+     * o del enganche y cierre a crédito (sin `method`, contra la forma de pago de la sesión).
+     * 422 `PROMOTION_PAYMENT_NOT_ELIGIBLE` si alguna promo apartada no la acepta.
      */
     checkSalePromotionPayment(
         tenantId: string,
@@ -43,4 +46,13 @@ export interface IRetailPromotionsBusinessApi {
      * Sin `tenantId`; la siembra si no existe. `active=false` = pausada, el wizard no paga bono.
      */
     getWelcomeBonus(retailerId: string): Promise<StandardResponse<WelcomeBonusPromotionResponse>>;
+
+    /**
+     * `POST /private/referral-rewards/by-phones`: premios de referido por cadena y lote de teléfonos, para el cajón.
+     * Un renglón por teléfono pedido; `rewards` vacío si no tiene.
+     */
+    getReferralRewardsByPhones(
+        tenantId: string,
+        input: GetReferralRewardsByPhonesRequest,
+    ): Promise<StandardResponse<ReferralRewardsByPhonesResponse>>;
 }

package/src/retailWizard/queue/RetailPromotionInboundPublisher.ts

@@ -1,16 +1,16 @@
 import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
 import { injectable } from "inversify";
-import type { RetailPromotionInboundMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
+import type { RetailPromotionQueueMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
 import { IRetailPromotionInboundPublisher } from "./interfaces/IRetailPromotionInboundPublisher.js";
 
 @injectable()
 export class RetailPromotionInboundPublisher implements IRetailPromotionInboundPublisher {
     private readonly RETAIL_PROMOTION_INBOUND_QUEUE_URL = process.env.RETAIL_PROMOTION_INBOUND_QUEUE_URL;
 
-    async publish(message: RetailPromotionInboundMessage): Promise<void> {
+    async publish(message: RetailPromotionQueueMessage): Promise<void> {
         try {
             const client: SQSClient = new SQSClient();
-            // Cola estándar: sin MessageGroupId; el consumidor deduplica por venta.
+            // Cola estándar: sin MessageGroupId; el consumidor deduplica por evento.
             const sendMessageRequest: SendMessageRequest = {
                 QueueUrl: this.RETAIL_PROMOTION_INBOUND_QUEUE_URL,
                 MessageBody: JSON.stringify(message),

package/src/retailWizard/queue/interfaces/IRetailPromotionInboundPublisher.ts

@@ -1,9 +1,9 @@
-import type { RetailPromotionInboundMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
+import type { RetailPromotionQueueMessage } from "@fiado/type-kit/bin/retailWizard/index.js";
 
 /**
- * Publisher hacia `RetailPromotionInboundQueue` (SALE_CONFIRMED | SALE_CANCELLED), que consume `retail-promotions`.
+ * Publisher hacia `RetailPromotionInboundQueue`, que consume `retail-promotions`: venta, ACCOUNT_OPENED o CREDIT_INSTALLMENT_PAID.
  * Env var requerida en el productor: `RETAIL_PROMOTION_INBOUND_QUEUE_URL`.
  */
 export interface IRetailPromotionInboundPublisher {
-    publish(message: RetailPromotionInboundMessage): Promise<void>;
+    publish(message: RetailPromotionQueueMessage): Promise<void>;
 }