View All Deliveries
URL: |
|
HTTP POST REQUEST
Note: the request structure below is for Method #1: Name/Value Pair (NVP) + JSON String. For Method #2: Custom Header + JSON Body, please refer to the json parameter only.
Field | Description |
date | The delivery date. Format: YYYY-MM-DD e.g. 2014-02-28. Required field. |
HTTP POST RESPONSE (JSON)
Field | Description |
status | The status of the request. The value will be “ok” if request is processed successfully or “failed” if the key or json parameter is missing. |
error | Contains the error details if the request failed. Note: this field is set only if the request failed. |
Field | Description |
date | The delivery date. Format: YYYY-MM-DD e.g. 2014-02-28. |
do | The D.O. #. This field is unique for the date. |
address | The delivery address. |
delivery_time | The delivery time window. |
deliver_to | The name of the recipient to deliver to. |
phone | The phone number of the recipient. |
notify_email | The email address to send customer-facing delivery updates to. |
notify_url | The URL to post delivery updates to. |
assign_to | The name of the vehicle to assign this delivery to. |
instructions | Delivery instructions for the driver. |
zone | The zone that this delivery falls under. |
reason | The reason of non-delivery if the delivery is not delivered. |
note | Any note recorded by the driver regarding this delivery. |
received_by | The name of the recipient who signed for the delivery. |
image | If the POD contains an image (signature / photo), the value will be 1. Otherwise, it will be 0. |
view_image_url | If the POD contains an image (signature / photo), this field will contain an access-controlled link (user must be logged in to Detrack) to the image. Otherwise, it will be empty. |
time | The time the POD is received. ISO 8601 format: YYYY–MM–DDTHH:MM:SS+HH:MM e.g. 2014-02-13T09:30:45+08:00 |
pod_lat | The latitude of the driver’s last known location when submitting POD for this delivery. |
pod_lng | The longitude of the driver’s last known location when submitting POD for this delivery. |
pod_address | The address of the driver’s last known location when submitting POD for this delivery. |
Item-level
Field | Description |
sku | Stock keeping unit or item #. |
desc | The item description. |
qty | Quantity of the item to be delivered. |
reject | Quantity of the item rejected by recipient. |
reason | Reason of item rejection. |
SAMPLE REQUEST JSON
{
"date":"2014-02-13"
}SAMPLE RESPONSE JSON
{
"info":{
"status":"ok"
},
"deliveries":[
{
"date":"2014-02-13",
"address":"63 Ubi Avenue 1 Singapore 408937",
"delivery_time":"09:00 AM - 12:00 PM",
"deliver_to":"John Tan",
"phone":"+6591234567",
"notify_email":"john.tan@example.com",
"notify_url":"http://www.example.com/notify.php",
"assign_to":"GT1234H",
"instructions":"Call customer upon arrival.",
"zone":"East",
"reason":"",
"note":"Recipient commented that delivery is very prompt.",
"received_by":"John",
"image":1,
"view_image_url":"https://app.detrack.com/deliveries/photo/52cbaf87f92ea105a4000115.jpg",
"do":"DO140213001",
"status":"Delivered",
"time":"2014-02-13T09:30:45+08:00",
"pod_lat":1.32502083807714,
"pod_lng":103.893779271220,
"pod_address":"63 Ubi Avenue 1, Singapore 408937",
"items":[
{
"sku":"T0201",
"desc":"Test Item #01",
"qty":1,
"reject":0,
"reason":""
},
{
"sku":"T0202",
"desc":"Test Item #02",
"qty":5,
"reject":0,
"reason":""
},
{
"sku":"T0203",
"desc":"Test Item #03",
"qty":10,
"reject":0,
"reason":""
}
]
},
{
"date":"2014-02-13",
"address":"59 Ubi Avenue 1 Singapore 408938",
"delivery_time":"02:00 PM - 05:30 PM",
"deliver_to":"Jane Lim",
"phone":"+6581234567",
"notify_email":"jane.lim@example.com",
"notify_url":"http://www.example.com/notify.php",
"assign_to":"GT1234H",
"instructions":"Change pass at security counter before proceeding to level 3.",
"zone":"East",
"reason":"",
"note":"",
"received_by":"",
"image":0,
"view_image_url":"",
"do":"DO140213002",
"status":"In Progress",
"time":"",
"pod_lat":"",
"pod_lng":"",
"pod_address":"",
"items":[
{
"sku":"T0211",
"desc":"Test Item #11",
"qty":1,
"reject":0,
"reason":""
},
{
"sku":"T0212",
"desc":"Test Item #12",
"qty":5,
"reject":0,
"reason":""
},
{
"sku":"T0213",
"desc":"Test Item #13",
"qty":10,
"reject":0,
"reason":""
}
]
}
]
}