The authorization will take usually around 1-3 working days

Note: the period may differ based on the number of authorization requests we received daily

We'll inform you through email once your account is ready to use the integration

You will get this email to your registered email address same as the login email on Ninjavan Dashboard.

1. Go back to Ninja Van modules in your Website Admin Page

2. In the dashboard, click “Setting”

3. Login to your Ninja Van Production Pro Account Dashboard,

• URL: https://dashboard.ninjavan.co/login-v2)

4. Go to Settings > IT Settings

5. Copy the Client ID and Client Key  

• Note: Click "Generate Client ID & Key" if it doesn't appear)

6. Paste the API keys

• Go back to your Website Admin Page, Enter “Client ID” and “Client key”, then click “Save” 

7. Click  the “Generate” button to generate a token 

8. You should see the success message. 

• In the “Access Token” field, you should see the expiration date. 

• Always check the expiration date to avoid function interruption. 

• You can click “Regenerate” to refresh the token if necessary.  

• Note: Always check the token first before creating any orders

9. Go back to Ninja Van modules

10. In the dashboard, click "Address Book"

11. Click “add” to add a new address

12. Fill in the address form and click “Save”

13. You can add more than 1 address as your Pickup Location 

• Maximum 10 Addresses

1. Go to Ninja Van modules

2. In the dashboard, click “Setting”

3. Go to the “Cronjob” tab

4. If cronjob token is not generated, 

• Click the refresh icon to generate a cronjob token, then click save.

5. Go to the “Cronjob” tab again,

• Copy the “auto regenerate token” URL and set the cronjob in your server.

• Note: Every Hosting provides a different way of setting the cronjob. Kindly refer your hosting provider 

1. Login to your Ninja Van Production Pro Account Dashboard 

• URL : https://dashboard.ninjavan.co/login-v2

2.  Go to Settings > IT Settings

3. Scroll down to the Webhooks section

- Click “Add” to add a new webhook 

4. Login to your Website Admin Page

• Go to Ninja Van modules

5. In the dashboard, click “Setting”

6. Click on the “Order fulfillment” tab

7. Copy the webhook URL

8. Go back to your Ninja Dashboard, 

• Select "Pending Pickup" for the event 

• Select “1.1” for the version

• Then paste the URL you have copied from the Website Admin Page into the URL Endpoint section. 

• Click “Save” to save

9. Repeat this by clicking “Add another” to add other events with the same version and URL Endpoint

10. These are the suggested Events to add:

• Pending Pickup

• Arrived at Sorting Hub 

• On Vehicle For Delivery 

• Completed

• Return to Sender

• Cancelled

11. You can add all events available in the event field as well

12. Go back to your Website Admin Page

13. For each event, you can select an order status to update when receiving a Webhook, then click “Save”. You can select “No update” if you don’t want to update the Website order status.

14. You are suggested to map as follows:

Ninja Van Event = OpenCart Order Status

• Pending Pickup = Processing

• Arrived at Sorting Hub = Processed

• On Vehicle For Delivery = Shipped

• Completed = Complete

• Return to Sender = Reversed

• Cancelled = Canceled

15. Go back to Ninja Van Module's Setting

16. Go to "Status"

17. Select "Enabled" for Status

1. Go back to your OpenCart store

2. For each of the event

• You can select an order status to update and an email template to send when receiving a webhook

• Then click “Save”. 

• You can select “No update” if you don’t want to update the OpenCart order status.

3. Add email templates

4. Go to Ninja Van modules

5. In the dashboard, click “Email Template”

1. Ninja van COD charge 

• • Allows you to add extra charges when customers choose COD as a payment method.

2. Go to Ninja Van modules

3. In the dashboard, click “Setting” 

4. Go to the “COD Charge” tab

5. COD Setup:

• Enable the COD charge and set the sort order

• The sort order should be after the sub-total and before the order total. 

• Enter the minimum total and the amount to be charged,

• You can add up to 5 charges. 

• Click save to save the setting.

6. You can go to your storefront to check if it is working. 

• First, add a product to the cart and checkout, 

• In the payment method step, select “Cash on delivery” as a payment method,

• Then click “Next”, you should see a “Ninja Van COD charge” in the order total.

Pickup Timeslot

1. This is to set the default timeslot for pickup reservation to Ninja Van

2. Select your Default Pickup Timeslot, this will be the default timeslot used during order creation

Autofill Product to Delivery Instructions

1. This is to set whether if you wanted to display the item descriptions with quantity on the Waybills Generated

2. Note: This will only show the product name, you may need to edit the extension file if you wanted to display "Product Options" or "Product Variations". 

   • Simply go to the Ninja Van's Plugin Folder > admin > controller > extension > module > ninja_van.php and look for $delivery_instructions[] = $product['model'] . ' x' . $product['quantity' to add or edit the parameter you use

3. Select "Yes" for Autofill delivery instructions if you wanted to display Item Descriptions on Waybills

Autofill order ID to delivery instructions

1. You can display the Order ID in the Waybill's Delivery Instructions

2. Select "Yes" to display Order ID in Waybills

Requested Tracking Number as Order ID

1. You can use your Order ID as the Requested Tracking Number to prevent any duplicate order creations

2. Select "Yes" to use your Order ID as the Requested Tracking Number

Requested Tracking Number Prefix

1. If you are using your Order ID as the Requested Tracking Number, you may encounter the error "Duplicate Tracking: Tracking Number has been used" 

2. You can add a prefix to prevent this error 

Autofill Minimum Insured Value

1. You can autofill the insured value of each of your parcels (Not recommended if most of your parcel value is less than RM 200.00 due to the default insurance Ninja Van offered)

2. Select "Yes" if you want the insured value to be autofill for every order

Hide Shipper Detail (Waybill)

1. You can hide your Sender Details on the Waybills if you wanted some privacy of your Address from your customers

2. Select "Yes" for Hiding the Sender Details on Waybills 

Status

1. This is to enable Ninja Van's Webhooks Status to be synchronized with your website Order Status

2. Select "Enabled" for Status

1. Go to Sales > Orders

2. Select the orders you want to create Ninja Van order by clicking the tick box, then click the “Bulk create order”(shopping cart) button at the top

3. Fill in the fields available in the order form 

• Pickup Location

• Pickup Date

• Service Level

• etc

4. Scroll down to the bottom, click “Create order” 

5. If the order is created successfully, 

• The success message with the tracking number will be displayed 

1. Go to Sales > Orders

2. Filter the order status to "Processed"

3. Select the orders you want to print by clicking the tick box, then click the “Bulk print waybill(truck) button at the top, you can select a format from the dropdown

4. Next, you can download the waybill in PDF format or print the waybill 

5. You can also print from Ninja Van Order List

•  Go to Sales > To view the Ninja Van order you have created using this extension:

• Go to Ninja Van modules

• Click the “Order history”

• You can see a list of Ninja Van orders you have created, even the canceled order. You can also perform bulk print waybill from here too. 

1. Go to Sales > Orders

2. View an order you want to see 

3. Scroll down to the Ninja Van order section,

• Find for Ninja Van order history, the most top is the latest Ninja Van status