@fiado/type-kit 3.490.0 → 3.492.0

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

@@ -48,6 +48,8 @@ export interface CommissionPayoutSeller {
     /** Al cerrar: si alcanzó su cuota. */
     quotaMet: boolean | null;
     quotaFactorBps: number | null;
+    /** El corte del vendedor calculado con reglas. Lo escribe el cierre. */
+    breakdown?: CommissionSellerBreakdown;
 }
 /**
  * Un ajuste manual sobre el corte.
@@ -71,3 +73,85 @@ export interface CommissionAdjustment {
     author: string;
     createdAt: string;
 }
+/** Lo que una regla de bono por venta aportó al corte del vendedor. */
+export interface CommissionRuleContribution {
+    ruleId: string;
+    name: string;
+    /** Piezas que pagaron esta regla. */
+    unitsCount: number;
+    bonusCents: number;
+    /** Su parte del multiplicador, en proporción a su bono. */
+    multiplierShareCents: number;
+}
+/** Un multiplicador que disparó en el corte. */
+export interface CommissionAppliedMultiplier {
+    ruleId: string;
+    name: string;
+    factorBps: number;
+}
+/** Un bono por umbral que disparó en el corte. */
+export interface CommissionAppliedThreshold {
+    ruleId: string;
+    name: string;
+    amountCents: number;
+}
+/** Lo vendido y lo pagado del vendedor en una tienda. Lo pagado no incluye umbrales. */
+export interface CommissionStoreContribution {
+    storeId: string;
+    salesCount: number;
+    unitsCount: number;
+    placementCents: number;
+    paidCents: number;
+}
+/** Lo vendido y lo pagado del vendedor por un SKU. Lo pagado no incluye umbrales. */
+export interface CommissionSkuContribution {
+    sku: string;
+    unitsCount: number;
+    placementCents: number;
+    paidCents: number;
+}
+/** La renta de cartera que pagó una regla en el corte. */
+export interface CommissionAppliedRent {
+    ruleId: string;
+    name: string;
+    /** Cuotas cobradas que pagaron esta regla. */
+    couponsCount: number;
+    amountCents: number;
+}
+/**
+ * El corte de un vendedor calculado con las reglas.
+ *
+ * liberado = round(subtotal × multiplicador) + umbral + renta · neto = liberado + ajustes.
+ */
+export interface CommissionSellerBreakdown {
+    sellerId: string;
+    /** Ventas del periodo sin las revertidas. */
+    salesCount: number;
+    /** Piezas de esas ventas: lo que cuentan las reglas. */
+    unitsCount: number;
+    /** Suma del precio neto de las piezas. */
+    placementCents: number;
+    subtotalBonusCents: number;
+    /** Multiplicador aplicado, ya con el tope. 10000 = ×1. */
+    multiplierBps: number;
+    multiplierBeforeCapBps: number;
+    multipliers: CommissionAppliedMultiplier[];
+    thresholdBonusCents: number;
+    thresholds: CommissionAppliedThreshold[];
+    portfolioRentCents: number;
+    releasedCents: number;
+    /** Ajustes del vendedor en el periodo: manuales, ventas tardías y reversas. */
+    adjustmentsCents: number;
+    /** Reversas de ventas de cortes ya cerrados, en positivo. Ya están dentro de `adjustmentsCents`. */
+    clawbackCents: number;
+    netCents: number;
+    byRule: CommissionRuleContribution[];
+    byStore: CommissionStoreContribution[];
+    bySku: CommissionSkuContribution[];
+    /** La renta por regla; suma `portfolioRentCents`. Ausente en cortes de antes de la renta. */
+    rentByRule?: CommissionAppliedRent[];
+    /** NPI M30 del vendedor con que se evaluaron las condiciones, en bps. `null` sin créditos que contar. */
+    npiM30Bps?: number | null;
+    /** Créditos que contaron para el NPI. */
+    npiSample?: number;
+}

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

@@ -0,0 +1,119 @@
+import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
+import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
+import type { CommissionBonusModeEnum } from '../enums/CommissionBonusModeEnum';
+import type { CommissionMetricEnum } from '../enums/CommissionMetricEnum';
+import type { CommissionOperatorEnum } from '../enums/CommissionOperatorEnum';
+import type { CommissionRuleStatusEnum } from '../enums/CommissionRuleStatusEnum';
+import type { CommissionWindowEnum } from '../enums/CommissionWindowEnum';
+/**
+ * Reglas de comisión de VentasLuga: cada regla es independiente y se apila con las demás.
+ *
+ * Montos en centavos (`*Cents`); porcentajes y factores en puntos base (`*Bps`, 10000 = 100% = ×1).
+ */
+/** Bono por pieza vendida: monto fijo (`FIXED`, centavos) o porcentaje de su precio neto (`PERCENT`, bps). */
+export interface CommissionBonusPerSale {
+    mode: CommissionBonusModeEnum;
+    value: number;
+}
+/** Monto fijo, una vez por corte, cuando se cumple la condición. */
+export interface CommissionThresholdBonus {
+    amountCents: number;
+}
+/** Multiplica el subtotal de bonos por venta del corte. */
+export interface CommissionMultiplier {
+    factorBps: number;
+}
+/** Renta de cartera: un bono por cada cupón que el cliente paga. */
+export interface CommissionCouponBonus {
+    mode: CommissionBonusModeEnum;
+    value: number;
+}
+/** Las palancas de una regla. Una regla publicable trae al menos una. */
+export interface CommissionRuleLevers {
+    bonoPorVenta: CommissionBonusPerSale | null;
+    bonoUmbral: CommissionThresholdBonus | null;
+    multiplicador: CommissionMultiplier | null;
+    bonoPorCuponPagado: CommissionCouponBonus | null;
+}
+/** A qué piezas aplica la regla. Una lista vacía es "todas". */
+export interface CommissionRuleScope {
+    tipos: ProductCategoryEnum[];
+    gamas: ProductTierEnum[];
+    skus: string[];
+    tiendas: string[];
+}
+/**
+ * Condición para que la regla dispare.
+ *
+ * `value` es un número, `[min, max]` con `BETWEEN` o la lista con `IN`. `minSample` solo aplica a
+ * `NPI_M30_VENDEDOR`: sin esa muestra la condición no dispara.
+ */
+export interface CommissionRuleCondition {
+    metric: CommissionMetricEnum;
+    operator: CommissionOperatorEnum;
+    value: number | number[];
+    minSample: number | null;
+}
+/** Una regla de comisión, en su última versión. */
+export interface CommissionRule {
+    ruleId: string;
+    retailerId: string;
+    name: string;
+    description: string | null;
+    status: CommissionRuleStatusEnum;
+    levers: CommissionRuleLevers;
+    scope: CommissionRuleScope;
+    condition: CommissionRuleCondition | null;
+    /** `YYYY-MM-DD`, inclusive. */
+    effectiveFrom: string;
+    /** `YYYY-MM-DD`, inclusive. `null` = permanente. */
+    effectiveTo: string | null;
+    /** Desempata multiplicadores exclusivos: gana la mayor. */
+    priority: number;
+    /** Solo con multiplicador: si dispara, es el único multiplicador del corte. */
+    replacesOthers: boolean;
+    /** Sube en cada guardado. */
+    version: number;
+    /** La versión que está en el plan vigente. `null` si nunca se publicó. */
+    publishedVersion: number | null;
+    publishedBy: string | null;
+    publishedAt: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Ventanas del clawback, en días. */
+export interface CommissionPolicyClawback {
+    cancelacionDias: number;
+    devolucionDias: number;
+    npiM30Dias: number;
+    editedBy: string;
+    editedAt: string;
+}
+/** Política de comisiones de la cadena. */
+export interface CommissionPolicyCommissions {
+    /** Tope del multiplicador acumulado del corte. 25000 = ×2.5. */
+    multiplicadorMaxBps: number;
+    ventanaDefault: CommissionWindowEnum;
+    editedBy: string;
+    editedAt: string;
+}
+/** Políticas de la cadena. Cada una es `null` mientras la cadena no la guarda. */
+export interface CommissionPolicies {
+    clawback: CommissionPolicyClawback | null;
+    commissions: CommissionPolicyCommissions | null;
+}
+/**
+ * El plan vigente: las reglas publicadas y las políticas, congeladas en un snapshot inmutable.
+ * Cada devengo apunta al snapshot con que se calculó.
+ */
+export interface CommissionRuleSetSnapshot {
+    retailerId: string;
+    snapshotId: string;
+    rules: CommissionRule[];
+    policies: CommissionPolicies;
+    changeNote: string;
+    publishedBy: string;
+    publishedAt: string;
+}

package/bin/retailCommission/dtos/CommissionRule.js

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

package/bin/retailCommission/enums/CommissionAggregateByEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Por qué se agrega lo pagado en los cortes cerrados.
+ *
+ * RULE - Por regla: bonos por venta con su parte del multiplicador, y umbrales.
+ * STORE - Por tienda donde se vendió.
+ * SKU - Por producto.
+ * SELLER - Por vendedor: su neto.
+ */
+export declare enum CommissionAggregateByEnum {
+    RULE = "RULE",
+    STORE = "STORE",
+    SKU = "SKU",
+    SELLER = "SELLER"
+}

package/bin/retailCommission/enums/CommissionAggregateByEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionAggregateByEnum = void 0;
+/**
+ * Por qué se agrega lo pagado en los cortes cerrados.
+ *
+ * RULE - Por regla: bonos por venta con su parte del multiplicador, y umbrales.
+ * STORE - Por tienda donde se vendió.
+ * SKU - Por producto.
+ * SELLER - Por vendedor: su neto.
+ */
+var CommissionAggregateByEnum;
+(function (CommissionAggregateByEnum) {
+    CommissionAggregateByEnum["RULE"] = "RULE";
+    CommissionAggregateByEnum["STORE"] = "STORE";
+    CommissionAggregateByEnum["SKU"] = "SKU";
+    CommissionAggregateByEnum["SELLER"] = "SELLER";
+})(CommissionAggregateByEnum || (exports.CommissionAggregateByEnum = CommissionAggregateByEnum = {}));

package/bin/retailCommission/enums/CommissionBonusModeEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cómo se calcula un bono.
+ *
+ * FIXED - Monto fijo en centavos por pieza.
+ * PERCENT - Puntos base sobre el precio neto de la pieza (10000 = 100%).
+ */
+export declare enum CommissionBonusModeEnum {
+    FIXED = "FIXED",
+    PERCENT = "PERCENT"
+}

package/bin/retailCommission/enums/CommissionBonusModeEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionBonusModeEnum = void 0;
+/**
+ * Cómo se calcula un bono.
+ *
+ * FIXED - Monto fijo en centavos por pieza.
+ * PERCENT - Puntos base sobre el precio neto de la pieza (10000 = 100%).
+ */
+var CommissionBonusModeEnum;
+(function (CommissionBonusModeEnum) {
+    CommissionBonusModeEnum["FIXED"] = "FIXED";
+    CommissionBonusModeEnum["PERCENT"] = "PERCENT";
+})(CommissionBonusModeEnum || (exports.CommissionBonusModeEnum = CommissionBonusModeEnum = {}));

package/bin/retailCommission/enums/CommissionCalcStepEnum.d.ts

@@ -10,6 +10,7 @@
  * QUOTA - Se resolvió la cuota (binaria o escalonada). Ocurre al CERRAR, no al devengar.
  * ADJUSTMENT - Un ajuste manual del corte.
  * NO_CATEGORY - El SKU no matcheó ninguna categoría del plan: devenga 0 y queda visible.
+ * BONUS_PER_SALE - Una regla con bono por venta sumó por una pieza de la venta.
  *
  * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
  */
@@ -19,5 +20,6 @@ export declare enum CommissionCalcStepEnum {
     ADDON = "ADDON",
     QUOTA = "QUOTA",
     ADJUSTMENT = "ADJUSTMENT",
-    NO_CATEGORY = "NO_CATEGORY"
+    NO_CATEGORY = "NO_CATEGORY",
+    BONUS_PER_SALE = "BONUS_PER_SALE"
 }

package/bin/retailCommission/enums/CommissionCalcStepEnum.js

@@ -13,6 +13,7 @@ exports.CommissionCalcStepEnum = void 0;
  * QUOTA - Se resolvió la cuota (binaria o escalonada). Ocurre al CERRAR, no al devengar.
  * ADJUSTMENT - Un ajuste manual del corte.
  * NO_CATEGORY - El SKU no matcheó ninguna categoría del plan: devenga 0 y queda visible.
+ * BONUS_PER_SALE - Una regla con bono por venta sumó por una pieza de la venta.
  *
  * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
  */
@@ -24,4 +25,5 @@ var CommissionCalcStepEnum;
     CommissionCalcStepEnum["QUOTA"] = "QUOTA";
     CommissionCalcStepEnum["ADJUSTMENT"] = "ADJUSTMENT";
     CommissionCalcStepEnum["NO_CATEGORY"] = "NO_CATEGORY";
+    CommissionCalcStepEnum["BONUS_PER_SALE"] = "BONUS_PER_SALE";
 })(CommissionCalcStepEnum || (exports.CommissionCalcStepEnum = CommissionCalcStepEnum = {}));

package/bin/retailCommission/enums/CommissionMetricEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Métricas de la condición de una regla.
+ *
+ * POSICION_VENTA_EN_PERIODO - Lugar de la pieza entre las del vendedor en el periodo que caen en el alcance de la regla.
+ * COLOCACION_PERIODO - Suma del precio neto de todo lo que el vendedor vendió en el periodo, en centavos.
+ * NPI_M30_VENDEDOR - Proporción de créditos del vendedor con primer impago a 30 días, en bps. Viene del crédito.
+ * SKUS_DISTINTOS_PERIODO - Cuántos SKUs distintos vendió el vendedor en el periodo.
+ */
+export declare enum CommissionMetricEnum {
+    POSICION_VENTA_EN_PERIODO = "POSICION_VENTA_EN_PERIODO",
+    COLOCACION_PERIODO = "COLOCACION_PERIODO",
+    NPI_M30_VENDEDOR = "NPI_M30_VENDEDOR",
+    SKUS_DISTINTOS_PERIODO = "SKUS_DISTINTOS_PERIODO"
+}

package/bin/retailCommission/enums/CommissionMetricEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionMetricEnum = void 0;
+/**
+ * Métricas de la condición de una regla.
+ *
+ * POSICION_VENTA_EN_PERIODO - Lugar de la pieza entre las del vendedor en el periodo que caen en el alcance de la regla.
+ * COLOCACION_PERIODO - Suma del precio neto de todo lo que el vendedor vendió en el periodo, en centavos.
+ * NPI_M30_VENDEDOR - Proporción de créditos del vendedor con primer impago a 30 días, en bps. Viene del crédito.
+ * SKUS_DISTINTOS_PERIODO - Cuántos SKUs distintos vendió el vendedor en el periodo.
+ */
+var CommissionMetricEnum;
+(function (CommissionMetricEnum) {
+    CommissionMetricEnum["POSICION_VENTA_EN_PERIODO"] = "POSICION_VENTA_EN_PERIODO";
+    CommissionMetricEnum["COLOCACION_PERIODO"] = "COLOCACION_PERIODO";
+    CommissionMetricEnum["NPI_M30_VENDEDOR"] = "NPI_M30_VENDEDOR";
+    CommissionMetricEnum["SKUS_DISTINTOS_PERIODO"] = "SKUS_DISTINTOS_PERIODO";
+})(CommissionMetricEnum || (exports.CommissionMetricEnum = CommissionMetricEnum = {}));

package/bin/retailCommission/enums/CommissionOperatorEnum.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Operadores de la condición de una regla.
+ *
+ * GTE, LTE, LT, GT - Contra un número.
+ * BETWEEN - Contra `[min, max]`, ambos inclusive.
+ * IN - Contra una lista de valores.
+ */
+export declare enum CommissionOperatorEnum {
+    GTE = "GTE",
+    LTE = "LTE",
+    LT = "LT",
+    GT = "GT",
+    BETWEEN = "BETWEEN",
+    IN = "IN"
+}

package/bin/retailCommission/enums/CommissionOperatorEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionOperatorEnum = void 0;
+/**
+ * Operadores de la condición de una regla.
+ *
+ * GTE, LTE, LT, GT - Contra un número.
+ * BETWEEN - Contra `[min, max]`, ambos inclusive.
+ * IN - Contra una lista de valores.
+ */
+var CommissionOperatorEnum;
+(function (CommissionOperatorEnum) {
+    CommissionOperatorEnum["GTE"] = "GTE";
+    CommissionOperatorEnum["LTE"] = "LTE";
+    CommissionOperatorEnum["LT"] = "LT";
+    CommissionOperatorEnum["GT"] = "GT";
+    CommissionOperatorEnum["BETWEEN"] = "BETWEEN";
+    CommissionOperatorEnum["IN"] = "IN";
+})(CommissionOperatorEnum || (exports.CommissionOperatorEnum = CommissionOperatorEnum = {}));

package/bin/retailCommission/enums/CommissionRuleStatusEnum.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Estado de una regla de comisión.
+ *
+ * DRAFT - Borrador: nunca se publicó y no está en el plan vigente.
+ * SCHEDULED - Publicada, con vigencia que todavía no empieza.
+ * ACTIVE - Publicada y vigente.
+ * PAUSED - Publicada y pausada: sale del plan vigente hasta reanudarla.
+ * EXPIRED - Vencida por fecha o con "Vencer ahora". No vuelve a aplicar.
+ */
+export declare enum CommissionRuleStatusEnum {
+    DRAFT = "DRAFT",
+    SCHEDULED = "SCHEDULED",
+    ACTIVE = "ACTIVE",
+    PAUSED = "PAUSED",
+    EXPIRED = "EXPIRED"
+}

package/bin/retailCommission/enums/CommissionRuleStatusEnum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionRuleStatusEnum = void 0;
+/**
+ * Estado de una regla de comisión.
+ *
+ * DRAFT - Borrador: nunca se publicó y no está en el plan vigente.
+ * SCHEDULED - Publicada, con vigencia que todavía no empieza.
+ * ACTIVE - Publicada y vigente.
+ * PAUSED - Publicada y pausada: sale del plan vigente hasta reanudarla.
+ * EXPIRED - Vencida por fecha o con "Vencer ahora". No vuelve a aplicar.
+ */
+var CommissionRuleStatusEnum;
+(function (CommissionRuleStatusEnum) {
+    CommissionRuleStatusEnum["DRAFT"] = "DRAFT";
+    CommissionRuleStatusEnum["SCHEDULED"] = "SCHEDULED";
+    CommissionRuleStatusEnum["ACTIVE"] = "ACTIVE";
+    CommissionRuleStatusEnum["PAUSED"] = "PAUSED";
+    CommissionRuleStatusEnum["EXPIRED"] = "EXPIRED";
+})(CommissionRuleStatusEnum || (exports.CommissionRuleStatusEnum = CommissionRuleStatusEnum = {}));

package/bin/retailCommission/enums/CommissionSeriesByEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * De qué se arma una serie por periodo.
+ *
+ * SELLER - Un vendedor.
+ * RULE - Una regla.
+ * STORE - Una tienda.
+ * SKU - Un producto.
+ */
+export declare enum CommissionSeriesByEnum {
+    SELLER = "SELLER",
+    RULE = "RULE",
+    STORE = "STORE",
+    SKU = "SKU"
+}

package/bin/retailCommission/enums/CommissionSeriesByEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionSeriesByEnum = void 0;
+/**
+ * De qué se arma una serie por periodo.
+ *
+ * SELLER - Un vendedor.
+ * RULE - Una regla.
+ * STORE - Una tienda.
+ * SKU - Un producto.
+ */
+var CommissionSeriesByEnum;
+(function (CommissionSeriesByEnum) {
+    CommissionSeriesByEnum["SELLER"] = "SELLER";
+    CommissionSeriesByEnum["RULE"] = "RULE";
+    CommissionSeriesByEnum["STORE"] = "STORE";
+    CommissionSeriesByEnum["SKU"] = "SKU";
+})(CommissionSeriesByEnum || (exports.CommissionSeriesByEnum = CommissionSeriesByEnum = {}));

package/bin/retailCommission/enums/CommissionSimulationSkipEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Por qué una regla no paga en la simulación.
+ *
+ * NOT_IN_EFFECT - Fuera de su vigencia en la fecha simulada.
+ * OUT_OF_SCOPE - El producto o la tienda no caen en su alcance.
+ * CONDITION_NOT_MET - Su condición no se cumple en esa posición.
+ * NO_DATA - Su condición usa un dato que todavía no existe (NPI M30).
+ */
+export declare enum CommissionSimulationSkipEnum {
+    NOT_IN_EFFECT = "NOT_IN_EFFECT",
+    OUT_OF_SCOPE = "OUT_OF_SCOPE",
+    CONDITION_NOT_MET = "CONDITION_NOT_MET",
+    NO_DATA = "NO_DATA"
+}

package/bin/retailCommission/enums/CommissionSimulationSkipEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionSimulationSkipEnum = void 0;
+/**
+ * Por qué una regla no paga en la simulación.
+ *
+ * NOT_IN_EFFECT - Fuera de su vigencia en la fecha simulada.
+ * OUT_OF_SCOPE - El producto o la tienda no caen en su alcance.
+ * CONDITION_NOT_MET - Su condición no se cumple en esa posición.
+ * NO_DATA - Su condición usa un dato que todavía no existe (NPI M30).
+ */
+var CommissionSimulationSkipEnum;
+(function (CommissionSimulationSkipEnum) {
+    CommissionSimulationSkipEnum["NOT_IN_EFFECT"] = "NOT_IN_EFFECT";
+    CommissionSimulationSkipEnum["OUT_OF_SCOPE"] = "OUT_OF_SCOPE";
+    CommissionSimulationSkipEnum["CONDITION_NOT_MET"] = "CONDITION_NOT_MET";
+    CommissionSimulationSkipEnum["NO_DATA"] = "NO_DATA";
+})(CommissionSimulationSkipEnum || (exports.CommissionSimulationSkipEnum = CommissionSimulationSkipEnum = {}));

package/bin/retailCommission/enums/CommissionWindowEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ventana del corte de comisiones.
+ *
+ * SEMANA_OPERATIVA - Semana operativa de la cadena.
+ * ROLLING_7D - Últimos 7 días.
+ * MES - Mes calendario.
+ */
+export declare enum CommissionWindowEnum {
+    SEMANA_OPERATIVA = "SEMANA_OPERATIVA",
+    ROLLING_7D = "ROLLING_7D",
+    MES = "MES"
+}

package/bin/retailCommission/enums/CommissionWindowEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionWindowEnum = void 0;
+/**
+ * Ventana del corte de comisiones.
+ *
+ * SEMANA_OPERATIVA - Semana operativa de la cadena.
+ * ROLLING_7D - Últimos 7 días.
+ * MES - Mes calendario.
+ */
+var CommissionWindowEnum;
+(function (CommissionWindowEnum) {
+    CommissionWindowEnum["SEMANA_OPERATIVA"] = "SEMANA_OPERATIVA";
+    CommissionWindowEnum["ROLLING_7D"] = "ROLLING_7D";
+    CommissionWindowEnum["MES"] = "MES";
+})(CommissionWindowEnum || (exports.CommissionWindowEnum = CommissionWindowEnum = {}));

package/bin/retailCommission/index.d.ts

@@ -11,7 +11,17 @@ export * from './enums/CommissionPayoutStatusEnum';
 export * from './enums/CommissionPayeeTypeEnum';
 export * from './enums/CommissionExceptionTypeEnum';
 export * from './enums/CommissionCalcStepEnum';
+export * from './enums/CommissionRuleStatusEnum';
+export * from './enums/CommissionBonusModeEnum';
+export * from './enums/CommissionMetricEnum';
+export * from './enums/CommissionOperatorEnum';
+export * from './enums/CommissionWindowEnum';
+export * from './enums/CommissionAggregateByEnum';
+export * from './enums/CommissionSeriesByEnum';
+export * from './enums/CommissionSimulationSkipEnum';
 export * from './dtos/CommissionPlan';
+export * from './dtos/CommissionRule';
+export * from './dtos/CommissionCouponAccrual';
 export * from './dtos/CommissionCalcTrace';
 export * from './dtos/CommissionAccrual';
 export * from './dtos/CommissionPayout';

package/bin/retailCommission/index.js

@@ -28,8 +28,18 @@ __exportStar(require("./enums/CommissionPayoutStatusEnum"), exports);
 __exportStar(require("./enums/CommissionPayeeTypeEnum"), exports);
 __exportStar(require("./enums/CommissionExceptionTypeEnum"), exports);
 __exportStar(require("./enums/CommissionCalcStepEnum"), exports);
+__exportStar(require("./enums/CommissionRuleStatusEnum"), exports);
+__exportStar(require("./enums/CommissionBonusModeEnum"), exports);
+__exportStar(require("./enums/CommissionMetricEnum"), exports);
+__exportStar(require("./enums/CommissionOperatorEnum"), exports);
+__exportStar(require("./enums/CommissionWindowEnum"), exports);
+__exportStar(require("./enums/CommissionAggregateByEnum"), exports);
+__exportStar(require("./enums/CommissionSeriesByEnum"), exports);
+__exportStar(require("./enums/CommissionSimulationSkipEnum"), exports);
 // Entidades del dominio
 __exportStar(require("./dtos/CommissionPlan"), exports);
+__exportStar(require("./dtos/CommissionRule"), exports);
+__exportStar(require("./dtos/CommissionCouponAccrual"), exports);
 __exportStar(require("./dtos/CommissionCalcTrace"), exports);
 __exportStar(require("./dtos/CommissionAccrual"), exports);
 __exportStar(require("./dtos/CommissionPayout"), exports);

package/bin/retailLoan/dtos/CreateMyPaymentRequest.d.ts

@@ -2,6 +2,8 @@ import { MyPaymentTypeEnum } from '../enums/MyPaymentTypeEnum';
 /** Body de `POST /benefits/{benefitId}/credits/{creditId}/payments`. La llave va en el header `Idempotency-Key`. */
 export declare class CreateMyPaymentRequest {
     type: MyPaymentTypeEnum;
-    /** Monto en pesos que vio el cliente; si ya no coincide, responde PAYMENT_AMOUNT_CHANGED. */
+    /** Monto en pesos que vio el cliente (en PREPAYMENT, el que eligió); si ya no coincide, responde PAYMENT_AMOUNT_CHANGED. */
     expectedAmount: number;
+    /** Solo ADVANCE: cuántas cuotas adelanta. */
+    installmentCount?: number;
 }

package/bin/retailLoan/dtos/CreateMyPaymentRequest.js

@@ -28,3 +28,10 @@ __decorate([
     (0, class_validator_1.IsPositive)(),
     __metadata("design:type", Number)
 ], CreateMyPaymentRequest.prototype, "expectedAmount", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(2),
+    __metadata("design:type", Number)
+], CreateMyPaymentRequest.prototype, "installmentCount", void 0);

package/bin/retailLoan/dtos/CreateMyPaymentResponse.d.ts

@@ -6,4 +6,6 @@ export interface CreateMyPaymentResponse {
     type: MyPaymentTypeEnum;
     amount: number;
     collection: MyCollectionOutcomeEnum;
+    /** Solo ADVANCE: cuántas cuotas cubre. */
+    installmentCount?: number;
 }

package/bin/retailLoan/dtos/MyPaymentOptions.d.ts

@@ -7,12 +7,21 @@ export interface MyPaymentOption {
     unavailableReason?: MyPaymentUnavailableReasonEnum;
     amount?: number;
 }
+/** Una cuota que se puede adelantar. `amount` en pesos. */
+export interface MyAdvanceInstallment {
+    installmentNumber: number;
+    /** `YYYY-MM-DD`. */
+    dueDate: string;
+    amount: number;
+}
 /** Opciones de pago de un crédito (`GET /benefits/{benefitId}/credits/{creditId}/payment-options`). Montos en pesos. */
 export interface MyPaymentOptions {
     /** Pago en curso; mientras exista, ninguna opción está disponible. */
     pendingPayment?: {
         type: MyPaymentTypeEnum;
         amount: number;
+        /** Solo en varias cuotas: las cuotas que cubre. */
+        installmentNumbers?: number[];
     };
     nextInstallment: MyPaymentOption & {
         mode?: MyNextInstallmentModeEnum;
@@ -20,7 +29,18 @@ export interface MyPaymentOptions {
         /** `YYYY-MM-DD`. */
         dueDate?: string;
     };
-    advance: MyPaymentOption;
+    /** Varias cuotas. `installments` trae las `maxInstallments` que se pueden adelantar, en orden. */
+    advance: MyPaymentOption & {
+        minInstallments?: number;
+        maxInstallments?: number;
+        installments?: MyAdvanceInstallment[];
+    };
+    /** Abono a capital: monto libre entre `minAmount` y `maxAmount`. */
+    prepayment: MyPaymentOption & {
+        minAmount?: number;
+        maxAmount?: number;
+        outstandingCapital?: number;
+    };
     settlement: MyPaymentOption & {
         breakdown?: {
             overdue: number;

package/bin/retailLoan/enums/MyPaymentTypeEnum.d.ts

@@ -1,6 +1,7 @@
-/** Pago que el cliente pide desde la app. `ADVANCE` = varias cuotas. */
+/** Pago que el cliente pide desde la app. `ADVANCE` = varias cuotas; `PREPAYMENT` = abono a capital. */
 export declare enum MyPaymentTypeEnum {
     NEXT_INSTALLMENT = "NEXT_INSTALLMENT",
     ADVANCE = "ADVANCE",
-    SETTLEMENT = "SETTLEMENT"
+    SETTLEMENT = "SETTLEMENT",
+    PREPAYMENT = "PREPAYMENT"
 }