@fiado/type-kit 3.575.0 → 3.576.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/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.576.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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ó. */