@fiado/type-kit 3.491.0 → 3.493.0

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/retailWizard/dtos/WizardCreditPromotionBonus.d.ts

@@ -5,4 +5,7 @@ export interface WizardCreditPromotionBonus {
     amountCents: number;
     /** `RESERVED` = en proceso; los otros tres son terminales. */
     status: PromotionBonusStatusEnum;
+    /** ISO 8601 del instante en que el bono entró en RESERVED por primera vez.
+     *  Lo sella el wizard una vez y no cambia después. */
+    pendingSince?: string;
 }

package/bin/retailWizard/enums/RetailCommissionInboundMessageTypeEnum.d.ts

@@ -0,0 +1,5 @@
+/** Tipo de mensaje que el wizard publica en la cola de Comisiones. */
+export declare enum RetailCommissionInboundMessageTypeEnum {
+    SALE_COMPLETED = "SALE_COMPLETED",
+    SALE_CANCELLED = "SALE_CANCELLED"
+}

package/bin/retailWizard/enums/RetailCommissionInboundMessageTypeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailCommissionInboundMessageTypeEnum = void 0;
+/** Tipo de mensaje que el wizard publica en la cola de Comisiones. */
+var RetailCommissionInboundMessageTypeEnum;
+(function (RetailCommissionInboundMessageTypeEnum) {
+    RetailCommissionInboundMessageTypeEnum["SALE_COMPLETED"] = "SALE_COMPLETED";
+    RetailCommissionInboundMessageTypeEnum["SALE_CANCELLED"] = "SALE_CANCELLED";
+})(RetailCommissionInboundMessageTypeEnum || (exports.RetailCommissionInboundMessageTypeEnum = RetailCommissionInboundMessageTypeEnum = {}));

package/bin/retailWizard/events/RetailCommissionInboundMessage.d.ts

@@ -1,19 +1,45 @@
 import { ItemTypeEnum } from '../../retailCatalog/enums/ItemTypeEnum';
+import { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
+import { ExternalProviderEnum } from '../enums/ExternalProviderEnum';
+import { LinePaymentTypeEnum } from '../enums/LinePaymentTypeEnum';
+import { RetailCommissionInboundMessageTypeEnum } from '../enums/RetailCommissionInboundMessageTypeEnum';
+import { SaleTypeEnum } from '../enums/SaleTypeEnum';
+import { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
 /** Línea vendida en el mensaje de comisiones. */
 export declare class RetailCommissionInboundLine {
+    lineId: string;
     sku: string;
     qty: number;
     /** Precio neto de la línea (precio − descuento). */
     netCents: number;
     itemType: ItemTypeEnum;
+    /** `null` si la línea no trae la ficha del producto. */
+    category: ProductCategoryEnum | null;
+    /** `null` = sin gama. */
+    tier: ProductTierEnum | null;
+    brand: string | null;
+    paymentType: LinePaymentTypeEnum;
+    role?: WizardLineRoleEnum;
 }
-/** Venta de la saga que el wizard publica en la cola de comisiones, con sus líneas. */
+/** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */
 export declare class RetailCommissionInboundMessage {
+    type: RetailCommissionInboundMessageTypeEnum;
     tenantId: string;
     retailerId: string;
     storeId: string;
     saleId: string;
     sessionId: string;
+    /** Quién vendió. */
+    sellerRetailUserId: string;
+    saleType: SaleTypeEnum;
+    /** Solo en EXTERNAL_REFERRAL. */
+    externalProvider: ExternalProviderEnum | null;
+    creditId: string | null;
     soldAt: string;
+    /** soldAt en la venta; cancelledAt en la cancelación. */
+    occurredAt: string;
+    /** Motivo de la cancelación; puede venir vacío. */
+    cancelReason?: string;
     lines: RetailCommissionInboundLine[];
 }

package/bin/retailWizard/events/RetailCommissionInboundMessage.js

@@ -13,10 +13,22 @@ exports.RetailCommissionInboundMessage = exports.RetailCommissionInboundLine = v
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const ItemTypeEnum_1 = require("../../retailCatalog/enums/ItemTypeEnum");
+const ProductCategoryEnum_1 = require("../../retailCatalog/enums/ProductCategoryEnum");
+const ProductTierEnum_1 = require("../../retailCatalog/enums/ProductTierEnum");
+const ExternalProviderEnum_1 = require("../enums/ExternalProviderEnum");
+const LinePaymentTypeEnum_1 = require("../enums/LinePaymentTypeEnum");
+const RetailCommissionInboundMessageTypeEnum_1 = require("../enums/RetailCommissionInboundMessageTypeEnum");
+const SaleTypeEnum_1 = require("../enums/SaleTypeEnum");
+const WizardLineRoleEnum_1 = require("../enums/WizardLineRoleEnum");
 /** Línea vendida en el mensaje de comisiones. */
 class RetailCommissionInboundLine {
 }
 exports.RetailCommissionInboundLine = RetailCommissionInboundLine;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundLine.prototype, "lineId", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
@@ -36,10 +48,38 @@ __decorate([
     (0, class_validator_1.IsEnum)(ItemTypeEnum_1.ItemTypeEnum),
     __metadata("design:type", String)
 ], RetailCommissionInboundLine.prototype, "itemType", void 0);
-/** Venta de la saga que el wizard publica en la cola de comisiones, con sus líneas. */
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductCategoryEnum_1.ProductCategoryEnum),
+    __metadata("design:type", String)
+], RetailCommissionInboundLine.prototype, "category", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductTierEnum_1.ProductTierEnum),
+    __metadata("design:type", String)
+], RetailCommissionInboundLine.prototype, "tier", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundLine.prototype, "brand", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(LinePaymentTypeEnum_1.LinePaymentTypeEnum),
+    __metadata("design:type", String)
+], RetailCommissionInboundLine.prototype, "paymentType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(WizardLineRoleEnum_1.WizardLineRoleEnum),
+    __metadata("design:type", String)
+], RetailCommissionInboundLine.prototype, "role", void 0);
+/** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */
 class RetailCommissionInboundMessage {
 }
 exports.RetailCommissionInboundMessage = RetailCommissionInboundMessage;
+__decorate([
+    (0, class_validator_1.IsEnum)(RetailCommissionInboundMessageTypeEnum_1.RetailCommissionInboundMessageTypeEnum),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "type", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
@@ -65,10 +105,39 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], RetailCommissionInboundMessage.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "sellerRetailUserId", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(SaleTypeEnum_1.SaleTypeEnum),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "saleType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ExternalProviderEnum_1.ExternalProviderEnum),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "externalProvider", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "creditId", void 0);
 __decorate([
     (0, class_validator_1.IsISO8601)(),
     __metadata("design:type", String)
 ], RetailCommissionInboundMessage.prototype, "soldAt", void 0);
+__decorate([
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "occurredAt", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "cancelReason", void 0);
 __decorate([
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(1),

package/bin/retailWizard/index.d.ts

@@ -139,6 +139,7 @@ export * from './events/SaleCompletedV2';
 export * from './events/SaleCancelledV2';
 export * from './events/SessionExpiredV1';
 export * from './enums/RetailPromotionInboundMessageTypeEnum';
+export * from './enums/RetailCommissionInboundMessageTypeEnum';
 export * from './events/RetailPromotionInboundMessage';
 export * from './events/RetailCommissionInboundMessage';
 export * from './enums/WizardSessionLookupStatusEnum';

package/bin/retailWizard/index.js

@@ -170,6 +170,7 @@ __exportStar(require("./events/SaleCompletedV2"), exports);
 __exportStar(require("./events/SaleCancelledV2"), exports);
 __exportStar(require("./events/SessionExpiredV1"), exports);
 __exportStar(require("./enums/RetailPromotionInboundMessageTypeEnum"), exports);
+__exportStar(require("./enums/RetailCommissionInboundMessageTypeEnum"), exports);
 __exportStar(require("./events/RetailPromotionInboundMessage"), exports);
 __exportStar(require("./events/RetailCommissionInboundMessage"), exports);
 // Lookup privado por lote (GET /private/wizard-sessions/batch)

package/package.json

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

package/src/loanCredit/dtos/InstallmentPaidEvent.ts

@@ -0,0 +1,20 @@
+import type { LoanInstallmentStatusEnum } from '../enums/LoanInstallmentStatusEnum';
+
+/** `eventType` del outbox cuando una cuota queda pagada. */
+export const INSTALLMENT_PAID_EVENT_TYPE = 'InstallmentPaidV1';
+
+/**
+ * Payload de `InstallmentPaidV1`: una cuota que pasó a `PAID` o `PAID_IN_ADVANCE` por cualquier
+ * camino (cargo de la cuota, revisión, adelanto, liquidación o recuperación). Se escribe al outbox en
+ * la misma transacción que la cuota. Sin PII.
+ */
+export interface InstallmentPaidV1Payload {
+    creditId: string;
+    installmentNumber: number;
+    /** Lo pagado de la cuota en total (capital + interés + IVA), en centavos. */
+    paidCents: number;
+    /** Instante del pago (ISO): decide el corte de la renta. */
+    paidAt: string;
+    installmentStatus: LoanInstallmentStatusEnum;
+    paymentId: string;
+}

package/src/loanCredit/index.ts

@@ -10,6 +10,7 @@ export * from './dtos/LoanBorrower';
 export * from './dtos/LoanBeneficiary';
 export * from './dtos/LoanCredit';
 export * from './dtos/LoanInstallment';
+export * from './dtos/InstallmentPaidEvent';
 export * from './dtos/LoanContract';
 export * from './dtos/ActivationChecklist';
 export * from './dtos/AppliedPromotionSnapshot';

package/src/retailCommission/dtos/CommissionAccrual.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.
@@ -52,6 +57,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;
 }
 
 /**
@@ -78,4 +87,33 @@ 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;
 }