@fiado/type-kit 3.555.0 → 3.557.0

package/_test_/unit/retailWizard/accountOpeningCancelReasons.test.ts

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+import { SystemCancelReasonEnum } from '../../../src/retailWizard';
+
+describe('SystemCancelReasonEnum — motivos de la apertura', () => {
+  it('declara ALREADY_HAS_ACCOUNT y CURP_OF_OTHER_CUSTOMER', () => {
+    expect(SystemCancelReasonEnum.ALREADY_HAS_ACCOUNT).toBe('ALREADY_HAS_ACCOUNT');
+    expect(SystemCancelReasonEnum.CURP_OF_OTHER_CUSTOMER).toBe('CURP_OF_OTHER_CUSTOMER');
+  });
+});

package/_test_/unit/retailWizard/accountOpeningFlag.test.ts

@@ -0,0 +1,37 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { StartSessionRequest, type WizardSession } from '../../../src/retailWizard';
+
+function startErrors(payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(StartSessionRequest, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+describe('StartSessionRequest — marca accountOpening', () => {
+  it('sin la marca sigue igual que hoy', () => {
+    expect(startErrors({ phone: '5512345678' })).toEqual([]);
+  });
+
+  it.each([true, false])('acepta accountOpening=%s y lo conserva', (value) => {
+    const dto = plainToInstance(
+      StartSessionRequest,
+      { phone: '5512345678', accountOpening: value },
+      { excludeExtraneousValues: true },
+    );
+    expect(validateSync(dto)).toEqual([]);
+    expect(dto.accountOpening).toBe(value);
+  });
+
+  it.each(['true', 1, 'si'])('rechaza accountOpening no booleano (%p)', (value) => {
+    expect(startErrors({ phone: '5512345678', accountOpening: value })).toContain('accountOpening');
+  });
+});
+
+describe('WizardSession — marca accountOpening', () => {
+  it('es opcional en la sesión', () => {
+    const session: Pick<WizardSession, 'accountOpening'> = { accountOpening: true };
+    const legacy: Pick<WizardSession, 'accountOpening'> = {};
+    expect([session.accountOpening, legacy.accountOpening]).toEqual([true, undefined]);
+  });
+});

package/_test_/unit/retailWizard/accountOpeningOccupation.test.ts

@@ -0,0 +1,44 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { OccupationEnum, OccupationRequest } from '../../../src/retailWizard';
+
+function occupationErrors(payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(OccupationRequest, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+const BASE_OCCUPATION = { occupation: OccupationEnum.EMPLOYED, monthlyIncome: '20000' };
+const FULL_PROFILE = {
+  monthlyExtraSupport: '0',
+  usageMonthly: '60',
+  maximumTx: '10000',
+  beneficialOwner: 'SELF',
+};
+
+describe('OccupationRequest — 4 MXN_* opcionales para la apertura', () => {
+  it('sin los MXN_* sigue igual que hoy', () => {
+    expect(occupationErrors(BASE_OCCUPATION)).toEqual([]);
+  });
+
+  it('acepta el perfil completo del catálogo y lo conserva', () => {
+    const dto = plainToInstance(
+      OccupationRequest,
+      { ...BASE_OCCUPATION, ...FULL_PROFILE },
+      { excludeExtraneousValues: true },
+    );
+    expect(validateSync(dto)).toEqual([]);
+    expect(dto).toMatchObject(FULL_PROFILE);
+  });
+
+  it('acepta OTHER en beneficialOwner: lo rechaza el negocio, no el DTO', () => {
+    expect(occupationErrors({ ...BASE_OCCUPATION, beneficialOwner: 'OTHER' })).toEqual([]);
+  });
+
+  it.each(['monthlyExtraSupport', 'usageMonthly', 'maximumTx', 'beneficialOwner'])(
+    'rechaza %s fuera del catálogo',
+    (field) => {
+      expect(occupationErrors({ ...BASE_OCCUPATION, ...FULL_PROFILE, [field]: 'X' })).toEqual([field]);
+    },
+  );
+});

package/_test_/unit/retailWizard/accountOpeningsResponse.test.ts

@@ -0,0 +1,22 @@
+import 'reflect-metadata';
+import type { BackofficeAccountOpeningsResponse } from '../../../src/retailWizard';
+
+describe('BackofficeAccountOpeningsResponse', () => {
+  it('declara las filas de aperturas y el cursor', () => {
+    const response: BackofficeAccountOpeningsResponse = {
+      nextToken: null,
+      items: [
+        {
+          sessionId: 'S1',
+          retailCustomerId: 'RC-1',
+          name: null,
+          phone: '5512345678',
+          storeId: 'ST-1',
+          sellerRetailUserId: 'RU-1',
+          openedAt: '2026-10-20T18:00:00.000Z',
+        },
+      ],
+    };
+    expect(response.items[0].sessionId).toBe('S1');
+  });
+});

package/bin/notificationMessages/dtos/DisputeNotificationData.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
+ * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ */
+export declare class DisputeNotificationData {
+    id: string;
+    folio: string;
+    folioId?: string;
+}

package/bin/notificationMessages/dtos/DisputeNotificationData.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeNotificationData = void 0;
+/**
+ * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
+ * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ */
+class DisputeNotificationData {
+}
+exports.DisputeNotificationData = DisputeNotificationData;

package/bin/notificationMessages/index.d.ts

@@ -1,5 +1,6 @@
 export * from './dtos/NotificationQueueMessageRequest';
 export * from './dtos/QueueMessageDestination';
+export * from './dtos/DisputeNotificationData';
 export * from './dtos/QueueMessageVariableValues';
 export * from './dtos/NotificationTemplate';
 export * from './dtos/MomentTemplateUpsertRequest';

package/bin/notificationMessages/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./dtos/NotificationQueueMessageRequest"), exports);
 __exportStar(require("./dtos/QueueMessageDestination"), exports);
+__exportStar(require("./dtos/DisputeNotificationData"), exports);
 __exportStar(require("./dtos/QueueMessageVariableValues"), exports);
 __exportStar(require("./dtos/NotificationTemplate"), exports);
 __exportStar(require("./dtos/MomentTemplateUpsertRequest"), exports);

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

@@ -156,6 +156,8 @@ export interface WizardSession {
      * Crédito y derivación se rechazan con `CREDIT_IN_PROGRESS_OTHER_STORE`. Ausente = venta completa.
      */
     cashOnly?: boolean;
+    /** Sesión de apertura de cuenta sin venta; ausente = venta de siempre. */
+    accountOpening?: boolean;
     /** TTL DDB ~24h de inactividad (D14). */
     ttlEpoch: number;
     createdBy: string;

package/bin/retailWizard/dtos/requests/OccupationRequest.d.ts

@@ -8,4 +8,9 @@ export declare class OccupationRequest {
     occupationOther?: string;
     /** Mismo catálogo cerrado que el paso 10 (`ProfileQuestionsRequest`). */
     monthlyIncome: string;
+    /** MXN_* del perfil transaccional: opcionales aquí, la apertura de cuenta los exige en negocio. */
+    monthlyExtraSupport?: string;
+    usageMonthly?: string;
+    maximumTx?: string;
+    beneficialOwner?: string;
 }

package/bin/retailWizard/dtos/requests/OccupationRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const OccupationEnum_1 = require("../../enums/OccupationEnum");
 const monthlyIncome_1 = require("../../catalog/monthlyIncome");
+const ProfileQuestionsRequest_1 = require("./ProfileQuestionsRequest");
 /**
  * POST /wizard/sessions/:id/occupation — registra la ocupación y el ingreso mensual del expediente
  * PCF (viven en People de Fiado — D17). Los dos obligatorios; `OTHER` abre texto ≤60.
@@ -39,3 +40,31 @@ __decorate([
     (0, class_validator_1.IsIn)(monthlyIncome_1.MONTHLY_INCOME_VALUES),
     __metadata("design:type", String)
 ], OccupationRequest.prototype, "monthlyIncome", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(ProfileQuestionsRequest_1.EXTRA_SUPPORT_VALUES),
+    __metadata("design:type", String)
+], OccupationRequest.prototype, "monthlyExtraSupport", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(ProfileQuestionsRequest_1.USAGE_MONTHLY_VALUES),
+    __metadata("design:type", String)
+], OccupationRequest.prototype, "usageMonthly", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(ProfileQuestionsRequest_1.MAXIMUM_TX_VALUES),
+    __metadata("design:type", String)
+], OccupationRequest.prototype, "maximumTx", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(ProfileQuestionsRequest_1.BENEFICIAL_OWNER_VALUES),
+    __metadata("design:type", String)
+], OccupationRequest.prototype, "beneficialOwner", void 0);

package/bin/retailWizard/dtos/requests/StartSessionRequest.d.ts

@@ -7,4 +7,6 @@ export declare class StartSessionRequest {
     phone: string;
     /** Prospecto a reanudar (opcional): si viene, la sesión se vincula al prospecto. */
     prospectId?: string;
+    /** Marca de apertura de cuenta sin venta; ausente = venta de siempre. */
+    accountOpening?: boolean;
 }

package/bin/retailWizard/dtos/requests/StartSessionRequest.js

@@ -33,3 +33,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], StartSessionRequest.prototype, "prospectId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], StartSessionRequest.prototype, "accountOpening", void 0);

package/bin/retailWizard/dtos/responses/BackofficeAccountOpeningsResponse.d.ts

@@ -0,0 +1,19 @@
+/** Una apertura de cuenta sin venta, cerrada en COMPLETED. */
+export interface AccountOpeningRow {
+    sessionId: string;
+    retailCustomerId: string;
+    /** `null` si el cliente no se pudo leer. */
+    name: string | null;
+    phone: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    openedAt: string;
+}
+/**
+ * `GET /backoffice/customers/account-openings?storeId&from&to&limit&nextToken` — sección «Cuentas abiertas
+ * sin compra» de Clientes VL, paginada por fecha de apertura descendente.
+ */
+export interface BackofficeAccountOpeningsResponse {
+    nextToken: string | null;
+    items: AccountOpeningRow[];
+}

package/bin/retailWizard/dtos/responses/BackofficeAccountOpeningsResponse.js

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

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

@@ -2,8 +2,12 @@
  * `cancelReason` que escribe el sistema (no el vendedor).
  * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
  * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ * ALREADY_HAS_ACCOUNT: la apertura de cuenta se cierra porque el cliente ya tiene cuenta PagoConFiado.
+ * CURP_OF_OTHER_CUSTOMER: la apertura de cuenta se cierra porque la CURP ya es de otro cliente.
  */
 export declare enum SystemCancelReasonEnum {
     SWEEP_CREDIT_DISCARDED = "SWEEP_CREDIT_DISCARDED",
-    TAKEN_OVER_BY_OTHER_STORE = "TAKEN_OVER_BY_OTHER_STORE"
+    TAKEN_OVER_BY_OTHER_STORE = "TAKEN_OVER_BY_OTHER_STORE",
+    ALREADY_HAS_ACCOUNT = "ALREADY_HAS_ACCOUNT",
+    CURP_OF_OTHER_CUSTOMER = "CURP_OF_OTHER_CUSTOMER"
 }

package/bin/retailWizard/enums/SystemCancelReasonEnum.js

@@ -5,9 +5,13 @@ exports.SystemCancelReasonEnum = void 0;
  * `cancelReason` que escribe el sistema (no el vendedor).
  * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
  * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ * ALREADY_HAS_ACCOUNT: la apertura de cuenta se cierra porque el cliente ya tiene cuenta PagoConFiado.
+ * CURP_OF_OTHER_CUSTOMER: la apertura de cuenta se cierra porque la CURP ya es de otro cliente.
  */
 var SystemCancelReasonEnum;
 (function (SystemCancelReasonEnum) {
     SystemCancelReasonEnum["SWEEP_CREDIT_DISCARDED"] = "SWEEP_CREDIT_DISCARDED";
     SystemCancelReasonEnum["TAKEN_OVER_BY_OTHER_STORE"] = "TAKEN_OVER_BY_OTHER_STORE";
+    SystemCancelReasonEnum["ALREADY_HAS_ACCOUNT"] = "ALREADY_HAS_ACCOUNT";
+    SystemCancelReasonEnum["CURP_OF_OTHER_CUSTOMER"] = "CURP_OF_OTHER_CUSTOMER";
 })(SystemCancelReasonEnum || (exports.SystemCancelReasonEnum = SystemCancelReasonEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -160,6 +160,7 @@ export * from './dtos/responses/BackofficeSellerKpisResponse';
 export * from './enums/SellerTableSourceStatusEnum';
 export * from './dtos/responses/BackofficeSellerTableResponse';
 export * from './dtos/responses/BackofficeCustomerTableResponse';
+export * from './dtos/responses/BackofficeAccountOpeningsResponse';
 export * from './enums/StoreKindEnum';
 export * from './dtos/responses/BackofficeStoreTableResponse';
 export * from './enums/StoreMixCategoryEnum';

package/bin/retailWizard/index.js

@@ -193,6 +193,7 @@ __exportStar(require("./dtos/responses/BackofficeSellerKpisResponse"), exports);
 __exportStar(require("./enums/SellerTableSourceStatusEnum"), exports);
 __exportStar(require("./dtos/responses/BackofficeSellerTableResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeCustomerTableResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeAccountOpeningsResponse"), exports);
 __exportStar(require("./enums/StoreKindEnum"), exports);
 __exportStar(require("./dtos/responses/BackofficeStoreTableResponse"), exports);
 __exportStar(require("./enums/StoreMixCategoryEnum"), exports);

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

@@ -0,0 +1,32 @@
+import { DisputeRefundSummary } from './DisputeRefundSummary';
+import { R27StatusEnum } from '../enums/R27StatusEnum';
+/**
+ * `data` de GET disputes/transaction/{code}/{transactionNumber} (pública, app).
+ * Devuelve el folio completo (todos los atributos de DisputeOrFraudLog) más los campos
+ * normalizados/enriquecidos que la app necesita para el detalle del movimiento.
+ * Vale desde cualquier movimiento ligado al folio (tx reclamada, abono o reversa).
+ */
+export declare class DisputeGetDetailResponse {
+    id: string;
+    disputeOrFraudFolio: string;
+    directoryId: string;
+    disputeOrFraudStatus: R27StatusEnum;
+    disputeOrFraudStatusUpdate: string;
+    dateOfDisputedTx: string;
+    disputedTxNumber: string;
+    amountOfDisputedTx: number;
+    /** Sentido del dictamen (701-705 improcedente, 706-709 procedente). '' hasta el dictamen. */
+    disputeResolutionCause: string;
+    disputeResolutionDate: string;
+    /** Siempre presente (0 si nunca se reabrió). Botón "segunda revisión": status 102 + causa 701-705 + reopenCount 0. */
+    reopenCount: number;
+    reopenedAt?: string;
+    reopenedReason?: string;
+    refundTransactionId?: string;
+    /** Abono (provisional o por dictamen). */
+    refund?: DisputeRefundSummary;
+    /** Reversa del abono; la fecha del abono original está en `refund.executedAt`. */
+    reversal?: DisputeRefundSummary;
+    /** Resto de atributos del folio (merchant, statusHistory, etc.). */
+    [attribute: string]: unknown;
+}

package/bin/transaction/dtos/DisputeGetDetailResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeGetDetailResponse = void 0;
+/**
+ * `data` de GET disputes/transaction/{code}/{transactionNumber} (pública, app).
+ * Devuelve el folio completo (todos los atributos de DisputeOrFraudLog) más los campos
+ * normalizados/enriquecidos que la app necesita para el detalle del movimiento.
+ * Vale desde cualquier movimiento ligado al folio (tx reclamada, abono o reversa).
+ */
+class DisputeGetDetailResponse {
+}
+exports.DisputeGetDetailResponse = DisputeGetDetailResponse;

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

@@ -0,0 +1,14 @@
+import { DisputeRefundStatus } from '../enums/DisputeRefundStatus';
+import { RefundChannelEnum } from '../enums/RefundChannelEnum';
+/**
+ * Reintegro (abono o reversa) ligado a una reclamación, tal como lo consume la app
+ * en el detalle del movimiento. Resumen de una fila de DisputeRefund_GT.
+ */
+export declare class DisputeRefundSummary {
+    id: string;
+    transactionId?: string;
+    status: DisputeRefundStatus;
+    amount: number;
+    channel?: RefundChannelEnum;
+    executedAt?: string;
+}

package/bin/transaction/dtos/DisputeRefundSummary.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputeRefundSummary = void 0;
+/**
+ * Reintegro (abono o reversa) ligado a una reclamación, tal como lo consume la app
+ * en el detalle del movimiento. Resumen de una fila de DisputeRefund_GT.
+ */
+class DisputeRefundSummary {
+}
+exports.DisputeRefundSummary = DisputeRefundSummary;

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

@@ -0,0 +1,11 @@
+import { R27StatusEnum } from '../enums/R27StatusEnum';
+/**
+ * Evento R27 compacto incluido en las respuestas de disputes-business
+ * (reapertura y firma de dictamen). El Dashboard usa `eventId` como
+ * `folioEventId` al autorizar el reintegro.
+ */
+export declare class R27EventPayload {
+    eventId: string;
+    code: R27StatusEnum;
+    occurredAt: string;
+}

package/bin/transaction/dtos/R27EventPayload.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R27EventPayload = void 0;
+/**
+ * Evento R27 compacto incluido en las respuestas de disputes-business
+ * (reapertura y firma de dictamen). El Dashboard usa `eventId` como
+ * `folioEventId` al autorizar el reintegro.
+ */
+class R27EventPayload {
+}
+exports.R27EventPayload = R27EventPayload;

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

@@ -0,0 +1,12 @@
+/**
+ * Instrucción de reintegro adjunta a la firma del dictamen (UpdateR27StatusRequest.refundInstruction).
+ * Política SP1:
+ *   1 = post-dictamen 2FA (el Dashboard genera la tx antes de cerrar el folio)
+ *   2 = T+2 provisional (ya abonado — se confirma el id existente)
+ *   3 = error operativo (reintegro manual)
+ */
+export declare class RefundInstruction {
+    camino: 1 | 2 | 3;
+    /** Id de la tx de refund en el ledger. Presente cuando el refund ya ocurrió. */
+    refundTransactionId?: string;
+}

package/bin/transaction/dtos/RefundInstruction.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundInstruction = void 0;
+/**
+ * Instrucción de reintegro adjunta a la firma del dictamen (UpdateR27StatusRequest.refundInstruction).
+ * Política SP1:
+ *   1 = post-dictamen 2FA (el Dashboard genera la tx antes de cerrar el folio)
+ *   2 = T+2 provisional (ya abonado — se confirma el id existente)
+ *   3 = error operativo (reintegro manual)
+ */
+class RefundInstruction {
+}
+exports.RefundInstruction = RefundInstruction;

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

@@ -0,0 +1,15 @@
+import { R27EventPayload } from './R27EventPayload';
+/**
+ * Response 200 de la reapertura de reclamación (102 -> 103):
+ * privada POST disputes/{folioId}/reopen (CS/OC) y pública POST disputes/reopen/{folioId} (app).
+ * Idempotente: si el folio ya estaba en 103 con el mismo motivo responde este mismo shape.
+ */
+export declare class ReopenDisputeResponse {
+    success: boolean;
+    folio: string;
+    id: string;
+    currentStatus: number;
+    reopenCount: number;
+    updatedAt: string;
+    lastEvent?: R27EventPayload;
+}

package/bin/transaction/dtos/ReopenDisputeResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReopenDisputeResponse = void 0;
+/**
+ * Response 200 de la reapertura de reclamación (102 -> 103):
+ * privada POST disputes/{folioId}/reopen (CS/OC) y pública POST disputes/reopen/{folioId} (app).
+ * Idempotente: si el folio ya estaba en 103 con el mismo motivo responde este mismo shape.
+ */
+class ReopenDisputeResponse {
+}
+exports.ReopenDisputeResponse = ReopenDisputeResponse;

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

@@ -2,6 +2,7 @@
  * Request del endpoint BO-R27 (cierre de dictamen UNE) en disputes-business.
  * POST disputes/{id}/r27-status — privado (VPC/VPN, sin Cognito).
  */
+import { RefundInstruction } from './RefundInstruction';
 export declare class UpdateR27StatusRequest {
     newR27Status: number;
     resolutionDate: string;
@@ -10,4 +11,6 @@ export declare class UpdateR27StatusRequest {
     signedByName: string;
     dictamenS3Key: string;
     contentHash: string;
+    /** Opcional (backward compat). Sólo se persiste refundTransactionId si resolutionCause ∈ 706-709. */
+    refundInstruction?: RefundInstruction;
 }

package/bin/transaction/dtos/UpdateR27StatusRequest.js

@@ -1,10 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateR27StatusRequest = void 0;
-/**
- * Request del endpoint BO-R27 (cierre de dictamen UNE) en disputes-business.
- * POST disputes/{id}/r27-status — privado (VPC/VPN, sin Cognito).
- */
 class UpdateR27StatusRequest {
 }
 exports.UpdateR27StatusRequest = UpdateR27StatusRequest;

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

@@ -3,6 +3,7 @@
  * mismo valor numerico (101-104): r27Status es el nombre del contrato, mapeado
  * internamente a disputeOrFraudStatus (vocabulario que ya lee la app).
  */
+import { R27EventPayload } from './R27EventPayload';
 export declare class UpdateR27StatusResponse {
     success: boolean;
     folio: string;
@@ -10,4 +11,6 @@ export declare class UpdateR27StatusResponse {
     r27Status: number;
     disputeOrFraudStatus: string;
     updatedAt: string;
+    lastEvent?: R27EventPayload;
+    refundTransactionId?: string;
 }

package/bin/transaction/dtos/UpdateR27StatusResponse.js

@@ -1,11 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateR27StatusResponse = void 0;
-/**
- * Response 200 del endpoint BO-R27. `r27Status` y `disputeOrFraudStatus` son el
- * mismo valor numerico (101-104): r27Status es el nombre del contrato, mapeado
- * internamente a disputeOrFraudStatus (vocabulario que ya lee la app).
- */
 class UpdateR27StatusResponse {
 }
 exports.UpdateR27StatusResponse = UpdateR27StatusResponse;

package/bin/transaction/enums/R27ActorRoleEnum.d.ts

@@ -0,0 +1,8 @@
+/** Rol de quien ejecuta una transición R27 (`statusHistory[].actor.role`). Valores reales en DDB. */
+export declare enum R27ActorRoleEnum {
+    CLIENT = "client",
+    OFICIAL_CUMPLIMIENTO = "oficial_cumplimiento",
+    TITULAR_UNE = "TitularUNE",
+    BACKOFFICE = "BACKOFFICE",
+    SYSTEM = "System"
+}

package/bin/transaction/enums/R27ActorRoleEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R27ActorRoleEnum = void 0;
+/** Rol de quien ejecuta una transición R27 (`statusHistory[].actor.role`). Valores reales en DDB. */
+var R27ActorRoleEnum;
+(function (R27ActorRoleEnum) {
+    R27ActorRoleEnum["CLIENT"] = "client";
+    R27ActorRoleEnum["OFICIAL_CUMPLIMIENTO"] = "oficial_cumplimiento";
+    R27ActorRoleEnum["TITULAR_UNE"] = "TitularUNE";
+    R27ActorRoleEnum["BACKOFFICE"] = "BACKOFFICE";
+    R27ActorRoleEnum["SYSTEM"] = "System";
+})(R27ActorRoleEnum || (exports.R27ActorRoleEnum = R27ActorRoleEnum = {}));

package/bin/transaction/enums/R27StatusEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado R27 (CNBV) de una reclamación. Se persiste como string en
+ * `DisputeOrFraudLog.disputeOrFraudStatus` y en `statusHistory[].code`.
+ *   101 pendiente · 102 1er dictamen · 103 reapertura (máx 1) · 104 2° dictamen (terminal)
+ */
+export declare enum R27StatusEnum {
+    PENDING = "101",
+    RESOLVED = "102",
+    REOPENED = "103",
+    RESOLVED_AFTER_REOPEN = "104"
+}

package/bin/transaction/enums/R27StatusEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R27StatusEnum = void 0;
+/**
+ * Estado R27 (CNBV) de una reclamación. Se persiste como string en
+ * `DisputeOrFraudLog.disputeOrFraudStatus` y en `statusHistory[].code`.
+ *   101 pendiente · 102 1er dictamen · 103 reapertura (máx 1) · 104 2° dictamen (terminal)
+ */
+var R27StatusEnum;
+(function (R27StatusEnum) {
+    R27StatusEnum["PENDING"] = "101";
+    R27StatusEnum["RESOLVED"] = "102";
+    R27StatusEnum["REOPENED"] = "103";
+    R27StatusEnum["RESOLVED_AFTER_REOPEN"] = "104";
+})(R27StatusEnum || (exports.R27StatusEnum = R27StatusEnum = {}));

package/bin/transaction/index.d.ts

@@ -2,6 +2,11 @@ export * from './dtos/CounterQueryResponse';
 export * from './dtos/UpdateR27StatusRequest';
 export * from './dtos/UpdateR27StatusResponse';
 export * from './dtos/ReopenDisputeRequest';
+export * from './dtos/ReopenDisputeResponse';
+export * from './dtos/R27EventPayload';
+export * from './dtos/RefundInstruction';
+export * from './dtos/DisputeRefundSummary';
+export * from './dtos/DisputeGetDetailResponse';
 export * from './dtos/CreateDisputePrivateRequest';
 export * from './dtos/TransactionCreateRequest';
 export * from './dtos/TransactionCreateResponse';
@@ -36,6 +41,8 @@ export * from './enums/TransactionSourceEnum';
 export * from './enums/TransactionStatusEnum';
 export * from './enums/DisputeOrFraudEnum';
 export * from './enums/DisputeOrFraudStatusEnum';
+export * from './enums/R27StatusEnum';
+export * from './enums/R27ActorRoleEnum';
 export * from './enums/ActivityProblemStatusEnum';
 export * from './enums/RefundChannelEnum';
 export * from './enums/RefundPathTypeEnum';

package/bin/transaction/index.js

@@ -19,6 +19,11 @@ __exportStar(require("./dtos/CounterQueryResponse"), exports);
 __exportStar(require("./dtos/UpdateR27StatusRequest"), exports);
 __exportStar(require("./dtos/UpdateR27StatusResponse"), exports);
 __exportStar(require("./dtos/ReopenDisputeRequest"), exports);
+__exportStar(require("./dtos/ReopenDisputeResponse"), exports);
+__exportStar(require("./dtos/R27EventPayload"), exports);
+__exportStar(require("./dtos/RefundInstruction"), exports);
+__exportStar(require("./dtos/DisputeRefundSummary"), exports);
+__exportStar(require("./dtos/DisputeGetDetailResponse"), exports);
 __exportStar(require("./dtos/CreateDisputePrivateRequest"), exports);
 __exportStar(require("./dtos/TransactionCreateRequest"), exports);
 __exportStar(require("./dtos/TransactionCreateResponse"), exports);
@@ -54,6 +59,8 @@ __exportStar(require("./enums/TransactionSourceEnum"), exports);
 __exportStar(require("./enums/TransactionStatusEnum"), exports);
 __exportStar(require("./enums/DisputeOrFraudEnum"), exports);
 __exportStar(require("./enums/DisputeOrFraudStatusEnum"), exports);
+__exportStar(require("./enums/R27StatusEnum"), exports);
+__exportStar(require("./enums/R27ActorRoleEnum"), exports);
 __exportStar(require("./enums/ActivityProblemStatusEnum"), exports);
 __exportStar(require("./enums/RefundChannelEnum"), exports);
 __exportStar(require("./enums/RefundPathTypeEnum"), exports);

package/package.json

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

package/src/notificationMessages/dtos/DisputeNotificationData.ts

@@ -0,0 +1,9 @@
+/**
+ * `destinations[].data` de los pushes DISPUTE_* (dictamen, reapertura, 2° dictamen).
+ * La app lo usa para saber de qué folio es el push: recargar el detalle o abrir la ficha.
+ */
+export class DisputeNotificationData {
+    id: string;        // templateId (DISPUTE_DICTAMEN_PROCEDENTE, DISPUTE_REOPEN_CONFIRMED, ...)
+    folio: string;     // disputeOrFraudFolio
+    folioId?: string;  // id del folio en DisputeOrFraudLog
+}

package/src/notificationMessages/index.ts

@@ -1,5 +1,6 @@
 export * from './dtos/NotificationQueueMessageRequest';
 export * from './dtos/QueueMessageDestination';
+export * from './dtos/DisputeNotificationData';
 export * from './dtos/QueueMessageVariableValues';
 export * from './dtos/NotificationTemplate';
 export * from './dtos/MomentTemplateUpsertRequest';

package/src/retailWizard/dtos/WizardSession.ts

@@ -160,6 +160,8 @@ export interface WizardSession {
    * Crédito y derivación se rechazan con `CREDIT_IN_PROGRESS_OTHER_STORE`. Ausente = venta completa.
    */
   cashOnly?: boolean;
+  /** Sesión de apertura de cuenta sin venta; ausente = venta de siempre. */
+  accountOpening?: boolean;
   /** TTL DDB ~24h de inactividad (D14). */
   ttlEpoch: number;
   createdBy: string;

package/src/retailWizard/dtos/requests/OccupationRequest.ts

@@ -2,6 +2,12 @@ import { Expose } from 'class-transformer';
 import { IsEnum, IsIn, IsOptional, IsString, MaxLength } from 'class-validator';
 import { OccupationEnum } from '../../enums/OccupationEnum';
 import { MONTHLY_INCOME_VALUES } from '../../catalog/monthlyIncome';
+import {
+  BENEFICIAL_OWNER_VALUES,
+  EXTRA_SUPPORT_VALUES,
+  MAXIMUM_TX_VALUES,
+  USAGE_MONTHLY_VALUES,
+} from './ProfileQuestionsRequest';
 
 /**
  * POST /wizard/sessions/:id/occupation — registra la ocupación y el ingreso mensual del expediente
@@ -23,4 +29,29 @@ export class OccupationRequest {
   @IsString()
   @IsIn(MONTHLY_INCOME_VALUES as unknown as string[])
   monthlyIncome!: string;
+
+  /** MXN_* del perfil transaccional: opcionales aquí, la apertura de cuenta los exige en negocio. */
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsIn(EXTRA_SUPPORT_VALUES as unknown as string[])
+  monthlyExtraSupport?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsIn(USAGE_MONTHLY_VALUES as unknown as string[])
+  usageMonthly?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsIn(MAXIMUM_TX_VALUES as unknown as string[])
+  maximumTx?: string;
+
+  @Expose()
+  @IsOptional()
+  @IsString()
+  @IsIn(BENEFICIAL_OWNER_VALUES as unknown as string[])
+  beneficialOwner?: string;
 }

package/src/retailWizard/dtos/requests/StartSessionRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsOptional, IsString, Matches } from 'class-validator';
+import { IsBoolean, IsOptional, IsString, Matches } from 'class-validator';
 import { regexPhoneMx } from '../../../helpers/constans/regex';
 
 /**
@@ -18,4 +18,10 @@ export class StartSessionRequest {
   @IsOptional()
   @IsString()
   prospectId?: string;
+
+  /** Marca de apertura de cuenta sin venta; ausente = venta de siempre. */
+  @Expose()
+  @IsOptional()
+  @IsBoolean()
+  accountOpening?: boolean;
 }

package/src/retailWizard/dtos/responses/BackofficeAccountOpeningsResponse.ts

@@ -0,0 +1,20 @@
+/** Una apertura de cuenta sin venta, cerrada en COMPLETED. */
+export interface AccountOpeningRow {
+    sessionId: string;
+    retailCustomerId: string;
+    /** `null` si el cliente no se pudo leer. */
+    name: string | null;
+    phone: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    openedAt: string;
+}
+
+/**
+ * `GET /backoffice/customers/account-openings?storeId&from&to&limit&nextToken` — sección «Cuentas abiertas
+ * sin compra» de Clientes VL, paginada por fecha de apertura descendente.
+ */
+export interface BackofficeAccountOpeningsResponse {
+    nextToken: string | null;
+    items: AccountOpeningRow[];
+}

package/src/retailWizard/enums/SystemCancelReasonEnum.ts

@@ -2,8 +2,12 @@
  * `cancelReason` que escribe el sistema (no el vendedor).
  * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
  * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ * ALREADY_HAS_ACCOUNT: la apertura de cuenta se cierra porque el cliente ya tiene cuenta PagoConFiado.
+ * CURP_OF_OTHER_CUSTOMER: la apertura de cuenta se cierra porque la CURP ya es de otro cliente.
  */
 export enum SystemCancelReasonEnum {
     SWEEP_CREDIT_DISCARDED = 'SWEEP_CREDIT_DISCARDED',
     TAKEN_OVER_BY_OTHER_STORE = 'TAKEN_OVER_BY_OTHER_STORE',
+    ALREADY_HAS_ACCOUNT = 'ALREADY_HAS_ACCOUNT',
+    CURP_OF_OTHER_CUSTOMER = 'CURP_OF_OTHER_CUSTOMER',
 }

package/src/retailWizard/index.ts

@@ -185,6 +185,7 @@ export * from './dtos/responses/BackofficeSellerKpisResponse';
 export * from './enums/SellerTableSourceStatusEnum';
 export * from './dtos/responses/BackofficeSellerTableResponse';
 export * from './dtos/responses/BackofficeCustomerTableResponse';
+export * from './dtos/responses/BackofficeAccountOpeningsResponse';
 export * from './enums/StoreKindEnum';
 export * from './dtos/responses/BackofficeStoreTableResponse';
 export * from './enums/StoreMixCategoryEnum';

package/src/transaction/dtos/DisputeGetDetailResponse.ts

@@ -0,0 +1,33 @@
+import { DisputeRefundSummary } from './DisputeRefundSummary';
+import { R27StatusEnum } from '../enums/R27StatusEnum';
+
+/**
+ * `data` de GET disputes/transaction/{code}/{transactionNumber} (pública, app).
+ * Devuelve el folio completo (todos los atributos de DisputeOrFraudLog) más los campos
+ * normalizados/enriquecidos que la app necesita para el detalle del movimiento.
+ * Vale desde cualquier movimiento ligado al folio (tx reclamada, abono o reversa).
+ */
+export class DisputeGetDetailResponse {
+    id: string;
+    disputeOrFraudFolio: string;
+    directoryId: string;
+    disputeOrFraudStatus: R27StatusEnum;
+    disputeOrFraudStatusUpdate: string;
+    dateOfDisputedTx: string;
+    disputedTxNumber: string;
+    amountOfDisputedTx: number;
+    /** Sentido del dictamen (701-705 improcedente, 706-709 procedente). '' hasta el dictamen. */
+    disputeResolutionCause: string;
+    disputeResolutionDate: string;
+    /** Siempre presente (0 si nunca se reabrió). Botón "segunda revisión": status 102 + causa 701-705 + reopenCount 0. */
+    reopenCount: number;
+    reopenedAt?: string;
+    reopenedReason?: string;
+    refundTransactionId?: string;
+    /** Abono (provisional o por dictamen). */
+    refund?: DisputeRefundSummary;
+    /** Reversa del abono; la fecha del abono original está en `refund.executedAt`. */
+    reversal?: DisputeRefundSummary;
+    /** Resto de atributos del folio (merchant, statusHistory, etc.). */
+    [attribute: string]: unknown;
+}

package/src/transaction/dtos/DisputeRefundSummary.ts

@@ -0,0 +1,15 @@
+import { DisputeRefundStatus } from '../enums/DisputeRefundStatus';
+import { RefundChannelEnum } from '../enums/RefundChannelEnum';
+
+/**
+ * Reintegro (abono o reversa) ligado a una reclamación, tal como lo consume la app
+ * en el detalle del movimiento. Resumen de una fila de DisputeRefund_GT.
+ */
+export class DisputeRefundSummary {
+    id: string;
+    transactionId?: string;        // id de la tx en PagoConfiadoTx_GT
+    status: DisputeRefundStatus;
+    amount: number;
+    channel?: RefundChannelEnum;
+    executedAt?: string;           // ISO — fecha del abono / de la reversa
+}

package/src/transaction/dtos/R27EventPayload.ts

@@ -0,0 +1,12 @@
+import { R27StatusEnum } from '../enums/R27StatusEnum';
+
+/**
+ * Evento R27 compacto incluido en las respuestas de disputes-business
+ * (reapertura y firma de dictamen). El Dashboard usa `eventId` como
+ * `folioEventId` al autorizar el reintegro.
+ */
+export class R27EventPayload {
+    eventId: string;
+    code: R27StatusEnum;
+    occurredAt: string;
+}

package/src/transaction/dtos/RefundInstruction.ts

@@ -0,0 +1,12 @@
+/**
+ * Instrucción de reintegro adjunta a la firma del dictamen (UpdateR27StatusRequest.refundInstruction).
+ * Política SP1:
+ *   1 = post-dictamen 2FA (el Dashboard genera la tx antes de cerrar el folio)
+ *   2 = T+2 provisional (ya abonado — se confirma el id existente)
+ *   3 = error operativo (reintegro manual)
+ */
+export class RefundInstruction {
+    camino: 1 | 2 | 3;
+    /** Id de la tx de refund en el ledger. Presente cuando el refund ya ocurrió. */
+    refundTransactionId?: string;
+}

package/src/transaction/dtos/ReopenDisputeResponse.ts

@@ -0,0 +1,16 @@
+import { R27EventPayload } from './R27EventPayload';
+
+/**
+ * Response 200 de la reapertura de reclamación (102 -> 103):
+ * privada POST disputes/{folioId}/reopen (CS/OC) y pública POST disputes/reopen/{folioId} (app).
+ * Idempotente: si el folio ya estaba en 103 con el mismo motivo responde este mismo shape.
+ */
+export class ReopenDisputeResponse {
+    success: boolean;
+    folio: string;
+    id: string;
+    currentStatus: number;      // 103
+    reopenCount: number;        // 1
+    updatedAt: string;          // ISO
+    lastEvent?: R27EventPayload; // ausente en folios legacy sin statusHistory
+}

package/src/transaction/dtos/UpdateR27StatusRequest.ts

@@ -2,6 +2,8 @@
  * Request del endpoint BO-R27 (cierre de dictamen UNE) en disputes-business.
  * POST disputes/{id}/r27-status — privado (VPC/VPN, sin Cognito).
  */
+import { RefundInstruction } from './RefundInstruction';
+
 export class UpdateR27StatusRequest {
     newR27Status: number;     // 102 | 104
     resolutionDate: string;   // ISO datetime, <= ahora
@@ -10,4 +12,6 @@ export class UpdateR27StatusRequest {
     signedByName: string;
     dictamenS3Key: string;    // path en fiado-prod-data-lake
     contentHash: string;      // sha256:...
+    /** Opcional (backward compat). Sólo se persiste refundTransactionId si resolutionCause ∈ 706-709. */
+    refundInstruction?: RefundInstruction;
 }

package/src/transaction/dtos/UpdateR27StatusResponse.ts

@@ -3,6 +3,8 @@
  * mismo valor numerico (101-104): r27Status es el nombre del contrato, mapeado
  * internamente a disputeOrFraudStatus (vocabulario que ya lee la app).
  */
+import { R27EventPayload } from './R27EventPayload';
+
 export class UpdateR27StatusResponse {
     success: boolean;
     folio: string;
@@ -10,4 +12,6 @@ export class UpdateR27StatusResponse {
     r27Status: number;
     disputeOrFraudStatus: string;
     updatedAt: string;
+    lastEvent?: R27EventPayload;     // evento 102/104 recién agregado a statusHistory
+    refundTransactionId?: string;    // sólo cierres procedentes con refund ligado
 }

package/src/transaction/enums/R27ActorRoleEnum.ts

@@ -0,0 +1,8 @@
+/** Rol de quien ejecuta una transición R27 (`statusHistory[].actor.role`). Valores reales en DDB. */
+export enum R27ActorRoleEnum {
+    CLIENT = "client",
+    OFICIAL_CUMPLIMIENTO = "oficial_cumplimiento",
+    TITULAR_UNE = "TitularUNE",
+    BACKOFFICE = "BACKOFFICE",
+    SYSTEM = "System",
+}

package/src/transaction/enums/R27StatusEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado R27 (CNBV) de una reclamación. Se persiste como string en
+ * `DisputeOrFraudLog.disputeOrFraudStatus` y en `statusHistory[].code`.
+ *   101 pendiente · 102 1er dictamen · 103 reapertura (máx 1) · 104 2° dictamen (terminal)
+ */
+export enum R27StatusEnum {
+    PENDING = "101",
+    RESOLVED = "102",
+    REOPENED = "103",
+    RESOLVED_AFTER_REOPEN = "104",
+}

package/src/transaction/index.ts

@@ -3,6 +3,11 @@ export * from './dtos/CounterQueryResponse';
 export * from './dtos/UpdateR27StatusRequest';
 export * from './dtos/UpdateR27StatusResponse';
 export * from './dtos/ReopenDisputeRequest';
+export * from './dtos/ReopenDisputeResponse';
+export * from './dtos/R27EventPayload';
+export * from './dtos/RefundInstruction';
+export * from './dtos/DisputeRefundSummary';
+export * from './dtos/DisputeGetDetailResponse';
 export * from './dtos/CreateDisputePrivateRequest';
 export * from './dtos/TransactionCreateRequest';
 export * from './dtos/TransactionCreateResponse';
@@ -41,6 +46,8 @@ export * from './enums/TransactionSourceEnum';
 export * from './enums/TransactionStatusEnum';
 export * from './enums/DisputeOrFraudEnum';
 export * from './enums/DisputeOrFraudStatusEnum';
+export * from './enums/R27StatusEnum';
+export * from './enums/R27ActorRoleEnum';
 export * from './enums/ActivityProblemStatusEnum';
 export * from './enums/RefundChannelEnum';
 export * from './enums/RefundPathTypeEnum';