@fiado/type-kit 3.452.0 → 3.453.0

package/_test_/unit/transaction/refund-dtos.test.ts

@@ -21,6 +21,8 @@ describe('Refund DTOs', () => {
       refundCase: {
         pathType: RefundPathTypeEnum.DICTAMEN_PROCEDE,
         caseFolio: 'FOLIO-001',
+        folioId: 'e8b34db9-11cc-4d7a-b6c9-7f2a91b8c001',
+        folioEventId: '9a41c3d0-f78b-4d54-9c62-1e8d5f2b7003',
         originalTransactionId: 'TX-123',
         originalAmount: 1000,
         originalChannel: 'SPEI_IN',
@@ -75,4 +77,31 @@ describe('Refund DTOs', () => {
     expect(confirmRequest.speiTrackingKey).toBe('SPE-TRACK-001');
     expect(confirmRequest.executedAt).toBe('2026-09-17T22:00:00Z');
   });
+
+  it('AuthorizeRefundRequest expone folioId y folioEventId como campos requeridos de refundCase', () => {
+    const req: AuthorizeRefundRequest = {
+      idempotencyKey: 'k',
+      directoryId: 'd',
+      peopleId: 'p',
+      productCatalogId: 'MEX_REFUND_PCF',
+      operation: 'ADD',
+      amount: { total: 100, currencyId: 'MXN' },
+      refundChannel: RefundChannelEnum.INTERNAL_PCF,
+      refundCase: {
+        pathType: RefundPathTypeEnum.DICTAMEN_PROCEDE,
+        caseFolio: 'F',
+        folioId: 'uuid-folio',
+        folioEventId: 'uuid-event',
+        originalTransactionId: null,
+        originalAmount: 100,
+        originalChannel: 'PCF_P2P',
+      },
+      approval: { makerUserId: 'm', checkerUserId: null, minuteS3Key: null },
+      reason: 'r',
+      evidence: { dictamenS3Key: null, incidentReportS3Key: null, objectionFormS3Key: null },
+      pldOverrideMinuteS3Key: null,
+    };
+    expect(req.refundCase.folioId).toBe('uuid-folio');
+    expect(req.refundCase.folioEventId).toBe('uuid-event');
+  });
 });

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

@@ -19,6 +19,25 @@ export interface AuthorizeRefundRequest {
     refundCase: {
         pathType: RefundPathTypeEnum;
         caseFolio: string;
+        /**
+         * UUID del registro `DisputeOrFraudLog` que originó el reintegro (fuente
+         * autoritativa del folio). El BO lo persiste en el ledger como
+         * `PagoConfiadoTx_GT.disputeOrFraudLogId` para cerrar el vínculo con la
+         * reclamación (antes del rediseño quedaba en "ND").
+         */
+        folioId: string;
+        /**
+         * UUID del evento R27 específico dentro de `DisputeOrFraudLog.statusHistory[]`
+         * que autoriza este reintegro. Preserva el ligado inmutable evento↔movimiento
+         * en `DisputeRefund_GT.folioEventId`: un folio que reingresa (103) tras un
+         * dictamen no procedente y genera un segundo refund puede tener 2 entradas
+         * en `DisputeRefund_GT`, cada una apuntando a su evento R27 propio.
+         *
+         * Lo obtiene el Dashboard del response de `disputes-business` al firmar el
+         * dictamen (`lastEvent.eventId`). Es inmutable — no se recalcula ni se
+         * reasigna una vez enviado.
+         */
+        folioEventId: string;
         originalTransactionId: string | null;
         originalAmount: number;
         /**

package/package.json

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

package/src/transaction/dtos/AuthorizeRefundRequest.ts

@@ -17,6 +17,25 @@ export interface AuthorizeRefundRequest {
     refundCase: {
         pathType: RefundPathTypeEnum;
         caseFolio: string;
+        /**
+         * UUID del registro `DisputeOrFraudLog` que originó el reintegro (fuente
+         * autoritativa del folio). El BO lo persiste en el ledger como
+         * `PagoConfiadoTx_GT.disputeOrFraudLogId` para cerrar el vínculo con la
+         * reclamación (antes del rediseño quedaba en "ND").
+         */
+        folioId: string;
+        /**
+         * UUID del evento R27 específico dentro de `DisputeOrFraudLog.statusHistory[]`
+         * que autoriza este reintegro. Preserva el ligado inmutable evento↔movimiento
+         * en `DisputeRefund_GT.folioEventId`: un folio que reingresa (103) tras un
+         * dictamen no procedente y genera un segundo refund puede tener 2 entradas
+         * en `DisputeRefund_GT`, cada una apuntando a su evento R27 propio.
+         *
+         * Lo obtiene el Dashboard del response de `disputes-business` al firmar el
+         * dictamen (`lastEvent.eventId`). Es inmutable — no se recalcula ni se
+         * reasigna una vez enviado.
+         */
+        folioEventId: string;
         originalTransactionId: string | null;
         originalAmount: number;
         /**