@fiado/type-kit 3.638.0 → 3.640.0

package/_test_/unit/transferNote/transferNoteConfigAndPrivate.test.ts

@@ -113,8 +113,12 @@ describe('espejo privado', () => {
                 trackingKey: 'K1',
                 paidAt: '2026-10-29T15:00:00.000Z',
                 amountCents: 100,
+                paidToClabe: '002010077777777771',
             }),
         ).toEqual([]);
+        expect(
+            errorsOf(PrivateCaptureTransferNoteSpeiRequest, { ...caller, trackingKey: 'K1', paidAt: '2026-10-29T15:00:00.000Z', amountCents: 100 }),
+        ).toContain('paidToClabe');
     });
 
     it('las lecturas privadas también exigen author y actorId', () => {
@@ -215,3 +219,52 @@ describe('catálogos', () => {
         expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.TRANSFER_NOTE_ITEM_NOT_FOUND]).toBe(404);
     });
 });
+
+describe('cambio de configuración con doble control', () => {
+    it('la decisión acepta APPROVE o REJECT y nada más', () => {
+        const { DecideTransferNoteConfigChangeRequest, TransferNoteConfigChangeDecisionEnum } = TransferNote;
+        const proposedAt = '2026-11-04T18:00:00.000Z';
+        expect(errorsOf(DecideTransferNoteConfigChangeRequest, { decision: TransferNoteConfigChangeDecisionEnum.APPROVE, proposedAt })).toEqual([]);
+        expect(errorsOf(DecideTransferNoteConfigChangeRequest, { decision: 'MAYBE', proposedAt })).toContain('decision');
+        expect(errorsOf(DecideTransferNoteConfigChangeRequest, { decision: TransferNoteConfigChangeDecisionEnum.APPROVE })).toContain('proposedAt');
+        expect(errorsOf(DecideTransferNoteConfigChangeRequest, { decision: TransferNoteConfigChangeDecisionEnum.REJECT, proposedAt: 'ayer' })).toContain('proposedAt');
+    });
+
+    it('los codes nuevos tienen su status', () => {
+        expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.SAME_ACTOR_NOT_ALLOWED]).toBe(422);
+        expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.CONFIG_CHANGE_NOT_PENDING]).toBe(409);
+        expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.NOTE_DOCUMENT_NOT_READY]).toBe(409);
+        expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[TransferNoteErrorCodeEnum.PARTY_ROUTING_CONFLICT]).toBe(409);
+    });
+
+    it('el registro expone el cambio propuesto aparte del vigente', () => {
+        const record: TransferNote.TransferNoteConfigRecord = {
+            recordKey: 'PARTY#luga',
+            recordType: TransferNoteConfigRecordTypeEnum.PARTY,
+            party: { partyId: 'luga', partyType: TransferNotePartyTypeEnum.RETAILER, displayName: 'Luga', retailerId: 'r-1', clabe: '002010077777777771' },
+            pendingChange: {
+                party: { partyId: 'luga', partyType: TransferNotePartyTypeEnum.RETAILER, displayName: 'Luga', retailerId: 'r-1', clabe: '012180001234567897' },
+                proposedBy: 'ana@sk.mx',
+                proposedAt: '2026-11-04T10:00:00.000Z',
+            },
+            updatedAt: '2026-11-04T10:00:00.000Z',
+            updatedBy: 'ana@sk.mx',
+        };
+        expect(record.party?.clabe).toBe('002010077777777771');
+    });
+
+    it('un cambio de pagador, receptor o signo de un concepto también queda propuesto', () => {
+        const pendingChange: TransferNote.TransferNoteConfigPendingChange = {
+            concept: {
+                concept: TransferNoteConceptEnum.DEVICE_PAYMENT,
+                payerPartyType: TransferNotePartyTypeEnum.SOFOM,
+                payeePartyType: TransferNotePartyTypeEnum.RETAILER,
+                sign: TransferNoteConceptSignEnum.NEGATIVE,
+                activeFrom: '2026-11-04T10:00:00.000Z',
+            },
+            proposedBy: 'ana@sk.mx',
+            proposedAt: '2026-11-04T10:00:00.000Z',
+        };
+        expect(pendingChange.concept?.sign).toBe(TransferNoteConceptSignEnum.NEGATIVE);
+    });
+});

package/_test_/unit/transferNote/transferNoteEventsAndFeeds.test.ts

@@ -36,6 +36,38 @@ describe('eventos de transferNote', () => {
     });
 });
 
+describe('los 7 eventos de la nota', () => {
+    it('cada detailType vive bajo transferNote.*', () => {
+        expect(Object.values(TransferNote.TransferNoteEventDetailTypeEnum).sort()).toEqual([
+            'transferNote.TransferNoteCancelled',
+            'transferNote.TransferNoteDisputeResolved',
+            'transferNote.TransferNoteDisputed',
+            'transferNote.TransferNoteIssued',
+            'transferNote.TransferNoteReconciled',
+            'transferNote.TransferNoteSpeiCaptured',
+            'transferNote.TransferNoteSpeiReverted',
+        ]);
+    });
+
+    it('la captura lleva la CLABE pagada y solo ids y montos', () => {
+        const detail: TransferNote.TransferNoteSpeiCapturedEventDetail = {
+            eventId: 'n-1#SPEI_CAPTURED#1762250400000',
+            tenantId: 'surekeep',
+            noteId: 'n-1',
+            pairKey: 'fsa#sk#-',
+            isoWeek: '2026-W44',
+            netAmountCents: 125000,
+            currency: CurrencyId.MXN,
+            trackingKey: 'BNET01002610290000001',
+            paidAt: '2026-11-04T10:00:00.000Z',
+            paidAmountCents: 125000,
+            paidToClabe: '002010077777777771',
+            capturedAt: '2026-11-04T10:00:00.000Z',
+        };
+        expect(detail.paidToClabe).toHaveLength(18);
+    });
+});
+
 describe('registros de feed de notas con la forma base', () => {
     it('un item de nota se lee con el cliente genérico y su reversa va en refs', () => {
         const reversal: TransferNote.TransferNoteItemFeedRecord = {

package/_test_/unit/transferNote/transferNoteRequests.test.ts

@@ -72,7 +72,7 @@ describe('PreviewTransferNoteRequest', () => {
 });
 
 describe('captura y reversa de SPEI', () => {
-    const spei = { trackingKey: 'BNET01002610290000001', paidAt: '2026-10-29T15:00:00.000Z', amountCents: 125000 };
+    const spei = { trackingKey: 'BNET01002610290000001', paidAt: '2026-10-29T15:00:00.000Z', amountCents: 125000, paidToClabe: '002010077777777771' };
 
     it('acepta clave, fecha ISO y monto entero positivo', () => {
         expect(errorsOf(CaptureTransferNoteSpeiRequest, spei)).toEqual([]);
@@ -90,6 +90,25 @@ describe('captura y reversa de SPEI', () => {
         expect(errorsOf(RevertTransferNoteSpeiRequest, { reason: '  ' })).toContain('reason');
         expect(errorsOf(CancelTransferNoteRequest, {})).toContain('reason');
     });
+
+    it('la cancelación pide razón de 20+ como emitir u objetar', () => {
+        expect(errorsOf(CancelTransferNoteRequest, { reason: 'corta' })).toContain('reason');
+        expect(errorsOf(CancelTransferNoteRequest, { reason: longReason })).toEqual([]);
+    });
+
+    it('paidToClabe es obligatoria en toda captura', () => {
+        const { paidToClabe: _omit, ...withoutClabe } = spei;
+        expect(errorsOf(CaptureTransferNoteSpeiRequest, withoutClabe)).toContain('paidToClabe');
+        expect(errorsOf(CaptureTransferNoteSpeiRequest, { ...spei, paidToClabe: null })).toContain('paidToClabe');
+    });
+
+    it('paidToClabe exige dígito verificador válido', () => {
+        expect(errorsOf(CaptureTransferNoteSpeiRequest, { ...spei, paidToClabe: '002010077777777771' })).toEqual([]);
+        expect(errorsOf(CaptureTransferNoteSpeiRequest, { ...spei, paidToClabe: '002010077777777772' })).toContain('paidToClabe');
+        expect(errorsOf(CaptureTransferNoteSpeiRequest, { ...spei, paidToClabe: '12345' })).toContain('paidToClabe');
+        expect(TransferNote.isValidTransferNoteClabe('002010077777777771')).toBe(true);
+        expect(TransferNote.isValidTransferNoteClabe(null)).toBe(false);
+    });
 });
 
 describe('objeción', () => {

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

@@ -85,6 +85,8 @@ export interface CommissionSaleInput {
     /** `CASH` | `CREDIT`, para `PERCENT_BY_PAYMENT`. */
     paymentType: string;
     soldAt: string;
+    /** Cuándo se ganó la comisión: ubica la venta en su corte. Los devengos viejos no lo traen o lo traen en `null` (usar `soldAt`). */
+    earnedAt?: string | null;
     /** Las líneas de la venta. Las ventas que se calculan con reglas siempre las traen. */
     lines?: CommissionSaleLine[];
 }

package/bin/retailWizard/dtos/Sale.d.ts

@@ -97,6 +97,10 @@ export interface Sale {
     cancelledAt: string | null;
     /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
     cancelReason: string | null;
+    /** La comisión espera a que el cliente active su app: contraseña, contrato y número secreto. Ausente si no espera. */
+    commissionAwaitingApp?: boolean;
+    /** ISO; cuándo se ganó la comisión, si el cliente activó su app después de cerrar. Ausente: al cerrar o en espera. */
+    commissionEarnedAt?: string;
     /** Si la venta se puede cancelar hoy y, si no, por qué; solo lo trae el detalle del backoffice. */
     cancellation?: SaleCancellation;
     /**

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

@@ -46,6 +46,11 @@ export declare class RetailCommissionInboundMessage {
     soldAt: string;
     /** soldAt en la venta; cancelledAt en la cancelación. */
     occurredAt: string;
+    /**
+     * Cuándo se ganó la comisión, si el cliente activó su app después de cerrar la venta. Ubica la venta en
+     * su corte. Ausente: se ganó al cerrar (`soldAt`).
+     */
+    earnedAt?: string;
     /** Motivo de la cancelación; puede venir vacío. */
     cancelReason?: string;
     lines: RetailCommissionInboundLine[];

package/bin/retailWizard/events/RetailCommissionInboundMessage.js

@@ -153,6 +153,11 @@ __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.IsISO8601)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "earnedAt", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),

package/bin/transferNote/constants/transferNoteErrorHttpStatus.js

@@ -34,4 +34,8 @@ exports.TRANSFER_NOTE_ERROR_HTTP_STATUS = {
     [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.CUTOFF_DISPATCH_FAILED]: 502,
     [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.CONCURRENT_WRITE_CONFLICT]: 409,
     [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.AUDIT_QUEUE_PUBLISH_FAILED]: 502,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.SAME_ACTOR_NOT_ALLOWED]: 422,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.CONFIG_CHANGE_NOT_PENDING]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOTE_DOCUMENT_NOT_READY]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.PARTY_ROUTING_CONFLICT]: 409,
 };

package/bin/transferNote/dtos/TransferNote.d.ts

@@ -25,6 +25,8 @@ export interface TransferNoteSpeiPayment {
     capturedBy: string;
     capturedAt: string;
     receiptUploaded: boolean;
+    /** CLABE a la que se mandó el SPEI, si se capturó. */
+    paidToClabe?: string;
 }
 export interface TransferNoteConfirmation {
     type: TransferNoteConfirmationTypeEnum;
@@ -40,6 +42,12 @@ export interface TransferNoteDispute {
     /** Estado al que vuelve la nota si se rechaza la objeción. */
     previousStatus: TransferNoteStatusEnum;
 }
+/** Cancelación de la nota: quién, cuándo y por qué. */
+export interface TransferNoteCancellation {
+    reason: string;
+    cancelledBy: string;
+    cancelledAt: string;
+}
 /** Fila de los listados de notas. */
 export interface TransferNoteSummary {
     noteId: string;
@@ -67,6 +75,8 @@ export interface TransferNote extends TransferNoteSummary {
     issueReason?: string;
     speiPayment?: TransferNoteSpeiPayment;
     dispute?: TransferNoteDispute;
+    /** Solo en notas canceladas después de emitirse. */
+    cancellation?: TransferNoteCancellation;
     /** Nota cancelada de la que nace esta, o la regenerada que la reemplaza. */
     regeneratedFromNoteId?: string;
     regeneratedNoteId?: string;

package/bin/transferNote/dtos/TransferNoteConfigRecords.d.ts

@@ -37,6 +37,18 @@ export interface TransferNotePairSettings {
     /** Se llena al 4.º corte seguido sin emitir. */
     discrepancyOpenedAt?: string;
 }
+/**
+ * Cambio que altera a quién se le paga y espera la aprobación de otra persona: CLABE, tipo o tienda de una parte,
+ * pagador/receptor de un par, o tipos de pagador/receptor o signo de un concepto.
+ * Mientras no se apruebe rige el valor vigente del registro.
+ */
+export interface TransferNoteConfigPendingChange {
+    party?: TransferNotePartySettings;
+    concept?: TransferNoteConceptSettings;
+    pair?: TransferNotePairSettings;
+    proposedBy: string;
+    proposedAt: string;
+}
 /** Un registro de configuración; trae solo el sub-shape de su `recordType`. */
 export interface TransferNoteConfigRecord {
     recordKey: string;
@@ -45,6 +57,8 @@ export interface TransferNoteConfigRecord {
     party?: TransferNotePartySettings;
     concept?: TransferNoteConceptSettings;
     pair?: TransferNotePairSettings;
+    /** Cambio propuesto que todavía no rige. */
+    pendingChange?: TransferNoteConfigPendingChange;
     updatedAt: string;
     updatedBy: string;
 }

package/bin/transferNote/dtos/requests/TransferNoteActionRequests.d.ts

@@ -17,12 +17,14 @@ export declare class CaptureTransferNoteSpeiRequest {
     trackingKey: string;
     paidAt: string;
     amountCents: number;
+    /** CLABE a la que se mandó el SPEI, obligatoria; viaja en el feed de liquidación para compararla con la registrada del receptor. */
+    paidToClabe: string;
 }
 /** Body de publicRevertTransferNoteSpei. */
 export declare class RevertTransferNoteSpeiRequest {
     reason: string;
 }
-/** Body de publicCancelTransferNote. */
+/** Body de publicCancelTransferNote; la cancelación es irreversible y exige la misma razón larga que emitir u objetar. */
 export declare class CancelTransferNoteRequest {
     reason: string;
 }

package/bin/transferNote/dtos/requests/TransferNoteActionRequests.js

@@ -13,6 +13,7 @@ exports.ResolveTransferNoteDisputeRequest = exports.CancelTransferNoteRequest =
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const TransferNoteDisputeDecisionEnum_1 = require("../../enums/TransferNoteDisputeDecisionEnum");
+const IsTransferNoteClabeConstraint_1 = require("../../validators/IsTransferNoteClabeConstraint");
 const IsTransferNoteSelectionConstraint_1 = require("../../validators/IsTransferNoteSelectionConstraint");
 const transferNoteRequestDecorators_1 = require("./transferNoteRequestDecorators");
 /** Body de publicPreviewTransferNote: items de un par por selección o por semana. */
@@ -73,6 +74,11 @@ __decorate([
     (0, class_validator_1.IsPositive)(),
     __metadata("design:type", Number)
 ], CaptureTransferNoteSpeiRequest.prototype, "amountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Validate)(IsTransferNoteClabeConstraint_1.IsTransferNoteClabeConstraint),
+    __metadata("design:type", String)
+], CaptureTransferNoteSpeiRequest.prototype, "paidToClabe", void 0);
 /** Body de publicRevertTransferNoteSpei. */
 class RevertTransferNoteSpeiRequest {
 }
@@ -81,12 +87,12 @@ __decorate([
     (0, transferNoteRequestDecorators_1.RequiredReason)(),
     __metadata("design:type", String)
 ], RevertTransferNoteSpeiRequest.prototype, "reason", void 0);
-/** Body de publicCancelTransferNote. */
+/** Body de publicCancelTransferNote; la cancelación es irreversible y exige la misma razón larga que emitir u objetar. */
 class CancelTransferNoteRequest {
 }
 exports.CancelTransferNoteRequest = CancelTransferNoteRequest;
 __decorate([
-    (0, transferNoteRequestDecorators_1.RequiredReason)(),
+    (0, transferNoteRequestDecorators_1.LongReason)(),
     __metadata("design:type", String)
 ], CancelTransferNoteRequest.prototype, "reason", void 0);
 /** Body de publicResolveTransferNoteDispute. */

package/bin/transferNote/dtos/requests/TransferNoteConfigRequests.d.ts

@@ -1,5 +1,6 @@
 import { CurrencyId } from '../../../currency/enums/CurrencyId';
 import { TransferNoteConceptSignEnum } from '../../enums/TransferNoteConceptSignEnum';
+import { TransferNoteConfigChangeDecisionEnum } from '../../enums/TransferNoteConfigChangeDecisionEnum';
 import { TransferNoteConfigRecordTypeEnum as RecordType } from '../../enums/TransferNoteConfigRecordTypeEnum';
 import { TransferNotePartyTypeEnum } from '../../enums/TransferNotePartyTypeEnum';
 export declare class TransferNoteTenantSettingsInput {
@@ -28,7 +29,10 @@ export declare class TransferNotePairSettingsInput {
     payeePartyId: string;
     activeFrom: string;
 }
-/** Body de publicUpdateTransferNoteConfig; da de alta el registro si no existe. */
+/**
+ * Body de publicUpdateTransferNoteConfig; da de alta el registro si no existe.
+ * Un cambio de CLABE o de pagador/receptor de un par queda propuesto hasta que otra persona lo apruebe.
+ */
 export declare class UpdateTransferNoteConfigRequest {
     recordType: RecordType;
     tenant?: TransferNoteTenantSettingsInput;
@@ -36,3 +40,9 @@ export declare class UpdateTransferNoteConfigRequest {
     concept?: TransferNoteConceptSettingsInput;
     pair?: TransferNotePairSettingsInput;
 }
+/** Body de publicDecideTransferNoteConfigChange: aprueba o descarta el cambio propuesto; quien lo propuso no puede aprobarlo. */
+export declare class DecideTransferNoteConfigChangeRequest {
+    decision: TransferNoteConfigChangeDecisionEnum;
+    /** `pendingChange.proposedAt` que vio quien decide; si la propuesta se reemplazó después, la decisión se rechaza. */
+    proposedAt: string;
+}

package/bin/transferNote/dtos/requests/TransferNoteConfigRequests.js

@@ -9,12 +9,13 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UpdateTransferNoteConfigRequest = exports.TransferNotePairSettingsInput = exports.TransferNoteConceptSettingsInput = exports.TransferNotePartySettingsInput = exports.TransferNoteTenantSettingsInput = void 0;
+exports.DecideTransferNoteConfigChangeRequest = exports.UpdateTransferNoteConfigRequest = exports.TransferNotePairSettingsInput = exports.TransferNoteConceptSettingsInput = exports.TransferNotePartySettingsInput = exports.TransferNoteTenantSettingsInput = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const CurrencyId_1 = require("../../../currency/enums/CurrencyId");
 const transferNoteValidation_1 = require("../../constants/transferNoteValidation");
 const TransferNoteConceptSignEnum_1 = require("../../enums/TransferNoteConceptSignEnum");
+const TransferNoteConfigChangeDecisionEnum_1 = require("../../enums/TransferNoteConfigChangeDecisionEnum");
 const TransferNoteConfigRecordTypeEnum_1 = require("../../enums/TransferNoteConfigRecordTypeEnum");
 const TransferNotePartyTypeEnum_1 = require("../../enums/TransferNotePartyTypeEnum");
 const transferNoteRequestDecorators_1 = require("./transferNoteRequestDecorators");
@@ -109,7 +110,10 @@ __decorate([
     (0, class_validator_1.IsISO8601)(),
     __metadata("design:type", String)
 ], TransferNotePairSettingsInput.prototype, "activeFrom", void 0);
-/** Body de publicUpdateTransferNoteConfig; da de alta el registro si no existe. */
+/**
+ * Body de publicUpdateTransferNoteConfig; da de alta el registro si no existe.
+ * Un cambio de CLABE o de pagador/receptor de un par queda propuesto hasta que otra persona lo apruebe.
+ */
 class UpdateTransferNoteConfigRequest {
 }
 exports.UpdateTransferNoteConfigRequest = UpdateTransferNoteConfigRequest;
@@ -150,3 +154,17 @@ __decorate([
     (0, class_transformer_1.Type)(() => TransferNotePairSettingsInput),
     __metadata("design:type", TransferNotePairSettingsInput)
 ], UpdateTransferNoteConfigRequest.prototype, "pair", void 0);
+/** Body de publicDecideTransferNoteConfigChange: aprueba o descarta el cambio propuesto; quien lo propuso no puede aprobarlo. */
+class DecideTransferNoteConfigChangeRequest {
+}
+exports.DecideTransferNoteConfigChangeRequest = DecideTransferNoteConfigChangeRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(TransferNoteConfigChangeDecisionEnum_1.TransferNoteConfigChangeDecisionEnum),
+    __metadata("design:type", String)
+], DecideTransferNoteConfigChangeRequest.prototype, "decision", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], DecideTransferNoteConfigChangeRequest.prototype, "proposedAt", void 0);

package/bin/transferNote/dtos/responses/TransferNoteConfigResponses.d.ts

@@ -4,3 +4,4 @@ export interface GetTransferNoteConfigResponse {
     records: TransferNoteConfigRecord[];
 }
 export type UpdateTransferNoteConfigResponse = TransferNoteConfigRecord;
+export type DecideTransferNoteConfigChangeResponse = TransferNoteConfigRecord;

package/bin/transferNote/enums/TransferNoteConfigChangeDecisionEnum.d.ts

@@ -0,0 +1,5 @@
+/** APPROVE aplica el cambio propuesto de CLABE o de par; REJECT lo descarta y sigue el valor vigente. */
+export declare enum TransferNoteConfigChangeDecisionEnum {
+    APPROVE = "APPROVE",
+    REJECT = "REJECT"
+}

package/bin/transferNote/enums/TransferNoteConfigChangeDecisionEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferNoteConfigChangeDecisionEnum = void 0;
+/** APPROVE aplica el cambio propuesto de CLABE o de par; REJECT lo descarta y sigue el valor vigente. */
+var TransferNoteConfigChangeDecisionEnum;
+(function (TransferNoteConfigChangeDecisionEnum) {
+    TransferNoteConfigChangeDecisionEnum["APPROVE"] = "APPROVE";
+    TransferNoteConfigChangeDecisionEnum["REJECT"] = "REJECT";
+})(TransferNoteConfigChangeDecisionEnum || (exports.TransferNoteConfigChangeDecisionEnum = TransferNoteConfigChangeDecisionEnum = {}));

package/bin/transferNote/enums/TransferNoteErrorCodeEnum.d.ts

@@ -38,5 +38,13 @@ export declare enum TransferNoteErrorCodeEnum {
     CUTOFF_DISPATCH_FAILED = "CUTOFF_DISPATCH_FAILED",
     /** Otra escritura cambió el registro entre la lectura y el guardado. */
     CONCURRENT_WRITE_CONFLICT = "CONCURRENT_WRITE_CONFLICT",
-    AUDIT_QUEUE_PUBLISH_FAILED = "AUDIT_QUEUE_PUBLISH_FAILED"
+    AUDIT_QUEUE_PUBLISH_FAILED = "AUDIT_QUEUE_PUBLISH_FAILED",
+    /** La misma persona no puede hacer las dos mitades de un control (capturar y confirmar, proponer y aprobar). */
+    SAME_ACTOR_NOT_ALLOWED = "SAME_ACTOR_NOT_ALLOWED",
+    /** El registro de configuración no tiene un cambio propuesto que decidir. */
+    CONFIG_CHANGE_NOT_PENDING = "CONFIG_CHANGE_NOT_PENDING",
+    /** El documento de la nota todavía no tiene todos sus items; se reintenta en unos segundos. */
+    NOTE_DOCUMENT_NOT_READY = "NOTE_DOCUMENT_NOT_READY",
+    /** La parte nueva repite la tienda de otra parte o un tipo que solo puede tener una parte en el tenant. */
+    PARTY_ROUTING_CONFLICT = "PARTY_ROUTING_CONFLICT"
 }

package/bin/transferNote/enums/TransferNoteErrorCodeEnum.js

@@ -43,4 +43,12 @@ var TransferNoteErrorCodeEnum;
     /** Otra escritura cambió el registro entre la lectura y el guardado. */
     TransferNoteErrorCodeEnum["CONCURRENT_WRITE_CONFLICT"] = "CONCURRENT_WRITE_CONFLICT";
     TransferNoteErrorCodeEnum["AUDIT_QUEUE_PUBLISH_FAILED"] = "AUDIT_QUEUE_PUBLISH_FAILED";
+    /** La misma persona no puede hacer las dos mitades de un control (capturar y confirmar, proponer y aprobar). */
+    TransferNoteErrorCodeEnum["SAME_ACTOR_NOT_ALLOWED"] = "SAME_ACTOR_NOT_ALLOWED";
+    /** El registro de configuración no tiene un cambio propuesto que decidir. */
+    TransferNoteErrorCodeEnum["CONFIG_CHANGE_NOT_PENDING"] = "CONFIG_CHANGE_NOT_PENDING";
+    /** El documento de la nota todavía no tiene todos sus items; se reintenta en unos segundos. */
+    TransferNoteErrorCodeEnum["NOTE_DOCUMENT_NOT_READY"] = "NOTE_DOCUMENT_NOT_READY";
+    /** La parte nueva repite la tienda de otra parte o un tipo que solo puede tener una parte en el tenant. */
+    TransferNoteErrorCodeEnum["PARTY_ROUTING_CONFLICT"] = "PARTY_ROUTING_CONFLICT";
 })(TransferNoteErrorCodeEnum || (exports.TransferNoteErrorCodeEnum = TransferNoteErrorCodeEnum = {}));

package/bin/transferNote/events/TransferNoteLifecycleEventDetails.d.ts

@@ -0,0 +1,38 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { TransferNoteDisputeCategoryEnum } from '../enums/TransferNoteDisputeCategoryEnum';
+import { TransferNoteDisputeDecisionEnum } from '../enums/TransferNoteDisputeDecisionEnum';
+export declare class TransferNoteLifecycleEventBase {
+    /** Fijo por ocurrencia (`{noteId}#{evento}#{instante}`): un reenvío llega con el mismo id. */
+    eventId: string;
+    tenantId: string;
+    noteId: string;
+    pairKey: string;
+    isoWeek: string;
+    netAmountCents: number;
+    currency: CurrencyId;
+}
+export declare class TransferNoteSpeiCapturedEventDetail extends TransferNoteLifecycleEventBase {
+    trackingKey: string;
+    /** ISO 8601 del pago declarado. */
+    paidAt: string;
+    paidAmountCents: number;
+    /** CLABE a la que se mandó el SPEI, si se capturó. */
+    paidToClabe?: string;
+    capturedAt: string;
+}
+export declare class TransferNoteSpeiRevertedEventDetail extends TransferNoteLifecycleEventBase {
+    /** Clave de rastreo del SPEI anulado. */
+    trackingKey: string;
+    revertedAt: string;
+}
+export declare class TransferNoteCancelledEventDetail extends TransferNoteLifecycleEventBase {
+    cancelledAt: string;
+}
+export declare class TransferNoteDisputedEventDetail extends TransferNoteLifecycleEventBase {
+    category: TransferNoteDisputeCategoryEnum;
+    disputedAt: string;
+}
+export declare class TransferNoteDisputeResolvedEventDetail extends TransferNoteLifecycleEventBase {
+    decision: TransferNoteDisputeDecisionEnum;
+    resolvedAt: string;
+}

package/bin/transferNote/events/TransferNoteLifecycleEventDetails.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferNoteDisputeResolvedEventDetail = exports.TransferNoteDisputedEventDetail = exports.TransferNoteCancelledEventDetail = exports.TransferNoteSpeiRevertedEventDetail = exports.TransferNoteSpeiCapturedEventDetail = exports.TransferNoteLifecycleEventBase = void 0;
+// Campos que comparten los eventos del ciclo de vida de la nota; solo ids y montos, sin razones en texto libre.
+class TransferNoteLifecycleEventBase {
+}
+exports.TransferNoteLifecycleEventBase = TransferNoteLifecycleEventBase;
+// `detail` de TransferNoteSpeiCaptured: el pagador capturó el SPEI y la nota pasó a SENT.
+class TransferNoteSpeiCapturedEventDetail extends TransferNoteLifecycleEventBase {
+}
+exports.TransferNoteSpeiCapturedEventDetail = TransferNoteSpeiCapturedEventDetail;
+// `detail` de TransferNoteSpeiReverted: el SPEI se anuló y la nota volvió a ISSUED sin confirmaciones.
+class TransferNoteSpeiRevertedEventDetail extends TransferNoteLifecycleEventBase {
+}
+exports.TransferNoteSpeiRevertedEventDetail = TransferNoteSpeiRevertedEventDetail;
+// `detail` de TransferNoteCancelled: la nota se canceló y sus items volvieron al pool.
+class TransferNoteCancelledEventDetail extends TransferNoteLifecycleEventBase {
+}
+exports.TransferNoteCancelledEventDetail = TransferNoteCancelledEventDetail;
+// `detail` de TransferNoteDisputed: el retailer objetó la nota.
+class TransferNoteDisputedEventDetail extends TransferNoteLifecycleEventBase {
+}
+exports.TransferNoteDisputedEventDetail = TransferNoteDisputedEventDetail;
+// `detail` de TransferNoteDisputeResolved: quien controla la nota aceptó o rechazó la objeción. La nota que
+// reemplaza a una aceptada sale después en su propio TransferNoteIssued.
+class TransferNoteDisputeResolvedEventDetail extends TransferNoteLifecycleEventBase {
+}
+exports.TransferNoteDisputeResolvedEventDetail = TransferNoteDisputeResolvedEventDetail;

package/bin/transferNote/events/TransferNoteReconciledEventDetail.d.ts

@@ -2,7 +2,12 @@ import { CurrencyId } from '../../currency/enums/CurrencyId';
 export declare const TRANSFER_NOTE_EVENTS_SOURCE = "fiado.transferNote";
 export declare enum TransferNoteEventDetailTypeEnum {
     TRANSFER_NOTE_RECONCILED = "transferNote.TransferNoteReconciled",
-    TRANSFER_NOTE_ISSUED = "transferNote.TransferNoteIssued"
+    TRANSFER_NOTE_ISSUED = "transferNote.TransferNoteIssued",
+    TRANSFER_NOTE_SPEI_CAPTURED = "transferNote.TransferNoteSpeiCaptured",
+    TRANSFER_NOTE_SPEI_REVERTED = "transferNote.TransferNoteSpeiReverted",
+    TRANSFER_NOTE_CANCELLED = "transferNote.TransferNoteCancelled",
+    TRANSFER_NOTE_DISPUTED = "transferNote.TransferNoteDisputed",
+    TRANSFER_NOTE_DISPUTE_RESOLVED = "transferNote.TransferNoteDisputeResolved"
 }
 export declare class TransferNoteReconciledEventDetail {
     /** Fijo por nota: un reenvío llega con el mismo id y el consumidor lo descarta. */

package/bin/transferNote/events/TransferNoteReconciledEventDetail.js

@@ -7,6 +7,11 @@ var TransferNoteEventDetailTypeEnum;
 (function (TransferNoteEventDetailTypeEnum) {
     TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_RECONCILED"] = "transferNote.TransferNoteReconciled";
     TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_ISSUED"] = "transferNote.TransferNoteIssued";
+    TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_SPEI_CAPTURED"] = "transferNote.TransferNoteSpeiCaptured";
+    TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_SPEI_REVERTED"] = "transferNote.TransferNoteSpeiReverted";
+    TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_CANCELLED"] = "transferNote.TransferNoteCancelled";
+    TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_DISPUTED"] = "transferNote.TransferNoteDisputed";
+    TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_DISPUTE_RESOLVED"] = "transferNote.TransferNoteDisputeResolved";
 })(TransferNoteEventDetailTypeEnum || (exports.TransferNoteEventDetailTypeEnum = TransferNoteEventDetailTypeEnum = {}));
 // `detail` de TransferNoteReconciled; el motor recalcula con él el agregado de la semana del par.
 class TransferNoteReconciledEventDetail {

package/bin/transferNote/index.d.ts

@@ -12,10 +12,12 @@ export * from './enums/TransferNoteConfirmationSourceEnum';
 export * from './enums/TransferNoteHistoryActionEnum';
 export * from './enums/TransferNoteFeedConceptEnum';
 export * from './enums/TransferNoteErrorCodeEnum';
+export * from './enums/TransferNoteConfigChangeDecisionEnum';
 export * from './constants/transferNoteErrorHttpStatus';
 export * from './constants/transferNoteValidation';
 export * from './constants/transferNoteDefaultFees';
 export * from './validators/IsTransferNoteSelectionConstraint';
+export * from './validators/IsTransferNoteClabeConstraint';
 export * from './dtos/TransferNote';
 export * from './dtos/TransferNoteItem';
 export * from './dtos/TransferNoteHistoryEntry';
@@ -33,3 +35,4 @@ export * from './dtos/responses/TransferNoteConfigResponses';
 export * from './dtos/responses/PrivateTransferNoteResponses';
 export * from './events/TransferNoteReconciledEventDetail';
 export * from './events/TransferNoteIssuedEventDetail';
+export * from './events/TransferNoteLifecycleEventDetails';

package/bin/transferNote/index.js

@@ -29,11 +29,13 @@ __exportStar(require("./enums/TransferNoteConfirmationSourceEnum"), exports);
 __exportStar(require("./enums/TransferNoteHistoryActionEnum"), exports);
 __exportStar(require("./enums/TransferNoteFeedConceptEnum"), exports);
 __exportStar(require("./enums/TransferNoteErrorCodeEnum"), exports);
+__exportStar(require("./enums/TransferNoteConfigChangeDecisionEnum"), exports);
 // Constantes y validadores
 __exportStar(require("./constants/transferNoteErrorHttpStatus"), exports);
 __exportStar(require("./constants/transferNoteValidation"), exports);
 __exportStar(require("./constants/transferNoteDefaultFees"), exports);
 __exportStar(require("./validators/IsTransferNoteSelectionConstraint"), exports);
+__exportStar(require("./validators/IsTransferNoteClabeConstraint"), exports);
 // Entidades del dominio
 __exportStar(require("./dtos/TransferNote"), exports);
 __exportStar(require("./dtos/TransferNoteItem"), exports);
@@ -55,3 +57,4 @@ __exportStar(require("./dtos/responses/PrivateTransferNoteResponses"), exports);
 // Eventos
 __exportStar(require("./events/TransferNoteReconciledEventDetail"), exports);
 __exportStar(require("./events/TransferNoteIssuedEventDetail"), exports);
+__exportStar(require("./events/TransferNoteLifecycleEventDetails"), exports);

package/bin/transferNote/validators/IsTransferNoteClabeConstraint.d.ts

@@ -0,0 +1,8 @@
+import { type ValidatorConstraintInterface } from 'class-validator';
+/** CLABE de 18 dígitos cuyo último dígito es el verificador correcto de los 17 anteriores. */
+export declare function isValidTransferNoteClabe(clabe: unknown): boolean;
+/** CLABE con formato y dígito verificador válidos. */
+export declare class IsTransferNoteClabeConstraint implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean;
+    defaultMessage(): string;
+}

package/bin/transferNote/validators/IsTransferNoteClabeConstraint.js

@@ -0,0 +1,34 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsTransferNoteClabeConstraint = void 0;
+exports.isValidTransferNoteClabe = isValidTransferNoteClabe;
+const class_validator_1 = require("class-validator");
+const transferNoteValidation_1 = require("../constants/transferNoteValidation");
+/** Pesos 3, 7, 1 del dígito verificador de la CLABE (Banxico). */
+const CLABE_CHECK_WEIGHTS = [3, 7, 1];
+/** CLABE de 18 dígitos cuyo último dígito es el verificador correcto de los 17 anteriores. */
+function isValidTransferNoteClabe(clabe) {
+    if (typeof clabe !== 'string' || !transferNoteValidation_1.TRANSFER_NOTE_CLABE_PATTERN.test(clabe))
+        return false;
+    const sum = [...clabe.slice(0, 17)].reduce((acc, digit, index) => acc + ((Number(digit) * CLABE_CHECK_WEIGHTS[index % 3]) % 10), 0);
+    return (10 - (sum % 10)) % 10 === Number(clabe[17]);
+}
+/** CLABE con formato y dígito verificador válidos. */
+let IsTransferNoteClabeConstraint = class IsTransferNoteClabeConstraint {
+    validate(value) {
+        return isValidTransferNoteClabe(value);
+    }
+    defaultMessage() {
+        return 'CLABE de 18 dígitos con dígito verificador válido';
+    }
+};
+exports.IsTransferNoteClabeConstraint = IsTransferNoteClabeConstraint;
+exports.IsTransferNoteClabeConstraint = IsTransferNoteClabeConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isTransferNoteClabe', async: false })
+], IsTransferNoteClabeConstraint);

package/package.json

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

package/src/retailCommission/dtos/CommissionAccrual.ts

@@ -88,6 +88,8 @@ export interface CommissionSaleInput {
     /** `CASH` | `CREDIT`, para `PERCENT_BY_PAYMENT`. */
     paymentType: string;
     soldAt: string;
+    /** Cuándo se ganó la comisión: ubica la venta en su corte. Los devengos viejos no lo traen o lo traen en `null` (usar `soldAt`). */
+    earnedAt?: string | null;
     /** Las líneas de la venta. Las ventas que se calculan con reglas siempre las traen. */
     lines?: CommissionSaleLine[];
 }

package/src/retailWizard/dtos/Sale.ts

@@ -98,6 +98,10 @@ export interface Sale {
   cancelledAt: string | null;
   /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
   cancelReason: string | null;
+  /** La comisión espera a que el cliente active su app: contraseña, contrato y número secreto. Ausente si no espera. */
+  commissionAwaitingApp?: boolean;
+  /** ISO; cuándo se ganó la comisión, si el cliente activó su app después de cerrar. Ausente: al cerrar o en espera. */
+  commissionEarnedAt?: string;
   /** Si la venta se puede cancelar hoy y, si no, por qué; solo lo trae el detalle del backoffice. */
   cancellation?: SaleCancellation;
   /**

package/src/retailWizard/events/RetailCommissionInboundMessage.ts

@@ -131,6 +131,14 @@ export class RetailCommissionInboundMessage {
     @IsISO8601()
     occurredAt!: string;
 
+    /**
+     * Cuándo se ganó la comisión, si el cliente activó su app después de cerrar la venta. Ubica la venta en
+     * su corte. Ausente: se ganó al cerrar (`soldAt`).
+     */
+    @IsOptional()
+    @IsISO8601()
+    earnedAt?: string;
+
     /** Motivo de la cancelación; puede venir vacío. */
     @IsOptional()
     @IsString()

package/src/transferNote/constants/transferNoteErrorHttpStatus.ts

@@ -32,4 +32,8 @@ export const TRANSFER_NOTE_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409
     [C.CUTOFF_DISPATCH_FAILED]: 502,
     [C.CONCURRENT_WRITE_CONFLICT]: 409,
     [C.AUDIT_QUEUE_PUBLISH_FAILED]: 502,
+    [C.SAME_ACTOR_NOT_ALLOWED]: 422,
+    [C.CONFIG_CHANGE_NOT_PENDING]: 409,
+    [C.NOTE_DOCUMENT_NOT_READY]: 409,
+    [C.PARTY_ROUTING_CONFLICT]: 409,
 };

package/src/transferNote/dtos/TransferNote.ts

@@ -28,6 +28,8 @@ export interface TransferNoteSpeiPayment {
     capturedBy: string;
     capturedAt: string;
     receiptUploaded: boolean;
+    /** CLABE a la que se mandó el SPEI, si se capturó. */
+    paidToClabe?: string;
 }
 
 export interface TransferNoteConfirmation {
@@ -46,6 +48,13 @@ export interface TransferNoteDispute {
     previousStatus: TransferNoteStatusEnum;
 }
 
+/** Cancelación de la nota: quién, cuándo y por qué. */
+export interface TransferNoteCancellation {
+    reason: string;
+    cancelledBy: string;
+    cancelledAt: string;
+}
+
 /** Fila de los listados de notas. */
 export interface TransferNoteSummary {
     noteId: string;
@@ -74,6 +83,8 @@ export interface TransferNote extends TransferNoteSummary {
     issueReason?: string;
     speiPayment?: TransferNoteSpeiPayment;
     dispute?: TransferNoteDispute;
+    /** Solo en notas canceladas después de emitirse. */
+    cancellation?: TransferNoteCancellation;
     /** Nota cancelada de la que nace esta, o la regenerada que la reemplaza. */
     regeneratedFromNoteId?: string;
     regeneratedNoteId?: string;

package/src/transferNote/dtos/TransferNoteConfigRecords.ts

@@ -42,6 +42,19 @@ export interface TransferNotePairSettings {
     discrepancyOpenedAt?: string;
 }
 
+/**
+ * Cambio que altera a quién se le paga y espera la aprobación de otra persona: CLABE, tipo o tienda de una parte,
+ * pagador/receptor de un par, o tipos de pagador/receptor o signo de un concepto.
+ * Mientras no se apruebe rige el valor vigente del registro.
+ */
+export interface TransferNoteConfigPendingChange {
+    party?: TransferNotePartySettings;
+    concept?: TransferNoteConceptSettings;
+    pair?: TransferNotePairSettings;
+    proposedBy: string;
+    proposedAt: string;
+}
+
 /** Un registro de configuración; trae solo el sub-shape de su `recordType`. */
 export interface TransferNoteConfigRecord {
     recordKey: string;
@@ -50,6 +63,8 @@ export interface TransferNoteConfigRecord {
     party?: TransferNotePartySettings;
     concept?: TransferNoteConceptSettings;
     pair?: TransferNotePairSettings;
+    /** Cambio propuesto que todavía no rige. */
+    pendingChange?: TransferNoteConfigPendingChange;
     updatedAt: string;
     updatedBy: string;
 }

package/src/transferNote/dtos/requests/TransferNoteActionRequests.ts

@@ -1,6 +1,7 @@
 import { Expose, Type } from 'class-transformer';
 import { IsEnum, IsInt, IsISO8601, IsPositive, Validate } from 'class-validator';
 import { TransferNoteDisputeDecisionEnum } from '../../enums/TransferNoteDisputeDecisionEnum';
+import { IsTransferNoteClabeConstraint } from '../../validators/IsTransferNoteClabeConstraint';
 import { IsTransferNoteSelectionConstraint } from '../../validators/IsTransferNoteSelectionConstraint';
 import { LongReason, OptionalIsoWeek, RequiredId, RequiredReason } from './transferNoteRequestDecorators';
 
@@ -47,6 +48,11 @@ export class CaptureTransferNoteSpeiRequest {
     @IsInt()
     @IsPositive()
     amountCents!: number;
+
+    /** CLABE a la que se mandó el SPEI, obligatoria; viaja en el feed de liquidación para compararla con la registrada del receptor. */
+    @Expose()
+    @Validate(IsTransferNoteClabeConstraint)
+    paidToClabe!: string;
 }
 
 /** Body de publicRevertTransferNoteSpei. */
@@ -55,9 +61,9 @@ export class RevertTransferNoteSpeiRequest {
     reason!: string;
 }
 
-/** Body de publicCancelTransferNote. */
+/** Body de publicCancelTransferNote; la cancelación es irreversible y exige la misma razón larga que emitir u objetar. */
 export class CancelTransferNoteRequest {
-    @RequiredReason()
+    @LongReason()
     reason!: string;
 }
 

package/src/transferNote/dtos/requests/TransferNoteConfigRequests.ts

@@ -3,6 +3,7 @@ import { IsDefined, IsEmail, IsEnum, IsInt, IsISO8601, IsOptional, Matches, Min,
 import { CurrencyId } from '../../../currency/enums/CurrencyId';
 import { TRANSFER_NOTE_CLABE_PATTERN } from '../../constants/transferNoteValidation';
 import { TransferNoteConceptSignEnum } from '../../enums/TransferNoteConceptSignEnum';
+import { TransferNoteConfigChangeDecisionEnum } from '../../enums/TransferNoteConfigChangeDecisionEnum';
 import { TransferNoteConfigRecordTypeEnum as RecordType } from '../../enums/TransferNoteConfigRecordTypeEnum';
 import { TransferNotePartyTypeEnum } from '../../enums/TransferNotePartyTypeEnum';
 import { RequiredId } from './transferNoteRequestDecorators';
@@ -79,7 +80,10 @@ export class TransferNotePairSettingsInput {
     activeFrom!: string;
 }
 
-/** Body de publicUpdateTransferNoteConfig; da de alta el registro si no existe. */
+/**
+ * Body de publicUpdateTransferNoteConfig; da de alta el registro si no existe.
+ * Un cambio de CLABE o de pagador/receptor de un par queda propuesto hasta que otra persona lo apruebe.
+ */
 export class UpdateTransferNoteConfigRequest {
     @Expose()
     @IsEnum(RecordType)
@@ -113,3 +117,15 @@ export class UpdateTransferNoteConfigRequest {
     @Type(() => TransferNotePairSettingsInput)
     pair?: TransferNotePairSettingsInput;
 }
+
+/** Body de publicDecideTransferNoteConfigChange: aprueba o descarta el cambio propuesto; quien lo propuso no puede aprobarlo. */
+export class DecideTransferNoteConfigChangeRequest {
+    @Expose()
+    @IsEnum(TransferNoteConfigChangeDecisionEnum)
+    decision!: TransferNoteConfigChangeDecisionEnum;
+
+    /** `pendingChange.proposedAt` que vio quien decide; si la propuesta se reemplazó después, la decisión se rechaza. */
+    @Expose()
+    @IsISO8601()
+    proposedAt!: string;
+}

package/src/transferNote/dtos/responses/TransferNoteConfigResponses.ts

@@ -6,3 +6,5 @@ export interface GetTransferNoteConfigResponse {
 }
 
 export type UpdateTransferNoteConfigResponse = TransferNoteConfigRecord;
+
+export type DecideTransferNoteConfigChangeResponse = TransferNoteConfigRecord;

package/src/transferNote/enums/TransferNoteConfigChangeDecisionEnum.ts

@@ -0,0 +1,5 @@
+/** APPROVE aplica el cambio propuesto de CLABE o de par; REJECT lo descarta y sigue el valor vigente. */
+export enum TransferNoteConfigChangeDecisionEnum {
+    APPROVE = 'APPROVE',
+    REJECT = 'REJECT',
+}

package/src/transferNote/enums/TransferNoteErrorCodeEnum.ts

@@ -41,4 +41,12 @@ export enum TransferNoteErrorCodeEnum {
     /** Otra escritura cambió el registro entre la lectura y el guardado. */
     CONCURRENT_WRITE_CONFLICT = 'CONCURRENT_WRITE_CONFLICT',
     AUDIT_QUEUE_PUBLISH_FAILED = 'AUDIT_QUEUE_PUBLISH_FAILED',
+    /** La misma persona no puede hacer las dos mitades de un control (capturar y confirmar, proponer y aprobar). */
+    SAME_ACTOR_NOT_ALLOWED = 'SAME_ACTOR_NOT_ALLOWED',
+    /** El registro de configuración no tiene un cambio propuesto que decidir. */
+    CONFIG_CHANGE_NOT_PENDING = 'CONFIG_CHANGE_NOT_PENDING',
+    /** El documento de la nota todavía no tiene todos sus items; se reintenta en unos segundos. */
+    NOTE_DOCUMENT_NOT_READY = 'NOTE_DOCUMENT_NOT_READY',
+    /** La parte nueva repite la tienda de otra parte o un tipo que solo puede tener una parte en el tenant. */
+    PARTY_ROUTING_CONFLICT = 'PARTY_ROUTING_CONFLICT',
 }

package/src/transferNote/events/TransferNoteLifecycleEventDetails.ts

@@ -0,0 +1,51 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { TransferNoteDisputeCategoryEnum } from '../enums/TransferNoteDisputeCategoryEnum';
+import { TransferNoteDisputeDecisionEnum } from '../enums/TransferNoteDisputeDecisionEnum';
+
+// Campos que comparten los eventos del ciclo de vida de la nota; solo ids y montos, sin razones en texto libre.
+export class TransferNoteLifecycleEventBase {
+    /** Fijo por ocurrencia (`{noteId}#{evento}#{instante}`): un reenvío llega con el mismo id. */
+    eventId!: string;
+    tenantId!: string;
+    noteId!: string;
+    pairKey!: string;
+    isoWeek!: string;
+    netAmountCents!: number;
+    currency!: CurrencyId;
+}
+
+// `detail` de TransferNoteSpeiCaptured: el pagador capturó el SPEI y la nota pasó a SENT.
+export class TransferNoteSpeiCapturedEventDetail extends TransferNoteLifecycleEventBase {
+    trackingKey!: string;
+    /** ISO 8601 del pago declarado. */
+    paidAt!: string;
+    paidAmountCents!: number;
+    /** CLABE a la que se mandó el SPEI, si se capturó. */
+    paidToClabe?: string;
+    capturedAt!: string;
+}
+
+// `detail` de TransferNoteSpeiReverted: el SPEI se anuló y la nota volvió a ISSUED sin confirmaciones.
+export class TransferNoteSpeiRevertedEventDetail extends TransferNoteLifecycleEventBase {
+    /** Clave de rastreo del SPEI anulado. */
+    trackingKey!: string;
+    revertedAt!: string;
+}
+
+// `detail` de TransferNoteCancelled: la nota se canceló y sus items volvieron al pool.
+export class TransferNoteCancelledEventDetail extends TransferNoteLifecycleEventBase {
+    cancelledAt!: string;
+}
+
+// `detail` de TransferNoteDisputed: el retailer objetó la nota.
+export class TransferNoteDisputedEventDetail extends TransferNoteLifecycleEventBase {
+    category!: TransferNoteDisputeCategoryEnum;
+    disputedAt!: string;
+}
+
+// `detail` de TransferNoteDisputeResolved: quien controla la nota aceptó o rechazó la objeción. La nota que
+// reemplaza a una aceptada sale después en su propio TransferNoteIssued.
+export class TransferNoteDisputeResolvedEventDetail extends TransferNoteLifecycleEventBase {
+    decision!: TransferNoteDisputeDecisionEnum;
+    resolvedAt!: string;
+}

package/src/transferNote/events/TransferNoteReconciledEventDetail.ts

@@ -6,6 +6,11 @@ export const TRANSFER_NOTE_EVENTS_SOURCE = 'fiado.transferNote';
 export enum TransferNoteEventDetailTypeEnum {
     TRANSFER_NOTE_RECONCILED = 'transferNote.TransferNoteReconciled',
     TRANSFER_NOTE_ISSUED = 'transferNote.TransferNoteIssued',
+    TRANSFER_NOTE_SPEI_CAPTURED = 'transferNote.TransferNoteSpeiCaptured',
+    TRANSFER_NOTE_SPEI_REVERTED = 'transferNote.TransferNoteSpeiReverted',
+    TRANSFER_NOTE_CANCELLED = 'transferNote.TransferNoteCancelled',
+    TRANSFER_NOTE_DISPUTED = 'transferNote.TransferNoteDisputed',
+    TRANSFER_NOTE_DISPUTE_RESOLVED = 'transferNote.TransferNoteDisputeResolved',
 }
 
 // `detail` de TransferNoteReconciled; el motor recalcula con él el agregado de la semana del par.

package/src/transferNote/index.ts

@@ -13,12 +13,14 @@ export * from './enums/TransferNoteConfirmationSourceEnum';
 export * from './enums/TransferNoteHistoryActionEnum';
 export * from './enums/TransferNoteFeedConceptEnum';
 export * from './enums/TransferNoteErrorCodeEnum';
+export * from './enums/TransferNoteConfigChangeDecisionEnum';
 
 // Constantes y validadores
 export * from './constants/transferNoteErrorHttpStatus';
 export * from './constants/transferNoteValidation';
 export * from './constants/transferNoteDefaultFees';
 export * from './validators/IsTransferNoteSelectionConstraint';
+export * from './validators/IsTransferNoteClabeConstraint';
 
 // Entidades del dominio
 export * from './dtos/TransferNote';
@@ -44,3 +46,4 @@ export * from './dtos/responses/PrivateTransferNoteResponses';
 // Eventos
 export * from './events/TransferNoteReconciledEventDetail';
 export * from './events/TransferNoteIssuedEventDetail';
+export * from './events/TransferNoteLifecycleEventDetails';

package/src/transferNote/validators/IsTransferNoteClabeConstraint.ts

@@ -0,0 +1,24 @@
+import { ValidatorConstraint, type ValidatorConstraintInterface } from 'class-validator';
+import { TRANSFER_NOTE_CLABE_PATTERN } from '../constants/transferNoteValidation';
+
+/** Pesos 3, 7, 1 del dígito verificador de la CLABE (Banxico). */
+const CLABE_CHECK_WEIGHTS = [3, 7, 1] as const;
+
+/** CLABE de 18 dígitos cuyo último dígito es el verificador correcto de los 17 anteriores. */
+export function isValidTransferNoteClabe(clabe: unknown): boolean {
+    if (typeof clabe !== 'string' || !TRANSFER_NOTE_CLABE_PATTERN.test(clabe)) return false;
+    const sum = [...clabe.slice(0, 17)].reduce((acc, digit, index) => acc + ((Number(digit) * CLABE_CHECK_WEIGHTS[index % 3]) % 10), 0);
+    return (10 - (sum % 10)) % 10 === Number(clabe[17]);
+}
+
+/** CLABE con formato y dígito verificador válidos. */
+@ValidatorConstraint({ name: 'isTransferNoteClabe', async: false })
+export class IsTransferNoteClabeConstraint implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean {
+        return isValidTransferNoteClabe(value);
+    }
+
+    defaultMessage(): string {
+        return 'CLABE de 18 dígitos con dígito verificador válido';
+    }
+}