Skip to main content

Business unit data

Business Unit Specific Data

When integrating with Hii Retail, it's crucial 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 Group level or, as discussed here, at the Business Unit-specific level.

Overview​

Retailers often organize their stores or Business Units into various groups or hierarchies. These groupings may be based on store size, location, or specific characteristics, such as differing pricing strategies for city-center versus rural stores. For example, shopping centers might require a different product assortment than local corner shops. Some stores might feature an in-house café or offer on-site production of sellable items, while others do not.

These differences often necessitate treating certain groups of stores differently from others.

This section focuses on scenarios where grouping is managed within your ERP system, and Hii Retail receives fully prepared data specific to each Business Unit.

When to Use Business Unit-Specific Endpoints​

These endpoints should be used when your data is already generated by an ERP or PIM solution for each Business Unit within your organization.

Integration Requirements​

To integrate with Hii Retail at a Business Unit-specific level, we expect that your ERP system handles all necessary data processing. The data received by Hii Retail should be complete and ready for distribution to downstream systems.

The following requirements apply:

  • All data in POST or PUT requests to our APIs must be complete.
  • The Business Unit ID must exist downstream; Hii Retail will not validate this before proceeding with data distribution.
  • PATCH or DELETE requests will have no effect if the specified data does not already exist.
  • PATCH requests will update individual properties of the existing data.
  • If a Business Unit Group ID is provided to these endpoints, no actions will be taken on the data, and no outputs will be generated for any Business Units.