@fiado/type-kit 3.443.0 → 3.445.0

package/_test_/unit/productCatalog/enums/refund-product-enums.test.ts

@@ -0,0 +1,18 @@
+import 'reflect-metadata';
+import { ProductTypeEnum } from '../../../../src/productCatalog/enums/ProductTypeEnum';
+import { ProductSubtypeEnum } from '../../../../src/productCatalog/enums/ProductSubtypeEnum';
+
+describe('Enums refund PCF', () => {
+  it('agrega REFUND_PCF y REFUND_PCF_REVERSE a ProductTypeEnum', () => {
+    expect(ProductTypeEnum.REFUND_PCF).toBe('REFUND_PCF');
+    expect(ProductTypeEnum.REFUND_PCF_REVERSE).toBe('REFUND_PCF_REVERSE');
+  });
+  it('agrega los 6 subtypes de refund', () => {
+    expect(ProductSubtypeEnum.REFUND_PCF_DICTAMEN_PROCEDE).toBe('DICTAMEN_PROCEDE');
+    expect(ProductSubtypeEnum.REFUND_PCF_AUTO_T2_SIN_2FA).toBe('AUTO_T2_SIN_2FA');
+    expect(ProductSubtypeEnum.REFUND_PCF_ERROR_OPERATIVO).toBe('ERROR_OPERATIVO');
+    expect(ProductSubtypeEnum.REFUND_PCF_DOMICILIACION_T1_60D).toBe('DOMICILIACION_T1_60D');
+    expect(ProductSubtypeEnum.REFUND_PCF_DOMICILIACION_T1_61_90D).toBe('DOMICILIACION_T1_61_90D');
+    expect(ProductSubtypeEnum.REFUND_PCF_REVERSE_DICTAMEN_CON_2FA_TARDIO).toBe('DICTAMEN_CON_2FA_TARDIO');
+  });
+});

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

@@ -0,0 +1,15 @@
+import 'reflect-metadata';
+import { RefundChannelEnum } from '../../../src/transaction';
+
+describe('RefundChannelEnum', () => {
+  it('expone INTERNAL_PCF y SPEI_OUT_MANUAL', () => {
+    expect(RefundChannelEnum.INTERNAL_PCF).toBe('INTERNAL_PCF');
+    expect(RefundChannelEnum.SPEI_OUT_MANUAL).toBe('SPEI_OUT_MANUAL');
+  });
+
+  it('no tiene valores de más', () => {
+    expect(Object.values(RefundChannelEnum).sort()).toEqual(
+      ['INTERNAL_PCF', 'SPEI_OUT_MANUAL'].sort()
+    );
+  });
+});

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

@@ -0,0 +1,16 @@
+import 'reflect-metadata';
+import { RefundManualExecutionStatus } from '../../../src/transaction';
+
+describe('RefundManualExecutionStatus', () => {
+  it('expone PENDING_MANUAL_EXECUTION, EXECUTED, CANCELLED', () => {
+    expect(RefundManualExecutionStatus.PENDING_MANUAL_EXECUTION).toBe('PENDING_MANUAL_EXECUTION');
+    expect(RefundManualExecutionStatus.EXECUTED).toBe('EXECUTED');
+    expect(RefundManualExecutionStatus.CANCELLED).toBe('CANCELLED');
+  });
+
+  it('no tiene valores de más', () => {
+    expect(Object.values(RefundManualExecutionStatus).sort()).toEqual(
+      ['PENDING_MANUAL_EXECUTION', 'EXECUTED', 'CANCELLED'].sort()
+    );
+  });
+});

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

@@ -0,0 +1,18 @@
+import 'reflect-metadata';
+import { RefundPathTypeEnum } from '../../../src/transaction';
+
+describe('RefundPathTypeEnum', () => {
+  it('expone las 5 rutas de reintegro definidas en SP1', () => {
+    expect(RefundPathTypeEnum.DICTAMEN_PROCEDE).toBe('DICTAMEN_PROCEDE');
+    expect(RefundPathTypeEnum.AUTO_T2_SIN_2FA).toBe('AUTO_T2_SIN_2FA');
+    expect(RefundPathTypeEnum.ERROR_OPERATIVO).toBe('ERROR_OPERATIVO');
+    expect(RefundPathTypeEnum.DOMICILIACION_T1_60D).toBe('DOMICILIACION_T1_60D');
+    expect(RefundPathTypeEnum.DOMICILIACION_T1_61_90D).toBe('DOMICILIACION_T1_61_90D');
+  });
+
+  it('no tiene valores de más', () => {
+    expect(Object.values(RefundPathTypeEnum).sort()).toEqual(
+      ['DICTAMEN_PROCEDE', 'AUTO_T2_SIN_2FA', 'ERROR_OPERATIVO', 'DOMICILIACION_T1_60D', 'DOMICILIACION_T1_61_90D'].sort()
+    );
+  });
+});

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

@@ -0,0 +1,78 @@
+import 'reflect-metadata';
+import { AuthorizeRefundRequest, ReverseRefundRequest, ConfirmManualExecutionRequest } from '../../../src/transaction';
+import { RefundChannelEnum, RefundPathTypeEnum } from '../../../src/transaction';
+
+describe('Refund DTOs', () => {
+  it('importa AuthorizeRefundRequest, ReverseRefundRequest, ConfirmManualExecutionRequest', () => {
+    // AuthorizeRefundRequest
+    const authRequest: AuthorizeRefundRequest = {
+      idempotencyKey: 'key-123',
+      directoryId: 'dir-456',
+      peopleId: 'person-789',
+      productCatalogId: 'MEX_REFUND_PCF',
+      operation: 'ADD',
+      amount: { total: 1000, currencyId: 'MXN' },
+      refundChannel: RefundChannelEnum.SPEI_OUT_MANUAL,
+      refundChannelData: {
+        targetClabe: '012180001232011635',
+        targetBankId: 'BBVAMXMM',
+        targetName: 'Beneficiario',
+      },
+      refundCase: {
+        pathType: RefundPathTypeEnum.DICTAMEN_PROCEDE,
+        caseFolio: 'FOLIO-001',
+        originalTransactionId: 'TX-123',
+        originalAmount: 1000,
+        originalChannel: 'SPEI_IN',
+      },
+      approval: {
+        makerUserId: 'user-maker-001',
+        checkerUserId: 'user-checker-001',
+        minuteS3Key: 's3://bucket/minute.pdf',
+      },
+      reason: 'Restitución por solicitud del cliente',
+      evidence: {
+        dictamenS3Key: 's3://bucket/dictamen.pdf',
+        incidentReportS3Key: 's3://bucket/incident.pdf',
+        objectionFormS3Key: null,
+      },
+      pldOverrideMinuteS3Key: null,
+    };
+    expect(authRequest.idempotencyKey).toBe('key-123');
+    expect(authRequest.refundChannel).toBe(RefundChannelEnum.SPEI_OUT_MANUAL);
+
+    // ReverseRefundRequest
+    const reverseRequest: ReverseRefundRequest = {
+      idempotencyKey: 'key-456',
+      directoryId: 'dir-456',
+      peopleId: 'person-789',
+      productCatalogId: 'MEX_REFUND_PCF_REVERSE',
+      operation: 'DEBIT',
+      originalRefundTransactionId: 'REFUND-TX-123',
+      originalIdempotencyKey: 'key-123',
+      amount: { total: 1000, currencyId: 'MXN' },
+      reverseReason: {
+        type: 'DICTAMEN_CON_2FA_TARDIO',
+        resolutionS3Key: 's3://bucket/resolution.pdf',
+        dictamenS3Key: 's3://bucket/dictamen-new.pdf',
+      },
+      approval: {
+        makerUserId: 'user-maker-002',
+        checkerUserId: 'user-checker-002',
+      },
+    };
+    expect(reverseRequest.originalRefundTransactionId).toBe('REFUND-TX-123');
+    expect(reverseRequest.reverseReason.type).toBe('DICTAMEN_CON_2FA_TARDIO');
+
+    // ConfirmManualExecutionRequest
+    const confirmRequest: ConfirmManualExecutionRequest = {
+      idempotencyKey: 'key-789',
+      speiTrackingKey: 'SPE-TRACK-001',
+      executedAt: '2026-09-17T22:00:00Z',
+      acuseS3Key: 's3://bucket/acuse.pdf',
+      executedByUserId: 'user-controller-001',
+    };
+    expect(confirmRequest.speiTrackingKey).toBe('SPE-TRACK-001');
+    expect(confirmRequest.executedAt).toBe('2026-09-17T22:00:00Z');
+  });
+});

package/bin/phoneSales/SaleDeliveryData.d.ts

@@ -0,0 +1,24 @@
+export type PickupLocationType = 'FIADO_STORE' | 'CARRIER_OFFICE';
+export interface FiadoStorePickupData {
+    pickupLocationType: 'FIADO_STORE';
+    storeId: string;
+}
+export interface CarrierOfficePickupData {
+    pickupLocationType: 'CARRIER_OFFICE';
+    carrierOfficeCode: string;
+    latitude: number;
+    longitude: number;
+    recipientName: string;
+    recipientPhone: string;
+}
+export type PickupDeliveryData = FiadoStorePickupData | CarrierOfficePickupData;
+export interface HomeDeliveryData {
+    street: string;
+    addressNumber: string;
+    neighborhood: string;
+    municipality: string;
+    region: string;
+    postalCode: string;
+    recipientName: string;
+    recipientPhone: string;
+}

package/bin/phoneSales/SaleDeliveryData.js

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

package/bin/phoneSales/SaleResponseDto.d.ts

@@ -1,4 +1,5 @@
 import { CurrencyId } from '../currency';
+import { PickupDeliveryData, HomeDeliveryData } from './SaleDeliveryData';
 export declare class SaleResponseDto {
     id: string;
     referenceCode: string;
@@ -6,9 +7,41 @@ export declare class SaleResponseDto {
     buyerDirectorId: string;
     newAccountDirectorId: string | null;
     deliveryType: 'PICKUP' | 'HOME';
+    /**
+     * Dónde había que entregar el dispositivo (retiro en tienda/oficina, u domicilio) —
+     * discriminado por `deliveryType`. Requerido porque `Sale_GT` lo requiere desde que existe la
+     * tabla; ventas con el objeto vacío son datos corruptos de un bug de persistencia ya corregido
+     * (ver memoria `patron-dynamoose-saveunknown-object-anidado`), no un estado válido del contrato.
+     */
+    deliveryData: PickupDeliveryData | HomeDeliveryData;
     trackingCode: string | null;
     providerStatus: string | null;
+    /**
+     * Detalle textual del status reportado por el proveedor de envío (ej. "en camino a sucursal
+     * destino") — DISTINTO de `providerStatus` (arriba), que es el código/estado corto. `null`
+     * porque el conector no siempre lo trae (eventos tempranos del envío).
+     */
+    providerStatusDetail: string | null;
+    /**
+     * Número de rastreo real que ve el comprador — DISTINTO de `trackingCode` (arriba, que es el ID
+     * de correlación interno asignado al CREAR el envío). Este es el que soporte le pasa al
+     * cliente cuando reclama. `null` porque el conector no siempre lo trae.
+     */
+    trackingNumber: string | null;
+    /** URL pública de rastreo del proveedor — mismo motivo de nullability que `trackingNumber`. */
+    trackingUrl: string | null;
+    /** Qué transportadora gestiona el envío — relevante para cuando haya más de un proveedor. */
+    shippingProviderId: string;
+    /**
+     * ID del cobro en transaction-processor-business — el puente para investigar una reclamación de
+     * pago sin buscar a mano en logs por `buyerDirectorId` + ventana de tiempo.
+     */
+    paymentId: string;
     status: string;
+    /** Fecha de compra (epoch ms) — el dato base de cualquier investigación de reclamación. */
+    createdAt: number;
+    /** Última modificación de la venta (epoch ms). */
+    updatedAt: number;
     /**
      * Modelo de la variante (resuelto server-side por `variantId`, incluyendo variantes con
      * stock=0). `null` si la resolución falló (variante borrada o error de infraestructura) — ver

package/bin/phoneSales/index.d.ts

@@ -4,6 +4,7 @@ export * from './CreateDeviceVariantRequestDto';
 export * from './UpdateDeviceVariantRequestDto';
 export * from './CreateSaleRequestDto';
 export * from './SaleResponseDto';
+export * from './SaleDeliveryData';
 export * from './RedeemSaleCodeRequestDto';
 export * from './DeviceVariantImageUploadUrlRequestDto';
 export * from './DeviceVariantImageUploadUrlResponseDto';

package/bin/phoneSales/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./CreateDeviceVariantRequestDto"), exports);
 __exportStar(require("./UpdateDeviceVariantRequestDto"), exports);
 __exportStar(require("./CreateSaleRequestDto"), exports);
 __exportStar(require("./SaleResponseDto"), exports);
+__exportStar(require("./SaleDeliveryData"), exports);
 __exportStar(require("./RedeemSaleCodeRequestDto"), exports);
 __exportStar(require("./DeviceVariantImageUploadUrlRequestDto"), exports);
 __exportStar(require("./DeviceVariantImageUploadUrlResponseDto"), exports);

package/bin/productCatalog/enums/ProductSubtypeEnum.d.ts

@@ -59,5 +59,11 @@ export declare enum ProductSubtypeEnum {
      */
     SP_CASH_IN_CASH_IN_OXXO = "CASH_IN_OXXO",
     SUREKEEP_BONUS_MX = "BONUS_MX",
-    STORE_PHONE = "PHONE"
+    STORE_PHONE = "PHONE",
+    REFUND_PCF_DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
+    REFUND_PCF_AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",
+    REFUND_PCF_ERROR_OPERATIVO = "ERROR_OPERATIVO",
+    REFUND_PCF_DOMICILIACION_T1_60D = "DOMICILIACION_T1_60D",
+    REFUND_PCF_DOMICILIACION_T1_61_90D = "DOMICILIACION_T1_61_90D",
+    REFUND_PCF_REVERSE_DICTAMEN_CON_2FA_TARDIO = "DICTAMEN_CON_2FA_TARDIO"
 }

package/bin/productCatalog/enums/ProductSubtypeEnum.js

@@ -77,4 +77,12 @@ var ProductSubtypeEnum;
     ProductSubtypeEnum["SUREKEEP_BONUS_MX"] = "BONUS_MX";
     //STORE
     ProductSubtypeEnum["STORE_PHONE"] = "PHONE";
+    // REFUND_PCF
+    ProductSubtypeEnum["REFUND_PCF_DICTAMEN_PROCEDE"] = "DICTAMEN_PROCEDE";
+    ProductSubtypeEnum["REFUND_PCF_AUTO_T2_SIN_2FA"] = "AUTO_T2_SIN_2FA";
+    ProductSubtypeEnum["REFUND_PCF_ERROR_OPERATIVO"] = "ERROR_OPERATIVO";
+    ProductSubtypeEnum["REFUND_PCF_DOMICILIACION_T1_60D"] = "DOMICILIACION_T1_60D";
+    ProductSubtypeEnum["REFUND_PCF_DOMICILIACION_T1_61_90D"] = "DOMICILIACION_T1_61_90D";
+    // REFUND_PCF_REVERSE
+    ProductSubtypeEnum["REFUND_PCF_REVERSE_DICTAMEN_CON_2FA_TARDIO"] = "DICTAMEN_CON_2FA_TARDIO";
 })(ProductSubtypeEnum || (exports.ProductSubtypeEnum = ProductSubtypeEnum = {}));

package/bin/productCatalog/enums/ProductTypeEnum.d.ts

@@ -48,5 +48,15 @@ export declare enum ProductTypeEnum {
      * `CreateTransactionManager` (no está en su switch), que ya arma `credit`/`debit` de forma
      * data-driven por monto, no por este type.
      */
-    STORE = "STORE"
+    STORE = "STORE",
+    /**
+     * Reembolso a cliente PCF — transacción iniciada desde dashboard de reclamaciones.
+     * Tipología: transfer SPEI out manual con aprobación de maker/checker.
+     */
+    REFUND_PCF = "REFUND_PCF",
+    /**
+     * Reversa de un reembolso anterior — se devuelve el dinero del reembolso al cliente
+     * cuando el dictamen fue incorrecto o se detectó fraude post-reembolso.
+     */
+    REFUND_PCF_REVERSE = "REFUND_PCF_REVERSE"
 }

package/bin/productCatalog/enums/ProductTypeEnum.js

@@ -53,4 +53,14 @@ var ProductTypeEnum;
      * data-driven por monto, no por este type.
      */
     ProductTypeEnum["STORE"] = "STORE";
+    /**
+     * Reembolso a cliente PCF — transacción iniciada desde dashboard de reclamaciones.
+     * Tipología: transfer SPEI out manual con aprobación de maker/checker.
+     */
+    ProductTypeEnum["REFUND_PCF"] = "REFUND_PCF";
+    /**
+     * Reversa de un reembolso anterior — se devuelve el dinero del reembolso al cliente
+     * cuando el dictamen fue incorrecto o se detectó fraude post-reembolso.
+     */
+    ProductTypeEnum["REFUND_PCF_REVERSE"] = "REFUND_PCF_REVERSE";
 })(ProductTypeEnum || (exports.ProductTypeEnum = ProductTypeEnum = {}));

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

@@ -0,0 +1,38 @@
+import { RefundChannelEnum } from '../enums/RefundChannelEnum';
+import { RefundPathTypeEnum } from '../enums/RefundPathTypeEnum';
+export interface AuthorizeRefundRequest {
+    idempotencyKey: string;
+    directoryId: string;
+    peopleId: string;
+    productCatalogId: 'MEX_REFUND_PCF';
+    operation: 'ADD';
+    amount: {
+        total: number;
+        currencyId: 'MXN';
+    };
+    refundChannel: RefundChannelEnum;
+    refundChannelData?: {
+        targetClabe?: string;
+        targetBankId?: string;
+        targetName?: string;
+    };
+    refundCase: {
+        pathType: RefundPathTypeEnum;
+        caseFolio: string;
+        originalTransactionId: string | null;
+        originalAmount: number;
+        originalChannel: 'PCF_P2P' | 'SPEI_IN' | 'SPEI_OUT' | 'CARD' | 'DOMICILIATION_FSA';
+    };
+    approval: {
+        makerUserId: string;
+        checkerUserId: string | null;
+        minuteS3Key: string | null;
+    };
+    reason: string;
+    evidence: {
+        dictamenS3Key: string | null;
+        incidentReportS3Key: string | null;
+        objectionFormS3Key: string | null;
+    };
+    pldOverrideMinuteS3Key: string | null;
+}

package/bin/transaction/dtos/AuthorizeRefundRequest.js

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

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

@@ -0,0 +1,7 @@
+export interface ConfirmManualExecutionRequest {
+    idempotencyKey: string;
+    speiTrackingKey: string;
+    executedAt: string;
+    acuseS3Key: string;
+    executedByUserId: string;
+}

package/bin/transaction/dtos/ConfirmManualExecutionRequest.js

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

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

@@ -0,0 +1,22 @@
+export interface ReverseRefundRequest {
+    idempotencyKey: string;
+    directoryId: string;
+    peopleId: string;
+    productCatalogId: 'MEX_REFUND_PCF_REVERSE';
+    operation: 'DEBIT';
+    originalRefundTransactionId: string;
+    originalIdempotencyKey: string;
+    amount: {
+        total: number;
+        currencyId: 'MXN';
+    };
+    reverseReason: {
+        type: 'DICTAMEN_CON_2FA_TARDIO';
+        resolutionS3Key: string;
+        dictamenS3Key: string;
+    };
+    approval: {
+        makerUserId: string;
+        checkerUserId: string | null;
+    };
+}

package/bin/transaction/dtos/ReverseRefundRequest.js

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

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

@@ -0,0 +1,4 @@
+export declare enum RefundChannelEnum {
+    INTERNAL_PCF = "INTERNAL_PCF",
+    SPEI_OUT_MANUAL = "SPEI_OUT_MANUAL"
+}

package/bin/transaction/enums/RefundChannelEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundChannelEnum = void 0;
+var RefundChannelEnum;
+(function (RefundChannelEnum) {
+    RefundChannelEnum["INTERNAL_PCF"] = "INTERNAL_PCF";
+    RefundChannelEnum["SPEI_OUT_MANUAL"] = "SPEI_OUT_MANUAL";
+})(RefundChannelEnum || (exports.RefundChannelEnum = RefundChannelEnum = {}));

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

@@ -0,0 +1,5 @@
+export declare enum RefundManualExecutionStatus {
+    PENDING_MANUAL_EXECUTION = "PENDING_MANUAL_EXECUTION",
+    EXECUTED = "EXECUTED",
+    CANCELLED = "CANCELLED"
+}

package/bin/transaction/enums/RefundManualExecutionStatus.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundManualExecutionStatus = void 0;
+var RefundManualExecutionStatus;
+(function (RefundManualExecutionStatus) {
+    RefundManualExecutionStatus["PENDING_MANUAL_EXECUTION"] = "PENDING_MANUAL_EXECUTION";
+    RefundManualExecutionStatus["EXECUTED"] = "EXECUTED";
+    RefundManualExecutionStatus["CANCELLED"] = "CANCELLED";
+})(RefundManualExecutionStatus || (exports.RefundManualExecutionStatus = RefundManualExecutionStatus = {}));

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

@@ -0,0 +1,7 @@
+export declare enum RefundPathTypeEnum {
+    DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
+    AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",
+    ERROR_OPERATIVO = "ERROR_OPERATIVO",
+    DOMICILIACION_T1_60D = "DOMICILIACION_T1_60D",
+    DOMICILIACION_T1_61_90D = "DOMICILIACION_T1_61_90D"
+}

package/bin/transaction/enums/RefundPathTypeEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundPathTypeEnum = void 0;
+var RefundPathTypeEnum;
+(function (RefundPathTypeEnum) {
+    RefundPathTypeEnum["DICTAMEN_PROCEDE"] = "DICTAMEN_PROCEDE";
+    RefundPathTypeEnum["AUTO_T2_SIN_2FA"] = "AUTO_T2_SIN_2FA";
+    RefundPathTypeEnum["ERROR_OPERATIVO"] = "ERROR_OPERATIVO";
+    RefundPathTypeEnum["DOMICILIACION_T1_60D"] = "DOMICILIACION_T1_60D";
+    RefundPathTypeEnum["DOMICILIACION_T1_61_90D"] = "DOMICILIACION_T1_61_90D";
+})(RefundPathTypeEnum || (exports.RefundPathTypeEnum = RefundPathTypeEnum = {}));

package/bin/transaction/index.d.ts

@@ -14,6 +14,9 @@ export * from './dtos/Product';
 export * from './dtos/ProductDetail';
 export * from './dtos/Total';
 export * from './dtos/ActivityProblemGetResponse';
+export * from './dtos/AuthorizeRefundRequest';
+export * from './dtos/ReverseRefundRequest';
+export * from './dtos/ConfirmManualExecutionRequest';
 export * from './dtos/internal/BaseProviderTransaction';
 export * from './dtos/internal/BaseProviderTransactionQueryParams';
 export * from './dtos/internal/CentralPaymentsQueryParams';
@@ -33,3 +36,6 @@ export * from './enums/TransactionStatusEnum';
 export * from './enums/DisputeOrFraudEnum';
 export * from './enums/DisputeOrFraudStatusEnum';
 export * from './enums/ActivityProblemStatusEnum';
+export * from './enums/RefundChannelEnum';
+export * from './enums/RefundPathTypeEnum';
+export * from './enums/RefundManualExecutionStatus';

package/bin/transaction/index.js

@@ -31,6 +31,9 @@ __exportStar(require("./dtos/Product"), exports);
 __exportStar(require("./dtos/ProductDetail"), exports);
 __exportStar(require("./dtos/Total"), exports);
 __exportStar(require("./dtos/ActivityProblemGetResponse"), exports);
+__exportStar(require("./dtos/AuthorizeRefundRequest"), exports);
+__exportStar(require("./dtos/ReverseRefundRequest"), exports);
+__exportStar(require("./dtos/ConfirmManualExecutionRequest"), exports);
 __exportStar(require("./dtos/internal/BaseProviderTransaction"), exports);
 __exportStar(require("./dtos/internal/BaseProviderTransactionQueryParams"), exports);
 __exportStar(require("./dtos/internal/CentralPaymentsQueryParams"), exports);
@@ -51,3 +54,6 @@ __exportStar(require("./enums/TransactionStatusEnum"), exports);
 __exportStar(require("./enums/DisputeOrFraudEnum"), exports);
 __exportStar(require("./enums/DisputeOrFraudStatusEnum"), exports);
 __exportStar(require("./enums/ActivityProblemStatusEnum"), exports);
+__exportStar(require("./enums/RefundChannelEnum"), exports);
+__exportStar(require("./enums/RefundPathTypeEnum"), exports);
+__exportStar(require("./enums/RefundManualExecutionStatus"), exports);

package/package.json

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

package/src/phoneSales/SaleDeliveryData.ts

@@ -0,0 +1,41 @@
+// Shape de `deliveryData` de una venta de celular. Portado 1:1 (mismos nombres y tipos) desde
+// `cell-phone-sales-business/src/infrastructure/entities/SaleRow.ts` (TD-011, shape CONFIRMADO
+// por el líder técnico, no inferido) — hasta ahora vivía SOLO como interfaces locales del lambda,
+// nunca se había publicado a `@fiado/type-kit`. Se publica acá porque `SaleResponseDto.deliveryData`
+// (agregado para que backoffice pueda investigar reclamaciones sin ir a logs) necesita un tipo real,
+// no `Record<string, unknown>` — y las DTOs de type-kit no pueden depender de tipos locales de un lambda.
+//
+// El retiro en tienda Fiado (`FIADO_STORE`) es un flujo INTERNO que nunca dispara un envío externo;
+// solo el retiro en oficina de transportadora (`CARRIER_OFFICE`) lo hace — por eso la unión
+// discriminada por `pickupLocationType` en vez de un objeto plano con campos opcionales.
+export type PickupLocationType = 'FIADO_STORE' | 'CARRIER_OFFICE';
+
+export interface FiadoStorePickupData {
+  pickupLocationType: 'FIADO_STORE';
+  storeId: string;
+}
+
+// Campos genéricos/agnósticos de proveedor a propósito (`carrierOfficeCode`, no el nombre real del
+// campo de Estafeta): la traducción a los nombres del contrato de cada transportadora vive en el
+// adaptador del lambda (`CreateShippingRequestMapper`), nunca en este tipo compartido.
+export interface CarrierOfficePickupData {
+  pickupLocationType: 'CARRIER_OFFICE';
+  carrierOfficeCode: string;
+  latitude: number;
+  longitude: number;
+  recipientName: string;
+  recipientPhone: string;
+}
+
+export type PickupDeliveryData = FiadoStorePickupData | CarrierOfficePickupData;
+
+export interface HomeDeliveryData {
+  street: string;
+  addressNumber: string;
+  neighborhood: string;
+  municipality: string;
+  region: string;
+  postalCode: string;
+  recipientName: string;
+  recipientPhone: string;
+}

package/src/phoneSales/SaleResponseDto.ts

@@ -1,4 +1,5 @@
 import { CurrencyId } from '../currency';
+import { PickupDeliveryData, HomeDeliveryData } from './SaleDeliveryData';
 
 export class SaleResponseDto {
   id!: string;
@@ -7,9 +8,41 @@ export class SaleResponseDto {
   buyerDirectorId!: string;
   newAccountDirectorId!: string | null;
   deliveryType!: 'PICKUP' | 'HOME';
+  /**
+   * Dónde había que entregar el dispositivo (retiro en tienda/oficina, u domicilio) —
+   * discriminado por `deliveryType`. Requerido porque `Sale_GT` lo requiere desde que existe la
+   * tabla; ventas con el objeto vacío son datos corruptos de un bug de persistencia ya corregido
+   * (ver memoria `patron-dynamoose-saveunknown-object-anidado`), no un estado válido del contrato.
+   */
+  deliveryData!: PickupDeliveryData | HomeDeliveryData;
   trackingCode!: string | null;
   providerStatus!: string | null;
+  /**
+   * Detalle textual del status reportado por el proveedor de envío (ej. "en camino a sucursal
+   * destino") — DISTINTO de `providerStatus` (arriba), que es el código/estado corto. `null`
+   * porque el conector no siempre lo trae (eventos tempranos del envío).
+   */
+  providerStatusDetail!: string | null;
+  /**
+   * Número de rastreo real que ve el comprador — DISTINTO de `trackingCode` (arriba, que es el ID
+   * de correlación interno asignado al CREAR el envío). Este es el que soporte le pasa al
+   * cliente cuando reclama. `null` porque el conector no siempre lo trae.
+   */
+  trackingNumber!: string | null;
+  /** URL pública de rastreo del proveedor — mismo motivo de nullability que `trackingNumber`. */
+  trackingUrl!: string | null;
+  /** Qué transportadora gestiona el envío — relevante para cuando haya más de un proveedor. */
+  shippingProviderId!: string;
+  /**
+   * ID del cobro en transaction-processor-business — el puente para investigar una reclamación de
+   * pago sin buscar a mano en logs por `buyerDirectorId` + ventana de tiempo.
+   */
+  paymentId!: string;
   status!: string;
+  /** Fecha de compra (epoch ms) — el dato base de cualquier investigación de reclamación. */
+  createdAt!: number;
+  /** Última modificación de la venta (epoch ms). */
+  updatedAt!: number;
   /**
    * Modelo de la variante (resuelto server-side por `variantId`, incluyendo variantes con
    * stock=0). `null` si la resolución falló (variante borrada o error de infraestructura) — ver

package/src/phoneSales/index.ts

@@ -4,6 +4,7 @@ export * from './CreateDeviceVariantRequestDto';
 export * from './UpdateDeviceVariantRequestDto';
 export * from './CreateSaleRequestDto';
 export * from './SaleResponseDto';
+export * from './SaleDeliveryData';
 export * from './RedeemSaleCodeRequestDto';
 export * from './DeviceVariantImageUploadUrlRequestDto';
 export * from './DeviceVariantImageUploadUrlResponseDto';

package/src/productCatalog/enums/ProductSubtypeEnum.ts

@@ -86,4 +86,14 @@ export enum ProductSubtypeEnum {
 
     //STORE
     STORE_PHONE = "PHONE",
+
+    // REFUND_PCF
+    REFUND_PCF_DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
+    REFUND_PCF_AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",
+    REFUND_PCF_ERROR_OPERATIVO = "ERROR_OPERATIVO",
+    REFUND_PCF_DOMICILIACION_T1_60D = "DOMICILIACION_T1_60D",
+    REFUND_PCF_DOMICILIACION_T1_61_90D = "DOMICILIACION_T1_61_90D",
+
+    // REFUND_PCF_REVERSE
+    REFUND_PCF_REVERSE_DICTAMEN_CON_2FA_TARDIO = "DICTAMEN_CON_2FA_TARDIO",
 }

package/src/productCatalog/enums/ProductTypeEnum.ts

@@ -48,5 +48,15 @@ export enum ProductTypeEnum {
      * `CreateTransactionManager` (no está en su switch), que ya arma `credit`/`debit` de forma
      * data-driven por monto, no por este type.
      */
-    STORE = "STORE"
+    STORE = "STORE",
+    /**
+     * Reembolso a cliente PCF — transacción iniciada desde dashboard de reclamaciones.
+     * Tipología: transfer SPEI out manual con aprobación de maker/checker.
+     */
+    REFUND_PCF = "REFUND_PCF",
+    /**
+     * Reversa de un reembolso anterior — se devuelve el dinero del reembolso al cliente
+     * cuando el dictamen fue incorrecto o se detectó fraude post-reembolso.
+     */
+    REFUND_PCF_REVERSE = "REFUND_PCF_REVERSE"
 }

package/src/transaction/dtos/AuthorizeRefundRequest.ts

@@ -0,0 +1,36 @@
+import { RefundChannelEnum } from '../enums/RefundChannelEnum';
+import { RefundPathTypeEnum } from '../enums/RefundPathTypeEnum';
+
+export interface AuthorizeRefundRequest {
+    idempotencyKey: string;
+    directoryId: string;
+    peopleId: string;
+    productCatalogId: 'MEX_REFUND_PCF';
+    operation: 'ADD';
+    amount: { total: number; currencyId: 'MXN' };
+    refundChannel: RefundChannelEnum;
+    refundChannelData?: {
+        targetClabe?: string;
+        targetBankId?: string;
+        targetName?: string;
+    };
+    refundCase: {
+        pathType: RefundPathTypeEnum;
+        caseFolio: string;
+        originalTransactionId: string | null;
+        originalAmount: number;
+        originalChannel: 'PCF_P2P' | 'SPEI_IN' | 'SPEI_OUT' | 'CARD' | 'DOMICILIATION_FSA';
+    };
+    approval: {
+        makerUserId: string;
+        checkerUserId: string | null;
+        minuteS3Key: string | null;
+    };
+    reason: string;
+    evidence: {
+        dictamenS3Key: string | null;
+        incidentReportS3Key: string | null;
+        objectionFormS3Key: string | null;
+    };
+    pldOverrideMinuteS3Key: string | null;
+}

package/src/transaction/dtos/ConfirmManualExecutionRequest.ts

@@ -0,0 +1,7 @@
+export interface ConfirmManualExecutionRequest {
+    idempotencyKey: string;
+    speiTrackingKey: string; // Clave de rastreo Banxico devuelta por BBVA
+    executedAt: string; // ISO 8601
+    acuseS3Key: string; // Comprobante SPEI subido por el Contralor
+    executedByUserId: string; // Contralor que ejecutó el SPEI
+}

package/src/transaction/dtos/ReverseRefundRequest.ts

@@ -0,0 +1,19 @@
+export interface ReverseRefundRequest {
+    idempotencyKey: string;
+    directoryId: string;
+    peopleId: string;
+    productCatalogId: 'MEX_REFUND_PCF_REVERSE';
+    operation: 'DEBIT';
+    originalRefundTransactionId: string;
+    originalIdempotencyKey: string;
+    amount: { total: number; currencyId: 'MXN' };
+    reverseReason: {
+        type: 'DICTAMEN_CON_2FA_TARDIO';
+        resolutionS3Key: string;
+        dictamenS3Key: string;
+    };
+    approval: {
+        makerUserId: string;
+        checkerUserId: string | null;
+    };
+}

package/src/transaction/enums/RefundChannelEnum.ts

@@ -0,0 +1,4 @@
+export enum RefundChannelEnum {
+    INTERNAL_PCF = "INTERNAL_PCF",
+    SPEI_OUT_MANUAL = "SPEI_OUT_MANUAL",
+}

package/src/transaction/enums/RefundManualExecutionStatus.ts

@@ -0,0 +1,5 @@
+export enum RefundManualExecutionStatus {
+    PENDING_MANUAL_EXECUTION = "PENDING_MANUAL_EXECUTION",
+    EXECUTED = "EXECUTED",
+    CANCELLED = "CANCELLED",
+}

package/src/transaction/enums/RefundPathTypeEnum.ts

@@ -0,0 +1,7 @@
+export enum RefundPathTypeEnum {
+    DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
+    AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",
+    ERROR_OPERATIVO = "ERROR_OPERATIVO",
+    DOMICILIACION_T1_60D = "DOMICILIACION_T1_60D",
+    DOMICILIACION_T1_61_90D = "DOMICILIACION_T1_61_90D",
+}

package/src/transaction/index.ts

@@ -15,6 +15,9 @@ export * from './dtos/Product';
 export * from './dtos/ProductDetail';
 export * from './dtos/Total';
 export * from './dtos/ActivityProblemGetResponse';
+export * from './dtos/AuthorizeRefundRequest';
+export * from './dtos/ReverseRefundRequest';
+export * from './dtos/ConfirmManualExecutionRequest';
 
 export * from './dtos/internal/BaseProviderTransaction';
 export * from './dtos/internal/BaseProviderTransactionQueryParams';
@@ -38,3 +41,6 @@ export * from './enums/TransactionStatusEnum';
 export * from './enums/DisputeOrFraudEnum';
 export * from './enums/DisputeOrFraudStatusEnum';
 export * from './enums/ActivityProblemStatusEnum';
+export * from './enums/RefundChannelEnum';
+export * from './enums/RefundPathTypeEnum';
+export * from './enums/RefundManualExecutionStatus';