The Freight API allows REST functionality to connect with our core information. This API is limited to consignment status and POD information as a GET method. Requests are returned in the form of JSON bodied responses.
The Freight API supports HTTP basic authentication.
For HTTP Basic authentication, you will use the username and auth token provided to you by Hi-Trans Express:
CURL -G https://api.hi-trans.com.au/ws/rest/freight/status/$ConsignmentNo -U $Username:$Token |
The Freight API produces the following standard errors, a summary of these are below:
200 - OK | Request successful. |
400 - Bad Request | Couldn’t submit request. Check parameters. |
401 - Unauthorized | Authentication failed. |
402 - Request Failed | The parameters were valid but the request failed. |
403 - Forbidden | User doesn’t have permissions to perform request. |
404 - Not Found | The requested resource doesn't exist. |
409 - Conflict | The request conflicts with another request. |
429 - Too Many Requests | Too many requests hit the API too quickly. We recommend an exponential backoff of your requests. |
500, 502, 503, 504 - Server Errors | Server issue on our end. |
The current status of a consignment can be requested through a GET call to the API. Currently, it is only possible to retrieve a single status using the consignment number within the endpoint.
CURL -G https://api.hi-trans.com.au/ws/rest/freight/status/$ConsignmentNo |
Where $ConsignmentNo is the Consignment Number you wish to retrieve.
Unique Record ID for the consignment record
The consignment number
The time at which the consignment was despatched
StatusID | ConsignmentStatus | Description |
---|---|---|
7 | Awaiting Pickup Allocation | The consignment is currently waiting to be allocated to a fleet for pickup |
10 | Pickup Allocated | The consignment has been allocated to a fleet for pickup |
12 | Pickup Acknowledged | The fleet has acknowledged pickup allocation for consignment |
15 | Arrived at Sender | The fleet has arrived at pickup location of consignment |
21 | Departed Sender | The fleet has complete the consignment pickup |
22 | Futile Pickup | The fleet was unable to pick up consignment |
25 | Unshipped | The consignment is awaiting to be placed on a linehaul truck |
40 | Manifested - Pending Arrival | The consignment has been placed on a linehaul manifest |
47 | Arrived at Receiving Depot | The consignment has arrived in the receiving depot |
50 | Delivery Allocated | The consignment has been put on-board a local truck or freight forwarder for delivery |
52 | Arrived at Receiver | The consignment has arrived at the delivery location. |
56 | Departed Receiver | The consignment has been delivered at the delivery location. |
58 | Futile Delivery | The consignment was unable to be delivered to the delivery location. |
The time the pickup fleet arrived at the pickup location.
The time the pickup for the consignment was complete at the pickup location. May contain a date only value if pickup was completed by a fleet without a PDA unit
The date the consignment was placed onto a linehaul manifest,
The date the consignment was placed onto a delivery vehicle or freight forwarder vehicle.
The time the delivery fleet arrived at the delivery location.
The time the delivery for the consignment was complete. May contain a date only value if delivery was completed by a fleet without a PDA unit.
CURL -G https://api.hi-trans.com.au/ws/rest/freight/Status/ETS188 -U $Username:$Token |
{ "ConsignmentID": 2241045, "ConsignmentNo": "ETS188", "DespatchDateTime": "16-10-2020T14:29:28", "ConsignmentStatus": "Departed Receiver", "StatusID": 56, "PickupArriveDateTime": "19-10-2020T14:53:41", "PickupCompletedDateTime": "19-10-2020T15:14:42", "ManifestDate": "26-10-2020", "RunsheetDate": "21-10-2020", "DeliveryArrivedDateTime": "26-10-2020T08:30:16", "DeliveryCompleteDateTime": "26-10-2020T08:37:59" } |
The POD and scanned documents can be requested through a GET call to the API. Currently you can retrieve all documents for an individual consignment.
CURL -G https://api.hi-trans.com.au/ws/rest/freight/PODs/$ConsignmentNo/ |
Where $ConsignmentNo is the Consignment Number you wish to retrieve the documents for.
ConsignmentNo StringThe linked consignment note number FileExt StringThe file extension type FileData String Base64 EncodedThe document encoded as Base64 |
CURL -G https://api.hi-trans.com.au/ws/rest/freight/PODs/ETS188 -U $Username:$Token |
{ "POD": [ { "ConsignmentNo": "ETS188", "FileExt": "jpg", "FileData": "Base64datahere" }, { "ConsignmentNo": "ETS188", "FileExt": "jpg", "FileData": "Base64datahere" } ] } |
Consignment manifests can be imported using a POST request to the API. Multiple consignments can be imported at the same time with pickup requests being created from the included details.
CURL -H "Content-Type: application/json" -X POST https://api.hi-trans.com.au/ws/rest/freight/import/ |
The newly created consignment note number. This must be unique and not repeat a previous consignment number. The consignment prefix will be used to determine the charge account.
The date of consignment despatch. Date must be in format : dd-MM-yyyy
An additional user reference for the consignment note. Eg. a purchase order number.
The business name of the sender
The sender’s address
The sender’s address
The sender’s address
The sender’s suburb. Our database contains all suburbs from the Australia Post database which can be found here: Postcodes Australia | Postcode Search & Finder - Australia Post (auspost.com.au)
The sending state. Options are ‘SA’, ‘QLD’, ‘VIC’, ‘NSW’, ‘ACT', ‘NT’, ‘WA’, 'TAS’
The sender postcode. Our database contains all suburbs from the Australia Post database which can be found here: Postcodes Australia | Postcode Search & Finder - Australia Post (auspost.com.au)
The contact name of the sender
The contact number of the sender.
Any additional instructions for pickup of the freight.
The business name of the receiver
The receiver’s address
The receiver’s address
The receiver’s address
The receiver’s suburb. Our database contains all suburbs from the Australia Post database which can be found here: Postcodes Australia | Postcode Search & Finder - Australia Post (auspost.com.au)
The receiving state. Options are ‘SA’, ‘QLD’, ‘VIC’, ‘NSW’, ‘ACT', ‘NT’, ‘WA’, 'TAS’
The receiver postcode. Our database contains all suburbs from the Australia Post database which can be found here: Postcodes Australia | Postcode Search & Finder - Australia Post (auspost.com.au)
The contact name of the receiver
The contact number of the receiver. Useful if we need to call upon delivery
Additional instructions for consignment delivery
The service level of the consignment. Options are below, pending customer rates agreement
G | General Service |
X | Express Service |
L | Local Service. Eg. Metro Adelaide > Metro Adelaide job |
F | Full Load Service |
Additional Instructions field for consignment. List and further requirements here.
The total number of pallet spaces the consignment covers.
The total number of chep pallets transferred. Required zero value if there are none
The total number of loscam pallets transferred. Required zero value if there are none
The total number of customer own pallets used on the consignment. Required zero value if there are none
For Timeslot use only. If delivery is required within a timeslot, please provide the date here. Date must be in format : dd-MM-yyyy
For Timeslot use only. If delivery is required within a timeslot, please provide the time here. Time must be in 24hr format : 13:00
The date the pickup is ready to be collected from the sender. Date must be in format : dd-MM-yyyy
The time the pickup is ready to be collected from the sender. Time must be in 24hr format : 13:00
The time the senders business closes for freight pickups. Time must be in 24hr format : 16:00
LineItemReference String MaxLength:25User reference number for freight line item. Eg. A purchase order number. LineItemUnitName String MaxLength:20The unit name for the freight line item. Must correspond to the rate units found on the customer account. For accounts using weight (c/kg) rates, leave this field blank. LineItemDescription String MaxLength:20A brief description of the freight items. Eg. Electronic Goods LineItemQuantity integerThe quantity of this freight line item. LineItemWeight numberThe total weight for this line item in tonnes. Eg if there are 5x 0.200t pallets, the total weight would be 1.000t LineItemLength numberThe length of each individual item in metres. LineItemWidth numberThe width of each individual item in metres. LineItemDepth numberThe depth of each individual item in metres. LineItemCubic numberThe total volume for this line item in cubic metres. Eg if there are 4x 1.2mx1.2mx1.2m pallets, the total volume would be 6.912 LineItemUNNumber String MaxLength:4If containing dangerous goods, the UN number for this freight. Please refer to the latest version of the Dangerous Goods Code Australian Dangerous Goods Code | National Transport Commission (ntc.gov.au) LineItemDGAmount numberThe amount of dangerous goods in litres or kilograms |
[ { "ConsignmentNo": "TEST1234", "DespatchDate": "10-02-2021", "SenderReference": "TEST", "SenderName": "TEST Sender", "SenderAddress1": "Test Sender Address", "SenderAddress2": "TEST", "SenderAddress3": "TEST", "SenderSuburb": "Gillman", "SenderState": "SA", "SenderPostcode": "5013", "SenderContactName": "BOB", "SenderContactPhone": "1234567890", "SenderInstructions": "Test Instructions", "ReceiverName": "Test Receiver", "ReceiverAddress1": "Test Receiver Address", "ReceiverAddress2": "TEST", "ReceiverAddress3": "TEST", "ReceiverSuburb": "Chelsea Heights", "ReceiverState": "VIC", "ReceiverPostcode": "3196", "ReceiverContactName": "John", "ReceiverContactPhone": "1234567890", "ReceiverInstructions": "Test Receiver Instructions", "ServiceCode": "G", "GeneralInstructions": "Test General Instructions", "TotalPalletSpaces": 1, "TotalChepPallets": 0, "TotalLoscamPallets": 0, "TotalPlainPallets": 1, "DeliveryRequiredDate": "15-02-2021", "DeliveryRequiredTime": "14:00", "PickupReadyDate": "10-02-2021", "PickupReadyTime": "7:00", "PickupCloseTime": "17:00", "LineItems": [ { "LineItemReference": "ABC1234", "LineItemUnitName": "PALLET", "LineItemDescription": "Electronic Goods", "LineItemQuantity": 1, "LineItemWeight": 1.000, "LineItemLength": 1.200, "LineItemWidth": 1.200, "LineItemDepth": 1.200, "LineItemCubic": 1.728, "LineItemUNNumber": "0000", "LineItemDGAmount": 4 }, { "LineItemReference": "ABC1235", "LineItemUnitName": "PALLET", "LineItemDescription": "More Electronics", "LineItemQuantity": 2, "LineItemWeight": 2.000, "LineItemLength": 1.200, "LineItemWidth": 1.200, "LineItemDepth": 1.200, "LineItemCubic": 3.456, "LineItemUNNumber": "0000", "LineItemDGAmount": 4 } ] } ] |