@fiado/api-invoker 5.116.0 → 5.118.0

package/bin/container.config.js

@@ -74,6 +74,7 @@ import { EventHistoryApi } from "./event-history-business/index.js";
 import ReportProcessorBusinessApi from "./report-processor-business/api/ReportProcessorBusinessApi.js";
 import NotificationWSMessagePublisher from "./notificationWebsockets/queue/NotificationWSMessagePublisher.js";
 import PeopleBusinessApi from "./people-business/api/PeopleBusinessApi.js";
+import DatalakeReportsApi from "./datalake-reports-business/api/DatalakeReportsApi.js";
 import PlacesBusinessApi from "./places-business/api/PlacesBusinessApi.js";
 import STPBusinessApi from "./stp-business/api/STPBusinessApi.js";
 import MulticommServicePaymentApi from "./multicommServicePayment/api/MulticommServicePaymentApi.js";
@@ -225,6 +226,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IEventHistoryApi").to(EventHistoryApi);
     bind("IReportProcessorBusinessApi").to(ReportProcessorBusinessApi);
     bind("IPeopleBusinessApi").to(PeopleBusinessApi);
+    bind("IDatalakeReportsApi").to(DatalakeReportsApi);
     bind("IPlacesBusinessApi").to(PlacesBusinessApi);
     bind("ISTPBusinessApi").to(STPBusinessApi);
     bind("IProductPaymentApi").to(ProductPaymentApi);

package/bin/datalake-reports-business/api/DatalakeReportsApi.d.ts

@@ -0,0 +1,13 @@
+import type { IHttpRequest } from "@fiado/http-client";
+import { DatalakeReportDefinition, DatalakeReportResult, IDatalakeReportsApi } from "./interfaces/IDatalakeReportsApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export default class DatalakeReportsApi implements IDatalakeReportsApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    listReports(): Promise<FiadoApiResponse<DatalakeReportDefinition[]>>;
+    getReport(id: string): Promise<FiadoApiResponse<DatalakeReportDefinition>>;
+    runReport(id: string, params: Record<string, unknown>): Promise<FiadoApiResponse<DatalakeReportResult>>;
+    getJob(jobId: string, nextToken?: string): Promise<FiadoApiResponse<DatalakeReportResult>>;
+}
+export {};

package/bin/datalake-reports-business/api/DatalakeReportsApi.js

@@ -0,0 +1,39 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+let DatalakeReportsApi = class DatalakeReportsApi {
+    httpRequest;
+    baseUrl = process.env.DATALAKE_REPORTS_BUSINESS_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    listReports() {
+        return this.httpRequest.get(`${this.baseUrl}private/reports`);
+    }
+    getReport(id) {
+        return this.httpRequest.get(`${this.baseUrl}private/reports/${encodeURIComponent(id)}`);
+    }
+    runReport(id, params) {
+        return this.httpRequest.post(`${this.baseUrl}private/reports/${encodeURIComponent(id)}/run`, { params });
+    }
+    getJob(jobId, nextToken) {
+        const qs = nextToken ? `?nextToken=${encodeURIComponent(nextToken)}` : "";
+        return this.httpRequest.get(`${this.baseUrl}private/reports/jobs/${encodeURIComponent(jobId)}${qs}`);
+    }
+};
+DatalakeReportsApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], DatalakeReportsApi);
+export default DatalakeReportsApi;

package/bin/datalake-reports-business/api/interfaces/IDatalakeReportsApi.d.ts

@@ -0,0 +1,58 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/** Contrato local hasta que @fiado/type-kit publique el dominio DatalakeReports (misma forma). */
+export interface DatalakeReportDefinition {
+    id: string;
+    version: number;
+    title: string;
+    description: string;
+    source: {
+        layer: "gold" | "silver";
+        databases: string[];
+    };
+    pii: boolean;
+    audiences: string[];
+    permission: string;
+    mode: "sync" | "async";
+    cacheSeconds: number;
+    params: Record<string, {
+        type: string;
+        required?: boolean;
+        default?: unknown;
+        values?: string[];
+        max?: number;
+        min?: number;
+    }>;
+    principalParams: string[];
+    columns: Array<{
+        name: string;
+        type: string;
+        label: string;
+    }>;
+}
+export interface DatalakeReportResult {
+    status: "RUNNING" | "DONE" | "FAILED";
+    reportId?: string;
+    version?: number;
+    jobId: string;
+    columns?: Array<{
+        name: string;
+        type: string;
+        label: string;
+    }>;
+    rows?: Array<Record<string, string | number | boolean | null>>;
+    rowCount?: number;
+    nextToken?: string;
+    computedAt?: string;
+    fromCache?: boolean;
+    bytesScanned?: number;
+    reason?: string;
+}
+/** Canal privado de datalake-reports-business (reportes predefinidos sobre Gold y Silver). */
+export interface IDatalakeReportsApi {
+    listReports(): Promise<FiadoApiResponse<DatalakeReportDefinition[]>>;
+    getReport(id: string): Promise<FiadoApiResponse<DatalakeReportDefinition>>;
+    /** 200 con filas, o 200 con status RUNNING y jobId si la corrida cae a asíncrono. */
+    runReport(id: string, params: Record<string, unknown>): Promise<FiadoApiResponse<DatalakeReportResult>>;
+    getJob(jobId: string, nextToken?: string): Promise<FiadoApiResponse<DatalakeReportResult>>;
+}
+export {};

package/bin/datalake-reports-business/api/interfaces/IDatalakeReportsApi.js

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

package/bin/datalake-reports-business/index.d.ts

@@ -0,0 +1,2 @@
+export * from './api/DatalakeReportsApi.js';
+export * from './api/interfaces/IDatalakeReportsApi.js';

package/bin/datalake-reports-business/index.js

@@ -0,0 +1,2 @@
+export * from './api/DatalakeReportsApi.js';
+export * from './api/interfaces/IDatalakeReportsApi.js';

package/bin/index.d.ts

@@ -65,6 +65,7 @@ export * from "./event-history-business/index.js";
 export * from "./report-processor-business/index.js";
 export * from "./notificationWebsockets/index.js";
 export * from "./people-business/index.js";
+export * from "./datalake-reports-business/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";

package/bin/index.js

@@ -65,6 +65,7 @@ export * from "./event-history-business/index.js";
 export * from "./report-processor-business/index.js";
 export * from "./notificationWebsockets/index.js";
 export * from "./people-business/index.js";
+export * from "./datalake-reports-business/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";

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

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { CreditSummariesBatchRequest, CreditSummariesBatchResponse } from "./dtos/CreditSummariesBatch.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
@@ -35,6 +35,7 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     batchGetCreditAnalytics(input: LoanCreditAnalyticsBatchRequest, tenantId: string): Promise<StandardResponse<LoanCreditAnalyticsBatchResponse>>;
     batchGetCreditSummaries(input: CreditSummariesBatchRequest, tenantId: string): Promise<StandardResponse<CreditSummariesBatchResponse>>;
     upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+    updateBorrowerSci(borrowerId: string, input: UpdateLoanBorrowerSciRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
     notifyLifecycleFact(creditId: string, input: CreditLifecycleFactRequest, tenantId: string): Promise<StandardResponse<CreditLifecycleFactResponse>>;
     listMessagingCandidates(input: ListMessagingCandidatesRequest, tenantId: string): Promise<StandardResponse<ListMessagingCandidatesResponse>>;
     private customerCreditsUrl;

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -11,6 +11,11 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
+/**
+ * Tope de `updateBorrowerSci`: se llama al final de una evaluación SCI, dentro del Lambda de
+ * scoring. Si loan-credit tarda más, la evaluación termina igual y el nivel llega en la próxima.
+ */
+const BORROWER_SCI_TIMEOUT_MS = 2000;
 /**
  * Publisher HTTP del lambda `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito).
  * Contrato y semántica completos → `ILoanCreditBusinessApi` (tenantId obligatorio,
@@ -82,6 +87,10 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/borrowers?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+    async updateBorrowerSci(borrowerId, input, tenantId) {
+        const url = `${this.baseUrl}/private/borrowers/${encodeURIComponent(borrowerId)}/sci?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.put(url, input, {}, undefined, false, { timeout: BORROWER_SCI_TIMEOUT_MS });
+    }
     async notifyLifecycleFact(creditId, input, tenantId) {
         const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/lifecycle-facts?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);

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

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { CreditSummariesBatchRequest, CreditSummariesBatchResponse } from "../dtos/CreditSummariesBatch.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
@@ -103,6 +103,12 @@ export interface ILoanCreditBusinessApi {
      * del evento `CustomerKycVerifiedV1` — fallback operativo mientras la cola no exista).
      */
     upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
+    /**
+     * Deja en el acreditado el SCI y el nivel de una evaluación (loan-scoring, al terminarla).
+     * Gana la evaluación más reciente: una más vieja que la guardada responde `200` sin cambiar
+     * nada. `404 BORROWER_NOT_FOUND` si el acreditado no existe · `400 VALIDATION_ERROR`.
+     */
+    updateBorrowerSci(borrowerId: string, input: UpdateLoanBorrowerSciRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
     /**
      * Puerta de los hechos del ciclo: el caller nombra el HECHO que ya ocurrió en su propio lambda
      * (originación, enganche, firma, MDM, bienvenida) y el motor resuelve el momento, la plantilla,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.116.0",
+  "version": "5.118.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.510.0",
+    "@fiado/type-kit": "^3.512.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -107,6 +107,8 @@ import { IReportProcessorBusinessApi } from "./report-processor-business/index.j
 import { INotificationWSMessagesPublisher } from "./notificationWebsockets/index.js";
 import NotificationWSMessagePublisher from "./notificationWebsockets/queue/NotificationWSMessagePublisher.js";
 import PeopleBusinessApi from "./people-business/api/PeopleBusinessApi.js";
+import DatalakeReportsApi from "./datalake-reports-business/api/DatalakeReportsApi.js";
+import { IDatalakeReportsApi } from "./datalake-reports-business/index.js";
 import { IPeopleBusinessApi } from "./people-business/index.js";
 import PlacesBusinessApi from "./places-business/api/PlacesBusinessApi.js";
 import { IPlacesBusinessApi } from "./places-business/index.js";
@@ -297,6 +299,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<IEventHistoryApi>("IEventHistoryApi").to(EventHistoryApi);
     bind<IReportProcessorBusinessApi>("IReportProcessorBusinessApi").to(ReportProcessorBusinessApi);
     bind<IPeopleBusinessApi>("IPeopleBusinessApi").to(PeopleBusinessApi);
+    bind<IDatalakeReportsApi>("IDatalakeReportsApi").to(DatalakeReportsApi);
     bind<IPlacesBusinessApi>("IPlacesBusinessApi").to(PlacesBusinessApi);
     bind<ISTPBusinessApi>("ISTPBusinessApi").to(STPBusinessApi);
     bind<IProductPaymentApi>("IProductPaymentApi").to(ProductPaymentApi);

package/src/datalake-reports-business/api/DatalakeReportsApi.ts

@@ -0,0 +1,30 @@
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { DatalakeReportDefinition, DatalakeReportResult, IDatalakeReportsApi } from "./interfaces/IDatalakeReportsApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+
+@injectable()
+export default class DatalakeReportsApi implements IDatalakeReportsApi {
+
+    private readonly baseUrl = process.env.DATALAKE_REPORTS_BUSINESS_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    listReports(): Promise<FiadoApiResponse<DatalakeReportDefinition[]>> {
+        return this.httpRequest.get(`${this.baseUrl}private/reports`);
+    }
+
+    getReport(id: string): Promise<FiadoApiResponse<DatalakeReportDefinition>> {
+        return this.httpRequest.get(`${this.baseUrl}private/reports/${encodeURIComponent(id)}`);
+    }
+
+    runReport(id: string, params: Record<string, unknown>): Promise<FiadoApiResponse<DatalakeReportResult>> {
+        return this.httpRequest.post(`${this.baseUrl}private/reports/${encodeURIComponent(id)}/run`, { params });
+    }
+
+    getJob(jobId: string, nextToken?: string): Promise<FiadoApiResponse<DatalakeReportResult>> {
+        const qs = nextToken ? `?nextToken=${encodeURIComponent(nextToken)}` : "";
+        return this.httpRequest.get(`${this.baseUrl}private/reports/jobs/${encodeURIComponent(jobId)}${qs}`);
+    }
+}

package/src/datalake-reports-business/api/interfaces/IDatalakeReportsApi.ts

@@ -0,0 +1,27 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+
+/** Contrato local hasta que @fiado/type-kit publique el dominio DatalakeReports (misma forma). */
+export interface DatalakeReportDefinition {
+    id: string; version: number; title: string; description: string;
+    source: { layer: "gold" | "silver"; databases: string[] };
+    pii: boolean; audiences: string[]; permission: string; mode: "sync" | "async"; cacheSeconds: number;
+    params: Record<string, { type: string; required?: boolean; default?: unknown; values?: string[]; max?: number; min?: number }>;
+    principalParams: string[];
+    columns: Array<{ name: string; type: string; label: string }>;
+}
+export interface DatalakeReportResult {
+    status: "RUNNING" | "DONE" | "FAILED";
+    reportId?: string; version?: number; jobId: string;
+    columns?: Array<{ name: string; type: string; label: string }>;
+    rows?: Array<Record<string, string | number | boolean | null>>;
+    rowCount?: number; nextToken?: string; computedAt?: string; fromCache?: boolean; bytesScanned?: number; reason?: string;
+}
+
+/** Canal privado de datalake-reports-business (reportes predefinidos sobre Gold y Silver). */
+export interface IDatalakeReportsApi {
+    listReports(): Promise<FiadoApiResponse<DatalakeReportDefinition[]>>;
+    getReport(id: string): Promise<FiadoApiResponse<DatalakeReportDefinition>>;
+    /** 200 con filas, o 200 con status RUNNING y jobId si la corrida cae a asíncrono. */
+    runReport(id: string, params: Record<string, unknown>): Promise<FiadoApiResponse<DatalakeReportResult>>;
+    getJob(jobId: string, nextToken?: string): Promise<FiadoApiResponse<DatalakeReportResult>>;
+}

package/src/datalake-reports-business/index.ts

@@ -0,0 +1,2 @@
+export * from './api/DatalakeReportsApi.js';
+export * from './api/interfaces/IDatalakeReportsApi.js';

package/src/index.ts

@@ -65,6 +65,7 @@ export * from "./event-history-business/index.js";
 export * from "./report-processor-business/index.js";
 export * from "./notificationWebsockets/index.js";
 export * from "./people-business/index.js";
+export * from "./datalake-reports-business/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -18,6 +18,7 @@ import {
     QuoteLoanCreditResponse,
     SignLoanCreditRequest,
     SignLoanCreditResponse,
+    UpdateLoanBorrowerSciRequest,
     UpsertLoanBorrowerRequest,
     LoanBorrowerCreditItem,
     LoanContractDownloadUrl,
@@ -44,6 +45,12 @@ import {
 } from "./dtos/CreditLifecycleFact.js";
 import { ILoanCreditBusinessApi } from "./interfaces/ILoanCreditBusinessApi.js";
 
+/**
+ * Tope de `updateBorrowerSci`: se llama al final de una evaluación SCI, dentro del Lambda de
+ * scoring. Si loan-credit tarda más, la evaluación termina igual y el nivel llega en la próxima.
+ */
+const BORROWER_SCI_TIMEOUT_MS = 2000;
+
 /**
  * Publisher HTTP del lambda `loan-credit-business` (componente 09 SureKeep F2 — motor de crédito).
  * Contrato y semántica completos → `ILoanCreditBusinessApi` (tenantId obligatorio,
@@ -172,6 +179,15 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         return await this.httpRequest.post(url, input);
     }
 
+    async updateBorrowerSci(
+        borrowerId: string,
+        input: UpdateLoanBorrowerSciRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanBorrowerResponse>> {
+        const url = `${this.baseUrl}/private/borrowers/${encodeURIComponent(borrowerId)}/sci?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.put(url, input, {}, undefined, false, { timeout: BORROWER_SCI_TIMEOUT_MS });
+    }
+
     async notifyLifecycleFact(
         creditId: string,
         input: CreditLifecycleFactRequest,

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

@@ -16,6 +16,7 @@ import {
     QuoteLoanCreditResponse,
     SignLoanCreditRequest,
     SignLoanCreditResponse,
+    UpdateLoanBorrowerSciRequest,
     UpsertLoanBorrowerRequest,
     LoanBorrowerCreditItem,
     LoanContractDownloadUrl,
@@ -197,6 +198,17 @@ export interface ILoanCreditBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<LoanBorrowerResponse>>;
 
+    /**
+     * Deja en el acreditado el SCI y el nivel de una evaluación (loan-scoring, al terminarla).
+     * Gana la evaluación más reciente: una más vieja que la guardada responde `200` sin cambiar
+     * nada. `404 BORROWER_NOT_FOUND` si el acreditado no existe · `400 VALIDATION_ERROR`.
+     */
+    updateBorrowerSci(
+        borrowerId: string,
+        input: UpdateLoanBorrowerSciRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanBorrowerResponse>>;
+
     /**
      * Puerta de los hechos del ciclo: el caller nombra el HECHO que ya ocurrió en su propio lambda
      * (originación, enganche, firma, MDM, bienvenida) y el motor resuelve el momento, la plantilla,