5.8 Order Object

Each order in the scenario is represented by an order object, which has the following fields:

  1. Field: id
    Required: Yes.
    Type: String.
    Description: the unique identifier for the order. An order’s identifier also acts as an attribute name.
  2. Field: name
    Required: No.
    Type: String.
    Description: A descriptive name for the order.
  3. Field: customerName
    Required: No.
    Type: String.
    Description: The name of the order’s customer.
  4. Field: tags
    Required: No.
    Type: Array of strings.
    Description: Client-specific information associated with the order. This field is ignored by the optimiser.
  5. Field: attributes
    Required: No.
    Type: Array of strings.
    Description: An array containing the names of any attributes the order has.
  6. Field: pickup_location
    Required: Yes.
    Type: String.
    Description: The pickup location for the order. Must match the id of a location specified in a location object.

    7.Field: pickup_name
    Required: No.
    Type: String.
    Description: A descriptive name for the pickup.
  7. Field: earliest_pickup_time
    Required: No.
    Type: String (HH:MM).
    Default: null (meaning no earliest pickup time).
    Description: Earliest time the order can be picked up.
  8. Field: latest_pickup_time
    Required: No.
    Type: String (HH:MM).
    Default: null (meaning no latest pickup time).
    Description: Latest time the order can be picked up.

    10.Field: pickup_time_windows
    Required: No.
    Type: Array of time window objects.
    Default: null (meaning the pickup can occur at any time).
    Description: Pickup time windows for the order. (See Order Time Windows in section x16-380002.122.12.) An empty array is treated as if the value were null.
    11.Field: pickup_soft_time_windows
    Required: No.
    Type: A soft time window object.
    Default: null (meaning no soft pickup time windows).
    Description: An object that contains an array of soft time windows for the order’s pickup as well as associated penalties.
  9. Field: pickup_service_time
    Required: No.
    Type: String (HH:MM).
    Default: 00:00.
    Description: Service time for the pickup. (See Service Time in Section x16-380002.122.12.)

    13.Field: delivery_location
    Required: Yes.
    Type: String.
    Description: The delivery location for the order. Must match the id of a location specified in a location object.
    14.Field: delivery_name
    Required: No.
    Type: String.
    Description: A descriptive name for the delivery.
  10. Field: earliest_delivery_time
    Required: No.
    Type: String (HH:MM).
    Default: null (meaning no earliest delivery time).
    Description: Earliest time the delivery can be made.
  11. Field: latest_delivery_time
    Required: No.
    Type: String (HH:MM).
    Default: null (meaning no latest delivery time).
    Description: Latest time a delivery can be made.
  12. Field: delivery_time_windows
    Required: No.
    Type: Array of time window objects.
    Default: null (meaning the delivery can occur at any time).
    Description: Delivery time windows for the order. An empty array is treated as if the value were null. (See Order Time Windows in section x16-380002.122.12.)
  13. Field: delivery_soft_time_windows
    Required: No.
    Type: A soft time window object.
    Default: null (meaning no soft delivery time windows).
    Description: An object that contains an array of soft time windows for the order’s delivery as well as associated penalties.

    19.Field: delivery_service_time
    Required: No.
    Type: String (HH:MM).
    Default: 00:00.
    Description: Service time for the delivery. (See Service Time in Section x16-380002.122.12).
    20.Field: maximum_duration
    Required: No.
    Type: String (HH:MM).
    Default: null (This means there is no maximum duration).
    Description: The maximum duration of the order.
    21.Field: weight
    Required: No.
    Type: Number.
    Default: 0.
    Description: The weight of the order consistent with vehicle maximum weights. Must be nonnegative.
    22.Field: volume
    Required: No.
    Type: Number.
    Default: 0.
    Description: The volume of the order consistent with vehicle maximum volumes. Must be nonnegative.
  14. Field: assign_cost
    Required: No.
    Type: Number.
    Default: 0.
    Description: The assign cost for the order.

    24.Field: hidden_assign_cost
    Required: No.
    Type: Number.
    Default: 0.
    Description: The hidden assign cost for the order.
    25.Field: revenue
    Required: No.
    Type: Number (nonnegative).
    Default: 0.
    Description: The revenue earned for servicing this order.
  15. Field: vehicle_assign_cost
    Required: No.
    Type: Array of vehicle cost objects.
    Default: No vehicle-specific assign costs.
    Description: The vehicle-specific assign costs for the order.
  16. Field: vehicle_hidden_assign_cost
    Required: No.
    Type: Array of vehicle cost objects.
    Default: No vehicle-specific hidden assign costs.
    Description: The vehicle-specific hidden assign costs for the order.
  17. Field: vehicle_preference
    Required: No.
    Type: Array of vehicle preference objects.
    Default: No vehicle-specific preferences.
    Description: The vehicle-specific rewards for the order.
  18. Field: allow_splitting
    Required: No.
    Type: Boolean.
    Description: If set to TRUE, then this order can be split according to the order splitting strategy.
    Note: The pickup and delivery locations must also allow splitting for this to take effect.