@fiado/api-invoker 5.62.0 → 5.64.0

package/bin/loanCredit/api/LoanCreditBusinessApi.d.ts

@@ -2,6 +2,7 @@ import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { ActivationCheckRequest, ActivationCheckResponse, LoanBorrowerResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
+import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import { ILoanCreditBusinessApi } from "./interfaces/ILoanCreditBusinessApi.js";
 /**
  * Publisher HTTP del lambda `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito).
@@ -26,6 +27,7 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     discard(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     getBorrowerByRetailCustomer(retailCustomerId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+    getCustomerCreditHistory(retailCustomerId: string, tenantId: string): Promise<StandardResponse<CustomerCreditHistoryResponse>>;
     batchGetCreditAnalytics(input: LoanCreditAnalyticsBatchRequest, tenantId: string): Promise<StandardResponse<LoanCreditAnalyticsBatchResponse>>;
     upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
 }

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -58,6 +58,10 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/borrowers/by-retail-customer/${encodeURIComponent(retailCustomerId)}?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);
     }
+    async getCustomerCreditHistory(retailCustomerId, tenantId) {
+        const url = `${this.baseUrl}/private/borrowers/by-retail-customer/${encodeURIComponent(retailCustomerId)}/credit-history?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
     async batchGetCreditAnalytics(input, tenantId) {
         const url = `${this.baseUrl}/private/credits/analytics?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);

package/bin/loanCredit/api/dtos/CustomerCreditHistory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Respuesta de `GET /private/borrowers/by-retail-customer/{retailCustomerId}/credit-history`.
+ * Historial crediticio agregado del acreditado. CERO PII — solo la FK al cliente retail y cifras.
+ */
+export interface CustomerCreditHistoryResponse {
+    retailCustomerId: string;
+    /**
+     * Peor atraso VIGENTE, en días, entre las cuotas vencidas en los últimos 180 días.
+     * `null` = el acreditado no tiene ninguna cuota fechada en la ventana (hecho ausente);
+     * `0` = tiene cuotas en la ventana y ninguna vencida impaga. NO son lo mismo.
+     */
+    delinquencyDaysLast6M: number | null;
+}

package/bin/loanCredit/api/dtos/CustomerCreditHistory.js

@@ -0,0 +1 @@
+export {};

package/bin/loanCredit/api/interfaces/ILoanCreditBusinessApi.d.ts

@@ -1,6 +1,7 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { ActivationCheckRequest, ActivationCheckResponse, LoanBorrowerResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
+import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 /**
  * Contrato del publisher de `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito
  * SOFOM, pista Loan). Endpoints PRIVADOS (VPC) consumidos por `retail-wizard-business` (pasos
@@ -57,6 +58,14 @@ export interface ILoanCreditBusinessApi {
      * `404 BORROWER_NOT_FOUND` si el evento KYC aún no lo hidrató.
      */
     getBorrowerByRetailCustomer(retailCustomerId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+    /**
+     * Historial crediticio agregado del acreditado, resuelto por su FK al cliente retail. Hoy
+     * devuelve el peor atraso VIGENTE en la ventana de 180 días — `null` cuando el acreditado no
+     * tiene ninguna cuota fechada en esa ventana, `0` cuando las tiene y ninguna está vencida
+     * impaga. Ese `null` es «hecho ausente», nunca se colapsa a `0`.
+     * `404 BORROWER_NOT_FOUND` si el evento KYC aún no hidrató al acreditado.
+     */
+    getCustomerCreditHistory(retailCustomerId: string, tenantId: string): Promise<StandardResponse<CustomerCreditHistoryResponse>>;
     /**
      * Lee créditos EN LOTE por su id y devuelve solo lo que se cuenta: el eje de riesgo congelado
      * al originar, el plan, las cifras del enganche, el estado, las fechas de originación y

package/bin/loanCredit/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";

package/bin/loanCredit/index.js

@@ -1,3 +1,4 @@
+export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.d.ts

@@ -1,6 +1,7 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanLevelEnum, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, ScopeWidePromotionsResponse, SkuPromotionsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { SegmentMembersResponse } from "./dtos/SegmentMembers.js";
 import { ILoanOfferingsBusinessApi } from "./interfaces/ILoanOfferingsBusinessApi.js";
 /**
  * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus
@@ -29,4 +30,5 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
     settlePromotionBonus(promotionId: string, input: SettlePromotionBonusRequest, tenantId: string): Promise<StandardResponse<PromotionBonusResponse>>;
     listSkuPromotions(storeId: string, tenantId: string, level?: CreditPlanLevelEnum, segmentId?: string): Promise<StandardResponse<SkuPromotionsResponse>>;
     listScopeWidePromotions(storeId: string, tenantId: string, level?: CreditPlanLevelEnum, segmentId?: string): Promise<StandardResponse<ScopeWidePromotionsResponse>>;
+    getSegmentMembers(retailCustomerIds: string[], tenantId: string): Promise<StandardResponse<SegmentMembersResponse>>;
 }

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.js

@@ -86,6 +86,14 @@ let LoanOfferingsBusinessApi = class LoanOfferingsBusinessApi {
             url += `&segmentId=${encodeURIComponent(segmentId)}`;
         return await this.httpRequest.get(url);
     }
+    async getSegmentMembers(retailCustomerIds, tenantId) {
+        const params = new URLSearchParams({
+            retailCustomerIds: retailCustomerIds.join(","),
+            tenantId,
+        });
+        const url = `${this.baseUrl}/private/segments/members?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
 };
 LoanOfferingsBusinessApi = __decorate([
     injectable(),

package/bin/loanOfferings/api/dtos/SegmentMembers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tipos de la pertenencia a segmentos EN LOTE. Viven en esta lib (y no en `@fiado/type-kit`) porque
+ * el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO local.
+ */
+/** Un segmento al que pertenece el cliente, con lo mínimo para pintarlo. */
+export interface CustomerSegmentMembership {
+    segmentId: string;
+    name: string;
+    /**
+     * Segmento por omisión del catálogo. Su semántica cambia por motor (alcanza a todos en
+     * promociones y a nadie en políticas), así que el consumidor decide si lo pinta.
+     */
+    isDefault: boolean;
+}
+/** Un cliente y los segmentos que le tocan. `segments: []` afirma que no está en ninguno. */
+export interface SegmentMembersItem {
+    retailCustomerId: string;
+    segments: CustomerSegmentMembership[];
+}
+/** Una fila por cada id PEDIDO, no por cada id con segmentos. */
+export interface SegmentMembersResponse {
+    items: SegmentMembersItem[];
+}

package/bin/loanOfferings/api/dtos/SegmentMembers.js

@@ -0,0 +1,5 @@
+/**
+ * Tipos de la pertenencia a segmentos EN LOTE. Viven en esta lib (y no en `@fiado/type-kit`) porque
+ * el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO local.
+ */
+export {};

package/bin/loanOfferings/api/interfaces/ILoanOfferingsBusinessApi.d.ts

@@ -1,4 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
+import { SegmentMembersResponse } from "../dtos/SegmentMembers.js";
 import { ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanLevelEnum, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, ScopeWidePromotionsResponse, SkuPromotionsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
 /**
  * Contrato del publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1)
@@ -133,4 +134,17 @@ export interface ILoanOfferingsBusinessApi {
      * hay ninguna vigente; nunca 404.
      */
     listScopeWidePromotions(storeId: string, tenantId: string, level?: CreditPlanLevelEnum, segmentId?: string): Promise<StandardResponse<ScopeWidePromotionsResponse>>;
+    /**
+     * `GET /private/segments/members?retailCustomerIds=<csv>` — pertenencia a segmentos EN LOTE.
+     * Es la alternativa a resolver segmento por cliente: una llamada por página de tabla.
+     *
+     * Devuelve una fila por cada id PEDIDO: los que no están en ningún segmento vuelven con
+     * `segments: []`, no se omiten. Aun así, indexa por `retailCustomerId` — nunca por posición.
+     *
+     * Tope de 100 ids por request, medido sobre lo que manda el caller.
+     *
+     * @throws `400 SEGMENT_MEMBERS_BATCH_TOO_LARGE` si el lote pasa de 100 ids.
+     * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
+     */
+    getSegmentMembers(retailCustomerIds: string[], tenantId: string): Promise<StandardResponse<SegmentMembersResponse>>;
 }

package/bin/loanOfferings/index.d.ts

@@ -1,2 +1,3 @@
+export * from "./api/dtos/SegmentMembers.js";
 export * from "./api/interfaces/ILoanOfferingsBusinessApi.js";
 export { default as LoanOfferingsBusinessApi } from "./api/LoanOfferingsBusinessApi.js";

package/bin/loanOfferings/index.js

@@ -1,2 +1,3 @@
+export * from "./api/dtos/SegmentMembers.js";
 export * from "./api/interfaces/ILoanOfferingsBusinessApi.js";
 export { default as LoanOfferingsBusinessApi } from "./api/LoanOfferingsBusinessApi.js";

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

@@ -2,6 +2,8 @@ import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, 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";
 import { IRetailCustomerBusinessApi } from "./interfaces/IRetailCustomerBusinessApi.js";
 /**
  * Publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail) para sus 7
@@ -28,4 +30,5 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
     markWelcomeAccredited(customerId: string, tenantId: string, payload?: WelcomeAccreditationRequest): Promise<StandardResponse<WelcomeAccreditationResponse>>;
     setWelcomeAccreditationResult(customerId: string, payload: WelcomeAccreditationResultRequest, tenantId: string): Promise<StandardResponse<WelcomeBonusResponse>>;
     getCustomersBatch(payload: CustomersBatchRequest, tenantId: string): Promise<StandardResponse<CustomersBatchResponse>>;
+    listCustomersPage(query: CustomersPageQuery, tenantId: string): Promise<StandardResponse<PaginatedResult<PrivateCustomerListItem>>>;
 }

package/bin/retailCustomer/api/RetailCustomerBusinessApi.js

@@ -60,6 +60,16 @@ let RetailCustomerBusinessApi = class RetailCustomerBusinessApi {
         const url = `${this.baseUrl}/private/customers/batch?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, payload);
     }
+    async listCustomersPage(query, tenantId) {
+        const params = new URLSearchParams({ tenantId });
+        if (query.limit !== undefined)
+            params.set("limit", String(query.limit));
+        // El cursor viaja tal cual lo entregó el destino: componerlo o re-codificarlo lo rompe.
+        if (query.nextToken)
+            params.set("nextToken", query.nextToken);
+        const url = `${this.baseUrl}/private/customers?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
 };
 RetailCustomerBusinessApi = __decorate([
     injectable(),

package/bin/retailCustomer/api/dtos/CustomersPage.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tipos del listado paginado de clientes del tenant. Viven en esta lib (y no en `@fiado/type-kit`)
+ * porque el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO
+ * local, mismo criterio que `CustomersBatch`.
+ */
+/** Query de `GET /private/customers`. `limit` default 25, máximo 100 del lado del destino. */
+export interface CustomersPageQuery {
+    limit?: number;
+    /** Cursor opaco de la página anterior. Ausente = primera página. */
+    nextToken?: string;
+}
+/**
+ * Lo mínimo para pintar el renglón de un cliente. `fullName: null` significa que el cliente existe
+ * y no tiene ninguna parte del nombre resuelta — es distinto de que el id no vuelva.
+ */
+export interface PrivateCustomerListItem {
+    retailCustomerId: string;
+    /** `names + paternalLastName + maternalLastName` ya compuesto por el destino. */
+    fullName: string | null;
+    phone: string | null;
+    /** Tienda donde se dio de alta. La ficha del backoffice la nombra y resuelve su KYC con ella. */
+    originStoreId: string | null;
+    /** Alta del cliente en ISO-8601 UTC. Es el orden del listado (descendente). */
+    createdAt: string;
+}

package/bin/retailCustomer/api/dtos/CustomersPage.js

@@ -0,0 +1,6 @@
+/**
+ * Tipos del listado paginado de clientes del tenant. Viven en esta lib (y no en `@fiado/type-kit`)
+ * porque el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO
+ * local, mismo criterio que `CustomersBatch`.
+ */
+export {};

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

@@ -1,6 +1,8 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import { UpsertCustomerFromKycRequest, AccountResultRequest, CustomerResponse, 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";
 /**
  * Contrato del publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail)
  * para sus 7 endpoints privados de cliente (service-to-service, VPC-only).
@@ -134,4 +136,18 @@ export interface IRetailCustomerBusinessApi {
      * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
      */
     getCustomersBatch(payload: CustomersBatchRequest, tenantId: string): Promise<StandardResponse<CustomersBatchResponse>>;
+    /**
+     * GET /private/customers?limit&nextToken&tenantId= — UNA página del padrón de clientes del
+     * tenant, del alta más reciente a la más vieja. Es el listado que alimenta las tablas de
+     * backoffice: una sola Query sobre el GSI de listado, sin fan-out por negocio.
+     *
+     * `nextToken` es OPACO: se pasea tal cual, no se compone ni se re-codifica. Ausente en la
+     * respuesta = última página. `count` son las filas de ESA página, nunca el total del padrón.
+     *
+     * `limit` default 25, máximo 100.
+     *
+     * @throws `400 INVALID_QUERY_PARAM` si `limit` no parsea o se pasa del tope.
+     * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
+     */
+    listCustomersPage(query: CustomersPageQuery, tenantId: string): Promise<StandardResponse<PaginatedResult<PrivateCustomerListItem>>>;
 }

package/bin/retailCustomer/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./api/dtos/CustomersBatch.js";
+export * from "./api/dtos/CustomersPage.js";
 export * from "./api/interfaces/IRetailCustomerBusinessApi.js";
 export { default as RetailCustomerBusinessApi } from "./api/RetailCustomerBusinessApi.js";

package/bin/retailCustomer/index.js

@@ -1,3 +1,4 @@
 export * from "./api/dtos/CustomersBatch.js";
+export * from "./api/dtos/CustomersPage.js";
 export * from "./api/interfaces/IRetailCustomerBusinessApi.js";
 export { default as RetailCustomerBusinessApi } from "./api/RetailCustomerBusinessApi.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.62.0",
+  "version": "5.64.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/loanCredit/api/LoanCreditBusinessApi.ts

@@ -18,6 +18,7 @@ import {
     LoanCreditAnalyticsBatchRequest,
     LoanCreditAnalyticsBatchResponse,
 } from "./dtos/LoanCreditAnalyticsBatch.js";
+import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import { ILoanCreditBusinessApi } from "./interfaces/ILoanCreditBusinessApi.js";
 
 /**
@@ -98,6 +99,14 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         return await this.httpRequest.get(url);
     }
 
+    async getCustomerCreditHistory(
+        retailCustomerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<CustomerCreditHistoryResponse>> {
+        const url = `${this.baseUrl}/private/borrowers/by-retail-customer/${encodeURIComponent(retailCustomerId)}/credit-history?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.get(url);
+    }
+
     async batchGetCreditAnalytics(
         input: LoanCreditAnalyticsBatchRequest,
         tenantId: string,

package/src/loanCredit/api/dtos/CustomerCreditHistory.ts

@@ -0,0 +1,13 @@
+/**
+ * Respuesta de `GET /private/borrowers/by-retail-customer/{retailCustomerId}/credit-history`.
+ * Historial crediticio agregado del acreditado. CERO PII — solo la FK al cliente retail y cifras.
+ */
+export interface CustomerCreditHistoryResponse {
+    retailCustomerId: string;
+    /**
+     * Peor atraso VIGENTE, en días, entre las cuotas vencidas en los últimos 180 días.
+     * `null` = el acreditado no tiene ninguna cuota fechada en la ventana (hecho ausente);
+     * `0` = tiene cuotas en la ventana y ninguna vencida impaga. NO son lo mismo.
+     */
+    delinquencyDaysLast6M: number | null;
+}

package/src/loanCredit/api/interfaces/ILoanCreditBusinessApi.ts

@@ -16,6 +16,7 @@ import {
     LoanCreditAnalyticsBatchRequest,
     LoanCreditAnalyticsBatchResponse,
 } from "../dtos/LoanCreditAnalyticsBatch.js";
+import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 
 /**
  * Contrato del publisher de `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito
@@ -104,6 +105,18 @@ export interface ILoanCreditBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<LoanBorrowerResponse>>;
 
+    /**
+     * Historial crediticio agregado del acreditado, resuelto por su FK al cliente retail. Hoy
+     * devuelve el peor atraso VIGENTE en la ventana de 180 días — `null` cuando el acreditado no
+     * tiene ninguna cuota fechada en esa ventana, `0` cuando las tiene y ninguna está vencida
+     * impaga. Ese `null` es «hecho ausente», nunca se colapsa a `0`.
+     * `404 BORROWER_NOT_FOUND` si el evento KYC aún no hidrató al acreditado.
+     */
+    getCustomerCreditHistory(
+        retailCustomerId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<CustomerCreditHistoryResponse>>;
+
     /**
      * Lee créditos EN LOTE por su id y devuelve solo lo que se cuenta: el eje de riesgo congelado
      * al originar, el plan, las cifras del enganche, el estado, las fechas de originación y

package/src/loanCredit/index.ts

@@ -1,3 +1,4 @@
+export * from "./api/dtos/CustomerCreditHistory.js";
 export * from "./api/dtos/LoanCreditAnalyticsBatch.js";
 export * from "./api/interfaces/ILoanCreditBusinessApi.js";
 export { default as LoanCreditBusinessApi } from "./api/LoanCreditBusinessApi.js";

package/src/loanOfferings/api/LoanOfferingsBusinessApi.ts

@@ -19,6 +19,7 @@ import {
     SimulateCreditPlanRequest,
     SimulationResultResponse,
 } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { SegmentMembersResponse } from "./dtos/SegmentMembers.js";
 import { ILoanOfferingsBusinessApi } from "./interfaces/ILoanOfferingsBusinessApi.js";
 
 /**
@@ -142,4 +143,16 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
         if (segmentId) url += `&segmentId=${encodeURIComponent(segmentId)}`;
         return await this.httpRequest.get(url);
     }
+
+    async getSegmentMembers(
+        retailCustomerIds: string[],
+        tenantId: string,
+    ): Promise<StandardResponse<SegmentMembersResponse>> {
+        const params = new URLSearchParams({
+            retailCustomerIds: retailCustomerIds.join(","),
+            tenantId,
+        });
+        const url = `${this.baseUrl}/private/segments/members?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
 }

package/src/loanOfferings/api/dtos/SegmentMembers.ts

@@ -0,0 +1,26 @@
+/**
+ * Tipos de la pertenencia a segmentos EN LOTE. Viven en esta lib (y no en `@fiado/type-kit`) porque
+ * el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO local.
+ */
+
+/** Un segmento al que pertenece el cliente, con lo mínimo para pintarlo. */
+export interface CustomerSegmentMembership {
+    segmentId: string;
+    name: string;
+    /**
+     * Segmento por omisión del catálogo. Su semántica cambia por motor (alcanza a todos en
+     * promociones y a nadie en políticas), así que el consumidor decide si lo pinta.
+     */
+    isDefault: boolean;
+}
+
+/** Un cliente y los segmentos que le tocan. `segments: []` afirma que no está en ninguno. */
+export interface SegmentMembersItem {
+    retailCustomerId: string;
+    segments: CustomerSegmentMembership[];
+}
+
+/** Una fila por cada id PEDIDO, no por cada id con segmentos. */
+export interface SegmentMembersResponse {
+    items: SegmentMembersItem[];
+}

package/src/loanOfferings/api/interfaces/ILoanOfferingsBusinessApi.ts

@@ -1,4 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
+import { SegmentMembersResponse } from "../dtos/SegmentMembers.js";
 import {
     ConsumePromotionRequest,
     PromotedSkusResponse,
@@ -203,4 +204,21 @@ export interface ILoanOfferingsBusinessApi {
         level?: CreditPlanLevelEnum,
         segmentId?: string,
     ): Promise<StandardResponse<ScopeWidePromotionsResponse>>;
+
+    /**
+     * `GET /private/segments/members?retailCustomerIds=<csv>` — pertenencia a segmentos EN LOTE.
+     * Es la alternativa a resolver segmento por cliente: una llamada por página de tabla.
+     *
+     * Devuelve una fila por cada id PEDIDO: los que no están en ningún segmento vuelven con
+     * `segments: []`, no se omiten. Aun así, indexa por `retailCustomerId` — nunca por posición.
+     *
+     * Tope de 100 ids por request, medido sobre lo que manda el caller.
+     *
+     * @throws `400 SEGMENT_MEMBERS_BATCH_TOO_LARGE` si el lote pasa de 100 ids.
+     * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
+     */
+    getSegmentMembers(
+        retailCustomerIds: string[],
+        tenantId: string,
+    ): Promise<StandardResponse<SegmentMembersResponse>>;
 }

package/src/loanOfferings/index.ts

@@ -1,2 +1,3 @@
+export * from "./api/dtos/SegmentMembers.js";
 export * from "./api/interfaces/ILoanOfferingsBusinessApi.js";
 export { default as LoanOfferingsBusinessApi } from "./api/LoanOfferingsBusinessApi.js";

package/src/retailCustomer/api/RetailCustomerBusinessApi.ts

@@ -11,6 +11,8 @@ import {
     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";
 import { IRetailCustomerBusinessApi } from "./interfaces/IRetailCustomerBusinessApi.js";
 
 /**
@@ -92,4 +94,16 @@ export default class RetailCustomerBusinessApi implements IRetailCustomerBusines
         const url = `${this.baseUrl}/private/customers/batch?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, payload);
     }
+
+    async listCustomersPage(
+        query: CustomersPageQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<PaginatedResult<PrivateCustomerListItem>>> {
+        const params = new URLSearchParams({ tenantId });
+        if (query.limit !== undefined) params.set("limit", String(query.limit));
+        // El cursor viaja tal cual lo entregó el destino: componerlo o re-codificarlo lo rompe.
+        if (query.nextToken) params.set("nextToken", query.nextToken);
+        const url = `${this.baseUrl}/private/customers?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
 }

package/src/retailCustomer/api/dtos/CustomersPage.ts

@@ -0,0 +1,27 @@
+/**
+ * Tipos del listado paginado de clientes del tenant. Viven en esta lib (y no en `@fiado/type-kit`)
+ * porque el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO
+ * local, mismo criterio que `CustomersBatch`.
+ */
+
+/** Query de `GET /private/customers`. `limit` default 25, máximo 100 del lado del destino. */
+export interface CustomersPageQuery {
+    limit?: number;
+    /** Cursor opaco de la página anterior. Ausente = primera página. */
+    nextToken?: string;
+}
+
+/**
+ * Lo mínimo para pintar el renglón de un cliente. `fullName: null` significa que el cliente existe
+ * y no tiene ninguna parte del nombre resuelta — es distinto de que el id no vuelva.
+ */
+export interface PrivateCustomerListItem {
+    retailCustomerId: string;
+    /** `names + paternalLastName + maternalLastName` ya compuesto por el destino. */
+    fullName: string | null;
+    phone: string | null;
+    /** Tienda donde se dio de alta. La ficha del backoffice la nombra y resuelve su KYC con ella. */
+    originStoreId: string | null;
+    /** Alta del cliente en ISO-8601 UTC. Es el orden del listado (descendente). */
+    createdAt: string;
+}

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

@@ -9,6 +9,8 @@ import {
     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";
 
 /**
  * Contrato del publisher HTTP del lambda `retail-customer-business` (SureKeep Fase 2, pista Retail)
@@ -173,4 +175,22 @@ export interface IRetailCustomerBusinessApi {
         payload: CustomersBatchRequest,
         tenantId: string,
     ): Promise<StandardResponse<CustomersBatchResponse>>;
+
+    /**
+     * GET /private/customers?limit&nextToken&tenantId= — UNA página del padrón de clientes del
+     * tenant, del alta más reciente a la más vieja. Es el listado que alimenta las tablas de
+     * backoffice: una sola Query sobre el GSI de listado, sin fan-out por negocio.
+     *
+     * `nextToken` es OPACO: se pasea tal cual, no se compone ni se re-codifica. Ausente en la
+     * respuesta = última página. `count` son las filas de ESA página, nunca el total del padrón.
+     *
+     * `limit` default 25, máximo 100.
+     *
+     * @throws `400 INVALID_QUERY_PARAM` si `limit` no parsea o se pasa del tope.
+     * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
+     */
+    listCustomersPage(
+        query: CustomersPageQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<PaginatedResult<PrivateCustomerListItem>>>;
 }

package/src/retailCustomer/index.ts

@@ -1,3 +1,4 @@
 export * from "./api/dtos/CustomersBatch.js";
+export * from "./api/dtos/CustomersPage.js";
 export * from "./api/interfaces/IRetailCustomerBusinessApi.js";
 export { default as RetailCustomerBusinessApi } from "./api/RetailCustomerBusinessApi.js";