How to set up a Wix (API v3) Sales Channel [Step-by-step guide]

 NOTE: This guide covers Wix (API v3) Sales Channel setup. For instructions on the Wix (API v1) Sales Channel, see How to set up a Wix (API v1) Sales Channel  [Step-by-step guide].

To connect Wix, first create the 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
4. Wix Export Behavior

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

I. ONBOARDING REQUIREMENTS

• This plugin is developed for the Wix Stores Catalog v3 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 techOMS 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: When sending shipping updates, the tracking URL is sent together with the carrier name. The carrier is not displayed in the Wix UI, though it is correctly stored in the backend. Multiple shipments per order are supported.

  
  

• 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.
  • Throughput: Select your subscription plan. This will adjust techOMS order synchronization and operation speed accordingly. 
  • Instance Id: Unique identifier automatically generated by Wix to identify techOMS installation on your Wix site.
    
  • Api URL: The base URL for the Wix REST APIs requests. 
  • 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.
    
    
• Carrier Mappings: Sets Carrier name mappings as detailed in How to map Carriers in a Sales Channel [Step-by-step guide].
  
  
• 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. At least one mapping must be created for inventory levels to work properly.

  
  
• 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 the automation is activated, orders are pushed automatically. No manual approval is required.
  
  

 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.

NOTE: Inventory can be viewed and filtered by location, using the available option in the Wix v3 UI Inventory, see reference screenshot:
 

IV. WIX PRODUCT EXPORT BEHAVIOR

Wix handles product data differently from techOMS. The following behaviors must be considered when exporting or updating products.

WARNING: Wix automatically generates all possible product variant combinations based on the options provided. Variants not defined in techOMS are created in Wix with zero cost and disabled visibility. Only variants explicitly created in techOMS are visible. 

WARNING: When creating or updating products with variants, at least one option (such as color or size) is required. Products without variant options cannot be processed correctly by Wix.

• Product combination behavior: If only specific variant combinations exist in techOMS (for example, White–Small and Black–Medium), Wix will still generate the remaining combinations (White–Medium and Black–Small). 
  
  Unused variants should be hidden in the Wix Store.
  
  
• Product description formatting: Wix product descriptions are format-based. Updating descriptions for existing products may break the original UI formatting. For new products, descriptions are added as a simple paragraph.