TUTORIAL

Fields and Description (API version)

API Key Dashboard Field Description Data Type Example
id Not Shown Unique identifier of the job assigned by Detrack upon job creation. Primary key. String 5b22055510c92b1a046ece04
type Detrack Job Type Acceptable values:

  1. Delivery
  2. Collection

Default: Delivery

String Delivery
primary_job_status Primary Job Status Available options:

  1. in_transit
  2. info_recv
  3. dispatched
  4. on_hold
  5. return
  6. completed
  7. completed
String dispatched
open_to_marketplace Open to Marketplace For indicating whether the job can appear in the marketplace for drivers to select.
true – Not available to Marketplace.
false – Open to Marketplace.
Boolean true
marketplace_offer Marketplace Offer Refers to the price/offer for drivers when shown on the marketplace. Float 1.5
do_number D.O. No. Unique identifier for the job.
Required unless Auto generate D.O. No. is enabled under Settings > Job > Options.
Required.
String DO123
attempt Attempt Number of times the job has been attempted.
Default number: 1.
If there is a reattempt of a job, the newly copied job entry will be in increment number, e.g. 2.
Integer 1
date Date Date for performing the job.
Format: YYYY-MM-DD.
Required.
Date 2019-12-24
start_date Start Date By default, it will be the same as the Date for performing the Delivery/Collection.
To indicate when the job was started.
Format: YYYY-MM-DD.
Date 2019-12-24
job_age Job Age For date earlier than start_date, job_age: 0.
For date same or after start_date, job_age: Difference between start_date and date + 1.
Integer 1
job_release_time Job Release Time Refers to the timing for the job to appear in the Driver App. Time 09:00 AM
job_time Job Time The duration of the job. String 30 mins
time_window Time Window The time window for performing the job. String 0900 – 1100 hrs
job_received_date Job Received Date Date when the job was received.
Format: YYYY-MM-DD.
Date 2019-12-24
tracking_number Tracking No. Tracking Number of the job. Can be used for tracking via Tracking Widget once setting is enabled. String T123
order_number Order No. Order Number of the job. String O123
job_type Job Type The job type of the job.
Related to “Sticky Jobs” or jobs with high priority to be placed at the top of the list in the Driver App.
String Urgent
job_sequence Job Sequence For controlling the index of the jobs appearing in the Driver App.
The lowest number will be placed at the top of the list.
Float 10.5
job_fee Job Fee The amount for performing the delivery. String 100
address_lat Address Latitude The latitude of the job address.
To be used with Address Longitude.
Float 1.3356456
address_lng Address Longitude The longitude of the job address.
To be used with Address Latitude.
Float 103.9095161
address Address The address of the job.
Required if “Line Address” not provided.
String 61 Kaki Bukit Ave 1 Shun Li Industrial Park Singapore 417943
company_name Company Name The name of the company. String ABC Company
address_1 Address 1 Part of “Line Address”.
Will be concatenated into address if address is absent.
String 61 Kaki Bukit Ave 1
Address 2 address_2 Part of “Line Address”.
Will be concatenated into address if address is absent.
String #04-34
address_3 Address 3 Part of “Line Address”.
Will be concatenated into address if address is absent.
String Shun Li Industrial Park
postal_code Postal Code Part of “Line Address”.
Will be concatenated into address if address is absent.
String 417943
city City Part of “Line Address”.
Will be concatenated into address if address is absent.
String Singapore
state State Part of “Line Address”.
Will be concatenated into address if address is absent.
String Singapore
country Country Part of “Line Address”.
Will be concatenated into address if address is absent.
String Singapore
billing_address Billing Address Billing address for collection of payment. String 61 Kaki Bukit Ave 1 Shun Li Industrial Park Singapore 417943
deliver_to_collect_from Deliver To / Collect From The name of the Recipient or Sender. String Patrick
last_name Last Name The last name of the Recipient or Sender. String Parker
phone_number Phone No. The phone number of the Recipient or Sender.
For text/sms notification, enter the number to send to.
String 912345678
sender_phone_number Sender Phone No. The phone number which the text/sms notifications will be sent to. String 912345678
other_phone_numbers Other Phone Numbers Phone numbers which the text/sms notifications will be sent to. String 912345678; 923456789; 934567890
fax_number Fax No. The fax number of the customer of the job. String 912345678
instructions Instructions Text for your driver in the Driver App. String Call the recipient upon arrival.
assign_to Assign To The vehicle/driver assigned to the job. String Driver1
notify_email Notify Email The email address/es to send notifications to.
Separate each email entry with “; “.
String john@gmail.com; mary@yahoo.com; peter@detrack.com
webhook_url Webhook URL Webhook URL for receiving the webhook PUSH notifications from Detrack. String https://yourwebhook.com
zone Zone The zone of the job.
If the job has a matching zone with a vehicle, and that the assign_to is absent; the job will be assigned to the vehicle with the matching zone.
String North
customer Customer The name of the customer. String Peter
account_number Account No. The account number of the customer for the job. String ACC123
job_owner Job Owner The requestor/owner of the job. String Mary
invoice_number Invoice No. The invoice number of the job. String Inv123
invoice_amount Invoice Amount The amount for the job invoice. Float 1.5
payment_mode Payment Mode The mode of payment for the job. String Cash on delivery
payment_amount Payment Amount The amount to be collected for the job.
Related to the Cash on Delivery (COD) feature in the Driver App.
Float 1.5
group Group Refers to the groups created under Users > Groups. String Group1
source Source The place where the item of the job originated from. String Jack’s place
weight Weight Weight of the package. You can enable the weight to appear on the Driver App under Settings > Job > Fields. Float 1.5
parcel_width Parcel Width Width of parcel. (centimeters)
Factor of cubic_meters.
Integer 1
parcel_length Parcel Length Length of parcel. (centimeters)
Factor of cubic_meters.
Integer 2
parcel_height Parcel Height Height of parcel. (centimeters)
Factor of cubic_meters.
Integer 3
cubic_meters CBM Cubic Meters/Volume of parcel/item. (cubic meters)
Product of parcel_width x parcel_length x parcel_height.
Float 0.000006
boxes Boxes Description of boxes. String Big medium small
cartons Cartons Number of Cartons. Integer 1
pieces Pieces Number of Pieces. Integer 1
envelopes Envelopes Number of Envelopes. Integer 1
pallets Pallets Number of Pallets. Integer 1
bins Bins Number of Bins. Integer 1
trays Trays Number of Trays. Integer 1
bundles Bundles Number of Bundles. Integer 1
rolls Rolls Number of Rolls. Integer 1
number_of_shipping_labels No. of Shipping Labels Number of copies of shipping labels to be generated. Integer 1
attachment_url Attachment URL URL link for attachment to be shown in Driver App. String https://example.com
detrack_number Detrack No. Unique Detrack number that is assigned by Detrack upon job creation. String DET123456789
status Job Status Available values:

  1. completed – Completed
  2. completed_partial – Partially Completed
  3. dispatched – In Progress
  4. failed – Failed
  5. info_recv – Info Received
  6. on_hold – On Hold
  7. return – Return
String info_recv
tracking_status Tracking Status Available values:

  1. Info Received
  2. Out for Delivery
  3. Out for Collection
  4. Completed
  5. On hold
  6. Return
String info_recv
reason Reason Reasons for job failure / Item rejection.
Edited in Settings > Delivery / Collection > Reasons.
String Recipient not in.
received_by_sent_by Received By
Sent By
Name of the signature bearer captured from the Driver App. String Bob
note Note Text entered by driver though the Driver App. String This is a note.
carrier Carrier The courier company performing the job.
For users to enter to keep track of the carrier.
Default: Settings > Organization > General > Entry in “Default Carrier”.
String ABC Logistics
pod_lat POD Latitude The Latitude of pod_address where the POD is performed. Float 1.3356456
pod_lng POD Longitude The Longitude of pod_address where the POD is performed. Float 103.9095161
pod_address POD Address The string address of where the POD is performed. From pod_lat and pod_lng String 1 Raffles Blvd, Singapore 039593
address_tracked_at Address Tracked At The last timing of address when the vehicle is tracked at. Date Time 2019-12-24T11:34:05.417+08:00
arrived_lat Arrived Latitude The Latitude where driver triggered Arrived at on Driver App.
Used in conjunction with arrived_lng.
Float 1.3356456
arrived_lng Arrived Longitude The Longitude where driver triggered Arrived at with Driver App.
Used in conjunction with arrived_lat.
Float 103.9095161
arrived_address Arrived Address The address where driver entered Arrived at with Driver App. String 1 Raffles Blvd, Singapore 039593
arrived_at Arrived At The timing when driver triggered Arrived at with Driver App. Date Time 2019-12-24T11:34:05.417+08:00
texted_at Texted At The timing when driver sends text through Driver App. Date Time 2019-12-24T11:34:05.417+08:00
called_at Called At The timing when driver calls through Driver App. Date Time 2019-12-24T11:34:05.417+08:00
serial_number Serial No. Serial No. of the job item.
Captured through Driver App.
String SN123
signature_file_url Not Shown URL to retrieve the signature image file. String https://example.com
photo_1_file_url Not Shown URL to retrieve the photo 1 image file. String https://example.com
photo_2_file_url Not Shown URL to retrieve the photo 2 image file. String https://example.com
photo_3_file_url Not Shown URL to retrieve the photo 3 image file. String https://example.com
photo_4_file_url Not Shown URL to retrieve the photo 4 image file. String https://example.com
photo_5_file_url Not Shown URL to retrieve the photo 5 image file. String https://example.com
photo_6_file_url Not Shown URL to retrieve the photo 6 image file. String https://example.com
photo_7_file_url Not Shown URL to retrieve the photo 7 image file. String https://example.com
photo_8_file_url Not Shown URL to retrieve the photo 8 image file. String https://example.com
photo_9_file_url Not Shown URL to retrieve the photo 9 image file. String https://example.com
photo_10_file_url Not Shown URL to retrieve the photo 10 image file. String https://example.com
signed_at Signed At Timing when Driver submits job completion. Date Time 2019-12-24T11:34:05.417+08:00
photo_1_at Photo 1 At Timing when Driver takes Photo 1. Date Time 2019-12-24T11:34:05.417+08:00
photo_2_at Photo 2 At Timing when Driver takes Photo 2. Date Time 2019-12-24T11:34:05.417+08:00
photo_3_at Photo 3 At Timing when Driver takes Photo 3. Date Time 2019-12-24T11:34:05.417+08:00
photo_4_at Photo 4 At Timing when Driver takes Photo 4. Date Time 2019-12-24T11:34:05.417+08:00
photo_5_at Photo 5 At Timing when Driver takes Photo 5. Date Time 2019-12-24T11:34:05.417+08:00
photo_6_at Photo 6 At Timing when Driver takes Photo 6. Date Time 2019-12-24T11:34:05.417+08:00
photo_7_at Photo 7 At Timing when Driver takes Photo 7. Date Time 2019-12-24T11:34:05.417+08:00
photo_8_at Photo 8 At Timing when Driver takes Photo 8. Date Time 2019-12-24T11:34:05.417+08:00
photo_9_at Photo 9 At Timing when Driver takes Photo 9. Date Time 2019-12-24T11:34:05.417+08:00
photo_10_at Photo 10 At Timing when Driver takes Photo 10. Date Time 2019-12-24T11:34:05.417+08:00
actual_weight Actual Weight The weight entered through the Driver App. Float 1.5
temperature Temperature The temperature entered through the Driver App. Float 1.5
hold_time Hold Time Users can enter the hold time for a job on the dashboard. Float 1.5
payment_collected Payment Collected The payment amount collected, entered through the Driver App. Float 1.5
auto_reschedule Auto Reschedule Indicates whether the job will be carried forward to the subsequent day at 12 midnight under certain conditions.
0 – disabled
1 – enabled
Boolean true
actual_crates Actual Crates The number of crates entered through the Driver App. Integer 10
actual_pallets Actual Pallets The number of pallets entered through the Driver App. Integer 10
actual_utilization Actual Utilization The number of utilization entered through the Driver App. Float 1.5
item_count Item Count Number of entries in the items array. Int 3
goods_service_rating Goods / Service Rating Goods service rating performed by your customers.
Values: 1 – 5.
Integer 5
driver_rating Driver Rating Driver rating performed by your customers.
Values: 1 – 5.
Integer 5
customer_feedback Customer Feedback Customer feedback provided by your customers. String Good job. I like the service.
eta_time ETA Time Estimated time of arrival of the job. String 12:00
live_eta Live ETA The Live ETA will be based on the differences between the ETA entered for the job form and the POD time submitted from the previous jobs. For instance, if the ETA Time of the previous job is late by 30 mins, and the ETA Time of the current job in 12:00, the Live ETA will be 12:30. Time 12:30
depot Depot Name of depot for the job. String Warehouse 1
depot_contact Depot Contact Contact number / person for the depot. String Jerry
department Department Department to deliver to for the job. String Marketing
sales_person Sales Person The sales person for the job. String Adam
identification_number Identification No. Identification no for the recipient. String ID123
bank_prefix Bank Prefix Prefix for the bank no. String BK123
run_number Run No. The run number which the job belongs to. String 1
head_to_delivery_at Not Shown Timing when the driver triggers the “Head to location” in Driver App for Delivery job. Date Time 2019-12-24T13:40:00.995+08:00
head_to_pick_up_at Not Shown Timing when the driver triggers the “Head to location” in Driver App for Collection job. Date Time 2019-12-24T13:40:00.995+08:00
pod_at Not Shown The timing when the POD was performed on driver’s app. Date Time 2019-12-24T11:34:05.417+08:00
pod_time POD Time The timing when the POD was performed on driver’s app. Time 11:34 AM
job_price Job Price Price of the job. String 100
insurance_price Insurance Price Price of insurance. String 100
insurance_coverage Insurance Coverage The Insurance coverage for the job. Boolean true
total_price Total Price Total price amount for the job. String 100
payer_type Payer Type To indicate the payer of the job. Acceptable values:

  1. Buyer
  2. Seller
String Buyer
remarks Remarks Remarks for the job. String Peter wish to extend the payment.
items_count Items Count Number of entries in the Item Details list. Integer 10
service_type Service Type Service type of the job. String Express delivery
warehouse_address Warehouse Address The address of the warehouse. String 61 Kaki Bukit Ave 1 Shun Li Industrial Park Singapore 417943
destination_time_window Destination Time Window The time window for the driver to arrive at delivery/collection location. String 1400 – 1500
door Door Which door for the driver to use at delivery / collection. String Backdoor
time_zone Time Zone Time zone of the job. For use if you are performing cross-zone jobs. String Singapore
priority Priority Priority of the job. Integer 1
service_time Service Time Service time to perform the job. Integer 10
created_at Not Shown Timing when the job is created. Date Time 2019-12-24T11:34:05.417+08:00
driver_mobile_number Not Shown Mobile number of the driver assigned to the job. String 912345678
reattempted Not Shown Indicates whether the job has been reattempted. Boolean true
can_reattempt Not Shown Indicates whether the job can be reattempted. Boolean true
tracking_link Tracking Link Tracking link for the job for Tap to Track feature. String https://trk.la/irS5dwz
available_statuses Not Shown statuses available for the job. Object of Strings {
“info_recv”: “Info Received”,
“dispatched”: “In Progress”,
“completed”: “Delivered”,
“completed_partial”: “Partially Delivered”,
“failed”: “Not Delivered”,
“on_hold”: “On Hold”,
“return”: “Return”
}
contactless_signature_link Not Shown URL link to contactless signature for customer to sign remotely. String https://trk.la/hQRuhLP?s=1
verification_code Not Shown Random number that is being generated for the job. For use in Driver App prior to completing / failing the job. String 1234
vehicle_type Vehicle Type Information on the type of vehicle used for servicing the job. String Truck
geofence_ack_at Geofence Acknowledged At Time when the geofence acknowledgement was performed. Related to geofence_ack_lat and geofence_ack_lng Date Time 2021-10-11T12:00:00.800+08:00
geofence_ack_lat Geofence Latitude Latitude where the geofence acknowledgement was performed. Related to geofence_ack_at and geofence_ack_lng Float 1.3371668284455491
geofence_ack_lng Geofence Longitude Longitude where the geofence acknowledgement was performed. Related to geofence_ack_at and geofence_ack_lat Float 103.91120365483371
photo_preview_ack_at Photo Preview Acknowledged At Time where the preview acknowledgement was performed. Related to photo_ack_lat and preview_ack_lng Date Time 2021-10-11T12:00:00.800+08:00
photo_preview_ack_lat Photo Preview Acknowledged Latitude Latitude where the preview acknowledgement was performed. Related to preview_ack_at and preview_ack_lng Float 1.3371668284455491
photo_preview_ack_lng Photo Preview Lnogitude Longitude where the preview acknowledgement was performed. Related to previe_ack_at and preview_ack_lat Float 103.91120365483371
mass_pod Mass POD Submission Indicates whether was the job performed completed by “Mass POD” feature in Driver App. Boolean true
pod_gps_status Vehicle GPS Status Indicates whether was the device location (GPS) being available during submission of job using the Driver App. Boolean true
pod_gps_permission Vehicle GPS Permission indicates whether was the Driver App given the permission to access location settings (GPS). Boolean true
driver_mobile_number Not Shown Phone number of the corresponding assign_to/code>. String 912345678

Only Applicable to Special Courier Mode

API Key Dashboard Field Description Data Type Example
pick_up_from Pick Up From Person to collect the item from. String Mary
pick_up_time Pick Up Time Time when the job is supposed to be collected. String 16:00
pick_up_lat Pick Up Latitude The latitude of the pick_up_address. To be used in conjunction with pick_up_lng. Float 1.3335305
pick_up_lng Pick Up Longitude The longitude of the pick_up_address. To be used in conjunction with pick_up_lat. Float 103.9573483
pick_up_address Pick Up Address The address to perform the collection. String Dummy Address1
pick_up_address_1 Pick Up Address 1 Part of “Line Pick Up Address”.
Will be concatenated into pick_up_address if pick_up_address is absent.
String Blk 123
pick_up_address_2 Pick Up Address 2 Part of “Line Pick Up Address”.
Will be concatenated into pick_up_address if pick_up_address is absent.
String Dummy Street
pick_up_address_3 Pick Up Address 3 Part of “Line Pick Up Address”.
Will be concatenated into pick_up_address if pick_up_address is absent.
String #12-456
pick_up_city Pick Up City Part of “Line Pick Up Address”.
Will be concatenated into pick_up_address if pick_up_address is absent.
String Singapore
pick_up_state Pick Up State Part of “Line Pick Up Address”.
Will be concatenated into pick_up_address if pick_up_address is absent.
String Singapore
pick_up_country Pick Up Country Part of “Line Pick Up Address”.
Will be concatenated into pick_up_address if pick_up_address is absent.
String Singapore
pick_up_postal_code Pick Up Postal Code Part of “Line Pick Up Address”.
Will be concatenated into pick_up_address if pick_up_address is absent.
String 123456
pick_up_zone Pick Up Zone Zone of the pick up. String East
pick_up_assign_to Not Shown The driver being assign to perform the pick-up portion of the job. String Vehicle1
pick_up_reason Pick Up Reason Reason for failing the pick-up portion of the job. String Recipient is not in.
pick_up_at Pick Up At Time when the pick-up occurred. Date Time 2020-02-27T13:34:56.619+08:00″
pick_up_photo_preview_ack_at Photo Preview Acknowledged At Time where the preview acknowledgement was performed. Related to pick_up_photo_preview_ack_lat and pick_up_photo_preview_ack_lng Date Time 2021-10-11T12:00:00.800+08:00
pick_up_photo_preview_ack_lat Photo Preview Acknowledged Latitude Latitude where the preview acknowledgement was performed. Related to pick_up_photo_preview_ack_at and pick_up_photo_preview_ack_lng Float 1.3371668284455491
pick_up_photo_preview_ack_lng Photo Preview Lnogitude Longitude where the preview acknowledgement was performed. Related to pick_up_photo_preview_ack_at and pick_up_photo_preview_ack_lat Float 103.91120365483371

items Array

Corresponds to the entries in the Items Details

API Key Dashboard Field Description Data Type Example
id Not Shown Unique identifier created by Detrack for the item. String 5b22055510c92b1a046ece06
sku SKU Stock keeping unit. Usually it is the item barcode. String SKU123
purchase_order_number Item P.O. No. Item purchase order number. String PO123
batch_number Item Batch No. Item batch number. String Batch123
expiry_date Expiry Date Expiry date of item. String 2019-12-24
description Item Description Description of the item. String Apple
comments Comments Comments of the item. String Black and juicy.
quantity Quantity Number of items. Integer 10
unit_of_measure Unit of Measure The measuring unit for the item e.g. box, kg, each, pkg String EA
checked Item Checked Will be check if driver uses the driver’s app to check if item belongs to that job based on SKU. Boolean true
actual_quantity Actual Quantity The quantity entered by the driver through the driver’s app under the job > items. Integer 10
inbound_quantity Inbound Quantity For inbound items, e.g. to indicate that the items has yet to finish processing after job completion. Integer 10
unload_time_estimate Unload Time Estimate Estimated time taken to unload items for delivery/collection. Integer 10
unload_time_actual Unload Time Actual The actual time taken to unload items for delivery/collection. Integer 10
follow_up_quantity Follow Up Quantity For follow up quantity after completing the job. Integer 10
follow_up_reason Follow Up Reason Reason for follow up items. String Reason1
rework_quantity Rework Quantity For changing of item quantity after completing the job. Integer 10
rework_reason Rework Reason Reason for reworking the quantity. String Reason1
reject_quantity Reject Quantity The number of the rejected item. Integer 10
reject_reason Item Reject Reason The reason why the item was rejected. Can be edited under Settings > Delivery / Collection > Reasons. String Reason1
weight Item Weight The weight of the item. Integer 10
serial_numbers Item Serial No. Item serial number captured through Driver App. String SN123
serial_numbers_list Item Serial No. serial_numbers in array format. List of Strings SN123, SN234
photo_url   URL to retrieve the photo of this entry. Strings https://www.example.org

milestones Array

Corresponds to the “history” of the job.

API Key Dashboard Field Description Data Type Example
status Status Available Values:

  1. info_recv
  2. out_for_delivery
  3. completed
  4. completed_partial
  5. failed
  6. on_hold
  7. return
  8. head_to_delivery
  9. picked_up
  10. head_to_pick_up
String info_recv
assign_to Driver The assign_to of the event. String Driver1
reason Reason Reason for failing the job, or when signature is not being captured for the job.    
pod_lat Not Shown Latitude of pod_address captured through Driver App when the event happens. Float 1.3369258
pod_lng Not Shown Longitude pod_address Float 103.910547
pod_address Not Shown String address from pod_lat and pod_lng captured through Driver App when the event happens. String 61 Kaki Bukit Ave 1, Singapore 417943
pod_at Proof Timing when the event was performed.
Usually the same as created_at, unless manual POD was performed for the job.
Date Time 2019-12-24T13:55:30.583+08:00
created_at Date / Time Timing when the event was created.
Usually the same as pod_at, unless manual POD was performed for the job.
Date Time 2019-12-24T13:55:30.583+08:00
user_name User Name of the user performing the action that triggers this change of event. String User1

milestones Logic

For normal mode

  1. Info Received will be added when job is created.
  2. Heading to delivery (delivery) / pick up (collection) will be added when driver triggers headning to.
  3. When job status (in_transit/dispatched/completed/failed ..etc) has changed, milestone will be added.
  4. When driver has changed and “Add vehicle change milestone” is enabled, milestone will be added.

For special courier mode

  1. Milestone will be added based on the job status when job is created.
  2. Heading to delivery (delivery) / pick up (collection) will be added when driver triggers headning to.
  3. When job status (dispatched/picked_up/completed/failed ..etc) has changed, milestone will be added.
  4. When driver has changed and “Add vehicle change milestone” is enabled, milestone will be added.

Delivery Dynamics:
Your Detrack Insider!

Subscribe to our newsletter to get tips delivered straight to your inbox