Skip to Content
FastracDocs

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 schedule as the rate's scheduledAt, or none.

Pickup or drop-off

Set the method per shipment in shippingOptions.fulfillmentMethod when you call POST /b2b/orders.

fulfillmentMethodWhat happensStatus after booking
PICKUPThe courier collects the parcel from the sender's address.PENDING_PICKUP
DROPOFFYou 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 serviceTypeDefault
INSTANTPICKUP
SAMEDAY, NEXTDAY, REGULAR, CARGODROPOFF

Not every service offers both. Check the rate before you choose:

Rate fieldIf false and you ask for it
isSupportPickup400 Courier service '…' (…) does not support pickup.
isSupportDropOff400 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.

Part of a shipment in POST /b2b/orders
{
  "shippingRateCode": "SR-Q24DXCOA",
  "shippingOptions": {
    "fulfillmentMethod": "PICKUP",
    "schedule": "2026-11-21T09:00:00+07:00"
  }
}
RuleDetail
Time zoneInclude an offset. A time without an offset is read as Jakarta time (WIB, UTC+7).
Earliest timeAt least 15 minutes after now, in WIB. Earlier → 400 with code: "PICKUP_SCHEDULE_EXPIRED".
DefaultOmitted: now + 15 minutes (WIB). For Lalamove, Dash and Blitz instant: the quoted time, or as soon as possible.
PaxelPaxel 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:

InboundResponse: data.shipments[0]
{
  "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 withOrder scheduleResult
scheduledAt: "2026-11-21T09:00:00+07:00"OmittedBooked 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 time400 PICKUP_SCHEDULE_NOT_QUOTED
No scheduledAt (as soon as possible)Omitted, or a time within the next 60 minutesBooked as soon as possible
No scheduledAt (as soon as possible)A later time400 PICKUP_SCHEDULE_NOT_QUOTED

Blitz instant only quotes "as soon as possible", so send no schedule for it.

400 PICKUP_SCHEDULE_NOT_QUOTED
{
  "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

Statuscode or messageCauseFix
400PICKUP_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 nowSend a later time, or omit schedule. For quoted-time couriers, quote again.
400PICKUP_SCHEDULE_NOT_QUOTEDLalamove, Dash or Blitz instant: schedule differs from the rate's scheduledAtOmit schedule, send the quoted time, or quote again for the new time.
400Pickup shipments require sender coordinates.REGULAR service, PICKUP, no sender.coordinateAdd sender.coordinate, or use DROPOFF.
400Courier service '…' (…) does not support pickup.PICKUP on a service with isSupportPickup: falseUse DROPOFF, or pick another service.
400Courier service '…' (…) does not support dropoff.DROPOFF on a service with isSupportDropOff: falseUse PICKUP, or pick another service.
400shipments.0.shippingOptions.schedule must be a valid ISO 8601 date stringschedule is not a date-timeSend 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?

On this page