X-Cart channel integration

X-Cart

 

Avasam can be integrated with one or more X-Cart websites to download orders, and update listings with stock levelstempsnip1

The list of sales channel integrations has 4 columns:

  • The logo representing the type of channel integration.
  • The type of channel integration.
  • The name of the specific channel integration.
  • The status of the integration - yes/blue is enabled, no/grey is disabled.

New sales channel integration

To create a new sales channel integration:

  1. Open ‘Settings’.
  2. Select ‘Sales channel integration’.
  3. Click the ‘Add sales channel’ button.
  4. Click on the ‘Add’ button next to ‘X-Cart’.
    Click on Add button for X-Cart
  5. Enter the name for this integration.Enter account name
  6. Click ‘Next’ to continue.
    Configuration screen
  7. You should enter your website address in the ‘Website end point’ field.
  8. The ‘API key’ field comes from your website.
    a. Login to the control panel at this link http://202.131.103.126/xcart/admin.php.Login
    b. Enter your registered email address and password, then click ‘Log in’.
    c. Click on ‘My addons’.
    d. Search for the words ‘Rest API’.
    Search Rest API
    e. Locate the ‘REST API’ entry.
    REST API
    f. Tick the ‘Install’ option.
    g. You will be moved to the ‘Installed Addons’ screen.
    h. Copy the value for ‘API key (read/write)’.
    i. This will provide you with an ‘API key’ value. Copy this value.REST API module setting
  9. Paste this value into the ‘API key’ field.API key field
  10. Select ‘Yes’ for ‘Use X-Cart tax settings’ if your site’s tax settings should be used for product prices.
  11. Select ‘Yes’ for ‘Use X-Cart tax settings for shipping’ if your site’s tax settings should be used for shipping costs.
  12. Enter the name that is used for the shipping surcharge in orders.
  13. Click ‘Next’ to continue.
  14. Select ‘Yes’ for fields where you are using that option in X-Cart.
    a. For ‘Processed order status’, specify what status Avasam should assign to orders when it has been shipped by the supplier.
  15. Click ‘Next’.
  16. You will be returned to the sales channel list in Avasam, with a new row added for your new integration.
    tempsnip1
  • Click ‘Cancel’ to return to the sales channel integration list without completing the integration.

    Disable channel integration

    When you create a new channel integration, it is automatically enabled and active.

    To disable the integration to stop it downloading orders and updating listings temporarily.

    1. Open ‘Settings’.
    2. Select ‘Sales channel integration’.
    3. Locate the integrated sales channel to disable.
    4. Click the status switch to toggle it from ‘Yes’/active to ‘No’/disabled.
    5. The channel will be disabled.

    Enable channel integration

    When you create a new channel integration, it is automatically enabled and active. You, or someone else, may temporarily disable it.

    To re-enable the integration to resume downloading orders and updating listings.

    1. Open ‘Settings’.
    2. Select ‘Sales channel integration’.
    3. Locate the integrated sales channel to enable.
    4. Click the status switch to toggle it from ‘No’/disabled to ‘Yes’/active.
    5. The channel will be re-enabled.

    Remove channel integration

    If you no longer wish to have Avasam connected to a sales channel, it can be easily removed. Once deleted, you will need to re-create the integration from scratch should you choose to re-use it.

    To remove a channel integration:

    1. Open ‘Settings’.
    2. Select ‘Sales channel integration’.
    3. Locate the channel integration to remove.
    4. To open the integration, click the name.Capture91
    5. Click the red ‘Remove account’ button.
    6. Click ‘OK’ to confirm.
    7. You will be returned to the list of channel integrations.
    • Click ‘Cancel’ if you decide to not delete the integration.
    • If you delete an integration and then reintegrate the same channel, the analytics and reports will not recognise orders from the two integrations as being from the same site.

      Update/verify channel integration

      If Avasam is having issues downloading from updating a sales channel, it can be easily checked. In ‘Settings’, select ‘Sales channel integration’ to ensure that you are connecting to the correct website end point.

      To update/verify a channel integration:

      1. Locate the channel integration.
      2. Click the name to open the integration.
        Capture91
      3. Click ‘Reauthorise’.
      4. A new window will open.
        Reauthorise
      5. Check the ‘Website end point’ value is correct.
      6. Confirm the ‘API key’ is correct.
      7. Click ‘Save’ to apply any updates/changes.
      8. You will be returned to the list of channel integrations.
      • Click ‘Cancel’ if you decide to not change/update the integration.