Back to top

Your guide to Zenda Ship

Zenda Ship is a shipping dashboard that connects to your store, so you can ship your orders with Zenda and get automatic status updates and tracking numbers.

Below is a guide for how to use Zenda Ship. If you need any more help, or you'd like a live demo, just contact us or talk to your account manager.


How do I connect my store to Zenda Ship?

You can connect your store to Zenda Ship to retrieve the orders that are ready to ship, get status updates when you pack and ship an order, and attach tracking numbers for each parcel.

Select your ecommerce platform to learn how to connect your store.

  • Log into your BigCommerce account, click Advanced Settings on the left menu, and then API Accounts
  • On the Store API Accounts screen, click Create API Account
  • Name the account 'Zenda'
  • Switch all permissions to 'Read-only'
  • Switch Orders and Order Transactions to 'Modify'
  • Click Save
  • On the next screen, copy down the Client ID and Access Token
  • Click Done and then open the API credentials .txt file that should have downloaded
  • In the file, find and copy the text from 'stores' and before '/v3', or the text in blue in this example (make sure to avoid the first and last forward slash): 'Zenda API PATH: https://api.bigcommerce.com/ stores/3wzptyx5t0 /v3/'. This is your Context.

2. Add BigCommerce to Zenda

  • Go to your Zenda Ship dashboard and log in with your Ship account
  • Click on the header dropdown and select Integrations
  • Click Connect to BigCommerce and enter your Account Name (as you've named it in the BigCommerce app), your BigCommerce Store URL, Access Token (as copied above), Client ID (as copied above) and the Context (as copied from the API credentials txt file)
  • Click on Connect
  • You will then be taken to the status configuration page

3. Map your statuses

  • Set the Ready to Pack status to Awaiting Fulfilment: Only those orders in your store with this status will show up in Zenda’s Your Orders page, so you can pack them with Zenda.
  • Set the In Progress status to Partially Shipped: When you pack an order into parcels, and before you Close Out a shipment, that order will update to this status in your store. That order will also no longer appear in Zenda's Your Orders page.
  • Set the Shipped status to Completed: Once you Close Out a shipment with Zenda, the relevant orders in your store will update to this status.

1. Go to the Integrations page

  • Go to your Zenda Ship dashboard and log in with your Ship account
  • Click on the header dropdown and select Integrations
  • Click on Connect your Magento or Magento 2 store
  • Add an account name and your store url
  • Click on Download Connection Bridge. This will download a zip file named “bridge.zip” to your computer.
  • Open the zip file and open the config.php file in a text editor. Scroll to the bottom and copy the numeric code, which is in bold in this example: define("M1_TOKEN", "96f4e883abe6ca4d151540ac6fe2acd2"). This is your Store Key.

2. Upload the bridge to your store's root folder

  • Extract the file. It will contain a “bridge2cart” folder.
  • Upload the "bridge2cart" folder to your store’s root folder by using your preferred FTP client (like WinSCP, FileFTP, FileZilla, CuteFTP or Cyberduck)

3. Go back to the Integrations page

  • Paste the Store Key value
  • Click on "Connect"
  • Click on Connect
  • You will then be taken to the status configuration page

4. Map your statuses

  • Set the Ready to Pack status to Pending: Only those orders in your store with this status will show up in Zenda’s Your Orders page, so you can pack them with Zenda.
  • Set the In Progress status to Processing: When you pack an order into parcels, and before you Close Out a shipment, that order will update to this status in your store. That order will also no longer appear in Zenda's Your Orders page.
  • Set Shipped status to Complete: Once you Close Out a shipment with Zenda, the relevant orders in your store will update to this status.

1. Go to the Integrations page

  • Go to your Zenda Ship dashboard and log in with your Ship account
  • Click on the header dropdown and select "Integrations"
  • Click on "connect" your Shopify store
  • Add an account name and your store URL

2. Go to your Shopify admin portal

  • In your Shopify dashboard, on the left hand menu, click on Apps
  • Click on "Working with a developer on your shop? Manage private apps" and then on "Create a new private app"
  • Name your Private app "Zenda" and give "Read and Write" access to orders, transactions and fulfillments. Keep the rest of the permissions to "Read".
  • To ensure you get tracking numbers back from Zenda, click on "▼ Review disabled Admin API permissions" and give Read and Write access to "Inventory". You can also do this later by going to your new private app settings. Under "Admin API Permissions", make sure that the "Inventory" is set to Read and Write access.

3. Go back to the Zenda Integrations page

  • Copy across your API Key, API Password and Shared Secret values
  • Click on "Connect"
  • You will then be taken to the status configuration page

4. Map your statuses

  • Set the Ready to Pack status to Open: Orders in your store with this status will show up in Zenda’s Your Orders page, so you can pack them with Zenda
  • Set the In Progress status to Closed: When you pack an order into parcels, and before you Close Out a shipment, that order will update to this status in your store. Your order will look archived in Shopify, so you know you have to update it. Update this order to Partially Fulfilled manually. That order will no longer show in Zenda Your Orders page, even if you unarchive it.
  • Set the Shipped status to Closed: Once you Close Out a shipment with Zenda, the relevant orders in your store will update to this status. Your order will look archived in Shopify, so you know you have to update it to "Fulfilled".

1. Go to the Integrations page

  • Go to your Zenda Ship dashboard and log in with your Ship account
  • Click on the header dropdown and select "Integrations"
  • Click on "connect" your Woocommerce store
  • Add an account name and your store url
  • Click on "Download connection bridge". This will download a zip file named “bridge.zip” to your computer.
  • Open the zip file and open the config.php file in a text editor. Scroll to the bottom and copy the numeric code, which is in bold in this example: define("M1_TOKEN", "96f4e883abe6ca4d151540ac6fe2acd2"). This is your Store Key.

2. Upload the bridge to your store's root folder

  • Extract the file. It will contain a “bridge2cart” folder.
  • Upload it to your store’s root folder using your preferred FTP client (WinSCP, FileFTP, FileZilla, CuteFTP, Cyberduck...)

Alternative: upload a Bridge Connector plugin

3. Go back to the Integrations page

  • If you had closed the window, paste the Store Key value
  • Click on "Connect"
  • You will then be taken to the status configuration page

4. Map your statuses

  • Set the Ready to Pack status to On Hold: Only those orders in your store with this status will show up in Zenda’s Your Orders page, so you can pack them with Zenda.
  • Set the In Progress status to Processing: When you pack an order into parcels, and before you Close Out a shipment, that order will update to this status in your store. That order will also no longer appear in Zenda's Your Orders page.
  • Set the Shipped status to Completed: Once you Close Out a shipment with Zenda, the relevant orders in your store will update to this status.

How can I see my orders in Zenda Ship?

  • Log in to your Zenda Ship dashboard with your Ship account
  • Click on Your Orders
  • You'll see a table with all the orders that can be shipped with Zenda. The orders need to meet two criteria to be shown in Your Orders page:
    1. The order is in a Ready to Ship status, as configured in the Integrations page. To edit which status in your ecommerce store is mapped to the Ready to Ship status, go to Integrations on the top right dropdown, or take a look at the answer for this question.
    2. The order is going to one of the 25 European destinations serviced by Zenda. You can find the full list of countries in the Zenda website homepage.
Screenshot of Zenda Your Orders page
By clicking on Download order list button, you can also download a spreadsheet of the order information, which you can print to make it easier for you to go around the warehouse and find the items that are ready to pack. The spreadsheet will contain whatever information is on the screen, which means you can use the filters at the top to only print the information that is useful to you.

How can I create and edit my packaging types?

Make sure you add your packaging types before your first shipment.

On the top right of the header, click on the dropdown, and then on Packaging.

Screenshot of Packaging page

To enter a new packaging type, add a name, dimensions and weight and click Add button to save it. Note that the weight refers to the weight of the packaging when it's empty.

You can also edit (Edit button) or delete (Delete button) your existing packaging types.

At the top of the screen, you can select your default parcel and piece. Your Default Parcel will appear in the Parcel Packing screen by default. The Default Piece will appear in the Piece Selection screen (during Close Out) by default.


How do I ship an order?

Read on, or watch this video demo to go through shipping an order with Zenda Ship.

To pack an order, go to My Orders and click on the icon Ship Action Icon under Actions for the order you want to ship.

The next page is the Parcel Packing page.

Screenshot of parcel packing screen

1. Screen breakdown

On the left side of this screen, you'll see:

  1. The Order Number, as it appears on your ecommerce store.
  2. The Consignee Address, or your customer's shipping address.
  3. The Service Level – currently Zenda only offers an Express service level, so you'll only see this one option.
  4. Unpacked Items – here is the list of items included in the order that are ready to be packed.

On the right side of this screen, you'll see:

  1. Your active parcels. Parcel 1 will be automatically opened and ready for you to put items inside.

2. Pack the items into parcels

Click Pack button to add the full quantity of that item into the active parcel on the right side of the screen. You can also modify the quantity of the items by clicking on the text field under "How many?".

To pack all the Unpacked Items at the same time, just click Pack All button.

If you run out of space on your first parcel, click on the New + tab.

The weight of the parcel will update automatically to include the weight of the item you've just added to it.

The Finish Packing Order button will turn active once all the items are packed, and so there are no remaining items under Unpacked Items.

Once you're done packing, make sure the dimensions and the weight of the parcels are all correct. These are the dimensions of the parcel after you've placed the items inside.

When you're ready, click on Finish Packing Order button.

This will display an overlay with all your parcel shipping labels. Screenshot of parcel label overlayYou can download or print each parcel label and the commercial invoice, or you can click on Download All button to download a zip file with all the documents.

Make sure you:

  1. Attach one parcel label to the outside of each parcel.
  2. Place a commercial invoice inside of each parcel.

Once you're all set, you can either click on Pack Another Order button to go back to Your Orders page and pack another order, or Your Dashboard button to go back to the Homepage.

3. Close Out a shipment

When you've packed all your orders and you want to book a shipment, then you are ready to Close Out.

The Close Out process is a standard practice in air cargo. It consists of placing your packed parcels into a larger container, called a piece. You then have to print and attach a First Mile label, Consolidation Manifest and Air Waybill label. (Check out our glossary for a description of all these documents!).

To Close Out, click on Close Out a Shipment from the dashboard homepage.

This will open your Active Shipments page. Click on the Plus Icon icon to expand the details on that active shipment. Here you'll see the list of parcels with their ZEN tracking numbers that are ready to be Closed Out.

Screenshot of active shipments

You can re-print your parcel labels if you need to, just click on the Print Icon for the relevant parcel.

If you're all set, click on Close Out buttonto get started.

The next screen is the Piece Selection screen. As a refresher, a piece is an outer container where you insert one or more parcels.

Screenshot of piece selection screen

In this screen, you need to:

  1. Place the parcels you're ready to ship inside one or more pieces – as many as you need.
  2. Type the number of pieces you are shipping in the 'Total piece count' text box.
  3. Check the dimensions and enter the weight for each piece. Remember these are dimensions of the piece once you've placed your parcels inside.
  4. It is very important that you enter the correct number of pieces.
  5. Read and check the disclosure statements. You can click on the information icon if you need more information.
  6. Once you've checked the first two mandatory statements, you can click on Book and get labels button to retrieve your piece labels.

This will open the last label overlay.

Screenshot of piece label overlay

Print or download each label, or click on Download All button to download a zip file with all the documents.

  1. Attach one Piece Label, also known as First Mile Label, on each piece.
  2. Attach one Air Waybill Label on each piece.
  3. Place the Consolidation Manifest inside a clear document pouch of one of the pieces.

And you're done!

Zenda has automatically scheduled a pick-up to your warehouse by your First Mile Carrier. Your shipment will then be taken to the nearest airport, flown overnight, customs cleared automatically, and delivered by a Last Mile Carrier to your customer's door.

Click here to download printable instructions for your warehouse explaining where to place each shipping label.


How can I track my Zenda parcels?

When you ship an order with Zenda Ship, the order in your store will automatically update as below:

  1. When you pack an order into parcels, the status of the order will update to the In Progress status
  2. A ZEN tracking number for each parcel will attach to that order
  3. When you Close Out a shipment, the status of the order will update to the Shipped status

Select your ecommerce platform below to see where to find the ZEN tracking numbers in your store.

Once you have your ZEN tracking number at hand, you can check the status of that parcel by either:

  • Going to the Zenda website and clicking Track Your Parcel on the header
  • Going straight to the following URL: https://live.zenda.global/track-your-parcel?trackingNumber=ZEN99999A1005X0751230

If you access the Track Your Parcel page as an anonymous user (i.e. you are not logged in), you will see the anonymous view, which contains less tracking information. Log in with your Ship or Admin account to see the full details of the parcel.

In your admin panel, go to Orders.

Look for the order that you want to see the tracking numbers for, and click on the plus icon icon to expand it.

On the right hand side, you'll see a ZEN tracking number for each parcel in that order.

Screenshot of Zenda tracking numbers in Bigcommerce

You can also see the ZEN tracking numbers in the Shipments screen, on the side menu.

  • In your admin panel, go to Sales, then Orders.
  • Click on the order that you want to see the tracking numbers for.
  • On the order details page, scroll down to the Shipping & Handling Information section.
  • Click on Track Order.
  • A pop up with your ZEN tracking number(s) will appear.
Screenshot of Zenda tracking numbers in Magento

You can get to that same page by going to Sales > Shipments and clicking on View for the shipment you want the tracking number for.

In your admin panel, go to Orders.

Look for the order that you want to see the tracking numbers for, and click on the order you want to see the ZEN tracking number(s) for.

At the top of the order, you'll see a ZEN tracking number for each parcel in the order.

Screenshot of Zenda tracking numbers in Shopify

Click on the ZEN tracking number to be taken to Zenda's Track Your Parcel page.

  • To see ZEN tracking numbers in your Woocommerce store, you have to install the following Woocommerce plugin. You can find a guide on how to install the plugin here.
  • Once this is installed, go to Woocommerce > Orders. Each order's ZEN tracking number(s) will appear under the column Shipment Tracking.
Screenshot of Zenda tracking numbers in Woocommerce

How do I edit my store configuration?

Click on the dropdown on the top right, and click on Integrations.

Click on Configure button your store. This will open an overlay where you can edit your account name and mapped statuses.

Screenshot of store configuration overlay

To change what status you have mapped to your store, simply pick one from the dropdown. In this question, you'll see our recommended mapped statuses.


Where can I see and manage my shipments?

Log into your dashboard with either your Admin or Ship login.

Click on View Active Shipments.

Here you'll see a table of all the shipments (or manifests) you have booked with Zenda, with a status by shipment and by individual parcel.


Where can I see invoicing information?

To see your invoicing information, log in with your Merchant Admin account. Contact your account manager if you're not sure what your credentials are.

Once logged in, click on Your Activity.

Here you'll see a breakdown of the shipping cost, taxes and duties for each parcel you have shipped.

Screenshot of Your Activity page in Zenda

How can I unlink my store from Zenda Ship?

Click on the dropdown on the top right, then on Integrations.

Click on Configure button your store. This will open the configuration overlay.

Screenshot of store configuration overlay

Click on Unlink this account at the bottom left of the overlay. You'll be asked to confirm you want to unlink your store and no longer ship those store's orders with Zenda.


Can I connect multiple stores to Zenda Ship?

Absolutely! Just go the Integrations page from the top right dropdown, and click Connect  button under the relevant eCommerce platform to add a new store.


Your guide to Zenda Checkout

Zenda Checkout is an extension for your store that shows Zenda as a shipping method, including a breakdown of taxes and duties.

Below is a guide for Magento 1 and Magento 2. Extensions for Bigcommerce, Shopify and Woocommmerce are coming soon – contact us to check our release dates.

If you need any more help, or you'd like a live demo, you can contact us below or talk to your account manager.


How do I install the extension?

Download the extension from Magento Marketplace

Search for Zenda in the Magento Marketplace, or click here.

Install the extension using FTP/SSH

  • Turn off the Magento compiler by logging in to the Magento Admin Panel and going to System -> Tools -> Compilation and turn it off.
  • Open the extension zipped file you downloaded and extract it to a directory on your computer.
  • Upload the extracted folders and files into the root directory of your Magento 1.9 installation. The root directory of Magento is the folder that contains the directories like "app", "js", "skin", etc.
  • Go to System -> Cache Management and click both the 'Flush Magento Cache' and 'Flush Cache Storage' buttons.
  • Log out from the Magento Admin Panel and then log back in.
  • Go to System -> Configuration -> Sales -> Shipping Methods and check if Zenda is one of the shipping methods.

Download the extension from Magento Marketplace

Search for Zenda in the Magento Marketplace, or click here.

Install the extension using FTP/SSH

  • Unpack the extension ZIP file on your computer.
  • Connect to your website source folder with FTP/SFTP/SSH client
  • Upload all the files and folders from the extension package to the root folder of your Magento installation. The root folder is the folder that contains the directories like "app", "js", "skin", etc.
  • Please use the “Merge” upload mode. Do not replace the whole folders. Just merge them. This way your FTP/SFTP client will only add new files. This mode is used by default by most of FTP/SFTP clients’ software.
  • Go to System -> Cache Management and click both the 'Flush Magento Cache' and 'Flush Cache Storage' buttons.
  • Log out from the Magento Admin Panel and then log back in.
  • Go to System -> Configuration -> Sales -> Shipping Methods and check if Zenda is one of the shipping methods.

Install the extension using Composer

  • Run this command first:
  • composer require zenda/module-shipping

  • Then run the following commands:
  • pphp bin/magento setup:upgrade

    php bin/magento setup:di:compile

    php bin/magento setup:static-content:deploy

1. Download the app

Search for Zenda in the Shopify App Store, or click here.

2. Create a private app

  • Go to your admin dashboard, and click on 'Apps' on the left hand menu
  • At the bottom of the page, click on 'Manage private apps'
  • Click on the 'Create a new private app' button
  • Name the app Zenda and Save it
  • Make a note of the API key and the Password that gets generated

3. Add credentials to the Zenda app

  • Go back to Apps on the left-hand menu and click on the Zenda app you just created
  • You should now see the Zenda Checkout configuration page.
  • Screenshot of Zenda Checkout Shopify configuration page
  • Add the API key and Password from the private app you created in Step 2
  • Your Zenda Checkout app is now intalled in your Shopify store!

To see what each option means and how to configure your shipping, check out the next question.


How do I configure my extension?

After installing Zenda Checkout extension:

  • If you're in Magento 1, go to System -> Configuration -> Sales -> Shipping Methods -> Zenda
  • Screenshot of Magento 1 configuration page
  • If you're in Magento 2, go to Stores -> Settings -> Configuration -> Sales -> Shipping Methods -> Zenda
Screenshot of Magento 2 configuration page

Set up these mandatory fields:

  • Enabled (Yes/No): Set this to Yes to activate Zenda as a shipping method on your checkout
  • Username: Contact your Zenda account manager or email contact@zenda.global to get your API username and password
  • Password: Contact your account manager or email contact@zenda.global to get your API username and password
  • Live Account (Yes/No): Set this to Yes if the username and password you obtained is a production (live) account

To edit the optional fields, first deactivate the default value by unchecking "Use system value"

  • Method Name: This is what your customer will see on the checkout page. The default value is “Express 4 to 8 Days”
  • Enable Flat Rate (Yes/No): This is set to No by default. Set this to Yes if you want to display a flat rate instead. An additional field for entering the flat rate price will appear, where you can set the flat rate amount.
  • Tooltip Label: The default value is “Is tax and duty required?”
  • Tooltip Content: The default value is “Most goods imported from outside the EU are subject to customs duty and tax. With other carriers, you have to pay these extra fees when your order arrives. With Zenda, you can avoid delays and hassle by paying all fees in advance.”
  • Title: The default value is “Zenda, powered by British Airways”
  • Ship to Applicable Countries: Set this to "All Allowed Countries" to show Zenda as a shipping method for all 25 European countries that we service. Set it to "Specific Countries" to select which countries you want to enable Zenda for.

To find the Zenda Checkout configuration page after you installed the app, go to 'Apps' on the left-hand menu of your admin dashboard and click on Zenda.

Set up these mandatory fields:

  • Enabled (Yes/No): Set this to Yes to display Zenda as a shipping method on your checkout
  • Username: Contact your Zenda account manager or email contact@zenda.global to get your API username and password
  • Password: Contact your account manager or email contact@zenda.global to get your API username and password
  • Live Account (Yes/No): Set this to Yes if the username and password you obtained is a production (live) account

Set up these optional fields:

  • Method Name: This is what your customer will see on the checkout page. We suggest you set it to "Zenda, powered by British Airways (4 to 8 days) or "Zenda Express Shipping (4 to 8 days)
  • Enable Flat Rate (Yes/No): Set this to Yes if you want to display a flat rate instead of a real-time calculation of the Zenda shipping cost. An additional field for entering the flat rate price will appear, where you can set the flat rate amount.
  • Ship to Applicable Countries: Set this to "All Allowed Countries" to show Zenda as a shipping method for all 25 European countries that we service. Set it to "Specific Countries" to select which countries you want to enable Zenda for.

For items that are large relative to the weight, and so the dimensions will set the shipping cost rather than the weight, make sure you set the Zenda shipping dimensions so you display the correct shipping cost to your customer.

Talk to your Zenda account manager if you're not sure what items you should do this for.

  • Go to Products on the left-hand menu
  • Click on an item.
  • On the item page, click on the 'More actions' dropdown and then on 'Edit Zenda Shipping Dimensions'
  • Set the length, width and height of your item and click on Save

Your guide to Zenda in ShipperHQ


How do I set up Zenda in ShipperHQ?

To install Zenda as a carrier in ShipperHQ, read the instructions below or watch the video further down the page.

  • Log in to your ShipperHQ Dashboard, and go to the Marketplace page on the left sidebar
  • Select Zenda as a carrier and click on “Install and Validate”
  • Click on “Install” or anywhere else on the listing to view more information about Zenda as a carrier in ShipperHQ
  • Enter your Admin username and password provided to you by Zenda
  • If the connection is successful, you’ll see a green success message. Click “Configure This Carrier” to configure your Zenda settings

How do I configure Zenda in ShipperHQ?

For more on configuring the carrier rules around Zenda, you can read the ShipperHQ documentation here.

Contact us

Interested in learning more? Send us an email or fill in the contact form below. We'll be in touch!