Skip to main content

Business units

Business Unit​

All orders must be connected to a business unit (AKA a store). The Hii Retail platform is in most cases dependent on knowing at least basic information about all stores that will use the solution. To learn more about Business Units, you can check the Business Unit API. Once the stores are created, every request to Click and Collect has to say which store it concerns — but how you pass it depends on which interface you are calling:

  • REST — the business unit is part of the path: /api/v1/business-units/{businessUnitId}/orders/…
  • GraphQL — the business unit is a required header, Business-Unit-Id. A query without it is rejected.

Business unit layout​

Stores are rarely laid out alike, and a picker's natural starting point differs from shop to shop. So each store can map its own picking path: an ordered list of item categories and sub-categories, arranged into zones that match the physical floor. Any authorised user can do this in the app.

⚠ Configuring a layout does not yet change the order the picker's list is shown in. The layout is captured and stored, and the zones and ordering are yours to set, but the pick list is not currently sorted by it. Until that lands, treat the layout as preparation rather than something that changes a picker's route today.