@fiado/type-kit 3.645.0 → 3.646.0

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

@@ -31,3 +31,18 @@ describe('AuthorizeCollectionMovementRequest.tenantId', () => {
         expect(await invalidProperties({ ...VALID, tenantId: 42 })).toEqual(['tenantId']);
     });
 });
+
+describe('AuthorizeCollectionMovementRequest.costCenterId', () => {
+    it('es opcional', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+    });
+
+    it('acepta el centro de costo del producto', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: 'SK-COBRANZA' })).toEqual([]);
+    });
+
+    it('rechaza costCenterId vacío o no string', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties({ ...VALID, costCenterId: 42 })).toEqual(['costCenterId']);
+    });
+});

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

@@ -0,0 +1,54 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { CollectionProductConfigDto, UpsertProductConfigRequest } from '../../../src/collection/index';
+import { AuthorizeBonusRequest } from '../../../src/transactionProcessor/index';
+
+async function invalidProperties<T extends object>(cls: new () => T, body: Record<string, unknown>): Promise<string[]> {
+    return (await validate(plainToInstance(cls, body) as object)).map((e) => e.property);
+}
+
+const UPSERT = {
+    sources: [{ order: 1, wallet: 'MXN', currency: 'MXN', mechanism: 'MXN_DIRECT', provider: 'wallet' }],
+    allowPartial: false,
+    retryPolicy: { maxAttempts: 3, backoffSeconds: 60 },
+    reportTargets: [],
+};
+
+const CONFIG = {
+    ...UPSERT,
+    tenantId: 'surekeep',
+    productId: 'loan',
+    version: 1,
+    createdBy: 'system',
+    updatedBy: 'system',
+};
+
+const BONUS = {
+    idempotencyKey: 'bonus-1',
+    productCatalogId: 'cat-1',
+    amount: 50,
+    directoryId: 'dir-1',
+    concept: 'Bono SureKeep',
+};
+
+describe.each([
+    ['CollectionProductConfigDto', CollectionProductConfigDto, CONFIG],
+    ['UpsertProductConfigRequest', UpsertProductConfigRequest, UPSERT],
+    ['AuthorizeBonusRequest', AuthorizeBonusRequest, BONUS],
+] as const)('%s.costCenterId', (_name, cls, valid) => {
+    const klass = cls as unknown as new () => object;
+
+    it('es opcional', async () => {
+        expect(await invalidProperties(klass, valid)).toEqual([]);
+    });
+
+    it('acepta un centro de costo', async () => {
+        expect(await invalidProperties(klass, { ...valid, costCenterId: 'SK-COBRANZA' })).toEqual([]);
+    });
+
+    it('rechaza vacío o no string', async () => {
+        expect(await invalidProperties(klass, { ...valid, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties(klass, { ...valid, costCenterId: 3 })).toEqual(['costCenterId']);
+    });
+});

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

@@ -130,3 +130,18 @@ describe('DisburseResponse', () => {
         expect(await validate(plainToInstance(DisburseResponse, { transactionId: null }) as object)).toHaveLength(0);
     });
 });
+
+describe('DisburseRequest.costCenterId', () => {
+    it('es opcional', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+    });
+
+    it('acepta el centro de costo de quien dispersa', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: 'SK-BONOS' })).toEqual([]);
+    });
+
+    it('rechaza vacío o no string', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties({ ...VALID, costCenterId: 9 })).toEqual(['costCenterId']);
+    });
+});

package/_test_/unit/reconciliation/reconciliationRequests.test.ts

@@ -206,6 +206,21 @@ describe('feed genérico de los dueños', () => {
         );
     });
 
+    it('costCenterIds es opcional y llega como csv del query', () => {
+        const base = { tenantId: 'surekeep', from: '2026-10-19T06:00:00.000Z', to: '2026-10-26T05:59:59.999Z' };
+        expect(errorsOf(PrivateListReconciliationFeedQuery, base)).toEqual([]);
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA, SK-BONOS' })).toEqual([]);
+        const dto = plainToInstance(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA, SK-BONOS' }, { excludeExtraneousValues: true });
+        expect(dto.costCenterIds).toEqual(['SK-COBRANZA', 'SK-BONOS']);
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: ['SK-COBRANZA'] })).toEqual([]);
+    });
+
+    it('costCenterIds rechaza elementos vacíos', () => {
+        const base = { tenantId: 'surekeep', from: '2026-10-19T06:00:00.000Z', to: '2026-10-26T05:59:59.999Z' };
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA,' })).toContain('costCenterIds');
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: '' })).toContain('costCenterIds');
+    });
+
     it('el registro por recordId pide tenant y el servicio que llama; el actor es opcional', () => {
         expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { tenantId: 'surekeep', author: 'reconciliation-engine-business' })).toEqual(
             [],

package/_test_/unit/transaction/transactionCreateRequestM8.test.ts

@@ -1,27 +1,42 @@
 import 'reflect-metadata';
 import { plainToInstance } from 'class-transformer';
 import { validateSync } from 'class-validator';
-import { TransactionCreateRequest } from '../../../src/transaction';
+import { TransactionCreateRequest, UNASSIGNED_COST_CENTER_ID } from '../../../src/transaction';
 
 function errorPropsOf(payload: Record<string, unknown>): string[] {
     return validateSync(plainToInstance(TransactionCreateRequest, payload)).map((e) => e.property);
 }
 
-describe('TransactionCreateRequest · executionId y tenant SOFOM', () => {
+describe('TransactionCreateRequest · executionId y centro de costo', () => {
     it('ambos son opcionales', () => {
         const props = errorPropsOf({});
         expect(props).not.toContain('executionId');
-        expect(props).not.toContain('sofomTenantId');
+        expect(props).not.toContain('costCenterId');
     });
 
     it('acepta strings no vacíos', () => {
-        const props = errorPropsOf({ executionId: 'exec-1', sofomTenantId: 'surekeep' });
+        const props = errorPropsOf({ executionId: 'exec-1', costCenterId: 'SK-COBRANZA' });
         expect(props).not.toContain('executionId');
-        expect(props).not.toContain('sofomTenantId');
+        expect(props).not.toContain('costCenterId');
+    });
+
+    it('acepta el centro de costo sin asignar', () => {
+        expect(errorPropsOf({ costCenterId: UNASSIGNED_COST_CENTER_ID })).not.toContain('costCenterId');
     });
 
     it('rechaza tipos que no son string o vacíos', () => {
         expect(errorPropsOf({ executionId: 12 })).toContain('executionId');
-        expect(errorPropsOf({ sofomTenantId: '' })).toContain('sofomTenantId');
+        expect(errorPropsOf({ costCenterId: '' })).toContain('costCenterId');
+        expect(errorPropsOf({ costCenterId: 7 })).toContain('costCenterId');
+    });
+
+    it('ya no declara el tenant SOFOM', () => {
+        expect(errorPropsOf({ sofomTenantId: '' })).not.toContain('sofomTenantId');
+    });
+});
+
+describe('UNASSIGNED_COST_CENTER_ID', () => {
+    it('es UNASSIGNED', () => {
+        expect(UNASSIGNED_COST_CENTER_ID).toBe('UNASSIGNED');
     });
 });

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.d.ts

@@ -11,7 +11,16 @@ export declare class AuthorizeCollectionMovementRequest {
     intentId?: string;
     chargeId?: string;
     holdTxId?: string;
+    /**
+     * Tenant SOFOM del intento de cobro. Se conserva por compatibilidad con transaction-processor; el
+     * ledger ya no lo usa: la pertenencia contable del movimiento viaja en `costCenterId`.
+     */
     tenantId?: string;
+    /**
+     * Centro de costo del producto cobrado, tomado de su configuración en el motor. El processor lo
+     * escribe en la transacción del ledger; ausente, queda como `UNASSIGNED`.
+     */
+    costCenterId?: string;
     /**
      * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
      * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.js

@@ -63,6 +63,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], AuthorizeCollectionMovementRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),

package/bin/collection/dtos/CollectionProductConfigDto.d.ts

@@ -17,6 +17,8 @@ export declare class CollectionProductConfigDto {
     allowPartial: boolean;
     retryPolicy: RetryPolicyDto;
     reportTargets: string[];
+    /** Centro de costo con el que el ledger registra los cobros de este producto. */
+    costCenterId?: string;
     createdBy: string;
     updatedBy: string;
 }

package/bin/collection/dtos/CollectionProductConfigDto.js

@@ -58,6 +58,12 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], CollectionProductConfigDto.prototype, "reportTargets", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CollectionProductConfigDto.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/collection/dtos/DisburseRequest.d.ts

@@ -18,6 +18,11 @@ export declare class DisburseRequest {
     concept: string;
     /** Id del llamador para rastreo: asiento, crédito. */
     reference?: string;
+    /**
+     * Centro de costo de la dispersión, tomado de la configuración de quien dispersa. El motor lo
+     * reenvía al processor en `AuthorizeBonusRequest.costCenterId`; ausente, el ledger escribe `UNASSIGNED`.
+     */
+    costCenterId?: string;
     /** Datos de la recarga. Obligatorio si `disbursementType` es `MEX_REWARD_TOPUP`; en otros tipos se ignora. */
     topup?: DisburseTopupDetail;
 }

package/bin/collection/dtos/DisburseRequest.js

@@ -64,6 +64,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], DisburseRequest.prototype, "reference", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], DisburseRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)((o) => o.disbursementType === DisbursementType_1.DisbursementType.MEX_REWARD_TOPUP),
     (0, class_validator_1.IsDefined)(),

package/bin/collection/dtos/UpsertProductConfigRequest.d.ts

@@ -9,4 +9,6 @@ export declare class UpsertProductConfigRequest {
     allowPartial: boolean;
     retryPolicy: RetryPolicyDto;
     reportTargets: string[];
+    /** Centro de costo con el que el ledger registra los cobros de este producto. */
+    costCenterId?: string;
 }

package/bin/collection/dtos/UpsertProductConfigRequest.js

@@ -41,3 +41,9 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], UpsertProductConfigRequest.prototype, "reportTargets", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UpsertProductConfigRequest.prototype, "costCenterId", void 0);

package/bin/reconciliation/dtos/ReconciliationDefinition.d.ts

@@ -11,6 +11,8 @@ export interface ReconciliationDefinitionSource {
     domain: ReconciliationFeedOwnerEnum;
     concept: ReconciliationFeedConceptEnum;
     partName?: string;
+    /** Centros de costo del ledger que pertenecen al tenant; el feed solo devuelve esos. */
+    costCenterIds?: string[];
 }
 /** Cuenta de FSA cuyo EdC lee una definición BANK_STATEMENT. */
 export interface ReconciliationDefinitionBankAccountView {

package/bin/reconciliation/dtos/requests/ReconciliationFeedRequests.d.ts

@@ -13,6 +13,11 @@ export declare class PrivateListReconciliationFeedQuery {
     from: string;
     to: string;
     cursor?: string;
+    /**
+     * Centros de costo del tenant, en csv (`a,b`). El dueño del feed filtra por ellos; sin la
+     * lista responde vacío, nunca el ledger completo.
+     */
+    costCenterIds?: string[];
 }
 /** Query de privateGetReconciliationFeedRecord; `author` y `actor` van al registro de acceso del dueño. */
 export declare class PrivateGetReconciliationFeedRecordQuery {

package/bin/reconciliation/dtos/requests/ReconciliationFeedRequests.js

@@ -53,6 +53,15 @@ __decorate([
     (0, reconciliationRequestDecorators_1.PageToken)(),
     __metadata("design:type", String)
 ], PrivateListReconciliationFeedQuery.prototype, "cursor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.split(',').map((id) => id.trim()) : value)),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], PrivateListReconciliationFeedQuery.prototype, "costCenterIds", void 0);
 /** Query de privateGetReconciliationFeedRecord; `author` y `actor` van al registro de acceso del dueño. */
 class PrivateGetReconciliationFeedRecordQuery {
 }

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

@@ -0,0 +1,5 @@
+/**
+ * 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.
+ */
+export declare const UNASSIGNED_COST_CENTER_ID = "UNASSIGNED";

package/bin/transaction/constants/costCenter.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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';

package/bin/transaction/dtos/TransactionCreateRequest.d.ts

@@ -56,6 +56,9 @@ export declare class TransactionCreateRequest {
     domFolio?: string;
     /** Intento del motor de cobro que originó el cargo; en cobranza es igual al `attemptId`. */
     executionId?: string;
-    /** Tenant SOFOM dueño del cobro; `tenantId` del ledger sigue siendo `FIADO`. */
-    sofomTenantId?: string;
+    /**
+     * Centro de costo contable de la transacción; con él se reparte el ledger entre dueños y
+     * conciliaciones. Si no llega, el ledger escribe `UNASSIGNED_COST_CENTER_ID`.
+     */
+    costCenterId?: string;
 }

package/bin/transaction/dtos/TransactionCreateRequest.js

@@ -211,4 +211,4 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
-], TransactionCreateRequest.prototype, "sofomTenantId", void 0);
+], TransactionCreateRequest.prototype, "costCenterId", void 0);

package/bin/transaction/index.d.ts

@@ -36,6 +36,7 @@ export * from './dtos/internal/ProviderTransactionReversalRequest';
 export * from './dtos/internal/ProviderTransactionReversalResponse';
 export * from './dtos/internal/ProviderTransactionCompletionRequest';
 export * from './dtos/internal/ProviderTransactionCompletionResponse';
+export * from './constants/costCenter';
 export * from './enums/OperationEnum';
 export * from './enums/TransactionSourceEnum';
 export * from './enums/TransactionStatusEnum';

package/bin/transaction/index.js

@@ -53,6 +53,8 @@ __exportStar(require("./dtos/internal/ProviderTransactionReversalRequest"), expo
 __exportStar(require("./dtos/internal/ProviderTransactionReversalResponse"), exports);
 __exportStar(require("./dtos/internal/ProviderTransactionCompletionRequest"), exports);
 __exportStar(require("./dtos/internal/ProviderTransactionCompletionResponse"), exports);
+//constants
+__exportStar(require("./constants/costCenter"), exports);
 //enums
 __exportStar(require("./enums/OperationEnum"), exports);
 __exportStar(require("./enums/TransactionSourceEnum"), exports);

package/bin/transactionProcessor/dtos/AuthorizeBonusRequest.d.ts

@@ -15,5 +15,7 @@ export declare class AuthorizeBonusRequest {
     directoryId: string;
     /** Lo que el cliente ve como descripción de su movimiento. */
     concept: string;
+    /** Centro de costo del bono en el ledger; ausente, el processor escribe `UNASSIGNED`. */
+    costCenterId?: string;
 }
 export default AuthorizeBonusRequest;

package/bin/transactionProcessor/dtos/AuthorizeBonusRequest.js

@@ -47,4 +47,10 @@ __decorate([
     (0, class_validator_1.MaxLength)(120),
     __metadata("design:type", String)
 ], AuthorizeBonusRequest.prototype, "concept", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeBonusRequest.prototype, "costCenterId", void 0);
 exports.default = AuthorizeBonusRequest;

package/package.json

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

package/src/collection/dtos/AuthorizeCollectionMovementRequest.ts

@@ -14,9 +14,18 @@ export class AuthorizeCollectionMovementRequest {
   @IsOptional() @IsString() intentId?: string;
   @IsOptional() @IsString() chargeId?: string;
   @IsOptional() @IsString() holdTxId?: string;
-  // Tenant SOFOM del intento de cobro; transaction-processor lo asienta como `sofomTenantId`.
+  /**
+   * Tenant SOFOM del intento de cobro. Se conserva por compatibilidad con transaction-processor; el
+   * ledger ya no lo usa: la pertenencia contable del movimiento viaja en `costCenterId`.
+   */
   @IsOptional() @IsString() @IsNotEmpty() tenantId?: string;
 
+  /**
+   * Centro de costo del producto cobrado, tomado de su configuración en el motor. El processor lo
+   * escribe en la transacción del ledger; ausente, queda como `UNASSIGNED`.
+   */
+  @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
+
   /**
    * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
    * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el

package/src/collection/dtos/CollectionProductConfigDto.ts

@@ -1,4 +1,4 @@
-import { IsString, IsInt, IsArray, IsBoolean, ValidateNested } from 'class-validator';
+import { IsString, IsInt, IsArray, IsBoolean, IsNotEmpty, IsOptional, ValidateNested } from 'class-validator';
 import { Type } from 'class-transformer';
 import { CollectionSourceDto } from './CollectionSourceDto';
 import { RetryPolicyDto } from './RetryPolicyDto';
@@ -20,6 +20,8 @@ export class CollectionProductConfigDto {
   @IsBoolean() allowPartial!: boolean;
   @ValidateNested() @Type(() => RetryPolicyDto) retryPolicy!: RetryPolicyDto;
   @IsArray() @IsString({ each: true }) reportTargets!: string[];
+  /** Centro de costo con el que el ledger registra los cobros de este producto. */
+  @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
   @IsString() createdBy!: string;
   @IsString() updatedBy!: string;
 }

package/src/collection/dtos/DisburseRequest.ts

@@ -30,6 +30,12 @@ export class DisburseRequest {
     /** Id del llamador para rastreo: asiento, crédito. */
     @IsOptional() @IsString() reference?: string;
 
+    /**
+     * Centro de costo de la dispersión, tomado de la configuración de quien dispersa. El motor lo
+     * reenvía al processor en `AuthorizeBonusRequest.costCenterId`; ausente, el ledger escribe `UNASSIGNED`.
+     */
+    @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
+
     /** Datos de la recarga. Obligatorio si `disbursementType` es `MEX_REWARD_TOPUP`; en otros tipos se ignora. */
     @ValidateIf((o: DisburseRequest) => o.disbursementType === DisbursementType.MEX_REWARD_TOPUP)
     @IsDefined()

package/src/collection/dtos/UpsertProductConfigRequest.ts

@@ -1,4 +1,4 @@
-import { IsString, IsArray, IsBoolean, ValidateNested } from 'class-validator';
+import { IsString, IsArray, IsBoolean, IsNotEmpty, IsOptional, ValidateNested } from 'class-validator';
 import { Type } from 'class-transformer';
 import { CollectionSourceDto } from './CollectionSourceDto';
 import { RetryPolicyDto } from './RetryPolicyDto';
@@ -12,4 +12,6 @@ export class UpsertProductConfigRequest {
   @IsBoolean() allowPartial!: boolean;
   @ValidateNested() @Type(() => RetryPolicyDto) retryPolicy!: RetryPolicyDto;
   @IsArray() @IsString({ each: true }) reportTargets!: string[];
+  /** Centro de costo con el que el ledger registra los cobros de este producto. */
+  @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
 }

package/src/reconciliation/dtos/ReconciliationDefinition.ts

@@ -12,6 +12,8 @@ export interface ReconciliationDefinitionSource {
     domain: ReconciliationFeedOwnerEnum;
     concept: ReconciliationFeedConceptEnum;
     partName?: string;
+    /** Centros de costo del ledger que pertenecen al tenant; el feed solo devuelve esos. */
+    costCenterIds?: string[];
 }
 
 /** Cuenta de FSA cuyo EdC lee una definición BANK_STATEMENT. */

package/src/reconciliation/dtos/requests/ReconciliationFeedRequests.ts

@@ -1,5 +1,5 @@
-import { Expose } from 'class-transformer';
-import { IsEnum, IsISO8601 } from 'class-validator';
+import { Expose, Transform } from 'class-transformer';
+import { IsArray, IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString } from 'class-validator';
 import { ReconciliationFeedConceptEnum } from '../../enums/ReconciliationFeedConceptEnum';
 import { OptionalEmail, PageToken, RequiredId } from './reconciliationRequestDecorators';
 
@@ -31,6 +31,18 @@ export class PrivateListReconciliationFeedQuery {
 
     @PageToken()
     cursor?: string;
+
+    /**
+     * Centros de costo del tenant, en csv (`a,b`). El dueño del feed filtra por ellos; sin la
+     * lista responde vacío, nunca el ledger completo.
+     */
+    @Expose()
+    @IsOptional()
+    @Transform(({ value }) => (typeof value === 'string' ? value.split(',').map((id) => id.trim()) : value))
+    @IsArray()
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    costCenterIds?: string[];
 }
 
 /** Query de privateGetReconciliationFeedRecord; `author` y `actor` van al registro de acceso del dueño. */

package/src/transaction/constants/costCenter.ts

@@ -0,0 +1,5 @@
+/**
+ * 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.
+ */
+export const UNASSIGNED_COST_CENTER_ID = 'UNASSIGNED';

package/src/transaction/dtos/TransactionCreateRequest.ts

@@ -173,9 +173,12 @@ export class TransactionCreateRequest {
     @IsOptional()
     executionId?: string;
 
-    /** Tenant SOFOM dueño del cobro; `tenantId` del ledger sigue siendo `FIADO`. */
+    /**
+     * Centro de costo contable de la transacción; con él se reparte el ledger entre dueños y
+     * conciliaciones. Si no llega, el ledger escribe `UNASSIGNED_COST_CENTER_ID`.
+     */
     @IsString()
     @IsNotEmpty()
     @IsOptional()
-    sofomTenantId?: string;
+    costCenterId?: string;
 }

package/src/transaction/index.ts

@@ -40,6 +40,9 @@ export * from './dtos/internal/ProviderTransactionCompletionRequest';
 export * from './dtos/internal/ProviderTransactionCompletionResponse';
 
 
+//constants
+export * from './constants/costCenter';
+
 //enums
 export * from './enums/OperationEnum';
 export * from './enums/TransactionSourceEnum';

package/src/transactionProcessor/dtos/AuthorizeBonusRequest.ts

@@ -1,4 +1,4 @@
-import { IsNotEmpty, IsNumber, IsPositive, IsString, MaxLength } from "class-validator";
+import { IsNotEmpty, IsNumber, IsOptional, IsPositive, IsString, MaxLength } from "class-validator";
 
 /**
  * Acreditación de un bono a la wallet PagoConfiado de una persona.
@@ -31,6 +31,12 @@ export class AuthorizeBonusRequest {
     @IsString()
     @MaxLength(120)
     concept: string;
+
+    /** Centro de costo del bono en el ledger; ausente, el processor escribe `UNASSIGNED`. */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    costCenterId?: string;
 }
 
 export default AuthorizeBonusRequest;