@fiado/type-kit 3.648.0 → 3.650.0

package/_test_/unit/costCenter/moduleCostCenterConfig.test.ts

@@ -0,0 +1,77 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { CreateSalePromotionRequest, UpdateSalePromotionRequest } from '../../../src/retailPromotions/index';
+import { CreatePromotionRequest, UpdatePromotionRequest } from '../../../src/loanOfferings/index';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../src/transaction/index';
+import type { WelcomeBonusPromotionResponse, SalePromotion } from '../../../src/retailPromotions/index';
+import type { PromotionBonusResponse, PromotionResponse } from '../../../src/loanOfferings/index';
+import type { CommissionPayoutPolicy, UpdatePoliciesRequest } from '../../../src/retailCommission/index';
+
+type Dto = new () => object;
+
+const errorProperties = async (dtoClass: Dto, raw: Record<string, unknown>): Promise<string[]> => {
+  const instance = plainToInstance(dtoClass, raw, { excludeExtraneousValues: true });
+  return (await validate(instance as object)).map((error) => error.property);
+};
+
+const salePromotion = {
+  name: 'Bono de venta',
+  customerText: 'Bono a tu wallet',
+  levers: { walletBonus: { amountCents: 10000 } },
+};
+
+const creditPromotion = {
+  name: 'Bono PCF',
+  description: 'Bono al activar el crédito',
+  effect: { pcfBonusCents: 5000 },
+  segmentId: 'SEG_ALL',
+  targetLevels: ['SILVER'],
+};
+
+describe('centro de costo en la configuración de los módulos que pagan', () => {
+  const tooLong = 'X'.repeat(COST_CENTER_ID_MAX_LENGTH + 1);
+
+  it.each([
+    ['CreateSalePromotionRequest', CreateSalePromotionRequest, salePromotion],
+    ['UpdateSalePromotionRequest', UpdateSalePromotionRequest, {}],
+    ['CreatePromotionRequest', CreatePromotionRequest, creditPromotion],
+    ['UpdatePromotionRequest', UpdatePromotionRequest, {}],
+  ] as const)('%s acepta el centro, ausente o null, y lo conserva al transformar', async (_name, dto, base) => {
+    const parsed = plainToInstance(dto as Dto, { ...base, costCenterId: 'CC_PROMO' }, { excludeExtraneousValues: true }) as {
+      costCenterId?: string | null;
+    };
+    expect(parsed.costCenterId).toBe('CC_PROMO');
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: 'CC_PROMO' })).not.toContain('costCenterId');
+    expect(await errorProperties(dto as Dto, { ...base })).not.toContain('costCenterId');
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: null })).not.toContain('costCenterId');
+  });
+
+  it.each([
+    ['CreateSalePromotionRequest', CreateSalePromotionRequest, salePromotion],
+    ['UpdateSalePromotionRequest', UpdateSalePromotionRequest, {}],
+    ['CreatePromotionRequest', CreatePromotionRequest, creditPromotion],
+    ['UpdatePromotionRequest', UpdatePromotionRequest, {}],
+  ] as const)('%s rechaza el centro vacío, que no es texto o demasiado largo', async (_name, dto, base) => {
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: '' })).toContain('costCenterId');
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: 42 })).toContain('costCenterId');
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: tooLong })).toContain('costCenterId');
+  });
+
+  it('las respuestas y la política de pagos llevan el centro opcional', () => {
+    const welcome: WelcomeBonusPromotionResponse = { promotionId: 'p', active: true, amountCents: 2500, costCenterId: 'CC_WELCOME' };
+    const bonus: Pick<PromotionBonusResponse, 'costCenterId'> = { costCenterId: 'CC_CREDIT' };
+    const credit: Pick<PromotionResponse, 'costCenterId'> = {};
+    const sale: Pick<SalePromotion, 'costCenterId'> = { costCenterId: 'CC_SALE' };
+    const payouts: Pick<CommissionPayoutPolicy, 'costCenterId'> = { costCenterId: 'CC_COMMISSION' };
+    const update: NonNullable<UpdatePoliciesRequest['payouts']>['costCenterId'] = null;
+    expect([welcome.costCenterId, bonus.costCenterId, credit.costCenterId, sale.costCenterId, payouts.costCenterId, update]).toEqual([
+      'CC_WELCOME',
+      'CC_CREDIT',
+      undefined,
+      'CC_SALE',
+      'CC_COMMISSION',
+      null,
+    ]);
+  });
+});

package/bin/collection/index.d.ts

@@ -13,7 +13,6 @@ export * from './enums/RedriveOutboxStatus';
 export * from './enums/DisbursementType';
 export * from './constants/CollectionResultLimits';
 export * from './validators/IsCentPrecision';
-export * from './interfaces/TenantCostCenters';
 export * from './dtos/PendingChargeDto';
 export * from './dtos/CollectRequest';
 export * from './dtos/CollectResponse';

package/bin/collection/index.js

@@ -31,8 +31,6 @@ __exportStar(require("./enums/DisbursementType"), exports);
 // Constantes y validadores
 __exportStar(require("./constants/CollectionResultLimits"), exports);
 __exportStar(require("./validators/IsCentPrecision"), exports);
-// Interfaces
-__exportStar(require("./interfaces/TenantCostCenters"), exports);
 // DTOs
 __exportStar(require("./dtos/PendingChargeDto"), exports);
 __exportStar(require("./dtos/CollectRequest"), exports);

package/bin/loanOfferings/dtos/requests/CreatePromotionRequest.d.ts

@@ -31,4 +31,9 @@ export declare class CreatePromotionRequest {
      * presupuesto negativo es un request bien formado que el negocio rechaza.
      */
     budgetMaxCents?: number | null;
+    /**
+     * Centro de costo con que el ledger imputa el bono PCF de la promoción. Ausente o `null` = sin
+     * centro: el bono se asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string | null;
 }

package/bin/loanOfferings/dtos/requests/CreatePromotionRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const offeringsInputLimits_1 = require("../../constants/offeringsInputLimits");
 const promotionRetailerScope_1 = require("../../constants/promotionRetailerScope");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
 const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
@@ -117,3 +118,11 @@ __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)
 ], CreatePromotionRequest.prototype, "budgetMaxCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "costCenterId", void 0);

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.d.ts

@@ -29,6 +29,8 @@ export declare class UpdatePromotionRequest {
     validFrom?: string | null;
     validUntil?: string | null;
     budgetMaxCents?: number | null;
+    /** Centro de costo del bono PCF. Ausente = conserva el actual; `null` = lo quita. */
+    costCenterId?: string | null;
     /** Motivo del cambio; queda en la bitácora de la promoción. */
     reason?: string;
 }

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const offeringsInputLimits_1 = require("../../constants/offeringsInputLimits");
 const promotionRetailerScope_1 = require("../../constants/promotionRetailerScope");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
 const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
@@ -126,6 +127,14 @@ __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)
 ], UpdatePromotionRequest.prototype, "budgetMaxCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], UpdatePromotionRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanOfferings/dtos/responses/PromotionBonusResponse.d.ts

@@ -11,6 +11,11 @@ export interface PromotionBonusResponse {
     /** Versión de la promoción al reservar: el monto queda congelado aunque la promo se edite. */
     promotionVersion: number;
     amountCents: number;
+    /**
+     * Centro de costo de la promoción al reservar, congelado como el monto. Quien paga lo manda al motor
+     * de cobro; ausente = el ledger asienta el bono como `UNASSIGNED`.
+     */
+    costCenterId?: string;
     status: PromotionBonusStatusEnum;
     /** Folio del processor. `null` mientras no haya cerrado, o si cerró sin darlo. */
     transactionId: string | null;

package/bin/loanOfferings/dtos/responses/PromotionResponse.d.ts

@@ -38,6 +38,8 @@ export interface PromotionResponse {
     phase: PromotionPhaseEnum | null;
     /** Tope de presupuesto; `null` = sin tope. */
     budgetMaxCents: number | null;
+    /** Centro de costo con que el ledger imputa el bono PCF; ausente = sin configurar. */
+    costCenterId?: string;
     budgetConsumedCents: number;
     creditsGenerated: number;
     version: number;

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

@@ -320,6 +320,8 @@ export interface UpdatePoliciesRequest {
     payouts?: {
         walletDeposits: boolean;
         chainBillingPeriod: CommissionBillingPeriodEnum;
+        /** Centro de costo de los depósitos de comisiones. Ausente = conserva el guardado; `null` = lo quita. */
+        costCenterId?: string | null;
     };
 }
 export interface UpdatePoliciesResponse {

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

@@ -118,6 +118,11 @@ export interface CommissionPayoutPolicy {
     walletDeposits: boolean;
     /** Cada cuánto se le cobra a la cadena. */
     chainBillingPeriod: CommissionBillingPeriodEnum;
+    /**
+     * Centro de costo con que el ledger imputa los depósitos de comisiones a la wallet. Ausente = sin
+     * configurar: el depósito se asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string;
 }
 /** Políticas de la cadena. `clawback` y `commissions` son `null` mientras la cadena no las guarda. */
 export interface CommissionPolicies {

package/bin/retailPromotions/dtos/SalePromotion.d.ts

@@ -33,6 +33,8 @@ export interface SalePromotion {
     stackable: boolean;
     /** Solo en promos `REFERRAL`. */
     referral?: ReferralPromotionConfig | null;
+    /** Centro de costo con que el ledger imputa lo que la promo paga a la wallet; ausente = sin configurar. */
+    costCenterId?: string;
     status: SalePromotionStatusEnum;
     /** Derivada; `null` cuando el estado no es `ACTIVE`. */
     phase: SalePromotionPhaseEnum | null;

package/bin/retailPromotions/dtos/requests/CreateSalePromotionRequest.d.ts

@@ -24,4 +24,10 @@ export declare class CreateSalePromotionRequest {
     stackable?: boolean;
     /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
     referral?: ReferralPromotionInput | null;
+    /**
+     * Centro de costo con que el ledger imputa lo que esta promo paga a la wallet (bono de venta,
+     * premio de referido, bono de bienvenida). Ausente o `null` = sin centro: el pago se asienta como
+     * `UNASSIGNED`.
+     */
+    costCenterId?: string | null;
 }

package/bin/retailPromotions/dtos/requests/CreateSalePromotionRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateSalePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
 const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
 const ReferralPromotionInput_1 = require("./ReferralPromotionInput");
@@ -103,3 +104,11 @@ __decorate([
     (0, class_transformer_1.Type)(() => ReferralPromotionInput_1.ReferralPromotionInput),
     __metadata("design:type", ReferralPromotionInput_1.ReferralPromotionInput)
 ], CreateSalePromotionRequest.prototype, "referral", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreateSalePromotionRequest.prototype, "costCenterId", void 0);

package/bin/retailPromotions/dtos/requests/UpdateSalePromotionRequest.d.ts

@@ -24,4 +24,6 @@ export declare class UpdateSalePromotionRequest {
     stackable?: boolean;
     /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
     referral?: ReferralPromotionInput | null;
+    /** Centro de costo de lo que la promo paga a la wallet. Ausente = conserva el actual; `null` = lo quita. */
+    costCenterId?: string | null;
 }

package/bin/retailPromotions/dtos/requests/UpdateSalePromotionRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateSalePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
 const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
 const ReferralPromotionInput_1 = require("./ReferralPromotionInput");
@@ -105,3 +106,11 @@ __decorate([
     (0, class_transformer_1.Type)(() => ReferralPromotionInput_1.ReferralPromotionInput),
     __metadata("design:type", ReferralPromotionInput_1.ReferralPromotionInput)
 ], UpdateSalePromotionRequest.prototype, "referral", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], UpdateSalePromotionRequest.prototype, "costCenterId", void 0);

package/bin/retailPromotions/dtos/responses/WelcomeBonusPromotionResponse.d.ts

@@ -3,4 +3,6 @@ export interface WelcomeBonusPromotionResponse {
     promotionId: string;
     active: boolean;
     amountCents: number;
+    /** Centro de costo del bono, configurado en la promo; ausente = el ledger lo asienta como `UNASSIGNED`. */
+    costCenterId?: string;
 }

package/bin/retailPromotions/dtos/responses/WizardSalePromotionResponses.d.ts

@@ -91,6 +91,8 @@ export interface EvaluatedDiscountCode {
     rejectionCode: RetailPromotionsErrorCodeEnum | null;
     lines: LinePromotionDiscount[];
     totalDiscountCents: number;
+    /** Formas de pago con las que vale el código; null = cualquiera (o código inexistente). */
+    paymentOptions: PromotionPaymentOptionEnum[] | null;
 }
 /** Lo que gana el recomendado en una promo de referido vigente. */
 export interface EvaluatedReferredReward {

package/bin/transaction/constants/costCenter.d.ts

@@ -3,3 +3,5 @@
  * transacciones sin dueño contable quedan agrupadas aquí en lugar de perderse del índice.
  */
 export declare const UNASSIGNED_COST_CENTER_ID = "UNASSIGNED";
+/** Largo máximo de un centro de costo capturado en la configuración de un módulo que paga. */
+export declare const COST_CENTER_ID_MAX_LENGTH = 64;

package/bin/transaction/constants/costCenter.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNASSIGNED_COST_CENTER_ID = void 0;
+exports.COST_CENTER_ID_MAX_LENGTH = exports.UNASSIGNED_COST_CENTER_ID = void 0;
 /**
  * Centro de costo de una transacción que llegó sin uno. El ledger lo escribe siempre, así que las
  * transacciones sin dueño contable quedan agrupadas aquí en lugar de perderse del índice.
  */
 exports.UNASSIGNED_COST_CENTER_ID = 'UNASSIGNED';
+/** Largo máximo de un centro de costo capturado en la configuración de un módulo que paga. */
+exports.COST_CENTER_ID_MAX_LENGTH = 64;

package/package.json

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

package/src/collection/index.ts

@@ -17,9 +17,6 @@ export * from './enums/DisbursementType';
 export * from './constants/CollectionResultLimits';
 export * from './validators/IsCentPrecision';
 
-// Interfaces
-export * from './interfaces/TenantCostCenters';
-
 // DTOs
 export * from './dtos/PendingChargeDto';
 export * from './dtos/CollectRequest';

package/src/loanOfferings/dtos/requests/CreatePromotionRequest.ts

@@ -19,6 +19,7 @@ import {
     SCOPE_STORE_IDS_MAX_ITEMS,
 } from '../../constants/offeringsInputLimits';
 import { PROMOTION_RETAILER_IDS_MAX_ITEMS } from '../../constants/promotionRetailerScope';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
@@ -117,4 +118,15 @@ export class CreatePromotionRequest {
     @IsOptional()
     @IsInt()
     budgetMaxCents?: number | null;
+
+    /**
+     * Centro de costo con que el ledger imputa el bono PCF de la promoción. Ausente o `null` = sin
+     * centro: el bono se asienta como `UNASSIGNED`.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
 }

package/src/loanOfferings/dtos/requests/UpdatePromotionRequest.ts

@@ -20,6 +20,7 @@ import {
     SCOPE_STORE_IDS_MAX_ITEMS,
 } from '../../constants/offeringsInputLimits';
 import { PROMOTION_RETAILER_IDS_MAX_ITEMS } from '../../constants/promotionRetailerScope';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
@@ -123,6 +124,14 @@ export class UpdatePromotionRequest {
     @IsInt()
     budgetMaxCents?: number | null;
 
+    /** Centro de costo del bono PCF. Ausente = conserva el actual; `null` = lo quita. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
+
     /** Motivo del cambio; queda en la bitácora de la promoción. */
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/responses/PromotionBonusResponse.ts

@@ -12,6 +12,11 @@ export interface PromotionBonusResponse {
     /** Versión de la promoción al reservar: el monto queda congelado aunque la promo se edite. */
     promotionVersion: number;
     amountCents: number;
+    /**
+     * Centro de costo de la promoción al reservar, congelado como el monto. Quien paga lo manda al motor
+     * de cobro; ausente = el ledger asienta el bono como `UNASSIGNED`.
+     */
+    costCenterId?: string;
     status: PromotionBonusStatusEnum;
     /** Folio del processor. `null` mientras no haya cerrado, o si cerró sin darlo. */
     transactionId: string | null;

package/src/loanOfferings/dtos/responses/PromotionResponse.ts

@@ -39,6 +39,8 @@ export interface PromotionResponse {
     phase: PromotionPhaseEnum | null;
     /** Tope de presupuesto; `null` = sin tope. */
     budgetMaxCents: number | null;
+    /** Centro de costo con que el ledger imputa el bono PCF; ausente = sin configurar. */
+    costCenterId?: string;
     budgetConsumedCents: number;
     creditsGenerated: number;
     version: number;

package/src/retailCommission/dtos/CommissionApi.ts

@@ -343,7 +343,12 @@ export interface UpdatePoliciesRequest {
     clawback: { cancelacionDias: number; devolucionDias: number; npiM30Dias: number };
     commissions: { multiplicadorMaxBps: number; ventanaDefault: CommissionWindowEnum };
     /** Opcional para que un editor que todavía no la manda siga funcionando. */
-    payouts?: { walletDeposits: boolean; chainBillingPeriod: CommissionBillingPeriodEnum };
+    payouts?: {
+        walletDeposits: boolean;
+        chainBillingPeriod: CommissionBillingPeriodEnum;
+        /** Centro de costo de los depósitos de comisiones. Ausente = conserva el guardado; `null` = lo quita. */
+        costCenterId?: string | null;
+    };
 }
 
 export interface UpdatePoliciesResponse {

package/src/retailCommission/dtos/CommissionRule.ts

@@ -130,6 +130,11 @@ export interface CommissionPayoutPolicy {
     walletDeposits: boolean;
     /** Cada cuánto se le cobra a la cadena. */
     chainBillingPeriod: CommissionBillingPeriodEnum;
+    /**
+     * Centro de costo con que el ledger imputa los depósitos de comisiones a la wallet. Ausente = sin
+     * configurar: el depósito se asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string;
 }
 
 /** Políticas de la cadena. `clawback` y `commissions` son `null` mientras la cadena no las guarda. */

package/src/retailPromotions/dtos/SalePromotion.ts

@@ -34,6 +34,8 @@ export interface SalePromotion {
     stackable: boolean;
     /** Solo en promos `REFERRAL`. */
     referral?: ReferralPromotionConfig | null;
+    /** Centro de costo con que el ledger imputa lo que la promo paga a la wallet; ausente = sin configurar. */
+    costCenterId?: string;
     status: SalePromotionStatusEnum;
     /** Derivada; `null` cuando el estado no es `ACTIVE`. */
     phase: SalePromotionPhaseEnum | null;

package/src/retailPromotions/dtos/requests/CreateSalePromotionRequest.ts

@@ -9,8 +9,10 @@ import {
     IsNotEmpty,
     IsOptional,
     IsString,
+    MaxLength,
     ValidateNested,
 } from 'class-validator';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { ReferralPromotionInput } from './ReferralPromotionInput';
@@ -93,4 +95,16 @@ export class CreateSalePromotionRequest {
     @ValidateNested()
     @Type(() => ReferralPromotionInput)
     referral?: ReferralPromotionInput | null;
+
+    /**
+     * Centro de costo con que el ledger imputa lo que esta promo paga a la wallet (bono de venta,
+     * premio de referido, bono de bienvenida). Ausente o `null` = sin centro: el pago se asienta como
+     * `UNASSIGNED`.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
 }

package/src/retailPromotions/dtos/requests/UpdateSalePromotionRequest.ts

@@ -8,8 +8,10 @@ import {
     IsNotEmpty,
     IsOptional,
     IsString,
+    MaxLength,
     ValidateNested,
 } from 'class-validator';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { ReferralPromotionInput } from './ReferralPromotionInput';
@@ -94,4 +96,12 @@ export class UpdateSalePromotionRequest {
     @ValidateNested()
     @Type(() => ReferralPromotionInput)
     referral?: ReferralPromotionInput | null;
+
+    /** Centro de costo de lo que la promo paga a la wallet. Ausente = conserva el actual; `null` = lo quita. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
 }

package/src/retailPromotions/dtos/responses/WelcomeBonusPromotionResponse.ts

@@ -3,4 +3,6 @@ export interface WelcomeBonusPromotionResponse {
     promotionId: string;
     active: boolean;
     amountCents: number;
+    /** Centro de costo del bono, configurado en la promo; ausente = el ledger lo asienta como `UNASSIGNED`. */
+    costCenterId?: string;
 }

package/src/retailPromotions/dtos/responses/WizardSalePromotionResponses.ts

@@ -98,6 +98,8 @@ export interface EvaluatedDiscountCode {
     rejectionCode: RetailPromotionsErrorCodeEnum | null;
     lines: LinePromotionDiscount[];
     totalDiscountCents: number;
+    /** Formas de pago con las que vale el código; null = cualquiera (o código inexistente). */
+    paymentOptions: PromotionPaymentOptionEnum[] | null;
 }
 
 /** Lo que gana el recomendado en una promo de referido vigente. */

package/src/transaction/constants/costCenter.ts

@@ -3,3 +3,6 @@
  * transacciones sin dueño contable quedan agrupadas aquí en lugar de perderse del índice.
  */
 export const UNASSIGNED_COST_CENTER_ID = 'UNASSIGNED';
+
+/** Largo máximo de un centro de costo capturado en la configuración de un módulo que paga. */
+export const COST_CENTER_ID_MAX_LENGTH = 64;

package/_test_/unit/collection/tenantCostCenters.test.ts

@@ -1,15 +0,0 @@
-import type { TenantCostCenters } from '../../../src/collection/index';
-
-describe('TenantCostCenters', () => {
-    it('cada movimiento del tenant tiene su centro de costo opcional', () => {
-        const all: TenantCostCenters = {
-            welcomeBonus: 'SK-BONO-BIENVENIDA',
-            creditPromotion: 'SK-PROMO-CREDITO',
-            salePromotion: 'SK-PROMO-VENTA',
-            commission: 'SK-COMISIONES',
-        };
-        const none: TenantCostCenters = {};
-        expect(Object.keys(all)).toEqual(['welcomeBonus', 'creditPromotion', 'salePromotion', 'commission']);
-        expect(none).toEqual({});
-    });
-});

package/bin/collection/interfaces/TenantCostCenters.d.ts

@@ -1,14 +0,0 @@
-/**
- * Centros de costo de un tenant para los movimientos que paga desde su bolsa. Cada servicio que
- * dispersa lee el suyo de la configuración del tenant; si falta, el ledger lo asienta como no asignado.
- */
-export interface TenantCostCenters {
-    /** Bono de bienvenida al alta del cliente. */
-    welcomeBonus?: string;
-    /** Promociones ligadas al crédito. */
-    creditPromotion?: string;
-    /** Promociones ligadas a la venta. */
-    salePromotion?: string;
-    /** Comisiones a vendedores. */
-    commission?: string;
-}

package/bin/collection/interfaces/TenantCostCenters.js

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

package/src/collection/interfaces/TenantCostCenters.ts

@@ -1,14 +0,0 @@
-/**
- * Centros de costo de un tenant para los movimientos que paga desde su bolsa. Cada servicio que
- * dispersa lee el suyo de la configuración del tenant; si falta, el ledger lo asienta como no asignado.
- */
-export interface TenantCostCenters {
-    /** Bono de bienvenida al alta del cliente. */
-    welcomeBonus?: string;
-    /** Promociones ligadas al crédito. */
-    creditPromotion?: string;
-    /** Promociones ligadas a la venta. */
-    salePromotion?: string;
-    /** Comisiones a vendedores. */
-    commission?: string;
-}