Configuration
Explore how to configure and manage markets in Omnium, including setting language, region, currency, tax, and shipment options. This guide helps you understand the key components and considerations for setting up markets for different customer needs and regions.
Omnium market setup
All orders in Omnium require a market ID. The market contains lots of options, including:
- Language
- Region
- Currency
- Shipments
- Number options
- Tax options
- Available connectors
There are no limitations on the number of markets. Based on the requirements, a market could be set up by country, state, or region, brand, or concept – or a combination of the above.
Considerations for Market Setup
Product Languages and Currencies
Markets are used to determine the product language and currency for placed orders. As a rule of thumb, every currency and/or product language should have its own market. Stores can be related to multiple markets, so in cases where a single store serves multiple markets (i.e., a web store that sells products in multiple countries with different currencies and/or languages), orders placed for the store in question will get its product language and price currency based on the market the order is placed in.
B2B vs B2C
Another use case for markets is separation between B2C and B2B. In market settings, it is also possible to configure whether prices and orders include or exclude tax.
Customer Communication
Communication with customers is also affected by the market structure. It is possible to design custom email templates for each market to support different languages and brands/concepts.
Market Model
| Property | Type | Description |
|---|---|---|
| MarketId | string | Unique market ID (ENG, NOR, SWE, etc) |
| MarketName | string | Name of market |
| IsDefaultMarket | bool | True if market should be used by default for new orders |
| IsActive | bool | True if market is active. False if temporarily unavailable. |
| IsTaxExcluded | bool | True if tax should not be added to orders |
| Language | string | Market language name (English, Norwegian, German, etc...) |
| LanguageCode | string | Market language code (two-letter ISO: no, en, etc...) |
| IsoLanguageCode | string | ISO Language/Region-code (en-US, nb-NO, de-DE, etc...) |
| CountryCode | string | Two-letter country code ("EN", "NO", etc...) |
| Currency | string | Default market currency (USD, EUR, NOK, etc.) |
| ProductContentLanguage | string | Default market content language for products (en, se, no, etc) |
| ShipmentOptions | List<ShipmentOption> | List of shipment options available for market |
| NumberOptions | List<NumberOptions> | List of market-specific number options |
| EmailClientSettings | EmailClientSettings | E-mail client settings |
| Connectors | List<ConnectorOptions> | List of market-specific connector options |
| ReturnCharges | ReturnCharges | Default return charge values |
| MarketGroupId | string | Used for CompanyId in D365, but can also be used as a key to group multiple markets |
| MarketGroupLabel | string | Used for labeling market groups in UI |
| MarketType | string | B2C / B2B / Possible other values for other tenants |
| DefaultTaxRate | decimal? | Default tax rate for market |
| DefaultVatType | decimal? | Default VAT type (VAT type in accounting systems: 3, 52, etc.) |
| DefaultPaymentType | string | Will automatically be set when creating a new cart for the current market |
| Properties | List<PropertyItem> | Custom properties |
Return Charges Model
| Property | Type | Description | Information |
|---|---|---|---|
| ReturnCost | decimal | Default cost to charge customer for return | |
| NotPickedUpCost | decimal | Default cost to charge customer for shipments not picked up |