@fiado/type-kit 3.578.0 → 3.580.0

package/bin/retailWizard/events/RetailCentralOutboundMessage.js

@@ -0,0 +1,42 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailCentralOutboundMessage = void 0;
+const class_validator_1 = require("class-validator");
+const RetailCentralOutboundMessageTypeEnum_1 = require("../enums/RetailCentralOutboundMessageTypeEnum");
+/** Aviso a Central de una venta por registrar o cancelar; el consumidor lee la venta por saleId. */
+class RetailCentralOutboundMessage {
+}
+exports.RetailCentralOutboundMessage = RetailCentralOutboundMessage;
+__decorate([
+    (0, class_validator_1.IsEnum)(RetailCentralOutboundMessageTypeEnum_1.RetailCentralOutboundMessageTypeEnum),
+    __metadata("design:type", String)
+], RetailCentralOutboundMessage.prototype, "messageType", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCentralOutboundMessage.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCentralOutboundMessage.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCentralOutboundMessage.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RetailCentralOutboundMessage.prototype, "saleId", void 0);

package/bin/retailWizard/index.d.ts

@@ -10,6 +10,8 @@ export * from './enums/SalePaymentMethodEnum';
 export * from './enums/RefundStatusEnum';
 export * from './enums/SaleStatusEnum';
 export * from './enums/CentralSyncStatusEnum';
+export * from './enums/CentralCancelStatusEnum';
+export * from './enums/CentralLiveCheckEnum';
 export * from './enums/ProspectStatusEnum';
 export * from './enums/PendingReasonEnum';
 export * from './enums/OccupationEnum';
@@ -172,11 +174,13 @@ export * from './events/SaleCancelledV2';
 export * from './events/SessionExpiredV1';
 export * from './enums/RetailPromotionInboundMessageTypeEnum';
 export * from './enums/RetailCommissionInboundMessageTypeEnum';
+export * from './enums/RetailCentralOutboundMessageTypeEnum';
 export * from './events/RetailPromotionInboundMessage';
 export * from './events/RetailPromotionAccountOpenedMessage';
 export * from './events/RetailPromotionInstallmentPaidMessage';
 export * from './events/RetailPromotionQueueMessage';
 export * from './events/RetailCommissionInboundMessage';
+export * from './events/RetailCentralOutboundMessage';
 export * from './enums/WizardSessionLookupStatusEnum';
 export * from './dtos/WizardSessionLookupEntry';
 export * from './dtos/responses/WizardSessionLookupResponse';

package/bin/retailWizard/index.js

@@ -29,6 +29,8 @@ __exportStar(require("./enums/SalePaymentMethodEnum"), exports);
 __exportStar(require("./enums/RefundStatusEnum"), exports);
 __exportStar(require("./enums/SaleStatusEnum"), exports);
 __exportStar(require("./enums/CentralSyncStatusEnum"), exports);
+__exportStar(require("./enums/CentralCancelStatusEnum"), exports);
+__exportStar(require("./enums/CentralLiveCheckEnum"), exports);
 __exportStar(require("./enums/ProspectStatusEnum"), exports);
 __exportStar(require("./enums/PendingReasonEnum"), exports);
 __exportStar(require("./enums/OccupationEnum"), exports);
@@ -206,11 +208,13 @@ __exportStar(require("./events/SaleCancelledV2"), exports);
 __exportStar(require("./events/SessionExpiredV1"), exports);
 __exportStar(require("./enums/RetailPromotionInboundMessageTypeEnum"), exports);
 __exportStar(require("./enums/RetailCommissionInboundMessageTypeEnum"), exports);
+__exportStar(require("./enums/RetailCentralOutboundMessageTypeEnum"), exports);
 __exportStar(require("./events/RetailPromotionInboundMessage"), exports);
 __exportStar(require("./events/RetailPromotionAccountOpenedMessage"), exports);
 __exportStar(require("./events/RetailPromotionInstallmentPaidMessage"), exports);
 __exportStar(require("./events/RetailPromotionQueueMessage"), exports);
 __exportStar(require("./events/RetailCommissionInboundMessage"), exports);
+__exportStar(require("./events/RetailCentralOutboundMessage"), exports);
 // Lookup privado por lote (GET /private/wizard-sessions/batch)
 __exportStar(require("./enums/WizardSessionLookupStatusEnum"), exports);
 __exportStar(require("./dtos/WizardSessionLookupEntry"), exports);

package/package.json

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

package/src/platformRbac/dtos/UpdateLevelEntityRequest.ts

@@ -2,10 +2,12 @@ import { Expose } from 'class-transformer';
 import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
 
 /**
- * Body del PUT que renombra un grupo. `tenantId`, `level` y el id del grupo viajan en el path.
+ * Body del PUT que renombra un grupo o lo mueve de padre. `tenantId`, `level` y el id del grupo viajan en el path.
  * `actedBy` es el cognitoSub de quien accionó en el backoffice — es lo único que queda en la auditoría.
  */
 export class UpdateLevelEntityRequest {
     @Expose() @IsOptional() @IsString() @IsNotEmpty() @MaxLength(120) displayName?: string;
+    /** Nuevo padre del grupo; el manager lo valida igual que en el alta. */
+    @Expose() @IsOptional() @IsString() @IsNotEmpty() parentId?: string;
     @Expose() @IsString() @IsNotEmpty() actedBy!: string;
 }

package/src/retailCatalog/dtos/requests/ReturnStockRequest.ts

@@ -1,5 +1,5 @@
 import { Type } from 'class-transformer';
-import { ArrayMinSize, IsArray, IsISO8601, IsString, ValidateNested } from 'class-validator';
+import { ArrayMinSize, IsArray, IsISO8601, IsOptional, IsString, ValidateNested } from 'class-validator';
 import { ReturnStockLine } from './ReturnStockLine';
 
 /** Body de PUT /private/stores/{storeId}/returns (privateReturnStock); componentes guardados en la venta. */
@@ -19,4 +19,9 @@ export class ReturnStockRequest {
     @ValidateNested({ each: true })
     @Type(() => ReturnStockLine)
     lines!: ReturnStockLine[];
+
+    /** Primer intento de cancelar en Central; si viene, la pieza se libera por las dos mitades. */
+    @IsOptional()
+    @IsISO8601()
+    centralCancelFirstAttemptAt?: string;
 }

package/src/retailCatalog/dtos/requests/SellInventoryRequest.ts

@@ -0,0 +1,19 @@
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/** Body de PUT /private/inventory/{imei}/sell (privateSellInventory); venta de una pieza por IMEI. */
+export class SellInventoryRequest {
+    /** Sesión del wizard titular de la reserva activa. */
+    @IsString()
+    @IsNotEmpty()
+    sessionId!: string;
+
+    /** Comprador al que se vende la pieza. */
+    @IsString()
+    @IsNotEmpty()
+    customerId!: string;
+
+    /** Venta a la que pertenece; sella la pieza con ella. */
+    @IsString()
+    @IsNotEmpty()
+    saleId!: string;
+}

package/src/retailCatalog/dtos/requests/SellStockRequest.ts

@@ -1,5 +1,5 @@
 import { Type } from 'class-transformer';
-import { ArrayMinSize, IsArray, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { ArrayMinSize, IsArray, IsNotEmpty, IsString, ValidateNested } from 'class-validator';
 import { StockLine } from './StockLine';
 
 /** Body de PUT /private/stores/{storeId}/sales (privateSellStock); una TX de venta. */
@@ -16,8 +16,8 @@ export class SellStockRequest {
     @Type(() => StockLine)
     lines!: StockLine[];
 
-    /** Venta a la que pertenece; liga los MOV# de la TX con ella. */
-    @IsOptional()
+    /** Venta a la que pertenece; sella las piezas y liga los MOV# de la TX con ella. */
     @IsString()
-    saleId?: string;
+    @IsNotEmpty()
+    saleId!: string;
 }

package/src/retailCatalog/dtos/responses/RenewReservationsResponse.ts

@@ -1,8 +1,15 @@
+import type { WizardLineStatusEnum } from '../../../retailWizard/enums/WizardLineStatusEnum';
+import type { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnum';
+
 /** Vencimiento nuevo de una línea renovada. */
 export interface RenewedReservationLine {
     lineId: string;
     reservationId: string;
     expiresAt: string;
+    /** Solo presente si la renovación no pudo sostener la pieza (LOST). */
+    status?: WizardLineStatusEnum;
+    /** Solo en LOST: estado en que Central dejó la pieza (SOLD, IN_TRANSIT o DAMAGED). */
+    lostReason?: InventoryItemStatusEnum;
 }
 
 /** Response de privateRenewReservations. */

package/src/retailCatalog/enums/InventoryInboundMessageTypeEnum.ts

@@ -2,4 +2,5 @@
 export enum InventoryInboundMessageTypeEnum {
     SALE_APPLIED = 'SALE_APPLIED',
     RETURN = 'RETURN',
+    CENTRAL_SALE_ACCEPTED = 'CENTRAL_SALE_ACCEPTED',
 }

package/src/retailCatalog/enums/InventoryItemStatusEnum.ts

@@ -10,6 +10,7 @@
  * @property {string} DAMAGED - Dañada, fuera de stock vendible.
  * @property {string} IN_TRANSIT - En traspaso entre tiendas, fuera de stock vendible.
  * @property {string} HELD - Capturada por una sesión de venta; no vence hasta venderse o soltarse.
+ * @property {string} INACTIVE - Baja suave; fuera de stock vendible.
  */
 export enum InventoryItemStatusEnum {
     AVAILABLE = 'AVAILABLE',
@@ -19,4 +20,5 @@ export enum InventoryItemStatusEnum {
     DAMAGED = 'DAMAGED',
     IN_TRANSIT = 'IN_TRANSIT',
     HELD = 'HELD',
+    INACTIVE = 'INACTIVE',
 }

package/src/retailCatalog/events/InventoryCentralSaleAcceptedMessage.ts

@@ -0,0 +1,36 @@
+import { Type } from 'class-transformer';
+import { ArrayMinSize, Equals, IsArray, IsISO8601, IsNotEmpty, IsString, ValidateNested } from 'class-validator';
+import { InventoryInboundMessageTypeEnum } from '../enums/InventoryInboundMessageTypeEnum';
+import { StockLine } from '../dtos/requests/StockLine';
+
+/** Aviso de que Central registró la venta; el catálogo confirma sus accesorios pendientes. */
+export class InventoryCentralSaleAcceptedMessage {
+    @Equals(InventoryInboundMessageTypeEnum.CENTRAL_SALE_ACCEPTED)
+    type!: InventoryInboundMessageTypeEnum.CENTRAL_SALE_ACCEPTED;
+
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    saleId!: string;
+
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => StockLine)
+    lines!: StockLine[];
+
+    /** Fecha en que Central aceptó la venta; es el acceptedAt del SKPEND#. */
+    @IsISO8601()
+    acceptedAt!: string;
+}

package/src/retailCatalog/events/InventoryInboundMessage.ts

@@ -1,5 +1,9 @@
+import type { InventoryCentralSaleAcceptedMessage } from './InventoryCentralSaleAcceptedMessage';
 import type { InventoryReturnMessage } from './InventoryReturnMessage';
 import type { InventorySaleAppliedMessage } from './InventorySaleAppliedMessage';
 
 /** Cualquier aviso de la cola de inventario; se discrimina por `type`. */
-export type InventoryInboundMessage = InventorySaleAppliedMessage | InventoryReturnMessage;
+export type InventoryInboundMessage =
+    | InventorySaleAppliedMessage
+    | InventoryReturnMessage
+    | InventoryCentralSaleAcceptedMessage;

package/src/retailCatalog/events/InventorySaleAppliedMessage.ts

@@ -1,4 +1,4 @@
-import { Equals, IsISO8601, IsNotEmpty, IsString, ValidateIf } from 'class-validator';
+import { Equals, IsISO8601, IsNotEmpty, IsString } from 'class-validator';
 import { InventoryInboundMessageTypeEnum } from '../enums/InventoryInboundMessageTypeEnum';
 import { SellStockRequest } from '../dtos/requests/SellStockRequest';
 
@@ -16,12 +16,6 @@ export class InventorySaleAppliedMessage extends SellStockRequest {
     @IsNotEmpty()
     storeId!: string;
 
-    /** El ValidateIf anula el @IsOptional que hereda de SellStockRequest: aquí saleId es obligatorio. */
-    @ValidateIf(() => true)
-    @IsString()
-    @IsNotEmpty()
-    saleId!: string;
-
     /** Fecha de la venta; fecha el DAY# y el MOV#. */
     @IsISO8601()
     soldAt!: string;

package/src/retailCatalog/index.ts

@@ -62,6 +62,7 @@ export * from './dtos/requests/ReserveStockRequest';
 export * from './dtos/requests/RenewReservationsRequest';
 export * from './dtos/requests/SuggestPiecesQuery';
 export * from './dtos/requests/SellStockRequest';
+export * from './dtos/requests/SellInventoryRequest';
 export * from './dtos/requests/ReleaseStockRequest';
 export * from './dtos/requests/ReturnStockRequest';
 export * from './dtos/requests/SyncInventoryRequest';
@@ -102,4 +103,5 @@ export * from './dtos/requests/HoldStockRequest';
 export * from './dtos/responses/HoldStockResponse';
 export * from './events/InventorySaleAppliedMessage';
 export * from './events/InventoryReturnMessage';
+export * from './events/InventoryCentralSaleAcceptedMessage';
 export * from './events/InventoryInboundMessage';

package/src/retailIntegration/constants/retailIntegrationErrorHttpStatus.ts

@@ -0,0 +1,17 @@
+import { RetailIntegrationErrorCodeEnum } from '../enums/RetailIntegrationErrorCodeEnum';
+
+/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+export const RETAIL_INTEGRATION_ERROR_HTTP_STATUS: Readonly<Record<RetailIntegrationErrorCodeEnum, 404 | 409 | 422>> = {
+    [RetailIntegrationErrorCodeEnum.ENTITY_MANAGED_BY_INTEGRATION]: 422,
+    [RetailIntegrationErrorCodeEnum.RECONCILIATION_ALREADY_RUNNING]: 409,
+    [RetailIntegrationErrorCodeEnum.RECONCILIATION_NOT_FOUND]: 404,
+    [RetailIntegrationErrorCodeEnum.RESERVATION_LOST]: 409,
+    [RetailIntegrationErrorCodeEnum.PRODUCT_NO_LONGER_SELLABLE]: 409,
+    [RetailIntegrationErrorCodeEnum.STORE_NOT_OPERATIONAL]: 422,
+    [RetailIntegrationErrorCodeEnum.CENTRAL_SYNC_NOT_RESENDABLE]: 409,
+    [RetailIntegrationErrorCodeEnum.SALE_NOT_FOUND]: 404,
+    [RetailIntegrationErrorCodeEnum.RETAILER_ALREADY_INTEGRATED]: 409,
+    [RetailIntegrationErrorCodeEnum.RETAILER_NOT_INTEGRATED]: 422,
+    [RetailIntegrationErrorCodeEnum.CREDIT_REQUIRES_MDM]: 422,
+    [RetailIntegrationErrorCodeEnum.RETAILER_INTEGRATION_MISMATCH]: 422,
+};

package/src/retailIntegration/constants/retailIntegrationLimits.ts

@@ -26,3 +26,6 @@ export const RETAIL_SKU_PATTERN = /^(?=.{1,64}$)[A-Za-z0-9-]+(?: +[A-Za-z0-9-]+)
 
 /** Decimal del contrato: string con dos decimales, nunca negativo. */
 export const RETAIL_DECIMAL_PATTERN = /^\d+\.\d{2}$/;
+
+/** Tope de identificadores por consulta de inventario en vivo. */
+export const RETAIL_LIVE_CHECK_IDENTIFIERS_MAX = 50;

package/src/retailIntegration/dtos/CancelRetailSaleRequest.ts

@@ -0,0 +1,9 @@
+import { IsString, Matches, Validate } from 'class-validator';
+import { IsIsoDateTimeWithZone } from '../validators/IsIsoDateTimeWithZone';
+
+/** Cuerpo de `POST /private/retail/sales/cancel`; el `saleId` es el mismo del registro. */
+export class CancelRetailSaleRequest {
+    @IsString() @Matches(/\S/) saleId!: string;
+    @Validate(IsIsoDateTimeWithZone) cancelledAt!: string;
+    @IsString() @Matches(/\S/) reason!: string;
+}

package/src/retailIntegration/dtos/CheckRetailInventoryRequest.ts

@@ -0,0 +1,20 @@
+import { Transform } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, IsArray, IsString, Matches } from 'class-validator';
+import { RETAIL_LIVE_CHECK_IDENTIFIERS_MAX } from '../constants/retailIntegrationLimits';
+import { RetailTenantQuery } from './RetailTenantQuery';
+
+/** Convierte el csv del query en arreglo; un arreglo ya armado pasa igual. */
+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. */
+export class CheckRetailInventoryRequest extends RetailTenantQuery {
+    @IsString() @Matches(/\S/) storeId!: string;
+
+    @Transform(csvToArray)
+    @IsArray() @ArrayNotEmpty() @ArrayMaxSize(RETAIL_LIVE_CHECK_IDENTIFIERS_MAX) @IsString({ each: true }) @Matches(/\S/, { each: true })
+    identifiers!: string[];
+
+    @IsString() @Matches(/\S/) sessionId!: string;
+}

package/src/retailIntegration/dtos/GetReconciliationResponses.ts

@@ -0,0 +1,37 @@
+import type { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
+import type { ReconciliationRunStatusEnum } from '../enums/ReconciliationRunStatusEnum';
+import type { ReconciliationTriggerEnum } from '../enums/ReconciliationTriggerEnum';
+import type { ReconciliationRunCounts } from './ReconciliationRunCounts';
+
+/** Respuesta 200 de GET .../reconciliations/{runId} en org (backofficeGetOrgReconciliation). */
+export interface GetOrgReconciliationResponse {
+    runId: string;
+    retailerId: string;
+    entity: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
+    status: ReconciliationRunStatusEnum;
+    trigger: ReconciliationTriggerEnum;
+    /** cognitoSub de quien pulsó «Actualizar»; ausente en el reloj. */
+    triggeredBy?: string;
+    startedAt: string;
+    finishedAt?: string;
+    pagesProcessed: number;
+    counts: ReconciliationRunCounts;
+}
+
+/** Respuesta 200 de GET .../reconciliations/{runId} en catalog (backofficeGetCatalogReconciliation). */
+export interface GetCatalogReconciliationResponse {
+    runId: string;
+    retailerId: string;
+    entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY;
+    status: ReconciliationRunStatusEnum;
+    trigger: ReconciliationTriggerEnum;
+    triggeredBy?: string;
+    startedAt: string;
+    finishedAt?: string;
+    pagesProcessed: number;
+    /** Tienda pedida en inventario. */
+    storeId?: string;
+    /** Tiendas de inventario que faltan por cerrar. */
+    storesPending?: number;
+    counts: ReconciliationRunCounts;
+}

package/src/retailIntegration/dtos/GetRetailInventoryRequest.ts

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

package/src/retailIntegration/dtos/ReconciliationPageMessage.ts

@@ -0,0 +1,32 @@
+import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+import { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
+
+/** Mensaje de la cola de revisión: una página, o una tienda completa en inventario. */
+export class ReconciliationPageMessage {
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @IsEnum(ReconciliationEntityEnum)
+    entity!: ReconciliationEntityEnum;
+
+    /** Corrida dueña del lease; otro runId en el LEASE vuelve el mensaje NOOP. */
+    @IsString()
+    @IsNotEmpty()
+    runId!: string;
+
+    /** Índice de la página que se pide; al re-encolar el resto lleva el índice siguiente. */
+    @IsInt()
+    @Min(0)
+    pageIndex!: number;
+
+    /** Tienda del mensaje en inventario. */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    storeId?: string;
+}

package/src/retailIntegration/dtos/ReconciliationRunCounts.ts

@@ -0,0 +1,9 @@
+/** Conteos de una corrida que se guardan en RECON# y se muestran en el avance. */
+export interface ReconciliationRunCounts {
+    seen: number;
+    created: number;
+    updated: number;
+    deactivated: number;
+    reactivated: number;
+    skipped: number;
+}

package/src/retailIntegration/dtos/RetailListQuery.ts

@@ -0,0 +1,10 @@
+import { IsOptional, IsString, Matches } from 'class-validator';
+import { RetailTenantQuery } from './RetailTenantQuery';
+
+/** Base de los listados hacia el retailer; `runId` liga la llamada con la corrida de revisión. */
+export class RetailListQuery extends RetailTenantQuery {
+    @IsOptional()
+    @IsString()
+    @Matches(/\S/)
+    runId?: string;
+}

package/src/retailIntegration/dtos/RetailOutboundResponses.ts

@@ -33,3 +33,14 @@ export interface ListRetailUsersResponse {
 export interface RegisterRetailSaleResponse {
     externalSaleId: string;
 }
+
+/** `data` de `POST /private/retail/sales/cancel`. */
+export interface CancelRetailSaleResponse {
+    saleId: string;
+}
+
+/** `data` de `GET /private/retail/inventory/live-check`: los identificadores que el retailer lista en la tienda. */
+export interface CheckRetailInventoryResponse {
+    listed: string[];
+    generatedAt: string;
+}

package/src/retailIntegration/dtos/RetailPagedQuery.ts

@@ -1,10 +1,10 @@
 import { Type } from 'class-transformer';
 import { IsInt, IsOptional, IsString, Matches, Max, Min } from 'class-validator';
 import { RETAIL_LIST_LIMIT_MAX, RETAIL_LIST_LIMIT_MIN } from '../constants/retailIntegrationLimits';
-import { RetailTenantQuery } from './RetailTenantQuery';
+import { RetailListQuery } from './RetailListQuery';
 
 /** Base de las listas paginadas; `nextToken` es opaco y viaja tal cual. */
-export class RetailPagedQuery extends RetailTenantQuery {
+export class RetailPagedQuery extends RetailListQuery {
     @IsOptional()
     @Type(() => Number)
     @IsInt()

package/src/retailIntegration/dtos/RetailTenantQuery.ts

@@ -1,9 +1,13 @@
 import { IsString, Matches } from 'class-validator';
 import { RETAIL_TENANT_ID_PATTERN } from '../constants/retailIntegrationLimits';
 
-/** Base de toda llamada de salida: el tenant cuyo retailer se consulta. */
+/** Base de toda llamada de salida: el tenant y el retailer que el connector coteja con el secreto. */
 export class RetailTenantQuery {
     @IsString()
     @Matches(RETAIL_TENANT_ID_PATTERN)
     tenantId!: string;
+
+    @IsString()
+    @Matches(/\S/)
+    retailerId!: string;
 }

package/src/retailIntegration/dtos/StartCatalogReconciliationRequest.ts

@@ -0,0 +1,19 @@
+import { IsIn, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
+
+/** Body de POST /backoffice/retailers/{retailerId}/reconciliations en catalog (backofficeStartCatalogReconciliation). */
+export class StartCatalogReconciliationRequest {
+    @IsIn([ReconciliationEntityEnum.CATALOG, ReconciliationEntityEnum.INVENTORY])
+    entity!: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY;
+
+    /** Tienda a revisar en inventario; sin ella se revisan todas las del padrón. */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    storeId?: string;
+}
+
+/** Respuesta 202 del arranque en catalog. */
+export interface StartCatalogReconciliationResponse {
+    runId: string;
+}

package/src/retailIntegration/dtos/StartOrgReconciliationRequest.ts

@@ -0,0 +1,13 @@
+import { IsIn } from 'class-validator';
+import { ReconciliationEntityEnum } from '../enums/ReconciliationEntityEnum';
+
+/** Body de POST /backoffice/retailers/{retailerId}/reconciliations en org (backofficeStartOrgReconciliation). */
+export class StartOrgReconciliationRequest {
+    @IsIn([ReconciliationEntityEnum.STORES, ReconciliationEntityEnum.USERS])
+    entity!: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
+}
+
+/** Respuesta 202 del arranque en org. */
+export interface StartOrgReconciliationResponse {
+    runId: string;
+}

package/src/retailIntegration/enums/InactiveReasonEnum.ts

@@ -0,0 +1,5 @@
+/** Motivo de una baja suave; solo NOT_IN_ZENTRAL se reactiva solo al volver a listarse. */
+export enum InactiveReasonEnum {
+    NOT_IN_ZENTRAL = 'NOT_IN_ZENTRAL',
+    ZENTRAL_EVENT = 'ZENTRAL_EVENT',
+}

package/src/retailIntegration/enums/ReconciliationEntityEnum.ts

@@ -0,0 +1,7 @@
+/** Entidad que revisa una corrida contra los listados de Zentral. */
+export enum ReconciliationEntityEnum {
+    STORES = 'STORES',
+    USERS = 'USERS',
+    CATALOG = 'CATALOG',
+    INVENTORY = 'INVENTORY',
+}

package/src/retailIntegration/enums/ReconciliationRunStatusEnum.ts

@@ -0,0 +1,7 @@
+/** Estado de una corrida de revisión; BRAKED es el freno por bajas de más del 10 %. */
+export enum ReconciliationRunStatusEnum {
+    RUNNING = 'RUNNING',
+    COMPLETE = 'COMPLETE',
+    ABORTED = 'ABORTED',
+    BRAKED = 'BRAKED',
+}

package/src/retailIntegration/enums/ReconciliationTriggerEnum.ts

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

package/src/retailIntegration/enums/RetailEventRejectCodeEnum.ts

@@ -13,4 +13,6 @@ export enum RetailEventRejectCodeEnum {
     TRACKING_MODE_MISMATCH = 'TRACKING_MODE_MISMATCH',
     INVALID_IMEI = 'INVALID_IMEI',
     IDENTIFIER_CONFLICT = 'IDENTIFIER_CONFLICT',
+    /** El evento trae una fecha posterior a la hora del servidor. */
+    EVENT_IN_FUTURE = 'EVENT_IN_FUTURE',
 }

package/src/retailIntegration/enums/RetailIntegrationErrorCodeEnum.ts

@@ -0,0 +1,23 @@
+/**
+ * Codes HTTP de la integración con el sistema del retailer (org, catalog, wizard y connector).
+ * El status de cada uno está en `RETAIL_INTEGRATION_ERROR_HTTP_STATUS`; las clases `DomainError` viven en el lambda.
+ * @enum {string}
+ */
+export enum RetailIntegrationErrorCodeEnum {
+    /** La entidad la administra la integración y no se edita desde SK. */
+    ENTITY_MANAGED_BY_INTEGRATION = 'ENTITY_MANAGED_BY_INTEGRATION',
+    RECONCILIATION_ALREADY_RUNNING = 'RECONCILIATION_ALREADY_RUNNING',
+    RECONCILIATION_NOT_FOUND = 'RECONCILIATION_NOT_FOUND',
+    /** El apartado de la pieza se perdió antes del cierre. */
+    RESERVATION_LOST = 'RESERVATION_LOST',
+    PRODUCT_NO_LONGER_SELLABLE = 'PRODUCT_NO_LONGER_SELLABLE',
+    STORE_NOT_OPERATIONAL = 'STORE_NOT_OPERATIONAL',
+    /** La venta no está en un estado de sincronización con Central que admita reenvío. */
+    CENTRAL_SYNC_NOT_RESENDABLE = 'CENTRAL_SYNC_NOT_RESENDABLE',
+    SALE_NOT_FOUND = 'SALE_NOT_FOUND',
+    RETAILER_ALREADY_INTEGRATED = 'RETAILER_ALREADY_INTEGRATED',
+    RETAILER_NOT_INTEGRATED = 'RETAILER_NOT_INTEGRATED',
+    /** El producto no tiene MDM y solo se vende de contado. */
+    CREDIT_REQUIRES_MDM = 'CREDIT_REQUIRES_MDM',
+    RETAILER_INTEGRATION_MISMATCH = 'RETAILER_INTEGRATION_MISMATCH',
+}

package/src/retailIntegration/enums/RetailSaleLineRoleEnum.ts

@@ -0,0 +1,4 @@
+/** Rol especial de una línea de venta; `null` es una línea normal. */
+export enum RetailSaleLineRoleEnum {
+    GIFT = 'GIFT',
+}

package/src/retailIntegration/enums/index.ts

@@ -19,5 +19,11 @@ export * from './RetailSaleTypeEnum';
 export * from './RetailSaleFinancierEnum';
 export * from './RetailPaymentMethodEnum';
 export * from './RetailLinePaymentTypeEnum';
+export * from './RetailSaleLineRoleEnum';
 export * from './RetailEventRejectCodeEnum';
 export * from './RetailMovementTypeEnum';
+export * from './RetailIntegrationErrorCodeEnum';
+export * from './ReconciliationEntityEnum';
+export * from './ReconciliationRunStatusEnum';
+export * from './ReconciliationTriggerEnum';
+export * from './InactiveReasonEnum';