Version History
This section describes changes made in subsequent releases and the new features in this API:
| Release | Enhancements | API Version |
|---|---|---|
| 2026.3 | We implemented the Multiple ERP External ID handling mechanism that lets one HIDM instance store business units/locations from multiple independent ERP sub-systems/business lines while keeping all business unit external IDs unique within the VRP platform. This allows multiple ERP systems to create Business Units in one HIDM tenant when ERP source IDs overlap. HIDM will make each Business Line a separate numeric namespace by assigning a server-owned prefix and storing one immutable canonical BusinessUnit.ExternalId. To support this implementation in the Public API, we added the following changes: - we introduced the following endpoint: GET /api/v1/tenant/usermanagement - retrieves the tenant user-management settings. - we added the new optional request field isBusinessUnitLine to the following endpoints: POST /api/v1/businessUnitTypes and PUT /api/v1/businessUnitTypes/{businessUnitTypeId}. - we also added the new optional response fields isPrefixedExternalId, originalSourceExternalId, isBusinessUnitLine, multipleERPEnabled, and rangeLength to the following endpoints: GET /api/v1/businessunits, GET /api/v1/businessunits/{businessUnitId}, GET /api/v1/businessunits/externalId, GET /api/v1/businessunits/externalId/{externalId}, GET /api/v1/businessunits/edgeSerialNumber/{serialNumber}, and GET /api/v1/tenant/usermanagement. | v1 |
| 2026.3 | We enhanced the Business Unit functionality to introduced the Canonical External ID. HIDM will make each Business Line a separate numeric namespace by assigning a server-owned prefix and storing one immutable canonical BusinessUnit.ExternalId. To support this enhancement in the Public API, we performed the following changes: - we added a new optional request field canonicalExternalId in the POST /api/v1/businessunits/bulkImport endpoint. | v1 |
| 2026.3 and Patch in API 2026.2 | We enhanced the Business Unit functionality to update the information of a specific Business Unit using the Business Unit external identifier (externalId). To support this enhancement in the Public API, we introduced the following endpoint: - PUT /api/v1/businessunits/externalId/{externalId} - enables the API client to update an information on a specific Business Unit in the Harmonized Identity Management application, based on the Business Unit external identifier (externalId). | v1 |
| 2026.3 | We enhanced the Bulk Import Business Unit functionality to support the location-related data management using HIDM APIs. To support this enhancement in the Public API, we performed the following changes: - We deprecated the statusId (use the entityStateId field instead) field from the POST /api/v1/businessunits/bulkImport endpoint. | v1 |
| 2026.3 and Patch in API 2026.2 | We enhanced the Business Unit functionality to get the consolidated reference data for the business unit screens and to provide details on a specific Business Unit based on the unique edge serial number associated with it using the HIDM APIs. To support this enhancement in the Public API, we introduced the following new endpoints: - GET /api/v1/businessunits/reference-data - retrieves the consolidated reference data for the business unit screens. - GET /api/v1/businessunits/edgeIdentification - provides details on a specific Business Unit based on the unique edge serial number associated with it. We also removed the following fields: - isMain - removed from the contactDetails object in the GET /api/v1/businessunits, POST /api/v1/businessunits, GET /api/v1/businessunits/{businessUnitId}, PUT /api/v1/businessunits/{businessUnitId}, GET /api/v1/businessunits/externalId/{externalId}, GET /api/v1/businessunits/edgeSerialNumber/{serialNumber}, GET /api/v1/businessunits/externalId, and POST /api/v1/businessunits/bulkImport endpoints. - countryCode - removed from the addressDetails object in the GET /api/v1/businessunits, POST /api/v1/businessunits, GET /api/v1/businessunits/{businessUnitId}, PUT /api/v1/businessunits/{businessUnitId}, GET /api/v1/businessunits/externalId/{externalId}, GET /api/v1/businessunits/edgeSerialNumber/{serialNumber}, GET /api/v1/businessunits/externalId, and POST /api/v1/businessunits/bulkImport endpoints. - entityNo - removed from the location object in the POST /api/v1/businessunits, PUT /api/v1/businessunits/{businessUnitId}, and POST /api/v1/businessunits/bulkImport endpoints. - IsCurrentInstance - removed from the edges > databaseInstance object in the GET /api/v1/businessunits, GET /api/v1/businessunits/{businessUnitId}, GET /api/v1/businessunits/externalId/{externalId}, GET /api/v1/businessunits/edgeSerialNumber/{serialNumber}, and GET /api/v1/businessunits/externalId endpoints. - isCurrentCloud - removed from the edges object in the GET /api/v1/businessunits, POST /api/v1/businessunits, GET /api/v1/businessunits/{businessUnitId}, PUT /api/v1/businessunits/{businessUnitId}, GET /api/v1/businessunits/externalId/{externalId}, GET /api/v1/businessunits/edgeSerialNumber/{serialNumber}, GET /api/v1/businessunits/externalId, and POST /api/v1/businessunits/bulkImport endpoints. - databaseInstanceId - removed from the edges object in the POST /api/v1/businessunits endpoint. We also renamed the DefaultStationNo field to defaultLocationBuId in the GET /api/v1/businessunits, POST /api/v1/businessunits, GET /api/v1/businessunits/{businessUnitId}, PUT /api/v1/businessunits/{businessUnitId}, GET /api/v1/businessunits/externalId/{externalId}, GET /api/v1/businessunits/edgeSerialNumber/{serialNumber}, GET /api/v1/businessunits/externalId, and POST /api/v1/businessunits/bulkImport endpoints. We also added the following fields: - previousEntityStateId - added to the edges object in the GET /api/v1/businessunits, GET /api/v1/businessunits/{businessUnitId}, GET /api/v1/businessunits/externalId/{externalId}, GET /api/v1/businessunits/edgeSerialNumber/{serialNumber}, and GET /api/v1/businessunits/externalId endpoints. - databaseName - added to the edges object in the POST /api/v1/businessunits endpoint. | v1 |
| 2026.3 and Patch in API 2026.2 | We enhanced the Business Unit functionality to provide details on a specific Business Unit based on the unique edge serial number using the HIDM APIs. To support this enhancement in the Public API, we introduced the following new endpoint: - GET /api/v1/businessunits/edgeSerialNumber/{serialNumber} - provides details on a specific Business Unit based on the unique edge serial number associated with it. | v1 |
| 2026.3 and Patch in API 2026.2 | To ensure consistency with the backend, we introduced the following endpoint: - PATCH /businessunits/{businessUnitId}/edges/{edgeId}/operationmode - enables the API client to update the operation mode for a location edge. | v1 |
| 2026.3 and Patch in API 2026.2 | We enhanced the Business Unit functionality to support the location-related data management using HIDM APIs. To support this enhancement in the Public API, we performed the following changes: - We removed the isActive (use the entityStateId field instead) field from the POST /businessunits and PUT /businessunits/{businessUnitId} endpoints. - We changed the object locationDetails name to location in the POST /businessunits and PUT /businessunits/{businessUnitId} endpoints. - We removed the mac, serialNumber, ip, isStatic, and edgeConfig fields from the location object in the POST /businessunits, PUT /businessunits/{businessUnitId}, GET /businessunits/{businessUnitId}, GET /businessunits, and GET /businessunits/externalId/{externalId} endpoints. - We removed the locationTypeId field from the location object and made locationTypeId as a seperate field in the GET /businessunits, GET /businessunits/{businessUnitId}, and GET /businessunits/externalId/{externalId} endpoints. - We removed the id field from addressDetails, contactDetails, and contactPersons objects in the POST /businessunits and PUT /businessunits/{businessUnitId} endpoints. | v1 |
| 2026.2 | We enhanced the Business Unit and Bulk Import functionality to support the location-related data management using HIDM APIs. To support this enhancement in the Public API, we have extended the POST /businessunits, PUT /businessunits/{businessUnitId}, GET /businessunits/{businessUnitId}, GET /businessunits/externalId/{externalId}, GET /businessunits, GET /businessunits/externalId, and POST /businessunits/bulkImport endpoints by adding request and response fields, legalEntityNo, locationDetails, id, number, operationModeId, stationOperatorNo, posProductTypeId, locationTypeId, isLocked, eslInitialPublicationStatusId, mac, serialNumber, ip, isStatic, isSkipDeployment, edgeConfig, entityNo, identifier, edges, databaseInstanceId, name, entityStateId, isCurrentCloud, fiscalCodes, code, description, fiscalCodeTypeId, bankAccounts, bankNo, account, accountIBAN, currencyNo, addressDetails, addressTypeId, isMain, postBoxCode, houseNumber, streetTypeId, street, postalCode, city, region, territory, countryNo, countryCode, location, latitude, longitude, contactDetails, phone, fax, mobile, email, information, comments, contactPersons, title, fullName, position, remark, tagIds, fiscalCodeTypeName, tagGroupId, tagGroupName, parentTagId, isAssignable, operationModeName, apiInitialPublicationStatusId, and apiInitialPublicationDate. | v1 |
| 2026.2 | To provide a possibility to get VRP Versions via the API Platform and to ensure consistency with the backend, we introduced the following endpoints: - PUT /vrpversions/{vrpVersionId} - enables the API client to update the VRP Version by Version ID. - GET /vrpversions/{vrpVersionId} - enables the API client to retrieve the VRP Version according to the Version ID. - DELETE /vrpversions/{vrpVersionId} - enables the API client to delete the VRP Version by Version ID from the Harmonized Identity Management application. - POST /vrpversions - enables the API client to create the VRP Version. - GET /vrpversions - enables the API client to retrieve the list of VRP Versions. | v1 |
| 2026.2 | We enhanced the Bulk Import functionality to allow the bulk import of translation. To support this enhancement in the Public API, we introduced the following new endpoint: - POST /translations/bulkImport - enables the API client to bulk load Translations to the Harmonized Identity Management application. | v1 |
| 2026.2 | We enhanced the Permission feature to allow for the updating and deletion of permissions. To support this enhancement in the Public API, we introduced the following new endpoints: - PUT /permissions/{permissionId} - enables the API client to update a permission based on the unique permission ID from the HIDM. - DELETE /permissions/{permissionId} - enables the API client to delete a permission based on the unique permission ID from the HIDM. | v1 |
| 2026.2 and Patch in API 2024.2-SP5 | We implemented the MSR authentication or login method in the HIDM application by entering or providing the MSR key during user creation or editing. To support this implementation in the Public API, we added the following changes: - we added the new optional request fields msr and msrExpiration to the following endpoints: POST /users and POST /users/externalId. - we added the new optional request fields msr, msrExpiration, and deactivateMsr to the following endpoints: PUT /users/{userId} and PUT /users/externalId/{externalId}. - we added the new optional response fields msrExpiration and isMsrAvailable to the following endpoints: GET /users/{userId} and GET /users/externalId/{externalId}. We also enhanced the Tenant Password Policy. To support this enhancement in the Public API, we added the following changes: - we added the new optional request fields isGLN, isGroupCombination, isDallasKeyExpiryDisabled, dallasKeyFixedExpiry, allowDallasKeySlidingExpiry, dallasKeySlidingExpiry, isQrCodeExpiryDisabled, qrCodeFixedExpiry, allowQrCodeSlidingExpiry, qrCodeSlidingExpiry, isRfidEnabled, isRfidExpiryDisabled, rfidFixedExpiry, allowRfidSlidingExpiry, rfidSlidingExpiry, isMsrEnabled, isMsrExpiryDisabled, msrFixedExpiry, allowMsrSlidingExpiry, msrSlidingExpiry, businessUnitNameConfiguration, isEasyAccessEnabledClient, isQrCodeEnabledClient, isDallasKeyEnabledClient, isRfidEnabledClient, and isMsrEnabledClient to the following endpoint: PUT /tenant. - we added the new optional response fields isGLN, isGroupCombination, isDallasKeyExpiryDisabled, dallasKeyFixedExpiry, allowDallasKeySlidingExpiry, dallasKeySlidingExpiry, isQrCodeExpiryDisabled, qrCodeFixedExpiry, allowQrCodeSlidingExpiry, qrCodeSlidingExpiry, isRfidEnabled, isRfidExpiryDisabled, rfidFixedExpiry, allowRfidSlidingExpiry, rfidSlidingExpiry, isMsrEnabled, isMsrExpiryDisabled, msrFixedExpiry, allowMsrSlidingExpiry, msrSlidingExpiry, businessUnitNameConfiguration, isEasyAccessEnabledClient, isQrCodeEnabledClient, isDallasKeyEnabledClient, isRfidEnabledClient, and isMsrEnabledClient to the following endpoint: GET /tenant/passwordpolicy. We updated the Tenant functionality by adding the following new endpoint: - PUT /tenant/businessUnitNameConfiguration - update the business unit name configuration for the tenant. | v1 |
| 2026.2 and patch in API 2024.2-SP5 | We enhanced the Bulk Import feature to support the Dallas Key, RFID, and MSR authentication or login methods: we added the new optional request fields dallasKey, dallasKeyExpiration, rfid, rfidExpiration, msr, and msrExpiration to the following endpoint: POST /users/bulkImport. | v1 |
| 2026.2 and patch in API 2024.2-SP5 | To ensure consistency with the backend, we introduced the following endpoint: - GET /bulkImport/{bulkImportId} - retrieves the status of bulk import for the given Bulk Import ID. | v1 |
| 2026.2 and patch in API 2024.2-SP5 | We implemented the RFID authentication method in the HIDM application. The RFID functionality allows users to provide or enter the RFID while creating or editing a user for login operations. To support this implementation in the Public API, we added the following changes: - we added the new optional request fields rfid, rfidExpiration, and deactivateRfid to the following endpoints: POST /users, PUT /users/{userId}, POST /users/externalId, and PUT /users/externalId/{externalId}. - we added the new optional response fields rfidExpiration and isRfidAvailable to the following endpoints: GET /users/{userId} and GET /users/externalId/{externalId}. | v1 |
| 2026.2 and patch in API 2024.2-SP5 | We implemented the Password and Access Code expiry policies in the Tenant Settings screen. These policies allows a user to select an option of not keeping a check on the password or access code expiry and set an expiration period for the password or access code. To support this implementation in the Public API, we added the following changes: - we added the new optional request fields accessCode, accessCodeChangeFlag, isPasswordExpiryEnabled, defaultPasswordExpiry, passwordExpiryReminder, isAccessCodeExpiryEnabled, defaultAccessCodeExpiry, and accessCodeExpiryReminder to the following endpoints: POST /users/bulkImport and PUT /tenant. - we added the new optional response fields isPasswordExpiryEnabled, defaultPasswordExpiry, passwordExpiryReminder, isAccessCodeExpiryEnabled, defaultAccessCodeExpiry, accessCodeExpiryReminder, passwordExpirationDate, accessCodeExpirationDate, and readOnly to the following endpoints: GET /tenant/passwordpolicy, GET /users/{userId}, and GET /users/externalId/{externalId}. | v1 |
| 2024.2-SP5 | To enhance handling of the Permission Groups via the Public API, we exposed the following new endpoints: - POST /permissionGroups - enables the API client to create permission groups. - GET /permissionGroups/{permissionGroupId} - retrieves information about a specific permission group from the Harmonized Identity Management application based on the Permission Group ID. - PUT /permissionGroups/{permissionGroupId} - updates information about a specific permission group from the Harmonized Identity Management application based on the Permission Group ID. | v1 |
| 2024.2-SP5 | We implemented the Access Code login method in the HIDM application by generating an access code during user creation or editing. The Easy Access Password Policy enables users to log into HIDM using the access code. To support this implementation in the Public API, we added the following changes: - we added a new mandatory response field maxLastAccessCodeMatch in the GET /tenant/passwordpolicy endpoint and a new mandatory request field maxLastAccessCodeMatch in the PUT /tenant endpoint. The field maxLastAccessCodeMatch indicates how many last access code matches a user can set. - we added a new optional request field isSkipAccessCodeForever in the PUT /users/{userId} and PUT /users/externalId/{externalId} endpoints. we also added a new optional response field isSkipAccessCodeForever in the GET /users/{userId} endpoint. The field isSkipAccessCodeForever allows external users to skip local access code setup upon each login. | v1 |
| 2024.2-SP5 | HIDM application was enhanced with a feature that allows user to login to all child Business Units below if access is provided for the higher node BU. To support this enhancement, we extended Public API with the following endpoints: GET /tenant/passwordpolicy and PUT /tenant where optional flag AllowChildBusinessUnitLogin was added in response and request of the endpoints respectively. When flag AllowChildBusinessUnitLogin set to True, a user with access to higher level BU can see all child BU even when explicit access to child BUs are not provided. | v1 |
| 2024.2-SP5 | We implemented the Dallas Key and QR Code authentication or login methods in the HIDM application. Users can generate a QR Code or provide the Dallas Key during user creation or editing. The QR Code allows users to generate a QR Code for login operations. The Dallas Key allows users to provide a Dallas Key for login operations. To support this implementation in the Public API, we added the following changes: - we added the new optional request fields qrCode, dallasKey, and dallasKeyExpiration to the following endpoints: POST /users, PUT /users/{userId}, POST /users/externalId, and PUT /users/externalId/{externalId}. - we added the new optional response fields isDallasKeyAvailable, isQrCodeAvailable, and qrCodeExpiration to the following endpoints: GET /users/{userId} and GET /users/externalId/{externalId}. | v1 |
| 2024.2-SP5 | We implemented the Access Code login method in the HIDM application by generating an access code during user creation or editing. The Easy Access Password Policy enables users to log into HIDM using the access code. To support this implementation in the Public API, we added the following changes: - we added a new optional request fields AccessCode and AccessCodeChangeFlag to the following endpoints: POST /users, PUT /users/{userId}, POST /users/externalId, and PUT /users/externalId/{externalId}. The property AccessCode indicates the Access Code of the user. The property AccessCodeChangeFlag indicates whether the Access Code needs to be changed. - we added a new optional response field isEasyAccessEnabled to the following endpoint: GET /clients/externalId/{externalId}. The property isEasyAccessEnabled indicates whether Easy Access is enabled for the client. - we added a new optional response fields accessCodeChangeFlag and isAccessCodeAvailable to the following endpoints: GET /users/{userId} and GET /users/externalId/{externalId}. The property accessCodeChangeFlag indicates whether the Access Code needs to be changed. The property isAccessCodeAvailable indicates whether the user has an Access Code for authentication. | v1 |
| 2024.2-SP5 | To enhance user experience, we introduced a new field isSkippedPasswordForever which allows external users to skip local password setup on each HIDM login. To support this improvement in Public API, we added a new optional field isSkippedPasswordForever to the following endpoints: - PUT /users/externalId/{externalId} (in request) - PUT /users/{userId} (in request) - GET /users/{userId} (in response) | v1 |
| 2024.2-SP5 and Patch in API 2024.2 | We enhanced large-scale data sets processing in HIDM with the bulk load operations feature. It minimizes the number of requests and improves integration of batch processes. You can perform bulk import of the following HIDM objects: Business Unit Types, Permission Groups, Roles, and Users using the following endpoints: - POST /businessUnitTypes/bulkImport - POST /permissionGroups/bulkImport - POST /roles/bulkImport - POST /users/bulkImport | v1 |
| 2024.2-SP5 and Patch in API 2024.2 | We improved User Role hierachy in the HIDM application by restricting users' access to only assigned Roles and downwards in the Role tree. Currently, you can only view and manage other users' roles who have the same role as you or a lower role. To support this enhancement in Public API, we introduced the following changes: - we added new fields isSystem and parentId to the following endpoints: POST /roles (in request), PUT /roles/{roleId} (in request), GET /roles/{roleId} (in response) , and GET /roles (in response). The property isSystem indicates role dedicated for client-only usage by system applications or services. The parentId field identifies a parent role. Both new properties are not mandatory. - we added a new request parameter includeSystem to the GET /roles, and GET /roles/externalId endpoints. It depicts technical roles used by system applications or services. - we added new response fields: isSystem and parentExternalId (external identifier of a parent role) to the GET /roles/externalId/{externalId} and GET /roles/externalId endpoints. | v1 |
| 2024.2-SP5 and Patch in API 2024.2 | The HIDM application was enhanced with operations using External Identifiers (externalId). External Id is a reference to a unique ID of the entity (for example Business Unit, Business Unit Type, Role, Client, etc.) as defined in the external application, for instance, third-party ERP system. To support this enhancement we extended Public API with the following endpoints: - DELETE /businessunits/externalId/{externalId} - deletes a Business Unit based on the unique externalId. - PUT /businessunits/externalId/{externalId}/changeStatus - updates the status of a Business Unit based on the BU ExternalId. - GET /businessunits/externalId - retrieves a list of Business Units with ExternalId. - GET /businessunits/externalId/{externalId} - provides details on a specific Business Unit based on the unique externalId. - DELETE /businessUnitTypes/externalId/{externalId} - delete a Business Unit Type based on the unique externalId. - PUT /businessUnitTypes/externalId/{externalId}/status - updates the status of a Business Unit Type based on the unique externalId. - GET /businessUnitTypes/externalId - retrieves a list of Business Unit Types with External Ids. - GET /businessUnitTypes/externalId/{externalId} - provides details on a specific Business Unit Type based on the unique externalId. - DELETE /roles/externalId/{externalId} - deletes a Role based on the unique externalId. - GET /roles/externalId - retrieves a list of Roles with external identifiers. - GET /roles/externalId/{externalId} - provides details on a specific Role based on the unique externalId. - DELETE /applications/externalId/{externalId} - deletes an Application based on the unique externalId. - PUT /applications/externalId/{externalId}/status - enables to change status for an Application, based on the unique externalId. - GET /applications/externalId/{externalId} - provides details on a specific Application based on the unique externalId. - DELETE /clients/externalId/{externalId} - deletes a Client based on the unique externalId. - PUT /clients/externalId/{externalId}/enabled - updates status (active/inactive) of a Client, based on the unique externalId. - GET /clients/externalId/{externalId} - provides details on a specific Client based on the unique externalId. - GET /permissions/externalId/{externalId} - provides details on a specific Permission based on the unique externalId. - DELETE /permissionGroups/externalId/{externalId} - deletes a Permission Group based on the unique externalId. - GET /permissionGroups/externalId - retrieves a list of Permission Groups with external identifiers. - GET /permissionGroups/externalId/{externalId} - provides details on a specific Permission Group based on the unique externalId. - DELETE /users/externalId/{externalId} - deletes a User based on the unique externalId. - PUT /users/externalId/{externalId}/lock - locks/unlocks a User based on the unique externalId. - PUT /users/externalId/{externalId}/resetMfa - allows to reset Multi-Factor Authentication (MFA) for a User, based on the unique externalId. | v1 |
| 2024.2-SP5 and Patch in API 2024.2 | To enable a service-level health check, we introduced a new endpoint: - GET /healthCheck. It enables the API client to check the API health status including the backend service status. A client can check the status of the backend service so that it knows when to switch from cloud to edge. On the 200 response, the client receives the overall status information: healthy, degraded, unhealthy. | v1 |
| 2024.2-SP5 | To enhance handling Permissions, Permission Groups, Applications, Clients and Resources via the Public API, we exposed the following new endpoints: - GET /permissions - retrieves a list of all permissions. - GET /permissionGroups - retrieves a list of all permission groups. - GET /applications - retrieves a list of all applications. - GET /clients - retrieves a list of all clients. - GET /resources - retrieves a list of all resources. | v1 |
| Patch in API 2024.2 | Users is a module in Harmonized Identity Management (HIDM) that enables HIDM users to set up and manage User details in HIDM. Managing Users includes tasks such as creating and editing a User, activating-deactivating status of a User, deleting a User, and more. To support handling Users by the Public API, we introduced the following new endpoints: - PUT /users/{userId} - updates a user data in the HIDM application, based on the unique userId. - DELETE /users/{userId} - deletes a User (based on the unique userId) from the HIDM application. - PUT /users/{userId}/status - updates the Status of a User in the HIDM application, based on the unique userId. The available statuses are: active and inactive. - PUT /users/{userId}/lock - enables the API Client to lock/unlock a user in the HIDM application, based on the unique userId. - PUT /users/{userId}/resetMfa - enables to reset Multi-Factor Authentication (MFA) for a user in the HIDM application, based on the unique userId. - POST /users/externalId - creates a user in the HIDM application, based on external identifiers. - GET /users/externalId/{externalId} - provides details on a specific user based on the unique externalId. - PUT /users/externalId/{externalId} - updates a user data in the HIDM application, based on the user external identifier (externalId). - PUT /users/externalId/{externalId}/status - updates a user status in the HIDM application, based on the user external identifier (externalId). We also introduced the following changes in the previously implemented endpoints: - the users.userName maximum size changed to 40 characters in the GET /users, GET /users/{userId}, and GET /users/{userId} endpoints. - the users.email maximum size changed to 256 characters in the GET /users endpoint. - the maximum characters restriction for rowVersion removed in the GET /users and GET /users/{userId} endpoints. - the externalId field changed from optional to mandatory in the POST /users endpoint. - the lastName field changed from mandatory to optional in the POST /users and GET /users/{userId} endpoints. | v1 |
| Patch in API 2024.2 | Roles is a module in Harmonized Identity Management that enables users to set up and manage Local Roles and Global Roles for different applications. Managing Roles includes tasks such as creating, editing, deleting, or viewing details of the Roles added. To support handling Roles by the Public API, we introduced the following new endpoints: - POST /roles - creates a Role in the HIDM application. - GET /roles - retrieves a multiple Roles details (for instance, name, description, externalId, permission groups associated with Roles). - GET /roles/{roleId} - enables the API client to retrieve a Role details (for instance, name, description, externalId, permission groups associated with the Role), based on the roleId. - PUT /roles/{roleId} - updates a given Role details, based on the roleId. - DELETE /roles/{roleId} - enables the API client to delete a Role, based on the roleId. | v1 |
| Patch in API 2024.2 | To enhance managing Business Unit Types, we exposed the following new endpoints: - GET /businessUnitTypes/parents - retrieves a list of all parents of a Business Unit Type. - GET /locationtypes - retrieves location types (Office, Warehouse, Location) We also introduced the following changes: - we changed the maximum characters for Name of Business Unit Type (name field) to 100 in the following endpoints: POST /businessUnitTypes, GET /businessUnitTypes/{businessUnitTypeId}, GET /businessUnitTypes, PUT /businessUnitTypes/{businessUnitTypeId}. - we changed externalId field from optional to mandatory in the POST /businessUnitTypes endpoint and removed externalId field in the PUT /businessUnitTypes/{businessUnitTypeId} endpoint. - In the PUT /businessUnitTypes/{businessUnitTypeId} and PUT /businessUnitTypes/{businessUnitTypeId}/status endpoints we deleted the maximum characters restriction for rowVersion string (in request and response). | v1 |
| Patch in API 2024.2 | Business Units enable an Enterprise to create and manage organization business hierarchy. Managing Business unit records includes tasks such as editing, deleting, deactivating or viewing details of the Business Units added. To support managing Business Units by the Public API, we enhanced the following endpoins: - POST /businessunits - we added new optional request fields: vrpVersionId (specifies VRP version installed in a particular Business Unit), regionCode (region code of the Business Unit), globalLocationNumber (GLN is a reference to a unique ID of the newly created Business Unit in an external system). We also changed the following request field: ownerBusinessUnitId from optional to mandatory. - GET /businessunits - we added new optional response fields: businessUnits.isFranchise (flag indicating if the Business Unit operates as a franchise), businessUnits.metadata, businessUnits.vrpVersionId,businessUnits.regionCode, businessUnits.globalLocationNumber. We changed the following response fields: businessUnits.id,businessUnits.parentBusinessUnitId, businessUnits.externalId to optional. - GET /businessunits/{businessUnitId} - we added new optional response fields: isFranchise, metadata, vrpVersionId, regionCode, globalLocationNumber. We changed the following response fields to optional: id, parentBusinessUnitId, externalId. - DELETE /businessunits/{businessUnitId} - we added a new mandatory request field: ownerBusinessUnitId (unique identifier of Business Unit Owner) - PUT /businessunits/{businessUnitId} - we added new optional request fields: isFranchise, metadata, vrpVersionId, regionCode, globalLocationNumber, and a new mandatory request field: ownerBusinessUnitId. We changed the following fields: parentBusinessUnitId (in request) and rowVersion (in response) to optional. The request field: externalId was deleted. - PUT /businessunits/{businessUnitId}/changeStatus - we added a new mandatory request field: ownerBusinessUnitId. We changed response field: rowVersion from mandatory to optional. | v1 |
| 2024.2 | To support managing Business Unit Types by the Public API endpoints, we added a new optional field: locationTypeId, indicating a location type, to the following endpoints: - POST /businessUnitTypes (in request) - GET /businessUnitTypes/{businessUnitTypeId} (in response) - GET /businessUnitTypes (businessUnitTypes.locationTypeId, in response) We also removed the isLocation field from the PUT /businessUnitTypes/{businessUnitTypeId} endpoint (in request). | v1 |
| 2024.1 | To resolve the issue with adding a business unit and to be consistent with the current backend we modified the POST /businessunits endpoint: - we increased the Business Unit name size to 100 characters - we changed the parentBusinessUnitId field from required to optional - we added the following new fields in request: isFranchise and ownerBusinessUnitId | v1 |
| 2024.1 | Users is a module in Harmonized Identity Management (HIDM) that enables the Retailer to successfully manage and maintain user authentication and authorization. Users may be assigned to one or more applications integrated with HIDM, assuming different roles in each application. To support the set up and management of User details in HIDM we exposed the following endpoints: - POST /users - Enables to create a user. - GET /users/{userId} - Provides details on the specific user based on unique userId - GET /users - Retrieves details on multiple users | v1 |
| 2024.1 | We changed the request field externalId to mandatory in the POST /businessunits endpoint. | v1 |
| 2023.3 | To improve using business units in HIDM, we introduced the following endpoints for managing Business Unit Types: - GET /businessUnitTypes - retrieves a list of all Business Unit Types. - POST /businessUnitTypes - enables to create a new Business Unit Type. - GET /businessUnitTypes/{businessUnitTypeId} - provides details about a specific Business Unit Type based on the BU Types's Id (unique identifier). - DELETE /businessUnitTypes/{businessUnitTypeId} - enables to delete a Business Unit Type entry. - PUT /businessUnitTypes/{businessUnitTypeId} - enables to update information on a specific Business Unit Type. - PUT /businessUnitTypes/{businessUnitTypeId}/status - enables to change the status of a Business Unit Type. The available statuses are active and inactive. | 1.1.7 |