@fiado/type-kit 3.449.0 → 3.451.0

package/_test_/unit/productCatalog/dtos/CreateProductCatalogRequest.test.ts

@@ -0,0 +1,37 @@
+import 'reflect-metadata';
+import { validate } from "class-validator";
+import { plainToInstance } from "class-transformer";
+import { CreateProductCatalogRequest } from "../../../../src/productCatalog/dtos/CreateProductCatalogRequest";
+
+describe("CreateProductCatalogRequest — campo minFee", () => {
+    const base = {
+        id: "SP_CASH_IN",
+        description: "Comisión fondeo en efectivo",
+        displayName: "Comisión fondeo en efectivo",
+        type: "SP_CASH_IN",
+        currencyId: "484",
+        feeType: "PERCENT_WITH_MIN",
+        fee: 3.5,
+        taxType: "PERCENT",
+        tax: 16,
+    };
+
+    it("acepta minFee numérico >= 0", async () => {
+        const dto = plainToInstance(CreateProductCatalogRequest, { ...base, minFee: 10 });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it("acepta minFee ausente (opcional, retro-compat)", async () => {
+        const dto = plainToInstance(CreateProductCatalogRequest, base);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it("rechaza minFee no numérico", async () => {
+        const dto = plainToInstance(CreateProductCatalogRequest, { ...base, minFee: "diez" });
+        const errors = await validate(dto);
+        expect(errors.length).toBeGreaterThan(0);
+        expect(errors[0].property).toBe("minFee");
+    });
+});

package/_test_/unit/productCatalog/dtos/GetProductCatalogResponse.test.ts

@@ -0,0 +1,39 @@
+import 'reflect-metadata';
+import { validate } from "class-validator";
+import { plainToInstance } from "class-transformer";
+import GetProductCatalogResponse from "../../../../src/productCatalog/dtos/GetProductCatalogResponse";
+
+describe("GetProductCatalogResponse — campo minFee", () => {
+    const base = {
+        id: "SP_CASH_IN",
+        description: "Comisión fondeo en efectivo",
+        displayName: "Comisión fondeo en efectivo",
+        type: "SP_CASH_IN",
+        currencyId: "484",
+        feeType: "PERCENT_WITH_MIN",
+        fee: 3.5,
+        taxType: "PERCENT",
+        tax: 16,
+        createdAt: "2026-01-01T00:00:00Z",
+        updatedAt: "2026-09-19T00:00:00Z",
+    };
+
+    it("acepta minFee numérico >= 0", async () => {
+        const dto = plainToInstance(GetProductCatalogResponse, { ...base, minFee: 10 });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it("acepta minFee ausente (opcional, retro-compat)", async () => {
+        const dto = plainToInstance(GetProductCatalogResponse, base);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it("rechaza minFee no numérico", async () => {
+        const dto = plainToInstance(GetProductCatalogResponse, { ...base, minFee: "diez" });
+        const errors = await validate(dto);
+        expect(errors.length).toBeGreaterThan(0);
+        expect(errors[0].property).toBe("minFee");
+    });
+});

package/_test_/unit/productCatalog/enums/ProductTaxFeeTypeEnum.test.ts

@@ -0,0 +1,13 @@
+import 'reflect-metadata';
+import { ProductTaxFeeTypeEnum } from "../../../../src/productCatalog/enums/ProductTaxFeeTypeEnum";
+
+describe("ProductTaxFeeTypeEnum", () => {
+    it("incluye PERCENT_WITH_MIN para tarifas con piso", () => {
+        expect(ProductTaxFeeTypeEnum.PERCENT_WITH_MIN).toBe("PERCENT_WITH_MIN");
+    });
+
+    it("preserva valores existentes PERCENT y FIXED", () => {
+        expect(ProductTaxFeeTypeEnum.PERCENT).toBe("PERCENT");
+        expect(ProductTaxFeeTypeEnum.FIXED).toBe("FIXED");
+    });
+});

package/bin/productCatalog/dtos/CreateProductCatalogRequest.d.ts

@@ -11,4 +11,5 @@ export declare class CreateProductCatalogRequest {
     fee: number;
     taxType: ProductTaxFeeTypeEnum;
     tax: number;
+    minFee?: number;
 }

package/bin/productCatalog/dtos/CreateProductCatalogRequest.js

@@ -1,6 +1,21 @@
 "use strict";
+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);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateProductCatalogRequest = void 0;
+const class_validator_1 = require("class-validator");
 class CreateProductCatalogRequest {
 }
 exports.CreateProductCatalogRequest = CreateProductCatalogRequest;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], CreateProductCatalogRequest.prototype, "minFee", void 0);

package/bin/productCatalog/dtos/GetProductCatalogResponse.d.ts

@@ -11,6 +11,7 @@ export default class GetProductCatalogResponse {
     fee: number;
     taxType: ProductTaxFeeTypeEnum;
     tax: number;
+    minFee?: number;
     createdAt: string;
     updatedAt: string;
 }

package/bin/productCatalog/dtos/GetProductCatalogResponse.js

@@ -52,6 +52,11 @@ __decorate([
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
 ], GetProductCatalogResponse.prototype, "tax", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], GetProductCatalogResponse.prototype, "minFee", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/productCatalog/enums/ProductTaxFeeTypeEnum.d.ts

@@ -1,4 +1,5 @@
 export declare enum ProductTaxFeeTypeEnum {
     PERCENT = "PERCENT",
-    FIXED = "FIXED"
+    FIXED = "FIXED",
+    PERCENT_WITH_MIN = "PERCENT_WITH_MIN"
 }

package/bin/productCatalog/enums/ProductTaxFeeTypeEnum.js

@@ -5,4 +5,5 @@ var ProductTaxFeeTypeEnum;
 (function (ProductTaxFeeTypeEnum) {
     ProductTaxFeeTypeEnum["PERCENT"] = "PERCENT";
     ProductTaxFeeTypeEnum["FIXED"] = "FIXED";
+    ProductTaxFeeTypeEnum["PERCENT_WITH_MIN"] = "PERCENT_WITH_MIN";
 })(ProductTaxFeeTypeEnum || (exports.ProductTaxFeeTypeEnum = ProductTaxFeeTypeEnum = {}));

package/bin/remittance/dtos/RemittanceBackofficeTransaction.d.ts

@@ -1,10 +1,17 @@
 import { RemittanceTxStatus } from "../enums/RemittanceTxStatus";
 import { RemittanceCancelStageEnum } from "../enums/RemittanceCancelStageEnum";
 import { RemittanceCancelOutcomeEnum } from "../enums/RemittanceCancelOutcomeEnum";
+import { RemittanceReconStatus } from "../enums/RemittanceReconStatus";
 /**
  * Vista operativa COMPLETA de una tx para el backoffice (F9): incluye campos
  * de trazabilidad (previewRef, idempotencyKey, marketplaceTransactionNumber
  * para correlación con el procesador) que el DTO de usuario no expone.
+ *
+ * A partir de Fase B de Uniteller también incluye los campos de enrichment
+ * poblados por el pipeline SUTWEB38 (unitellerCostTicket, netMarginUsd,
+ * reconStatus, etc.) — todos opcionales, filas creadas antes de la
+ * implementación no los tienen. Ver `RemittanceReconciliationFields` para
+ * el shape canónico.
  */
 export declare class RemittanceBackofficeTransaction {
     directoryId: string;
@@ -68,4 +75,24 @@ export declare class RemittanceBackofficeTransaction {
     updatedAt: string;
     createdBy?: string;
     updatedBy?: string;
+    /** Processing Fee (costo per-tx) reportado por Uniteller en TxDetails. */
+    unitellerCostTicket?: number;
+    /** Fx Gain reportado por Uniteller (para reconciliar contra cálculo local). */
+    unitellerFxGainReported?: number;
+    /** Liquidation Rate real que Uniteller aplicó (wholesale efectivo). */
+    liquidationRateReported?: number;
+    /** Retail Rate que Uniteller cobró al cliente. */
+    retailRateReported?: number;
+    /** serviceFee + fxGainUsdLocal − unitellerCostTicket. Redondeo 2 decimales. */
+    netMarginUsd?: number;
+    /** YYYY-MM-DD del reporte SUTWEB38 que pobló los campos anteriores. */
+    providerStatementDate?: string;
+    /** S3 key del CSV que pobló los campos (trazabilidad + idempotencia). */
+    providerStatementSourceKey?: string;
+    /** ISO UTC del enrichment. */
+    providerStatementAppliedAt?: string;
+    /** Estado de reconciliación calculado por AssertionEngine. */
+    reconStatus?: RemittanceReconStatus;
+    /** Detalle textual de los diffs cuando reconStatus !== OK. */
+    reconDiffDetail?: string;
 }

package/bin/remittance/dtos/RemittanceBackofficeTransaction.js

@@ -5,6 +5,12 @@ exports.RemittanceBackofficeTransaction = void 0;
  * Vista operativa COMPLETA de una tx para el backoffice (F9): incluye campos
  * de trazabilidad (previewRef, idempotencyKey, marketplaceTransactionNumber
  * para correlación con el procesador) que el DTO de usuario no expone.
+ *
+ * A partir de Fase B de Uniteller también incluye los campos de enrichment
+ * poblados por el pipeline SUTWEB38 (unitellerCostTicket, netMarginUsd,
+ * reconStatus, etc.) — todos opcionales, filas creadas antes de la
+ * implementación no los tienen. Ver `RemittanceReconciliationFields` para
+ * el shape canónico.
  */
 class RemittanceBackofficeTransaction {
 }

package/bin/remittance/dtos/RemittanceReconciliation.d.ts

@@ -0,0 +1,61 @@
+import { RemittanceReconStatus } from "../enums/RemittanceReconStatus";
+/**
+ * Campos de enrichment poblados en una tx local por el pipeline de ingesta
+ * SUTWEB38 del uniteller-connector, cuando aterriza el archivo TxDetails del
+ * día y matchea la tx por `txIdentifier === txNumber`. Todos son opcionales
+ * — filas de tx creadas antes de la implementación de Fase B no los tienen.
+ *
+ * Se comparte como interface (no class) para que otros DTOs (por ejemplo
+ * `RemittanceBackofficeTransaction`) la extiendan o intersecten sin duplicar
+ * definiciones.
+ *
+ * Ver spec Cap 4.2.
+ */
+export interface RemittanceReconciliationFields {
+    /**
+     * Processing Fee reportado por Uniteller en la fila TxDetails del SUTWEB38.
+     * Es el costo per-tx que Uniteller cobra a Fiado (consolida "UNITELLER
+     * processing Cost" + "Payer Cost" del Exhibit A del contrato firmado).
+     */
+    unitellerCostTicket?: number;
+    /**
+     * Fx Gain reportado por Uniteller en la fila TxDetails. Se usa para
+     * reconciliar contra el cálculo local `amountUSD × markupBps / 10000`.
+     * Diff sistemática apunta a redondeo o a que Uniteller aplicó un rate
+     * distinto al instruido.
+     */
+    unitellerFxGainReported?: number;
+    /**
+     * Liquidation Rate reportado por Uniteller (rate wholesale efectivamente
+     * aplicado). Se compara contra el `wholesaleRate` snapshot local para
+     * detectar drift silencioso de FX.
+     */
+    liquidationRateReported?: number;
+    /** Retail Rate reportado por Uniteller (rate que cobró al cliente). */
+    retailRateReported?: number;
+    /**
+     * Margen neto USD por transacción calculado como:
+     *     serviceFee + (amountUSD × markupBps / 10000) − unitellerCostTicket
+     * Redondeado a 2 decimales.
+     */
+    netMarginUsd?: number;
+    /**
+     * Fecha del reporte SUTWEB38 (YYYY-MM-DD) que pobló los campos anteriores.
+     * Derivada del filename `SUTWEBXX_TxDetails_MMDDYYYY_MMDDYYYY.csv`.
+     */
+    providerStatementDate?: string;
+    /**
+     * S3 key del archivo CSV que pobló los campos (para trazabilidad
+     * regulatoria y para la idempotencia por conditional write DDB).
+     */
+    providerStatementSourceKey?: string;
+    /** ISO UTC del momento en que se aplicó el enrichment. */
+    providerStatementAppliedAt?: string;
+    /** Estado de reconciliación calculado por AssertionEngine. */
+    reconStatus?: RemittanceReconStatus;
+    /**
+     * Descripción textual concatenada de los diffs encontrados (ej.
+     * "amountUSD 150 vs stmt 151; fx local 0.585 vs stmt 2.0").
+     */
+    reconDiffDetail?: string;
+}

package/bin/remittance/dtos/RemittanceReconciliation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/remittance/dtos/index.d.ts

@@ -31,6 +31,7 @@ export * from "./RemittanceSmsRequest";
 export * from "./RemittanceBackofficeUserView";
 export * from "./RemittanceBackofficeDashboardSummary";
 export * from "./RemittanceBackofficeTransaction";
+export * from "./RemittanceReconciliation";
 export * from "./RemittanceBackofficeUserDetail";
 export * from "./RemittanceBackofficeUserListResponse";
 export * from "./RemittanceBackofficeTxListResponse";

package/bin/remittance/dtos/index.js

@@ -47,6 +47,7 @@ __exportStar(require("./RemittanceSmsRequest"), exports);
 __exportStar(require("./RemittanceBackofficeUserView"), exports);
 __exportStar(require("./RemittanceBackofficeDashboardSummary"), exports);
 __exportStar(require("./RemittanceBackofficeTransaction"), exports);
+__exportStar(require("./RemittanceReconciliation"), exports);
 __exportStar(require("./RemittanceBackofficeUserDetail"), exports);
 __exportStar(require("./RemittanceBackofficeUserListResponse"), exports);
 __exportStar(require("./RemittanceBackofficeTxListResponse"), exports);

package/bin/remittance/enums/RemittanceReconStatus.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Estado de reconciliación de una tx local contra el reporte SUTWEB38 diario
+ * de Uniteller. Poblado por AssertionEngine del uniteller-connector al ingerir
+ * el archivo TxDetails. Ver spec de reconciliación Cap 6 (motor de aserciones).
+ *
+ * Prioridad si múltiples diffs: DIFF_COST > DIFF_FX > DIFF_RATE > DIFF_AMOUNT > OK.
+ */
+export declare enum RemittanceReconStatus {
+    OK = "OK",
+    DIFF_FX = "DIFF_FX",
+    DIFF_COST = "DIFF_COST",
+    DIFF_RATE = "DIFF_RATE",
+    DIFF_AMOUNT = "DIFF_AMOUNT",
+    MISSING_IN_PROVIDER = "MISSING_IN_PROVIDER"
+}

package/bin/remittance/enums/RemittanceReconStatus.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceReconStatus = void 0;
+/**
+ * Estado de reconciliación de una tx local contra el reporte SUTWEB38 diario
+ * de Uniteller. Poblado por AssertionEngine del uniteller-connector al ingerir
+ * el archivo TxDetails. Ver spec de reconciliación Cap 6 (motor de aserciones).
+ *
+ * Prioridad si múltiples diffs: DIFF_COST > DIFF_FX > DIFF_RATE > DIFF_AMOUNT > OK.
+ */
+var RemittanceReconStatus;
+(function (RemittanceReconStatus) {
+    RemittanceReconStatus["OK"] = "OK";
+    RemittanceReconStatus["DIFF_FX"] = "DIFF_FX";
+    RemittanceReconStatus["DIFF_COST"] = "DIFF_COST";
+    RemittanceReconStatus["DIFF_RATE"] = "DIFF_RATE";
+    RemittanceReconStatus["DIFF_AMOUNT"] = "DIFF_AMOUNT";
+    RemittanceReconStatus["MISSING_IN_PROVIDER"] = "MISSING_IN_PROVIDER";
+})(RemittanceReconStatus || (exports.RemittanceReconStatus = RemittanceReconStatus = {}));

package/bin/remittance/enums/index.d.ts

@@ -25,3 +25,4 @@ export * from "./RuleActionType";
 export * from "./AuditResult";
 export * from "./RemittanceExceptionCode";
 export * from "./RemittanceFieldBelongsTo";
+export * from "./RemittanceReconStatus";

package/bin/remittance/enums/index.js

@@ -41,3 +41,4 @@ __exportStar(require("./RuleActionType"), exports);
 __exportStar(require("./AuditResult"), exports);
 __exportStar(require("./RemittanceExceptionCode"), exports);
 __exportStar(require("./RemittanceFieldBelongsTo"), exports);
+__exportStar(require("./RemittanceReconStatus"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.449.0",
+  "version": "3.451.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/productCatalog/dtos/CreateProductCatalogRequest.ts

@@ -1,6 +1,7 @@
 import {CountryId} from "../../country";
 import {ProductTaxFeeTypeEnum} from "../enums/ProductTaxFeeTypeEnum";
 import {ProductTypeEnum} from "../enums/ProductTypeEnum";
+import {IsNumber, IsOptional} from "class-validator";
 
 export class CreateProductCatalogRequest {
     id: string;
@@ -12,4 +13,8 @@ export class CreateProductCatalogRequest {
     fee: number;
     taxType: ProductTaxFeeTypeEnum;
     tax: number;
+
+    @IsOptional()
+    @IsNumber()
+    minFee?: number;
 }

package/src/productCatalog/dtos/GetProductCatalogResponse.ts

@@ -1,6 +1,6 @@
 import {CountryId} from "../../country";
 import {ProductTaxFeeTypeEnum} from "../enums/ProductTaxFeeTypeEnum";
-import {IsEnum, IsNumber, IsString} from "class-validator";
+import {IsEnum, IsNumber, IsOptional, IsString} from "class-validator";
 import {ProductTypeEnum} from "../enums/ProductTypeEnum";
 
 export default class GetProductCatalogResponse {
@@ -31,6 +31,10 @@ export default class GetProductCatalogResponse {
     @IsNumber()
     tax: number;
 
+    @IsOptional()
+    @IsNumber()
+    minFee?: number;
+
     @IsString()
     createdAt: string;
 

package/src/productCatalog/enums/ProductTaxFeeTypeEnum.ts

@@ -1,4 +1,5 @@
 export enum ProductTaxFeeTypeEnum {
     PERCENT = "PERCENT",
-    FIXED = "FIXED"
+    FIXED = "FIXED",
+    PERCENT_WITH_MIN = "PERCENT_WITH_MIN",
 }

package/src/remittance/dtos/RemittanceBackofficeTransaction.ts

@@ -1,11 +1,18 @@
 import { RemittanceTxStatus } from "../enums/RemittanceTxStatus";
 import { RemittanceCancelStageEnum } from "../enums/RemittanceCancelStageEnum";
 import { RemittanceCancelOutcomeEnum } from "../enums/RemittanceCancelOutcomeEnum";
+import { RemittanceReconStatus } from "../enums/RemittanceReconStatus";
 
 /**
  * Vista operativa COMPLETA de una tx para el backoffice (F9): incluye campos
  * de trazabilidad (previewRef, idempotencyKey, marketplaceTransactionNumber
  * para correlación con el procesador) que el DTO de usuario no expone.
+ *
+ * A partir de Fase B de Uniteller también incluye los campos de enrichment
+ * poblados por el pipeline SUTWEB38 (unitellerCostTicket, netMarginUsd,
+ * reconStatus, etc.) — todos opcionales, filas creadas antes de la
+ * implementación no los tienen. Ver `RemittanceReconciliationFields` para
+ * el shape canónico.
  */
 export class RemittanceBackofficeTransaction {
     directoryId!: string;
@@ -69,4 +76,30 @@ export class RemittanceBackofficeTransaction {
     updatedAt!: string;
     createdBy?: string;
     updatedBy?: string;
+
+    // ─── Enrichment SUTWEB38 (Fase B Uniteller) ─────────────────────────
+    // Poblados por Sutweb38FilePipeline en uniteller-connector al aterrizar
+    // el archivo TxDetails del día que matchea txNumber. Ver
+    // RemittanceReconciliationFields para docs por campo.
+
+    /** Processing Fee (costo per-tx) reportado por Uniteller en TxDetails. */
+    unitellerCostTicket?: number;
+    /** Fx Gain reportado por Uniteller (para reconciliar contra cálculo local). */
+    unitellerFxGainReported?: number;
+    /** Liquidation Rate real que Uniteller aplicó (wholesale efectivo). */
+    liquidationRateReported?: number;
+    /** Retail Rate que Uniteller cobró al cliente. */
+    retailRateReported?: number;
+    /** serviceFee + fxGainUsdLocal − unitellerCostTicket. Redondeo 2 decimales. */
+    netMarginUsd?: number;
+    /** YYYY-MM-DD del reporte SUTWEB38 que pobló los campos anteriores. */
+    providerStatementDate?: string;
+    /** S3 key del CSV que pobló los campos (trazabilidad + idempotencia). */
+    providerStatementSourceKey?: string;
+    /** ISO UTC del enrichment. */
+    providerStatementAppliedAt?: string;
+    /** Estado de reconciliación calculado por AssertionEngine. */
+    reconStatus?: RemittanceReconStatus;
+    /** Detalle textual de los diffs cuando reconStatus !== OK. */
+    reconDiffDetail?: string;
 }

package/src/remittance/dtos/RemittanceReconciliation.ts

@@ -0,0 +1,71 @@
+import { RemittanceReconStatus } from "../enums/RemittanceReconStatus";
+
+/**
+ * Campos de enrichment poblados en una tx local por el pipeline de ingesta
+ * SUTWEB38 del uniteller-connector, cuando aterriza el archivo TxDetails del
+ * día y matchea la tx por `txIdentifier === txNumber`. Todos son opcionales
+ * — filas de tx creadas antes de la implementación de Fase B no los tienen.
+ *
+ * Se comparte como interface (no class) para que otros DTOs (por ejemplo
+ * `RemittanceBackofficeTransaction`) la extiendan o intersecten sin duplicar
+ * definiciones.
+ *
+ * Ver spec Cap 4.2.
+ */
+export interface RemittanceReconciliationFields {
+    /**
+     * Processing Fee reportado por Uniteller en la fila TxDetails del SUTWEB38.
+     * Es el costo per-tx que Uniteller cobra a Fiado (consolida "UNITELLER
+     * processing Cost" + "Payer Cost" del Exhibit A del contrato firmado).
+     */
+    unitellerCostTicket?: number;
+
+    /**
+     * Fx Gain reportado por Uniteller en la fila TxDetails. Se usa para
+     * reconciliar contra el cálculo local `amountUSD × markupBps / 10000`.
+     * Diff sistemática apunta a redondeo o a que Uniteller aplicó un rate
+     * distinto al instruido.
+     */
+    unitellerFxGainReported?: number;
+
+    /**
+     * Liquidation Rate reportado por Uniteller (rate wholesale efectivamente
+     * aplicado). Se compara contra el `wholesaleRate` snapshot local para
+     * detectar drift silencioso de FX.
+     */
+    liquidationRateReported?: number;
+
+    /** Retail Rate reportado por Uniteller (rate que cobró al cliente). */
+    retailRateReported?: number;
+
+    /**
+     * Margen neto USD por transacción calculado como:
+     *     serviceFee + (amountUSD × markupBps / 10000) − unitellerCostTicket
+     * Redondeado a 2 decimales.
+     */
+    netMarginUsd?: number;
+
+    /**
+     * Fecha del reporte SUTWEB38 (YYYY-MM-DD) que pobló los campos anteriores.
+     * Derivada del filename `SUTWEBXX_TxDetails_MMDDYYYY_MMDDYYYY.csv`.
+     */
+    providerStatementDate?: string;
+
+    /**
+     * S3 key del archivo CSV que pobló los campos (para trazabilidad
+     * regulatoria y para la idempotencia por conditional write DDB).
+     */
+    providerStatementSourceKey?: string;
+
+    /** ISO UTC del momento en que se aplicó el enrichment. */
+    providerStatementAppliedAt?: string;
+
+    /** Estado de reconciliación calculado por AssertionEngine. */
+    reconStatus?: RemittanceReconStatus;
+
+    /**
+     * Descripción textual concatenada de los diffs encontrados (ej.
+     * "amountUSD 150 vs stmt 151; fx local 0.585 vs stmt 2.0").
+     */
+    reconDiffDetail?: string;
+}

package/src/remittance/dtos/index.ts

@@ -31,6 +31,7 @@ export * from "./RemittanceSmsRequest";
 export * from "./RemittanceBackofficeUserView";
 export * from "./RemittanceBackofficeDashboardSummary";
 export * from "./RemittanceBackofficeTransaction";
+export * from "./RemittanceReconciliation";
 export * from "./RemittanceBackofficeUserDetail";
 export * from "./RemittanceBackofficeUserListResponse";
 export * from "./RemittanceBackofficeTxListResponse";

package/src/remittance/enums/RemittanceReconStatus.ts

@@ -0,0 +1,15 @@
+/**
+ * Estado de reconciliación de una tx local contra el reporte SUTWEB38 diario
+ * de Uniteller. Poblado por AssertionEngine del uniteller-connector al ingerir
+ * el archivo TxDetails. Ver spec de reconciliación Cap 6 (motor de aserciones).
+ *
+ * Prioridad si múltiples diffs: DIFF_COST > DIFF_FX > DIFF_RATE > DIFF_AMOUNT > OK.
+ */
+export enum RemittanceReconStatus {
+    OK = "OK",
+    DIFF_FX = "DIFF_FX",
+    DIFF_COST = "DIFF_COST",
+    DIFF_RATE = "DIFF_RATE",
+    DIFF_AMOUNT = "DIFF_AMOUNT",
+    MISSING_IN_PROVIDER = "MISSING_IN_PROVIDER",
+}

package/src/remittance/enums/index.ts

@@ -25,3 +25,4 @@ export * from "./RuleActionType";
 export * from "./AuditResult";
 export * from "./RemittanceExceptionCode";
 export * from "./RemittanceFieldBelongsTo";
+export * from "./RemittanceReconStatus";