メインコンテンツへスキップ

注文

Marketplace APIs are limited access

弊社のマーケットプレイス統合パイプラインは、現在上限に達しています。加盟店オンボーディング用セルフサービスツール開発する当面の間は、新しいパートナーを受け付けておりません。統合の構築前にDoorDashにお問い合わせいただくには、 マーケットプレイス統合に関するお問い合わせ フォームにご入力ください。

サンプルの注文データはどこで見つけられますか？​

サンプル注文データ

POS 注文エラーとは何ですか？​

POS 注文エラーとは、注文を POS に送信したものの、その注文が POS に投入されなかった場合に発生するエラーです。この原因としては、POS 接続の問題、商品の在庫切れ、メニューの設定ミスなど、さまざまな理由が考えられます。

お客様によるテイクアウトの注文と、ダッシャーによる通常の配達の注文を、どのように見分けられますか？​

注文ペイロードに「is_pickup」というフィールドがあります 。このフィールドは、お客様の注文がテイクアウトの場合に true になります。これに加えて、注文ペイロードに「fulfillment_type」というフィールドがあります 。このフィールドを見れば、注文がダッシャーによる配達、加盟店による配達（セルフデリバリー）、お客様によるテイクアウトのいずれであるかが分かります。

ダッシャーが対応する配達注文とセルフデリバリー（加盟店による配達）の注文との違いはどのように分かりますか？​

注文ペイロードに「fulfillment_type」というフィールドがあります 。このフィールドを見れば、注文がダッシャーによる配達、加盟店による配達（セルフデリバリー）、お客様によるテイクアウトのいずれであるかが分かります。

最大注文サイズ (バスケットサイズ) はありますか？​

数量に基づく最大注文サイズはありませんが、加盟店レベルでの最大額は設定できます。これは、加盟店のオンボーディング時に DoorDash チームによって設定可能です。設定するには、DoorDash の担当者までお問い合わせください。

注文 1 件あたりの最低注文額はありますか？​

注文の小計が$0 の場合、その注文の DoorDash での検証は失敗します。これを除き、注文あたりの最低額はありません。

スケジュール済みの注文はどのような仕組みですか？​

DoorDash は、スケジュール済みの注文を加盟店に配達手配するタイミングを、受け取り予定時刻、注文のサイズ、店舗の営業時間に応じて決定するロジックを管理しています。スケジュール済みの注文は、これに基づいていったん保留にされ、加盟店が「可能な限り早く」の注文として扱えるようになったタイミングで初めて処理が開始されます。

OpenAPI 統合を行うことで、タブレット経由で注文を受け付けることはできますか？​

OpenAPI と統合すると、タブレットを使用して注文を受け付ける必要がなくなります。タブレットはバックアップとして注文を表示するためだけに使用されます。特殊なケースでは、POS の注文投入が失敗した場合にフォールバックプロトコルとしてタブレットを使用して加盟店の設定を行うことができます。ご関心がある場合には、適正を判断するために DoorDash チームまでお問い合わせください。

加盟店に複数のメニューがある場合、注文がどのメニューから作成されたのかを確認する方法はありますか？​

現時点において、注文ペイロードに注文がどのメニューから発信されたのかを示すフラグはありません。

注文キャンセル通知の webhook を有効にするにはどうすればよいですか？​

関連する認証トークンをエンドポイントに提供し、DoorDash チームに設定を依頼する必要があります。これが設定されると、DoorDash チームはテスト注文の作成をサポートします。加盟店によって確定されると、DoorDash チームがキャンセルを開始します。その後、キャンセル通知の受信を確認することができます。

自動リリースはテイクアウトの注文でどのように機能しますか？​

お客様がデバイスで位置情報サービスを有効にしている場合、テイクアウトのフローは配達と同じです。お客様が加盟店のジオフェンスを越えると、注文のリリースがトリガーされます。お客様が位置情報サービスを有効にしていない場合は、アプリのボタンをクリックして手動でチェックインするオプションがあります。「チェックイン」ボタンをクリックすると、リリースイベントがトリガーされます。

パートナーによって処理が正常になされなかった場合、DoorDash は注文の POST を再試行しますか？​

パートナーが最初のリクエストに 5xx のレスポンスステータスを返した場合に、DoorDash は注文、注文のキャンセル、メニューのコールバックを最大 3 回、0.3 秒の間隔で再試行します。

非同期注文確認の場合は、最初のレスポンスで何らかのペイロード本文が必要ですか？​

いいえ。非同期注文確認の初期段階において必要なのは 202 ステータスだけです。注文を正常に確認するには、有効なレスポンスでフォローアップする必要があります。

注文ペイロードでは商品の価格がどのように伝えられますか？​

注文ペイロード内の商品価格は、その商品の価格に、その商品内で選択されたすべての代替品の価格を足した価格として計算されます。以下のサンプル注文において、JSON スニペットでは、ブリトー・スクラム・ボウルの価格が$5.00（メニューで指定されているとおり）であるため、注文ペイロード内のこの商品の価格は、$5.00+$0.10 [ケチャップ] +$0.00 [塩] =$5.10 として計算されます。

{
  "items": [
    {
      "extras": [
        {
          "merchant_supplied_id": "INDIVIDUAL_SAUCES",
          "name": "Signature Sauces",
          "options": [
            {
              "extra": [
                {
                  "merchant_supplied_id": "BREAKFAST_CONDIMENTS",
                  "name": "Breakfast Condiments",
                  "options": [
                    {
                      "merchant_supplied_id": "ADD_SALT",
                      "name": "Salt",
                      "price": 0,
                      "quantity": 1
                    }
                  ]
                }
              ],
              "merchant_supplied_id": "ADD_KETCHUP_INDIVIDUAL",
              "name": "KETCHUP",
              "price": 10,
              "quantity": 1
            }
          ]
        }
      ],
      "merchant_supplied_id": "26d3fce0-efd2-46d3-832c-ced5bc956401",
      "name": "Burrito Scram-Bowl",
      "price": 510,
      "quantity": 1
    }
  ]
}

注文が DoorDash、Caviar、ストアフロントのいずれで行われたかはどうすれば分かりますか？​

注文ペイロードに、注文がどのプラットフォームで行われたかを示す「experience」というフィールドがあります。

お客様が各注文時にチップを渡したかどうかはどうすれば分かりますか？​

注文ペイロードに、お客様がチップを渡した場合に 0 より大きい値になる「merchant_tip_amount」というフィールドがあります （テイクアウトの注文にのみ該当）。

注文のプロモーションはどのように送信されますか？​

特定のタイプのプロモーションに関しては、注文ペイロードで割引情報を送信できます。詳細については、担当の技術アカウントマネージャーにお問い合わせください。

お客様によるキャンセルはどのように処理されますか？​

お客様のキャンセルに関する詳細と、加盟店が受ける影響については、 こちらのキャンセルポリシーでご確認ください。

加盟店が POS 統合で注文を手動で受け入れないと、注文が失敗しますか？​

いいえ、DoorDash から POS へ送信された注文は、統合の一部として自動的に確定または却下されます。加盟店が注文を手動で受け入れたり拒否したりすることはできません。