Pickup scheduling
Choose between courier pickup and drop-off, and set a pickup time the courier will accept.
- Product
- APIShipping Engine API
- Section
- Core concepts
- Reading time
- 6 min read
In short
- Each shipment is either picked up by the courier (
PICKUP) or dropped off by you at a courier counter (DROPOFF). Instant services default to pickup, all others to drop-off. - A pickup time must be at least 15 minutes ahead, in Jakarta time (WIB). Leave it out and Shipping Engine uses now + 15 minutes.
- Lalamove, Dash and Blitz instant book the time they quoted. Send the same
scheduleas the rate'sscheduledAt, or none.
Pickup or drop-off
Set the method per shipment in shippingOptions.fulfillmentMethod when you call
POST /b2b/orders.
fulfillmentMethod | What happens | Status after booking |
|---|---|---|
PICKUP | The courier collects the parcel from the sender's address. | PENDING_PICKUP |
DROPOFF | You take the parcel to a courier counter and show the airway bill. | PENDING_DROPOFF |
If you leave shippingOptions out, the default depends on the service type of the rate:
Rate serviceType | Default |
|---|---|
INSTANT | PICKUP |
SAMEDAY, NEXTDAY, REGULAR, CARGO | DROPOFF |
Not every service offers both. Check the rate before you choose:
| Rate field | If false and you ask for it |
|---|---|
isSupportPickup | 400 Courier service '…' (…) does not support pickup. |
isSupportDropOff | 400 Courier service '…' (…) does not support dropoff. |
Setting a pickup time
Send shippingOptions.schedule as an ISO 8601 date-time. It only applies to PICKUP; with
DROPOFF it is ignored.
{
"shippingRateCode": "SR-Q24DXCOA",
"shippingOptions": {
"fulfillmentMethod": "PICKUP",
"schedule": "2026-11-21T09:00:00+07:00"
}
}| Rule | Detail |
|---|---|
| Time zone | Include an offset. A time without an offset is read as Jakarta time (WIB, UTC+7). |
| Earliest time | At least 15 minutes after now, in WIB. Earlier → 400 with code: "PICKUP_SCHEDULE_EXPIRED". |
| Default | Omitted: now + 15 minutes (WIB). For Lalamove, Dash and Blitz instant: the quoted time, or as soon as possible. |
| Paxel | Paxel needs at least 60 minutes' notice. An earlier time is booked as now + 60 minutes. |
The pickup time is a request
The schedule tells the courier when the parcel is ready. Couriers plan their own routes, so the
actual pickup can be later, especially for regular services. Follow the status and the
shipment.pending_pickup / shipment.in_transit webhooks.
The order response shows the time that was booked, in WIB:
{
"fulfillmentMethod": "PICKUP",
"pickupSchedule": { "scheduledAt": "2026-11-21T09:00:00+07:00", "asSoonAsPossible": false }
}pickupSchedule is null for drop-off. It is { "scheduledAt": null, "asSoonAsPossible": true }
when the courier comes as soon as possible.
Couriers that book the quoted time
For Lalamove, Dash and Blitz instant services, the pickup time is part of the price. The courier
prices the time in the rate request's scheduledAt (or "as soon as possible" if you left it out), and
the order must keep it.
| Rate quoted with | Order schedule | Result |
|---|---|---|
scheduledAt: "2026-11-21T09:00:00+07:00" | Omitted | Booked for 09:00 WIB |
scheduledAt: "2026-11-21T09:00:00+07:00" | Same time (within one minute) | Booked for 09:00 WIB |
scheduledAt: "2026-11-21T09:00:00+07:00" | Any other time | 400 PICKUP_SCHEDULE_NOT_QUOTED |
No scheduledAt (as soon as possible) | Omitted, or a time within the next 60 minutes | Booked as soon as possible |
No scheduledAt (as soon as possible) | A later time | 400 PICKUP_SCHEDULE_NOT_QUOTED |
Blitz instant only quotes "as soon as possible", so send no schedule for it.
{
"statusCode": 400,
"code": "PICKUP_SCHEDULE_NOT_QUOTED",
"message": "Jadwal pickup tidak sesuai dengan ongkir yang dipilih. Hitung ulang ongkir dengan jadwal tersebut, atau pesan tanpa jadwal untuk pickup secepatnya.",
"quotedScheduledAt": "2026-11-21T09:00:00+07:00",
"requestedScheduledAt": "2026-11-21T11:00:00+07:00"
}To change the time, request a new rate with the new
scheduledAt and book that rate. A quoted time that is now less than 15 minutes away is rejected
with PICKUP_SCHEDULE_EXPIRED, so quote again for a later time.
Lalamove quotes expire at Lalamove too
If Lalamove's own quotation has expired, the order fails with 400
Payment failed, but order 'FSO-…' was created successfully. Reason: Tarif LALAMOVE untuk pesanan ini sudah kedaluwarsa. …
Nothing is charged. Request a new rate and create a new order.
Sender coordinates for regular pickup
A REGULAR service with PICKUP needs the exact pickup point. Send sender.coordinate, with latitude
and longitude as strings:
{
"sender": {
"name": "Toko Sinar",
"email": "[email protected]",
"whatsappNumber": "081234567890",
"coordinate": { "latitude": "-6.2087634", "longitude": "106.845599" }
}
}Without it, the order fails with 400 Pickup shipments require sender coordinates. Instant
services take the coordinates from the rate, so send them in the rate request instead. See
How shipping rates work.
Errors
| Status | code or message | Cause | Fix |
|---|---|---|---|
400 | PICKUP_SCHEDULE_EXPIRED · Pickup schedule must be at least 15 minutes ahead (Asia/Jakarta, UTC+7). | schedule (or the quoted time) is less than 15 minutes from now | Send a later time, or omit schedule. For quoted-time couriers, quote again. |
400 | PICKUP_SCHEDULE_NOT_QUOTED | Lalamove, Dash or Blitz instant: schedule differs from the rate's scheduledAt | Omit schedule, send the quoted time, or quote again for the new time. |
400 | Pickup shipments require sender coordinates. | REGULAR service, PICKUP, no sender.coordinate | Add sender.coordinate, or use DROPOFF. |
400 | Courier service '…' (…) does not support pickup. | PICKUP on a service with isSupportPickup: false | Use DROPOFF, or pick another service. |
400 | Courier service '…' (…) does not support dropoff. | DROPOFF on a service with isSupportDropOff: false | Use PICKUP, or pick another service. |
400 | shipments.0.shippingOptions.schedule must be a valid ISO 8601 date string | schedule is not a date-time | Send ISO 8601, for example 2026-11-21T09:00:00+07:00. |
All errors are returned before payment, so nothing is charged. See Errors.
Common mistakes
Sending UTC without an offset
2026-11-21T02:00:00 is read as 02:00 WIB, not UTC. Always include the offset: 2026-11-21T09:00:00+07:00 or 2026-11-21T02:00:00Z.
Changing the time on an instant rate
For Lalamove, Dash and Blitz, the pickup time is part of the price. Changing it at order time is
rejected. Quote again with the new scheduledAt.
Expecting a pickup for a regular rate by default
Regular services default to drop-off. If you want the courier to come to you, send
fulfillmentMethod: "PICKUP" and the sender's coordinates.
Was this page helpful?