@fiado/type-kit 3.575.0 → 3.577.0

package/_test_/unit/remittance/RemittanceProviderCost.test.ts

@@ -0,0 +1,78 @@
+import "reflect-metadata";
+import { plainToInstance } from "class-transformer";
+import { validateSync } from "class-validator";
+import { ProviderCostUpdateRequest } from "../../../src/remittance/dtos/RemittanceProviderCost";
+import { SimulatePricingRequest, UpdatePricingRequest } from "../../../src/remittance/dtos/RemittancePricing";
+import { PricingResolveRequest } from "../../../src/remittance/dtos/internal/RemittancePricingResolve";
+
+const errorsOf = <T extends object>(cls: new () => T, plain: object) =>
+    validateSync(plainToInstance(cls, plain), { whitelist: true, forbidNonWhitelisted: true });
+
+describe("ProviderCostUpdateRequest", () => {
+    it("acepta grupos con tres precios, tramo y asignaciones", () => {
+        expect(errorsOf(ProviderCostUpdateRequest, {
+            costTier: 1,
+            groups: [{ groupId: "A", costsUSD: [3, 2.75, 2.6] }],
+            assignments: [
+                { payerCode: "GCA8", receptionMethod: "CASH_PICKUP", groupId: "B" },
+                { payerCode: "GCA12", receptionMethod: "CASH_PICKUP", groupId: null },
+            ],
+        })).toHaveLength(0);
+    });
+
+    it("rechaza un grupo sin los tres precios", () => {
+        expect(errorsOf(ProviderCostUpdateRequest, { groups: [{ groupId: "A", costsUSD: [3, 2.75] }] })).not.toHaveLength(0);
+    });
+
+    it("rechaza ids de grupo que no son una letra mayúscula", () => {
+        expect(errorsOf(ProviderCostUpdateRequest, { groups: [{ groupId: "AB", costsUSD: [3, 2.75, 2.6] }] })).not.toHaveLength(0);
+        expect(errorsOf(ProviderCostUpdateRequest, { assignments: [{ payerCode: "GCA8", receptionMethod: "CASH_PICKUP", groupId: "b" }] })).not.toHaveLength(0);
+    });
+
+    it("rechaza precios con más de dos decimales o fuera de rango", () => {
+        expect(errorsOf(ProviderCostUpdateRequest, { groups: [{ groupId: "A", costsUSD: [3.001, 2.75, 2.6] }] })).not.toHaveLength(0);
+        expect(errorsOf(ProviderCostUpdateRequest, { groups: [{ groupId: "A", costsUSD: [-1, 2.75, 2.6] }] })).not.toHaveLength(0);
+    });
+
+    it("rechaza un tramo fuera de 1..3", () => {
+        expect(errorsOf(ProviderCostUpdateRequest, { costTier: 4 })).not.toHaveLength(0);
+    });
+});
+
+describe("ajustes de fee por grupo", () => {
+    const tramos = [{ amountMin: 25, amountMax: null, serviceFee: 2.99, effectiveFrom: "2026-10-23" }];
+
+    it("UpdatePricingRequest acepta groupFeeAdjustments con signo", () => {
+        expect(errorsOf(UpdatePricingRequest, {
+            markupBps: 120, tramos,
+            groupFeeAdjustments: [{ groupId: "C", adjustmentUSD: 1 }, { groupId: "A", adjustmentUSD: -0.5 }],
+        })).toHaveLength(0);
+    });
+
+    it("UpdatePricingRequest sigue válido sin groupFeeAdjustments", () => {
+        expect(errorsOf(UpdatePricingRequest, { markupBps: 120, tramos })).toHaveLength(0);
+    });
+
+    it("SimulatePricingRequest acepta payer y método", () => {
+        expect(errorsOf(SimulatePricingRequest, {
+            corridor: "USD-GTQ", amountUSD: 200, markupBps: 120, tramos,
+            payerCode: "GCA10", receptionMethod: "CASH_PICKUP",
+        })).toHaveLength(0);
+    });
+});
+
+describe("PricingResolveRequest", () => {
+    it("acepta payer y método opcionales", () => {
+        expect(errorsOf(PricingResolveRequest, {
+            directoryId: "8f14e45f-ceea-467f-a8f8-3c1a3f6b1d2e", corridor: "USD-GTQ", amountUSD: 200,
+            payerCode: "GCA10", receptionMethod: "ACCOUNT_CREDIT",
+        })).toHaveLength(0);
+    });
+
+    it("rechaza un método que no existe", () => {
+        expect(errorsOf(PricingResolveRequest, {
+            directoryId: "8f14e45f-ceea-467f-a8f8-3c1a3f6b1d2e", corridor: "USD-GTQ", amountUSD: 200,
+            receptionMethod: "CARRIER_PIGEON",
+        })).not.toHaveLength(0);
+    });
+});

package/_test_/unit/retailCommission/commissionRules.test.ts

@@ -113,6 +113,14 @@ describe('retailCommission — regla, políticas y snapshot', () => {
         expect(monthly.payTiming).toBe('MONTHLY');
     });
 
+    it('la regla puede traer adelanto al momento, o null, o nada', () => {
+        const withAdvance: RetailCommission.CommissionRule = { ...base, payTiming: RetailCommission.CommissionPayTimingEnum.MONTHLY, onSaleAdvanceBps: 3000 };
+        const none: RetailCommission.CommissionRule = { ...base, onSaleAdvanceBps: null };
+        expect(base.onSaleAdvanceBps).toBeUndefined();
+        expect(withAdvance.onSaleAdvanceBps).toBe(3000);
+        expect(none.onSaleAdvanceBps).toBeNull();
+    });
+
     it('el snapshot congela las reglas publicadas y las políticas', () => {
         const snapshot: RetailCommission.CommissionRuleSetSnapshot = {
             retailerId: 'RET-1',
@@ -276,6 +284,26 @@ describe('retailCommission — contratos de reglas y políticas', () => {
         expect(view.payTiming).toBe('ON_SALE');
     });
 
+    it('el editor manda el adelanto y el vendedor lo ve', () => {
+        const create: RetailCommission.CreateRuleRequest = { ...input, payTiming: RetailCommission.CommissionPayTimingEnum.MONTHLY, onSaleAdvanceBps: 3000 };
+        const clear: RetailCommission.CreateRuleRequest = { ...input, onSaleAdvanceBps: null };
+        const view: RetailCommission.CommissionRuleView = {
+            ruleId: 'RC-01',
+            name: create.name,
+            description: create.description,
+            levers: create.levers,
+            scope: create.scope,
+            condition: create.condition,
+            effectiveFrom: create.effectiveFrom,
+            effectiveTo: create.effectiveTo,
+            payTiming: create.payTiming,
+            onSaleAdvanceBps: create.onSaleAdvanceBps,
+        };
+        expect(input.onSaleAdvanceBps).toBeUndefined();
+        expect(clear.onSaleAdvanceBps).toBeNull();
+        expect(view.onSaleAdvanceBps).toBe(3000);
+    });
+
     it('las políticas se guardan juntas', () => {
         const request: RetailCommission.UpdatePoliciesRequest = {
             clawback: { cancelacionDias: 7, devolucionDias: 7, npiM30Dias: 30 },

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

@@ -95,4 +95,12 @@ export declare class RemittanceBackofficeTransaction {
     reconStatus?: RemittanceReconStatus;
     /** Detalle textual de los diffs cuando reconStatus !== OK. */
     reconDiffDetail?: string;
+    /** Costo UniTeller esperado en USD según el grupo y el tramo vigente al enviar. */
+    unitellerCostExpected?: number;
+    /** Grupo de costo del payer × método al enviar. */
+    costGroup?: string;
+    /** Tramo de volumen vigente al enviar (1..3). */
+    costTier?: number;
+    /** Ajuste del grupo que se sumó al fee de esta remesa. */
+    groupFeeAdjustment?: number;
 }

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

@@ -1,4 +1,5 @@
 import { ReceptionMethod } from "../enums/ReceptionMethod";
+import { CostGroupByMethod } from "./RemittanceProviderCost";
 /**
  * DTOs de la administración de payers desde el backoffice (v1: enabled + override de nombre).
  * La lista de payers la dicta el catálogo UniTeller; la config es un overlay por payerCode.
@@ -18,6 +19,8 @@ export declare class RemittancePayerConfigItem {
     configured: boolean;
     /** Logo de UniTeller, solo lectura (identificación visual en la lista). */
     logoUrl?: string;
+    /** Grupo de costo UniTeller de cada método (solo lectura aquí; se edita en Costos UniTeller). */
+    costGroupByMethod?: CostGroupByMethod;
 }
 /** Response de GET /backoffice/config/payers (config chica, sin paginación). */
 export declare class RemittancePayerConfigListResponse {

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

@@ -1,4 +1,5 @@
 import { RemittanceCorridor } from "../enums/RemittanceCorridor";
+import { ReceptionMethod } from "../enums/ReceptionMethod";
 /**
  * DTOs de Precio Base (Dashboard Ops · Variables Operativas §1).
  *
@@ -20,6 +21,12 @@ export declare class PricingTier {
     /** ISO date (YYYY-MM-DD) "FEE DESDE" — informativo. */
     effectiveFrom: string;
 }
+/** Ajuste en USD que se suma al fee del tramo cuando el payer × método cae en ese grupo de costo. */
+export declare class PricingGroupFeeAdjustment {
+    groupId: string;
+    /** CON SIGNO: negativo descuenta. El fee final nunca baja de 0. */
+    adjustmentUSD: number;
+}
 /** Body de POST /backoffice/pricing/base. */
 export declare class CreatePricingRequest {
     corridor: RemittanceCorridor;
@@ -29,6 +36,8 @@ export declare class CreatePricingRequest {
     tramos: PricingTier[];
     name?: string;
     notes?: string;
+    /** Ajuste del fee por grupo de costo del payer. Ausente = conserva los actuales; [] = sin ajustes. */
+    groupFeeAdjustments?: PricingGroupFeeAdjustment[];
 }
 /** Body de PUT /backoffice/pricing/base/{id} (reemplazo completo; corridor/segmentId inmutables). */
 export declare class UpdatePricingRequest {
@@ -36,6 +45,8 @@ export declare class UpdatePricingRequest {
     tramos: PricingTier[];
     name?: string;
     notes?: string;
+    /** Ajuste del fee por grupo de costo del payer. Ausente = conserva los actuales; [] = sin ajustes. */
+    groupFeeAdjustments?: PricingGroupFeeAdjustment[];
 }
 /** Combinación completa (response de list/create/update). */
 export declare class PricingCombination {
@@ -48,6 +59,8 @@ export declare class PricingCombination {
     tramos: PricingTier[];
     /** # promos activas que aplican a la combinación. 0 hasta que exista Promociones. */
     promosCount: number;
+    /** Ajuste del fee por grupo de costo. Ausente o [] = sin ajustes. */
+    groupFeeAdjustments?: PricingGroupFeeAdjustment[];
     name: string | null;
     notes: string | null;
     createdAt: string;
@@ -72,6 +85,11 @@ export declare class SimulatePricingRequest {
     amountUSD: number;
     markupBps: number;
     tramos: PricingTier[];
+    /** Ajustes del panel (pueden no estar guardados). Solo aplican si viene payer y método. */
+    groupFeeAdjustments?: PricingGroupFeeAdjustment[];
+    /** Payer y método opcionales: con ellos la simulación suma el ajuste del grupo y calcula costo y margen. */
+    payerCode?: string;
+    receptionMethod?: ReceptionMethod;
 }
 export declare class SimulatePricingResponse {
     /** ExternalQuickQuotes (vivo). */
@@ -90,6 +108,14 @@ export declare class SimulatePricingResponse {
     revenueUsd: number;
     /** ISO del quote. */
     asOf: string;
+    /** Grupo de costo del payer × método simulado. */
+    costGroup?: string;
+    /** Ajuste del grupo ya sumado en serviceFee. */
+    groupFeeAdjustment?: number;
+    /** Costo UniTeller esperado (Exhibit A, tramo vigente del país). */
+    unitellerCostExpected?: number;
+    /** revenueUsd − unitellerCostExpected. */
+    netMarginUsd?: number;
 }
 /** Response de GET /backoffice/pricing/wholesale?corridor= (rb passthrough del connector). */
 export declare class WholesaleRateResponse {

package/bin/remittance/dtos/RemittancePricing.js

@@ -9,10 +9,12 @@ 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.WholesaleRateResponse = exports.SimulatePricingResponse = exports.SimulatePricingRequest = exports.PricingCombinationMetrics = exports.PricingListResponse = exports.PricingCombination = exports.UpdatePricingRequest = exports.CreatePricingRequest = exports.PricingTier = void 0;
+exports.WholesaleRateResponse = exports.SimulatePricingResponse = exports.SimulatePricingRequest = exports.PricingCombinationMetrics = exports.PricingListResponse = exports.PricingCombination = exports.UpdatePricingRequest = exports.CreatePricingRequest = exports.PricingGroupFeeAdjustment = exports.PricingTier = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const RemittanceCorridor_1 = require("../enums/RemittanceCorridor");
+const ReceptionMethod_1 = require("../enums/ReceptionMethod");
+const RemittanceProviderCost_1 = require("./RemittanceProviderCost");
 /**
  * DTOs de Precio Base (Dashboard Ops · Variables Operativas §1).
  *
@@ -55,6 +57,21 @@ __decorate([
     (0, class_validator_1.Length)(10, 10),
     __metadata("design:type", String)
 ], PricingTier.prototype, "effectiveFrom", void 0);
+/** Ajuste en USD que se suma al fee del tramo cuando el payer × método cae en ese grupo de costo. */
+class PricingGroupFeeAdjustment {
+}
+exports.PricingGroupFeeAdjustment = PricingGroupFeeAdjustment;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(RemittanceProviderCost_1.PROVIDER_COST_GROUP_ID_PATTERN),
+    __metadata("design:type", String)
+], PricingGroupFeeAdjustment.prototype, "groupId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.Min)(-100),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], PricingGroupFeeAdjustment.prototype, "adjustmentUSD", void 0);
 /** Body de POST /backoffice/pricing/base. */
 class CreatePricingRequest {
 }
@@ -94,6 +111,14 @@ __decorate([
     (0, class_validator_1.MaxLength)(500),
     __metadata("design:type", String)
 ], CreatePricingRequest.prototype, "notes", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(10),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PricingGroupFeeAdjustment),
+    __metadata("design:type", Array)
+], CreatePricingRequest.prototype, "groupFeeAdjustments", void 0);
 /** Body de PUT /backoffice/pricing/base/{id} (reemplazo completo; corridor/segmentId inmutables). */
 class UpdatePricingRequest {
 }
@@ -124,6 +149,14 @@ __decorate([
     (0, class_validator_1.MaxLength)(500),
     __metadata("design:type", String)
 ], UpdatePricingRequest.prototype, "notes", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(10),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PricingGroupFeeAdjustment),
+    __metadata("design:type", Array)
+], UpdatePricingRequest.prototype, "groupFeeAdjustments", void 0);
 /** Combinación completa (response de list/create/update). */
 class PricingCombination {
 }
@@ -163,6 +196,25 @@ __decorate([
     (0, class_transformer_1.Type)(() => PricingTier),
     __metadata("design:type", Array)
 ], SimulatePricingRequest.prototype, "tramos", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(10),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PricingGroupFeeAdjustment),
+    __metadata("design:type", Array)
+], SimulatePricingRequest.prototype, "groupFeeAdjustments", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 40),
+    __metadata("design:type", String)
+], SimulatePricingRequest.prototype, "payerCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ReceptionMethod_1.ReceptionMethod),
+    __metadata("design:type", String)
+], SimulatePricingRequest.prototype, "receptionMethod", void 0);
 class SimulatePricingResponse {
 }
 exports.SimulatePricingResponse = SimulatePricingResponse;

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

@@ -0,0 +1,72 @@
+import { ReceptionMethod } from "../enums/ReceptionMethod";
+/**
+ * DTOs de Costos UniTeller (Exhibit A del contrato): lo que UniTeller le cobra a Fiado por remesa.
+ * Por país hay grupos con un precio por tramo de volumen y un tramo vigente; cada payer × método
+ * cae en un grupo. Se guarda en RemittanceCountryConfig_GT (grupos y tramo) y en
+ * RemittancePayerConfig_GT (grupo por método). Dueño: remittance-business.
+ */
+/** Cantidad de tramos de volumen del Exhibit A. */
+export declare const PROVIDER_COST_TIER_COUNT = 3;
+/** Id de grupo: una letra mayúscula (A, B, C…). */
+export declare const PROVIDER_COST_GROUP_ID_PATTERN: RegExp;
+/** Grupo de costo: un precio en USD por tramo de volumen (posición 0 = tramo 1). */
+export declare class ProviderCostGroup {
+    groupId: string;
+    costsUSD: number[];
+}
+/** Grupo de cada método de un payer. Método ausente = sin grupo (sin costo esperado ni ajuste de fee). */
+export declare class CostGroupByMethod {
+    ACCOUNT_CREDIT?: string;
+    CASH_PICKUP?: string;
+    WALLET?: string;
+}
+/** Un payer × método del catálogo del país, con su grupo si tiene. */
+export declare class ProviderCostAssignment {
+    payerCode: string;
+    /** Nombre efectivo del payer (override de Ops o el de UniTeller). */
+    name: string;
+    receptionMethod: ReceptionMethod;
+    /** Ausente = sin grupo. */
+    groupId?: string;
+}
+/** Volumen del mes calendario en curso (UTC), sin canceladas. Guía para elegir el tramo vigente. */
+export declare class ProviderCostMonthVolume {
+    txCount: number;
+    volumeUSD: number;
+}
+/** Costos de un país (vista de backoffice). */
+export declare class ProviderCostCountryItem {
+    countryISO: string;
+    name: string;
+    /** Tramo vigente 1..3; null = sin configurar. */
+    costTier: number | null;
+    groups: ProviderCostGroup[];
+    /** Todos los payer × método del catálogo del país, con o sin grupo. */
+    assignments: ProviderCostAssignment[];
+    /** Ausente si no se pudo calcular. */
+    monthVolume?: ProviderCostMonthVolume;
+    updatedAt?: string;
+    updatedBy?: string;
+}
+/** Response de GET /backoffice/config/provider-costs. */
+export declare class ProviderCostListResponse {
+    /** Etiquetas de los tramos de volumen del contrato, en orden (tramo 1 primero). */
+    tierLabels: string[];
+    items: ProviderCostCountryItem[];
+}
+/** Cambio de grupo de un payer × método. groupId null o ausente = quitarlo de su grupo. */
+export declare class ProviderCostAssignmentUpdate {
+    payerCode: string;
+    receptionMethod: ReceptionMethod;
+    groupId?: string | null;
+}
+/**
+ * Body de PUT /backoffice/config/provider-costs/{countryISO}. Todo opcional.
+ * `groups` reemplaza la lista completa; `assignments` solo toca los payer × método que trae.
+ * Response: ProviderCostCountryItem.
+ */
+export declare class ProviderCostUpdateRequest {
+    costTier?: number;
+    groups?: ProviderCostGroup[];
+    assignments?: ProviderCostAssignmentUpdate[];
+}

package/bin/remittance/dtos/RemittanceProviderCost.js

@@ -0,0 +1,127 @@
+"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.ProviderCostUpdateRequest = exports.ProviderCostAssignmentUpdate = exports.ProviderCostListResponse = exports.ProviderCostCountryItem = exports.ProviderCostMonthVolume = exports.ProviderCostAssignment = exports.CostGroupByMethod = exports.ProviderCostGroup = exports.PROVIDER_COST_GROUP_ID_PATTERN = exports.PROVIDER_COST_TIER_COUNT = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReceptionMethod_1 = require("../enums/ReceptionMethod");
+/**
+ * DTOs de Costos UniTeller (Exhibit A del contrato): lo que UniTeller le cobra a Fiado por remesa.
+ * Por país hay grupos con un precio por tramo de volumen y un tramo vigente; cada payer × método
+ * cae en un grupo. Se guarda en RemittanceCountryConfig_GT (grupos y tramo) y en
+ * RemittancePayerConfig_GT (grupo por método). Dueño: remittance-business.
+ */
+/** Cantidad de tramos de volumen del Exhibit A. */
+exports.PROVIDER_COST_TIER_COUNT = 3;
+/** Id de grupo: una letra mayúscula (A, B, C…). */
+exports.PROVIDER_COST_GROUP_ID_PATTERN = /^[A-Z]$/;
+/** Grupo de costo: un precio en USD por tramo de volumen (posición 0 = tramo 1). */
+class ProviderCostGroup {
+}
+exports.ProviderCostGroup = ProviderCostGroup;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(exports.PROVIDER_COST_GROUP_ID_PATTERN),
+    __metadata("design:type", String)
+], ProviderCostGroup.prototype, "groupId", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(exports.PROVIDER_COST_TIER_COUNT),
+    (0, class_validator_1.ArrayMaxSize)(exports.PROVIDER_COST_TIER_COUNT),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }, { each: true }),
+    (0, class_validator_1.Min)(0, { each: true }),
+    (0, class_validator_1.Max)(50, { each: true }),
+    __metadata("design:type", Array)
+], ProviderCostGroup.prototype, "costsUSD", void 0);
+/** Grupo de cada método de un payer. Método ausente = sin grupo (sin costo esperado ni ajuste de fee). */
+class CostGroupByMethod {
+}
+exports.CostGroupByMethod = CostGroupByMethod;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(exports.PROVIDER_COST_GROUP_ID_PATTERN),
+    __metadata("design:type", String)
+], CostGroupByMethod.prototype, "ACCOUNT_CREDIT", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(exports.PROVIDER_COST_GROUP_ID_PATTERN),
+    __metadata("design:type", String)
+], CostGroupByMethod.prototype, "CASH_PICKUP", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(exports.PROVIDER_COST_GROUP_ID_PATTERN),
+    __metadata("design:type", String)
+], CostGroupByMethod.prototype, "WALLET", void 0);
+/** Un payer × método del catálogo del país, con su grupo si tiene. */
+class ProviderCostAssignment {
+}
+exports.ProviderCostAssignment = ProviderCostAssignment;
+/** Volumen del mes calendario en curso (UTC), sin canceladas. Guía para elegir el tramo vigente. */
+class ProviderCostMonthVolume {
+}
+exports.ProviderCostMonthVolume = ProviderCostMonthVolume;
+/** Costos de un país (vista de backoffice). */
+class ProviderCostCountryItem {
+}
+exports.ProviderCostCountryItem = ProviderCostCountryItem;
+/** Response de GET /backoffice/config/provider-costs. */
+class ProviderCostListResponse {
+}
+exports.ProviderCostListResponse = ProviderCostListResponse;
+/** Cambio de grupo de un payer × método. groupId null o ausente = quitarlo de su grupo. */
+class ProviderCostAssignmentUpdate {
+}
+exports.ProviderCostAssignmentUpdate = ProviderCostAssignmentUpdate;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 40),
+    __metadata("design:type", String)
+], ProviderCostAssignmentUpdate.prototype, "payerCode", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(ReceptionMethod_1.ReceptionMethod),
+    __metadata("design:type", String)
+], ProviderCostAssignmentUpdate.prototype, "receptionMethod", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(exports.PROVIDER_COST_GROUP_ID_PATTERN),
+    __metadata("design:type", String)
+], ProviderCostAssignmentUpdate.prototype, "groupId", void 0);
+/**
+ * Body de PUT /backoffice/config/provider-costs/{countryISO}. Todo opcional.
+ * `groups` reemplaza la lista completa; `assignments` solo toca los payer × método que trae.
+ * Response: ProviderCostCountryItem.
+ */
+class ProviderCostUpdateRequest {
+}
+exports.ProviderCostUpdateRequest = ProviderCostUpdateRequest;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(exports.PROVIDER_COST_TIER_COUNT),
+    __metadata("design:type", Number)
+], ProviderCostUpdateRequest.prototype, "costTier", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(10),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ProviderCostGroup),
+    __metadata("design:type", Array)
+], ProviderCostUpdateRequest.prototype, "groups", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(300),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ProviderCostAssignmentUpdate),
+    __metadata("design:type", Array)
+], ProviderCostUpdateRequest.prototype, "assignments", void 0);

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

@@ -49,6 +49,7 @@ export * from "./RemittancePricingTable";
 export * from "./RemittanceExceptionCatalog";
 export * from "./RemittanceCountryConfig";
 export * from "./RemittancePayerConfig";
+export * from "./RemittanceProviderCost";
 export * from "./RemittanceFavoriteItem";
 export * from "./RemittanceFavoriteListResponse";
 export * from "./RemittanceBackofficeCancelCloseRequest";

package/bin/remittance/dtos/index.js

@@ -65,6 +65,7 @@ __exportStar(require("./RemittancePricingTable"), exports);
 __exportStar(require("./RemittanceExceptionCatalog"), exports);
 __exportStar(require("./RemittanceCountryConfig"), exports);
 __exportStar(require("./RemittancePayerConfig"), exports);
+__exportStar(require("./RemittanceProviderCost"), exports);
 __exportStar(require("./RemittanceFavoriteItem"), exports);
 __exportStar(require("./RemittanceFavoriteListResponse"), exports);
 __exportStar(require("./RemittanceBackofficeCancelCloseRequest"), exports);

package/bin/remittance/dtos/internal/RemittancePricingResolve.d.ts

@@ -1,4 +1,5 @@
 import { RemittanceCorridor } from "../../enums/RemittanceCorridor";
+import { ReceptionMethod } from "../../enums/ReceptionMethod";
 /**
  * Request del resolver de send-time (Fase B). El connector lo llama por cada
  * quote/preview/pay. `code` = promo tecleada por el cliente en la app (opcional).
@@ -8,6 +9,9 @@ export declare class PricingResolveRequest {
     corridor: RemittanceCorridor;
     amountUSD: number;
     code?: string;
+    /** Payer del beneficiario. Con receptionMethod define el grupo de costo (costo esperado y ajuste de fee). */
+    payerCode?: string;
+    receptionMethod?: ReceptionMethod;
 }
 /** Regla BLOCK que rechazó la tx (VALIDATION o TX_AMOUNT con acción BLOCK). */
 export declare class PricingResolveBlocked {
@@ -32,4 +36,12 @@ export declare class PricingResolveResponse {
     /** Mínimo de envío del país destino (RemittanceCountryConfig_GT). El connector rechaza montos menores. */
     minAmountUSD: number;
     blocked?: PricingResolveBlocked;
+    /** Grupo de costo del payer × método. Ausente = sin grupo o sin payer en el request. */
+    costGroup?: string;
+    /** Tramo de volumen vigente del país con el que se calculó el costo (1..3). */
+    costTier?: number;
+    /** Costo UniTeller esperado en USD (Exhibit A). Ausente si no hay grupo o tramo. */
+    unitellerCostExpected?: number;
+    /** Ajuste en USD del grupo que ya está sumado en `serviceFee` (antes de promos y topes). */
+    groupFeeAdjustment?: number;
 }

package/bin/remittance/dtos/internal/RemittancePricingResolve.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PricingResolveResponse = exports.PricingResolveBlocked = exports.PricingResolveRequest = void 0;
 const class_validator_1 = require("class-validator");
 const RemittanceCorridor_1 = require("../../enums/RemittanceCorridor");
+const ReceptionMethod_1 = require("../../enums/ReceptionMethod");
 /**
  * Request del resolver de send-time (Fase B). El connector lo llama por cada
  * quote/preview/pay. `code` = promo tecleada por el cliente en la app (opcional).
@@ -38,6 +39,17 @@ __decorate([
     (0, class_validator_1.Length)(3, 30),
     __metadata("design:type", String)
 ], PricingResolveRequest.prototype, "code", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 40),
+    __metadata("design:type", String)
+], PricingResolveRequest.prototype, "payerCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ReceptionMethod_1.ReceptionMethod),
+    __metadata("design:type", String)
+], PricingResolveRequest.prototype, "receptionMethod", void 0);
 /** Regla BLOCK que rechazó la tx (VALIDATION o TX_AMOUNT con acción BLOCK). */
 class PricingResolveBlocked {
 }

package/bin/remittance/dtos/internal/RemittancePricingSchedule.d.ts

@@ -1,5 +1,6 @@
 import { RemittanceCorridor } from "../../enums/RemittanceCorridor";
 import { PromotionKind } from "../../enums/PromotionKind";
+import { ReceptionMethod } from "../../enums/ReceptionMethod";
 /**
  * Request del schedule de precio por corredor (Fase B — F2 app). El connector lo
  * llama (passthrough desde benefits) para mostrarle al usuario la tabla de tramos de
@@ -8,6 +9,9 @@ import { PromotionKind } from "../../enums/PromotionKind";
 export declare class PricingScheduleRequest {
     directoryId: string;
     corridor: RemittanceCorridor;
+    /** Payer y método elegidos: los fees de los tramos incluyen el ajuste de su grupo. Ausentes = fee base. */
+    payerCode?: string;
+    receptionMethod?: ReceptionMethod;
 }
 /** Un tramo del schedule. `serviceFee` YA refleja la promo automática aplicada (D5). */
 export declare class PricingScheduleTier {

package/bin/remittance/dtos/internal/RemittancePricingSchedule.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const RemittanceCorridor_1 = require("../../enums/RemittanceCorridor");
 const PromotionKind_1 = require("../../enums/PromotionKind");
+const ReceptionMethod_1 = require("../../enums/ReceptionMethod");
 /**
  * Request del schedule de precio por corredor (Fase B — F2 app). El connector lo
  * llama (passthrough desde benefits) para mostrarle al usuario la tabla de tramos de
@@ -30,6 +31,16 @@ __decorate([
     (0, class_validator_1.IsEnum)(RemittanceCorridor_1.RemittanceCorridor),
     __metadata("design:type", String)
 ], PricingScheduleRequest.prototype, "corridor", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PricingScheduleRequest.prototype, "payerCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ReceptionMethod_1.ReceptionMethod),
+    __metadata("design:type", String)
+], PricingScheduleRequest.prototype, "receptionMethod", void 0);
 /** Un tramo del schedule. `serviceFee` YA refleja la promo automática aplicada (D5). */
 class PricingScheduleTier {
 }

package/bin/retailCommission/dtos/CommissionApi.d.ts

@@ -202,6 +202,12 @@ export interface CommissionRuleInput {
     countBy?: CommissionCountByEnum;
     /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
     payTiming?: CommissionPayTimingEnum;
+    /**
+     * Parte del bono por venta que se paga al registrar la venta, en puntos base (100–9900); el resto se
+     * paga en `payTiming`. Solo en reglas cuya única palanca es el bono por venta y con `payTiming`
+     * `ON_CUT` o `MONTHLY`. Ausente o `null` = sin adelanto.
+     */
+    onSaleAdvanceBps?: number | null;
 }
 /** `POST /backoffice/commissions/rules` — la regla nace en borrador. */
 export type CreateRuleRequest = CommissionRuleInput;
@@ -387,6 +393,12 @@ export interface CommissionRuleView {
     countBy?: CommissionCountByEnum;
     /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
     payTiming?: CommissionPayTimingEnum;
+    /**
+     * Parte del bono por venta que se paga al registrar la venta, en puntos base (100–9900); el resto se
+     * paga en `payTiming`. Solo en reglas cuya única palanca es el bono por venta y con `payTiming`
+     * `ON_CUT` o `MONTHLY`. Ausente o `null` = sin adelanto.
+     */
+    onSaleAdvanceBps?: number | null;
 }
 /** Lo pagado en varios cortes. */
 export interface MyCommissionsTotals {

package/bin/retailCommission/dtos/CommissionRule.d.ts

@@ -79,6 +79,12 @@ export interface CommissionRule {
     countBy?: CommissionCountByEnum;
     /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
     payTiming?: CommissionPayTimingEnum;
+    /**
+     * Parte del bono por venta que se paga al registrar la venta, en puntos base (100–9900); el resto se
+     * paga en `payTiming`. Solo en reglas cuya única palanca es el bono por venta y con `payTiming`
+     * `ON_CUT` o `MONTHLY`. Ausente o `null` = sin adelanto.
+     */
+    onSaleAdvanceBps?: number | null;
     /** Sube en cada guardado. */
     version: number;
     /** La versión que está en el plan vigente. `null` si nunca se publicó. */

package/package.json

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

package/src/remittance/dtos/RemittanceBackofficeTransaction.ts

@@ -102,4 +102,15 @@ export class RemittanceBackofficeTransaction {
     reconStatus?: RemittanceReconStatus;
     /** Detalle textual de los diffs cuando reconStatus !== OK. */
     reconDiffDetail?: string;
+
+    // ─── Costo esperado al enviar (Exhibit A, foto del confirm) ─────────
+
+    /** Costo UniTeller esperado en USD según el grupo y el tramo vigente al enviar. */
+    unitellerCostExpected?: number;
+    /** Grupo de costo del payer × método al enviar. */
+    costGroup?: string;
+    /** Tramo de volumen vigente al enviar (1..3). */
+    costTier?: number;
+    /** Ajuste del grupo que se sumó al fee de esta remesa. */
+    groupFeeAdjustment?: number;
 }

package/src/remittance/dtos/RemittancePayerConfig.ts

@@ -1,5 +1,6 @@
 import { IsBoolean, IsOptional, IsString, Length } from "class-validator";
 import { ReceptionMethod } from "../enums/ReceptionMethod";
+import { CostGroupByMethod } from "./RemittanceProviderCost";
 
 /**
  * DTOs de la administración de payers desde el backoffice (v1: enabled + override de nombre).
@@ -21,6 +22,8 @@ export class RemittancePayerConfigItem {
     configured!: boolean;
     /** Logo de UniTeller, solo lectura (identificación visual en la lista). */
     logoUrl?: string;
+    /** Grupo de costo UniTeller de cada método (solo lectura aquí; se edita en Costos UniTeller). */
+    costGroupByMethod?: CostGroupByMethod;
 }
 
 /** Response de GET /backoffice/config/payers (config chica, sin paginación). */

package/src/remittance/dtos/RemittancePricing.ts

@@ -9,12 +9,15 @@ import {
     IsOptional,
     IsString,
     Length,
+    Matches,
     Max,
     MaxLength,
     Min,
     ValidateNested,
 } from "class-validator";
 import { RemittanceCorridor } from "../enums/RemittanceCorridor";
+import { ReceptionMethod } from "../enums/ReceptionMethod";
+import { PROVIDER_COST_GROUP_ID_PATTERN } from "./RemittanceProviderCost";
 
 /**
  * DTOs de Precio Base (Dashboard Ops · Variables Operativas §1).
@@ -56,6 +59,19 @@ export class PricingTier {
     effectiveFrom!: string;
 }
 
+/** Ajuste en USD que se suma al fee del tramo cuando el payer × método cae en ese grupo de costo. */
+export class PricingGroupFeeAdjustment {
+    @IsString()
+    @Matches(PROVIDER_COST_GROUP_ID_PATTERN)
+    groupId!: string;
+
+    /** CON SIGNO: negativo descuenta. El fee final nunca baja de 0. */
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @Min(-100)
+    @Max(100)
+    adjustmentUSD!: number;
+}
+
 /** Body de POST /backoffice/pricing/base. */
 export class CreatePricingRequest {
     @IsEnum(RemittanceCorridor)
@@ -87,6 +103,14 @@ export class CreatePricingRequest {
     @IsString()
     @MaxLength(500)
     notes?: string;
+
+    /** Ajuste del fee por grupo de costo del payer. Ausente = conserva los actuales; [] = sin ajustes. */
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(10)
+    @ValidateNested({ each: true })
+    @Type(() => PricingGroupFeeAdjustment)
+    groupFeeAdjustments?: PricingGroupFeeAdjustment[];
 }
 
 /** Body de PUT /backoffice/pricing/base/{id} (reemplazo completo; corridor/segmentId inmutables). */
@@ -112,6 +136,14 @@ export class UpdatePricingRequest {
     @IsString()
     @MaxLength(500)
     notes?: string;
+
+    /** Ajuste del fee por grupo de costo del payer. Ausente = conserva los actuales; [] = sin ajustes. */
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(10)
+    @ValidateNested({ each: true })
+    @Type(() => PricingGroupFeeAdjustment)
+    groupFeeAdjustments?: PricingGroupFeeAdjustment[];
 }
 
 /** Combinación completa (response de list/create/update). */
@@ -125,6 +157,8 @@ export class PricingCombination {
     tramos!: PricingTier[];
     /** # promos activas que aplican a la combinación. 0 hasta que exista Promociones. */
     promosCount!: number;
+    /** Ajuste del fee por grupo de costo. Ausente o [] = sin ajustes. */
+    groupFeeAdjustments?: PricingGroupFeeAdjustment[];
     name!: string | null;
     notes!: string | null;
     createdAt!: string;
@@ -166,6 +200,24 @@ export class SimulatePricingRequest {
     @ValidateNested({ each: true })
     @Type(() => PricingTier)
     tramos!: PricingTier[];
+
+    /** Ajustes del panel (pueden no estar guardados). Solo aplican si viene payer y método. */
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(10)
+    @ValidateNested({ each: true })
+    @Type(() => PricingGroupFeeAdjustment)
+    groupFeeAdjustments?: PricingGroupFeeAdjustment[];
+
+    /** Payer y método opcionales: con ellos la simulación suma el ajuste del grupo y calcula costo y margen. */
+    @IsOptional()
+    @IsString()
+    @Length(1, 40)
+    payerCode?: string;
+
+    @IsOptional()
+    @IsEnum(ReceptionMethod)
+    receptionMethod?: ReceptionMethod;
 }
 
 export class SimulatePricingResponse {
@@ -185,6 +237,14 @@ export class SimulatePricingResponse {
     revenueUsd!: number;
     /** ISO del quote. */
     asOf!: string;
+    /** Grupo de costo del payer × método simulado. */
+    costGroup?: string;
+    /** Ajuste del grupo ya sumado en serviceFee. */
+    groupFeeAdjustment?: number;
+    /** Costo UniTeller esperado (Exhibit A, tramo vigente del país). */
+    unitellerCostExpected?: number;
+    /** revenueUsd − unitellerCostExpected. */
+    netMarginUsd?: number;
 }
 
 /** Response de GET /backoffice/pricing/wholesale?corridor= (rb passthrough del connector). */

package/src/remittance/dtos/RemittanceProviderCost.ts

@@ -0,0 +1,139 @@
+import { Type } from "class-transformer";
+import {
+    ArrayMaxSize,
+    ArrayMinSize,
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Length,
+    Matches,
+    Max,
+    Min,
+    ValidateNested,
+} from "class-validator";
+import { ReceptionMethod } from "../enums/ReceptionMethod";
+
+/**
+ * DTOs de Costos UniTeller (Exhibit A del contrato): lo que UniTeller le cobra a Fiado por remesa.
+ * Por país hay grupos con un precio por tramo de volumen y un tramo vigente; cada payer × método
+ * cae en un grupo. Se guarda en RemittanceCountryConfig_GT (grupos y tramo) y en
+ * RemittancePayerConfig_GT (grupo por método). Dueño: remittance-business.
+ */
+
+/** Cantidad de tramos de volumen del Exhibit A. */
+export const PROVIDER_COST_TIER_COUNT = 3;
+
+/** Id de grupo: una letra mayúscula (A, B, C…). */
+export const PROVIDER_COST_GROUP_ID_PATTERN = /^[A-Z]$/;
+
+/** Grupo de costo: un precio en USD por tramo de volumen (posición 0 = tramo 1). */
+export class ProviderCostGroup {
+    @IsString()
+    @Matches(PROVIDER_COST_GROUP_ID_PATTERN)
+    groupId!: string;
+
+    @IsArray()
+    @ArrayMinSize(PROVIDER_COST_TIER_COUNT)
+    @ArrayMaxSize(PROVIDER_COST_TIER_COUNT)
+    @IsNumber({ maxDecimalPlaces: 2 }, { each: true })
+    @Min(0, { each: true })
+    @Max(50, { each: true })
+    costsUSD!: number[];
+}
+
+/** Grupo de cada método de un payer. Método ausente = sin grupo (sin costo esperado ni ajuste de fee). */
+export class CostGroupByMethod {
+    @IsOptional()
+    @Matches(PROVIDER_COST_GROUP_ID_PATTERN)
+    ACCOUNT_CREDIT?: string;
+
+    @IsOptional()
+    @Matches(PROVIDER_COST_GROUP_ID_PATTERN)
+    CASH_PICKUP?: string;
+
+    @IsOptional()
+    @Matches(PROVIDER_COST_GROUP_ID_PATTERN)
+    WALLET?: string;
+}
+
+/** Un payer × método del catálogo del país, con su grupo si tiene. */
+export class ProviderCostAssignment {
+    payerCode!: string;
+    /** Nombre efectivo del payer (override de Ops o el de UniTeller). */
+    name!: string;
+    receptionMethod!: ReceptionMethod;
+    /** Ausente = sin grupo. */
+    groupId?: string;
+}
+
+/** Volumen del mes calendario en curso (UTC), sin canceladas. Guía para elegir el tramo vigente. */
+export class ProviderCostMonthVolume {
+    txCount!: number;
+    volumeUSD!: number;
+}
+
+/** Costos de un país (vista de backoffice). */
+export class ProviderCostCountryItem {
+    countryISO!: string;
+    name!: string;
+    /** Tramo vigente 1..3; null = sin configurar. */
+    costTier!: number | null;
+    groups!: ProviderCostGroup[];
+    /** Todos los payer × método del catálogo del país, con o sin grupo. */
+    assignments!: ProviderCostAssignment[];
+    /** Ausente si no se pudo calcular. */
+    monthVolume?: ProviderCostMonthVolume;
+    updatedAt?: string;
+    updatedBy?: string;
+}
+
+/** Response de GET /backoffice/config/provider-costs. */
+export class ProviderCostListResponse {
+    /** Etiquetas de los tramos de volumen del contrato, en orden (tramo 1 primero). */
+    tierLabels!: string[];
+    items!: ProviderCostCountryItem[];
+}
+
+/** Cambio de grupo de un payer × método. groupId null o ausente = quitarlo de su grupo. */
+export class ProviderCostAssignmentUpdate {
+    @IsString()
+    @Length(1, 40)
+    payerCode!: string;
+
+    @IsEnum(ReceptionMethod)
+    receptionMethod!: ReceptionMethod;
+
+    @IsOptional()
+    @Matches(PROVIDER_COST_GROUP_ID_PATTERN)
+    groupId?: string | null;
+}
+
+/**
+ * Body de PUT /backoffice/config/provider-costs/{countryISO}. Todo opcional.
+ * `groups` reemplaza la lista completa; `assignments` solo toca los payer × método que trae.
+ * Response: ProviderCostCountryItem.
+ */
+export class ProviderCostUpdateRequest {
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    @Max(PROVIDER_COST_TIER_COUNT)
+    costTier?: number;
+
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(10)
+    @ValidateNested({ each: true })
+    @Type(() => ProviderCostGroup)
+    groups?: ProviderCostGroup[];
+
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(300)
+    @ValidateNested({ each: true })
+    @Type(() => ProviderCostAssignmentUpdate)
+    assignments?: ProviderCostAssignmentUpdate[];
+}

package/src/remittance/dtos/index.ts

@@ -49,6 +49,7 @@ export * from "./RemittancePricingTable";
 export * from "./RemittanceExceptionCatalog";
 export * from "./RemittanceCountryConfig";
 export * from "./RemittancePayerConfig";
+export * from "./RemittanceProviderCost";
 export * from "./RemittanceFavoriteItem";
 export * from "./RemittanceFavoriteListResponse";
 export * from "./RemittanceBackofficeCancelCloseRequest";

package/src/remittance/dtos/internal/RemittancePricingResolve.ts

@@ -1,5 +1,6 @@
 import { IsEnum, IsNumber, IsOptional, IsString, IsUUID, Length, Min } from "class-validator";
 import { RemittanceCorridor } from "../../enums/RemittanceCorridor";
+import { ReceptionMethod } from "../../enums/ReceptionMethod";
 
 /**
  * Request del resolver de send-time (Fase B). El connector lo llama por cada
@@ -20,6 +21,16 @@ export class PricingResolveRequest {
     @IsString()
     @Length(3, 30)
     code?: string;
+
+    /** Payer del beneficiario. Con receptionMethod define el grupo de costo (costo esperado y ajuste de fee). */
+    @IsOptional()
+    @IsString()
+    @Length(1, 40)
+    payerCode?: string;
+
+    @IsOptional()
+    @IsEnum(ReceptionMethod)
+    receptionMethod?: ReceptionMethod;
 }
 
 /** Regla BLOCK que rechazó la tx (VALIDATION o TX_AMOUNT con acción BLOCK). */
@@ -46,4 +57,12 @@ export class PricingResolveResponse {
     /** Mínimo de envío del país destino (RemittanceCountryConfig_GT). El connector rechaza montos menores. */
     minAmountUSD!: number;
     blocked?: PricingResolveBlocked;
+    /** Grupo de costo del payer × método. Ausente = sin grupo o sin payer en el request. */
+    costGroup?: string;
+    /** Tramo de volumen vigente del país con el que se calculó el costo (1..3). */
+    costTier?: number;
+    /** Costo UniTeller esperado en USD (Exhibit A). Ausente si no hay grupo o tramo. */
+    unitellerCostExpected?: number;
+    /** Ajuste en USD del grupo que ya está sumado en `serviceFee` (antes de promos y topes). */
+    groupFeeAdjustment?: number;
 }

package/src/remittance/dtos/internal/RemittancePricingSchedule.ts

@@ -12,6 +12,7 @@ import {
 } from "class-validator";
 import { RemittanceCorridor } from "../../enums/RemittanceCorridor";
 import { PromotionKind } from "../../enums/PromotionKind";
+import { ReceptionMethod } from "../../enums/ReceptionMethod";
 
 /**
  * Request del schedule de precio por corredor (Fase B — F2 app). El connector lo
@@ -24,6 +25,15 @@ export class PricingScheduleRequest {
 
     @IsEnum(RemittanceCorridor)
     corridor!: RemittanceCorridor;
+
+    /** Payer y método elegidos: los fees de los tramos incluyen el ajuste de su grupo. Ausentes = fee base. */
+    @IsOptional()
+    @IsString()
+    payerCode?: string;
+
+    @IsOptional()
+    @IsEnum(ReceptionMethod)
+    receptionMethod?: ReceptionMethod;
 }
 
 /** Un tramo del schedule. `serviceFee` YA refleja la promo automática aplicada (D5). */

package/src/retailCommission/dtos/CommissionApi.ts

@@ -264,6 +264,12 @@ export interface CommissionRuleInput {
     countBy?: CommissionCountByEnum;
     /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
     payTiming?: CommissionPayTimingEnum;
+    /**
+     * Parte del bono por venta que se paga al registrar la venta, en puntos base (100–9900); el resto se
+     * paga en `payTiming`. Solo en reglas cuya única palanca es el bono por venta y con `payTiming`
+     * `ON_CUT` o `MONTHLY`. Ausente o `null` = sin adelanto.
+     */
+    onSaleAdvanceBps?: number | null;
 }
 
 /** `POST /backoffice/commissions/rules` — la regla nace en borrador. */
@@ -466,6 +472,12 @@ export interface CommissionRuleView {
     countBy?: CommissionCountByEnum;
     /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
     payTiming?: CommissionPayTimingEnum;
+    /**
+     * Parte del bono por venta que se paga al registrar la venta, en puntos base (100–9900); el resto se
+     * paga en `payTiming`. Solo en reglas cuya única palanca es el bono por venta y con `payTiming`
+     * `ON_CUT` o `MONTHLY`. Ausente o `null` = sin adelanto.
+     */
+    onSaleAdvanceBps?: number | null;
 }
 
 /** Lo pagado en varios cortes. */

package/src/retailCommission/dtos/CommissionRule.ts

@@ -88,6 +88,12 @@ export interface CommissionRule {
     countBy?: CommissionCountByEnum;
     /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
     payTiming?: CommissionPayTimingEnum;
+    /**
+     * Parte del bono por venta que se paga al registrar la venta, en puntos base (100–9900); el resto se
+     * paga en `payTiming`. Solo en reglas cuya única palanca es el bono por venta y con `payTiming`
+     * `ON_CUT` o `MONTHLY`. Ausente o `null` = sin adelanto.
+     */
+    onSaleAdvanceBps?: number | null;
     /** Sube en cada guardado. */
     version: number;
     /** La versión que está en el plan vigente. `null` si nunca se publicó. */