@fiado/type-kit 3.597.0 → 3.599.0

package/bin/messageMoments/constants/MessageMomentClassification.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MANUAL_SEND_MOMENTS = exports.COLLECTION_MOMENT_OVERRIDES = exports.COLLECTION_BLOCKS = exports.CREDIT_CATEGORY_OVERRIDES = exports.BLOCK_DEFAULT_CATEGORY = void 0;
+exports.classifyMoment = classifyMoment;
+const MessageMomentBlockEnum_1 = require("../enums/MessageMomentBlockEnum");
+const MessageMomentCategoryEnum_1 = require("../enums/MessageMomentCategoryEnum");
+const MessageMomentEnum_1 = require("../enums/MessageMomentEnum");
+/** Categoría por defecto de cada bloque; un momento nuevo la hereda. */
+exports.BLOCK_DEFAULT_CATEGORY = {
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.ORIGINATION]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.SALE,
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.REMINDERS]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.PAYMENTS]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.COLLECTIONS]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.DEVICE_LOCK]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.EXCEPTIONS]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.CLOSURE]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.SERVICE]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.SALE,
+    [MessageMomentBlockEnum_1.MessageMomentBlockEnum.REFERRALS]: MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.SALE,
+};
+/** Momentos del bloque de servicio que van al historial del crédito. */
+exports.CREDIT_CATEGORY_OVERRIDES = new Set([
+    MessageMomentEnum_1.MessageMomentEnum.MONTHLY_STATEMENT,
+    MessageMomentEnum_1.MessageMomentEnum.CAT_TERMS_NOTICE,
+    MessageMomentEnum_1.MessageMomentEnum.PRIVACY_ARCO_NOTICE,
+]);
+/** Bloques cuyos momentos son de cobranza y cuentan contra el tope diario. */
+exports.COLLECTION_BLOCKS = new Set([
+    MessageMomentBlockEnum_1.MessageMomentBlockEnum.REMINDERS,
+    MessageMomentBlockEnum_1.MessageMomentBlockEnum.COLLECTIONS,
+]);
+/** Momentos de cobranza fuera de esos bloques. */
+exports.COLLECTION_MOMENT_OVERRIDES = new Set([
+    MessageMomentEnum_1.MessageMomentEnum.PAYMENT_REJECTED,
+    MessageMomentEnum_1.MessageMomentEnum.MDM_LOCK_APPLIED,
+    MessageMomentEnum_1.MessageMomentEnum.LAST_INSTALLMENT,
+]);
+/** Momentos que el backoffice puede enviar a mano a un cliente. */
+exports.MANUAL_SEND_MOMENTS = new Set([
+    MessageMomentEnum_1.MessageMomentEnum.F5_FRAUD_CONFIRMED,
+    MessageMomentEnum_1.MessageMomentEnum.CAT_TERMS_NOTICE,
+    MessageMomentEnum_1.MessageMomentEnum.PRIVACY_ARCO_NOTICE,
+    MessageMomentEnum_1.MessageMomentEnum.REFERRAL_COUPON_ISSUED,
+]);
+/** Clasificación de un momento: la de su bloque, salvo que esté en una lista de excepciones. */
+function classifyMoment(messageType, blockId) {
+    return {
+        category: exports.CREDIT_CATEGORY_OVERRIDES.has(messageType) ? MessageMomentCategoryEnum_1.MessageMomentCategoryEnum.CREDIT : exports.BLOCK_DEFAULT_CATEGORY[blockId],
+        collection: exports.COLLECTION_BLOCKS.has(blockId) || exports.COLLECTION_MOMENT_OVERRIDES.has(messageType),
+        manualSend: exports.MANUAL_SEND_MOMENTS.has(messageType),
+    };
+}

package/bin/messageMoments/enums/MessageMomentCategoryEnum.d.ts

@@ -0,0 +1,5 @@
+/** A qué historial del cliente pertenece un momento: la venta o el crédito. */
+export declare enum MessageMomentCategoryEnum {
+    SALE = "SALE",
+    CREDIT = "CREDIT"
+}

package/bin/messageMoments/enums/MessageMomentCategoryEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageMomentCategoryEnum = void 0;
+/** A qué historial del cliente pertenece un momento: la venta o el crédito. */
+var MessageMomentCategoryEnum;
+(function (MessageMomentCategoryEnum) {
+    MessageMomentCategoryEnum["SALE"] = "SALE";
+    MessageMomentCategoryEnum["CREDIT"] = "CREDIT";
+})(MessageMomentCategoryEnum || (exports.MessageMomentCategoryEnum = MessageMomentCategoryEnum = {}));

package/bin/messageMoments/index.d.ts

@@ -1,5 +1,7 @@
 export * from './enums/MessageMomentEnum';
 export * from './enums/MessageMomentBlockEnum';
+export * from './enums/MessageMomentCategoryEnum';
+export * from './constants/MessageMomentClassification';
 export * from './constants/MessageMomentVariables';
 export * from './constants/MessageMomentCatalog';
 export * from './constants/TemplatePlaceholder';

package/bin/messageMoments/index.js

@@ -16,6 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enums/MessageMomentEnum"), exports);
 __exportStar(require("./enums/MessageMomentBlockEnum"), exports);
+__exportStar(require("./enums/MessageMomentCategoryEnum"), exports);
+__exportStar(require("./constants/MessageMomentClassification"), exports);
 __exportStar(require("./constants/MessageMomentVariables"), exports);
 __exportStar(require("./constants/MessageMomentCatalog"), exports);
 __exportStar(require("./constants/TemplatePlaceholder"), exports);

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

@@ -1,6 +1,7 @@
 import type { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
 import type { ReconciliationRunStatusEnum } from '../enums/ReconciliationRunStatusEnum';
 import type { ReconciliationTriggerEnum } from '../enums/ReconciliationTriggerEnum';
+import type { ReconciliationPreview } from './ReconciliationPreview';
 import type { ReconciliationRunCounts } from './ReconciliationRunCounts';
 /** Respuesta 200 de GET .../reconciliations/{runId} en org (backofficeGetOrgReconciliation). */
 export interface GetOrgReconciliationResponse {
@@ -15,6 +16,10 @@ export interface GetOrgReconciliationResponse {
     finishedAt?: string;
     pagesProcessed: number;
     counts: ReconciliationRunCounts;
+    /** La corrida fue en modo prueba y no escribió nada. */
+    dryRun?: boolean;
+    /** Vista previa de una corrida en modo prueba. */
+    preview?: ReconciliationPreview;
 }
 /** Respuesta 200 de GET .../reconciliations/{runId} en catalog (backofficeGetCatalogReconciliation). */
 export interface GetCatalogReconciliationResponse {
@@ -40,4 +45,8 @@ export interface GetCatalogReconciliationResponse {
     /** Fin ISO de la ventana revisada en movimientos. */
     movementsTo?: string;
     counts: ReconciliationRunCounts;
+    /** La corrida fue en modo prueba y no escribió nada. */
+    dryRun?: boolean;
+    /** Vista previa de una corrida en modo prueba. */
+    preview?: ReconciliationPreview;
 }

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

@@ -0,0 +1,21 @@
+/** Tope de renglones por lista de la vista previa; si se pasa, `truncated` es true. */
+export declare const RECONCILIATION_PREVIEW_MAX_ITEMS = 200;
+/** Renglón de la vista previa: `id` es storeId, retailUserId, sku o identifier según la entidad. */
+export interface ReconciliationPreviewItem {
+    id: string;
+    /** Nombre legible para mostrar en el backoffice. */
+    label?: string;
+    /** Campos que cambiarían, solo en `updated`. */
+    fields?: string[];
+    /** Tienda de la pieza en inventario. */
+    storeId?: string;
+}
+/** Lo que haría una corrida en modo prueba (`dryRun`), sin escribir nada. */
+export interface ReconciliationPreview {
+    created: ReconciliationPreviewItem[];
+    updated: ReconciliationPreviewItem[];
+    deactivated: ReconciliationPreviewItem[];
+    reactivated: ReconciliationPreviewItem[];
+    /** Alguna lista se cortó en RECONCILIATION_PREVIEW_MAX_ITEMS. */
+    truncated: boolean;
+}

package/bin/retailIntegration/dtos/ReconciliationPreview.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECONCILIATION_PREVIEW_MAX_ITEMS = void 0;
+/** Tope de renglones por lista de la vista previa; si se pasa, `truncated` es true. */
+exports.RECONCILIATION_PREVIEW_MAX_ITEMS = 200;

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

@@ -1,9 +1,21 @@
+import type { RetailEventRejectCodeEnum } from '../enums/RetailEventRejectCodeEnum';
 import { RetailEventResultEnum } from '../enums/RetailEventResultEnum';
+/** Renglón inválido de un evento de inventario; `index` es 0-based en `pieces` o en `stock` según `kind`. */
+export interface RetailEventItemError {
+    index: number;
+    kind?: 'piece' | 'stock';
+    identifier?: string;
+    sku?: string;
+    storeId?: string;
+    code: RetailEventRejectCodeEnum;
+}
 /** Resultado de un evento; `code` explica un `REJECTED` y es `null` en los demás. */
 export interface RetailEventResult {
     eventId: string;
     result: RetailEventResultEnum;
     code: string | null;
+    /** Todos los renglones inválidos de un `REJECTED` de inventario, no solo el primero. */
+    errors?: RetailEventItemError[];
 }
 export type ReceiveStoreEventResponse = RetailEventResult;
 export type ReceiveRetailUserEventResponse = RetailEventResult;

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

@@ -4,6 +4,8 @@ export declare class StartCatalogReconciliationRequest {
     entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY;
     /** Tienda a revisar en inventario; sin ella se revisan todas las del padrón. */
     storeId?: string;
+    /** Modo prueba: calcula la vista previa sin escribir nada. */
+    dryRun?: boolean;
 }
 /** Respuesta 202 del arranque en catalog. */
 export interface StartCatalogReconciliationResponse {

package/bin/retailIntegration/dtos/StartCatalogReconciliationRequest.js

@@ -29,3 +29,9 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], StartCatalogReconciliationRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], StartCatalogReconciliationRequest.prototype, "dryRun", void 0);

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

@@ -2,6 +2,8 @@ import { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
 /** Body de POST /backoffice/retailers/{retailerId}/reconciliations en org (backofficeStartOrgReconciliation). */
 export declare class StartOrgReconciliationRequest {
     entity: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
+    /** Modo prueba: calcula la vista previa sin escribir nada. */
+    dryRun?: boolean;
 }
 /** Respuesta 202 del arranque en org. */
 export interface StartOrgReconciliationResponse {

package/bin/retailIntegration/dtos/StartOrgReconciliationRequest.js

@@ -22,3 +22,9 @@ __decorate([
     (0, class_validator_1.IsIn)([ReconciliationEntityEnum_1.ReconciliationEntityEnum.STORES, ReconciliationEntityEnum_1.ReconciliationEntityEnum.USERS]),
     __metadata("design:type", String)
 ], StartOrgReconciliationRequest.prototype, "entity", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], StartOrgReconciliationRequest.prototype, "dryRun", void 0);

package/bin/retailIntegration/index.d.ts

@@ -38,5 +38,6 @@ export * from './models/RetailSystemSale';
 export * from './dtos/StartOrgReconciliationRequest';
 export * from './dtos/StartCatalogReconciliationRequest';
 export * from './dtos/ReconciliationRunCounts';
+export * from './dtos/ReconciliationPreview';
 export * from './dtos/GetReconciliationResponses';
 export * from './dtos/ReconciliationPageMessage';

package/bin/retailIntegration/index.js

@@ -54,5 +54,6 @@ __exportStar(require("./models/RetailSystemSale"), exports);
 __exportStar(require("./dtos/StartOrgReconciliationRequest"), exports);
 __exportStar(require("./dtos/StartCatalogReconciliationRequest"), exports);
 __exportStar(require("./dtos/ReconciliationRunCounts"), exports);
+__exportStar(require("./dtos/ReconciliationPreview"), exports);
 __exportStar(require("./dtos/GetReconciliationResponses"), exports);
 __exportStar(require("./dtos/ReconciliationPageMessage"), exports);

package/package.json

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

package/src/customerMessages/constants/CustomerMessageLimits.ts

@@ -0,0 +1,13 @@
+import { DeliveryChannelExtendedEnum } from '../../messagesConnector/enums/DeliveryChannelExtendedEnum';
+
+/** Máximo de mensajes por página del historial del cliente. */
+export const CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT = 50;
+
+/** Id de ficha de un momento: `PM-` y tres dígitos. */
+export const MESSAGE_MOMENT_TEMPLATE_ID_PATTERN = /^PM-\d{3}$/;
+
+/** Canales por los que el backoffice puede enviar un momento a mano. */
+export const CUSTOMER_MANUAL_MESSAGE_CHANNELS: readonly DeliveryChannelExtendedEnum[] = [
+    DeliveryChannelExtendedEnum.SMS,
+    DeliveryChannelExtendedEnum.PUSH_NOTIFICATION,
+];

package/src/customerMessages/dtos/requests/CustomerManualMessageRequest.ts

@@ -0,0 +1,16 @@
+import { Expose } from 'class-transformer';
+import { IsIn, IsString, Matches } from 'class-validator';
+import { DeliveryChannelExtendedEnum } from '../../../messagesConnector/enums/DeliveryChannelExtendedEnum';
+import { CUSTOMER_MANUAL_MESSAGE_CHANNELS, MESSAGE_MOMENT_TEMPLATE_ID_PATTERN } from '../../constants/CustomerMessageLimits';
+
+/** Body del envío manual de un momento a un cliente desde el backoffice. */
+export class CustomerManualMessageRequest {
+    @Expose()
+    @IsString()
+    @Matches(MESSAGE_MOMENT_TEMPLATE_ID_PATTERN)
+    templateId!: string;
+
+    @Expose()
+    @IsIn(CUSTOMER_MANUAL_MESSAGE_CHANNELS)
+    channel!: DeliveryChannelExtendedEnum;
+}

package/src/customerMessages/dtos/requests/CustomerMessageHistoryQuery.ts

@@ -0,0 +1,25 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { MessageMomentCategoryEnum } from '../../../messageMoments/enums/MessageMomentCategoryEnum';
+import { CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT } from '../../constants/CustomerMessageLimits';
+
+/** Query del historial de mensajes de un cliente, filtrado por venta o crédito. */
+export class CustomerMessageHistoryQuery {
+    @Expose()
+    @IsEnum(MessageMomentCategoryEnum)
+    category!: MessageMomentCategoryEnum;
+
+    /** Cursor opaco de la página anterior. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    cursor?: string;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT)
+    limit?: number;
+}

package/src/customerMessages/dtos/responses/CollectionQuotaDay.ts

@@ -0,0 +1,10 @@
+import { DeliveryChannelExtendedEnum } from '../../../messagesConnector/enums/DeliveryChannelExtendedEnum';
+
+/** Mensajes de cobranza de un día de tienda en un canal: enviados y bloqueados por el tope. */
+export class CollectionQuotaDay {
+    /** YYYY-MM-DD en la zona de la tienda. */
+    storeDay!: string;
+    channel!: DeliveryChannelExtendedEnum;
+    sent!: number;
+    blocked!: number;
+}

package/src/customerMessages/dtos/responses/CollectionQuotaResponse.ts

@@ -0,0 +1,9 @@
+import { CollectionQuotaDay } from './CollectionQuotaDay';
+
+/** Contador diario de cobranza del cliente por canal. */
+export class CollectionQuotaResponse {
+    maxPerChannel!: number;
+    /** YYYY-MM-DD del día de tienda actual. */
+    today!: string;
+    days!: CollectionQuotaDay[];
+}

package/src/customerMessages/dtos/responses/CustomerManualMessageResponse.ts

@@ -0,0 +1,4 @@
+/** Respuesta del envío manual: el id del mensaje encolado. */
+export class CustomerManualMessageResponse {
+    queueMessageId!: string;
+}

package/src/customerMessages/dtos/responses/CustomerMessageHistoryItem.ts

@@ -0,0 +1,20 @@
+import { MessageMomentCategoryEnum } from '../../../messageMoments/enums/MessageMomentCategoryEnum';
+import { DeliveryChannelExtendedEnum } from '../../../messagesConnector/enums/DeliveryChannelExtendedEnum';
+import { MessageLogStatusEnum } from '../../../messagesConnector/enums/MessageLogStatusEnum';
+import { NotificationOriginEnum } from '../../../messagesConnector/enums/NotificationOriginEnum';
+
+/** Un mensaje del historial del cliente, clasificado por su momento. */
+export class CustomerMessageHistoryItem {
+    messageId!: string;
+    templateId!: string;
+    messageType!: string;
+    category!: MessageMomentCategoryEnum;
+    collection!: boolean;
+    channelType!: DeliveryChannelExtendedEnum;
+    status!: MessageLogStatusEnum;
+    /** Null cuando el texto no se muestra, como el OTP. */
+    renderedMessage!: string | null;
+    origin!: NotificationOriginEnum;
+    /** ISO 8601. */
+    createdAt!: string;
+}

package/src/customerMessages/dtos/responses/CustomerMessageHistoryResponse.ts

@@ -0,0 +1,9 @@
+import { CustomerMessageHistoryItem } from './CustomerMessageHistoryItem';
+
+/** Página del historial del cliente, del más nuevo al más viejo. `nextCursor` en null: no hay más. */
+export class CustomerMessageHistoryResponse {
+    /** False si el cliente no tiene cuenta Fiado; entonces `items` viene vacío. */
+    hasFiadoAccount!: boolean;
+    items!: CustomerMessageHistoryItem[];
+    nextCursor!: string | null;
+}

package/src/customerMessages/index.ts

@@ -0,0 +1,8 @@
+export * from './constants/CustomerMessageLimits';
+export * from './dtos/requests/CustomerMessageHistoryQuery';
+export * from './dtos/requests/CustomerManualMessageRequest';
+export * from './dtos/responses/CustomerMessageHistoryItem';
+export * from './dtos/responses/CustomerMessageHistoryResponse';
+export * from './dtos/responses/CollectionQuotaDay';
+export * from './dtos/responses/CollectionQuotaResponse';
+export * from './dtos/responses/CustomerManualMessageResponse';

package/src/index.ts

@@ -224,3 +224,6 @@ export * as LoanRetailAudit from './loanRetailAudit';
 
 // TaskManager: DTOs del lambda task-manager-business (gestor genérico de tareas; primer tipo MARKETING_MATERIAL).
 export * as TaskManager from './task-manager-business';
+
+// CustomerMessages: historial de mensajes del cliente por venta o crédito, contador de cobranza y envío manual.
+export * as CustomerMessages from './customerMessages';

package/src/messageMoments/constants/MessageMomentCatalog.ts

@@ -1,5 +1,7 @@
 import { MessageMomentEnum } from '../enums/MessageMomentEnum';
 import { MessageMomentBlockEnum } from '../enums/MessageMomentBlockEnum';
+import { MessageMomentCategoryEnum } from '../enums/MessageMomentCategoryEnum';
+import { classifyMoment } from './MessageMomentClassification';
 import {
     CREDIT_MOMENT_ALWAYS_VARIABLES,
     CREDIT_MOMENT_CONDITIONAL_VARIABLES,
@@ -20,6 +22,12 @@ export interface MessageMomentIdentity {
     blockId: MessageMomentBlockEnum;
     alwaysVariables: readonly string[];
     conditionalVariables: readonly string[];
+    /** Historial del cliente donde aparece: venta o crédito. */
+    category: MessageMomentCategoryEnum;
+    /** Es cobranza: cuenta contra el tope diario por canal. */
+    collection: boolean;
+    /** El backoffice lo puede enviar a mano. */
+    manualSend: boolean;
 }
 
 /** Un momento del crédito: las variables del crédito más las que solo emite él. */
@@ -30,6 +38,7 @@ function creditMoment(templateId: string, messageType: MessageMomentEnum, blockI
         blockId,
         alwaysVariables: [...CREDIT_MOMENT_ALWAYS_VARIABLES, ...(MOMENT_SPECIFIC_VARIABLES[messageType] ?? [])],
         conditionalVariables: CREDIT_MOMENT_CONDITIONAL_VARIABLES,
+        ...classifyMoment(messageType, blockId),
     };
 }
 
@@ -41,7 +50,7 @@ function standaloneMoment(
     alwaysVariables: readonly string[],
     conditionalVariables: readonly string[] = [],
 ): MessageMomentIdentity {
-    return { templateId, messageType, blockId, alwaysVariables, conditionalVariables };
+    return { templateId, messageType, blockId, alwaysVariables, conditionalVariables, ...classifyMoment(messageType, blockId) };
 }
 
 const B = MessageMomentBlockEnum;
@@ -100,3 +109,13 @@ export const momentByTemplateId: ReadonlyMap<string, MessageMomentIdentity> = ne
 export const momentByMessageType: ReadonlyMap<string, MessageMomentIdentity> = new Map(
     MESSAGE_MOMENT_CATALOG.map((moment) => [moment.messageType, moment]),
 );
+
+/** Si el messageType es de cobranza; false para lo que no está en el catálogo. */
+export function isCollectionMoment(messageType: string): boolean {
+    return momentByMessageType.get(messageType)?.collection ?? false;
+}
+
+/** Los momentos de una categoría, en el orden del catálogo. */
+export function momentsOfCategory(category: MessageMomentCategoryEnum): readonly MessageMomentIdentity[] {
+    return MESSAGE_MOMENT_CATALOG.filter((moment) => moment.category === category);
+}

package/src/messageMoments/constants/MessageMomentClassification.ts

@@ -0,0 +1,56 @@
+import { MessageMomentBlockEnum } from '../enums/MessageMomentBlockEnum';
+import { MessageMomentCategoryEnum } from '../enums/MessageMomentCategoryEnum';
+import { MessageMomentEnum } from '../enums/MessageMomentEnum';
+
+/** Categoría por defecto de cada bloque; un momento nuevo la hereda. */
+export const BLOCK_DEFAULT_CATEGORY: Readonly<Record<MessageMomentBlockEnum, MessageMomentCategoryEnum>> = {
+    [MessageMomentBlockEnum.ORIGINATION]: MessageMomentCategoryEnum.SALE,
+    [MessageMomentBlockEnum.REMINDERS]: MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum.PAYMENTS]: MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum.COLLECTIONS]: MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum.DEVICE_LOCK]: MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum.EXCEPTIONS]: MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum.CLOSURE]: MessageMomentCategoryEnum.CREDIT,
+    [MessageMomentBlockEnum.SERVICE]: MessageMomentCategoryEnum.SALE,
+    [MessageMomentBlockEnum.REFERRALS]: MessageMomentCategoryEnum.SALE,
+};
+
+/** Momentos del bloque de servicio que van al historial del crédito. */
+export const CREDIT_CATEGORY_OVERRIDES: ReadonlySet<MessageMomentEnum> = new Set([
+    MessageMomentEnum.MONTHLY_STATEMENT,
+    MessageMomentEnum.CAT_TERMS_NOTICE,
+    MessageMomentEnum.PRIVACY_ARCO_NOTICE,
+]);
+
+/** Bloques cuyos momentos son de cobranza y cuentan contra el tope diario. */
+export const COLLECTION_BLOCKS: ReadonlySet<MessageMomentBlockEnum> = new Set([
+    MessageMomentBlockEnum.REMINDERS,
+    MessageMomentBlockEnum.COLLECTIONS,
+]);
+
+/** Momentos de cobranza fuera de esos bloques. */
+export const COLLECTION_MOMENT_OVERRIDES: ReadonlySet<MessageMomentEnum> = new Set([
+    MessageMomentEnum.PAYMENT_REJECTED,
+    MessageMomentEnum.MDM_LOCK_APPLIED,
+    MessageMomentEnum.LAST_INSTALLMENT,
+]);
+
+/** Momentos que el backoffice puede enviar a mano a un cliente. */
+export const MANUAL_SEND_MOMENTS: ReadonlySet<MessageMomentEnum> = new Set([
+    MessageMomentEnum.F5_FRAUD_CONFIRMED,
+    MessageMomentEnum.CAT_TERMS_NOTICE,
+    MessageMomentEnum.PRIVACY_ARCO_NOTICE,
+    MessageMomentEnum.REFERRAL_COUPON_ISSUED,
+]);
+
+/** Clasificación de un momento: la de su bloque, salvo que esté en una lista de excepciones. */
+export function classifyMoment(
+    messageType: MessageMomentEnum,
+    blockId: MessageMomentBlockEnum,
+): { category: MessageMomentCategoryEnum; collection: boolean; manualSend: boolean } {
+    return {
+        category: CREDIT_CATEGORY_OVERRIDES.has(messageType) ? MessageMomentCategoryEnum.CREDIT : BLOCK_DEFAULT_CATEGORY[blockId],
+        collection: COLLECTION_BLOCKS.has(blockId) || COLLECTION_MOMENT_OVERRIDES.has(messageType),
+        manualSend: MANUAL_SEND_MOMENTS.has(messageType),
+    };
+}

package/src/messageMoments/enums/MessageMomentCategoryEnum.ts

@@ -0,0 +1,5 @@
+/** A qué historial del cliente pertenece un momento: la venta o el crédito. */
+export enum MessageMomentCategoryEnum {
+    SALE = 'SALE',
+    CREDIT = 'CREDIT',
+}

package/src/messageMoments/index.ts

@@ -1,5 +1,7 @@
 export * from './enums/MessageMomentEnum';
 export * from './enums/MessageMomentBlockEnum';
+export * from './enums/MessageMomentCategoryEnum';
+export * from './constants/MessageMomentClassification';
 export * from './constants/MessageMomentVariables';
 export * from './constants/MessageMomentCatalog';
 export * from './constants/TemplatePlaceholder';

package/src/retailIntegration/dtos/GetReconciliationResponses.ts

@@ -1,6 +1,7 @@
 import type { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
 import type { ReconciliationRunStatusEnum } from '../enums/ReconciliationRunStatusEnum';
 import type { ReconciliationTriggerEnum } from '../enums/ReconciliationTriggerEnum';
+import type { ReconciliationPreview } from './ReconciliationPreview';
 import type { ReconciliationRunCounts } from './ReconciliationRunCounts';
 
 /** Respuesta 200 de GET .../reconciliations/{runId} en org (backofficeGetOrgReconciliation). */
@@ -16,6 +17,10 @@ export interface GetOrgReconciliationResponse {
     finishedAt?: string;
     pagesProcessed: number;
     counts: ReconciliationRunCounts;
+    /** La corrida fue en modo prueba y no escribió nada. */
+    dryRun?: boolean;
+    /** Vista previa de una corrida en modo prueba. */
+    preview?: ReconciliationPreview;
 }
 
 /** Respuesta 200 de GET .../reconciliations/{runId} en catalog (backofficeGetCatalogReconciliation). */
@@ -42,4 +47,8 @@ export interface GetCatalogReconciliationResponse {
     /** Fin ISO de la ventana revisada en movimientos. */
     movementsTo?: string;
     counts: ReconciliationRunCounts;
+    /** La corrida fue en modo prueba y no escribió nada. */
+    dryRun?: boolean;
+    /** Vista previa de una corrida en modo prueba. */
+    preview?: ReconciliationPreview;
 }

package/src/retailIntegration/dtos/ReconciliationPreview.ts

@@ -0,0 +1,23 @@
+/** Tope de renglones por lista de la vista previa; si se pasa, `truncated` es true. */
+export const RECONCILIATION_PREVIEW_MAX_ITEMS = 200;
+
+/** Renglón de la vista previa: `id` es storeId, retailUserId, sku o identifier según la entidad. */
+export interface ReconciliationPreviewItem {
+    id: string;
+    /** Nombre legible para mostrar en el backoffice. */
+    label?: string;
+    /** Campos que cambiarían, solo en `updated`. */
+    fields?: string[];
+    /** Tienda de la pieza en inventario. */
+    storeId?: string;
+}
+
+/** Lo que haría una corrida en modo prueba (`dryRun`), sin escribir nada. */
+export interface ReconciliationPreview {
+    created: ReconciliationPreviewItem[];
+    updated: ReconciliationPreviewItem[];
+    deactivated: ReconciliationPreviewItem[];
+    reactivated: ReconciliationPreviewItem[];
+    /** Alguna lista se cortó en RECONCILIATION_PREVIEW_MAX_ITEMS. */
+    truncated: boolean;
+}

package/src/retailIntegration/dtos/RetailEventResult.ts

@@ -1,10 +1,23 @@
+import type { RetailEventRejectCodeEnum } from '../enums/RetailEventRejectCodeEnum';
 import { RetailEventResultEnum } from '../enums/RetailEventResultEnum';
 
+/** Renglón inválido de un evento de inventario; `index` es 0-based en `pieces` o en `stock` según `kind`. */
+export interface RetailEventItemError {
+    index: number;
+    kind?: 'piece' | 'stock';
+    identifier?: string;
+    sku?: string;
+    storeId?: string;
+    code: RetailEventRejectCodeEnum;
+}
+
 /** Resultado de un evento; `code` explica un `REJECTED` y es `null` en los demás. */
 export interface RetailEventResult {
     eventId: string;
     result: RetailEventResultEnum;
     code: string | null;
+    /** Todos los renglones inválidos de un `REJECTED` de inventario, no solo el primero. */
+    errors?: RetailEventItemError[];
 }
 
 export type ReceiveStoreEventResponse = RetailEventResult;

package/src/retailIntegration/dtos/StartCatalogReconciliationRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsIn, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { IsBoolean, IsIn, IsNotEmpty, IsOptional, IsString } from 'class-validator';
 import { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
 
 /** Body de POST /backoffice/retailers/{retailerId}/reconciliations en catalog (backofficeStartCatalogReconciliation). */
@@ -14,6 +14,12 @@ export class StartCatalogReconciliationRequest {
     @IsString()
     @IsNotEmpty()
     storeId?: string;
+
+    /** Modo prueba: calcula la vista previa sin escribir nada. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    dryRun?: boolean;
 }
 
 /** Respuesta 202 del arranque en catalog. */

package/src/retailIntegration/dtos/StartOrgReconciliationRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsIn } from 'class-validator';
+import { IsBoolean, IsIn, IsOptional } from 'class-validator';
 import { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
 
 /** Body de POST /backoffice/retailers/{retailerId}/reconciliations en org (backofficeStartOrgReconciliation). */
@@ -7,6 +7,12 @@ export class StartOrgReconciliationRequest {
     @Expose()
     @IsIn([ReconciliationEntityEnum.STORES, ReconciliationEntityEnum.USERS])
     entity!: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
+
+    /** Modo prueba: calcula la vista previa sin escribir nada. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    dryRun?: boolean;
 }
 
 /** Respuesta 202 del arranque en org. */

package/src/retailIntegration/index.ts

@@ -38,5 +38,6 @@ export * from './models/RetailSystemSale';
 export * from './dtos/StartOrgReconciliationRequest';
 export * from './dtos/StartCatalogReconciliationRequest';
 export * from './dtos/ReconciliationRunCounts';
+export * from './dtos/ReconciliationPreview';
 export * from './dtos/GetReconciliationResponses';
 export * from './dtos/ReconciliationPageMessage';