@fiado/type-kit 3.491.0 → 3.492.0

package/bin/loanCredit/index.js

@@ -27,6 +27,7 @@ __exportStar(require("./dtos/LoanBorrower"), exports);
 __exportStar(require("./dtos/LoanBeneficiary"), exports);
 __exportStar(require("./dtos/LoanCredit"), exports);
 __exportStar(require("./dtos/LoanInstallment"), exports);
+__exportStar(require("./dtos/InstallmentPaidEvent"), exports);
 __exportStar(require("./dtos/LoanContract"), exports);
 __exportStar(require("./dtos/ActivationChecklist"), exports);
 __exportStar(require("./dtos/AppliedPromotionSnapshot"), exports);

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

@@ -2,6 +2,11 @@ import type { CommissionAccrualStatusEnum } from '../enums/CommissionAccrualStat
 import type { CommissionPayeeTypeEnum } from '../enums/CommissionPayeeTypeEnum';
 import type { SaleFinancierEnum } from '../../retailWizard/enums/SaleFinancierEnum';
 import type { CommissionCalcTrace } from './CommissionCalcTrace';
+import type { CommissionBonusModeEnum } from '../enums/CommissionBonusModeEnum';
+import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
+import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
+import type { LinePaymentTypeEnum } from '../../retailWizard/enums/LinePaymentTypeEnum';
+import type { WizardLineRoleEnum } from '../../retailWizard/enums/WizardLineRoleEnum';
 /**
  * El devengo: lo que se le debe a un vendedor por UNA venta.
  * SureKeep Fase 3 — pista Retail.
@@ -50,6 +55,10 @@ export interface CommissionAccrual {
     payoutId: string | null;
     reversalReason: string | null;
     calcTrace: CommissionCalcTrace;
+    /** Los bonos por venta que sumaron, uno por regla y por pieza. Solo en devengos calculados con reglas. */
+    appliedBonuses?: CommissionAppliedBonus[];
+    /** Suma de `appliedBonuses`. Solo en devengos calculados con reglas. */
+    subtotalBonusCents?: number;
 }
 /**
  * Lo mínimo de una venta para devengarla. Es lo que llega por la cola y lo que se reconstruye
@@ -75,4 +84,31 @@ export interface CommissionSaleInput {
     /** `CASH` | `CREDIT`, para `PERCENT_BY_PAYMENT`. */
     paymentType: string;
     soldAt: string;
+    /** Las líneas de la venta. Las ventas que se calculan con reglas siempre las traen. */
+    lines?: CommissionSaleLine[];
+}
+/** Una línea de la venta, congelada en el devengo. */
+export interface CommissionSaleLine {
+    lineId: string;
+    sku: string;
+    qty: number;
+    /** Precio neto de la línea completa (todas sus piezas). */
+    netCents: number;
+    category: ProductCategoryEnum | null;
+    tier: ProductTierEnum | null;
+    brand: string | null;
+    paymentType: LinePaymentTypeEnum;
+    /** `GIFT` = regalo: no comisiona ni cuenta en la posición. */
+    role?: WizardLineRoleEnum;
+}
+/** Un bono por venta que sumó en el devengo. */
+export interface CommissionAppliedBonus {
+    ruleId: string;
+    name: string;
+    lineId: string;
+    sku: string;
+    /** Posición de la pieza en el contador de la regla dentro del periodo. */
+    position: number;
+    mode: CommissionBonusModeEnum;
+    amountCents: number;
 }

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

@@ -1,8 +1,16 @@
 import type { CommissionPlanStatusEnum } from '../enums/CommissionPlanStatusEnum';
 import type { CommissionPayoutStatusEnum } from '../enums/CommissionPayoutStatusEnum';
 import type { CommissionAddOn, CommissionCategory, CommissionPlanSnapshot, CommissionQuota } from './CommissionPlan';
-import type { CommissionAccrual, CommissionSaleInput } from './CommissionAccrual';
-import type { CommissionAdjustment, CommissionPayout, CommissionPayoutSeller } from './CommissionPayout';
+import type { CommissionAccrual, CommissionAppliedBonus, CommissionSaleInput, CommissionSaleLine } from './CommissionAccrual';
+import type { CommissionAdjustment, CommissionAppliedMultiplier, CommissionAppliedThreshold, CommissionPayout, CommissionPayoutSeller, CommissionSellerBreakdown } from './CommissionPayout';
+import type { CommissionPolicies, CommissionRule, CommissionRuleCondition, CommissionRuleLevers, CommissionRuleScope, CommissionRuleSetSnapshot } from './CommissionRule';
+import type { CommissionWindowEnum } from '../enums/CommissionWindowEnum';
+import type { CommissionAggregateByEnum } from '../enums/CommissionAggregateByEnum';
+import type { CommissionSeriesByEnum } from '../enums/CommissionSeriesByEnum';
+import type { CommissionAccrualStatusEnum } from '../enums/CommissionAccrualStatusEnum';
+import type { CommissionSimulationSkipEnum } from '../enums/CommissionSimulationSkipEnum';
+import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
+import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
 /**
  * Los contratos HTTP del motor de comisiones — uno por endpoint, sin reutilizar.
  * SureKeep Fase 3 — pista Retail.
@@ -167,3 +175,234 @@ export interface ClosePayoutResponse {
 }
 /** Lo que el simulador reconstruye desde el data lake para volver a correr el motor. */
 export type CommissionSimulationSale = CommissionSaleInput;
+/** `GET /backoffice/commissions/plan` — el plan vigente con reglas. `null` mientras no se publica nada. */
+export interface GetRuleSetResponse {
+    active: CommissionRuleSetSnapshot | null;
+}
+/** `GET /backoffice/commissions/rules` — la última versión de cada regla. */
+export interface ListRulesResponse {
+    rules: CommissionRule[];
+}
+/** Lo que el editor manda al crear o guardar una regla. */
+export interface CommissionRuleInput {
+    name: string;
+    description: string | null;
+    levers: CommissionRuleLevers;
+    scope: CommissionRuleScope;
+    condition: CommissionRuleCondition | null;
+    effectiveFrom: string;
+    effectiveTo: string | null;
+    priority: number;
+    replacesOthers: boolean;
+}
+/** `POST /backoffice/commissions/rules` — la regla nace en borrador. */
+export type CreateRuleRequest = CommissionRuleInput;
+/** `PUT /backoffice/commissions/rules/{ruleId}` — `expectedVersion` es la versión que el editor cargó. */
+export interface UpdateRuleRequest extends CommissionRuleInput {
+    expectedVersion: number;
+}
+export interface RuleResponse {
+    rule: CommissionRule;
+}
+/** `POST /backoffice/commissions/rules/{ruleId}/publish | pause | resume | expire` */
+export interface RuleActionRequest {
+    expectedVersion: number;
+}
+/** Las acciones que cambian el plan vigente devuelven la regla y el snapshot nuevo. */
+export interface RuleActionResponse {
+    rule: CommissionRule;
+    snapshotId: string;
+}
+/** Un evento del historial de una regla. */
+export interface CommissionRuleEvent {
+    at: string;
+    action: string;
+    performedBy: string;
+    version: number | null;
+}
+/** `GET /backoffice/commissions/rules/{ruleId}/history` — del más nuevo al más viejo. */
+export interface RuleHistoryResponse {
+    events: CommissionRuleEvent[];
+}
+/** `GET /backoffice/commissions/policies` */
+export interface GetPoliciesResponse {
+    policies: CommissionPolicies;
+}
+/** `PUT /backoffice/commissions/policies` — las dos políticas se guardan juntas. */
+export interface UpdatePoliciesRequest {
+    clawback: {
+        cancelacionDias: number;
+        devolucionDias: number;
+        npiM30Dias: number;
+    };
+    commissions: {
+        multiplicadorMaxBps: number;
+        ventanaDefault: CommissionWindowEnum;
+    };
+}
+export interface UpdatePoliciesResponse {
+    policies: CommissionPolicies;
+    snapshotId: string;
+}
+/** `GET /backoffice/commissions/live?periodId=` — el corte calculado al momento, sin escribir nada. */
+export interface GetLivePayoutResponse {
+    periodId: string;
+    periodStart: string;
+    periodEnd: string;
+    status: CommissionPayoutStatusEnum;
+    sellers: CommissionSellerBreakdown[];
+}
+/** Una venta del vendedor en el corte, con sus bonos recalculados en orden. Sin datos del cliente. */
+export interface CommissionLiveSale {
+    saleId: string;
+    soldAt: string;
+    storeId: string;
+    status: CommissionAccrualStatusEnum;
+    /** El snapshot con el que se devengó: es el que se usa para recalcularla. */
+    planSnapshotId: string;
+    lines: CommissionSaleLine[];
+    appliedBonuses: CommissionAppliedBonus[];
+    subtotalBonusCents: number;
+}
+/** `GET /backoffice/commissions/live/sellers/{sellerId}?periodId=` */
+export interface GetLiveSellerResponse {
+    periodId: string;
+    seller: CommissionSellerBreakdown;
+    sales: CommissionLiveSale[];
+}
+/** Un renglón del agregado. `name` es el de la regla; tienda, SKU y vendedor los resuelve el front. */
+export interface CommissionAggregateRow {
+    key: string;
+    name: string | null;
+    sellersCount: number;
+    salesCount: number;
+    unitsCount: number;
+    placementCents: number;
+    paidCents: number;
+}
+/** `GET /backoffice/commissions/payouts/aggregates?by=&from=&to=` — sobre los cortes cerrados del rango. */
+export interface GetPayoutAggregatesResponse {
+    by: CommissionAggregateByEnum;
+    from: string;
+    to: string;
+    /** Los cortes cerrados que entraron. */
+    periodIds: string[];
+    rows: CommissionAggregateRow[];
+    totalPaidCents: number;
+}
+/** Un punto de la serie: un corte cerrado. */
+export interface CommissionSeriesPoint {
+    periodId: string;
+    salesCount: number;
+    unitsCount: number;
+    placementCents: number;
+    paidCents: number;
+}
+/** `GET /backoffice/commissions/payouts/series?by=&id=&weeks=` — del corte más viejo al más nuevo. */
+export interface GetPayoutSeriesResponse {
+    by: CommissionSeriesByEnum;
+    id: string;
+    points: CommissionSeriesPoint[];
+}
+/** El vendedor modelo: cómo va su semana. */
+export interface CommissionSimulationProfile {
+    unitsInWeek: number;
+    placementCents: number;
+    distinctSkus: number;
+}
+/** El producto que vende en la simulación. */
+export interface CommissionSimulationProduct {
+    sku: string;
+    category: ProductCategoryEnum | null;
+    tier: ProductTierEnum | null;
+    netCents: number;
+}
+/** `POST /backoffice/commissions/rules/simulate` */
+export interface SimulateRulesRequest {
+    /** Reglas por id, en su última versión, como si estuvieran publicadas. Vacío = el plan vigente. */
+    ruleIds: string[];
+    profile: CommissionSimulationProfile;
+    product: CommissionSimulationProduct;
+    /** Con tienda se evalúa el alcance por tienda; sin ella, se ignora. */
+    storeId: string | null;
+    /** `YYYY-MM-DD`. `null` = hoy. */
+    date: string | null;
+}
+/** Lo que una regla de bono por venta pagaría en una posición, o por qué no. */
+export interface CommissionSimulatedRule {
+    ruleId: string;
+    name: string;
+    amountCents: number;
+    skipped: CommissionSimulationSkipEnum | null;
+}
+export interface SimulateRulesResponse {
+    date: string;
+    /** La venta siguiente, en la posición `unitsInWeek + 1`. */
+    nextSale: {
+        position: number;
+        subtotalBonusCents: number;
+        rules: CommissionSimulatedRule[];
+    };
+    /** Las piezas de la semana, en las posiciones 1 a `unitsInWeek`. */
+    progression: Array<{
+        position: number;
+        subtotalBonusCents: number;
+        cumulativeBonusCents: number;
+    }>;
+    /** El corte de esa semana. */
+    week: {
+        subtotalBonusCents: number;
+        multiplierBps: number;
+        multiplierBeforeCapBps: number;
+        multipliers: CommissionAppliedMultiplier[];
+        thresholdBonusCents: number;
+        thresholds: CommissionAppliedThreshold[];
+        releasedCents: number;
+    };
+}
+/** Una regla como la ve el vendedor: sin estado interno ni datos de auditoría. */
+export interface CommissionRuleView {
+    ruleId: string;
+    name: string;
+    description: string | null;
+    levers: CommissionRuleLevers;
+    scope: CommissionRuleScope;
+    condition: CommissionRuleCondition | null;
+    effectiveFrom: string;
+    effectiveTo: string | null;
+}
+/** Lo pagado en varios cortes. */
+export interface MyCommissionsTotals {
+    periodsCount: number;
+    salesCount: number;
+    unitsCount: number;
+    netCents: number;
+}
+/**
+ * `GET /commissions/me?weeks=` — las comisiones del vendedor que llama. El vendedor sale del token;
+ * no se puede pedir el de otro.
+ */
+export interface GetMyCommissionsResponse {
+    seller: {
+        sellerId: string;
+        name: string | null;
+        storeId: string | null;
+    };
+    period: {
+        periodId: string;
+        periodStart: string;
+        periodEnd: string;
+    };
+    /** El corte en curso; `null` si todavía no tiene ventas, renta ni ajustes. */
+    week: CommissionSellerBreakdown | null;
+    /** Cortes cuya semana empieza en el mes de hoy: cerrados, el anterior aún sin cerrar y el en curso. */
+    month: MyCommissionsTotals;
+    /** Cortes cuya semana empieza en el año de hoy: cerrados, el anterior aún sin cerrar y el en curso. */
+    year: MyCommissionsTotals;
+    /** Los cortes cerrados de las últimas `weeks` semanas, del más viejo al más nuevo. `paidCents` es el neto. */
+    history: CommissionSeriesPoint[];
+    /** Las reglas vigentes hoy que pueden pagarle: las de corte, las sin tienda y las de su tienda o de donde vendió. */
+    rules: CommissionRuleView[];
+    /** Tope del multiplicador de la política; `null` sin política. */
+    multiplierCapBps: number | null;
+}

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

@@ -69,5 +69,15 @@ export type CommissionCalcTraceEntry = {
         sku: string;
         brand: string | null;
     };
+} | {
+    /** Una regla con bono por venta sumó por una pieza. */
+    step: CommissionCalcStepEnum.BONUS_PER_SALE;
+    label: string;
+    outputCents: number;
+    detail: {
+        ruleId: string;
+        lineId: string;
+        position: number;
+    };
 };
 export type CommissionCalcTrace = CommissionCalcTraceEntry[];

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

@@ -0,0 +1,31 @@
+import type { CommissionAccrualStatusEnum } from '../enums/CommissionAccrualStatusEnum';
+import type { CommissionBonusModeEnum } from '../enums/CommissionBonusModeEnum';
+/** Lo que paga una regla de renta de cartera por una cuota cobrada. */
+export interface CommissionCouponAppliedBonus {
+    ruleId: string;
+    name: string;
+    mode: CommissionBonusModeEnum;
+    amountCents: number;
+}
+/**
+ * La renta de cartera de una cuota pagada, en el corte de su pago.
+ * Clave `SELLER#<sellerId>` · `COUPON#<periodId>#<creditId>#<cuota>`: determinista, idempotente.
+ */
+export interface CommissionCouponAccrual {
+    sellerId: string;
+    retailerId: string;
+    periodId: string;
+    creditId: string;
+    /** La venta que originó el crédito. */
+    saleId: string;
+    installmentNumber: number;
+    /** Lo pagado de la cuota (capital + interés + IVA). */
+    couponAmountCents: number;
+    paidAt: string;
+    /** El snapshot con que se evaluó: de ahí salen las condiciones al cerrar el corte. */
+    planSnapshotId: string;
+    bonuses: CommissionCouponAppliedBonus[];
+    subtotalCents: number;
+    status: CommissionAccrualStatusEnum;
+    createdAt: string;
+}

package/bin/retailCommission/dtos/CommissionCouponAccrual.js

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

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 = {}));