@fiado/type-kit 3.581.0 → 3.583.0

package/_test_/unit/mdm/MdmProviderEnum.test.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+import { MdmProviderEnum } from '../../../src/mdm/enums/MdmProviderEnum';
+
+describe('MdmProviderEnum', () => {
+    it('trae exactamente los proveedores MDM del contrato, en orden', () => {
+        expect(Object.values(MdmProviderEnum)).toEqual(['TRUSTONIC', 'DATACULTR', 'MOTOSAFE']);
+    });
+
+    it('MOTOSAFE vale su propio nombre', () => {
+        expect(MdmProviderEnum.MOTOSAFE).toBe('MOTOSAFE');
+    });
+});

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

@@ -236,6 +236,9 @@ describe('financiamiento, MDM y externalId en las altas y edición backoffice',
       const errors = errorsOf(cls, { ...ok, ...financed, mdmProvider: 'KNOX', mdmLockMode: 'NEVER' });
       expect(errors).toEqual(expect.arrayContaining(['mdmProvider', 'mdmLockMode']));
     });
+    it('acepta MOTOSAFE como proveedor MDM', () => {
+      expect(errorsOf(cls, { ...ok, ...financed, mdmProvider: 'MOTOSAFE' })).toEqual([]);
+    });
     it('rechaza MDM incoherente', () => {
       expect(errorsOf(cls, { ...ok, mdmEnabled: true })).toContain('mdmEnabled');
       expect(errorsOf(cls, { ...ok, mdmEnabled: false, mdmProvider: 'TRUSTONIC', mdmLockMode: 'ONDEMAND' })).toContain('mdmEnabled');

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

@@ -10,6 +10,10 @@ describe('retailCatalog — enums del inventario multi-item', () => {
     expect(Object.values(RetailCatalog.TrackingModeEnum)).toEqual(['IMEI', 'SERIAL', 'QUANTITY']);
   });
 
+  it('expone los proveedores MDM, con MOTOSAFE', () => {
+    expect(Object.values(RetailCatalog.MdmProviderEnum)).toEqual(['TRUSTONIC', 'DATACULTR', 'MOTOSAFE']);
+  });
+
   it('expone los tipos de movimiento', () => {
     expect(Object.values(RetailCatalog.InventoryMovementTypeEnum)).toEqual([
       'ENTRY', 'RESERVATION', 'RELEASE', 'SALE', 'RETURN', 'ADJUSTMENT',

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

@@ -88,6 +88,14 @@ describe('ProductEventPayload', () => {
         expect(await errorsOf(ProductEventPayload, product)).toEqual([]);
     });
 
+    it.each(['TRUSTONIC', 'DATACULTR', 'MOTOSAFE'])('acepta mdmProvider %s', async (mdmProvider) => {
+        expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider })).toEqual([]);
+    });
+
+    it('rechaza un mdmProvider fuera del enum', async () => {
+        expect(await errorsOf(ProductEventPayload, { ...product, mdmProvider: 'KNOX' })).toContain('mdmProvider');
+    });
+
     it.each([
         ['sku', { sku: 'SAM_A17' }],
         ['price.basePrice', { price: { ...product.price, basePrice: '4299' } }],

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

@@ -27,7 +27,7 @@ describe('enums de los objetos del retailer', () => {
         [RetailProductTierEnum, ['LOW', 'MID', 'HIGH', 'PREMIUM']],
         [RetailCurrencyEnum, ['MXN', 'USD']],
         [RetailFinancierEnum, ['SUREKEEP', 'PAYJOY', 'CREDIYA', 'LESPAGO', 'INNOVA']],
-        [RetailMdmProviderEnum, ['TRUSTONIC', 'DATACULTR']],
+        [RetailMdmProviderEnum, ['TRUSTONIC', 'DATACULTR', 'MOTOSAFE']],
         [RetailProductStatusEnum, ['ACTIVE', 'INACTIVE', 'DISCONTINUED']],
         [RetailPieceStatusEnum, ['AVAILABLE', 'IN_TRANSIT', 'SOLD', 'DAMAGED']],
         [RetailPieceReasonEnum, ['WARRANTY', 'DAMAGED_RETURN', 'SHRINKAGE']],

package/_test_/unit/retailOrg/dtos/retailerIntegrationMode.test.ts

@@ -0,0 +1,106 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    ActivateRetailerIntegrationRequest,
+    ActivateRetailerIntegrationResponse,
+    RetailIntegrationModeEnum,
+    RetailIntegrationSystemEnum,
+    Retailer,
+    RetailerStatusEnum,
+    RetailerTypeEnum,
+    RetailerValidationDto,
+    SetRetailerIntegrationModeRequest,
+} from '../../../../src/retailOrg/index';
+
+const base = {
+    retailerId: 'ret_001',
+    parentId: 'ROOT',
+    type: RetailerTypeEnum.CHAIN,
+    name: 'Tiendas del Centro',
+    legalName: 'Tiendas del Centro SA de CV',
+    rfc: 'VEN123456ABC',
+    contactEmail: 'contacto@tdc.mx',
+    contactPhone: '+525512345678',
+    address: { city: 'CDMX', region: 'CDMX', zipCode: '01000' },
+    status: RetailerStatusEnum.ACTIVE,
+    createdAt: '2026-07-14T10:00:00.000Z',
+    updatedAt: '2026-07-14T10:00:00.000Z',
+    createdBy: 'user_1',
+    updatedBy: 'user_1',
+};
+const errorsOf = async <T extends object>(cls: new () => T, plain: object) =>
+    (await validate(plainToInstance(cls, plain))).map(e => e.property);
+
+describe('RetailIntegrationModeEnum', () => {
+    it('trae SOFT y FULL', () => {
+        expect(Object.values(RetailIntegrationModeEnum)).toEqual(['SOFT', 'FULL']);
+    });
+});
+
+describe('Retailer.integrationMode', () => {
+    it('es opcional', async () => {
+        expect(await errorsOf(Retailer, base)).toEqual([]);
+    });
+
+    it('acepta un modo del enum', async () => {
+        expect(await errorsOf(Retailer, { ...base, integrationMode: 'FULL' })).toEqual([]);
+    });
+
+    it('rechaza un modo fuera del enum', async () => {
+        expect(await errorsOf(Retailer, { ...base, integrationMode: 'HARD' })).toContain('integrationMode');
+    });
+});
+
+describe('RetailerValidationDto.integrationMode', () => {
+    it('admite el modo opcional', () => {
+        const dto: RetailerValidationDto = {
+            retailerId: 'ret_001', name: 'x', type: RetailerTypeEnum.CHAIN, status: RetailerStatusEnum.ACTIVE, parentId: 'ROOT',
+            integrationMode: RetailIntegrationModeEnum.SOFT,
+        };
+        expect(dto.integrationMode).toBe('SOFT');
+    });
+});
+
+describe('ActivateRetailerIntegrationRequest.integrationMode', () => {
+    it('es opcional', async () => {
+        expect(await errorsOf(ActivateRetailerIntegrationRequest, { integrationSystem: 'ZENTRAL' })).toEqual([]);
+    });
+
+    it('acepta un modo del enum y lo expone', async () => {
+        const req = plainToInstance(ActivateRetailerIntegrationRequest, { integrationSystem: 'ZENTRAL', integrationMode: 'FULL' }, { excludeExtraneousValues: true });
+        expect(req.integrationMode).toBe(RetailIntegrationModeEnum.FULL);
+        expect(await validate(req)).toEqual([]);
+    });
+
+    it('rechaza un modo fuera del enum', async () => {
+        expect(await errorsOf(ActivateRetailerIntegrationRequest, { integrationSystem: 'ZENTRAL', integrationMode: 'HARD' })).toContain('integrationMode');
+    });
+});
+
+describe('ActivateRetailerIntegrationResponse.integrationMode', () => {
+    it('incluye el modo opcional', () => {
+        const response = plainToInstance(Retailer, {
+            ...base, integrationSystem: RetailIntegrationSystemEnum.ZENTRAL, integrationActivatedAt: '2026-10-25T10:00:00.000Z',
+            integrationActivatedBy: 'user_1', integrationMode: 'SOFT',
+        }) as ActivateRetailerIntegrationResponse;
+        expect(response.integrationMode).toBe(RetailIntegrationModeEnum.SOFT);
+    });
+});
+
+describe('SetRetailerIntegrationModeRequest', () => {
+    it('acepta SOFT y FULL', async () => {
+        expect(await errorsOf(SetRetailerIntegrationModeRequest, { integrationMode: 'SOFT' })).toEqual([]);
+        expect(await errorsOf(SetRetailerIntegrationModeRequest, { integrationMode: 'FULL' })).toEqual([]);
+    });
+
+    it('exige integrationMode dentro del enum', async () => {
+        expect(await errorsOf(SetRetailerIntegrationModeRequest, {})).toContain('integrationMode');
+        expect(await errorsOf(SetRetailerIntegrationModeRequest, { integrationMode: 'HARD' })).toContain('integrationMode');
+    });
+
+    it('expone integrationMode con excludeExtraneousValues', () => {
+        const req = plainToInstance(SetRetailerIntegrationModeRequest, { integrationMode: 'FULL', extra: 1 }, { excludeExtraneousValues: true });
+        expect(req).toEqual({ integrationMode: 'FULL' });
+    });
+});

package/bin/mdm/enums/MdmProviderEnum.d.ts

@@ -1,4 +1,5 @@
 export declare enum MdmProviderEnum {
     TRUSTONIC = "TRUSTONIC",
-    DATACULTR = "DATACULTR"
+    DATACULTR = "DATACULTR",
+    MOTOSAFE = "MOTOSAFE"
 }

package/bin/mdm/enums/MdmProviderEnum.js

@@ -5,4 +5,5 @@ var MdmProviderEnum;
 (function (MdmProviderEnum) {
     MdmProviderEnum["TRUSTONIC"] = "TRUSTONIC";
     MdmProviderEnum["DATACULTR"] = "DATACULTR";
+    MdmProviderEnum["MOTOSAFE"] = "MOTOSAFE";
 })(MdmProviderEnum || (exports.MdmProviderEnum = MdmProviderEnum = {}));

package/bin/retailCatalog/enums/MdmProviderEnum.d.ts

@@ -4,8 +4,10 @@
  *
  * @property {string} TRUSTONIC - Proveedor Trustonic.
  * @property {string} DATACULTR - Proveedor Datacultr.
+ * @property {string} MOTOSAFE - Proveedor Motosafe (MDM embebido de Motorola); solo opera en ONDEMAND.
  */
 export declare enum MdmProviderEnum {
     TRUSTONIC = "TRUSTONIC",
-    DATACULTR = "DATACULTR"
+    DATACULTR = "DATACULTR",
+    MOTOSAFE = "MOTOSAFE"
 }

package/bin/retailCatalog/enums/MdmProviderEnum.js

@@ -7,9 +7,11 @@ exports.MdmProviderEnum = void 0;
  *
  * @property {string} TRUSTONIC - Proveedor Trustonic.
  * @property {string} DATACULTR - Proveedor Datacultr.
+ * @property {string} MOTOSAFE - Proveedor Motosafe (MDM embebido de Motorola); solo opera en ONDEMAND.
  */
 var MdmProviderEnum;
 (function (MdmProviderEnum) {
     MdmProviderEnum["TRUSTONIC"] = "TRUSTONIC";
     MdmProviderEnum["DATACULTR"] = "DATACULTR";
+    MdmProviderEnum["MOTOSAFE"] = "MOTOSAFE";
 })(MdmProviderEnum || (exports.MdmProviderEnum = MdmProviderEnum = {}));

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

@@ -1,5 +1,6 @@
 /** Proveedor de MDM del equipo. */
 export declare enum RetailMdmProviderEnum {
     TRUSTONIC = "TRUSTONIC",
-    DATACULTR = "DATACULTR"
+    DATACULTR = "DATACULTR",
+    MOTOSAFE = "MOTOSAFE"
 }

package/bin/retailIntegration/enums/RetailMdmProviderEnum.js

@@ -6,4 +6,5 @@ var RetailMdmProviderEnum;
 (function (RetailMdmProviderEnum) {
     RetailMdmProviderEnum["TRUSTONIC"] = "TRUSTONIC";
     RetailMdmProviderEnum["DATACULTR"] = "DATACULTR";
+    RetailMdmProviderEnum["MOTOSAFE"] = "MOTOSAFE";
 })(RetailMdmProviderEnum || (exports.RetailMdmProviderEnum = RetailMdmProviderEnum = {}));

package/bin/retailOrg/dtos/Retailer.d.ts

@@ -1,6 +1,7 @@
 import { LocationAddress } from '../../address/dtos/LocationAddress';
 import { RetailerStatusEnum } from '../enums/RetailerStatusEnum';
 import { RetailerTypeEnum } from '../enums/RetailerTypeEnum';
+import { RetailIntegrationModeEnum } from '../enums/RetailIntegrationModeEnum';
 import { RetailIntegrationSystemEnum } from '../enums/RetailIntegrationSystemEnum';
 /**
  * Retailer — nodo raíz de la organización comercial SureKeep (cadena / subdistribuidor / franquicia).
@@ -32,4 +33,6 @@ export declare class Retailer {
     integrationSystem?: RetailIntegrationSystemEnum;
     integrationActivatedAt?: string;
     integrationActivatedBy?: string;
+    /** Modo de integración; ausente si el retailer no está integrado. */
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/bin/retailOrg/dtos/Retailer.js

@@ -16,6 +16,7 @@ const LocationAddress_1 = require("../../address/dtos/LocationAddress");
 const regex_1 = require("../../helpers/constans/regex");
 const RetailerStatusEnum_1 = require("../enums/RetailerStatusEnum");
 const RetailerTypeEnum_1 = require("../enums/RetailerTypeEnum");
+const RetailIntegrationModeEnum_1 = require("../enums/RetailIntegrationModeEnum");
 const RetailIntegrationSystemEnum_1 = require("../enums/RetailIntegrationSystemEnum");
 /**
  * Retailer — nodo raíz de la organización comercial SureKeep (cadena / subdistribuidor / franquicia).
@@ -122,3 +123,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], Retailer.prototype, "integrationActivatedBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RetailIntegrationModeEnum_1.RetailIntegrationModeEnum),
+    __metadata("design:type", String)
+], Retailer.prototype, "integrationMode", void 0);

package/bin/retailOrg/dtos/requests/ActivateRetailerIntegrationRequest.d.ts

@@ -1,5 +1,8 @@
+import { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
 import { RetailIntegrationSystemEnum } from '../../enums/RetailIntegrationSystemEnum';
 /** Body de POST /retailers/:retailerId/integration/activate. */
 export declare class ActivateRetailerIntegrationRequest {
     integrationSystem: RetailIntegrationSystemEnum;
+    /** Si no viene, el back usa SOFT. */
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/bin/retailOrg/dtos/requests/ActivateRetailerIntegrationRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActivateRetailerIntegrationRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const RetailIntegrationModeEnum_1 = require("../../enums/RetailIntegrationModeEnum");
 const RetailIntegrationSystemEnum_1 = require("../../enums/RetailIntegrationSystemEnum");
 /** Body de POST /retailers/:retailerId/integration/activate. */
 class ActivateRetailerIntegrationRequest {
@@ -22,3 +23,9 @@ __decorate([
     (0, class_validator_1.IsEnum)(RetailIntegrationSystemEnum_1.RetailIntegrationSystemEnum),
     __metadata("design:type", String)
 ], ActivateRetailerIntegrationRequest.prototype, "integrationSystem", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RetailIntegrationModeEnum_1.RetailIntegrationModeEnum),
+    __metadata("design:type", String)
+], ActivateRetailerIntegrationRequest.prototype, "integrationMode", void 0);

package/bin/retailOrg/dtos/requests/SetRetailerIntegrationModeRequest.d.ts

@@ -0,0 +1,5 @@
+import { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
+/** Body del endpoint que cambia el modo de integración de un retailer ya integrado. */
+export declare class SetRetailerIntegrationModeRequest {
+    integrationMode: RetailIntegrationModeEnum;
+}

package/bin/retailOrg/dtos/requests/SetRetailerIntegrationModeRequest.js

@@ -0,0 +1,24 @@
+"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.SetRetailerIntegrationModeRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RetailIntegrationModeEnum_1 = require("../../enums/RetailIntegrationModeEnum");
+/** Body del endpoint que cambia el modo de integración de un retailer ya integrado. */
+class SetRetailerIntegrationModeRequest {
+}
+exports.SetRetailerIntegrationModeRequest = SetRetailerIntegrationModeRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RetailIntegrationModeEnum_1.RetailIntegrationModeEnum),
+    __metadata("design:type", String)
+], SetRetailerIntegrationModeRequest.prototype, "integrationMode", void 0);

package/bin/retailOrg/dtos/validation/RetailerValidationDto.d.ts

@@ -1,5 +1,6 @@
 import type { RetailerStatusEnum } from '../../enums/RetailerStatusEnum';
 import type { RetailerTypeEnum } from '../../enums/RetailerTypeEnum';
+import type { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
 import type { RetailIntegrationSystemEnum } from '../../enums/RetailIntegrationSystemEnum';
 /**
  * Shape mínimo que devuelve el endpoint privado de validación de retailer (consumido por otros
@@ -15,4 +16,5 @@ export interface RetailerValidationDto {
     /** Bandera «integrado»; ausente si el retailer no está integrado. */
     integrationSystem?: RetailIntegrationSystemEnum;
     integrationActivatedAt?: string;
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/bin/retailOrg/enums/RetailIntegrationModeEnum.d.ts

@@ -0,0 +1,5 @@
+/** Alcance de la revisión contra el sistema externo: SOFT solo aplica altas y cambios, nunca bajas; FULL aplica todo. */
+export declare enum RetailIntegrationModeEnum {
+    SOFT = "SOFT",
+    FULL = "FULL"
+}

package/bin/retailOrg/enums/RetailIntegrationModeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailIntegrationModeEnum = void 0;
+/** Alcance de la revisión contra el sistema externo: SOFT solo aplica altas y cambios, nunca bajas; FULL aplica todo. */
+var RetailIntegrationModeEnum;
+(function (RetailIntegrationModeEnum) {
+    RetailIntegrationModeEnum["SOFT"] = "SOFT";
+    RetailIntegrationModeEnum["FULL"] = "FULL";
+})(RetailIntegrationModeEnum || (exports.RetailIntegrationModeEnum = RetailIntegrationModeEnum = {}));

package/bin/retailOrg/index.d.ts

@@ -7,6 +7,7 @@ export * from './enums/EmploymentTypeEnum';
 export * from './enums/CollectorSeniorityEnum';
 export * from './enums/RetailUserWalletLinkMethodEnum';
 export * from './enums/RetailIntegrationSystemEnum';
+export * from './enums/RetailIntegrationModeEnum';
 export * from './enums/GoalTargetTypeEnum';
 export * from './dtos/GeoLocation';
 export * from './dtos/GoalAmounts';
@@ -46,6 +47,7 @@ export * from './dtos/requests/PrivateGoalListQuery';
 export * from './dtos/requests/KpiQuery';
 export * from './dtos/requests/PrivateSellerListQuery';
 export * from './dtos/requests/ActivateRetailerIntegrationRequest';
+export * from './dtos/requests/SetRetailerIntegrationModeRequest';
 export * from './dtos/responses/RetailerHierarchyResponse';
 export * from './dtos/responses/GoalListResponse';
 export * from './dtos/responses/GoalUpsertResponse';

package/bin/retailOrg/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./enums/EmploymentTypeEnum"), exports);
 __exportStar(require("./enums/CollectorSeniorityEnum"), exports);
 __exportStar(require("./enums/RetailUserWalletLinkMethodEnum"), exports);
 __exportStar(require("./enums/RetailIntegrationSystemEnum"), exports);
+__exportStar(require("./enums/RetailIntegrationModeEnum"), exports);
 // F3 — Portal Admin VentasLuga (metas de venta del periodo)
 __exportStar(require("./enums/GoalTargetTypeEnum"), exports);
 // Entity DTOs
@@ -69,6 +70,7 @@ __exportStar(require("./dtos/requests/PrivateGoalListQuery"), exports);
 __exportStar(require("./dtos/requests/KpiQuery"), exports);
 __exportStar(require("./dtos/requests/PrivateSellerListQuery"), exports);
 __exportStar(require("./dtos/requests/ActivateRetailerIntegrationRequest"), exports);
+__exportStar(require("./dtos/requests/SetRetailerIntegrationModeRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/RetailerHierarchyResponse"), exports);
 __exportStar(require("./dtos/responses/GoalListResponse"), exports);

package/package.json

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

package/src/mdm/README.md

@@ -4,7 +4,7 @@
 
 ## Qué es esto
 
-DTOs y enums para el servicio MDM (Mobile Device Management) de SureKeep. Son agnósticos al proveedor — la misma forma sirve para Trustonic, Datacultr o cualquier otro proveedor que se integre en el futuro.
+DTOs y enums para el servicio MDM (Mobile Device Management) de SureKeep. Son agnósticos al proveedor — la misma forma sirve para Trustonic, Datacultr, Motosafe o cualquier otro proveedor que se integre en el futuro.
 
 ## Convenciones
 
@@ -43,22 +43,22 @@ import { Mdm } from "@fiado/type-kit";
 
 ## Acciones soportadas
 
-| Acción | Trustonic | Datacultr |
-|---|---|---|
-| DeviceNotify | HEADSUP / FULLSCREEN | Notification (con `notification_code`) |
-| DeviceRestrictApps | ⚠️ Por confirmar configuración | Nudge (App Block) |
-| DeviceLock (FIRM) | Lock LOCK | Bulk Lock |
-| DeviceLock (TEMPORARY) | Lock DIMISSABLE | ❌ Error: no soporta |
-| DeviceUnlock | Unlock | Unlock |
-| DevicePinUnlock | PIN Unlock | get_device_passcode |
-| DeviceStatus | Device Info | Device Status by IMEI |
-| DeviceEnroll | Upload + Activate (síncrono) | Registra y espera webhook |
-| DeviceRelease | Release | Release |
-| DeviceServiceDeactivate | Deactivate Service | ❌ Error: no soporta |
-| DeviceArchive | Archive | ❌ Error: no soporta |
-| DeviceAutoLockSchedule | ❌ Error: no soporta postpaid | Adhoc Auto Lock |
-| DeviceLastSeen | (incluido en Device Info) | Device Last Seen |
-| DeviceLog | ❌ Error: no expone | Device Log |
+| Acción | Trustonic | Datacultr | Motosafe |
+|---|---|---|---|
+| DeviceNotify | HEADSUP / FULLSCREEN | Notification (con `notification_code`) | send-message (título ≤ 30, cuerpo ≤ 100; un IMEI por llamada) |
+| DeviceRestrictApps | ⚠️ Por confirmar configuración | Nudge (App Block) | ❌ Error: no soporta |
+| DeviceLock (FIRM) | Lock LOCK | Bulk Lock | command `lock` (sin mensaje en pantalla) |
+| DeviceLock (TEMPORARY) | Lock DIMISSABLE | ❌ Error: no soporta | ❌ Error: no soporta |
+| DeviceUnlock | Unlock | Unlock | command `unlock` (sin `unlockUntil`: solo ONDEMAND) |
+| DevicePinUnlock | PIN Unlock | get_device_passcode | ❌ Error: no soporta |
+| DeviceStatus | Device Info | Device Status by IMEI | Device (`status` / `nextStatus`) |
+| DeviceEnroll | Upload + Activate (síncrono) | Registra y espera webhook | register (sin handle; se concilia por estado) |
+| DeviceRelease | Release | Release | command `release` |
+| DeviceServiceDeactivate | Deactivate Service | ❌ Error: no soporta | ❌ Error: no soporta |
+| DeviceArchive | Archive | ❌ Error: no soporta | Cancel Device |
+| DeviceAutoLockSchedule | ❌ Error: no soporta postpaid | Adhoc Auto Lock | ❌ Error: no soporta |
+| DeviceLastSeen | (incluido en Device Info) | Device Last Seen | ❌ Error: no expone |
+| DeviceLog | ❌ Error: no expone | Device Log | ❌ Error: no expone |
 
 ## Modo de bloqueo (`MdmLockModeEnum`)
 

package/src/mdm/enums/MdmProviderEnum.ts

@@ -1,4 +1,5 @@
 export enum MdmProviderEnum {
     TRUSTONIC = "TRUSTONIC",
-    DATACULTR = "DATACULTR"
+    DATACULTR = "DATACULTR",
+    MOTOSAFE = "MOTOSAFE"
 }

package/src/retailCatalog/enums/MdmProviderEnum.ts

@@ -4,8 +4,10 @@
  *
  * @property {string} TRUSTONIC - Proveedor Trustonic.
  * @property {string} DATACULTR - Proveedor Datacultr.
+ * @property {string} MOTOSAFE - Proveedor Motosafe (MDM embebido de Motorola); solo opera en ONDEMAND.
  */
 export enum MdmProviderEnum {
     TRUSTONIC = 'TRUSTONIC',
     DATACULTR = 'DATACULTR',
+    MOTOSAFE = 'MOTOSAFE',
 }

package/src/retailIntegration/enums/RetailMdmProviderEnum.ts

@@ -2,4 +2,5 @@
 export enum RetailMdmProviderEnum {
     TRUSTONIC = 'TRUSTONIC',
     DATACULTR = 'DATACULTR',
+    MOTOSAFE = 'MOTOSAFE',
 }

package/src/retailOrg/dtos/Retailer.ts

@@ -4,6 +4,7 @@ import { LocationAddress } from '../../address/dtos/LocationAddress';
 import { regexIso8601 } from '../../helpers/constans/regex';
 import { RetailerStatusEnum } from '../enums/RetailerStatusEnum';
 import { RetailerTypeEnum } from '../enums/RetailerTypeEnum';
+import { RetailIntegrationModeEnum } from '../enums/RetailIntegrationModeEnum';
 import { RetailIntegrationSystemEnum } from '../enums/RetailIntegrationSystemEnum';
 
 /**
@@ -96,4 +97,10 @@ export class Retailer {
     @IsOptional()
     @IsString()
     integrationActivatedBy?: string;
+
+    /** Modo de integración; ausente si el retailer no está integrado. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(RetailIntegrationModeEnum)
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/src/retailOrg/dtos/requests/ActivateRetailerIntegrationRequest.ts

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
-import { IsEnum } from 'class-validator';
+import { IsEnum, IsOptional } from 'class-validator';
+import { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
 import { RetailIntegrationSystemEnum } from '../../enums/RetailIntegrationSystemEnum';
 
 /** Body de POST /retailers/:retailerId/integration/activate. */
@@ -7,4 +8,10 @@ export class ActivateRetailerIntegrationRequest {
     @Expose()
     @IsEnum(RetailIntegrationSystemEnum)
     integrationSystem!: RetailIntegrationSystemEnum;
+
+    /** Si no viene, el back usa SOFT. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(RetailIntegrationModeEnum)
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/src/retailOrg/dtos/requests/SetRetailerIntegrationModeRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
+
+/** Body del endpoint que cambia el modo de integración de un retailer ya integrado. */
+export class SetRetailerIntegrationModeRequest {
+    @Expose()
+    @IsEnum(RetailIntegrationModeEnum)
+    integrationMode!: RetailIntegrationModeEnum;
+}

package/src/retailOrg/dtos/validation/RetailerValidationDto.ts

@@ -1,5 +1,6 @@
 import type { RetailerStatusEnum } from '../../enums/RetailerStatusEnum';
 import type { RetailerTypeEnum } from '../../enums/RetailerTypeEnum';
+import type { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
 import type { RetailIntegrationSystemEnum } from '../../enums/RetailIntegrationSystemEnum';
 
 /**
@@ -16,4 +17,5 @@ export interface RetailerValidationDto {
     /** Bandera «integrado»; ausente si el retailer no está integrado. */
     integrationSystem?: RetailIntegrationSystemEnum;
     integrationActivatedAt?: string;
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/src/retailOrg/enums/RetailIntegrationModeEnum.ts

@@ -0,0 +1,5 @@
+/** Alcance de la revisión contra el sistema externo: SOFT solo aplica altas y cambios, nunca bajas; FULL aplica todo. */
+export enum RetailIntegrationModeEnum {
+    SOFT = 'SOFT',
+    FULL = 'FULL',
+}

package/src/retailOrg/index.ts

@@ -7,6 +7,7 @@ export * from './enums/EmploymentTypeEnum';
 export * from './enums/CollectorSeniorityEnum';
 export * from './enums/RetailUserWalletLinkMethodEnum';
 export * from './enums/RetailIntegrationSystemEnum';
+export * from './enums/RetailIntegrationModeEnum';
 // F3 — Portal Admin VentasLuga (metas de venta del periodo)
 export * from './enums/GoalTargetTypeEnum';
 
@@ -58,6 +59,7 @@ export * from './dtos/requests/PrivateGoalListQuery';
 export * from './dtos/requests/KpiQuery';
 export * from './dtos/requests/PrivateSellerListQuery';
 export * from './dtos/requests/ActivateRetailerIntegrationRequest';
+export * from './dtos/requests/SetRetailerIntegrationModeRequest';
 
 // Response DTOs
 export * from './dtos/responses/RetailerHierarchyResponse';