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

1. Look for the app using the search bar on your Shopify page or the link here

2. Download the Ninja Van Shopify app on the Shopify App Store. 

3. After installing the app, you will land on its Settings page. 

You will have to complete the following to get all set up:

1. Set up delivery mappings

2. Set up preferred label size

As a Shopify merchant, you would have configured your Shopify shipping settings for your store prior to installing the Ninja Van Shopify app. 

What delivery mappings allow you to do is to associate your existing shipping settings with one of Ninja Van’s delivery service level (“Standard”, “Next-day”, “Same-day”, “Express”).

This section explains how to set up delivery mappings in your Shopify store to specify which delivery methods trigger order creation in Ninja Dashboard. Take these steps:

1. In your Shopify store, go to Apps, and then click the Ninja Van Shopify app.

2. Click "Create Mapping" to add a new mapping.

3. Select the profile, location and zones that you’d like to map to a Ninja Van’s service type. 

4. Your Shopify store’s current shipping rates will automatically be pulled and show up as options to select in the drop-down fields.

4. Click Save.

That’s it! The new mapping appears in the list.

Do you have multiple delivery profiles/locations?

Delivery mappings are grouped by shipping profile, and you can add multiple mappings for the applicable delivery rates and locations.

1. Create Ninja Van orders from Shopify

i. Order Creation

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

1. In your Shopify store, go to your Shopify orders tab

2. Click the checkbox for orders that you want to create on the Ninja Van system

   • (Optional) If you want the app to update your tracking IDs to the orders and send customers notifications of the tracking information

   • Click Mark as fulfilled on this page before completing the next steps

3. Click More actions on the top right and select 'Create Orders on Ninja Van'

4. At the Order Details page, you will be able to view each order 

5. At this stage you can do the following: 

   • Edit the Liability value

   • Edit the Service level

   • Remove orders that are not to be created on Ninja Van by deselecting te 'Create Ninja Van Order' toggle on the top right of each order

6. Once done, simply click Next

ii. Booking Pick Ups

1. At the Pick Up Details page, you will be able to book a pick up at the locations where your orders are being fulfilled from

2. Simply select 'Yes' from the drop down box

3. Here you can select the Pickup Date, desired Pickup Time Slot and leave any Pickup Instructions for our drivers

iii. Confirmation

1. Once you are at the 'Confirmation' page, all you have to do is check that the number of orders to be created and pickup details are accurate

2. Once done, click the 'Create Orders' button

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:

• The orders do not have a phone number or an email address

• The orders selected are more than 60 days old

• These orders do not originate from your Ninja Van account country

• These orders are going to a destination country we do not service as of now

  • Serviceable lanes are below:

  • From Indonesia: To Indonesia

  • From Malaysia: To Malaysia and Singapore

  • From Philippines: To Philippines

  • From Singapore: To Singapore and Malaysia

• Your account does not have the appropriate lanes activated

• The orders have a Cash on Delivery (COD) requirement but destination country is not the source country (international COD will be supported in the future)

If nothing happens after you click the 'Download' button

• Do you have a pop-up clocker enabled? 

• If so look out for the pop-up blocked icon on your browser and always allow pop-ups within this page.

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.

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. 

• Do ensure that the information is accurate before saving and updating the delivery information as this would be the address that our driver would refer to during delivery.

1. How do I log out or change the account I am currently logged into?

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.

• Your order history on the 'Orders' page will remain

• Orders created will be created on the account linked at the point of order creation

What if I still can't sync my orders?

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

•  Have you added a payment method to your Shopify account?

• Have you entered a valid and full Business Address under your Shopify store details?

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.