ZenCart Channel Integration for Linnworks

Integrate the Channel into Linnworks.net

To use ZenCart channel, you must first install it from within Linnworks.net.

    Login to Linnworks.net

    Select Settings in the left-hand menu bar

ZenCart1

    Select the Channel Integration option.

    Select Add New to return a list of available Channel Integrations.

ZenCart2

    Locate ZenCart on the list, and click on Integrate.

ZenCart3

    After reading the warning, please click on Accept to move onto the next step of the integration. You can click on the link at the bottom to review the ZenCart Channel Terms and Conditions first, if you ZenCart to.

ZenCart4

    Enter your ZenCart account name to start the actual integration. And then click on next button for the next step.

ZenCart5

    After reading the Disclaimer, please tick ‘I agree to the terms and conditions’ and Next to continue integrating ZenCart.

ZenCart6

    • ZenCart Integration Guide:

    To integrate your ZenCart account, you will need the following information:

    9.1) API Settings:- There are following fields have to setup on installation.

      I. Username and Token:- Username and Token will be provided by E-Business Guru at the time of installation.

      II. Order Status:- You have to select order status defaultly as Pending.

      III. Base URL:- You have to enter your website url.

      IV. Order Processed Status:- You have to select order processed status defaultly as Delivered.

ZenCart7

    10. To complete the integration, please click on Finish. Your ZenCart integration should now show in Linnworks.Net -> Channel Integrations.

ZenCart8

Edit Channel Details

ZenCart13

Account Status


    1) In Linnworks.Net, select Settings.

    2) Select Channel Integration.

    3) Locate the ZenCart entry, and look to the right. Click on the Configuration button.

    4) To Enable or Disable the Account, locate the Account section.

    5) If the Enabled option is not ticked, the channel will not download or update orders, or provide inventory level updates.

    6) The Test button allows you to confirm there are no errors preventing Linnworks and ZenCart communicating. Contact EBG Support if Test Reports any errors.

    7) Click Save at the bottom of this window to apply any changes.

ZenCart16

Channel Inventory Settings

    1) In Linnworks .Net, select Settings.

    2) Select Channel Integration.

    3) Locate the ZenCart entry, and look to the right. Click on the Configuration button.

    4) In the Inventory section, the first entry is Update Inventory. If this is disabled, then Linnworks will not tell the listings on the opencart marketplace when Available Stock Levels change in Linnworks. If enabled, then Linnworks will provide these updates.

    5) Update Inventory only works where a listing has been mapped to a Linnworks Inventory item. See the end of this document for more information on Mapping.

    6) The Price Change feature allows Linnworks to send new prices directly to the listing when they are correctly imported or updated.

      a. Price Change only works where a listing has been mapped to a Linnworks Inventory item. See the end of this document for more information on Price Change and Mapping.

    7) Max Listed allows you to filter the highest quantity that Linnworks can/will send to the listings on this ZenCart channel. If Max Listed is set to 50 and your Available Stock moves from 30 to 60, Linnworks can only send 50, and this will not change until the Available Stock level drops below 50.

    8) Stock Percentage acts in a similar fashion, but only updates the listings with the specified percentage of your actual Available Stock level.

    9) End when allows you to set a ‘false zero’ for the channel. This means it will send Out of Stock when the available stock reaches the value set in this value.

    10) Click Save at the bottom of this window to apply any changes.

ZenCart17

Channel Listing Settings

Linnworks.net periodically checks the channel for the current listings you have on the channel, their titles and SKUs, so that the Mapping Tool can be used correctly. It can be triggered manually, should you have made changes directly on the channel and outside of Linnworks.

    1) In Linnworks .Net, select Settings.

    2) Select Channel Integration.

    3) Locate the ZenCart entry, and look to the right. Click on the Configuration button.

    4) In the Listings section, the information reflects the information Linnworks currently has about your listed items on the ZenCart marketplace.

    5) If there is a tick by listing download in progress, Linnworks is downloading the current listings, and cannot be interrupted.

    6) The Listing download start time value is the time the last download/update was started.

    7) The Last listing download completion time value tells you the last successful download completed and was imported into Linnworks.

    8) The Listing download estimated completion reflects Linnworks’ best estimate of when the most recent or current download should complete. The Download Listings button instructs Linnworks to retrieve the latest listing information, and ticks the Listing Download in Progress box. This can only be used once every 4 hours maximum, and will warn you if you try to use it more frequently.

    9) Click Save at the bottom of this window to apply any changes.

OSCommerce18

Order settings

This section reflects activities affecting the Linnworks Order Sync on your ZenCart channel integration. Linnworks downloads orders from ZenCart with the status shipping in Progress.

    1. In Linnworks .Net, select Settings.

    2. Select Channel Integration.

    3. Locate the ZenCart entry, and look to the right. Click on the Configuration button.

    4. In the Order section, there are 2 options.

    5. Despatch Notes, when enabled, allows Linnworks to send information about orders that have been processed in Linnworks. Orders that are processed in Linnworks are updated to the status Shipped on ZenCart.

    6. The Order Sync Date reflects the date and time of the last successful order download and update for the current ZenCart channel integration.

    7. Click Save at the bottom of this window to apply any changes.

    ZenCart19

API Settings

These settings are used to enable Linnworks and your ZenCart account to connect, and are covered in Step 1.

Click Save at the bottom of this window to apply any changes.

    ZenCart20

Mapping ZenCart21

Linnworks.net uses the Mapping Tool to ensure that it knows which SKUs in its inventory are connected to which listings on ZenCart. As such, you should ensure that all of your listings are mapped correctly, or stock levels and prices will not update correctly, and orders may not be picked accurately.

    1) In Linnworks .Net, select Settings.

    2) Select Channel Integration.

    3) Locate the ZenCart entry, and look to the right. Click on the Mapping button (see above).

This screen is divided into 2 sections.

On the left is the listing Linnworks is aware of on your ZenCart Channel. If this is not correct, or a change is missing, you should see the Download Listings button in the Listings section of the Channel Configuration.

On the right is a Linnworks Inventory Search Tool.

Each has its own Search box.


In the bottom left hand corner of the window is a status section. It shows the Total number of listings on the channel, and then beside it the Unlinked and Linked numbers – Linked listings are connected to a Linnworks Inventory item to allow updates and recognition, Unlinked are not. Ideally there should be no unlinked listings.

Linking items Automatically

If the SKUs in your inventory match the SKUs used on the listings, you can ask Linnworks to link them all for you.

    1) Click the button in the top left hand corner with a gear on it.

    2) Select Link all by.

    3) Select SKU.

    4) Linnworks will map all those listings that have a SKU which matches a SKU in the Linnworks Inventory.

    5) Check the Linked and Unlinked values once this is complete.

Linking Items Manually

If the SKUs in your inventory do not match the SKUs used on the listings, you can make the link manually.

    1) Use the left hand list and Search to find the listing to be linked.

    2) Click on it to highlight and select it.

    3) In the right hand list, use the Search box to find the correct Linnworks Inventory item to link it to.

    4) Click on the Link button beside it with the listing highlighted.

    5) Repeat for other listings to be linked manually.

Creating Linnworks Inventory items and mapping them

If there are no SKUs in your inventory match to the SKUs on the listings, you can ask Linnworks to create basic Inventory items for you, and link them.

    1) Use the left hand list and Search to find the listing to be linked.

    2) Click on the Create button.

    3) A new item will be created in the Linnworks inventory using the Name, Price and stock level, as well as the SKU from the listing. This will be linked to the SKU.

    4) This can be updated with other information later in the Inventory.

    5) Repeat this for other Listings that have no Linnworks inventory equivalent.

Price Change Functionality

Price Change only works for listings that are correctly linked to a Linnworks Inventory item in the Mapping Tool.

    1) Open Linnworks.Net.

    2) Select Inventory.

    3) Select My Inventory.

    4) Use Search to locate the Inventory item that requires a Price Change on ZenCart.

    5) Click on the SKU to edit the item.

    6) Click on the Listing descriptions tab.

    7) Under the Product pricing by channel section, click on Add New.

    8) Enter the Source as ZenCart.

    9) Enter the Sub Source as the account name of the ZenCart channel.

    10) Enter the Price.

    11) Click on + add to complete.

    12) If there is already an entry present for the correct Source and Sub Source, double click the Price to edit it, and then hit Enter.

    13) Close the SKU window when you have finished.

Location Mapping

ZenCart13

    1) In Linnworks .Net, select Settings.

    2) Select Channel Integration.

    3) Locate the opencart entry, and look to the right. Click on the Configuration button.

    4) Locate the Location Mapping button, and click on it.

    5) This opens the Location Mapping window.

    6) The first option is the Order Download location. This is initially Default, but can be changed. Click on the dropdown list and select which inventory/fulfillment location will initially receive the orders from this ZenCart integration.

    7) Under Inventory Sync Locations, you control which Linnworks Inventory locations are used to calculate the Available Stock values for your ZenCart listings.

    8) If you have only the Default location, this can be ignored, with Default left enabled.

    9) If you have multiple Inventory Locations, you can switch off locations (Slide switch to the left) that you don’t want to be included in the stock numbers on the listings.

OSCommerce14

Click Save when you have finished updating Linnworks. You should also click Save at the bottom of the configuration window to apply any changes.

Shipping Mapping

ZenCart9

The next step is to map your ZenCart Shipping services to Postal Services in Linnworks, so orders don’t need to have their Postal Service set manually. Initially, all are mapped to Default.

    1) In Linnworks .Net, select Settings.

    2) Select Channel Integration.

    3) Locate the ZenCart entry, and look to the right. Locate the Shipping Mapping button (see above), and click on it.

    4) In the Edit Shipping Allocation window, you should have an empty list.

    5) To add a new entry for one of ZenCart shipping services, click on Create New.

ZenCart10

    1. Create New Shipping Service Mapping

ZenCart11

ZenCart12

    1. For Channel Service Name, Enter the name of the Shipping Service in ZenCart.

    2. In Channel Service Tag, enter the Tag value used for the service in ZenCart.

    3. In the Linnworks Postal Service dropdown, select the name of the Linnworks Postal Service that should be used for orders imported from ZenCart with the Shipping Service to dispatch them correctly.

    4. The Add button will save the mapping, and display it in the Edit Shipping Allocation screen.

    5. Repeat this for all the other ZenCart Shipping methods you are using. This ensures your Linnworks order processing will run smoothly, and with minimal distractions.

    6. Click Save at the bottom of the channel integration window to apply any changes.

Payment Mapping

    For edit payment mapping click on payment mapping icon “Payment-mapping-1” and then it will open the payment mapping screen.

    • Edit payment Methods screen will be display below:

Payment-mapping-2

    • Create new payment screen will be display below:

Payment-mapping-3

    • Add new payment screen will be display below:

Payment-mapping-4

    Shipping Mapping:

    Open Channel integration screen in that go to Zencart integrated channel and then click on last icon for shipping mapping.

Payment-mapping-5

    It will open the popup for Add/Edit/Delete shipping mapping.

Payment-mapping-6

    Add new shipping mapping:

    Click on button “Add New ” to add new shipping mapping

Payment-mapping-7

    It will ask for the select channel postal service and Linnworks postal service.

    After selection of channel postal service and linnworks postal service click on “Add” button to add new shipping service mapping.

Payment-mapping-8

    Delete Shipping Mapping:

Payment-mapping-9

    First shipping service do you wish to delete and then click on “Delete” button.

    Once shipping service mapping delete click on “Save” button to complete deletion of shipping mapping.

Get your free quote

Call 0208 090 4547

Hear From Our Clients

Best website/e-commerce vendor I've worked with in my 10 years of being an IT PM! We hired eBusiness Guru to create our e-commerce website for our premium brand. This was no easy task as it was not your traditional e-commerce site. They delivered on-time, on-budget, and all with a successful release to the public and established partnership with us. We enjoyed working with the whole team. I would highly recommend them for any website need.
Bastien Peyronnel

Certifications