How to set up a Wix Sales Channel [Step-by-step guide]

To connect Wix, first create a Sales Channel connection, and then set up its parameters. 

Once the connection is established between the channel and techOMS, you can use all its supported features as listed in the techOMS Sales Channels - Master List [Guides List].

This article is divided into the following sections:

1. Onboarding Requirements
2. Create the Sales Channel
3. Configure Additional Parameters

 NOTE: Make sure that you are operating at the right Vendor/Warehouse beforehand.

I. ONBOARDING REQUIREMENTS

• This plugin is developed for Wix Stores Catalog v1 API
  

  
  

  WARNING: Make sure to identify your Catalog API version before moving forward.

  
  
• Install the techOMS App from the Wix App Market (steps provided in section II)

NOTE: This section is partly performed in Wix. The following instructions are provided as guidance and may change without notice.

To create a Wix sales channel: 

1. Access the Wix App Market here: https://manage.wix.com/app-market

2. Search for the techOMS app using the search bar, locate the techOMS app and click on it.

3. Press Add to Site to be redirected to your Wix administration console. 

NOTE: If you have more than one Wix site, you will be prompted to select one. Do it and confirm again to complete the techOMS app installation.

Once confirmed, you will be automatically redirected to techOMS.

4. Select the Sales Channel Account you want to create the connection under.

5. Name the Channel for proper identification.

6. Press Save to complete the process.

III. CONFIGURE ADDITIONAL PARAMETERS 

1. Click Channels from the left menu under the Sales Channels section. 

2. Click on the created channel's name.

3. Configure its parameters in Sections A, B, and C as required.

SECTIONS

A) QUICK ACTIONS lets you perform additional actions:

• Sync: Enables manual synchronization as detailed in How to Synchronize data through a Sales Channel [Step-by-step guide].
  
  

  WARNING: There are two scenarios to consider when exporting products to a Wix Store.
  
  Wix automatically creates all possible combinations with the product options provided. For example, if only White-Small and Black-Medium variants are defined, Wix will still generate White-Medium and Black-Small. Unused variants should be hidden from the Wix Store.
  
  New variants for products that already exist must be added manually.

  
  

• Save: Saves and commits changes.
  
• Delete: Deletes the channel connection.

B) VIEW SELECTION allows you to navigate the different tabs:

• Main settings (default): Configures general and automation behavior using the options outlined in Main Settings of a Beta Sales Channel [Information].
   
• Advanced settings: Sets privacy and system settings.
   
• Channel settings: Sets the following channel integration parameters.
  • Api URL: The base URL for the Wix REST APIs requests. 
  • Instance Id: Unique identifier automatically generated by Wix to identify techOMS installation on your Wix site.
  • App Id: The public identifier for techOMS in Wix, used to recognize which app is connecting to your Wix site.
  • App Secret: A private security key used to authenticate our app and keep the connection with your site secure.
  • Site ID: Unique identifier of your app within the Wix site. Alphanumeric, dashed ID contained in your Wix web browser session, in the address bar. 
    
    
    WARNING: Site ID is required for Webhooks to properly work.

    
    
    
    

  • Download Orders with the following Order Status: Initialized, Approved, Pending, Canceled, Rejected.
  • Throughput: Select your subscription plan. This will adjust techOMS order synchronization and operation speed accordingly. 
    
    
• Carrier Mappings: Sets Carrier name mappings as detailed in How to map Carriers in a Sales Channel [Step-by-step guide].
  
  

  WARNING: The Carrier Mapping for this channel is only used for receiving orders into techOMS. 

   
• SKU Mappings: Reviews and sets SKU mappings as detailed in How to map SKUs in a Sales Channel [Step-by-step guide].
   
• Warehouse Mappings: Binds or modifies the connection to a specific warehouse by assigning or modifying the Warehouse IDs. This links the techOMS warehouse with the corresponding identifier in the Sales Channel.
  
  

  WARNING: Warehouse mapping is only supported for inventory updates. Still, there must be at least one mapping created for inventory levels to work properly. Add a random value for this purpose.
  
  It is not recommended to push inventory levels of the same product from multiple warehouses.

  
  
• Webhooks: Steps to set up Webhook connections for Wix Stores Catalog API
  
  
  WARNING: This procedure requires Channel Mode to be set to Webhooks in the Main Settings tab. For more information, see: How to configure Automations for Sales/Fulfillment channels [Step-by-step guide] 

  
  

  i. Pre setup Steps in techOMS
  
  1. Open the Sales Channel, select the Webhooks tab and press Create.

  
  

  

  
  

  2. Select the connection type from the Type dropdown menu. System will automatically generate a URL.
  
  

  
  3. Copy the newly generated URL, DO NOT Save it and press Cancel. 
  
  

  NOTE: You need this URL to complete your Webhook configuration in Wix

  
  
  

  ii. Wix Setup Steps
   

  Login to your Wix site: https://manage.wix.com/

  
  

  1. Select Automation from the left menu

  
  

  
  2. Select Create Automation

  
  

  3. In the pop-up screen, select Start from Scratch

  
  

  

  
  4. On the left menu, select trigger: Order placed.
  
  
  5. Hit the "+" icon under Order placed to add an action.
  
  
  6. Select Send HTTP Request. 
  
  
  7. Paste the Webhook URL obtained from the Pre Setup step 3. 
  
  

  
  8. Hit Activate on the top right corner.

  
  

  WARNING: Once an order is activated, it gets pushed automatically no need for approval.
  
  

 C) CONTENT VIEW displays and/or allows editing of the settings in the "View Selection" section.

WARNING: Remember to press Save to commit the changes made in this section.