Frequently Asked Questions

You can find answers and solutions to the frequently asked questions here.

My Products Are Not Appearing on the Sales Channels

Check if the Channel is Active

  1. Go to your stores by clicking “Stores” on the side menu.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you'd like to activate.

    image.png

  4. Check if the “Is Active” option is checked.

    image.png

  5. If not, then please activate your channel by clicking on the option.

    image.png

Ensure That the Authentication for Your Channel is Done Correctly

You need to make sure your channel connection is done properly and successfully. To do so you need to check whether the “auth_connect” job was completed for your channel. 

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you'd like to check.

    image.png

  4. Click on the “Transaction Records” button. 

    image.png

  5. Filter the list by “Log Type”.

    image.png


  6. Select the “auth_connect” log type and press the ”Add” button. 

    image.png

  7. Check if the response was successful.

    image.png

     

  8. If it is unsuccessful, check the log details to see what the error was by clicking the pencil icon. 

    image.png

  9. If the response is something about wrong authentication credentials or it is about credentials (token) being expired then you need to either reconnect your channel or check if the entered authentication credentials are still valid.
  10. After you update your credentials or reconnect your channel, please check again if the “auth_connect” job is successful. If the problem persists, please contact our support team and provide details of the problem.

The Sales Channels API Might Not Be Responding to Our "Get Orders" Calls

In some cases, the sales channel’s API might not be answering our API calls properly due to problems on their side. To check if this is the case please check whether the “Get_orders” jobs for the channel are working properly or not.

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you'd like to check.

    image.png

  4. Click on the “Transaction Records” button. 

    image.png

  5. Filter the list by “Log Type”.

    image.png


  6. Select the “get_order” log type and press the ”Add” button.

    image.png

     


  7. Check if the response was successful.

    image.png

     

  8. If it is unsuccessful, click the pencil icon to check the log details and see what the error was. 

    image.png

  9. Scroll down to the response part and see the response message and the error message received.

  10. Try to take action based on the error message in the response or contact customer support directly.

Channel Set Up, but Orders Not Coming Through? What to Do

Check if the Channel is Active

  1. Go to your stores by clicking “Stores” on the side menu.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you want to activate.

    image.png

  4. Check if the “Is Active” option is checked.

    image.png

  5. If not, then please activate your channel by clicking on the option.

    image.png

Check if the Authentication is Properly Done for Your Channel

You need to make sure your channel connection is done properly and successfully. To do so, you need to check whether the “auth_connect” job was completed for your channel. 

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you want to check.

    image.png

  4. Click on the “Transaction Records” button. 

    image.png

  5. Filter the list by “Log Type”.

    image.png


  6. Select the “auth_connect” log type and press the ”Add” button. 

    image.png

  7. Check if the response was successful.

    image.png

     

  8. If it is unsuccessful, check the log details to see what the error was by clicking the pencil icon. 

    image.png

  9. If the response is something about wrong authentication credentials or it is about credentials (token) being expired then you need to either reconnect your channel or check if the entered authentication credentials are still valid.
  10. After you update your credentials or reconnect your channel, please check if the “auth_connect” job is successful. If the problem persists, please contact our support team and provide details of the problem.

The Order Creation Date Might Be Before the Date the Sales Channel Was Connected to Channels

By default, we only pull the orders created after the sales channel setup date. But if you want to receive orders created before you set up the sales channel, you need to perform an order polling action under the channel settings.

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you want to check.

    image.png


  4. Scroll down to the “Order Polling” section and switch it on

    image.png

  5. Select the date from which point on the orders will start being polled.

    image.png

  6. Click the Save button and wait around 3 to 10 minutes for orders to be imported into the system. If the orders you wanted are still not imported, move on to the next recommendation.

    image.png

Check Whether Your Orders Are Already Fulfilled or Whether They're Paid or Not

Please make sure the orders you are trying to import are unfulfilled and paid. By default, our system doesn't import fulfilled and unpaid orders unless you've configured your sales channel to import orders with different statuses. If you want to import your fulfilled, cancelled, or unpaid orders, you can switch on the necessary settings under “Order Management” and do an order polling. You can check our FAQ on order polling for more instructions.

The Sales Channels API Might Not Be Answering Our Get Orders Calls

In some cases, the sales channel’s API might not be answering our API calls properly due to problems on their side. To check if this is the case please check whether the “Get_orders” jobs for the channel are working properly or not.

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you want to check.

    image.png

  4. Click on the “Transaction Records” button. 

    image.png

  5. Filter the list by “Log Type”.

    image.png


  6. Select the “get_orders” log type and press the ”Add” button.

    image.png

     


  7. Check if the response was successful.

    image.png

     

  8. If it is "Failed," click the pencil icon to check the log details and see what the error was. 

    image.png


  9. Try to take action based on the error message, or contact customer support directly.

Orders on Hold After Sales Channel Setup: What Does It Mean?

About the "On Hold" Status

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you'd like to check.

    image.png

  4. Switch off the “Auto Hold Aged Orders” setting under Order Management.

    image.png

Fulfillment Not Sent to Sales Channel: What to Do?

Make Sure the Fulfillment is Created Successfully for the Order in Question

  1. Access your account and go to the left side of the screen. Click the "Orders" button.

    image.png

  2. Find the order you want to check and click the pencil icon to view it's details.

    image.png


  3. Scroll down to the “Fulfilment Info” part and ensure you correctly see the fulfilment information you created. If you do not see that, you didn’t create a fulfilment for that order. Please create one using Channel API.

    image.png

  4. If you see the fulfilment information correctly and see that the Fulfilment sync status is “Failed” please scroll down to order activities table at the bottom of the page and check “fulfillment_replied” activity detail by clicking the edit button to understand why the sync attempt is failed. 

    image.png

  5. You can check the fulfilment sync request sent to the sales channel and view the response received from the sales channel API.
  6. Try to take action based on the error message in the response or contact customer support directly.
  7. If the response error message is about the courier not being found in the system, please ensure you have the courier mappings done correctly.

Make Sure the Courier Mappings are Done Correctly

Most of the time, fulfillments fail because courier mapping is not done for sales channels. You need to make sure that you have the correct mappings for your sales channels. To do the courier mappings, please go to the channel settings courier mapping page.

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you want to check.

    image.png

  4. Click on the “Couriers” button. 

    image.png

  5. Select the courier name you sent in the fulfilment creation request.

    image.png

  6. Enter the custom name as the Channel accepts the selected courier. Please contact your sales channel account manager to get the courier codes and names list for the channel in question.

    image.png

  7. Click Save.

    image.png

  8. Go to the order detail that has the failed fulfillment sync.

  9. Click on the “Resend Fulfillments” button.

    image.png

  10. Please check if the fulfilment status has changed to “Synced” in 5 minutes. If not, follow this guide again or contact customer support.

Check the Channel Transaction Records for Fulfillment Errors

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you want to check.

    image.png

  4. Click on the “Transaction Records” button. 

    image.png

  5. Filter the list by “Log Type”.

    image.png


  6. Select the “submit_fulfillment” log type and press the ”Add” button.

    image.png

     
  7. Check if there are any recent failures.
  8. If there is, check the log details by clicking the pencil icon to see what the error was. 

    image.png

  9. Scroll down to the response part and see the response and error messages received.
  10. Try to take action based on the error message in the response or contact customer support directly.
  11. If the response error message is about the courier not being found in the system, please ensure you have the courier mappings done correctly.

Webhooks Set Up, But Not Working

Check If the Webhook Is Activated

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your webhook is in.

    image.png


  3. Go to the Webhooks tab.

    image.png

  4. See if the webhook you created has a checkmark under the “Is Active” column.

    image.png


  5. If it doesn’t have a checkmark, it means the webhook is not active. Please click on the checkbox to activate the webhook.

    image.png

Verify if the Webhook URL Is Entered Correctly

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your webhook is in.

    image.png


  3. Go to the Webhooks tab.

    image.png


  4. Go to the webhook’s settings by clicking on the edit button.

    image.png

  5. Check if the URL is entered correctly.

    image.png

Check Whether the Receiver URL Is Working Properly

  1. Go to the “Transaction Records” page.image.png
  2. Select your store.image.png
  3. Click on the “Webhook Transaction Records”.image.png
  4. Check if there have been failed transactions recently.

    image.png

  5. If there are failed transactions, click the edit button for the most recent failed one.
  6. Check the error message in the response part of the transaction.
  7. Try to take action based on the error message in the response or contact customer support directly.

Plugin Set Up, But Orders Not Sent: What to Do?

Check If the Plugin Is Active

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your webhook is in.

    image.png

  3. Go to the plugins tab.

    image.png

  4. Check if your plugin has a checkmark under the “Is Active” column.

    image.png

  5. If not, please click on the checkbox to activate your plugin.

    image.png

Check If the Authentication Information Is Correct

If you receive authentication errors under plugin transaction records, you must ensure the entered authentication information is correct under plugin settings. 

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your webhook is in.

    image.png

  3. Go to the plugins tab.

    image.png


  4. Click on the pencil icon for the plugin you'd like to check.

    image.png

  5. Click on the “Transaction Records” button.

    image.png

  6. Check if you've been receiving continued failed transactions recently.

    image.png

  7. If so, click on the edit button for the most recent failed transaction to view its details.

    image.png

  8. Scroll down to the response part and see the error message received in the response.
  9. If the message is about incorrect authentication information, please confirm the entered authentication information is correct.
  10. If not, try to take action based on the error message in the response or contact customer support directly.

Check If the Plugin's API Is Responding

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your webhook is in.

    image.png

  3. Go to the plugins tab.

    image.png


  4. Click on the pencil icon for the plugin you'd like to check.

    image.png

  5. Click on the “Transaction Records” button.

    image.png

  6. Check if you've been receiving continued failed transactions recently.

    image.png

  7. If so, click on the edit button for the most recent failed transaction to view its details.

    image.png

  8. Scroll down to the response part and see the error message received in the response.
  9. If the message is about incorrect authentication information, please confirm the entered authentication information is correct.
  10. If not, try to take action based on the error message in the response or contact customer support directly.

Product Quantities Not Synced to Sales Channels: What to Do?

Check If Auto-Sync Setting Is On

  1. Go to your stores by clicking “Stores” on the side menu.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you'd like to activate.

    image.png

  4. Check if the “Auto Sync Stock Levels” setting is on. If it's not, please turn it on.

    image.png

 

Check If the Products Are in the Main Products

  1. Go to your stores by clicking “Stores” on the side menu.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you'd like to activate.

    image.png

  4. Switch on Stock Management, Download Products and Add To Products.

    image.png

Initiate an Order Push to the Sales Channel

If the "Auto Sync" and the "Add To Products" settings are on, it is best to run a stock push job manually. To do that, follow these steps.

  1. Go to your stores by clicking “Stores” on the side menu.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you'd like to activate.

    image.png

  4. Turn on “Stock Management” and “Push Stock Levels”.

    image.png

  5. Click on the save button.

    image.png

  6. Wait a while for the system to finish stock syncing for all your products.

How to Refetch Product Updates from Sales Channel

Try Refetching Your Products

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you want to check.

    image.png

  4. Switch on "Stock Management" and “Refetch Products”.

    image.png

  5. Click the Save button and wait a while for the system to finish syncing your products.

    image.png

How to Refetch Orders and Order Updates

Try Using Order Polling

  1. Access your account and go to the left side of the screen. Click the "Stores" button.

    image.png

  2. Click on the pencil icon next to the store your channel is in.

    image.png

  3. Click on the pencil icon next to the channel you want to check.

    image.png


  4. Scroll down to the “Order Polling” section and switch it on.

    image.png

  5. Select the date from which point the orders will start being polled.

    image.png

  6. Click the Save button and wait around 3 to 10 minutes for orders to be imported into the system. If the orders you wanted are still not imported, move on to the next recommendation.

    image.png

How to Resend Orders via Webhook/Plugin

Try Bulk Updating Your Orders

  1. Access your account and go to the left side of the screen. Click the "Orders" button.

    image.png

  2. Pick a store and click “Actions”.

    image.png

  3. Click "Bulk Update Sync Status".

    image.png

  4. Select the action type you want to proceed with:

    1. Update Order Sync Status: select this option if you want to take action regarding the order sync status. For example, to resend orders via webhook

    2. Update Fulfilment Sync Status: Select this option to take action on the order fulfilment sync status. For example, resending the failed fulfilment to the sales channel

    3. Update Plugin Sync Status: Select this option if you want to take action on order sync status, such as resending already synced or failed orders to the plugin.

      image.png

  5. If you have the remote IDs of your orders in an Excel or a CSV file, switch on the “Use File Upload to Enter Remote IDs” option and upload your file by clicking the “Order Remote IDs File” button.

    image.png

  6. If you don’t have a file, you can copy and paste the remote IDs to the “Remote IDs” field by putting a comma between the IDs. You can only enter up to 500 remote IDs.

    image.png

  7. Make sure that the correct store is selected in the “Store” field.

    image.png

  8. Select which process type you'd like to update your orders to.

    image.png

  9. Next, click on Bulk Update to save your changes.

    image.png

  10. You will receive an email confirming the actions when the process is complete.

  11. Action configurations should be as follows:

    1. To mark the sync status of the orders as “Excluded”, select the action type as “Update order sync status” and select the process type “Mark as Excluded”.

    2. To mark plugins' sync status as "Excluded," select the action type “Update Plugin Sync Status” and the process type “Mark as Excluded.”

  12. If you want to resend orders via webhook, select the Action Type as “Update Order Sync Status” and select the Process Type as “Mark as Pending.” If you have a plugin set up in your store and don’t want your orders sent to it, you need to do another bulk action for the same orders and update their plugin sync status to “Excluded “ to prevent them from being fulfilled more than once.

    1. If you want to resend a fulfilment to the sales channel, select the action type “Update Plugin Sync Status” and select the process type “Mark As Awaiting Send”.

    2. If you want to resend an order to the plugin, you must do two bulk actions. First, you need to mark the order sync status as "Excluded". Then, you need to mark the plugin sync status as excluded for the orders you want to resend to the plugin.

How to Update Wix App Permissions and Reconnect Your Wix Sales Channel

1. Please go to this URL: https://manage.wix.com/studio/custom-apps

Then click on the 3 dots menu on your app and click on Go to app dashboard

screencapture-manage-wix-studio-custom-apps-2024-08-27-13_33_19.png

2. Click on Permissions on the side menu.

screencapture-dev-wix-apps-5aa3d4c9-61c5-4bbb-9a57-6bdf1577cbe6-dev-center-permissions-2024-08-27-13_35_54.png

3. Click on the Add Permissions button.

screencapture-dev-wix-apps-5aa3d4c9-61c5-4bbb-9a57-6bdf1577cbe6-dev-center-permissions-2024-08-27-13_35_54 (1).png

4. Please put a checkmark on each permission by searching them and clicking their checkboxes individually. 

screencapture-dev-wix-apps-5aa3d4c9-61c5-4bbb-9a57-6bdf1577cbe6-dev-center-permissions-add-2024-08-27-14_10_59.png

5. Make sure you put a checkmark on all necessary permissions as below and click Save.

screencapture-dev-wix-apps-5aa3d4c9-61c5-4bbb-9a57-6bdf1577cbe6-dev-center-permissions-add-2024-08-27-14_14_51 (1).png

6. After saving them, ensure you see the permissions under Permission Scopes. 

screencapture-dev-wix-apps-5aa3d4c9-61c5-4bbb-9a57-6bdf1577cbe6-dev-center-permissions-2024-08-27-14_24_19.png

7. Go to the OAuth tab on the side menu. Enter the below URL to the App URL and the Redirect URL inputs then click Save.

https://production.channelapi.co.uk/authorization/wix

screencapture-dev-wix-apps-5aa3d4c9-61c5-4bbb-9a57-6bdf1577cbe6-oauth-2024-08-27-14_28_04.png

8. Go to your Wix Channel settings page on Despatch Cloud or Channels.

9. Click on "Copy Connection Link" and open the link on a new tab on your browser. Screenshot 2024-08-27 at 16.03.52.png

10 Select the site you want to get your orders from if you have more than one site.

image 1.png

11. Check the "By Installing this third party app, I agree to all of the above" checkbox and click the Agree & Add button. 

image 2.png

12. Click on "Continue" 

screencapture-staging-channelapi-co-uk-authorization-wix-2024-08-27-14_42_46.png