1. Track and Trace Intro
Sampson Express has designed this document which outlines the specifications required for clients who required access to our backend track and trace and proof of delivery information.
Sampson Express provides its track and trace in two formats: XML and JSON. We can also provide the track and trace in HTML format which can be embedded in your website or platform. If you require the embedded HTML format, please contact us for further information.
Access to our Track and Trace is only for a maximum of 120 days per connote from date of delivery. After 120 days, a manual request needs to be sent to Sampson Express for the track and trace information to be given to the client.
Non-payment of Account may result in immediate suspension of access to all our system such as API, Track and Trace feed and integration.
2. Consignment Number Tracking Output
Your Server will send a unique URL to Sampson Express consisting the consignment number and Sampson Express will send a JSON as a response.
| HTTP Methods | GET |
| Authentication method | Basic Auth |
| API URL MRL Logistics |
https://api.mrllogistics.com/v3.4/customers/{CustomerID}/tracking/{connoteNo} |
| API URL Sampson Express |
https://api.sampsonexpress.com.au/v3.4/customers/{CustomerID}/ tracking/{connoteNo} |
{
"success": true,
"error": {
"code": 0,
"message": ""
},
"response": [{
"connote": "CCPM000188",
"item": "ICPM000689",
"description": "ATEF, 30/06/2016, 12:16, 1 items, received in good order",
"label": "Confirmation of Delivery",
"code": "COD",
"quantity": "1",
"signedBy": "ATEF",
"date": "30/06/2016",
"time": "12:16"
},
{
"connote": "CCPM000188",
"item": "ICPM000693",
"description": "ATEF, 30/06/2016, 12:16, 1 items, received in good order",
"label": "Confirmation of Delivery",
"code": "COD",
"quantity": "1",
"signedBy": "ATEF",
"date": "30/06/2016",
"time": "12:16"
},
{
"connote": "CCPM000188",
"item": "ICPM000687",
"description": "ATEF, 30/06/2016, 12:16, 1 items, received in good order",
"label": "Confirmation of Delivery",
"code": "COD",
"quantity": "1",
"signedBy": "ATEF",
"date": "30/06/2016",
"time": "12:16"
},
{
"connote": "CCPM000188",
"item": "ICPM000692",
"description": "ATEF, 30/06/2016, 12:16, 1 items, received in good order",
"label": "Confirmation of Delivery",
"code": "COD",
"quantity": "1",
"signedBy": "ATEF",
"date": "30/06/2016",
"time": "12:16"
},
{
"connote": "CCPM000188",
"item": "ICPM000690",
"description": "ATEF, 30/06/2016, 12:16, 1 items, received in good order",
"label": "Confirmation of Delivery",
"code": "COD",
"quantity": "1",
"signedBy": "ATEF",
"date": "30/06/2016",
"time": "12:16"
},
{
"connote": "CCPM000188",
"item": "ICPM000691",
"description": "ATEF, 30/06/2016, 12:16, 1 items, received in good order",
"label": "Confirmation of Delivery",
"code": "COD",
"quantity": "1",
"signedBy": "ATEF",
"date": "30/06/2016",
"time": "12:16"
},
{
"connote": "CCPM000188",
"item": "ICPM000688",
"description": "ATEF, 30/06/2016, 12:16, 1 items, received in good order",
"label": "Confirmation of Delivery",
"code": "COD",
"quantity": "1",
"signedBy": "ATEF",
"date": "30/06/2016",
"time": "12:16"
},
{
"connote": "CCPM000188",
"item": "ICPM000693",
"description": "",
"label": "Onboard Delivery Scan",
"code": "ODS",
"quantity": "1",
"signedBy": "",
"date": "30/06/2016",
"time": "11:39"
},
{
"connote": "CCPM000188",
"item": "ICPM000687",
"description": "",
"label": "Onboard Delivery Scan",
"code": "ODS",
"quantity": "1",
"signedBy": "",
"date": "30/06/2016",
"time": "11:39"
},
{
"connote": "CCPM000188",
"item": "ICPM000688",
"description": "",
"label": "Onboard Delivery Scan",
"code": "ODS",
"quantity": "1",
"signedBy": "",
"date": "30/06/2016",
"time": "11:39"
},
{
"connote": "CCPM000188",
"item": "ICPM000689",
"description": "",
"label": "Onboard Delivery Scan",
"code": "ODS",
"quantity": "1",
"signedBy": "",
"date": "30/06/2016",
"time": "11:39"
},
{
"connote": "CCPM000188",
"item": "ICPM000690",
"description": "",
"label": "Onboard Delivery Scan",
"code": "ODS",
"quantity": "1",
"signedBy": "",
"date": "30/06/2016",
"time": "11:39"
},
{
"connote": "CCPM000188",
"item": "ICPM000691",
"description": "",
"label": "Onboard Delivery Scan",
"code": "ODS",
"quantity": "1",
"signedBy": "",
"date": "30/06/2016",
"time": "11:39"
},
{
"connote": "CCPM000188",
"item": "ICPM000692",
"description": "",
"label": "Onboard Delivery Scan",
"code": "ODS",
"quantity": "1",
"signedBy": "",
"date": "30/06/2016",
"time": "11:39"
},
{
"connote": "CCPM000188",
"item": "ICPM000693",
"description": "",
"label": "Linehaul Scan",
"code": "LSD",
"quantity": "1",
"signedBy": "CPM0600043446",
"date": "29/06/2016",
"time": "18:43"
},
{
"connote": "CCPM000188",
"item": "ICPM000692",
"description": "",
"label": "In Transit",
"code": "OSA003",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "18:14"
},
{
"connote": "CCPM000188",
"item": "ICPM000688",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "18:06"
},
{
"connote": "CCPM000188",
"item": "ICPM000693",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "18:06"
},
{
"connote": "CCPM000188",
"item": "ICPM000689",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "18:06"
},
{
"connote": "CCPM000188",
"item": "ICPM000691",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "18:06"
},
{
"connote": "CCPM000188",
"item": "ICPM000687",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "18:06"
},
{
"connote": "CCPM000188",
"item": "ICPM000690",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "18:06"
},
{
"connote": "CCPM000188",
"item": "ICPM000692",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "18:06"
},
{
"connote": "CCPM000188",
"item": "ICPM000693",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "15:07"
},
{
"connote": "CCPM000188",
"item": "ICPM000687",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "15:07"
},
{
"connote": "CCPM000188",
"item": "ICPM000688",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "15:07"
},
{
"connote": "CCPM000188",
"item": "ICPM000689",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "15:07"
},
{
"connote": "CCPM000188",
"item": "ICPM000690",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "15:07"
},
{
"connote": "CCPM000188",
"item": "ICPM000692",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "15:07"
},
{
"connote": "CCPM000188",
"item": "ICPM000691",
"description": "",
"label": "Pickup Scan",
"code": "PKU",
"quantity": "1",
"signedBy": "",
"date": "29/06/2016",
"time": "15:07"
}
]
}
4. Proof of Delivery (POD) Intro
Sampson Express has designed this document which outlines the specifications required for clients who required access to our backend proof of delivery information.
Sampson Express provides its POD in two stages:
Stage 1: Client sends a unique URL containing several information in the URL identifying the client, the connote, a unique key.
Stage 2: Sampson Express will then send back a different URL containing the POD image with a unique ID valid for a small period of time. This time is set by default to only 10 minutes. The physical POD is not sent to the client and only the URL is sent and it expires after 10 minutes for security reasons.
Access to our POD is only for a maximum of 120 days per connote from date of delivery. After 120 days, a manual request needs to be sent to Sampson Express for the POD information to be given to the client.
Non-payment of Account may result in immediate suspension of access to all our system such as API, Track and Trace feed and integration.
4.1 Proof of Delivery API
| HTTP Methods | GET |
| Authentication method | Basic Auth |
| API URL MRL Logistics |
https://api.mrllogistics.com/v3.4/customers/{CustomerID}/pod/{connoteNo} |
| API URL Sampson Express |
https://api.sampsonexpress.com.au/v3.4/customers/{CustomerID}/ pod/{connoteNo} |
Response sample:
Data in fileContent field is the PDF content in base64 encoded
{
"success": true,
"error": {
"code": 0,
"message": ""
},
"response": {
"filename": "COD_CMRL000676.pdf",
"fileContent": "JVBERi0xLjMKMyAwIG9iago8PC9Ue…Zgo2MTczCiUlRU9GCg=="
}
}
If you require any further information / assistance, please feel free to contact us through https://www.mrlglobal.com/contact-us/.