Deine Kurier:innen nachverfolgen
Unsere Pipeline für Marktplatz-Integration ist derzeit ausgelastet. Wir nehmen im Moment keine neuen Partner an, sind aber dabei, Self-Service-Tools für das Onboarding von Anbietern zu entwickeln. Bitte fülle das Formular für Interessenten der Marktplatz-Integration aus, um mit DoorDash in Kontakt zu treten, bevor du deine Integration erstellst.
DoorDash hat die Open-API-Vereinbarung um einen neuen Webhook erweitert. Integrationspartner:innen können diesen Webhook abonnieren, indem sie ihrem Technical Account Manager einen Endpunkt und Autorisierungsdetails mitteilen.
Der Status-Webhook für die Kurier:innen enthält eine Statusanzeige, einen Verweis auf die jeweilige Bestellung und Informationen zu den Kurier:innen. Jedes Mal, wenn ein bestimmter Kurierstatus erreicht wird, wird ein Webhook-Ereignis ausgelöst. Für eine Bestellung werden also voraussichtlich mehrere Ereignisse ausgelöst.
Indem wir POS-Anbietern Einblick in den gesamten Lebenszyklus einer Bestellung geben, ermöglichen wir ihnen, ihre betriebliche Effizienz folgendermaßen zu steigern:
- Durchführung letzter Handgriffe bei einer Bestellung, kurz bevor der:die Kurier:in das Geschäft betritt, bei gleichzeitiger Sicherstellung der Essensqualität (Verpackung fertigmachen, Eiswürfel aus dem Gefrierschrank holen usw.).
- Überblick über den aktuellen Status einer Bestellung, sodass keine Notwendigkeit besteht, den Support zu kontaktieren
- Priorisierung laufender Bestellungen und Abschluss der Bestellung mit dem:der zuerst eintreffenden Kurier:in
- Verbesserte Erfahrung bei der Übergabe der Bestellung durch die Sichtbarkeit der Kurierdetails
Webhook-Format
dasher_status: String-Wert, der den aktuellen Kurierstatus angibt. Werte umfassen dasher_confirmed, arriving_at_store, arrived_at_store, dasher_out_for_delivery.
external_order_id: eindeutige UUID der von DoorDash an den Anbieter gesendeten Bestellung
client_order_id: merchant_supplied_id aus der Payload der Bestellbestätigung. Wenn ein Anbieter die Bestellung bestätigt, kann er seine interne Bestell-ID im Feld merchant_supplied_id angeben, dann speichern wir diesen Wert als client_order_id. Dies ist der Wert, den wir in der Payload als client_order_id zurücksenden. Wenn dieser Wert während der Bestellbestätigung nicht angegeben wird, wird er in der Payload auf null gesetzt.
created_at: Zeitstempel des Kurierstatus-Ereignisses
location_id: die vom Anbieter angegebene Kennung eines Geschäfts
Phone_number: verborgene Telefonnummer des:der Kurier:in (Hinweis: Der:die Kurier:in ist nur erreichbar, wenn der Anruf über die Telefonnummer des Anbieters erfolgt.
Webhook-Payload
Unten ist eine Beispiel-Payload:
{
"event": {
"type": "dasher_status_update",
"status": "<SUCCESS> OR <FAILURE>",
"reference": "<reference_uuid>"
},
"created_at": "2021-06-02T17:41:29.996321Z",
"delivery": {
"external_order_id": "7424215690108_2",
"client_order_id": "12321444",
"location_id": "123852",
"dasher_status": "arrived_at_store",
"dasher": {
"phone_number": "(586) 381-6148",
"first_name": "Jude",
"last_name": "D.",
"vehicle": {
"color": "",
"make": "Dodge",
"model": "Dakota"
}
}
}
}
Antwort- und Fehlercodes
Sobald ein Webhook eingeht, wird vom Anbieter erwartet, dass er die unten angegebenen Antwortcodes zurückgibt.
| Statuscode | Details |
|---|---|
| 200 | Mit der Rückgabe des Status 200 wird angezeigt, dass die Daten erfolgreich erhalten wurden. |
| 401 | Unautorisiert; DoorDash hat kein Authentifizierungstoken für diesen Endpunkt. |
| 403 | Verboten; DoorDash hat keinen Zugriff auf diesen Endpunkt. |
| 500 | Interner Serverfehler – auf der Mx-Seite ist etwas schiefgelaufen. |
| 503 | Dienst nicht verfügbar – Mx-Endpunkt ist teilweise oder vollständig ausgefallen. |