Contents
Topic overview
The extension of the Sales channels application in the Multi-channel sales introduces a new type of adapter to the Sales channels application. An OXID adapter can be chosen when creating a new sales channel. With the OXID adapter it is possible to use the MCS framework to exchange the data with the OXID webshops.
For more information about the OXID adapter, see the document Introduction: OXID adapter.
This documentation describes the structure of the extension for Sales channels application. For more information about the application, see the document Sales Channels.
For more information about the Multi-channel sales framework, see the document Introduction: Multi-Channel Sales.
Definition of terms
Sales channel
Depending on the context, the term might have one of the following meanings:
1. External system in which items are sold (e.g. web shop, call centre, shopping mall).
2. An ERP business entity which stores the configuration for connection with sales channel within the meaning of 1.
OXID Webshop
An open source e-commerce platform providing the online shop functionality with support for B2B and B2C processes.
OXID adapter
An adapter dedicated to the MCS framework. The OXID adapter extends the MCS framework with capability to connect to the OXID webshops. The OXID adapter is provided in a separate App.
Application description
The extension of Sales channels application is used to view, create and edit the extension attributes of sales channels in order to configure the sales channel to the specific requirements of the OXID webshop.
The extension of Sales channels application comprises of an additional tab in the work pane.
Work pane
The extension of the work pane comprises of additional tab OXID.
OXID tab
The OXID tab contains the OXID-specific configuration fields:
Shop connection
The Shop connection group contains all the attributes that are required to establish a connection with the OXID webshop. This connection is the default communication channel used during the exchange of data between the CEE and the webshop.
| Field | Explanation |
|---|---|
| Web shop URL | Enter the URL of the OXID web shop that you want to connect to the ERP system. Data between the OXID web shop and the ERP system are exchanged using web services of the SOAP category. The URL is required for setting up the connection of the web service. |
| Shop username | Enter the name of the HTTP user. |
| HTTP password | Enter the password for the HTTP user. |
| Shop ID | Enter the ID of the OXID shop that shall be connected to the ERP system with the help of the adapter. |
| Enable HTTP authentication | Use this setting to enable the basic HTTP authentication during connection. |
| Use Shop credentials for HTTP authentication | Select this checkbox if the HTTP authentication should be made using Webshop user credentials. |
| HTTP username | Enter the name of the HTTP user. |
| HTTP password | Enter the password for the HTTP user. |
FTP connection
The “FTP connection” group contains all the attributes that are required to establish a FTP connection with the OXID webshop. The FTP connection is used to transfer large binary data between the CEE and the webshop (e.g. pictures).
| Field | Explanation |
|---|---|
| Explanation | Use this setting to enable the FTP connection for this sales channel. The FTP is used for sending binary data to the webshop (e.g. images). |
| Use shop credentials for FTP | Select this checkbox if the FTP connection should be authenticated using Website user credentials. |
| FTP URL | Enter the URL of the FTP server that you want to connect from the ERP system. |
| FTP username | Enter the name of the FTP user. |
| FTP password | Enter the password for the FTP user. |
| Use active mode | Use active mode instead of default passive mode. |
| Port range (min) | Enter the lowest available port (inclusive) to be used in active mode. If both ports are set to 0, the range is determined by the system. |
| Port range (max) | Enter the lowest available port (inclusive) to be used in active mode. If both ports are set to 0, the range is determined by the system. |
Locale
The Locale group contains various localization settings that can be used to fine-tune the multilingual functions of the adapter.
| Field | Explanation |
|---|---|
| Default language | The default language used in the OXID shop that is connected to the ERP system. This language corresponds to the language with ID 0 in OXID. |
| Additional languages | With this field you can determine which additional languages should be supported by the current sales channel. Please note that setting many languages may have negative impact on the transfer times. |
| Timezone | Enter a time zone used by the OXID shop that is connected to the ERP system. |
Defaults
The Defaults group contains various channel-specific default values that are used during data transfers using the MCS framework:
| Field | Explanation |
|---|---|
| Brands/manufacturers | Enter the sales channel item categories that will be used as selection of OXID brands/manufacturers. |
| Distributors | Enter the sales channel item categories that will be used as selection of OXID distributors. |
| Main brands/manufacturers | Define a selection of brands/manufacturers from the master sales channel that should be available to the sub-shop. |
| Main distributors | Define a selection of distributors from the master sales channel that should be available to the sub-shop. |
| Main categories | Define a selection of categories from the master sales channel that should be available to the sub-shop. |
| Mobile phone method | Enter the communication method representing the mobile phone of customer. |
| Private phone method | Enter the communication method representing the private phone of customer. |
| Delivery Status | Choose type of stock managing used by articles in the OXID shop that is connected to the ERP system. At Delivery status you can select from 4 settings: · Standard: The product can then also be ordered if it is sold out. · External storehouse: The product can always be purchased and is always displayed as in stock. · If out of stock, offline: The product is not displayed if it is sold out. · If out of stock, not orderable: The product is displayed if it is sold out but it cannot be ordered. |
| Unit of length | Enter the default unit of length. |
| Unit of weight | Enter the default unit of weight. |
| Billing item for header discount | Enter the billing item which will be used to store the total discount of the sales order. |
| Billing item for header voucher discount | Enter the billing item which will be used to store the total voucher discount of the sales order. |
| Inherit all products from parent shop | Use this setting to if all the products from the master shop should be unrestrictedly available in this sales channel. |
Defaults-prices
The Defaults group contains various channel-specific default values that are used during the export of prices in the framework. For more information regarding the price calculation, see document Introduction: OXID adapter.
| Field | Explanation |
|---|---|
| RRP group | Enter the customer price classification associated with the Recommended retail price (RRP). |
| Price A group | Enter the customer price classification representing the price A user group. |
| Price B group | Enter the customer price classification representing the price B user group. |
| Price C group | Enter the customer price classification representing the price C user group. |
Business entities
The following business entity is relevant for the Sales channels application. It is used, for example, to perform the following:
- Configure the entity mappings between CEE and the OXID webshop.
OXID adapter
com.sem.ext.app.oxid.obj.OXIDAdapter
The business entity is not a part of any business entity group.
Customizing
No settings need to be made in the Customizing application for the extension of Sales channels application.