View All Deliveries
Operator avatar
Written by Operator
Updated over a week ago

View All Deliveries

URL:

https://app.detrack.com/api/v1/deliveries/view/all.json

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

Did this answer your question?