README

Master data entities in Hii Retail

The entities used in Hii Retail are modeled closely to how each entity exists in the real world. This is cognitively important to make the integration easy, and it also makes the payload of data easier to navigate.

The entities

• Item
• Price Specification
• Item Identifier
• Item Category
• Promotion
• Deposit Rule
• Assortment Policy
• Item Link
• Content Declaration
• Business Units
• Complete Item

Entity Relations

The entities in Hii Retail are eventually consistent. This means that several of our entities have a foreign key reference to another entity, but this reference is not enforced internally. It also means that it is possible to send all entities in any order without causing broken links, as long as all required entities are produced to Hii Retail.

The requirement for consistency is maintained in downstream services such as the Store Data Service, which is responsible for constructing and distributing the data to POS. In addition we have the concept of a Complete Item, which is used for legacy integrations and edge communication.

If an entity is missing, the link will be broken until it is provided. More about this in Integrating master data