Ninja Van Shopify App

We've updated our Shopify integration! You can see the guide to the previous integration here

Get Started! Find the new integration on the Shopify App Store here.


What you’ll need

Set Up

1. Installing the Ninja Van Shopify app

To connect your Ninja Van and Shopify accounts, start by taking these steps:


2. Connect your Ninja Dashboard account to your Shopify account

Select country

Select the country that your Ninja Van account is set up in

Log in

Login to your Ninja Van account

Review permissions

Review and allow permissions

Your Shopify account is now linked to your Ninja Van account and you're ready to start creating orders!

Optional Configuration

While we automatically apply some default settings, this section will show you some settings you can configure:


Delivery type presets

Delivery presets

In this section you will be able to match your existing Shopify delivery settings with one of Ninja Van’s service types (“Standard”, “Next-day”, “Same-day”, “Express”).


For each Shopify delivery method, simply select the Ninja Van service type that you want us to apply. Orders created with us after this will then be created with the corresponding service type!


Air waybill configuration

Air waybill settings

In this section you will be able to customise your air waybill size, include packing information and brand information.

1. Air waybill size

Configure your label size presets

Under the 'Settings' tab in the  Shopify app,  you will able to access the "Air Waybill Label Size" page.  

On this page you can select the paper/label size that you will print your Air Waybill on and select if you want to include the packing details.



2. Packing information

Packing Slip & Information

By toggling the "Include product details on air waybills" button, you will also be able to see what items are supposed to be packed into these parcels.


For paper sizes other than 50*70, you will also be able to generate  one of the following:

or 

1-paged air waybill

2-paged air waybill

3. Branding customizations

Get more out of your air waybills

Under the 'Air Waybill Content' tab under the 'Settings' tab on the Shopify app,  you'll be able to customize your air waybill to include your brand name and even include a custom brand message.

Order customizations and additional liability

Order presets

In this section you will be able to modify things like your tracking ID preferences, liability coverage and even enable international cash on delivery.

1. Tracking ID

Set your Shopify Order ID as your Ninja Van tracking ID

Under the 'Ninja Van Orders' tab within the 'Settings' on the Shopify app,  you will also be able to automatically toggle on this feature.

Simply toggle the "Set Order ID as Ninja Van Tracking ID" button and all orders after that will have their tracking IDs referencing their Shopify order ID.

Do note that the Shopify order ID referenced by the app to do so would be the plain numerical Shopify order ID and will not include any prefix or suffix.

2. Liability Coverage 

Cover your parcels with additional liability

If you want all orders to be covered with liability coverage at the order value (less of the delivery fee):


If you only want orders that are higher than a certain value to be covered at the order value (less of delivery fee):

*This added liability coverage will be chargeable as per your contract with Ninja Van.

Pickup Presets

Address configuration

In this section you will be able to let us know what your preset timeslots and instructions will be, so that you won't have to repeatdely type this in when you book a pick up through the plugin.

Set up pick up timeslots and instructions

Here you will be able to see your Shopify-set locations or add a custom location for us to pick up from. Once set up, simply choose this address during the order creation stage to let us know which orders are coming from the location.


Default locations can also be set to overwrite any Shopify location and have all Ninja Van orders come from or return to this address.

Using The App

1. Create Ninja Van orders from Shopify

i. Order Creation

To create orders on Ninja Van from Shopify, take these steps:


ii. Booking Pick Ups


iii. Confirmation


iv. Summary


That’s it! At this stage you can download and print the air waybills and the orders have been created on Ninja Van's system. 


If you have 'Fulfilled' these orders as well, their tracking IDs will be automatically updated to the orders shortly.

It's not showing up...

If the orders do not appear in the Order Creation step above, these may be why:


If nothing happens after you click the 'Download' button

2. Printing your air waybills/labels

Once your done fulfilling your orders (step 1), give it a moment to work its magic and your orders should appear under the 'Orders' tab in the Shopify app.

From this tab you'll be able to:

Simply then click Download to download them in a PDF in the label size selected earlier for printing through your desired printer.

Once done, simply print out the air waybills and attach them securely to your parcels.

Here are some packaging guidelines to help make sure your parcels reach your customers quickly and safely.


3. In-depth order tracking

In case you need more granular details of the progress of a parcel, simply click the tracking ID on the "Orders" tab in the app

 We will then display the current stage of the parcel and all the milestones and events that have occurred since we picked it up.

4. Tracking your pick ups

After booking your pickups, you can track upcoming pickups at the from the 'Scheduled pickups' tab on the left.

Here you will be able to see the upcoming and also past pickups that you have booked.

5. Editing Shopify fulfilled orders in Ninja Dashboard

In the left navigation menu of Ninja Dashboard, click Order History, and then select the Other Orders tab. 

Orders can also be looked up via the customer information or Ninja Van Tracking ID from the search bar on the top of the page.

You can then make changes to the delivery information accordingly from this page as well. 

FAQs

Navigate to the 'Accounts' settings page from 'Settings' on the left panel of the app and you will be able to unlink (log-out) of the currently linked account and log into another account that you need.

2. Why do you need permissions to manage my orders?

To link your Shopify account to Ninja Dashboard,  we need the permissions to read and modify your orders from Shopify. We will only use these permissions for the following actions:


3. Why is my country not supported?

This service is currently only available in Indonesia, Malaysia , the Philippines and Singapore so far, we are planning to open this up to other countries very soon!


4. Why do I need to set up my store's delivery mappings?

We help to prefill the service level based on the delivery mappings you can set so we can save you a few more clicks!


5. Why don't I see the changes I've made to delivery details when creating regular orders on Shopify?

As per our data integrity practices, we won’t modify any details in the original Shopify order. We only import order details from Shopify to automatically create orders in Ninja Van. Therefore, any changes in the delivery details that we require to deliver the order to your customer will only be captured on Ninja Van’s side.


6. Can the app handle international orders (i.e. orders from Singapore/Malaysia/Philippines to other countries)?

We have currently launched the following international services via the app:


For more information on how we use data from your Shopify store, see our Privacy Policy.


Troubleshooting

1. Error connecting or linking accounts

What if I still can't sync my orders?

If your orders are still not being synced, check the following:


If any problem persists, reach out to your Account Manager or sg-sales@ninjavan.co who will log the issue with us, and we'll get back to you as soon as we can.