Driver QR Code Order Creation

Modified on Tue, 3 Jun at 4:50 PM

Drivers can quickly create Orders by scanning a QR code, streamlining the order entry process and reducing manual input. This feature relies on mapping the contents of the QR code to the appropriate Order fields within Dispatch Science.

Overview

QR Code Order Creation requires a predefined mapping of QR code fields to Order fields. One such mapping currently exists.

Note: Please reach out to support@dispatchscience.com to configure QR codes

QR Code Format

The QR code must follow a specific format, where each field is separated by a pipe (|). The order and structure of the fields must match the existing mapping.

Field Mapping Specification

Field	Description / Action	Stored In
Blank Field	Blank field	Not stored
Order# (Account Order#)	Reference number	Reference 2
Shipping Address 1	Primary address line	Delivery Address Line 1
Shipping Address 2–4	Additional address lines	Concatenated, comma-separated → Delivery Address Line 2 (Suite/Apt)
Shipping City	Delivery city	Delivery City
Shipping State/Province	2-letter province/state code	Delivery State/Province
Shipping ZIP/Postal Code	Postal/ZIP code	Delivery ZIP/Postal Code
Blank Field	Blank field	Not stored
Blank Field	Blank field	Not stored
Total Packages Sent	Used to calculate item quantity	Default parcel type on Account
Blank Field	Blank field	Not stored
Latitude	Optional. Used for Delivery location	Delivery Latitude (fallback: geolocation)
Longitude	Optional. Used for Delivery location	Delivery Longitude (fallback: geolocation)
Cash On Delivery Amount	COD amount	If a COD step is in the Delivery workflow, it is enabled and this value is used
Delivery Window - Earliest Time	Start time in 24h UTC format (e.g., 14:00)	Earliest Delivery Window
Delivery Window - Latest Time	End time in 24h UTC format (e.g., 18:00)	Latest Delivery Window
Shipping Instruction Lines 1–5	Special instructions	Concatenated and stored in Notes

Additional Notes

The QR code must contain all fields in the correct order, even if some are left blank.
Latitude and Longitude fields can be omitted; if so, Dispatch Science will automatically geolocate the address.
Shipping instructions (Lines 1–5) will be concatenated into the Order Notes field.
The pickup address is determined based on the geolocation of the Account’s main address relative to the driver’s current location.
The Service Level and User Name are set at the Account level—please ensure these fields are correctly configured.
Ensure the time fields for Delivery Windows are in 24-hour UTC format.