ダッシャーの追跡
弊社のマーケットプレイス統合パイプラインは、現在上限に達しています。加盟店オンボーディング用セルフサービスツール開発する当面の間は、新しいパートナーを受け付けておりません。統合の構築前にDoorDashにお問い合わせいただくには、 マーケットプレイス統合に関するお問い合わせ フォームにご入力ください。
Open API 契約が、新しい Webhook の追加により強化されました。統合パートナー様は、担当の技術テクニカルアカウントマネージャーにエンドポイントと認証の詳細を提供することで、この Webhook をご利用いただけます。
ダッシャーのステータスの Webhook には、ステータスインジケータ、特定の注文への参照、ダッシャー情報が含まれています。ダッシャーが特定のステータスに達するたびに Webhook イベントがトリガーされるため、通常は、1 つの注文に対して複数のイベントがトリガーされます。
注文のライフサイクル全体に渡って注文の状況を POS 加盟店に提供することで、加盟店は以下ことを行えるようになり、運用効率が上がります。
- 料理の質を保ちながら、ダッシャーが店舗に入る直前に注文に対する最後の作業（袋に入れる、アイスクリームを冷凍庫から取り出すなど）を行うこと
- 注文の現在のステータスを把握すること（サポートへのお問い合わせが不要になります）
- 進行中の注文を優先し、最も早く到着するダッシャーによって注文を完了させること
- ダッシャーの詳細を表示することで、注文の引き渡し時のエクスペリエンスを向上させること
Webhook の形式
dasher_status: ダッシャーの現在のステータスを示す文字列値（値には、「dasher_confirmed」、「arriving_at_store」、「arrived_at_store」、「dasher_out_for_delivery」があります）
external_order_id: DoorDash から加盟店に送信された注文の一意の UUID
client_order_id: 注文確認ペイロードに含まれるmerchant_supplied_id（加盟店は、注文確定時に自社内での注文 ID を「merchant_supplied_id」フィールドに提供することができます。DoorDash は、この値を client_order_id として保存します。これは、ペイロードに含めて「client_order_id」として DoorDash から送り返す値です。注文確定時にこの値が提供されなかった場合、ペイロードではこの値が null に設定されます）
created_at: ダッシャーのステータスイベントのタイムスタンプ
location_id: 加盟店が提供した店舗の識別子
Phone_number: ダッシャーのマスキング処理された電話番号（注意: ダッシャーには店舗の電話番号から電話した場合にのみ連絡できます）
Webhook ペイロード
以下は、ペイロードの例です。
{
"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"
}
}
}
}
レスポンスとエラーコード
Webhook を受信すると、プロバイダは以下のレスポンスコードを返すことができます
| ステータスコード | 詳細 |
|---|---|
| 200 | データが正常に受信されたことを示すには、ステータス 200 を返します |
| 401 | 権限なし\: DoorDash にこのエンドポイントの認証トークンがありません |
| 403 | 禁止: DoorDash にはこのエンドポイントへのアクセス権がありません |
| 500 | 内部サーバーエラー: MX 側で何らかの問題が発生しました |
| 503 | サービス利用不可: MX エンドポイントが部分的または完全にダウンしています |