Business unit group data
Business Unit Group Data
When integrating with Hii Retail, it's essential to understand how you manage and distribute your master data.
Hii Retail allows you to assign master data in two primary ways: at the Business Unit specific level or, as discussed here, at the Business Unit Group level.
Overview
Retailers often organize their stores, or Business Units, into various groups or hierarchies. These groupings may be based on factors such as store size, location, or specific operational characteristics. For example, city-center stores may require different pricing than rural stores, shopping centers might demand a different product assortment compared to local corner shops, and some stores may offer in-house dining options or produce sellable items on-site.
These differences often necessitate distinct treatment of certain store groups.
This section focuses on scenarios where the grouping is not managed within your ERP system, and Hii Retail is responsible for calculating the correct output for each specific Business Unit.
When to Use Business Unit Group Endpoints
These endpoints are ideal when your organization uses a hierarchy to manage data differences across various segments of Business Units, and your ERP or PIM lacks the advanced capabilities to generate Business Unit-specific outputs.
Another scenario might involve bandwidth constraints, where you prefer to minimize the data sent from your ERP to integration services, allowing Hii Retail to handle large volumes of data as close to the communication and distribution services as possible.
Requirements and Restrictions
To integrate with Hii Retail at a Business Unit Group level, the following requirements and restrictions apply:
- All data in POST or PUT requests to our APIs must be complete for the given Business Unit Group and all sub-Business Units.
- The Business Unit Group ID must exist in Hii Retail's Business Unit Management system.
- PATCH or DELETE requests will update or delete all sub-entities, regardless of any overrides made at lower levels in the hierarchy.
- If a Business Unit ID is provided to these endpoints, the action will apply only to that specific Business Unit (this behavior may be subject to change).