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":"" } ] } ] }