3.1 Create Shipments
Description
This section will show you how you can create the shipments using this API.
Sandbox/Testing URL: https://sandbox-apiv2.unixus.com.my/shipment/v2/Create
Production/Live URL: https://apiv2.unixus.com.my/shipment/v2/Create
Method : POST
Content-Type : application/json
Accept-Language : en
Authorization : Bearer {access_token}
Request
Data Structure
CreateShipments
| Field | Type | Mandatory | Remarks |
|---|---|---|---|
| Shipments | CreateShipmentDetails[] | Yes | Refer to CreateShipmentDetails |
CreateShipmentDetails
| Field | Type | Mandatory | Remarks |
|---|---|---|---|
| Shipper | PersonInfo | Yes | Refer to PersonInfo |
| Consignee | PersonInfo | Yes | Refer to PersonInfo |
| Items | ItemInfo[] | Yes | Refer to ItemInfo |
| Packages | PackageInfo[] | Yes | Refer to Packages |
| ShipmentDate | DateTime | Yes | Example: 2018-07-01T00:00:00+08:00 |
| TOSMode | String | Yes | Refer to TOS Mode |
| ProfitCentreCode | String | No | |
| ReferenceNo | String | No | |
| ReferenceSource | String | No | |
| PackageType | Enum | Yes | Refer to PackageType |
| WeightType | Enum | Yes | Refer to WeightType |
| CurrencyCode | String | Yes | |
| Remarks | String | No |
PersonInfo
| Field | Type | Mandatory | Description |
|---|---|---|---|
| Name | String | No | |
| ContactPerson | String | Yes | |
| IdentityNo | String | No | |
| Address1 | String | Yes | |
| Address2 | String | No | |
| Address3 | String | No | |
| Postcode | String | Yes | |
| City | String | Yes | |
| State | String | Yes | |
| CountryCode | String | Yes | |
| StationCode | String | No | |
| Phone1 | String | Yes | |
| Phone2 | String | No | |
| MobilePhone | String | No | |
| Fax | String | No | |
| String | No | ||
| Url | String | No |
ItemInfo
| Field | Type | Mandatory | Description |
|---|---|---|---|
| Description | String | Yes | |
| Quantity | Integer | Yes | |
| UnitValue | Numeric | Yes | |
| HSCode | String | No | |
| SKU | String | No | |
| Url | String | No |
PackageInfo
| Field | Type | Mandatory | Description |
|---|---|---|---|
| PackageReference | String | Yes | |
| Length | Numeric | Yes | Length in CM |
| Width | Numeric | Yes | Width in CM |
| Height | Numeric | Yes | Height in CM |
| ActualWeight | Numeric | Yes | Actual weight in KG |
TOS Mode
TOS stand for Type of Service. The value of TOS Mode in Shipment Info is based on the consignee country code. The following code is the example of how you assign the TOSMode value. If you facing the error of invalid TOS, please contact our customer support.
public string GetTOSMode(string consigneeCountry) {
switch (consigneeCountry) {
case "MY":
return "MY-E-EXPRESS";
case "TH":
return "TH-E-EXPRESS";
case "HK":
return "HK-E-EXPRESS";
case "SG":
return "SG-E-EXPRESS";
case "ID":
return "ID-E-EXPRESS";
case "CN":
return "CN-E-EXPRESS";
default:
// error
}
}
PackageType and WeightType
// If in doubt, choose SPX
public enum PackageType {
DOX,
SPX,
SPX_L,
SPX_P,
SPX_S
}
public enum WeightType {
KG,
LBS
}
Sample:
{
"Shipments": [
{
"Shipper": {
"Name": " DEMO ACCOUNT",
"ContactPerson": "DEMO ACCOUNT",
"Address1": "Block C, 3A01 & 3A02,",
"Address2": "Level 3A, Kelana Square,",
"Address3": "No.17, Jalan SS7/26",
"Postcode": "47301",
"City": "Petaling Jaya",
"State": "Selangor",
"CountryCode": "MY",
"Phone1": "+60378038830"
},
"Consignee": {
"ContactPerson": "LWE (AU) Ltd.",
"Address1": "Test Address 1",
"Address2": "Test Address 2",
"Postcode": "70000",
"City": "JOHOR BAHRU",
"State": "SELANGOR",
"CountryCode": "MY",
"Phone1": "03-8888888"
},
"Items": [
{
"Description": "item1",
"Quantity": 10,
"UnitValue": 20.0,
"HSCode": "30",
"SKU": "40",
"Url": "50"
}
],
"Packages": [
{
"PackageReference": "pkg1",
"Length": 10.0,
"Width": 20.0,
"Height": 30.0,
"ActualWeight": 30.0
}
],
"PackageType": "SPX",
"WeightType": "KG",
"ShipmentDate": "2019-01-10T00:00:00+08:00",
"TOSMode": "MY-E-EXPRESS",
"CurrencyCode": "MYR"
}
]
}
Response
Sample
{
"Summary": {
"Total": 1,
"Success": 1,
"Failed": 0
},
"ShipmentsResponse": [
{
"IsSuccess": true,
"ShipmentDetails": {
"Shipper": {
"Name": " DEMO ACCOUNT",
"ContactPerson": "DEMO ACCOUNT",
"Address1": "Block C, 3A01 & 3A02,",
"Address2": "Level 3A, Kelana Square,",
"Address3": "No.17, Jalan SS7/26",
"Postcode": "47301",
"City": "Petaling Jaya",
"State": "Selangor",
"CountryCode": "MY",
"Phone1": "+60378038830"
},
"Consignee": {
"ContactPerson": "LWE (AU) Ltd.",
"Address1": "Test Address 1",
"Address2": "Test Address 2",
"Postcode": "70000",
"City": "JOHOR BAHRU",
"State": "SELANGOR",
"CountryCode": "MY",
"Phone1": "03-8888888"
},
"Items": [
{
"Description": "item1",
"Quantity": 10,
"UnitValue": 20,
"HSCode": "30",
"SKU": "40",
"Url": "50"
}
],
"Packages": [
{
"PackageReference": "pkg1",
"Length": 10,
"Width": 20,
"Height": 30,
"ActualWeight": 30,
"ChildHawb": "458040010570483PC001"
}
],
"ShipmentsReference": [
{
"CarrierName": "POS-LAJU",
"ReferenceNo": "458040010570483"
}
],
"HawbNo": "458040010570483",
"TOSMode": "MY-E-EXPRESS",
"CurrencyCode": "MYR",
"PackageType": "SPX",
"WeightType": "KG",
"ShipmentDate": "2019-01-10T00:00:00+08:00"
}
}
]
}