Markets
Structure and configuration
All orders in Omnium require a Market ID, which defines a variety of configurations, including:
- Language
- Region
- Currency
- Shipments
- Number options
- Tax options
- Available connectors
There are no limitations on the number of markets. Markets can be set up based on factors such as country, state or region, brand, concept, or a combination of these, depending on business needs.
Considerations for market setup
Product languages and currencies
Markets determine the product language and currency for placed orders.
- Each currency and/or product language should have its own market.
- Stores can be related to multiple markets. For example, if a web store serves multiple markets with different currencies or languages, the market determines the product language and price currency for the placed order.
B2B vs. B2C
Markets can differentiate between B2B and B2C customers.
- Market settings allow you to configure whether prices and orders include or exclude tax.
Customer communication
Markets also influence customer communication:
- Design custom email templates for each market to support different languages, brands, or concepts.
Market Model
Properties
| Property | Type | Description |
|---|---|---|
| MarketId | string | Unique market ID (e.g., ENG, NOR, SWE). |
| MarketName | string | Name of the market. |
| IsDefaultMarket | bool | True if the market should be used by default for new orders. |
| IsActive | bool | True if the market is active; False if temporarily unavailable. |
| IsTaxExcluded | bool | True if tax should not be added to orders. |
| Language | string | Market language name (e.g., English, Norwegian, German). |
| LanguageCode | string | Two-letter ISO language code (e.g., no, en). |
| IsoLanguageCode | string | ISO Language/Region code (e.g., en-US, nb-NO, de-DE). |
| CountryCode | string | Two-letter country code (e.g., "EN", "NO"). |
| Currency | string | Default market currency (e.g., USD, EUR, NOK). |
| ProductContentLanguage | string | Default product content language for the market (e.g., en, se, no). |
| ShipmentOptions | List<ShipmentOption> | List of shipment options available for the market. |
| NumberOptions | List<NumberOptions> | List of market-specific number options. |
| EmailClientSettings | EmailClientSettings | E-mail client settings for the market. |
| Connectors | List<ConnectorOptions> | List of market-specific connector options. |
| ReturnCharges | ReturnCharges | Default return charge values for the market. |
| MarketGroupId | string | Used for CompanyId in D365 or as a grouping key for multiple markets. |
| MarketGroupLabel | string | Label used for market groups in the UI. |
| MarketType | string | Market type (e.g., B2C, B2B). |
| DefaultTaxRate | decimal? | Default tax rate for the market. |
| DefaultVatType | decimal? | Default VAT type (e.g., accounting system codes like 3, 52). |
| DefaultPaymentType | string | Automatically set when creating a new cart for the current market. |
| Properties | List<PropertyItem> | Custom properties for the market. |
Return Charges Model
| Property | Type | Description |
|---|---|---|
| ReturnCost | decimal | Default cost charged to the customer for returns. |
| NotPickedUpCost | decimal | Default cost charged to the customer for unclaimed shipments. |