POST Promise Quote Create

The endpoint will return the estimated delivery time if the delivery is available.

Endpoint verifies drivers and DSPs availability for delivery for one or multiple stores. The quotes provided by drivers and DSPs are compared and the best delivery quote is selected.

Headers
  • Accept
    Type: string
    required

    Accept header

  • Authorization
    Type: string
    required

    Authorization header

  • Content-Type
    Type: string
    required

    Content-Type header

  • API-VERSION
    Type: string
    required

    API version

  • Application
    Type: string
    required

    Application key

  • X-Request-ID
    Type: string
    required

    Unique request identifier

  • X-QB-Enabled
    enum
    required

    Header which if sent with value 'true' will allow usage of the query building feature in response (through the request's query params). It is mandatory for this part of the documentation.

    values
    • true
    • false
Body
  • expected_delivery_time
    Type: string
  • latitude
    Type: numberFormat: float
  • longitude
    Type: numberFormat: float
  • store_ids
    Type: array string[]
Responses
  • application/json
Request Example for post/dispatch-service/quotes
curl https://api-public-demo.menu.app/api/dispatch-service/quotes \
  --request POST \
  --header 'Accept: application/json' \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --header 'API-VERSION: ' \
  --header 'Application: ' \
  --header 'X-Request-ID: c10b4a70-6274-490d-80a0-03e7bb826937' \
  --header 'X-QB-Enabled: true' \
  --data '{
  "expected_delivery_time": "2023-08-11 17:00:00",
  "store_ids": [
    "b8baafab-3f22-11ed-936c-1a67b454859d"
  ],
  "latitude": 45.263273710844025,
  "longitude": 19.831003078597004
}'
{
  "status": "OK",
  "code": 200,
  "data": {
    "promises": [
      {
        "token": "3921ed0b-f4a6-40eb-89a4-d68b64f6fb77",
        "state": "Ready to order",
        "store_id": "b8b96123-3f22-11ed-936c-1a67b454859d",
        "order_token": "null",
        "expected_delivery_time": "2023-01-23T19:00:00.000Z",
        "estimated_pickup_time": "null",
        "estimated_delivery_time": "2023-05-24T13:57:40.000Z",
        "estimated_delivery_fee": 705,
        "target_delivery_providers": [
          "dsp1"
        ],
        "external_delivery_provider_promise_order_id": "null"
      }
    ]
  }
}