@fiado/api-invoker 5.90.0 → 5.92.0

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 } 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, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import { CreditLifecycleFactRequest, CreditLifecycleFactResponse } from "./dtos/CreditLifecycleFact.js";
@@ -45,4 +45,6 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     }): Promise<StandardResponse<LoanPaymentListResponse>>;
     listCustomerCreditContracts(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanContractResponse[]>>;
     getCustomerCreditContractUrl(directoryId: string, creditId: string, contractId: string, tenantId: string): Promise<StandardResponse<LoanContractDownloadUrl>>;
+    getCustomerPaymentOptions(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanCustomerPaymentOptions>>;
+    createCustomerPayment(directoryId: string, creditId: string, tenantId: string, body: CreateCustomerPaymentRequest): Promise<StandardResponse<LoanCustomerPaymentResult>>;
 }

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -114,6 +114,13 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
     async getCustomerCreditContractUrl(directoryId, creditId, contractId, tenantId) {
         return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/contracts/${encodeURIComponent(contractId)}/url?tenantId=${encodeURIComponent(tenantId)}`);
     }
+    // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
+    async getCustomerPaymentOptions(directoryId, creditId, tenantId) {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/payment-options?tenantId=${encodeURIComponent(tenantId)}`);
+    }
+    async createCustomerPayment(directoryId, creditId, tenantId, body) {
+        return await this.httpRequest.post(`${this.customerCreditsUrl(directoryId, creditId)}/payments?tenantId=${encodeURIComponent(tenantId)}`, body);
+    }
 };
 LoanCreditBusinessApi = __decorate([
     injectable(),

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 } 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, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 import { CreditLifecycleFactRequest, CreditLifecycleFactResponse } from "../dtos/CreditLifecycleFact.js";
@@ -131,4 +131,13 @@ export interface ILoanCreditBusinessApi {
     listCustomerCreditContracts(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanContractResponse[]>>;
     /** URL prefirmada del PDF de un contrato. 404 CONTRACT_NOT_FOUND · 409 CONTRACT_PDF_NOT_READY. */
     getCustomerCreditContractUrl(directoryId: string, creditId: string, contractId: string, tenantId: string): Promise<StandardResponse<LoanContractDownloadUrl>>;
+    /** Opciones de pago de un crédito del cliente, con montos ya calculados. */
+    getCustomerPaymentOptions(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanCustomerPaymentOptions>>;
+    /**
+     * Pide el cobro de una opción de pago (202). Misma `idempotencyKey` y mismo cuerpo devuelven la
+     * misma respuesta. 404 CREDIT_NOT_FOUND · 409 AD_HOC_CHARGE_PENDING · 409 CREDIT_NOT_CURRENT ·
+     * 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED · 422 PAYMENT_OPTION_UNAVAILABLE · 422 IDEMPOTENCY_KEY_MISMATCH ·
+     * 5xx si el motor de cobro no contesta.
+     */
+    createCustomerPayment(directoryId: string, creditId: string, tenantId: string, body: CreateCustomerPaymentRequest): Promise<StandardResponse<LoanCustomerPaymentResult>>;
 }

package/bin/retailCatalog/api/RetailCatalogBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import type { GetStoreStockCatalogResponse, ReleaseStockRequest, ReleaseStockResponse, RenewReservationsRequest, RenewReservationsResponse, ReserveStockRequest, ReserveStockResponse, ReturnStockRequest, ReturnStockResponse, SellStockRequest, SellStockResponse, SuggestPiecesQuery, SuggestPiecesResponse, SyncInventoryRequest, SyncInventoryResponse, ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
 import { IRetailCatalogBusinessApi, ProductsByRetailersResponse, ReleaseReservationBody, ReserveInventoryBody, ReserveInventoryResult, SellInventoryBody, StoreCatalogItem } from "./interfaces/IRetailCatalogBusinessApi.js";
 /**
  * Publisher HTTP del lambda `retail-catalog-business` (SureKeep Fase 1, pista Retail) para sus
@@ -27,4 +27,14 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
     sellInventory(imei: string, body: SellInventoryBody, issuer: string): Promise<StandardResponse<void>>;
     releaseInventory(imei: string, body: ReleaseReservationBody, issuer: string): Promise<StandardResponse<void>>;
     returnInventory(imei: string, issuer: string): Promise<StandardResponse<void>>;
+    /** URL de una ruta de tienda con `tenantId` y los parámetros extra en query. */
+    private storeUrl;
+    reserveStock(storeId: string, body: ReserveStockRequest, tenantId: string): Promise<StandardResponse<ReserveStockResponse>>;
+    renewReservations(storeId: string, body: RenewReservationsRequest, tenantId: string): Promise<StandardResponse<RenewReservationsResponse>>;
+    suggestPieces(storeId: string, query: SuggestPiecesQuery, tenantId: string): Promise<StandardResponse<SuggestPiecesResponse>>;
+    sellStock(storeId: string, body: SellStockRequest, tenantId: string): Promise<StandardResponse<SellStockResponse>>;
+    releaseStock(storeId: string, body: ReleaseStockRequest, tenantId: string): Promise<StandardResponse<ReleaseStockResponse>>;
+    returnStock(storeId: string, body: ReturnStockRequest, tenantId: string): Promise<StandardResponse<ReturnStockResponse>>;
+    syncInventory(retailerId: string, body: SyncInventoryRequest, tenantId: string): Promise<StandardResponse<SyncInventoryResponse>>;
+    getStoreStockCatalog(storeId: string, tenantId: string): Promise<StandardResponse<GetStoreStockCatalogResponse>>;
 }

package/bin/retailCatalog/api/RetailCatalogBusinessApi.js

@@ -70,6 +70,38 @@ let RetailCatalogBusinessApi = class RetailCatalogBusinessApi {
         const url = `${this.baseUrl}/private/inventory/${encodeURIComponent(imei)}/return`;
         return await this.httpRequest.put(url, undefined, this.tenantHeader(issuer));
     }
+    /** URL de una ruta de tienda con `tenantId` y los parámetros extra en query. */
+    storeUrl(storeId, suffix, tenantId, extra = {}) {
+        const query = new URLSearchParams({ tenantId, ...extra });
+        return `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/${suffix}?${query.toString()}`;
+    }
+    async reserveStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations", tenantId), body);
+    }
+    async renewReservations(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations/renew", tenantId), body);
+    }
+    async suggestPieces(storeId, query, tenantId) {
+        const extra = { sku: query.sku, prefix: query.prefix };
+        return await this.httpRequest.get(this.storeUrl(storeId, "pieces", tenantId, extra));
+    }
+    async sellStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "sales", tenantId), body);
+    }
+    async releaseStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations/release", tenantId), body);
+    }
+    async returnStock(storeId, body, tenantId) {
+        return await this.httpRequest.put(this.storeUrl(storeId, "returns", tenantId), body);
+    }
+    async syncInventory(retailerId, body, tenantId) {
+        const query = new URLSearchParams({ tenantId });
+        const url = `${this.baseUrl}/private/retailers/${encodeURIComponent(retailerId)}/inventory/sync?${query.toString()}`;
+        return await this.httpRequest.post(url, body);
+    }
+    async getStoreStockCatalog(storeId, tenantId) {
+        return await this.httpRequest.get(this.storeUrl(storeId, "stock-catalog", tenantId));
+    }
 };
 RetailCatalogBusinessApi = __decorate([
     injectable(),

package/bin/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { MdmLockModeEnum, MdmProviderEnum, ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import type { GetStoreStockCatalogResponse, MdmLockModeEnum, MdmProviderEnum, ReleaseStockRequest, ReleaseStockResponse, RenewReservationsRequest, RenewReservationsResponse, ReserveStockRequest, ReserveStockResponse, ReturnStockRequest, ReturnStockResponse, SellStockRequest, SellStockResponse, SuggestPiecesQuery, SuggestPiecesResponse, SyncInventoryRequest, SyncInventoryResponse, ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
 /**
  * Contrato del publisher HTTP del lambda `retail-catalog-business` (SureKeep Fase 1, pista Retail)
  * para sus endpoints privados del ciclo de venta del IMEI, consumidos por el wizard F2.
@@ -152,4 +152,20 @@ export interface IRetailCatalogBusinessApi {
     releaseInventory(imei: string, body: ReleaseReservationBody, issuer: string): Promise<StandardResponse<void>>;
     /** PUT `/private/inventory/{imei}/return` — devuelve el IMEI vendido al stock (SOLD → AVAILABLE, sin body). */
     returnInventory(imei: string, issuer: string): Promise<StandardResponse<void>>;
+    /** PUT `/private/stores/{storeId}/reservations` — reserva una línea (kit completo) de forma idempotente. */
+    reserveStock(storeId: string, body: ReserveStockRequest, tenantId: string): Promise<StandardResponse<ReserveStockResponse>>;
+    /** PUT `/private/stores/{storeId}/reservations/renew` — extiende las reservas de las líneas. */
+    renewReservations(storeId: string, body: RenewReservationsRequest, tenantId: string): Promise<StandardResponse<RenewReservationsResponse>>;
+    /** GET `/private/stores/{storeId}/pieces` — piezas disponibles del SKU que empiezan con `prefix`. */
+    suggestPieces(storeId: string, query: SuggestPiecesQuery, tenantId: string): Promise<StandardResponse<SuggestPiecesResponse>>;
+    /** PUT `/private/stores/{storeId}/sales` — vende las líneas con sus identificadores en una transacción. */
+    sellStock(storeId: string, body: SellStockRequest, tenantId: string): Promise<StandardResponse<SellStockResponse>>;
+    /** PUT `/private/stores/{storeId}/reservations/release` — libera las reservas de las líneas. */
+    releaseStock(storeId: string, body: ReleaseStockRequest, tenantId: string): Promise<StandardResponse<ReleaseStockResponse>>;
+    /** PUT `/private/stores/{storeId}/returns` — regresa al stock las piezas de una venta cancelada. */
+    returnStock(storeId: string, body: ReturnStockRequest, tenantId: string): Promise<StandardResponse<ReturnStockResponse>>;
+    /** POST `/private/retailers/{retailerId}/inventory/sync` — puerta de entrada de productos, precios y stock. */
+    syncInventory(retailerId: string, body: SyncInventoryRequest, tenantId: string): Promise<StandardResponse<SyncInventoryResponse>>;
+    /** GET `/private/stores/{storeId}/stock-catalog` — catálogo vendible de la tienda, una fila por SKU. */
+    getStoreStockCatalog(storeId: string, tenantId: string): Promise<StandardResponse<GetStoreStockCatalogResponse>>;
 }

package/package.json

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

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -25,6 +25,9 @@ import {
     LoanCreditDetail,
     LoanInstallmentResponse,
     LoanPaymentListResponse,
+    CreateCustomerPaymentRequest,
+    LoanCustomerPaymentOptions,
+    LoanCustomerPaymentResult,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 import {
     LoanCreditAnalyticsBatchRequest,
@@ -238,4 +241,28 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
             `${this.customerCreditsUrl(directoryId, creditId)}/contracts/${encodeURIComponent(contractId)}/url?tenantId=${encodeURIComponent(tenantId)}`,
         );
     }
+
+    // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
+
+    async getCustomerPaymentOptions(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCustomerPaymentOptions>> {
+        return await this.httpRequest.get(
+            `${this.customerCreditsUrl(directoryId, creditId)}/payment-options?tenantId=${encodeURIComponent(tenantId)}`,
+        );
+    }
+
+    async createCustomerPayment(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+        body: CreateCustomerPaymentRequest,
+    ): Promise<StandardResponse<LoanCustomerPaymentResult>> {
+        return await this.httpRequest.post(
+            `${this.customerCreditsUrl(directoryId, creditId)}/payments?tenantId=${encodeURIComponent(tenantId)}`,
+            body,
+        );
+    }
 }

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

@@ -23,6 +23,9 @@ import {
     LoanCreditDetail,
     LoanInstallmentResponse,
     LoanPaymentListResponse,
+    CreateCustomerPaymentRequest,
+    LoanCustomerPaymentOptions,
+    LoanCustomerPaymentResult,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 import {
     LoanCreditAnalyticsBatchRequest,
@@ -255,4 +258,26 @@ export interface ILoanCreditBusinessApi {
         contractId: string,
         tenantId: string,
     ): Promise<StandardResponse<LoanContractDownloadUrl>>;
+
+    // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
+
+    /** Opciones de pago de un crédito del cliente, con montos ya calculados. */
+    getCustomerPaymentOptions(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCustomerPaymentOptions>>;
+
+    /**
+     * Pide el cobro de una opción de pago (202). Misma `idempotencyKey` y mismo cuerpo devuelven la
+     * misma respuesta. 404 CREDIT_NOT_FOUND · 409 AD_HOC_CHARGE_PENDING · 409 CREDIT_NOT_CURRENT ·
+     * 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED · 422 PAYMENT_OPTION_UNAVAILABLE · 422 IDEMPOTENCY_KEY_MISMATCH ·
+     * 5xx si el motor de cobro no contesta.
+     */
+    createCustomerPayment(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+        body: CreateCustomerPaymentRequest,
+    ): Promise<StandardResponse<LoanCustomerPaymentResult>>;
 }

package/src/retailCatalog/api/RetailCatalogBusinessApi.ts

@@ -1,7 +1,24 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import type { ValidateProductResponse } from "@fiado/type-kit/bin/retailCatalog/index.js";
+import type {
+    GetStoreStockCatalogResponse,
+    ReleaseStockRequest,
+    ReleaseStockResponse,
+    RenewReservationsRequest,
+    RenewReservationsResponse,
+    ReserveStockRequest,
+    ReserveStockResponse,
+    ReturnStockRequest,
+    ReturnStockResponse,
+    SellStockRequest,
+    SellStockResponse,
+    SuggestPiecesQuery,
+    SuggestPiecesResponse,
+    SyncInventoryRequest,
+    SyncInventoryResponse,
+    ValidateProductResponse,
+} from "@fiado/type-kit/bin/retailCatalog/index.js";
 import {
     IRetailCatalogBusinessApi,
     ProductsByRetailersBody,
@@ -97,4 +114,76 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
         const url = `${this.baseUrl}/private/inventory/${encodeURIComponent(imei)}/return`;
         return await this.httpRequest.put(url, undefined, this.tenantHeader(issuer));
     }
+
+    /** URL de una ruta de tienda con `tenantId` y los parámetros extra en query. */
+    private storeUrl(storeId: string, suffix: string, tenantId: string, extra: Record<string, string> = {}): string {
+        const query = new URLSearchParams({ tenantId, ...extra });
+        return `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/${suffix}?${query.toString()}`;
+    }
+
+    async reserveStock(
+        storeId: string,
+        body: ReserveStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReserveStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations", tenantId), body);
+    }
+
+    async renewReservations(
+        storeId: string,
+        body: RenewReservationsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<RenewReservationsResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations/renew", tenantId), body);
+    }
+
+    async suggestPieces(
+        storeId: string,
+        query: SuggestPiecesQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<SuggestPiecesResponse>> {
+        const extra = { sku: query.sku, prefix: query.prefix };
+        return await this.httpRequest.get(this.storeUrl(storeId, "pieces", tenantId, extra));
+    }
+
+    async sellStock(
+        storeId: string,
+        body: SellStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SellStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "sales", tenantId), body);
+    }
+
+    async releaseStock(
+        storeId: string,
+        body: ReleaseStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReleaseStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "reservations/release", tenantId), body);
+    }
+
+    async returnStock(
+        storeId: string,
+        body: ReturnStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReturnStockResponse>> {
+        return await this.httpRequest.put(this.storeUrl(storeId, "returns", tenantId), body);
+    }
+
+    async syncInventory(
+        retailerId: string,
+        body: SyncInventoryRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SyncInventoryResponse>> {
+        const query = new URLSearchParams({ tenantId });
+        const url = `${this.baseUrl}/private/retailers/${encodeURIComponent(retailerId)}/inventory/sync?${query.toString()}`;
+        return await this.httpRequest.post(url, body);
+    }
+
+    async getStoreStockCatalog(
+        storeId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<GetStoreStockCatalogResponse>> {
+        return await this.httpRequest.get(this.storeUrl(storeId, "stock-catalog", tenantId));
+    }
 }

package/src/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.ts

@@ -1,7 +1,22 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
 import type {
+    GetStoreStockCatalogResponse,
     MdmLockModeEnum,
     MdmProviderEnum,
+    ReleaseStockRequest,
+    ReleaseStockResponse,
+    RenewReservationsRequest,
+    RenewReservationsResponse,
+    ReserveStockRequest,
+    ReserveStockResponse,
+    ReturnStockRequest,
+    ReturnStockResponse,
+    SellStockRequest,
+    SellStockResponse,
+    SuggestPiecesQuery,
+    SuggestPiecesResponse,
+    SyncInventoryRequest,
+    SyncInventoryResponse,
     ValidateProductResponse,
 } from "@fiado/type-kit/bin/retailCatalog/index.js";
 
@@ -186,4 +201,54 @@ export interface IRetailCatalogBusinessApi {
 
     /** PUT `/private/inventory/{imei}/return` — devuelve el IMEI vendido al stock (SOLD → AVAILABLE, sin body). */
     returnInventory(imei: string, issuer: string): Promise<StandardResponse<void>>;
+
+    // Contrato de stock por SKU: el tenant va en `?tenantId=`; errores tipados del destino se propagan.
+
+    /** PUT `/private/stores/{storeId}/reservations` — reserva una línea (kit completo) de forma idempotente. */
+    reserveStock(
+        storeId: string,
+        body: ReserveStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReserveStockResponse>>;
+
+    /** PUT `/private/stores/{storeId}/reservations/renew` — extiende las reservas de las líneas. */
+    renewReservations(
+        storeId: string,
+        body: RenewReservationsRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<RenewReservationsResponse>>;
+
+    /** GET `/private/stores/{storeId}/pieces` — piezas disponibles del SKU que empiezan con `prefix`. */
+    suggestPieces(
+        storeId: string,
+        query: SuggestPiecesQuery,
+        tenantId: string,
+    ): Promise<StandardResponse<SuggestPiecesResponse>>;
+
+    /** PUT `/private/stores/{storeId}/sales` — vende las líneas con sus identificadores en una transacción. */
+    sellStock(storeId: string, body: SellStockRequest, tenantId: string): Promise<StandardResponse<SellStockResponse>>;
+
+    /** PUT `/private/stores/{storeId}/reservations/release` — libera las reservas de las líneas. */
+    releaseStock(
+        storeId: string,
+        body: ReleaseStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReleaseStockResponse>>;
+
+    /** PUT `/private/stores/{storeId}/returns` — regresa al stock las piezas de una venta cancelada. */
+    returnStock(
+        storeId: string,
+        body: ReturnStockRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<ReturnStockResponse>>;
+
+    /** POST `/private/retailers/{retailerId}/inventory/sync` — puerta de entrada de productos, precios y stock. */
+    syncInventory(
+        retailerId: string,
+        body: SyncInventoryRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SyncInventoryResponse>>;
+
+    /** GET `/private/stores/{storeId}/stock-catalog` — catálogo vendible de la tienda, una fila por SKU. */
+    getStoreStockCatalog(storeId: string, tenantId: string): Promise<StandardResponse<GetStoreStockCatalogResponse>>;
 }