@fiado/type-kit 3.584.0 → 3.585.0

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

@@ -0,0 +1,41 @@
+import { ReceiveInventoryEventRequest } from './ReceiveInventoryEventRequest';
+/** `meta` de una página de Zentral; `nextToken` en `null` cierra la lectura y nunca se omite. */
+export declare class RetailSystemPageMeta {
+    count: number;
+    nextToken: string | null;
+}
+/** Página de una lista de Zentral; cada consumidor valida sus renglones de `data`. */
+export declare class RetailSystemPageResponse {
+    data: unknown[];
+    meta: RetailSystemPageMeta;
+}
+/** `data` de una página de `GET /inventory`: piezas y existencias crudas. */
+export declare class RetailSystemInventoryData {
+    pieces: unknown[];
+    stock: unknown[];
+}
+/** `meta` de una página de `GET /inventory`; `generatedAt` es igual en toda la lectura. */
+export declare class RetailSystemInventoryMeta extends RetailSystemPageMeta {
+    storeId: string;
+    generatedAt: string;
+}
+/** Respuesta de `GET /inventory` de Zentral. */
+export declare class RetailSystemInventoryResponse {
+    data: RetailSystemInventoryData;
+    meta: RetailSystemInventoryMeta;
+}
+/** `data` de `POST /sales` de Zentral. */
+export declare class RetailSystemSaleResponse {
+    externalSaleId: string;
+}
+/** Cuerpo de error de Zentral; `lineIndex` solo viene en errores de una línea de venta. */
+export declare class RetailSystemErrorBody {
+    code: string;
+    msg?: string;
+    lineIndex?: number;
+}
+/** Respuesta de `GET /inventory/movements`: cada elemento es el mismo sobre del webhook de inventario. */
+export declare class RetailSystemMovementsResponse {
+    data: ReceiveInventoryEventRequest[];
+    meta: RetailSystemPageMeta;
+}

package/bin/retailIntegration/dtos/RetailSystemResponses.js

@@ -0,0 +1,136 @@
+"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.RetailSystemMovementsResponse = exports.RetailSystemErrorBody = exports.RetailSystemSaleResponse = exports.RetailSystemInventoryResponse = exports.RetailSystemInventoryMeta = exports.RetailSystemInventoryData = exports.RetailSystemPageResponse = exports.RetailSystemPageMeta = 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 ReceiveInventoryEventRequest_1 = require("./ReceiveInventoryEventRequest");
+/** `meta` de una página de Zentral; `nextToken` en `null` cierra la lectura y nunca se omite. */
+class RetailSystemPageMeta {
+}
+exports.RetailSystemPageMeta = RetailSystemPageMeta;
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RetailSystemPageMeta.prototype, "count", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_NEXT_TOKEN_MAX_LENGTH),
+    __metadata("design:type", String)
+], RetailSystemPageMeta.prototype, "nextToken", void 0);
+/** Página de una lista de Zentral; cada consumidor valida sus renglones de `data`. */
+class RetailSystemPageResponse {
+}
+exports.RetailSystemPageResponse = RetailSystemPageResponse;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], RetailSystemPageResponse.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RetailSystemPageMeta),
+    __metadata("design:type", RetailSystemPageMeta)
+], RetailSystemPageResponse.prototype, "meta", void 0);
+/** `data` de una página de `GET /inventory`: piezas y existencias crudas. */
+class RetailSystemInventoryData {
+}
+exports.RetailSystemInventoryData = RetailSystemInventoryData;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], RetailSystemInventoryData.prototype, "pieces", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], RetailSystemInventoryData.prototype, "stock", void 0);
+/** `meta` de una página de `GET /inventory`; `generatedAt` es igual en toda la lectura. */
+class RetailSystemInventoryMeta extends RetailSystemPageMeta {
+}
+exports.RetailSystemInventoryMeta = RetailSystemInventoryMeta;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_ENTITY_ID_PATTERN),
+    __metadata("design:type", String)
+], RetailSystemInventoryMeta.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.Validate)(IsIsoDateTimeWithZone_1.IsIsoDateTimeWithZone),
+    __metadata("design:type", String)
+], RetailSystemInventoryMeta.prototype, "generatedAt", void 0);
+/** Respuesta de `GET /inventory` de Zentral. */
+class RetailSystemInventoryResponse {
+}
+exports.RetailSystemInventoryResponse = RetailSystemInventoryResponse;
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RetailSystemInventoryData),
+    __metadata("design:type", RetailSystemInventoryData)
+], RetailSystemInventoryResponse.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RetailSystemInventoryMeta),
+    __metadata("design:type", RetailSystemInventoryMeta)
+], RetailSystemInventoryResponse.prototype, "meta", void 0);
+/** `data` de `POST /sales` de Zentral. */
+class RetailSystemSaleResponse {
+}
+exports.RetailSystemSaleResponse = RetailSystemSaleResponse;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_ID_TEXT_MAX_LENGTH),
+    (0, class_validator_1.Matches)(retailIntegrationLimits_1.RETAIL_EXTERNAL_ID_PATTERN),
+    __metadata("design:type", String)
+], RetailSystemSaleResponse.prototype, "externalSaleId", void 0);
+/** Cuerpo de error de Zentral; `lineIndex` solo viene en errores de una línea de venta. */
+class RetailSystemErrorBody {
+}
+exports.RetailSystemErrorBody = RetailSystemErrorBody;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/\S/),
+    (0, class_validator_1.MaxLength)(retailIntegrationLimits_1.RETAIL_ERROR_CODE_MAX_LENGTH),
+    __metadata("design:type", String)
+], RetailSystemErrorBody.prototype, "code", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailSystemErrorBody.prototype, "msg", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(retailIntegrationLimits_1.RETAIL_LINE_INDEX_MIN),
+    (0, class_validator_1.Max)(retailIntegrationLimits_1.RETAIL_LINE_INDEX_MAX),
+    __metadata("design:type", Number)
+], RetailSystemErrorBody.prototype, "lineIndex", void 0);
+/** Respuesta de `GET /inventory/movements`: cada elemento es el mismo sobre del webhook de inventario. */
+class RetailSystemMovementsResponse {
+}
+exports.RetailSystemMovementsResponse = RetailSystemMovementsResponse;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ReceiveInventoryEventRequest_1.ReceiveInventoryEventRequest),
+    __metadata("design:type", Array)
+], RetailSystemMovementsResponse.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RetailSystemPageMeta),
+    __metadata("design:type", RetailSystemPageMeta)
+], RetailSystemMovementsResponse.prototype, "meta", void 0);

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

@@ -3,5 +3,6 @@ export declare enum ReconciliationEntityEnum {
     STORES = "STORES",
     USERS = "USERS",
     CATALOG = "CATALOG",
-    INVENTORY = "INVENTORY"
+    INVENTORY = "INVENTORY",
+    MOVEMENTS = "MOVEMENTS"
 }

package/bin/retailIntegration/enums/ReconciliationEntityEnum.js

@@ -8,4 +8,5 @@ var ReconciliationEntityEnum;
     ReconciliationEntityEnum["USERS"] = "USERS";
     ReconciliationEntityEnum["CATALOG"] = "CATALOG";
     ReconciliationEntityEnum["INVENTORY"] = "INVENTORY";
+    ReconciliationEntityEnum["MOVEMENTS"] = "MOVEMENTS";
 })(ReconciliationEntityEnum || (exports.ReconciliationEntityEnum = ReconciliationEntityEnum = {}));

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

@@ -1,6 +1,8 @@
-/** Quién abrió la corrida: el reloj horario, el botón «Actualizar» o la activación del retailer. */
+/** Quién abrió la corrida: el reloj horario o diario, el botón «Actualizar», la activación o una discrepancia. */
 export declare enum ReconciliationTriggerEnum {
     SCHEDULED = "SCHEDULED",
     MANUAL = "MANUAL",
-    ACTIVATION = "ACTIVATION"
+    ACTIVATION = "ACTIVATION",
+    DISCREPANCY = "DISCREPANCY",
+    DAILY = "DAILY"
 }

package/bin/retailIntegration/enums/ReconciliationTriggerEnum.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReconciliationTriggerEnum = void 0;
-/** Quién abrió la corrida: el reloj horario, el botón «Actualizar» o la activación del retailer. */
+/** Quién abrió la corrida: el reloj horario o diario, el botón «Actualizar», la activación o una discrepancia. */
 var ReconciliationTriggerEnum;
 (function (ReconciliationTriggerEnum) {
     ReconciliationTriggerEnum["SCHEDULED"] = "SCHEDULED";
     ReconciliationTriggerEnum["MANUAL"] = "MANUAL";
     ReconciliationTriggerEnum["ACTIVATION"] = "ACTIVATION";
+    ReconciliationTriggerEnum["DISCREPANCY"] = "DISCREPANCY";
+    ReconciliationTriggerEnum["DAILY"] = "DAILY";
 })(ReconciliationTriggerEnum || (exports.ReconciliationTriggerEnum = ReconciliationTriggerEnum = {}));

package/bin/retailIntegration/index.d.ts

@@ -2,6 +2,7 @@ export * from './constants/retailIntegrationLimits';
 export * from './constants/retailIntegrationErrorHttpStatus';
 export * from './enums';
 export * from './validators/IsIsoDateTimeWithZone';
+export * from './validators/IsMovementsRangeValid';
 export * from './dtos/RetailEventEnvelope';
 export * from './dtos/ReceiveStoreEventRequest';
 export * from './dtos/ReceiveRetailUserEventRequest';
@@ -21,11 +22,13 @@ export * from './dtos/RetailPagedQuery';
 export * from './dtos/ListRetailStoresRequest';
 export * from './dtos/ListRetailCatalogRequest';
 export * from './dtos/GetRetailInventoryRequest';
+export * from './dtos/ListRetailInventoryMovementsRequest';
 export * from './dtos/ListRetailUsersRequest';
 export * from './dtos/RegisterRetailSaleRequest';
 export * from './dtos/CancelRetailSaleRequest';
 export * from './dtos/CheckRetailInventoryRequest';
 export * from './dtos/RetailOutboundResponses';
+export * from './dtos/RetailSystemResponses';
 export * from './models/RetailPageMeta';
 export * from './models/RetailSystemStore';
 export * from './models/RetailSystemProduct';

package/bin/retailIntegration/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./constants/retailIntegrationLimits"), exports);
 __exportStar(require("./constants/retailIntegrationErrorHttpStatus"), exports);
 __exportStar(require("./enums"), exports);
 __exportStar(require("./validators/IsIsoDateTimeWithZone"), exports);
+__exportStar(require("./validators/IsMovementsRangeValid"), exports);
 __exportStar(require("./dtos/RetailEventEnvelope"), exports);
 __exportStar(require("./dtos/ReceiveStoreEventRequest"), exports);
 __exportStar(require("./dtos/ReceiveRetailUserEventRequest"), exports);
@@ -37,11 +38,13 @@ __exportStar(require("./dtos/RetailPagedQuery"), exports);
 __exportStar(require("./dtos/ListRetailStoresRequest"), exports);
 __exportStar(require("./dtos/ListRetailCatalogRequest"), exports);
 __exportStar(require("./dtos/GetRetailInventoryRequest"), exports);
+__exportStar(require("./dtos/ListRetailInventoryMovementsRequest"), exports);
 __exportStar(require("./dtos/ListRetailUsersRequest"), exports);
 __exportStar(require("./dtos/RegisterRetailSaleRequest"), exports);
 __exportStar(require("./dtos/CancelRetailSaleRequest"), exports);
 __exportStar(require("./dtos/CheckRetailInventoryRequest"), exports);
 __exportStar(require("./dtos/RetailOutboundResponses"), exports);
+__exportStar(require("./dtos/RetailSystemResponses"), exports);
 __exportStar(require("./models/RetailPageMeta"), exports);
 __exportStar(require("./models/RetailSystemStore"), exports);
 __exportStar(require("./models/RetailSystemProduct"), exports);

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

@@ -3,8 +3,10 @@ export interface RetailPageMeta {
     count: number;
     nextToken: string | null;
 }
-/** `meta` del inventario de una tienda. */
+/** `meta` del inventario de una tienda; `count` y `nextToken` llegan cuando la lectura pagina. */
 export interface RetailInventoryMeta {
     storeId: string;
     generatedAt: string;
+    count?: number;
+    nextToken?: string | null;
 }

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

@@ -1,4 +1,5 @@
-import { RetailPieceReasonEnum, RetailPieceStatusEnum } from '../enums';
+import type { InventoryEventPayload } from '../dtos/InventoryEventPayload';
+import { InventoryEventTypeEnum, RetailPieceReasonEnum, RetailPieceStatusEnum } from '../enums';
 export type RetailPieceStatus = `${RetailPieceStatusEnum}`;
 export type RetailPieceReason = `${RetailPieceReasonEnum}`;
 /** Pieza con IMEI o número de serie. */
@@ -15,3 +16,10 @@ export interface RetailSystemStock {
     storeId: string;
     qty: number;
 }
+/** Movimiento de inventario de Zentral: el mismo sobre que llega a `POST /webhooks/inventory`. */
+export interface RetailSystemInventoryMovement {
+    eventId: string;
+    eventType: `${InventoryEventTypeEnum}`;
+    occurredAt: string;
+    payload: InventoryEventPayload;
+}

package/bin/retailIntegration/validators/IsMovementsRangeValid.d.ts

@@ -0,0 +1,6 @@
+import { ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+/** `to`: mayor que `from` y a lo más 7 días después; sin `from` legible lo rechaza su propio validador. */
+export declare class IsMovementsRangeValid implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/retailIntegration/validators/IsMovementsRangeValid.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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsMovementsRangeValid = void 0;
+const class_validator_1 = require("class-validator");
+const retailIntegrationLimits_1 = require("../constants/retailIntegrationLimits");
+/** `to`: mayor que `from` y a lo más 7 días después; sin `from` legible lo rechaza su propio validador. */
+let IsMovementsRangeValid = class IsMovementsRangeValid {
+    validate(value, args) {
+        const from = Date.parse(String(args.object.from));
+        const to = Date.parse(String(value));
+        if (Number.isNaN(from) || Number.isNaN(to))
+            return true;
+        return to > from && to - from <= retailIntegrationLimits_1.RETAIL_MOVEMENTS_RANGE_MAX_MS;
+    }
+    defaultMessage() {
+        return 'to debe ser mayor que from y a lo más 7 días después';
+    }
+};
+exports.IsMovementsRangeValid = IsMovementsRangeValid;
+exports.IsMovementsRangeValid = IsMovementsRangeValid = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isMovementsRangeValid', async: false })
+], IsMovementsRangeValid);

package/package.json

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

package/src/platformRbac/dtos/CreateTenantUserRequest.ts

@@ -14,7 +14,8 @@ const hasAnyGrantField = (o: CreateTenantUserRequest): boolean =>
  * Consumido por el alta de usuario orquestada de SureKeep F1 (retail-org → RBAC → RetailUser) vía api-invoker.
  * - Usuario provisionado en estado INVITED (mitiga orphan si el paso siguiente en retail-org falla).
  * - Idempotente por identidad Cognito.
- * - `roleId`/`scope`/`scopeRef`: todos o ninguno; sin rol no hay invitación.
+ * - `roleId`/`scope`/`scopeRef`: todos o ninguno; sin rol exige `suppressInvitation: true`
+ *   y la invitación queda pendiente (`invitationPending`) hasta asignar el primer rol.
  * - `createdBy` = cognitoSub del admin real (audit + grantedBy del assignment).
  * - `customFields` = valores de los campos personalizados del tenant; si el correo ya tiene usuario, se fusionan.
  */

package/src/platformRbac/dtos/UpdateTenantUserEmailRequest.ts

@@ -0,0 +1,12 @@
+import { Expose, Transform } from 'class-transformer';
+import { IsEmail, IsNotEmpty, IsString } from 'class-validator';
+
+/** Body M2M que cambia el correo de un usuario del tenant; el correo se guarda en minúsculas. */
+export class UpdateTenantUserEmailRequest {
+    @Expose()
+    @Transform(({ value }) => (typeof value === 'string' ? value.trim().toLowerCase() : value))
+    @IsEmail()
+    email!: string;
+
+    @Expose() @IsString() @IsNotEmpty() actedBy!: string;
+}

package/src/platformRbac/enums/Permission.ts

@@ -165,6 +165,8 @@ export enum Permission {
     TENANT_INTEGRATION_DIAGNOSTIC = 'tenant.integration.diagnostic',
     // Alta, rotación de secreto y edición de IPs de usuarios de API; se exige además de tenant.user.create.
     TENANT_API_USER_MANAGE = 'tenant.api_user.manage',
+    // Activa la integración de un retailer externo (Zentral); scope PLATFORM.
+    PLATFORM_RETAIL_INTEGRATION_ACTIVATE = 'platform.retail_integration.activate',
 }
 
 /**
@@ -286,6 +288,7 @@ export const PERMISSION_BIT_ORDER: readonly Permission[] = [
     Permission.PLATFORM_INTEGRATION_KEY_REVOKE,
     Permission.TENANT_INTEGRATION_DIAGNOSTIC,
     Permission.TENANT_API_USER_MANAGE,
+    Permission.PLATFORM_RETAIL_INTEGRATION_ACTIVATE,
 ] as const;
 
 function djb2(input: string): number {

package/src/platformRbac/index.ts

@@ -167,6 +167,7 @@ export type { ListTenantUsersResponse } from './dtos/ListTenantUsersResponse';
 export type { TenantUserListItemResponse } from './dtos/TenantUserListItemResponse';
 export type { GetTenantUserResponse } from './dtos/GetTenantUserResponse';
 export * from './dtos/UpdateTenantUserRequest';
+export * from './dtos/UpdateTenantUserEmailRequest';
 export * from './dtos/DeleteTenantUserRequest';
 export * from './dtos/DisableTenantUserRequest';
 export * from './dtos/EnableTenantUserRequest';

package/src/retailIntegration/constants/retailIntegrationLimits.ts

@@ -50,3 +50,19 @@ export const RETAIL_ELIGIBLE_FINANCIERS_MAX = 50;
 
 /** Decimal de los eventos del retailer: hasta 12 enteros y dos decimales, nunca negativo. */
 export const RETAIL_EVENT_DECIMAL_PATTERN = /^\d{1,12}\.\d{2}$/;
+
+/** Tope del `nextToken` opaco que devuelve Zentral. */
+export const RETAIL_NEXT_TOKEN_MAX_LENGTH = 2048;
+
+/** Id que asigna Zentral, como `externalSaleId`: no vacío, sin espacios y de a lo más 64. */
+export const RETAIL_EXTERNAL_ID_PATTERN = /^\S{1,64}$/;
+
+/** Tope del `code` en el cuerpo de error de Zentral. */
+export const RETAIL_ERROR_CODE_MAX_LENGTH = 64;
+
+/** Rango de `lineIndex` en un error de línea de venta. */
+export const RETAIL_LINE_INDEX_MIN = 0;
+export const RETAIL_LINE_INDEX_MAX = 999;
+
+/** Rango máximo de `GET /inventory/movements`: 7 días en milisegundos. */
+export const RETAIL_MOVEMENTS_RANGE_MAX_MS = 7 * 24 * 60 * 60 * 1000;

package/src/retailIntegration/dtos/CheckRetailInventoryRequest.ts

@@ -8,7 +8,10 @@ function csvToArray({ value }: { value: unknown }): unknown {
     return typeof value === 'string' ? value.split(',').map((item) => item.trim()) : value;
 }
 
-/** Query de `GET /private/retail/inventory/live-check`; `identifiers` llega como csv. */
+/**
+ * Query de `GET /private/retail/inventory/live-check`; `identifiers` llega como csv.
+ * @deprecated el live-check se va a quitar; el inventario se toma de movimientos y de la lectura diaria.
+ */
 export class CheckRetailInventoryRequest extends RetailTenantQuery {
     @IsString() @Matches(/\S/) storeId!: string;
 

package/src/retailIntegration/dtos/GetRetailInventoryRequest.ts

@@ -1,8 +1,8 @@
 import { IsString, Matches } from 'class-validator';
-import { RetailListQuery } from './RetailListQuery';
+import { RetailPagedQuery } from './RetailPagedQuery';
 
-/** Query de `GET /private/retail/inventory`; el inventario es por tienda y no pagina. */
-export class GetRetailInventoryRequest extends RetailListQuery {
+/** Query de `GET /private/retail/inventory`; el inventario es por tienda y pagina con `limit`/`nextToken`. */
+export class GetRetailInventoryRequest extends RetailPagedQuery {
     @IsString()
     @Matches(/\S/)
     storeId!: string;

package/src/retailIntegration/dtos/ListRetailInventoryMovementsRequest.ts

@@ -0,0 +1,14 @@
+import { Validate } from 'class-validator';
+import { IsIsoDateTimeWithZone } from '../validators/IsIsoDateTimeWithZone';
+import { IsMovementsRangeValid } from '../validators/IsMovementsRangeValid';
+import { RetailPagedQuery } from './RetailPagedQuery';
+
+/** Query de `GET /private/retail/inventory/movements`: rango `[from, to)` de a lo más 7 días. */
+export class ListRetailInventoryMovementsRequest extends RetailPagedQuery {
+    @Validate(IsIsoDateTimeWithZone)
+    from!: string;
+
+    @Validate(IsIsoDateTimeWithZone)
+    @Validate(IsMovementsRangeValid)
+    to!: string;
+}

package/src/retailIntegration/dtos/ReconciliationPageMessage.ts

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, Matches, Min, Validate } from 'class-validator';
 import { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
+import { IsIsoDateTimeWithZone } from '../validators/IsIsoDateTimeWithZone';
 
 /** Mensaje de la cola de revisión: una página, o una tienda completa en inventario. */
 export class ReconciliationPageMessage {
@@ -43,4 +44,23 @@ export class ReconciliationPageMessage {
     @IsInt()
     @Min(0)
     requeueCount?: number;
+
+    /** Cursor de Zentral para la siguiente página del inventario de la tienda. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(/\S/)
+    nextToken?: string;
+
+    /** Inicio del rango de movimientos, incluido. */
+    @Expose()
+    @IsOptional()
+    @Validate(IsIsoDateTimeWithZone)
+    from?: string;
+
+    /** Fin del rango de movimientos, excluido. */
+    @Expose()
+    @IsOptional()
+    @Validate(IsIsoDateTimeWithZone)
+    to?: string;
 }

package/src/retailIntegration/dtos/RetailOutboundResponses.ts

@@ -1,5 +1,5 @@
 import { RetailInventoryMeta, RetailPageMeta } from '../models/RetailPageMeta';
-import { RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
+import { RetailSystemInventoryMovement, RetailSystemPiece, RetailSystemStock } from '../models/RetailSystemInventory';
 import { RetailSystemProduct } from '../models/RetailSystemProduct';
 import { RetailSystemStore } from '../models/RetailSystemStore';
 import { RetailSystemUser } from '../models/RetailSystemUser';
@@ -23,6 +23,12 @@ export interface GetRetailInventoryResponse {
     meta: RetailInventoryMeta;
 }
 
+/** `data` de `GET /private/retail/inventory/movements`. */
+export interface ListRetailInventoryMovementsResponse {
+    items: RetailSystemInventoryMovement[];
+    meta: RetailPageMeta;
+}
+
 /** `data` de `GET /private/retail/users`. */
 export interface ListRetailUsersResponse {
     items: RetailSystemUser[];
@@ -39,7 +45,10 @@ export interface CancelRetailSaleResponse {
     saleId: string;
 }
 
-/** `data` de `GET /private/retail/inventory/live-check`: los identificadores que el retailer lista en la tienda. */
+/**
+ * `data` de `GET /private/retail/inventory/live-check`: los identificadores que el retailer lista en la tienda.
+ * @deprecated el live-check se va a quitar; el inventario se toma de movimientos y de la lectura diaria.
+ */
 export interface CheckRetailInventoryResponse {
     listed: string[];
     generatedAt: string;

package/src/retailIntegration/dtos/RetailSystemResponses.ts

@@ -0,0 +1,75 @@
+import { Type } from 'class-transformer';
+import {
+    IsArray,
+    IsInt,
+    IsObject,
+    IsOptional,
+    IsString,
+    Matches,
+    Max,
+    MaxLength,
+    Min,
+    Validate,
+    ValidateIf,
+    ValidateNested,
+} from 'class-validator';
+import {
+    RETAIL_ENTITY_ID_PATTERN,
+    RETAIL_ERROR_CODE_MAX_LENGTH,
+    RETAIL_ID_TEXT_MAX_LENGTH,
+    RETAIL_LINE_INDEX_MAX,
+    RETAIL_LINE_INDEX_MIN,
+    RETAIL_NEXT_TOKEN_MAX_LENGTH,
+    RETAIL_EXTERNAL_ID_PATTERN,
+} from '../constants/retailIntegrationLimits';
+import { IsIsoDateTimeWithZone } from '../validators/IsIsoDateTimeWithZone';
+import { isNullOrValidated } from '../validators/payloadValidators';
+import { ReceiveInventoryEventRequest } from './ReceiveInventoryEventRequest';
+
+/** `meta` de una página de Zentral; `nextToken` en `null` cierra la lectura y nunca se omite. */
+export class RetailSystemPageMeta {
+    @IsInt() @Min(0) count!: number;
+    @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_NEXT_TOKEN_MAX_LENGTH) nextToken!: string | null;
+}
+
+/** Página de una lista de Zentral; cada consumidor valida sus renglones de `data`. */
+export class RetailSystemPageResponse {
+    @IsArray() data!: unknown[];
+    @IsObject() @ValidateNested() @Type(() => RetailSystemPageMeta) meta!: RetailSystemPageMeta;
+}
+
+/** `data` de una página de `GET /inventory`: piezas y existencias crudas. */
+export class RetailSystemInventoryData {
+    @IsArray() pieces!: unknown[];
+    @IsArray() stock!: unknown[];
+}
+
+/** `meta` de una página de `GET /inventory`; `generatedAt` es igual en toda la lectura. */
+export class RetailSystemInventoryMeta extends RetailSystemPageMeta {
+    @IsString() @Matches(RETAIL_ENTITY_ID_PATTERN) storeId!: string;
+    @Validate(IsIsoDateTimeWithZone) generatedAt!: string;
+}
+
+/** Respuesta de `GET /inventory` de Zentral. */
+export class RetailSystemInventoryResponse {
+    @IsObject() @ValidateNested() @Type(() => RetailSystemInventoryData) data!: RetailSystemInventoryData;
+    @IsObject() @ValidateNested() @Type(() => RetailSystemInventoryMeta) meta!: RetailSystemInventoryMeta;
+}
+
+/** `data` de `POST /sales` de Zentral. */
+export class RetailSystemSaleResponse {
+    @IsString() @MaxLength(RETAIL_ID_TEXT_MAX_LENGTH) @Matches(RETAIL_EXTERNAL_ID_PATTERN) externalSaleId!: string;
+}
+
+/** Cuerpo de error de Zentral; `lineIndex` solo viene en errores de una línea de venta. */
+export class RetailSystemErrorBody {
+    @IsString() @Matches(/\S/) @MaxLength(RETAIL_ERROR_CODE_MAX_LENGTH) code!: string;
+    @IsOptional() @IsString() msg?: string;
+    @IsOptional() @IsInt() @Min(RETAIL_LINE_INDEX_MIN) @Max(RETAIL_LINE_INDEX_MAX) lineIndex?: number;
+}
+
+/** Respuesta de `GET /inventory/movements`: cada elemento es el mismo sobre del webhook de inventario. */
+export class RetailSystemMovementsResponse {
+    @IsArray() @ValidateNested({ each: true }) @Type(() => ReceiveInventoryEventRequest) data!: ReceiveInventoryEventRequest[];
+    @IsObject() @ValidateNested() @Type(() => RetailSystemPageMeta) meta!: RetailSystemPageMeta;
+}

package/src/retailIntegration/enums/ReconciliationEntityEnum.ts

@@ -4,4 +4,5 @@ export enum ReconciliationEntityEnum {
     USERS = 'USERS',
     CATALOG = 'CATALOG',
     INVENTORY = 'INVENTORY',
+    MOVEMENTS = 'MOVEMENTS',
 }

package/src/retailIntegration/enums/ReconciliationTriggerEnum.ts

@@ -1,6 +1,8 @@
-/** Quién abrió la corrida: el reloj horario, el botón «Actualizar» o la activación del retailer. */
+/** Quién abrió la corrida: el reloj horario o diario, el botón «Actualizar», la activación o una discrepancia. */
 export enum ReconciliationTriggerEnum {
     SCHEDULED = 'SCHEDULED',
     MANUAL = 'MANUAL',
     ACTIVATION = 'ACTIVATION',
+    DISCREPANCY = 'DISCREPANCY',
+    DAILY = 'DAILY',
 }

package/src/retailIntegration/index.ts

@@ -2,6 +2,7 @@ export * from './constants/retailIntegrationLimits';
 export * from './constants/retailIntegrationErrorHttpStatus';
 export * from './enums';
 export * from './validators/IsIsoDateTimeWithZone';
+export * from './validators/IsMovementsRangeValid';
 export * from './dtos/RetailEventEnvelope';
 export * from './dtos/ReceiveStoreEventRequest';
 export * from './dtos/ReceiveRetailUserEventRequest';
@@ -21,11 +22,13 @@ export * from './dtos/RetailPagedQuery';
 export * from './dtos/ListRetailStoresRequest';
 export * from './dtos/ListRetailCatalogRequest';
 export * from './dtos/GetRetailInventoryRequest';
+export * from './dtos/ListRetailInventoryMovementsRequest';
 export * from './dtos/ListRetailUsersRequest';
 export * from './dtos/RegisterRetailSaleRequest';
 export * from './dtos/CancelRetailSaleRequest';
 export * from './dtos/CheckRetailInventoryRequest';
 export * from './dtos/RetailOutboundResponses';
+export * from './dtos/RetailSystemResponses';
 export * from './models/RetailPageMeta';
 export * from './models/RetailSystemStore';
 export * from './models/RetailSystemProduct';