Knowledge Base

E-commerce channel is a sales channel that uses marketplace platforms such as Tokopedia and Shopee or channels that use Webstore platforms such as Shopify and SWIFT. After we set up the Marketplace (MP) Adapter configuration, the next step is registering the marketplace (e-commerce) as a sales channel in the SWIFT OMS. 

As mentioned before, the Marketplace (MP) Adapter configuration (for marketplace channel) and access token (for webstore channel) should be set before registering the e-commerce channels to SWIFT OMS.

1. Set Production Mode to Yes if you are in the production environment.
   

2. If you already have API Client Key, you can put it here. If not, you can leave it blank because we can generate it on the Integration menu.
   

3. Production URL & Staging URL can be set to the default value. URL changes can be made only when it is needed.
   

4. Set Google Project ID to sirclo-prod for the production environment. For sandbox/staging, set the value to sirclo-1152.
   

5. Google Service Account Directory can be set to default. If you want to change to another path, make sure it has the right permissions.
   

6. Click Choose File button to upload your service account file. If you are Google Cloud Marketplace users, you can skip this step as the file has already been uploaded.
   

• Request Access Token 
  To integrate with the webstore, especially SWIFT or Magento 2 (M2), or other channels that will use the SWIFT OMS API, you need to create a request to the ICUBE Support Team for an API Access Token. The support team will generate an access token via back-office access in SWIFT OMS.
  
  This access token will be placed on the SWIFT or Magento 2 channel configuration, not on the SWIFT OMS.

To add e-commerce channel integration:

1. Go to the Integration menu and select Ecommerce Channel.
   
2. Click on the Add Channel button to add a new e-commerce channel.
   
   
3. There are two e-commerce platforms; marketplace store and webstore. Select which e-commerce you want to use for the new channel then click the Start Integration button.
   
   
4. Please complete the requirements for the new channel to get capability on the selected marketplace (this is shown on the right side of the page). 
   
5. The credentials and capabilities from each marketplace might be different but data such as assigned store & location, seller store name/identity, cutoff date, etc are always required.
   
   
6. Click the Start Integration button to save this marketplace integration. Repeat all steps if you have multiple brands or stores.
   

After integration, the status on the newly added marketplace channel is set to Connected by default. You can disconnect or reconnect the specific channel by clicking button.

• To disconnect an active channel, click on then select Disconnect.
  

• To reconnect the disconnected channel, click on then select Reconnect.
  

Like any other channel, you can also edit the details for your e-commerce channel as follows:

1. On the Integration > Ecommerce Channel, click button on the channel you want to edit and select Edit.
   
   
   
2. The page will redirect you to the Edit Sales Channel page on the Masters menu. Edit channel details as you need and please note to complete the required fields. For the details of all fields on the channel editing form, please refer to the Channel Management on Master Data Management.
   
   
   
3. Click Submit button to save changes. This will redirect you back to the E-commerce Channel Integration page.