@fiado/type-kit 3.602.0 → 3.604.0

package/_test_/unit/retailIntegration/retailMovementsContracts.test.ts

@@ -4,9 +4,11 @@ import { validateSync } from 'class-validator';
 import {
     GetRetailInventoryRequest,
     type GetRetailInventoryResponse,
+    type InvalidRetailInventoryMovement,
     ListRetailInventoryMovementsRequest,
     type ListRetailInventoryMovementsResponse,
     ReconciliationEntityEnum,
+    RetailEventRejectCodeEnum,
     ReconciliationPageMessage,
     ReconciliationTriggerEnum,
 } from '../../../src/retailIntegration';
@@ -61,6 +63,17 @@ describe('ListRetailInventoryMovementsRequest', () => {
             meta: { count: 1, nextToken: null },
         };
         expect(response.meta.nextToken).toBeNull();
+        expect(response.invalidItems).toBeUndefined();
+    });
+
+    it('la respuesta lista los movimientos inválidos con índice, eventId opcional y rutas', () => {
+        const invalid: InvalidRetailInventoryMovement[] = [
+            { index: 3, eventId: 'evt-4', code: RetailEventRejectCodeEnum.INVALID_PAYLOAD, invalidPaths: ['payload.storeId'] },
+            { index: 7, code: RetailEventRejectCodeEnum.INVALID_PAYLOAD, invalidPaths: ['eventId', 'occurredAt'] },
+        ];
+        const response: ListRetailInventoryMovementsResponse = { items: [], meta: { count: 0, nextToken: null }, invalidItems: invalid };
+        expect(response.invalidItems?.map((i) => i.index)).toEqual([3, 7]);
+        expect(response.invalidItems?.[1].eventId).toBeUndefined();
     });
 });
 

package/_test_/unit/retailIntegration/retailSaleContracts.test.ts

@@ -23,6 +23,12 @@ async function errorsOf(cls: new () => object, plain: object): Promise<string[]>
     return paths(await validate(plainToInstance(cls, plain)));
 }
 
+const cashPayment = { method: 'CASH', amount: '400.00', cardLast4: null, authCode: null, speiTrackingKey: null, senderClabe: null } as const;
+const cardPayment = { method: 'CARD', amount: '200.00', cardLast4: '4242', authCode: 'A1B2C3', speiTrackingKey: null, senderClabe: null } as const;
+const wirePayment = {
+    method: 'WIRE', amount: '200.00', cardLast4: null, authCode: null, speiTrackingKey: 'MBAN01002610160000123ABCD', senderClabe: '012180001234567897',
+} as const;
+
 // Literal tipado: prueba en compilación que la clase sigue aceptando objetos planos.
 const sale: RetailSystemSale = {
     saleId: '7f0c2a52-1b7e-4f0e-9d7a-2a1d3c4b5e6f',
@@ -33,30 +39,39 @@ const sale: RetailSystemSale = {
     saleType: 'CREDIT',
     financier: 'SUREKEEP',
     creditId: 'CR-991',
+    credit: {
+        paymentFrequency: 'WEEKLY', installments: 16, installmentAmount: '260.67', downPayment: '600.00', totalToPay: '4170.72', firstPaymentDate: '2026-10-30',
+    },
     currencyId: 'MXN',
     customer: { customerId: 'C-1', names: 'Ana', paternalLastName: 'López', maternalLastName: null, phone: '7221234567' },
     equipmentPrice: '5999.00',
     amountPaid: '600.00',
-    paymentMethod: 'CASH',
+    payments: [cashPayment, cardPayment],
     lines: [
         {
             lineId: 'L1', sku: 'IPH-15', qty: 1, basePrice: '5999.00', discount: '0.00', paymentType: 'CREDIT',
-            financedAmount: '5399.00', role: null, components: [{ sku: 'IPH-15', qty: 1, identifiers: ['356789012345678'] }],
+            financedAmount: '5399.00', role: null, promotionId: null, components: [{ sku: 'IPH-15', qty: 1, identifiers: ['356789012345678'] }],
         },
         {
             lineId: 'L2', sku: 'FUNDA-1', qty: 1, basePrice: '0.00', discount: '0.00', paymentType: 'CASH',
-            financedAmount: '0.00', role: 'GIFT', components: [],
+            financedAmount: '0.00', role: 'GIFT', promotionId: 'PRM-0012', components: [],
         },
     ],
 };
 
+const cashSale = { ...sale, saleType: 'CASH', financier: 'NONE', creditId: null, credit: null };
+
 describe('RetailSystemSale (body de privateRegisterRetailSale)', () => {
-    it('acepta una venta completa', async () => {
+    it('acepta una venta a crédito SureKeep completa', async () => {
         expect(await errorsOf(RetailSystemSale, sale)).toEqual([]);
     });
 
-    it('acepta los nullables en null', async () => {
-        expect(await errorsOf(RetailSystemSale, { ...sale, creditId: null, paymentMethod: null })).toEqual([]);
+    it('acepta una venta de contado con creditId y credit en null', async () => {
+        expect(await errorsOf(RetailSystemSale, cashSale)).toEqual([]);
+    });
+
+    it('acepta una referida sin creditId ni credit', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, financier: 'PAYJOY', creditId: null, credit: null })).toEqual([]);
     });
 
     it.each([
@@ -67,14 +82,19 @@ describe('RetailSystemSale (body de privateRegisterRetailSale)', () => {
         ['financier', { financier: 'OTRO' }],
         ['currencyId', { currencyId: 'EUR' }],
         ['equipmentPrice', { equipmentPrice: '5999' }],
-        ['amountPaid', { amountPaid: '-1.00' }],
-        ['paymentMethod', { paymentMethod: 'BITCOIN' }],
+        ['equipmentPrice', { equipmentPrice: '1234567890123.00' }],
         ['creditId', { creditId: undefined }],
+        ['credit', { credit: undefined }],
+        ['payments', { payments: undefined }],
         ['lines', { lines: [] }],
     ])('rechaza %s inválido', async (field, patch) => {
         expect(await errorsOf(RetailSystemSale, { ...sale, ...patch })).toEqual([field]);
     });
 
+    it.each(['722123456', '72212345678', '+527221234567', '722-123-4567'])('rechaza customer.phone %s', async (phone) => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, customer: { ...sale.customer, phone } })).toEqual(['customer.phone']);
+    });
+
     it('valida el cliente anidado', async () => {
         expect(await errorsOf(RetailSystemSale, { ...sale, customer: { ...sale.customer, names: '' } })).toEqual(['customer.names']);
     });
@@ -90,11 +110,139 @@ describe('RetailSystemSale (body de privateRegisterRetailSale)', () => {
     });
 });
 
+describe('RetailSystemSale.credit', () => {
+    it('SUREKEEP exige credit y creditId', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, credit: null })).toEqual(['financier']);
+        expect(await errorsOf(RetailSystemSale, { ...sale, creditId: null })).toEqual(['financier']);
+    });
+
+    it('contado exige credit y creditId en null', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...cashSale, credit: sale.credit })).toEqual(['financier']);
+        expect(await errorsOf(RetailSystemSale, { ...cashSale, creditId: 'CR-1' })).toEqual(['financier']);
+    });
+
+    it.each([
+        ['paymentFrequency', { paymentFrequency: 'DAILY' }],
+        ['installments', { installments: 0 }],
+        ['installments', { installments: 1.5 }],
+        ['installmentAmount', { installmentAmount: '260.6' }],
+        ['downPayment', { downPayment: undefined }],
+        ['totalToPay', { totalToPay: '1234567890123.00' }],
+        ['firstPaymentDate', { firstPaymentDate: '2026-02-30' }],
+        ['firstPaymentDate', { firstPaymentDate: '2026-10-30T00:00:00Z' }],
+    ])('rechaza credit.%s inválido', async (field, patch) => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, credit: { ...sale.credit, ...patch } })).toEqual([`credit.${field}`]);
+    });
+});
+
+describe('RetailSystemSale.payments', () => {
+    it('acepta [] cuando amountPaid es 0.00', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, amountPaid: '0.00', payments: [] })).toEqual([]);
+    });
+
+    it('acepta WIRE con y sin senderClabe', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, wirePayment] })).toEqual([]);
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, senderClabe: null }] })).toEqual([]);
+    });
+
+    it('acepta speiTrackingKey de 1 a 30 alfanuméricos', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, speiTrackingKey: '7' }] })).toEqual([]);
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, speiTrackingKey: 'A'.repeat(30) }] })).toEqual([]);
+    });
+
+    it('acepta FIADO sin detalle', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [{ ...cashPayment, method: 'FIADO', amount: '600.00' }] })).toEqual([]);
+    });
+
+    it('rechaza que la suma no cuadre con amountPaid', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment] })).toEqual(['payments']);
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [] })).toEqual(['payments']);
+    });
+
+    it.each([
+        ['method', { method: 'SPEI' }],
+        ['amount', { amount: '0.00' }],
+        ['amount', { amount: '400' }],
+        ['cardLast4', { cardLast4: '4242' }],
+        ['cardLast4', { cardLast4: undefined }],
+        ['authCode', { authCode: 'X' }],
+        ['speiTrackingKey', { speiTrackingKey: undefined }],
+        ['senderClabe', { senderClabe: undefined }],
+    ])('rechaza %s fuera de regla en CASH', async (field, patch) => {
+        const payments = [{ ...cashPayment, ...patch }, cardPayment];
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments })).toEqual([`payments.0.${field}`]);
+    });
+
+    it.each([
+        ['cardLast4', { cardLast4: null }],
+        ['cardLast4', { cardLast4: '424' }],
+        ['authCode', { authCode: null }],
+        ['authCode', { authCode: ' ' }],
+        ['authCode', { authCode: 'A'.repeat(65) }],
+        ['speiTrackingKey', { speiTrackingKey: '123456789012345678' }],
+    ])('rechaza %s fuera de regla en CARD', async (field, patch) => {
+        const payments = [cashPayment, { ...cardPayment, ...patch }];
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments })).toEqual([`payments.1.${field}`]);
+    });
+
+    it.each([
+        ['speiTrackingKey', { speiTrackingKey: null }],
+        ['speiTrackingKey', { speiTrackingKey: '' }],
+        ['speiTrackingKey', { speiTrackingKey: 'A'.repeat(31) }],
+        ['speiTrackingKey', { speiTrackingKey: 'MBAN-0100-2610' }],
+        ['speiTrackingKey', { speiTrackingKey: 'MBAN 01002610' }],
+        ['senderClabe', { senderClabe: '01218000123456789A' }],
+        ['senderClabe', { senderClabe: '0121' }],
+        ['cardLast4', { cardLast4: '4242' }],
+    ])('rechaza %s fuera de regla en WIRE', async (field, patch) => {
+        const payments = [cashPayment, { ...wirePayment, ...patch }];
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments })).toEqual([`payments.1.${field}`]);
+    });
+});
+
+describe('RetailSystemSale.lines[].promotionId', () => {
+    it('la llave es obligatoria aunque sea null', async () => {
+        const lines = [{ ...sale.lines[0], promotionId: undefined }, sale.lines[1]];
+        expect(await errorsOf(RetailSystemSale, { ...sale, lines })).toEqual(['lines.0.promotionId']);
+    });
+
+    it('acepta una promoción en una línea con descuento', async () => {
+        const lines = [{ ...sale.lines[0], discount: '500.00', promotionId: 'PRM-1' }, sale.lines[1]];
+        expect(await errorsOf(RetailSystemSale, { ...sale, lines })).toEqual([]);
+    });
+
+    it.each([
+        ['vacío', ' '],
+        ['más de 64', 'P'.repeat(65)],
+    ])('rechaza promotionId %s', async (_case, promotionId) => {
+        const lines = [{ ...sale.lines[0], promotionId }, sale.lines[1]];
+        expect(await errorsOf(RetailSystemSale, { ...sale, lines })).toEqual(['lines.0.promotionId']);
+    });
+
+    it('un regalo exige promotionId', async () => {
+        const lines = [sale.lines[0], { ...sale.lines[1], promotionId: null }];
+        expect(await errorsOf(RetailSystemSale, { ...sale, lines })).toEqual(['lines.1.promotionId']);
+    });
+});
+
 describe('CancelRetailSaleRequest', () => {
-    const cancel = { saleId: sale.saleId, cancelledAt: '2026-10-25T19:00:00-06:00', reason: 'Cliente desistió' };
+    const cancel: CancelRetailSaleRequest = {
+        saleId: sale.saleId,
+        cancelledAt: '2026-10-25T19:00:00-06:00',
+        reason: 'Cliente desistió',
+        damaged: [
+            { sku: 'IPH-15', identifier: '356789012345678', qty: 1 },
+            { sku: 'FUNDA-1', identifier: null, qty: 3 },
+        ],
+    };
 
-    it('acepta la cancelación', async () => {
+    it('acepta la cancelación con y sin dañados', async () => {
         expect(await errorsOf(CancelRetailSaleRequest, cancel)).toEqual([]);
+        expect(await errorsOf(CancelRetailSaleRequest, { ...cancel, damaged: [] })).toEqual([]);
+    });
+
+    it('acepta reason de 200 caracteres', async () => {
+        expect(await errorsOf(CancelRetailSaleRequest, { ...cancel, reason: 'r'.repeat(200) })).toEqual([]);
     });
 
     it.each([
@@ -102,10 +250,23 @@ describe('CancelRetailSaleRequest', () => {
         ['cancelledAt', { cancelledAt: '2026-02-31T10:00:00Z' }],
         ['reason', { reason: '' }],
         ['reason', { reason: undefined }],
+        ['reason', { reason: 'r'.repeat(201) }],
+        ['damaged', { damaged: undefined }],
     ])('rechaza %s inválido', async (field, patch) => {
         expect(await errorsOf(CancelRetailSaleRequest, { ...cancel, ...patch })).toEqual([field]);
     });
 
+    it.each([
+        ['sku', { sku: 'a/b' }],
+        ['identifier', { identifier: undefined }],
+        ['identifier', { identifier: ' ' }],
+        ['qty', { qty: 0 }],
+        ['qty', { qty: 2 }],
+    ])('rechaza damaged[].%s inválido', async (field, patch) => {
+        const damaged = [{ ...cancel.damaged[0], ...patch }];
+        expect(await errorsOf(CancelRetailSaleRequest, { ...cancel, damaged })).toEqual([`damaged.0.${field}`]);
+    });
+
     it('la respuesta trae el saleId', () => {
         const response: CancelRetailSaleResponse = { saleId: cancel.saleId };
         expect(response.saleId).toBe(cancel.saleId);

package/_test_/unit/retailIntegration/retailSystemEnums.test.ts

@@ -5,6 +5,7 @@ import {
     RetailFinancierEnum,
     RetailLinePaymentTypeEnum,
     RetailMdmProviderEnum,
+    RetailPaymentFrequencyEnum,
     RetailPaymentMethodEnum,
     RetailPieceReasonEnum,
     RetailPieceStatusEnum,
@@ -35,7 +36,8 @@ describe('enums de los objetos del retailer', () => {
         [RetailUserAccessStatusEnum, ['ACTIVE', 'SUSPENDED', 'INACTIVE']],
         [RetailSaleTypeEnum, ['CASH', 'CREDIT', 'EXTERNAL_REFERRAL']],
         [RetailSaleFinancierEnum, ['NONE', 'SUREKEEP', 'PAYJOY', 'CREDIYA', 'LESPAGO', 'INNOVA']],
-        [RetailPaymentMethodEnum, ['CASH', 'CARD', 'SPEI']],
+        [RetailPaymentMethodEnum, ['CASH', 'CARD', 'WIRE', 'FIADO']],
+        [RetailPaymentFrequencyEnum, ['WEEKLY', 'BIWEEKLY', 'MONTHLY']],
         [RetailLinePaymentTypeEnum, ['CASH', 'CREDIT']],
     ])('%p trae exactamente los valores del contrato', (enumObject, values) => {
         expect(Object.values(enumObject)).toEqual(values);

package/bin/retailIntegration/constants/retailIntegrationLimits.d.ts

@@ -45,3 +45,19 @@ export declare const RETAIL_LINE_INDEX_MIN = 0;
 export declare const RETAIL_LINE_INDEX_MAX = 999;
 /** Rango máximo de `GET /inventory/movements`: 7 días en milisegundos. */
 export declare const RETAIL_MOVEMENTS_RANGE_MAX_MS: number;
+/** Decimal de la venta y la cancelación: hasta 12 enteros y dos decimales, nunca negativo. */
+export declare const RETAIL_SALE_DECIMAL_PATTERN: RegExp;
+/** Decimal de la venta mayor que cero, como `payments[].amount`. */
+export declare const RETAIL_SALE_POSITIVE_DECIMAL_PATTERN: RegExp;
+/** Texto libre corto de la venta, como `authCode` y `promotionId`: no vacío y de a lo más 64. */
+export declare const RETAIL_SALE_ID_TEXT_PATTERN: RegExp;
+/** Últimos 4 dígitos de la tarjeta en un pago `CARD`. */
+export declare const RETAIL_CARD_LAST4_PATTERN: RegExp;
+/** Clave de rastreo SPEI de un pago `WIRE`: alfanumérica de 1 a 30, como la define Banxico. */
+export declare const RETAIL_SPEI_TRACKING_KEY_PATTERN: RegExp;
+/** CLABE de la cuenta que envió un pago `WIRE`: 18 dígitos. */
+export declare const RETAIL_CLABE_PATTERN: RegExp;
+/** Tope del motivo de cancelación de una venta. */
+export declare const RETAIL_CANCEL_REASON_MAX_LENGTH = 200;
+/** Teléfono del cliente en la venta: 10 dígitos. */
+export declare const RETAIL_CUSTOMER_PHONE_PATTERN: RegExp;

package/bin/retailIntegration/constants/retailIntegrationLimits.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RETAIL_MOVEMENTS_RANGE_MAX_MS = exports.RETAIL_LINE_INDEX_MAX = exports.RETAIL_LINE_INDEX_MIN = exports.RETAIL_ERROR_CODE_MAX_LENGTH = exports.RETAIL_EXTERNAL_ID_PATTERN = exports.RETAIL_NEXT_TOKEN_MAX_LENGTH = exports.RETAIL_EVENT_DECIMAL_PATTERN = exports.RETAIL_ELIGIBLE_FINANCIERS_MAX = exports.RETAIL_EVENT_STOCK_MAX = exports.RETAIL_LONG_TEXT_MAX_LENGTH = exports.RETAIL_SHORT_TEXT_MAX_LENGTH = exports.RETAIL_ID_TEXT_MAX_LENGTH = exports.RETAIL_EVENT_PIECES_MAX = exports.RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = exports.RETAIL_DECIMAL_PATTERN = exports.RETAIL_SKU_PATTERN = exports.RETAIL_ZIP_CODE_MAX_LENGTH = exports.RETAIL_ZIP_CODE_MIN_LENGTH = exports.RETAIL_STORE_CODE_MAX_LENGTH = exports.RETAIL_ZONE_ID_PATTERN = exports.RETAIL_ENTITY_ID_PATTERN = exports.RETAIL_TENANT_ID_PATTERN = exports.RETAIL_LIST_LIMIT_MAX = exports.RETAIL_LIST_LIMIT_MIN = exports.RETAIL_EVENT_ID_MAX_LENGTH = void 0;
+exports.RETAIL_CUSTOMER_PHONE_PATTERN = exports.RETAIL_CANCEL_REASON_MAX_LENGTH = exports.RETAIL_CLABE_PATTERN = exports.RETAIL_SPEI_TRACKING_KEY_PATTERN = exports.RETAIL_CARD_LAST4_PATTERN = exports.RETAIL_SALE_ID_TEXT_PATTERN = exports.RETAIL_SALE_POSITIVE_DECIMAL_PATTERN = exports.RETAIL_SALE_DECIMAL_PATTERN = exports.RETAIL_MOVEMENTS_RANGE_MAX_MS = exports.RETAIL_LINE_INDEX_MAX = exports.RETAIL_LINE_INDEX_MIN = exports.RETAIL_ERROR_CODE_MAX_LENGTH = exports.RETAIL_EXTERNAL_ID_PATTERN = exports.RETAIL_NEXT_TOKEN_MAX_LENGTH = exports.RETAIL_EVENT_DECIMAL_PATTERN = exports.RETAIL_ELIGIBLE_FINANCIERS_MAX = exports.RETAIL_EVENT_STOCK_MAX = exports.RETAIL_LONG_TEXT_MAX_LENGTH = exports.RETAIL_SHORT_TEXT_MAX_LENGTH = exports.RETAIL_ID_TEXT_MAX_LENGTH = exports.RETAIL_EVENT_PIECES_MAX = exports.RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = exports.RETAIL_DECIMAL_PATTERN = exports.RETAIL_SKU_PATTERN = exports.RETAIL_ZIP_CODE_MAX_LENGTH = exports.RETAIL_ZIP_CODE_MIN_LENGTH = exports.RETAIL_STORE_CODE_MAX_LENGTH = exports.RETAIL_ZONE_ID_PATTERN = exports.RETAIL_ENTITY_ID_PATTERN = exports.RETAIL_TENANT_ID_PATTERN = exports.RETAIL_LIST_LIMIT_MAX = exports.RETAIL_LIST_LIMIT_MIN = exports.RETAIL_EVENT_ID_MAX_LENGTH = void 0;
 /** Tope de `eventId`: el límite seguro de una llave de DynamoDB. */
 exports.RETAIL_EVENT_ID_MAX_LENGTH = 1024;
 /** Rango de `limit` en las listas paginadas del retailer. */
@@ -48,3 +48,19 @@ exports.RETAIL_LINE_INDEX_MIN = 0;
 exports.RETAIL_LINE_INDEX_MAX = 999;
 /** Rango máximo de `GET /inventory/movements`: 7 días en milisegundos. */
 exports.RETAIL_MOVEMENTS_RANGE_MAX_MS = 7 * 24 * 60 * 60 * 1000;
+/** Decimal de la venta y la cancelación: hasta 12 enteros y dos decimales, nunca negativo. */
+exports.RETAIL_SALE_DECIMAL_PATTERN = /^\d{1,12}\.\d{2}$/;
+/** Decimal de la venta mayor que cero, como `payments[].amount`. */
+exports.RETAIL_SALE_POSITIVE_DECIMAL_PATTERN = /^(?=.*[1-9])\d{1,12}\.\d{2}$/;
+/** Texto libre corto de la venta, como `authCode` y `promotionId`: no vacío y de a lo más 64. */
+exports.RETAIL_SALE_ID_TEXT_PATTERN = /^(?=.*\S).{1,64}$/;
+/** Últimos 4 dígitos de la tarjeta en un pago `CARD`. */
+exports.RETAIL_CARD_LAST4_PATTERN = /^\d{4}$/;
+/** Clave de rastreo SPEI de un pago `WIRE`: alfanumérica de 1 a 30, como la define Banxico. */
+exports.RETAIL_SPEI_TRACKING_KEY_PATTERN = /^[A-Za-z0-9]{1,30}$/;
+/** CLABE de la cuenta que envió un pago `WIRE`: 18 dígitos. */
+exports.RETAIL_CLABE_PATTERN = /^\d{18}$/;
+/** Tope del motivo de cancelación de una venta. */
+exports.RETAIL_CANCEL_REASON_MAX_LENGTH = 200;
+/** Teléfono del cliente en la venta: 10 dígitos. */
+exports.RETAIL_CUSTOMER_PHONE_PATTERN = /^\d{10}$/;

package/bin/retailIntegration/dtos/CancelRetailSaleRequest.d.ts

@@ -1,6 +1,13 @@
+/** Lo que regresa dañado al cancelar; `identifier` en `null` si el producto es `QUANTITY`. */
+export declare class RetailSystemDamagedItem {
+    sku: string;
+    identifier: string | null;
+    qty: number;
+}
 /** Cuerpo de `POST /private/retail/sales/cancel`; el `saleId` es el mismo del registro. */
 export declare class CancelRetailSaleRequest {
     saleId: string;
     cancelledAt: string;
     reason: string;
+    damaged: RetailSystemDamagedItem[];
 }

package/bin/retailIntegration/dtos/CancelRetailSaleRequest.js

@@ -9,9 +9,35 @@ 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.CancelRetailSaleRequest = void 0;
+exports.CancelRetailSaleRequest = exports.RetailSystemDamagedItem = void 0;
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const retailIntegrationLimits_1 = require("../constants/retailIntegrationLimits");
 const IsIsoDateTimeWithZone_1 = require("../validators/IsIsoDateTimeWithZone");
+const payloadValidators_1 = require("../validators/payloadValidators");
+const saleValidators_1 = require("../validators/saleValidators");
+/** Lo que regresa dañado al cancelar; `identifier` en `null` si el producto es `QUANTITY`. */
+class RetailSystemDamagedItem {
+}
+exports.RetailSystemDamagedItem = RetailSystemDamagedItem;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_SKU_PATTERN),
+    __metadata("design:type", String)
+], RetailSystemDamagedItem.prototype, "sku", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_SHORT_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], RetailSystemDamagedItem.prototype, "identifier", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Validate)(saleValidators_1.QtyMatchesIdentifier),
+    __metadata("design:type", Number)
+], RetailSystemDamagedItem.prototype, "qty", void 0);
 /** Cuerpo de `POST /private/retail/sales/cancel`; el `saleId` es el mismo del registro. */
 class CancelRetailSaleRequest {
 }
@@ -28,5 +54,12 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_CANCEL_REASON_MAX_LENGTH),
     __metadata("design:type", String)
 ], CancelRetailSaleRequest.prototype, "reason", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RetailSystemDamagedItem),
+    __metadata("design:type", Array)
+], CancelRetailSaleRequest.prototype, "damaged", void 0);

package/bin/retailIntegration/dtos/RetailOutboundResponses.d.ts

@@ -1,3 +1,4 @@
+import { RetailEventRejectCodeEnum } from '../enums';
 import { RetailInventoryMeta, RetailPageMeta } from '../models/RetailPageMeta';
 import { RetailSystemInventoryMovement, RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
 import { RetailSystemProduct } from '../models/RetailSystemProduct';
@@ -19,10 +20,18 @@ export interface GetRetailInventoryResponse {
     stock: RetailSystemStock[];
     meta: RetailInventoryMeta;
 }
-/** `data` de `GET /private/retail/inventory/movements`. */
+/** Movimiento de la página que no cumple el sobre del webhook; catalog lo salta y lo cuenta. */
+export interface InvalidRetailInventoryMovement {
+    index: number;
+    eventId?: string;
+    code: RetailEventRejectCodeEnum.INVALID_PAYLOAD;
+    invalidPaths: string[];
+}
+/** `data` de `GET /private/retail/inventory/movements`; `invalidItems` lista los movimientos descartados. */
 export interface ListRetailInventoryMovementsResponse {
     items: RetailSystemInventoryMovement[];
     meta: RetailPageMeta;
+    invalidItems?: InvalidRetailInventoryMovement[];
 }
 /** `data` de `GET /private/retail/users`. */
 export interface ListRetailUsersResponse {

package/bin/retailIntegration/enums/RetailPaymentFrequencyEnum.d.ts

@@ -0,0 +1,6 @@
+/** Cada cuánto paga el cliente en `credit.paymentFrequency`. */
+export declare enum RetailPaymentFrequencyEnum {
+    WEEKLY = "WEEKLY",
+    BIWEEKLY = "BIWEEKLY",
+    MONTHLY = "MONTHLY"
+}

package/bin/retailIntegration/enums/RetailPaymentFrequencyEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailPaymentFrequencyEnum = void 0;
+/** Cada cuánto paga el cliente en `credit.paymentFrequency`. */
+var RetailPaymentFrequencyEnum;
+(function (RetailPaymentFrequencyEnum) {
+    RetailPaymentFrequencyEnum["WEEKLY"] = "WEEKLY";
+    RetailPaymentFrequencyEnum["BIWEEKLY"] = "BIWEEKLY";
+    RetailPaymentFrequencyEnum["MONTHLY"] = "MONTHLY";
+})(RetailPaymentFrequencyEnum || (exports.RetailPaymentFrequencyEnum = RetailPaymentFrequencyEnum = {}));

package/bin/retailIntegration/enums/RetailPaymentMethodEnum.d.ts

@@ -1,6 +1,7 @@
-/** Método de pago de la venta. */
+/** Medio de pago de `payments[].method` en la venta. */
 export declare enum RetailPaymentMethodEnum {
     CASH = "CASH",
     CARD = "CARD",
-    SPEI = "SPEI"
+    WIRE = "WIRE",
+    FIADO = "FIADO"
 }

package/bin/retailIntegration/enums/RetailPaymentMethodEnum.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetailPaymentMethodEnum = void 0;
-/** Método de pago de la venta. */
+/** Medio de pago de `payments[].method` en la venta. */
 var RetailPaymentMethodEnum;
 (function (RetailPaymentMethodEnum) {
     RetailPaymentMethodEnum["CASH"] = "CASH";
     RetailPaymentMethodEnum["CARD"] = "CARD";
-    RetailPaymentMethodEnum["SPEI"] = "SPEI";
+    RetailPaymentMethodEnum["WIRE"] = "WIRE";
+    RetailPaymentMethodEnum["FIADO"] = "FIADO";
 })(RetailPaymentMethodEnum || (exports.RetailPaymentMethodEnum = RetailPaymentMethodEnum = {}));

package/bin/retailIntegration/enums/index.d.ts

@@ -18,6 +18,7 @@ export * from './RetailUserAccessStatusEnum';
 export * from './RetailSaleTypeEnum';
 export * from './RetailSaleFinancierEnum';
 export * from './RetailPaymentMethodEnum';
+export * from './RetailPaymentFrequencyEnum';
 export * from './RetailLinePaymentTypeEnum';
 export * from './RetailSaleLineRoleEnum';
 export * from './RetailEventRejectCodeEnum';

package/bin/retailIntegration/enums/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./RetailUserAccessStatusEnum"), exports);
 __exportStar(require("./RetailSaleTypeEnum"), exports);
 __exportStar(require("./RetailSaleFinancierEnum"), exports);
 __exportStar(require("./RetailPaymentMethodEnum"), exports);
+__exportStar(require("./RetailPaymentFrequencyEnum"), exports);
 __exportStar(require("./RetailLinePaymentTypeEnum"), exports);
 __exportStar(require("./RetailSaleLineRoleEnum"), exports);
 __exportStar(require("./RetailEventRejectCodeEnum"), exports);

package/bin/retailIntegration/index.d.ts

@@ -3,6 +3,8 @@ export * from './constants/retailIntegrationErrorHttpStatus';
 export * from './enums';
 export * from './validators/IsIsoDateTimeWithZone';
 export * from './validators/IsMovementsRangeValid';
+export * from './validators/IsCalendarDate';
+export * from './validators/saleValidators';
 export * from './dtos/RetailEventEnvelope';
 export * from './dtos/ReceiveStoreEventRequest';
 export * from './dtos/ReceiveRetailUserEventRequest';

package/bin/retailIntegration/index.js

@@ -19,6 +19,8 @@ __exportStar(require("./constants/retailIntegrationErrorHttpStatus"), exports);
 __exportStar(require("./enums"), exports);
 __exportStar(require("./validators/IsIsoDateTimeWithZone"), exports);
 __exportStar(require("./validators/IsMovementsRangeValid"), exports);
+__exportStar(require("./validators/IsCalendarDate"), exports);
+__exportStar(require("./validators/saleValidators"), exports);
 __exportStar(require("./dtos/RetailEventEnvelope"), exports);
 __exportStar(require("./dtos/ReceiveStoreEventRequest"), exports);
 __exportStar(require("./dtos/ReceiveRetailUserEventRequest"), exports);

package/bin/retailIntegration/models/RetailSystemSale.d.ts

@@ -1,8 +1,9 @@
-import { RetailLinePaymentTypeEnum, RetailPaymentMethodEnum, RetailSaleFinancierEnum, RetailSaleLineRoleEnum, RetailSaleTypeEnum } from '../enums';
+import { RetailLinePaymentTypeEnum, RetailPaymentFrequencyEnum, RetailPaymentMethodEnum, RetailSaleFinancierEnum, RetailSaleLineRoleEnum, RetailSaleTypeEnum } from '../enums';
 import { RetailCurrency } from './RetailSystemProduct';
 export type RetailSaleType = `${RetailSaleTypeEnum}`;
 export type RetailSaleFinancier = `${RetailSaleFinancierEnum}`;
 export type RetailPaymentMethod = `${RetailPaymentMethodEnum}`;
+export type RetailPaymentFrequency = `${RetailPaymentFrequencyEnum}`;
 export type RetailLinePaymentType = `${RetailLinePaymentTypeEnum}`;
 export type RetailSaleLineRole = `${RetailSaleLineRoleEnum}`;
 export declare class RetailSystemSaleCustomer {
@@ -12,6 +13,24 @@ export declare class RetailSystemSaleCustomer {
     maternalLastName: string | null;
     phone: string;
 }
+/** Condiciones del crédito; todas obligatorias cuando `credit` no es `null`. */
+export declare class RetailSystemSaleCredit {
+    paymentFrequency: RetailPaymentFrequency;
+    installments: number;
+    installmentAmount: string;
+    downPayment: string;
+    totalToPay: string;
+    firstPaymentDate: string;
+}
+/** Un medio de pago de `amountPaid`; las seis llaves van siempre, en `null` las que no aplican. */
+export declare class RetailSystemSalePayment {
+    method: RetailPaymentMethod;
+    amount: string;
+    cardLast4: string | null;
+    authCode: string | null;
+    speiTrackingKey: string | null;
+    senderClabe: string | null;
+}
 export declare class RetailSystemSaleComponent {
     sku: string;
     qty: number;
@@ -26,6 +45,7 @@ export declare class RetailSystemSaleLine {
     paymentType: RetailLinePaymentType;
     financedAmount: string;
     role: RetailSaleLineRole | null;
+    promotionId: string | null;
     components: RetailSystemSaleComponent[];
 }
 /** Cuerpo de `POST /sales` de la doc y de `privateRegisterRetailSale`; `saleId` es la llave de idempotencia. */
@@ -38,10 +58,11 @@ export declare class RetailSystemSale {
     saleType: RetailSaleType;
     financier: RetailSaleFinancier;
     creditId: string | null;
+    credit: RetailSystemSaleCredit | null;
     currencyId: RetailCurrency;
     customer: RetailSystemSaleCustomer;
     equipmentPrice: string;
     amountPaid: string;
-    paymentMethod: RetailPaymentMethod | null;
+    payments: RetailSystemSalePayment[];
     lines: RetailSystemSaleLine[];
 }