Skynet APIs

Skynet APIs


Authentication

A token will be required for authentication. Customers with a registered Skynet Account may request for a valid token.

JSON format will be used for all request and response.

All API requests should use the POST method

Don't have a token? Login to your Skypostpaid account to obtain your token there!


Error Codes

Token key must remain private and should never be visible on any client-facing code. Errors will come with “error” key. Error will have field code and message. Table below shows the error codes and messages.

# Code No. Message
General Tracking Pickup Domestic Quotation
1 200 Invalid AWB Number Invalid Order Number Invalid Parameter Value
2 300 Invalid Token
3 400 Parameter is missing

General Tracking API

URL Path

http://api.skynet.com.my/api/sn/pub/AWBTracking/

Request parameters

# Name Description Data Type Attributes
1 access_token This token will be provided by SKYNET. String Mandatory
2 Awbs[] AWB Number String[] Mandatory

Request JSON Format


						{
							"access_token":"**********************************1252218",
							"awbs": [
								{"awbnumber":"238721669380"}, 
								{"awbnumber":"238289437072"}
							]
						}

						

Response Parameters

Track status:-

# Name Description Data Type
1 AWBNumber AWB No. (232********) String
2 EventType Example: POD String
3 EventDate Full date time. Date time
4 Description Status of shipment. String
5 Location Place of Shipment String
6 RecieverName Receiver name. String

Response JSON Format


						[
							{
								"AWBNumber": "238721669380",
								"EventType": "",
								"EventDate": null,
								"Description": "Data not found",
								"Location": "",
								"ReceiverName": ""
							},
							{
								"AWBNumber": "201029271122",
								"EventType": "POD",
								"EventDate": "2018-06-20T20:03:55",
								"Description": "Delivered",
								"Location": "SETIAWAN",
								"ReceiverName": ""
							},
							{
								"AWBNumber": "201029271122",
								"EventType": "OFD",
								"EventDate": "2018-06-20T10:40:38.31",
								"Description": "Out for Delivery",
								"Location": "SETIAWAN",
								"ReceiverName": ""
							},
							{
								"AWBNumber": "201029271122",
								"EventType": "CHECKIN",
								"EventDate": "2018-06-20T09:29:20.953",
								"Description": "Arrived STW",
								"Location": "SETIAWAN",
								"ReceiverName": ""
							},
							{
								"AWBNumber": "201029271122",
								"EventType": "HUB CHECKIN",
								"EventDate": "2018-06-19T23:39:07.01",
								"Description": "Arrived HUB",
								"Location": "SUBANG JAYA",
								"ReceiverName": ""
							},
							{
								"AWBNumber": "201029271122",
								"EventType": "PUCHECIN",
								"EventDate": "2018-06-19T13:11:09",
								"Description": "Collection",
								"Location": "BAHAU",
								"ReceiverName": ""
							}
						]

						

Tracking Event Types

# Event Code Description
1 Arrived At Sorting Facility PUCHECIN Collection at pick-up Station
2 Departed to HUB LINEHAUL Line haul to HUB
3 Arrived HUB HUB CHECKIN Checked in at HUB
4 Departed to destination HUB LINEHAUL Line haul to destination station
5 Arrived destination CHECKIN Checked in at arrival station
6 Out for Delivery OFD Shipment out for Delivery
7 Delivered POD Shipment delivered to Customer

Postcode API

URL Path

http://api.skynet.com.my/api/sn/getpostcode

Request parameters

# Name Description Data Type Attributes
1 access_token This token will be provided by SKYNET. String Mandatory
2 functionstr Use "getpostcode" String Mandatory
3 GetType Use "postcode" String Mandatory
4 GetVal The postcode of recipient address. String Mandatory
5 AWBNumber AWBNumber that assigned to the recipient address. String Optional

Request JSON Format


						{
							"access_token":"**********************************YDD444444DD",
							"functionstr":"getpostcode",
							"GetType":"postcode",
							"GetVal":"01000",
							"AWBNumber":"test123456"
						}

						

Response Parameters

Track status:-

# Name Description Data Type
1 postcode The postcode of recipient address. String
2 branchcode The branchcode of the station incharge. String
3 AWBNumber AWBNumber that assigned to the recipient address. String

Response JSON Format


						[
							{
								"postcode": "01000", 
								"branchcode": "KGR", 
								"AWBNumber": "test123456"
							}
						]

						

Woocommerce Integration

Installation Guide
Requirements
  • WooCommerce plugin version 3.0.0 or higher installed and set up.
  • SkyPostpaid account API token.
Installation from Wordpress
  1. Go to `Plugins` menu > `add new plugin` and search for `Skynet Malaysia` in your Wordpress Admin panel.
  2. Click the `Install now` button to install the plugin.
  3. After the plugin is installed, Activate the plugin by clicking the `Activate` button through the `Plugins` menu in WordPress.
Manual Installation
If you have manually downloaded the plugin from Wordpress you may:
  1. Upload the plugin files to the `/wp-content/plugins/` in your Wordpress directory
  2. Activate the plugin Activate the plugin by clicking the `Activate` through the `Plugins` menu in WordPress
Configuration
In order to configure your Skynet plugin, you will need your API token. If you do not have an API token, please request for one from https://www.skynet.com.my/api
  1. Fill up your company/sender information and API token in WooCommerce > Settings > Shipping > Skynet.
  2. You may also click the `Load default store address` button to load WooCommerce's default store address that you have configured in WooCommerce settings.
  3. Save your information by clicking the `Save Changes` button.

User Guide
Printing Airwaybill
  1. Go to WooCommerce > Orders and select the order that you want to print the Airwaybill for.
  2. Fill up the fields. Note: You have to make sure that the Shipping Address details are correct before you proceed to print.
  3. Click 'Print Airwaybill' to print out the Airwaybill in the PDF format.
Reprinting Airwaybill
If you want to reprint the Airwaybill due to some unforeseen circumstances, you may:
  1. Go to WooCommerce > Orders and select the order that you want to print the Airwaybill for.
  2. Click 'Reprint Airwaybill' to print out the Airwaybill in the PDF format.

OpenCart Integration

Installation Guide
Requirements
  • OpenCart version 3.0.0.0 or higher installed.
  • SkyPostpaid account API token.
Installation
  1. Go to OpenCart Extension Store and search for `Skynet Malaysia Shipping` or click here.
  2. Click the `Download` button and login with your OpenCart account to proceed download.
  3. Once downloaded, extract the skynetmalaysia.zip
  4. Go to upload folder, copy the admin folder and paste into your opencart root files system.
  5. Login to your opencart admin web system, on the left menu panel, navigate to `Extensions`>`Installer`.
  6. Click `Upload` button and browse for skynet_malaysia.ocmod.zip inside the downloaded Skynet Malaysia Shipping Module and click Open.
  7. Once uploaded, the skynet_malaysia.ocmod.zip will be listed in the Install History.
  8. On the left menu panel, navigate to `Extensions`>`Modifications`.
  9. On the Modification List, Skynet Malaysia should be listed, if not click button at the top right.
    If it is still not listed after Refresh, repeat from Step No. 4
Configuration
In order to configure your Skynet Malaysia Module, you will need your API token. API Token can be obtained from here.
  1. Login to your opencart admin web system, on the left menu panel, navigate to `Extensions`>`Extensions` and Choose the extension type of Modules.
  2. Scroll down and find Skynet Malaysia and click button.
  3. Once Installed, click button at Skynet Malaysia module.
  4. On Edit Skynet Malaysia Module page, insert the API Token and click .

User Guide
Printing Airwaybill

• Single

  1. Go to List of Orders page and select the order that you want to print the Airwaybill for and click .
  2. On Order Details page, scroll down to Order History section and click `Skynet Malaysia` tab.
  3. Fill up the fields and click to print out the Airwaybill in the PDF format.

• Bulky

  1. Go to List of Orders page and select the multiple orders that you want to print the Airwaybill at once and click .
  2. On Print Bulky Skynet Airwaybill page, fill up the fields for each order and click to print out the Airwaybill in the PDF format.
Reprinting Airwaybill
If you want to reprint the Airwaybill due to some unforeseen circumstances, you may:
  1. Go to `Skynet Malaysia`>`Printed Airwaybills` and click for order that you want to reprint the airwaybill.

EasyStore Integration

Installation Guide
Requirements
  • SkyPostpaid account API token.
Installation
  1. Login to your EasyStore account or click here to login.
  2. Go to EasyStore App Marketplace and search for `Skynet Malaysia` or click here.
  3. Click the `Install this app` button to proceed the installation inside your store.
  4. EasyStore will prompt out the authorization granted to the Skynet Malaysia app for the installation.
  5. Click `Install` button to proceed with the installation.
Configuration
In order to configure your Skynet plugin, you will need your API token. If you do not have an API token, please request for one from https://www.skynet.com.my/api
  1. Login to your EasyStore admin web system, on the left menu panel, navigate to `App` and click on the Skynet Malaysia app inside the list of installed app.
  2. On Skynet Malaysia app page, insert the API Token and click `Save` button.

User Guide
Printing Airwaybill
  1. Go to Orders and select the order that you want to print the Airwaybill for.
  2. On the order details page, click the `Fulfill` button and select the Skynet Malaysia.
  3. Fill up the fields and click `Print Airwaybill` button to print out the Airwaybill in the PDF format.
Reprinting Airwaybill
If you want to reprint the Airwaybill due to some unforeseen circumstances, you may:
First Method :
  1. Go to Orders and select the order that you want to print the Airwaybill for.
  2. On the order details page, scroll down to the History section and click the Label is printed.
  3. In the Message description, click `here` text to reprint out the Airwaybill in the PDF format.
Second Method :
  1. Navigate to `App` and click on the Skynet Malaysia app inside the list of installed app.
  2. On Skynet Malaysia app page, click on the `Printed Airwaybills` panel.
  3. On the list of previous printed Skynet Airwaybills, click the `Reprint Airwaybill` button to reprint out the Airwaybill in the PDF format.