Pickup times and schedules

You can define daily or weekly pickup times and schedules to specify when customers can pickup items at the node level. PICK schedules restrict customer pickups to specific time windows throughout the day. Calculation APIs respect these schedules to determine the earliest pickup time and the latest pickup time or an order

Default behavior when no schedules exist

If no pickup schedules are configured, the system assumes that pickup is available all day. In this case, the earliest pickup time might start from midnight (00:00) of the same day, subject to capacity and cutoff constraints.

Important: Cutoff times can still override this default and push pickup to the next day if the request arrives after the cutoff.

Defining pickup schedules

You can define daily pickup windows by using node-level calendars. Each day can have one or more time ranges, for example, 8:00 AM to 17:00 PM. Days without entries indicate no pickup availability.


{
  "validFromDateIncl": "2000-01-01",
  "validToDateIncl": "2999-01-01",
  "schedule": {
    "monday": [{"fromTimeIncl": "08:00:00", "toTimeExcl": "17:00:00"}],
    "tuesday": [{"fromTimeIncl": "08:00:00", "toTimeExcl": "17:00:00"}],
    "wednesday": [{"fromTimeIncl": "08:00:00", "toTimeExcl": "17:00:00"}],
    "thursday": [{"fromTimeIncl": "08:00:00", "toTimeExcl": "17:00:00"}],
    "friday": [{"fromTimeIncl": "08:00:00", "toTimeExcl": "17:00:00"}],
    "saturday": [],
    "sunday": []
  }
}

Note: Pick up is only available for a node with an active pickup schedule. When the pickup schedule expires, pickups only occur when you either re-create the recent schedule by adding new dates or you create a new schedule.

Impact on pickup times

Calculation APIs use these schedules to determine when an order becomes pickable:

If an order arrives before the next pickup window, earliest pickup aligns with the start of that window.
If an order arrives during a pickup window, earliest pickup might occur after processing time completes.
If an order arrives after the last window of the day, pickup moves to the next day’s first window.

Note: Ensure that schedules cover all intended pickup periods to avoid unintended gaps where pickup is disabled.