Lieferungsfelder und Multi-Stop-Payloads

Eine Lieferung wird aus einem zuvor kalkulierten Angebot oder direkt aus einer vollständigen Route erstellt.

Route kalkulieren#

Senden Sie an POST /partner/v1/quotes:

• pickup und dropoff mit address, latitude und longitude.
• vehicle_type_id aus GET /partner/v1/vehicle-types.
• Optional bis zu zehn stops in der Reihenfolge, in der sie angefahren werden sollen.
• Optional extras mit extra_id, option_id und quantity.

Das Angebot enthält eine quote_id, Preis, Distanz, Dauer und valid_until. Eine Quote ist fünf Minuten gültig.

Lieferung erstellen#

Senden Sie an POST /partner/v1/deliveries entweder eine gültige quote_id oder die vollständige Route. Beides darf nicht kombiniert werden.

Zusätzlich erforderlich ist contact mit name und phone; email ist optional. Unterstützt werden außerdem:

• external_id als Ihre eigene eindeutige Referenz.
• notes für operative Hinweise.
• scheduled_at als RFC-3339-Zeitstempel.
• test_scenario mit courier_cancelled oder delivery_failed bei Testschlüsseln.

Jeder Create-Request benötigt einen eindeutigen Idempotency-Key-Header.

Multi-Stop-Regeln#

• pickup und dropoff nicht in stops wiederholen.
• Zwischenstopps in der tatsächlichen Fahrreihenfolge senden.
• Pro Route sind maximal zehn Zwischenstopps zulässig.
• Adressen immer zusammen mit gültigen Koordinaten übertragen.

Die API übernimmt die übermittelte Reihenfolge unverändert für Dispatch, Tracking und ETA-Berechnung.