@fiado/type-kit 3.463.0 → 3.465.0

package/_test_/unit/retailCatalog/catalogEnums.test.ts

@@ -13,6 +13,7 @@ describe('retailCatalog — enums del inventario multi-item', () => {
   it('expone los tipos de movimiento', () => {
     expect(Object.values(RetailCatalog.InventoryMovementTypeEnum)).toEqual([
       'ENTRY', 'RESERVATION', 'RELEASE', 'SALE', 'RETURN', 'ADJUSTMENT',
+      'TRANSFER_OUT', 'TRANSFER_IN', 'TRANSFER_CANCEL',
     ]);
   });
 
@@ -24,7 +25,7 @@ describe('retailCatalog — enums del inventario multi-item', () => {
   });
 
   it('expone el origen del precio y los periodos del lente', () => {
-    expect(Object.values(RetailCatalog.PriceSourceEnum)).toEqual(['ZENTRAL_SYNC']);
+    expect(Object.values(RetailCatalog.PriceSourceEnum)).toEqual(['ZENTRAL_SYNC', 'BACKOFFICE']);
     expect(Object.values(RetailCatalog.InventoryLensPeriodEnum)).toEqual(['7d', '30d', '90d', 'all']);
   });
 
@@ -32,3 +33,29 @@ describe('retailCatalog — enums del inventario multi-item', () => {
     expect(Object.values(RetailCatalog.InventoryLensFilterEnum)).toEqual(['critical', 'stale', 'gap', 'transfers', 'list']);
   });
 });
+
+describe('retailCatalog — enums de la operación independiente', () => {
+  it('expone el tipo de ítem', () => {
+    expect(Object.values(RetailCatalog.ItemTypeEnum)).toEqual(['PRODUCT', 'SERVICE']);
+  });
+
+  it('agrega IN_TRANSIT al estado de pieza sin quitar los existentes', () => {
+    expect(Object.values(RetailCatalog.InventoryItemStatusEnum)).toEqual([
+      'AVAILABLE', 'RESERVED', 'SOLD', 'RETURNED', 'DAMAGED', 'IN_TRANSIT',
+    ]);
+  });
+
+  it('expone la condición de una devolución', () => {
+    expect(Object.values(RetailCatalog.ReturnConditionEnum)).toEqual(['GOOD', 'DAMAGED']);
+  });
+
+  it('expone el estado de un traspaso', () => {
+    expect(Object.values(RetailCatalog.TransferStateEnum)).toEqual(['OPEN', 'RECEIVED', 'CANCELLED']);
+  });
+
+  it('expone el motivo de un movimiento', () => {
+    expect(Object.values(RetailCatalog.InventoryMovementReasonEnum)).toEqual([
+      'SHRINKAGE', 'ADJUSTMENT', 'WARRANTY', 'DAMAGED_RETURN',
+    ]);
+  });
+});

package/_test_/unit/retailCatalog/responseFields.test.ts

@@ -0,0 +1,53 @@
+import 'reflect-metadata';
+import * as RetailCatalog from '../../../src/retailCatalog';
+
+// ts-jest compila con type-check: si un campo nuevo no existe en el tipo, la suite no compila.
+describe('retailCatalog — campos nuevos opcionales en respuestas', () => {
+  it('Product y ProductResponse aceptan itemType y siguen válidos sin él', () => {
+    const product = new RetailCatalog.Product();
+    product.itemType = RetailCatalog.ItemTypeEnum.SERVICE;
+    const response: RetailCatalog.ProductResponse = product;
+    expect(response.itemType).toBe('SERVICE');
+    expect(new RetailCatalog.Product().itemType).toBeUndefined();
+  });
+
+  it('StoreCatalogItem acepta itemType', () => {
+    const item: Pick<RetailCatalog.StoreCatalogItem, 'sku' | 'itemType'> = {
+      sku: 'SKU-1',
+      itemType: RetailCatalog.ItemTypeEnum.PRODUCT,
+    };
+    expect(item.itemType).toBe('PRODUCT');
+  });
+
+  it('la fila del lente en modo lista acepta itemType', () => {
+    const row: Pick<RetailCatalog.InventoryLensListItem, 'sku' | 'itemType'> = {
+      sku: 'SKU-1',
+      itemType: RetailCatalog.ItemTypeEnum.SERVICE,
+    };
+    expect(row.itemType).toBe('SERVICE');
+  });
+
+  it('ReservedComponent acepta priceCents y sigue válido sin él', () => {
+    const base: RetailCatalog.ReservedComponent = {
+      sku: 'SKU-1',
+      qty: 1,
+      category: RetailCatalog.ProductCategoryEnum.PHONE,
+      trackingMode: RetailCatalog.TrackingModeEnum.IMEI,
+    };
+    const priced: RetailCatalog.ReservedComponent = { ...base, priceCents: 150000 };
+    expect(base.priceCents).toBeUndefined();
+    expect(priced.priceCents).toBe(150000);
+  });
+
+  it('SkuPriceEntry acepta comboPriceCents y el origen BACKOFFICE', () => {
+    const entry: RetailCatalog.SkuPriceEntry = {
+      effectiveFrom: '2026-09-24T00:00:00.000Z',
+      listPriceCents: null,
+      basePriceCents: 200000,
+      comboPriceCents: 180000,
+      source: RetailCatalog.PriceSourceEnum.BACKOFFICE,
+      createdBy: 'system',
+    };
+    expect(entry.comboPriceCents).toBe(180000);
+  });
+});

package/_test_/unit/retailCatalog/returnConditions.test.ts

@@ -0,0 +1,64 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import { ReturnConditionEnum, ReturnPieceCondition, ReturnStockLine, ReturnStockRequest } from '../../../src/retailCatalog';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+function errorsOf<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+  return paths(validateSync(plainToInstance(cls, payload) as object, { whitelist: true, forbidNonWhitelisted: true }));
+}
+
+describe('ReturnPieceCondition', () => {
+  it('una pieza con identificador y sin condición queda GOOD', () => {
+    const dto = plainToInstance(ReturnPieceCondition, { sku: 'PH-A15', identifier: '356938035643809' });
+    expect(dto.condition).toBe(ReturnConditionEnum.GOOD);
+    expect(validateSync(dto)).toEqual([]);
+  });
+  it('acepta un accesorio por cantidad dañado con motivo', () => {
+    expect(errorsOf(ReturnPieceCondition, { sku: 'FUNDA-1', qty: 2, condition: 'DAMAGED', reason: 'Rota' })).toEqual([]);
+  });
+  it('DAMAGED exige motivo; GOOD no', () => {
+    expect(errorsOf(ReturnPieceCondition, { sku: 'FUNDA-1', qty: 1, condition: 'DAMAGED' })).toContain('reason');
+    expect(errorsOf(ReturnPieceCondition, { sku: 'FUNDA-1', qty: 1, condition: 'DAMAGED', reason: '   ' })).toContain('reason');
+    expect(errorsOf(ReturnPieceCondition, { sku: 'PH-A15', identifier: '356938035643809', condition: 'DAMAGED', reason: 'Pantalla rota' })).toEqual([]);
+    expect(errorsOf(ReturnPieceCondition, { sku: 'PH-A15', identifier: '356938035643809', condition: 'GOOD' })).toEqual([]);
+  });
+  it('rechaza sin sku, sin identifier ni qty, y con ambos', () => {
+    expect(errorsOf(ReturnPieceCondition, { identifier: 'A1' })).toContain('sku');
+    expect(errorsOf(ReturnPieceCondition, { sku: 'FUNDA-1' })).toContain('identifier');
+    expect(errorsOf(ReturnPieceCondition, { sku: 'FUNDA-1', identifier: 'A1', qty: 1 })).toContain('identifier');
+  });
+  it('rechaza condición desconocida, qty 0, identificador y motivo en blanco', () => {
+    const errors = errorsOf(ReturnPieceCondition, { sku: 'FUNDA-1', qty: 0, condition: 'BROKEN', reason: '   ' });
+    expect(errors).toEqual(expect.arrayContaining(['qty', 'condition', 'reason']));
+    expect(errorsOf(ReturnPieceCondition, { sku: 'PH-1', identifier: '  ' })).toContain('identifier');
+  });
+});
+
+describe('ReturnStockRequest con condición por pieza', () => {
+  const line = { lineId: 'L1', sku: 'KIT-1', qty: 1, components: [{ sku: 'PH-A15', qty: 1, identifiers: ['356938035643809'] }, { sku: 'FUNDA-1', qty: 2, identifiers: [] }] };
+  const base = { saleId: 'sale', retailerId: 'ret', soldAt: '2026-09-23T10:00:00.000Z' };
+  it('un consumidor viejo sin condiciones sigue validando', () => {
+    expect(errorsOf(ReturnStockRequest, { ...base, lines: [line] })).toEqual([]);
+  });
+  it('acepta condiciones por pieza y por cantidad', () => {
+    const conditions = [
+      { sku: 'PH-A15', identifier: '356938035643809', condition: 'DAMAGED', reason: 'Pantalla rota' },
+      { sku: 'FUNDA-1', qty: 1, condition: 'DAMAGED', reason: 'Descosida' },
+    ];
+    const dto = plainToInstance(ReturnStockRequest, { ...base, lines: [{ ...line, conditions }] });
+    expect(dto.lines[0]).toBeInstanceOf(ReturnStockLine);
+    expect(dto.lines[0].conditions?.[0]).toBeInstanceOf(ReturnPieceCondition);
+    expect(validateSync(dto)).toEqual([]);
+  });
+  it('valida cada condición anidada', () => {
+    const conditions = [{ sku: 'PH-A15', identifier: '356938035643809', condition: 'LOST' }];
+    expect(errorsOf(ReturnStockRequest, { ...base, lines: [{ ...line, conditions }] })).toContain('lines.0.conditions.0.condition');
+  });
+});

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

@@ -0,0 +1,41 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import { ReturnPieceCondition } from '../../../src/retailCatalog';
+import { BackofficeCancelSaleRequest, CancelSaleRequest } from '../../../src/retailWizard';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+function errorsOf<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+  return paths(validateSync(plainToInstance(cls, payload, { excludeExtraneousValues: true }) as object));
+}
+
+const conditions = [
+  { sku: 'PH-A15', identifier: '356938035643809', condition: 'DAMAGED', reason: 'Pantalla rota' },
+  { sku: 'FUNDA-1', qty: 1 },
+];
+
+describe.each([
+  ['CancelSaleRequest', CancelSaleRequest, { reason: 'Cliente se arrepintió' }],
+  ['BackofficeCancelSaleRequest', BackofficeCancelSaleRequest, { reason: 'Cliente se arrepintió' }],
+] as const)('%s con condición por pieza', (_name, cls, base) => {
+  it('sin returnConditions sigue validando', () => expect(errorsOf(cls, base)).toEqual([]));
+  it('acepta condiciones y las hidrata aun con excludeExtraneousValues', () => {
+    const dto = plainToInstance(cls, { ...base, returnConditions: conditions }, { excludeExtraneousValues: true });
+    expect(validateSync(dto)).toEqual([]);
+    expect(dto.returnConditions?.[0]).toBeInstanceOf(ReturnPieceCondition);
+    expect(dto.returnConditions?.[0].reason).toBe('Pantalla rota');
+    expect(dto.returnConditions?.[1].condition).toBe('GOOD');
+  });
+  it('valida cada condición y rechaza un no-arreglo', () => {
+    expect(errorsOf(cls, { ...base, returnConditions: [{ sku: 'FUNDA-1', condition: 'LOST' }] })).toEqual(
+      expect.arrayContaining(['returnConditions.0.condition', 'returnConditions.0.identifier']),
+    );
+    expect(errorsOf(cls, { ...base, returnConditions: 'GOOD' })).toContain('returnConditions');
+  });
+});

package/_test_/unit/stpSpei/additive.test.ts

@@ -0,0 +1,84 @@
+import "reflect-metadata";
+import { Provider } from "../../../src/provider/enums/Provider";
+import { ProductTypeEnum } from "../../../src/productCatalog/enums/ProductTypeEnum";
+import {
+    BusinessNameEnum,
+    ConsultStpOrderRequest,
+    PutStpOrderRequest,
+    StpOrderSourceEnum,
+} from "../../../src/stpSpei";
+
+describe("stpSpei — cambios aditivos para money-transfer-connector (DEC-013 / DEC-037)", () => {
+    it("Provider expone MONEY_TRANSFER", () => {
+        expect(Provider.MONEY_TRANSFER).toBe("MONEY_TRANSFER");
+    });
+
+    it("ProductTypeEnum expone MONEY_TRANSFER_SA", () => {
+        expect(ProductTypeEnum.MONEY_TRANSFER_SA).toBe("MONEY_TRANSFER_SA");
+    });
+
+    it("StpOrderSourceEnum expone USER_TRANSFER y BENEFITS_SETTLEMENT", () => {
+        expect(StpOrderSourceEnum.USER_TRANSFER).toBe("USER_TRANSFER");
+        expect(StpOrderSourceEnum.BENEFITS_SETTLEMENT).toBe("BENEFITS_SETTLEMENT");
+    });
+
+    it("PutStpOrderRequest compila sin los campos de usuario y acepta source + beneficiaryRfc", () => {
+        const request: PutStpOrderRequest = {
+            amount: 150.5,
+            transactionNumber: "TX-0001",
+            numericReference: 1234567,
+            concept: "Liquidación de beneficios",
+            beneficiaryAccount: "646180110400000007",
+            beneficiaryName: "EMPRESA SA DE CV",
+            bankCode: "90646",
+            source: StpOrderSourceEnum.BENEFITS_SETTLEMENT,
+        };
+
+        expect(request.source).toBe("BENEFITS_SETTLEMENT");
+        expect(request.directoryId).toBeUndefined();
+        expect(request.beneficiaryRfc).toBeUndefined();
+
+        const withRfc: PutStpOrderRequest = { ...request, beneficiaryRfc: "XAXX010101000" };
+        expect(withRfc.beneficiaryRfc).toBe("XAXX010101000");
+    });
+
+    it("PutStpOrderRequest sigue aceptando el shape completo actual (USER_TRANSFER)", () => {
+        const request: PutStpOrderRequest = {
+            processorObject: null,
+            directoryId: "dir-1",
+            phoneNumber: "+525500000000",
+            indexName: "idx",
+            amount: 10,
+            transactionNumber: "TX-0002",
+            numericReference: 1,
+            concept: null,
+            beneficiaryAccount: "646180110400000007",
+            beneficiaryName: "JUAN PEREZ",
+            bankName: "STP",
+            bankCode: "90646",
+            originatorAccountNumber: "646180110400000008",
+            originatorCurp: "XAXX010101HDFXXX01",
+            originatorName: "FIADO",
+        };
+
+        expect(request.source).toBeUndefined();
+        expect(request.transactionNumber).toBe("TX-0002");
+    });
+
+    it("ConsultStpOrderRequest acepta businessName opcional (DEC-037)", () => {
+        const sinEmpresa: ConsultStpOrderRequest = {
+            transactionNumber: "TX-0003",
+            orderType: "E",
+            operationDate: "20260924",
+        };
+        expect(sinEmpresa.businessName).toBeUndefined();
+
+        const conEmpresa: ConsultStpOrderRequest = {
+            ...sinEmpresa,
+            orderType: "R",
+            businessName: BusinessNameEnum.PAGO_CONFIADO,
+        };
+        expect(conEmpresa.businessName).toBe("PAGO_CONFIADO");
+        expect(conEmpresa.orderType).toBe("R");
+    });
+});

package/bin/bankAccount/enums/BeneficiaryAccountTypeEnum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tipo de identificador con el que se reconoce la cuenta destino de una
+ * transferencia SPEI.
+ *
+ * Banxico admite tres (Circular 17/2010) y STP los distingue con el campo
+ * `tipoCuentaBeneficiario` del servicio registraOrden. El valor numerico de
+ * cada uno vive en el lambda que arma la orden; aqui solo se nombra el
+ * concepto.
+ *
+ * No confundir con `ExternalAccountTypeEnum`, que describe la naturaleza de la
+ * cuenta (cheques, ahorro), no como se identifica.
+ */
+export declare enum BeneficiaryAccountTypeEnum {
+    /** CLABE de 18 digitos, con digito verificador Banxico. */
+    CLABE = "CLABE",
+    /** Numero de tarjeta de debito de 16 digitos, con verificacion Luhn. */
+    DEBIT_CARD = "DEBIT_CARD",
+    /** Linea movil de 10 digitos. Sin verificador: habilitar con cuidado. */
+    MOBILE_PHONE = "MOBILE_PHONE"
+}

package/bin/bankAccount/enums/BeneficiaryAccountTypeEnum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BeneficiaryAccountTypeEnum = void 0;
+/**
+ * Tipo de identificador con el que se reconoce la cuenta destino de una
+ * transferencia SPEI.
+ *
+ * Banxico admite tres (Circular 17/2010) y STP los distingue con el campo
+ * `tipoCuentaBeneficiario` del servicio registraOrden. El valor numerico de
+ * cada uno vive en el lambda que arma la orden; aqui solo se nombra el
+ * concepto.
+ *
+ * No confundir con `ExternalAccountTypeEnum`, que describe la naturaleza de la
+ * cuenta (cheques, ahorro), no como se identifica.
+ */
+var BeneficiaryAccountTypeEnum;
+(function (BeneficiaryAccountTypeEnum) {
+    /** CLABE de 18 digitos, con digito verificador Banxico. */
+    BeneficiaryAccountTypeEnum["CLABE"] = "CLABE";
+    /** Numero de tarjeta de debito de 16 digitos, con verificacion Luhn. */
+    BeneficiaryAccountTypeEnum["DEBIT_CARD"] = "DEBIT_CARD";
+    /** Linea movil de 10 digitos. Sin verificador: habilitar con cuidado. */
+    BeneficiaryAccountTypeEnum["MOBILE_PHONE"] = "MOBILE_PHONE";
+})(BeneficiaryAccountTypeEnum || (exports.BeneficiaryAccountTypeEnum = BeneficiaryAccountTypeEnum = {}));

package/bin/bankAccount/index.d.ts

@@ -4,6 +4,7 @@ export * from './dtos/GetExternalBankAccountResponse';
 export * from './dtos/GetExternalBankResponse';
 export * from './dtos/CreateExternalBankAccountRequest';
 export * from './dtos/CreateExternalBankAccountResponse';
+export * from './enums/BeneficiaryAccountTypeEnum';
 export * from './enums/ExternalAccountOwnershipEnum';
 export * from './enums/ExternalAccountStatusEnum';
 export * from './enums/ExternalAccountTypeEnum';

package/bin/bankAccount/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./dtos/GetExternalBankAccountResponse"), exports);
 __exportStar(require("./dtos/GetExternalBankResponse"), exports);
 __exportStar(require("./dtos/CreateExternalBankAccountRequest"), exports);
 __exportStar(require("./dtos/CreateExternalBankAccountResponse"), exports);
+__exportStar(require("./enums/BeneficiaryAccountTypeEnum"), exports);
 __exportStar(require("./enums/ExternalAccountOwnershipEnum"), exports);
 __exportStar(require("./enums/ExternalAccountStatusEnum"), exports);
 __exportStar(require("./enums/ExternalAccountTypeEnum"), exports);

package/bin/index.d.ts

@@ -116,3 +116,4 @@ export * as PeopleBusiness from './peopleBusiness';
 export * as WebhookBusiness from './webhookBusiness';
 export * as Membership from './membership';
 export * as RetailLoan from './retailLoan';
+export * as MoneyTransfer from './moneyTransfer';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.DatalakeQuery = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = void 0;
-exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = void 0;
+exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -222,3 +222,7 @@ exports.Membership = __importStar(require("./membership"));
 // RetailLoan: contrato público de retail-loan-business (I1), la puerta de la App Fiado
 // hacia las suites FiadoLend/FiadoRetail. Montos en pesos; el lambda convierte desde centavos.
 exports.RetailLoan = __importStar(require("./retailLoan"));
+// MoneyTransfer: contrato del money-transfer-connector (Centro de Beneficios) — catálogo de
+// servicios/productos con riel SPEI/ACH y liquidación inmediata o en lote, liquidaciones
+// (settlements) y estado de órdenes SPEI. Reusa AmountTypeEnum/ReferenceTypeEnum de servicePayment.
+exports.MoneyTransfer = __importStar(require("./moneyTransfer"));

package/bin/moneyTransfer/dtos/BatchScheduleRequest.d.ts

@@ -0,0 +1,7 @@
+/** Programación del lote para productos con `settlementMode = BATCH`. */
+export declare class BatchScheduleRequest {
+    /** Expresión cron (5 campos) evaluada en `timezone`. */
+    cron: string;
+    /** Zona horaria IANA, ej. `America/Mexico_City`. */
+    timezone: string;
+}

package/bin/moneyTransfer/dtos/BatchScheduleRequest.js

@@ -0,0 +1,28 @@
+"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;
+};
+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.BatchScheduleRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** Programación del lote para productos con `settlementMode = BATCH`. */
+class BatchScheduleRequest {
+}
+exports.BatchScheduleRequest = BatchScheduleRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], BatchScheduleRequest.prototype, "cron", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], BatchScheduleRequest.prototype, "timezone", void 0);

package/bin/moneyTransfer/dtos/CreateSettlementRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Crea una liquidación agrupando folios pendientes (`transactionNumbers`) de un mismo producto.
+ * `sendNow = true` la envía al riel de inmediato; en caso contrario queda en `CREATED` o
+ * `SCHEDULED` (si viene `scheduledAt`, epoch ms).
+ */
+export declare class CreateSettlementRequest {
+    idempotencyKey: string;
+    transactionNumbers: string[];
+    sendNow: boolean;
+    /** Epoch ms del envío programado. */
+    scheduledAt?: number;
+}

package/bin/moneyTransfer/dtos/CreateSettlementRequest.js

@@ -0,0 +1,42 @@
+"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;
+};
+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.CreateSettlementRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Crea una liquidación agrupando folios pendientes (`transactionNumbers`) de un mismo producto.
+ * `sendNow = true` la envía al riel de inmediato; en caso contrario queda en `CREATED` o
+ * `SCHEDULED` (si viene `scheduledAt`, epoch ms).
+ */
+class CreateSettlementRequest {
+}
+exports.CreateSettlementRequest = CreateSettlementRequest;
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], CreateSettlementRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(1000),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateSettlementRequest.prototype, "transactionNumbers", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateSettlementRequest.prototype, "sendNow", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], CreateSettlementRequest.prototype, "scheduledAt", void 0);

package/bin/moneyTransfer/dtos/MoneyTransferProductRequest.d.ts

@@ -0,0 +1,37 @@
+import { AmountTypeEnum } from "../../servicePayment/enums/AmountTypeEnum";
+import { ReferenceTypeEnum } from "../../servicePayment/enums/ReferenceTypeEnum";
+import { SettlementModeEnum } from "../enums/SettlementModeEnum";
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+import { BatchScheduleRequest } from "./BatchScheduleRequest";
+/**
+ * Producto de un servicio de transferencia de dinero (Centro de Beneficios). Los campos en
+ * español espejan el catálogo legacy de pago de servicios; los campos en inglés son la
+ * configuración propia del riel (canal, modo de liquidación, beneficiario, lote).
+ */
+export declare class MoneyTransferProductRequest {
+    idProducto: string;
+    producto: string;
+    precio: number;
+    amountType: AmountTypeEnum;
+    fee: number;
+    tipoReferencia: ReferenceTypeEnum;
+    verificateReference: boolean;
+    hasDigitoVerificador: boolean;
+    showAyuda: boolean;
+    legend: string;
+    logoSrc: string;
+    refSrc: string;
+    tipoFront: number;
+    idCatTipoServicio: number;
+    enabled: boolean;
+    channel: TransferChannelEnum;
+    settlementMode: SettlementModeEnum;
+    /** Nombre del beneficiario tal como viaja al riel (SPEI acepta máx. 40 chars). */
+    beneficiaryName: string;
+    /** RFC del beneficiario: 12 chars persona moral, 13 persona física. */
+    beneficiaryRfc?: string;
+    minAmount?: number;
+    maxAmount?: number;
+    /** Requerido operativamente cuando `settlementMode = BATCH`; lo valida el conector. */
+    batchSchedule?: BatchScheduleRequest;
+}

package/bin/moneyTransfer/dtos/MoneyTransferProductRequest.js

@@ -0,0 +1,131 @@
+"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;
+};
+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.MoneyTransferProductRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const AmountTypeEnum_1 = require("../../servicePayment/enums/AmountTypeEnum");
+const ReferenceTypeEnum_1 = require("../../servicePayment/enums/ReferenceTypeEnum");
+const SettlementModeEnum_1 = require("../enums/SettlementModeEnum");
+const TransferChannelEnum_1 = require("../enums/TransferChannelEnum");
+const BatchScheduleRequest_1 = require("./BatchScheduleRequest");
+/**
+ * Producto de un servicio de transferencia de dinero (Centro de Beneficios). Los campos en
+ * español espejan el catálogo legacy de pago de servicios; los campos en inglés son la
+ * configuración propia del riel (canal, modo de liquidación, beneficiario, lote).
+ */
+class MoneyTransferProductRequest {
+}
+exports.MoneyTransferProductRequest = MoneyTransferProductRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(34),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "idProducto", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "producto", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], MoneyTransferProductRequest.prototype, "precio", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(AmountTypeEnum_1.AmountTypeEnum),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "amountType", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], MoneyTransferProductRequest.prototype, "fee", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(ReferenceTypeEnum_1.ReferenceTypeEnum),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "tipoReferencia", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], MoneyTransferProductRequest.prototype, "verificateReference", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], MoneyTransferProductRequest.prototype, "hasDigitoVerificador", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], MoneyTransferProductRequest.prototype, "showAyuda", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "legend", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "logoSrc", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "refSrc", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], MoneyTransferProductRequest.prototype, "tipoFront", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], MoneyTransferProductRequest.prototype, "idCatTipoServicio", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], MoneyTransferProductRequest.prototype, "enabled", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(TransferChannelEnum_1.TransferChannelEnum),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "channel", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(SettlementModeEnum_1.SettlementModeEnum),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "settlementMode", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(40),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "beneficiaryName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(12, 13),
+    __metadata("design:type", String)
+], MoneyTransferProductRequest.prototype, "beneficiaryRfc", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], MoneyTransferProductRequest.prototype, "minAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], MoneyTransferProductRequest.prototype, "maxAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BatchScheduleRequest_1.BatchScheduleRequest),
+    __metadata("design:type", BatchScheduleRequest_1.BatchScheduleRequest)
+], MoneyTransferProductRequest.prototype, "batchSchedule", void 0);