Store Management Service

Introduction

The Store Management Service in the Brink Commerce API is designed to be as flexible as possible in order to tailor to your needs. This service allows for a wide range of operations that can be tailored to fit the unique needs of your business. This documentation aims to provide comprehensive information on how to utilize the Store Management Service effectively.

StoreGroup

A StoreGroup acts as a sales channel, specifying who buys something, from whom they buy it, where they buy it, and what price they pay for it.

Features

• Multiple Storefronts: A single StoreGroup can represent one or multiple storefronts.

• Customer Tiering: Use StoreGroup to implement customer tiering strategies.

• Commercial Prerequisites: Tailor aspects like pricing according to your needs.

• Legal Entities: Allows a merchant to operate under different legal entities within the same Brink Commerce API. For example, you can have Merchant Ltd for the UK market and Merchant Inc for the US market.

StoreMarket

A StoreMarket is a country with a specified currency.

Features

• Provider Integrations: Easily specify what Payment Service Providers, gift card providers and shipping checkout providers that should be available for a specific StoreMarket.

• Inventory setup: Connect and prioritize your your inventories

Entity relationship

• A StoreGroup can be assigned multiple StoreMarkets.
• Each StoreMarket is unique to a StoreGroup.

StoreGroup 1 ----< StoreMarket

Entity Attributes

StoreGroup

• id: Unique identifier
• name: Name of the StoreGroup
• description: Description of the StoreGroup

StoreMarket

• countryCode: Country code
• currencyCode: Currency code
• storeGroupId: ID of the StoreGroup it belongs to

Operations

StoreGroup and StoreMarket support the following operations:

• Create (PUT)
• Update (PUT/PATCH)
• Delete (DELETE)
• List (GET)

StoreGroup also support fetching information regarding a single StoreGroup

• Get details (GET)

Fields and Descriptions

Field	Description
id	Unique identifier for the StoreGroup
name	Name of the StoreGroup
description	Brief description of the StoreGroup
legalEntity	Legal entity under which the StoreGroup operates
pricingModel	The pricing model applied to the StoreGroup
inventoryModel	The inventory model applied to the StoreGroup
createdAt	Timestamp indicating when the StoreGroup was created
updatedAt	Timestamp indicating the last update to the StoreGroup

---

For more details, you can visit the Brink Commerce Store Management Service Documentation.

Related entities

• Providers
• Inventory
• ProductVariantPrice

Relationships

StoreMarket and ProductVariantPrice

A ProductVariantPrice is set to a countryCode and a storeGroupId, making it unique to a StoreMarket.

StoreMarket 1 ----< ProductVariantPrice

StoreMarket and Inventory

Multiple Inventories (identified by inventoryId) can be assigned to multiple StoreMarkets.

StoreMarket >----< Inventory

Related Entity Attributes

ProductVariantPrice

• countryCode: Country code
• storeGroupId: ID of the StoreGroup it belongs to
• price: Price of the product variant

Inventory

• inventoryId: Unique identifier for the inventory

Related entities diagram

StoreGroup 1 ----< StoreMarket >----< Inventory
                        |
                        |
                        1
                        |
                        |
                        |
                        V
               ProductVariantPrice

This diagram outlines the relationships between the entities within domain management in the Brink Commerce API.