@fiado/type-kit 3.491.0 → 3.493.0

package/src/retailCommission/dtos/CommissionApi.ts

@@ -6,8 +6,30 @@ import type {
     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.
@@ -203,3 +225,255 @@ export interface ClosePayoutResponse {
 
 /** Lo que el simulador reconstruye desde el data lake para volver a correr el motor. */
 export type CommissionSimulationSale = CommissionSaleInput;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Reglas y políticas
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** `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;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Corte vivo, agregados y series
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** `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[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Simulador de reglas
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** 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;
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Mis comisiones (Portal Vendedor)
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** 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/src/retailCommission/dtos/CommissionCalcTrace.ts

@@ -59,6 +59,13 @@ export type CommissionCalcTraceEntry =
           label: string;
           outputCents: number;
           detail: { 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/src/retailCommission/dtos/CommissionCouponAccrual.ts

@@ -0,0 +1,33 @@
+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/src/retailCommission/dtos/CommissionPayout.ts

@@ -50,6 +50,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;
 }
 
 /**
@@ -74,3 +76,92 @@ 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/src/retailCommission/dtos/CommissionRule.ts

@@ -0,0 +1,132 @@
+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/src/retailCommission/enums/CommissionAggregateByEnum.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 enum CommissionAggregateByEnum {
+    RULE = 'RULE',
+    STORE = 'STORE',
+    SKU = 'SKU',
+    SELLER = 'SELLER',
+}

package/src/retailCommission/enums/CommissionBonusModeEnum.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 enum CommissionBonusModeEnum {
+    FIXED = 'FIXED',
+    PERCENT = 'PERCENT',
+}

package/src/retailCommission/enums/CommissionCalcStepEnum.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.
  */
@@ -20,4 +21,5 @@ export enum CommissionCalcStepEnum {
     QUOTA = 'QUOTA',
     ADJUSTMENT = 'ADJUSTMENT',
     NO_CATEGORY = 'NO_CATEGORY',
+    BONUS_PER_SALE = 'BONUS_PER_SALE',
 }

package/src/retailCommission/enums/CommissionMetricEnum.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 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/src/retailCommission/enums/CommissionOperatorEnum.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 enum CommissionOperatorEnum {
+    GTE = 'GTE',
+    LTE = 'LTE',
+    LT = 'LT',
+    GT = 'GT',
+    BETWEEN = 'BETWEEN',
+    IN = 'IN',
+}

package/src/retailCommission/enums/CommissionRuleStatusEnum.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 enum CommissionRuleStatusEnum {
+    DRAFT = 'DRAFT',
+    SCHEDULED = 'SCHEDULED',
+    ACTIVE = 'ACTIVE',
+    PAUSED = 'PAUSED',
+    EXPIRED = 'EXPIRED',
+}

package/src/retailCommission/enums/CommissionSeriesByEnum.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 enum CommissionSeriesByEnum {
+    SELLER = 'SELLER',
+    RULE = 'RULE',
+    STORE = 'STORE',
+    SKU = 'SKU',
+}