Uber Developers

Delivery Window

Delivery windows are time blocks with start and end times that Uber Direct use as guidance to ensure timely and fulfilled deliveries. These windows determine when we request couriers to fulfill the specified delivery orders. Delivery windows can be set using either the ASAP (As Soon As Possible) or Scheduled (Merchant-driven) methods. In the delivery process, two types of windows are essential:

Pickup Windows: These specify the start and end times for when we want the courier to arrive at the pickup location.
- pickup_ready_dt: Beginning of the pickup window when an order is ready and must be picked up. Send this field when preparation time is known. Must be less than 30 days in the future.
- pickup_deadline_dt: End of the pickup window when an order may be picked up. Must be at least 10 mins later than pickup_ready_dt and at least 20 minutes in the future from now.
Drop Off Windows: These specify the start and end times for when we want the courier to arrive at the drop-off location.
- dropoff_ready_dt: Beginning of the dropoff window when an order must be dropped off. Must be less than or equal to pickup_deadline_dt.
- dropoff_deadline_dt: End of the dropoff window when an order must be dropped off. Must be at least 20 mins later than dropoff_ready_dt and must be greater than or equal to pickup_deadline_dt.

The availability of delivery options during checkout depends on the choices made by you and need to be set in the Create Quote and Create Delivery API call. You can offer ASAP (As Soon As Possible) delivery, which can range from being as soon as 30 minutes after order placement to up to 30 days into the future (Scheduled Delivery).

Note: Optimal delivery windows may vary depending on the use case of each merchant. Please ensure adequte testing to determine your optimal configuration.

¶ ASAP

	Description	Values
On Demand	Use when the items are packed and ready for immediate delivery.	Order Create: t0 (today)_{^{pickup_ready_dt: Optional (if prep time required then t0 + prep time, otherwise leave blank) pickup_deadline_dt: Leave Blank dropoff_ready_dt: Leave Blank dropoff_deadline_dt: Leave Blank}}

Guidance:

Drop Off expectation is < 90 minutes in the future from the order creation time.
Use when the items are packed and ready for immediate delivery.
If you require prep-time, provide a pickup_ready_dt timestamp. The courier will arrive around the pickup_ready_dt.

¶ Scheduled Delivery

	Description	Values
Same Day/Next Day	Use when the customer selects a delivery window for delivery by the end of current date or on a future date	Order Create: t0 (today) Earliest scheduled delivery time: t1 (today/future date) _{^{pickup_ready_dt: at least t0 + 60 min pickup_deadline_dt: at least pickup_ready_dt + 60 min dropoff_ready_dt: = equal to t1, must be <= pickup_deadline_dt dropoff_deadline_dt: at least dropoff_ready_dt + 240 min}}

	Description	Values
Windows	Use when the customer selects a delivery window in the future (faster than end of day)	Order Create: t0 (today) Earliest scheduled delivery time: t1 (today) _{^{pickup_ready_dt: at least t0 + prep time pickup_deadline_dt: at least pickup_ready_dt + 30 min dropoff_ready_dt: equal to t1, must be <= pickup_deadline_dt dropoff_deadline_dt: at least pickup_ready_dt + 90 min and at least t1 + 60min}}

Guidance:

Drop Off expectation is >= 90 minutes in the future from the order creation time.
dropoff_deadline_dt should be set 2 hours before the carrier cutoff time for return-eligible trips.
The above scenario depicts the pickup_ready_dt timestamp if you require prep time (staging, pick and pack).
Scheduled date must be less than 30 days in the future.