Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: PICKUP activated.

...

NameMandatoryStandard (if empty)DescriptionMax lengthTypeExample
ORDER_ID

External order ID
Typically identifies each customer for this distribution.

30StringA345
ORDER_LINE_ID

External order line ID
Typically identifies each package for this distribution. If given, it must be unique. 

30String891837
PICKUP
NOrder-lines are normally deliveries, but indicate here if an order-line is a pickup. Driver can then see different action-buttons. 
Status
colourYellowGreen
titleCOMING SOONNEW
1String (Y/N)Y
TIMEWINDOW_START
Start time of routeCriteria for when the customer can receive the package (start time)
String/text "HH:MM" or "HHMM"17:00
-or-
1700
TIMEWINDOW_STOP
End time of routeCriteria for when the customer can receive the package (end time)
String/text "HH:MM" or "HHMM"19:00
-or-
1900
PRODUCT(tick)
Product name/number (must be recognised by driver)100String/textMatkasse liten
PRODUCT_COUNT
1Product quantity
Integer1
PARCEL_NUMBER

Used for scanning. The number that will represented as a barcode on the parcel. Each non-blank value must be unique (within the file).
-or-

Status
colourYellow
titlePLANNED
 Just ensure that PARTS of the numbers matches the barcode (used for scanning standard parcels). Use "?" as a wildcard (can be any single character).
When containing wildcards you may of course have multiple rows with same PARCEL_NUMBER.

20String12345ABC900987654321
-or-
???????????987654???
CUSTOMER_NAME(tick)
Customer name100String/textOla Hansen
CUSTOMER_CO

Optional Care Of (if the carrier should look for other names when delivering)50String/textFam. Olsen
CUSTOMER_DIRECTIVE

Notes about how the delivery should take place. Can be a note from the customer about where to deliver the package or what to do if they are not home.

To preserv linebreaks, use "\n" so the driver sees the message the same way it was written.

Sanitize
Remember to sanitize the data. Would be wise to use quotes and to replace double-quotes in the comment with single-quote.

Example:
This unquoted with problem-characters (;) is INVALID:
User's; "comment"
By adding quotes and replace double with single it's VALID:
"User's; 'comment'"

Note: For this field to be helpful, the drivers must understand the customer's language.

2000String/text

"Hvis ikke vi er hjemme, så ring på hos <nabo-navn> på samme adresse, og hun vil slippe dere inn. \nSett kassen i boden i 4.etg. Takk."

CUSTOMER_PHONE_1

Customer's primary phone (with or without country code), so the driver easily can contact the customer.
Assumed to be a mobile number (so we can send SMS to it).

12String/text004792929393
CUSTOMER_PHONE_2

Customer's secondary phone (with or without country code), so the driver easily can contact the customer.
12String/text92929393
ADDRESS(tick)
Street address100String/textMøllergata 3 A
ZIP(tick)
Zip (can be integer or string)
String/text or Integer0366
CITY(tick)
City30String/textOSLO
LATITUDE

Optional - if you want to use your own coordinates, else we will perform geocoding.


Double59.915165 -or- 59,915165
LONGITUDE

Optional - if you want to use your own coordinates, else we will perform geocoding.


Double10.743319 -or- 10,743319
ROUTE_NAME

Optional - If you want full control of how the routes are made, you can skip the optimization and use your own routes. You can still optimize the order within the routes afterwards.

Manual or Automatic
If this column it not used the customers will automatically re-user the last used route for this address.

NOTE: The planner will always get the option between creating these routes or to ignore them and start a fresh optimisation. (and can also easy start over with the imported customer-data).


String/textRøa
-or-
201
WEIGHT

Weight of the package (gram).


Integer250
HEIGHT

Status
colourGrey
titleNot implemented
Volume. Height/width/depth. All dimensions must be given to use (cm).


Integer30
WIDTH

Status
colourGrey
titleNot implemented
Volume. Height/width/depth. All dimensions must be given to use (cm).

Integer40
DEPTH

Status
colourGrey
titleNot implemented
Volume. Height/width/depth. All dimensions must be given to use (cm).  


Integer20

...