@fiado/api-invoker 5.43.0 → 5.45.0

package/bin/collection-engine/api/CollectionEngineApi.d.ts

@@ -1,5 +1,5 @@
 import type { IHttpRequest } from "@fiado/http-client";
-import { CollectRequest, CollectResponse, RegisterCollectibleRequest } from "@fiado/type-kit/bin/collection/index.js";
+import { CollectRequest, CollectResponse, DeregisterChargeResponse } from "@fiado/type-kit/bin/collection/index.js";
 import { ICollectionEngineApi } from "./interfaces/ICollectionEngineApi.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
@@ -11,7 +11,6 @@ export default class CollectionEngineApi implements ICollectionEngineApi {
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
-    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<boolean>>;
-    deregister(ownerRef: string, productId: string, chargeId: string): Promise<FiadoApiResponse<boolean>>;
+    deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>>;
 }
 export {};

package/bin/collection-engine/api/CollectionEngineApi.js

@@ -25,13 +25,13 @@ let CollectionEngineApi = class CollectionEngineApi {
         const url = `${this.baseUrl}collection/collect`;
         return await this.httpRequest.post(url, request);
     }
-    async registerCollectible(request) {
-        const url = `${this.baseUrl}collection/register`;
-        return await this.httpRequest.post(url, request);
-    }
-    async deregister(ownerRef, productId, chargeId) {
-        const url = `${this.baseUrl}collection/deregister`;
-        return await this.httpRequest.post(url, { ownerRef, productId, chargeId });
+    async deregister(domain, chargeId) {
+        // `chargeId` lleva separadores `#` en todos los dominios (`SALE#42#INSTALLMENT#3`): sin
+        // escapar, el navegador o el cliente HTTP lo tratan como fragmento y el motor recibe la
+        // parte anterior al primer `#`, o sea otro cargo.
+        const url = `${this.baseUrl}collection/domains/${encodeURIComponent(domain)}`
+            + `/charges/${encodeURIComponent(chargeId)}/deregister`;
+        return await this.httpRequest.post(url, {});
     }
 };
 CollectionEngineApi = __decorate([

package/bin/collection-engine/api/interfaces/ICollectionEngineApi.d.ts

@@ -1,30 +1,40 @@
-import { CollectRequest, CollectResponse, RegisterCollectibleRequest } from "@fiado/type-kit/bin/collection/index.js";
+import { CollectRequest, CollectResponse, DeregisterChargeResponse } from "@fiado/type-kit/bin/collection/index.js";
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
 /**
  * Cliente para invocar los endpoints privados del lambda `collection-engine-business`.
  *
  * Los endpoints viven bajo `COLLECTION_ENGINE_LAMBDA_URL` (API Gateway privado / VPC).
- * El motor es agnóstico de proveedores/cuentas — los dominios (une-credit,
- * surekeep-retail, etc.) sólo hablan el contrato genérico de `PendingCharge`.
+ * El motor es agnóstico de proveedores y cuentas: el dominio dice QUÉ se debe y el motor
+ * decide de dónde cobrarlo según la config del producto.
+ *
+ * El alta explícita de un cargo cobrable (`registerCollectible`) todavía no existe en el
+ * motor: hoy `collect` crea el intent si no lo había, derivando su identidad de
+ * `domain#chargeId`. El método se reincorporará cuando el motor exponga la ruta.
  */
 export interface ICollectionEngineApi {
     /**
-     * Cobro on-demand síncrono. El dominio pide al motor que intente cobrar
-     * un cargo puntual (fuera del barrido normal de la cascada).
+     * Cobro on-demand síncrono. El dominio manda el cargo ya resuelto y el motor recorre la
+     * cascada de fuentes configurada para el producto. Idempotente por `domain#chargeId`:
+     * repetir la llamada sobre un cargo ya cobrado devuelve el resultado anterior sin volver
+     * a mover dinero.
+     *
      * Backend: POST /collection/collect (privado VPC).
      */
     collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
     /**
-     * Alta de un cargo cobrable en el índice del motor. Lo invoca el dominio
-     * dueño cuando nace una deuda cobrable (installment, cuota, etc.).
-     * Backend: POST /collection/register (privado VPC).
-     */
-    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<boolean>>;
-    /**
-     * Baja de un cargo del índice del motor (equivalente a cancelar el intent
-     * en curso). Lo invoca el dominio dueño cuando el cargo deja de ser cobrable.
-     * Backend: POST /collection/deregister (privado VPC).
+     * Baja de un cargo: detiene los reintentos de un cobro que el dominio castigó, condonó o
+     * reestructuró. Sin esto, un cargo sin fondos se reintenta indefinidamente.
+     *
+     * Identifica el cobro por `domain` y `chargeId`, que es la llave con la que el motor lo
+     * registró. Es idempotente: dar de baja un cargo ya terminal devuelve `ALREADY_TERMINAL`
+     * sin alterarlo.
+     *
+     * Un cargo desconocido responde 404, y el cliente HTTP lo propaga como excepción — no llega
+     * como envelope con `code`. El dominio debe atraparlo si un cargo ya inexistente es un caso
+     * esperado de su flujo.
+     *
+     * Backend: POST /collection/domains/{domain}/charges/{chargeId}/deregister (privado VPC).
      */
-    deregister(ownerRef: string, productId: string, chargeId: string): Promise<FiadoApiResponse<boolean>>;
+    deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>>;
 }
 export {};

package/bin/container.config.js

@@ -280,7 +280,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     // El productor necesita WEBHOOK_BUSINESS_QUEUE_URL y sqs:SendMessage sobre la cola.
     bind("IWebhookBusinessPublisher").to(WebhookBusinessPublisher);
     bind("ICentralPaymentsWebhookApi").to(CentralPaymentsWebhookApi);
-    // Collection engine — motor de cobro central multitenant (collect/registerCollectible/deregister)
+    // Collection engine — motor de cobro central multitenant (collect/deregister)
     bind("ICollectionEngineApi").to(CollectionEngineApi);
     // Domain callback — el motor notifica al dominio dueño del cargo (applyCollectionResult)
     bind("IDomainCallbackApi").to(DomainCallbackApi);

package/bin/document-generator/DocumentGeneratorApi.d.ts

@@ -1,4 +1,4 @@
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { IDocumentGeneratorApi } from "./interfaces/IDocumentGeneratorApi.js";
 import { DocumentGenerateRequest } from "@fiado/type-kit/bin/credit/dtos/internal/DocumentGenerateRequest.js";
 import { DocumentGenerateResponse } from "@fiado/type-kit/bin/credit/dtos/internal/DocumentGenerateResponse.js";

package/bin/document-generator/DocumentGeneratorApi.js

@@ -37,17 +37,17 @@ let DocumentGeneratorApi = class DocumentGeneratorApi {
     async getDocument(documentId) {
         const url = `${this.baseUrl}document/${documentId}`;
         const operationName = "documentGetDocument";
-        return await this.httpRequest.post(url, null, { 'operationName': operationName });
+        return await this.httpRequest.get(url, undefined, { 'operationName': operationName });
     }
     async getDocumentUrl(documentId) {
         const url = `${this.baseUrl}document/${documentId}/url`;
         const operationName = "documentGetDocumentUrl";
-        return await this.httpRequest.post(url, null, { 'operationName': operationName });
+        return await this.httpRequest.get(url, undefined, { 'operationName': operationName });
     }
     async getDocumentByReference(type, referenceId) {
         const url = `${this.baseUrl}document/by-reference/${type}/${referenceId}`;
         const operationName = "documentGetDocumentByReference";
-        return await this.httpRequest.post(url, null, { 'operationName': operationName });
+        return await this.httpRequest.get(url, undefined, { 'operationName': operationName });
     }
 };
 DocumentGeneratorApi = __decorate([

package/bin/legalDocument/api/LegalDocumentApi.d.ts

@@ -1,9 +1,10 @@
 import { ILegalDocumentApi } from "./interfaces/ILegalDocumentApi.js";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 export declare class LegalDocumentApi implements ILegalDocumentApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
     getPendingSign(directoryId: string): Promise<any>;
     getDirectoryAcceptanceByDirectoryId(directoryId: string): Promise<any>;
+    getDocumentByType(type: string): Promise<any>;
 }

package/bin/legalDocument/api/LegalDocumentApi.js

@@ -31,6 +31,13 @@ let LegalDocumentApi = class LegalDocumentApi {
         const url = `${this.baseUrl}directories/${directoryId}`;
         return await this.httpRequest.get(url);
     }
+    async getDocumentByType(type) {
+        if (!type) {
+            throw new Error("Document type is required.");
+        }
+        const url = `${this.baseUrl}documents/types/${encodeURIComponent(type)}`;
+        return await this.httpRequest.get(url);
+    }
 };
 LegalDocumentApi = __decorate([
     injectable(),

package/bin/legalDocument/api/interfaces/ILegalDocumentApi.d.ts

@@ -1,4 +1,9 @@
 export interface ILegalDocumentApi {
     getPendingSign(directoryId: string): Promise<any>;
     getDirectoryAcceptanceByDirectoryId(directoryId: string): Promise<any>;
+    /**
+     * Documento legal vigente de un tipo (PRIVACY_PAY, etc.).
+     * Devuelve el documento con su URL firmada y el vencimiento de esa URL.
+     */
+    getDocumentByType(type: string): Promise<any>;
 }

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 { IRetailCatalogBusinessApi, ReleaseReservationBody, ReserveInventoryBody, ReserveInventoryResult, SellInventoryBody, StoreCatalogItem } from "./interfaces/IRetailCatalogBusinessApi.js";
+import { ImeiProductLookupResponse, IRetailCatalogBusinessApi, ReleaseReservationBody, ReserveInventoryBody, ReserveInventoryResult, SellInventoryBody, StoreCatalogItem } from "./interfaces/IRetailCatalogBusinessApi.js";
 /**
  * Publisher HTTP del lambda `retail-catalog-business` (SureKeep Fase 1, pista Retail) para sus
  * endpoints privados del ciclo de venta del IMEI. Contrato y semántica completos →
@@ -20,6 +20,7 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
     constructor(httpRequest: IHttpRequest);
     private tenantHeader;
     getStoreCatalog(storeId: string, issuer: string): Promise<StandardResponse<StoreCatalogItem[]>>;
+    getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
     reserveInventory(imei: string, body: ReserveInventoryBody, issuer: string): Promise<StandardResponse<ReserveInventoryResult>>;
     sellInventory(imei: string, body: SellInventoryBody, issuer: string): Promise<StandardResponse<void>>;
     releaseInventory(imei: string, body: ReleaseReservationBody, issuer: string): Promise<StandardResponse<void>>;

package/bin/retailCatalog/api/RetailCatalogBusinessApi.js

@@ -11,6 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable } from "inversify";
+import { IMEI_PRODUCT_BATCH_MAX, } from "./interfaces/IRetailCatalogBusinessApi.js";
 /** Header por el que el destino resuelve el silo (issuer Cognito forwardeado por el caller). */
 const TENANT_ISSUER_HEADER = "x-tenant-issuer";
 /**
@@ -40,6 +41,16 @@ let RetailCatalogBusinessApi = class RetailCatalogBusinessApi {
         const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/catalog`;
         return await this.httpRequest.get(url, undefined, this.tenantHeader(issuer));
     }
+    async getProductsByImei(imeis, tenantId) {
+        // Se corta acá: mandar un lote que el destino va a rechazar solo gasta un round-trip.
+        if (imeis.length > IMEI_PRODUCT_BATCH_MAX) {
+            throw new Error(`El lote admite hasta ${IMEI_PRODUCT_BATCH_MAX} IMEIs y llegaron ${imeis.length}`);
+        }
+        // `URLSearchParams` codifica la coma del separador; el destino hace `split(',')` sobre el
+        // valor ya decodificado por API Gateway.
+        const query = new URLSearchParams({ imeis: imeis.join(","), tenantId });
+        return await this.httpRequest.get(`${this.baseUrl}/private/products/by-imei?${query.toString()}`);
+    }
     async reserveInventory(imei, body, issuer) {
         const url = `${this.baseUrl}/private/inventory/${encodeURIComponent(imei)}/reserve`;
         return await this.httpRequest.put(url, body, this.tenantHeader(issuer));

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

@@ -5,12 +5,17 @@ import type { MdmLockModeEnum, MdmProviderEnum } from "@fiado/type-kit/bin/retai
  * para sus endpoints privados del ciclo de venta del IMEI, consumidos por el wizard F2.
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * TENANT — header `x-tenant-issuer` (NO `?tenantId=`).
+ * TENANT — DOS convenciones conviven acá. Mirá la firma de cada método.
  * ─────────────────────────────────────────────────────────────────────────────
- * A diferencia de customer/cards/loan-config (que resuelven el silo por `?tenantId=` canónico), este
- * lambda resuelve el tenant por el ISSUER Cognito forwardeado en el header `x-tenant-issuer`
- * (`PrivateController.issuerFromHeader` → `TenantContextService.withContext(issuer)`). Los privados son
- * `Feature.ANONIMUS` (sin RBAC; la protección es la red VPC), así que el caller DEBE declarar el issuer.
+ * Los cinco métodos del ciclo de venta del IMEI toman `issuer` y lo mandan en el header
+ * `x-tenant-issuer` (`PrivateController.issuerFromHeader` → `TenantContextService.withContext`).
+ * `getProductsByImei` toma `tenantId` y lo manda por `?tenantId=`
+ * (→ `TenantContextService.withContextByTenantId`), porque su consumidor es un backoffice que no
+ * tiene el issuer Cognito. Los privados son `Feature.ANONIMUS` (sin RBAC; la protección es la red
+ * VPC), así que el caller DEBE declarar uno de los dos — no hay default.
+ *
+ * TD: converger los cinco del ciclo de venta a `?tenantId=`, el camino canónico para
+ * service-to-service. No se migran acá para no romper al wizard, que ya consume el header.
  *
  * ⚠️ Retorno `StandardResponse<T>` — el consumer lee `result.data`, NO `result.body`.
  * Errores: el destino lanza `DomainError` tipado → el publisher RECHAZA (no devuelve null); cada
@@ -53,6 +58,28 @@ export interface StoreCatalogItem {
     /** Modo de bloqueo pactado; `null` si el producto no lleva MDM. */
     mdmLockMode: MdmLockModeEnum | null;
 }
+/** Techo de IMEIs por request del lote IMEI->producto. Lo declara y lo honra el destino. */
+export declare const IMEI_PRODUCT_BATCH_MAX = 100;
+/** Por que se pudo (o no) resolver el producto de un IMEI del lote. */
+export type ImeiProductLookupStatus = "OK" | "NOT_FOUND" | "UNAVAILABLE" | "INVALID_ID";
+/** Una entrada del lote IMEI->producto (espeja `ImeiProductLookupEntry` del destino). */
+export interface ImeiProductLookupEntry {
+    imei: string;
+    /**
+     * `OK` trae sku/brand/model · `NOT_FOUND` el catalogo no llega al producto (dato POSITIVO) ·
+     * `UNAVAILABLE` no se pudo leer ese IMEI, reintentalo · `INVALID_ID` no tiene forma de IMEI.
+     */
+    status: ImeiProductLookupStatus;
+    sku?: string;
+    /** Marca comercial (p. ej. "Apple"). Solo viene con `status: OK`. */
+    brand?: string;
+    /** Modelo (p. ej. "iPhone 15 Pro"). Solo viene con `status: OK`. */
+    model?: string;
+}
+/** Respuesta del lote: UNA entrada por IMEI pedido, en el MISMO orden. */
+export interface ImeiProductLookupResponse {
+    items: ImeiProductLookupEntry[];
+}
 /** Resultado de la reserva (espeja `ReserveInventoryResponse` del destino). */
 export interface ReserveInventoryResult {
     reservationExpiresAt: string;
@@ -74,6 +101,30 @@ export interface ReleaseReservationBody {
 export interface IRetailCatalogBusinessApi {
     /** GET `/private/stores/{storeId}/catalog` — catálogo vendible (sku, imei, precio de contado, disponibilidad). */
     getStoreCatalog(storeId: string, issuer: string): Promise<StandardResponse<StoreCatalogItem[]>>;
+    /**
+     * GET `/private/products/by-imei?imeis=&tenantId=` — resuelve un lote de IMEIs a su producto
+     * (sku + marca + modelo). Para los lambdas que del equipo solo guardan el IMEI.
+     *
+     * ─────────────────────────────────────────────────────────────────────────────
+     * ⚠️ El tenant va por `?tenantId=`, NO por el header `x-tenant-issuer` del resto de este publisher.
+     * ─────────────────────────────────────────────────────────────────────────────
+     * El consumidor es un backoffice que solo tiene el `tenantId` de su contexto; el issuer Cognito
+     * no existe de su lado. El destino entra por `TenantContextService.withContextByTenantId`, con las
+     * mismas garantías (mismo diccionario, AssumeRole del silo, fail-closed sin tenant).
+     *
+     * ── El contrato del lote ────────────────────────────────────────────────────────────────────
+     * Devuelve UNA entrada por cada IMEI pedido, en el MISMO orden — el caller nunca reconcilia. Los
+     * repetidos se consultan una sola vez pero salen repetidos. Techo de `IMEI_PRODUCT_BATCH_MAX`
+     * IMEIs por request; el caller parte los lotes mayores.
+     *
+     * Ningún IMEI tumba el lote: el mal formado sale `INVALID_ID`, el que el catálogo no alcanza a
+     * resolver sale `NOT_FOUND` y el que DynamoDB no llegó a leer sale `UNAVAILABLE` (reintentable).
+     * Solo un fallo total del destino rechaza la promesa.
+     *
+     * @throws Error si el lote supera el techo (se corta acá, sin salir a la red) ·
+     *   `400 IMEI_BATCH_REQUIRED` si `imeis` viene vacío · `400 UNKNOWN_TENANT` sin `tenantId`.
+     */
+    getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
     /** PUT `/private/inventory/{imei}/reserve` — reserva atómica del IMEI para una sesión (AVAILABLE → RESERVED). */
     reserveInventory(imei: string, body: ReserveInventoryBody, issuer: string): Promise<StandardResponse<ReserveInventoryResult>>;
     /** PUT `/private/inventory/{imei}/sell` — vende el IMEI (RESERVED → SOLD). */

package/bin/retailCatalog/api/interfaces/IRetailCatalogBusinessApi.js

@@ -1 +1,2 @@
-export {};
+/** Techo de IMEIs por request del lote IMEI->producto. Lo declara y lo honra el destino. */
+export const IMEI_PRODUCT_BATCH_MAX = 100;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.43.0",
+  "version": "5.45.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.360.0",
+    "@fiado/type-kit": "^3.367.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/collection-engine/api/CollectionEngineApi.ts

@@ -3,7 +3,7 @@ import type { IHttpRequest } from "@fiado/http-client";
 import {
     CollectRequest,
     CollectResponse,
-    RegisterCollectibleRequest,
+    DeregisterChargeResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
 import { ICollectionEngineApi } from "./interfaces/ICollectionEngineApi.js";
 
@@ -26,13 +26,12 @@ export default class CollectionEngineApi implements ICollectionEngineApi {
         return await this.httpRequest.post(url, request);
     }
 
-    async registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<boolean>> {
-        const url = `${this.baseUrl}collection/register`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async deregister(ownerRef: string, productId: string, chargeId: string): Promise<FiadoApiResponse<boolean>> {
-        const url = `${this.baseUrl}collection/deregister`;
-        return await this.httpRequest.post(url, { ownerRef, productId, chargeId });
+    async deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>> {
+        // `chargeId` lleva separadores `#` en todos los dominios (`SALE#42#INSTALLMENT#3`): sin
+        // escapar, el navegador o el cliente HTTP lo tratan como fragmento y el motor recibe la
+        // parte anterior al primer `#`, o sea otro cargo.
+        const url = `${this.baseUrl}collection/domains/${encodeURIComponent(domain)}`
+            + `/charges/${encodeURIComponent(chargeId)}/deregister`;
+        return await this.httpRequest.post(url, {});
     }
 }

package/src/collection-engine/api/interfaces/ICollectionEngineApi.ts

@@ -1,7 +1,7 @@
 import {
     CollectRequest,
     CollectResponse,
-    RegisterCollectibleRequest,
+    DeregisterChargeResponse,
 } from "@fiado/type-kit/bin/collection/index.js";
 
 type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
@@ -10,29 +10,38 @@ type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApi
  * Cliente para invocar los endpoints privados del lambda `collection-engine-business`.
  *
  * Los endpoints viven bajo `COLLECTION_ENGINE_LAMBDA_URL` (API Gateway privado / VPC).
- * El motor es agnóstico de proveedores/cuentas — los dominios (une-credit,
- * surekeep-retail, etc.) sólo hablan el contrato genérico de `PendingCharge`.
+ * El motor es agnóstico de proveedores y cuentas: el dominio dice QUÉ se debe y el motor
+ * decide de dónde cobrarlo según la config del producto.
+ *
+ * El alta explícita de un cargo cobrable (`registerCollectible`) todavía no existe en el
+ * motor: hoy `collect` crea el intent si no lo había, derivando su identidad de
+ * `domain#chargeId`. El método se reincorporará cuando el motor exponga la ruta.
  */
 export interface ICollectionEngineApi {
 
     /**
-     * Cobro on-demand síncrono. El dominio pide al motor que intente cobrar
-     * un cargo puntual (fuera del barrido normal de la cascada).
+     * Cobro on-demand síncrono. El dominio manda el cargo ya resuelto y el motor recorre la
+     * cascada de fuentes configurada para el producto. Idempotente por `domain#chargeId`:
+     * repetir la llamada sobre un cargo ya cobrado devuelve el resultado anterior sin volver
+     * a mover dinero.
+     *
      * Backend: POST /collection/collect (privado VPC).
      */
     collect(request: CollectRequest): Promise<FiadoApiResponse<CollectResponse>>;
 
     /**
-     * Alta de un cargo cobrable en el índice del motor. Lo invoca el dominio
-     * dueño cuando nace una deuda cobrable (installment, cuota, etc.).
-     * Backend: POST /collection/register (privado VPC).
-     */
-    registerCollectible(request: RegisterCollectibleRequest): Promise<FiadoApiResponse<boolean>>;
-
-    /**
-     * Baja de un cargo del índice del motor (equivalente a cancelar el intent
-     * en curso). Lo invoca el dominio dueño cuando el cargo deja de ser cobrable.
-     * Backend: POST /collection/deregister (privado VPC).
+     * Baja de un cargo: detiene los reintentos de un cobro que el dominio castigó, condonó o
+     * reestructuró. Sin esto, un cargo sin fondos se reintenta indefinidamente.
+     *
+     * Identifica el cobro por `domain` y `chargeId`, que es la llave con la que el motor lo
+     * registró. Es idempotente: dar de baja un cargo ya terminal devuelve `ALREADY_TERMINAL`
+     * sin alterarlo.
+     *
+     * Un cargo desconocido responde 404, y el cliente HTTP lo propaga como excepción — no llega
+     * como envelope con `code`. El dominio debe atraparlo si un cargo ya inexistente es un caso
+     * esperado de su flujo.
+     *
+     * Backend: POST /collection/domains/{domain}/charges/{chargeId}/deregister (privado VPC).
      */
-    deregister(ownerRef: string, productId: string, chargeId: string): Promise<FiadoApiResponse<boolean>>;
+    deregister(domain: string, chargeId: string): Promise<FiadoApiResponse<DeregisterChargeResponse>>;
 }

package/src/container.config.ts

@@ -195,7 +195,7 @@ import { IKycVerificationsBusinessApi, KycVerificationsBusinessApi } from "./kyc
 // Webhook business — publisher de la cola compartida de entrega de eventos a suscriptores externos
 import { IWebhookBusinessPublisher, WebhookBusinessPublisher } from "./webhook-business/index.js";
 import { ICentralPaymentsWebhookApi, CentralPaymentsWebhookApi } from "./central-payments-webhook/index.js";
-// Collection engine — cliente del motor de cobro central (collect/registerCollectible/deregister)
+// Collection engine — cliente del motor de cobro central (collect/deregister)
 import { ICollectionEngineApi } from "./collection-engine/index.js";
 import CollectionEngineApi from "./collection-engine/api/CollectionEngineApi.js";
 // Domain callback — cliente genérico que usa el motor para notificar a cualquier dominio
@@ -374,7 +374,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<IWebhookBusinessPublisher>("IWebhookBusinessPublisher").to(WebhookBusinessPublisher);
     bind<ICentralPaymentsWebhookApi>("ICentralPaymentsWebhookApi").to(CentralPaymentsWebhookApi);
 
-    // Collection engine — motor de cobro central multitenant (collect/registerCollectible/deregister)
+    // Collection engine — motor de cobro central multitenant (collect/deregister)
     bind<ICollectionEngineApi>("ICollectionEngineApi").to(CollectionEngineApi);
 
     // Domain callback — el motor notifica al dominio dueño del cargo (applyCollectionResult)

package/src/document-generator/DocumentGeneratorApi.ts

@@ -1,6 +1,6 @@
 import dotenv from 'dotenv';
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { IDocumentGeneratorApi } from "./interfaces/IDocumentGeneratorApi.js";
 import { DocumentGenerateRequest } from "@fiado/type-kit/bin/credit/dtos/internal/DocumentGenerateRequest.js";
 import { DocumentGenerateResponse } from "@fiado/type-kit/bin/credit/dtos/internal/DocumentGenerateResponse.js";
@@ -34,18 +34,18 @@ export class DocumentGeneratorApi implements IDocumentGeneratorApi {
     public async getDocument(documentId: string): Promise<DocumentGenerateResponse> {
         const url = `${this.baseUrl}document/${documentId}`;
         const operationName = "documentGetDocument";
-        return await this.httpRequest.post(url, null, { 'operationName': operationName });
+        return await this.httpRequest.get(url, undefined, { 'operationName': operationName });
     }
 
     public async getDocumentUrl(documentId: string): Promise<{ url: string; expiresAt: string }> {
         const url = `${this.baseUrl}document/${documentId}/url`;
         const operationName = "documentGetDocumentUrl";
-        return await this.httpRequest.post(url, null, { 'operationName': operationName });
+        return await this.httpRequest.get(url, undefined, { 'operationName': operationName });
     }
 
     public async getDocumentByReference(type: string, referenceId: string): Promise<DocumentGenerateResponse[]> {
         const url = `${this.baseUrl}document/by-reference/${type}/${referenceId}`;
         const operationName = "documentGetDocumentByReference";
-        return await this.httpRequest.post(url, null, { 'operationName': operationName });
+        return await this.httpRequest.get(url, undefined, { 'operationName': operationName });
     }
 }

package/src/legalDocument/api/LegalDocumentApi.ts

@@ -1,6 +1,6 @@
 import { inject, injectable } from "inversify";
 import { ILegalDocumentApi } from "./interfaces/ILegalDocumentApi.js";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 
 
 
@@ -34,5 +34,16 @@ export class LegalDocumentApi implements ILegalDocumentApi {
 
         return await this.httpRequest.get<any>(url);
     }
+
+    async getDocumentByType(type: string): Promise<any> {
+
+        if (!type) {
+            throw new Error("Document type is required.")
+        }
+
+        const url = `${this.baseUrl}documents/types/${encodeURIComponent(type)}`;
+
+        return await this.httpRequest.get<any>(url);
+    }
 }
 

package/src/legalDocument/api/interfaces/ILegalDocumentApi.ts

@@ -5,4 +5,10 @@ export interface ILegalDocumentApi {
     getPendingSign(directoryId: string): Promise<any>;
     getDirectoryAcceptanceByDirectoryId(directoryId: string): Promise<any>;
 
+    /**
+     * Documento legal vigente de un tipo (PRIVACY_PAY, etc.).
+     * Devuelve el documento con su URL firmada y el vencimiento de esa URL.
+     */
+    getDocumentByType(type: string): Promise<any>;
+
 }

package/src/retailCatalog/api/RetailCatalogBusinessApi.ts

@@ -2,6 +2,8 @@ import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
 import {
+    IMEI_PRODUCT_BATCH_MAX,
+    ImeiProductLookupResponse,
     IRetailCatalogBusinessApi,
     ReleaseReservationBody,
     ReserveInventoryBody,
@@ -42,6 +44,20 @@ export default class RetailCatalogBusinessApi implements IRetailCatalogBusinessA
         return await this.httpRequest.get(url, undefined, this.tenantHeader(issuer));
     }
 
+    async getProductsByImei(
+        imeis: string[],
+        tenantId: string,
+    ): Promise<StandardResponse<ImeiProductLookupResponse>> {
+        // Se corta acá: mandar un lote que el destino va a rechazar solo gasta un round-trip.
+        if (imeis.length > IMEI_PRODUCT_BATCH_MAX) {
+            throw new Error(`El lote admite hasta ${IMEI_PRODUCT_BATCH_MAX} IMEIs y llegaron ${imeis.length}`);
+        }
+        // `URLSearchParams` codifica la coma del separador; el destino hace `split(',')` sobre el
+        // valor ya decodificado por API Gateway.
+        const query = new URLSearchParams({ imeis: imeis.join(","), tenantId });
+        return await this.httpRequest.get(`${this.baseUrl}/private/products/by-imei?${query.toString()}`);
+    }
+
     async reserveInventory(
         imei: string,
         body: ReserveInventoryBody,

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

@@ -6,12 +6,17 @@ import type { MdmLockModeEnum, MdmProviderEnum } from "@fiado/type-kit/bin/retai
  * para sus endpoints privados del ciclo de venta del IMEI, consumidos por el wizard F2.
  *
  * ─────────────────────────────────────────────────────────────────────────────
- * TENANT — header `x-tenant-issuer` (NO `?tenantId=`).
+ * TENANT — DOS convenciones conviven acá. Mirá la firma de cada método.
  * ─────────────────────────────────────────────────────────────────────────────
- * A diferencia de customer/cards/loan-config (que resuelven el silo por `?tenantId=` canónico), este
- * lambda resuelve el tenant por el ISSUER Cognito forwardeado en el header `x-tenant-issuer`
- * (`PrivateController.issuerFromHeader` → `TenantContextService.withContext(issuer)`). Los privados son
- * `Feature.ANONIMUS` (sin RBAC; la protección es la red VPC), así que el caller DEBE declarar el issuer.
+ * Los cinco métodos del ciclo de venta del IMEI toman `issuer` y lo mandan en el header
+ * `x-tenant-issuer` (`PrivateController.issuerFromHeader` → `TenantContextService.withContext`).
+ * `getProductsByImei` toma `tenantId` y lo manda por `?tenantId=`
+ * (→ `TenantContextService.withContextByTenantId`), porque su consumidor es un backoffice que no
+ * tiene el issuer Cognito. Los privados son `Feature.ANONIMUS` (sin RBAC; la protección es la red
+ * VPC), así que el caller DEBE declarar uno de los dos — no hay default.
+ *
+ * TD: converger los cinco del ciclo de venta a `?tenantId=`, el camino canónico para
+ * service-to-service. No se migran acá para no romper al wizard, que ya consume el header.
  *
  * ⚠️ Retorno `StandardResponse<T>` — el consumer lee `result.data`, NO `result.body`.
  * Errores: el destino lanza `DomainError` tipado → el publisher RECHAZA (no devuelve null); cada
@@ -62,6 +67,32 @@ export interface StoreCatalogItem {
     mdmLockMode: MdmLockModeEnum | null;
 }
 
+/** Techo de IMEIs por request del lote IMEI->producto. Lo declara y lo honra el destino. */
+export const IMEI_PRODUCT_BATCH_MAX = 100;
+
+/** Por que se pudo (o no) resolver el producto de un IMEI del lote. */
+export type ImeiProductLookupStatus = "OK" | "NOT_FOUND" | "UNAVAILABLE" | "INVALID_ID";
+
+/** Una entrada del lote IMEI->producto (espeja `ImeiProductLookupEntry` del destino). */
+export interface ImeiProductLookupEntry {
+    imei: string;
+    /**
+     * `OK` trae sku/brand/model · `NOT_FOUND` el catalogo no llega al producto (dato POSITIVO) ·
+     * `UNAVAILABLE` no se pudo leer ese IMEI, reintentalo · `INVALID_ID` no tiene forma de IMEI.
+     */
+    status: ImeiProductLookupStatus;
+    sku?: string;
+    /** Marca comercial (p. ej. "Apple"). Solo viene con `status: OK`. */
+    brand?: string;
+    /** Modelo (p. ej. "iPhone 15 Pro"). Solo viene con `status: OK`. */
+    model?: string;
+}
+
+/** Respuesta del lote: UNA entrada por IMEI pedido, en el MISMO orden. */
+export interface ImeiProductLookupResponse {
+    items: ImeiProductLookupEntry[];
+}
+
 /** Resultado de la reserva (espeja `ReserveInventoryResponse` del destino). */
 export interface ReserveInventoryResult {
     reservationExpiresAt: string;
@@ -88,6 +119,31 @@ export interface IRetailCatalogBusinessApi {
     /** GET `/private/stores/{storeId}/catalog` — catálogo vendible (sku, imei, precio de contado, disponibilidad). */
     getStoreCatalog(storeId: string, issuer: string): Promise<StandardResponse<StoreCatalogItem[]>>;
 
+    /**
+     * GET `/private/products/by-imei?imeis=&tenantId=` — resuelve un lote de IMEIs a su producto
+     * (sku + marca + modelo). Para los lambdas que del equipo solo guardan el IMEI.
+     *
+     * ─────────────────────────────────────────────────────────────────────────────
+     * ⚠️ El tenant va por `?tenantId=`, NO por el header `x-tenant-issuer` del resto de este publisher.
+     * ─────────────────────────────────────────────────────────────────────────────
+     * El consumidor es un backoffice que solo tiene el `tenantId` de su contexto; el issuer Cognito
+     * no existe de su lado. El destino entra por `TenantContextService.withContextByTenantId`, con las
+     * mismas garantías (mismo diccionario, AssumeRole del silo, fail-closed sin tenant).
+     *
+     * ── El contrato del lote ────────────────────────────────────────────────────────────────────
+     * Devuelve UNA entrada por cada IMEI pedido, en el MISMO orden — el caller nunca reconcilia. Los
+     * repetidos se consultan una sola vez pero salen repetidos. Techo de `IMEI_PRODUCT_BATCH_MAX`
+     * IMEIs por request; el caller parte los lotes mayores.
+     *
+     * Ningún IMEI tumba el lote: el mal formado sale `INVALID_ID`, el que el catálogo no alcanza a
+     * resolver sale `NOT_FOUND` y el que DynamoDB no llegó a leer sale `UNAVAILABLE` (reintentable).
+     * Solo un fallo total del destino rechaza la promesa.
+     *
+     * @throws Error si el lote supera el techo (se corta acá, sin salir a la red) ·
+     *   `400 IMEI_BATCH_REQUIRED` si `imeis` viene vacío · `400 UNKNOWN_TENANT` sin `tenantId`.
+     */
+    getProductsByImei(imeis: string[], tenantId: string): Promise<StandardResponse<ImeiProductLookupResponse>>;
+
     /** PUT `/private/inventory/{imei}/reserve` — reserva atómica del IMEI para una sesión (AVAILABLE → RESERVED). */
     reserveInventory(imei: string, body: ReserveInventoryBody, issuer: string): Promise<StandardResponse<ReserveInventoryResult>>;