DoorDash Drive 接続:見積・配送手配・ステータス確認
DoorDash Developer Portal の Credentials ページで Developer ID、Key ID、Signing Secret をコピーし、Integration で集荷方法をどちらか設定します(集荷住所、または External Business ID と External Store ID のペア)。テスト後、DoorDash Drive の配送を依頼できます。
DoorDash コネクタは、このシステムから DoorDash Drive の地域配送を依頼するためのものです。見積の取得、配送の作成、配送ステータスの確認、配送のキャンセルができます。ラストマイル配送専用の接続です。DoorDash マーケットプレイスの注文をこのシステムに取り込むことはせず、メニューや店舗カタログの同期もしません。見積と配送は、ご自身の DoorDash Drive アカウントと集荷場所で実行されます。
前提条件#
- DoorDash Drive アカウントと、DoorDash Developer Portal へのアクセス。Credentials ページに Developer ID、Key ID、Signing Secret が表示されます。
- 集荷場所の指定方法が分かっていること:店舗または倉庫の 1 行の集荷住所か、DoorDash に登録済みの店舗をその External Business ID と External Store ID で指定するかのどちらかです。住所と ID ペアは代替案です。開始前にどちらを使うか決めてください。
- 集荷時に表示したい場合、その集荷店舗名と、配達員が集荷時に電話できる番号。たとえば店舗名とその直通番号です。
認証情報の取得#
- DoorDash Developer Portal にログインし、Credentials ページを開きます。
- そのページに表示される Developer ID をコピーします。これは開発者アカウントを識別し、接続がリクエストに署名する際に使う 3 つの値の 1 つです。
- 同じ Credentials ページに表示される Key ID をコピーします。
- 同じ Credentials ページに表示される Signing Secret を全文コピーします。Key ID と Signing Secret はペアであり、Signing Secret は base64 値で、接続はこれを使ってリクエストごとに短期間有効なトークンに署名します。Key ID と同じページからコピーし、別のキーペアのものを使わないでください。
Integration への入力#
- Integration → コネクタマーケットプレイス → DoorDash → 新規接続 を開きます。
- developer_id、必須、Developer ID:DoorDash Developer Portal → Credentials ページの Developer ID を貼り付けます。
- key_id、必須、Key ID:同じ Credentials ページの Key ID を貼り付けます。
- signing_secret、必須、Signing Secret:同じ Credentials ページの Signing Secret を全文貼り付けます。パスワード型のフィールドで、秘密情報として保存されます。
- 次に集荷方法を 1 つ選びます。方法 A、住所:pickup_address に店舗または倉庫の 1 行の集荷住所(例:901 Market Street, San Francisco, CA 94103, US)を入力し、2 つの外部 ID フィールドは空欄にします。
- 方法 B、登録済み店舗:pickup_address は空欄にし、pickup_external_business_id(External Business ID)と pickup_external_store_id(External Store ID)の両方に、DoorDash に登録済みの店舗の ID を入力します。2 つの ID は必ずペアで入力してください。1 つだけでは機能しません。登録済み店舗の住所が集荷住所の代わりになるのは、両方の ID が揃った場合だけです。
- pickup_business_name、任意、集荷店舗名:配達員に表示される集荷先の名称。たとえば店舗名です。pickup_phone_number、任意、集荷連絡先電話番号:配達員が集荷時に電話できる番号。たとえば +16505550100 です。
- user_agent、任意、User-Agent:ほとんどの場合は空欄で構いません。接続は既定値の Docklify/1.0 を使用します。
接続テスト#
接続テストをクリックします。テストはまず 3 つの認証情報(developer_id、key_id、signing_secret)が揃っているかを確認し、いずれかが未入力の場合はリクエストを送らずに停止します。3 つが揃っている場合、それらの値から短期間有効なトークン(5 分間)に署名し、存在しない配送 docklify-probe-nonexistent を検索します。DoorDash が 404 を返すのが合格です。署名付きトークンが受け入れられ、架空の配送だけが存在しないという意味であり、このテストの想定結果は 404 で、修正すべきエラーではありません。401 または 403 の応答は AUTH_FAILED として報告され、これが本当の失敗です。DoorDash が署名付きトークンを拒否したということです。認証情報を保存する前にテストを実行すると、結果はシミュレーションによる確認のみとなります。実際の認証情報を保存して再テストしてください。テストは配送を作成せず、集荷住所や外部 ID ペアも確認しません。そのため、集荷設定が間違っていてもテストは合格し、見積や配送作成の段階で初めて失敗します。
Mapping / テンプレート選択#
DoorDash Drive は注文 Mapping 不要です。配送を扱い、注文は扱いません。ここで確認するのは、入力手順の集荷設定と、各リクエストに含まれる配送フィールドです。集荷は pickup_address から、または登録済み店舗(External Business ID と External Store ID)から取得され、各配送リクエストはこのシステムの出荷にある配送先住所、連絡先、品目を使用します。有効化前に、実際の見積を 1 件と、ご自身の住所宛てのテスト配送を 1 件作成し、集荷名、集荷電話番号、配送先の詳細を出荷と並べて確認してください。
有効化#
有効化後、このシステムの出荷から DoorDash Drive の配送を依頼できます。接続は配送を見積もり、見積の承認後に配送を作成し、配送ステータスを出荷に保持し、まだ集荷されていない配送をキャンセルできます。無人で任せる前に、最初の実際の配送を Runs / Logs で確認し、集荷と配送先の詳細を DoorDash と照合してください。
この接続が行わないこと:DoorDash マーケットプレイスの注文をこのシステムに取り込まず、メニューや店舗カタログを同期せず、配達員の報酬や DoorDash の請求を代わりに精算しません。この接続経由で送る出荷について、DoorDash Drive の配送の見積、作成、追跡、キャンセルのみを行います。
よくある質問#
テストで 404 が出た。失敗ですか?
いいえ。DoorDash Drive では、その 404 が成功の合図です。テストは存在しない配送 docklify-probe-nonexistent をわざと検索します。見つからないという回答が返るのは、DoorDash が developer_id、key_id、signing_secret から署名したトークンを受け入れ、架空の配送だけを拒否したという意味です。
テストは合格として、有効化に進んでください。401 または 403 が返り AUTH_FAILED と報告された場合だけが本当の失敗です。
テストが AUTH_FAILED、401 または 403 で失敗する
DoorDash が署名付きトークンを拒否しました。3 つの値のいずれかが一致していないということです。developer_id、key_id、signing_secret のコピーミスか、貼り付けた Signing Secret が貼り付けた Key ID とペアになっていません。両者は Credentials ページで一緒に発行されるペアです。
DoorDash Developer Portal → Credentials ページに戻り、同じページから 3 つの値をコピーし直してください。Developer ID を developer_id に、Key ID を key_id に、その Key ID とペアになる Signing Secret を全文 signing_secret に入力し、再テストします。
認証情報が不足していて、テストが何も送らずに停止する
テストは 3 つの認証情報の値すべてを使ってトークンに署名するため、1 つでも欠けていると開始できません。developer_id、key_id、signing_secret が揃わなければ署名に使うものがなく、テストは成功するはずのないリクエストを送る代わりに停止します。
DoorDash Developer Portal → Credentials ページから 3 フィールドすべてを入力し、接続を保存して再テストしてください。認証情報なしのテストはシミュレーション確認だけです。実際の結果には実際の値を保存してください。
2 つの外部 ID のうち 1 つだけ入力したら、集荷が使えない
External Business ID と External Store ID はペアでのみ機能します。登録済み店舗の住所が集荷住所の代わりになるのは、両方の ID が揃った場合だけです。ID が 1 つだけでは、接続には完全な登録済み店舗がなく、住所を空欄にしていた場合は集荷住所もまったくありません。
どちらか 1 つを選んで完全に入力してください。登録済み店舗の場合は pickup_external_business_id と pickup_external_store_id の両方を入力するか、両方の ID フィールドを消して pickup_address に 1 行の集荷住所を入力します。その後、再度見積もりしてください。
テストは合格するが、集荷側で配送作成が失敗する
接続テストが証明するのは認証情報だけです。トークンに署名し、存在しない配送を照会します。集荷住所や外部 ID ペアは確認しないため、住所の未入力、ID ペアの不備、未登録店舗の ID ペアでもテストは合格し、実際の見積や配送でその集荷場所を使おうとした段階で初めて表面化します。
接続の集荷方法を確認してください。pickup_address に完全な 1 行住所が入力されているか、DoorDash に登録済みの店舗について両方の外部 ID フィールドが入力されているか。混在させたり、ID を 1 つだけにしたりしないでください。修正して保存し、配送を作成する前に再度見積してください。
配達員が違う場所に行く、または集荷時に誰にも連絡が取れない
配達員は、接続が集荷用に送信する情報に従います。集荷住所(または外部 ID ペアの背後にある登録済み店舗)、集荷用に表示される pickup_business_name、配達員が電話できる pickup_phone_number です。これらのいずれかが間違っているか不足していると、配達員は違う場所、違う名称、またはつながらない番号を受け取ります。
接続の集荷フィールドを修正してください。集荷住所または登録済み店舗の ID ペア、pickup_business_name は集荷現場のスタッフが認識できる名称、pickup_phone_number は集荷時間帯に応答がある番号にします。保存すると、修正した値は次の配送から使われます。すでに作成済みの配送は、作成時の集荷詳細のままです。