v1

latestOpenAPI 3.0.02026-07-1398671635.1 KB

Order Delivery Webhooks

publicly-accessible

Order requires delivery acceptance

This webhook will be invoked when we have determined that an order is required acceptance for delivery. Upon receiving the request, the order should be scheduled for pickup by a courier/driver. We expect an immediate 201 response from this webhook to denote that you have received the request.

put/order-requires-delivery-acceptance

Request body

OrderIdstring

Globally unique Identifier for the order. Please use this whenever sending requests related to this order. Just Eat will provide this same identifier on any further messages relating to this order.

FriendlyOrderReferencestring

The customer facing identifier for the order, which should be used in any UI or receipts to identify the order to the customer, driver or restaurant. This identifier is not guaranteed to be globally unique.

Idstring

The unique identifier for an order within the country. You can provide this ID whenever sending requests related to the order. Note that further messages from Just Eat relating to this order may not use this same identifier, use OrderId for a more consistent identifier.

CustomerOrderIdnumber

This is a deprecated customer-facing ID that we maintain to support existing implementations.

OrderReferencestring

This field is used to store external references to the order. This is defined by either Just Eat or the partner that created the order.

IsAMiniFistPumpOrderboolean

Legacy Promotion - Ignore.

Example request

[
  {
    "OrderId": "ijdhpy7bdusgtc28bapspa",
    "FriendlyOrderReference": "348322088",
    "Id": "348322088",
    "CustomerOrderId": 348322088,
    "OrderReference": "39cce3f0-0278-dd25-ae32-e8effe1ce4eb",
    "Order": {
      "NoteToRestaurant": "Contact-free delivery",
      "PickupNoticePeriod": "00:10:00"
    },
    "RestaurantInfo": {
      "Id": "123456",
      "Name": "Test Restaurant",
      "PhoneNumber": "07123456789",
      "AddressLines": [
        "Fleet Place House 2, Fleet Place, London"
      ],
      "City": "London",
      "Postcode": "EC4M 7RF",
      "Longitude": -0.12624,
      "Latitude": 51.50015,
      "EmailAddress": "contact@testrestaurant.com",
      "PickupNotes": "Use the back entrance",
      "DispatchMethod": "Phone"
    },
    "PaymentInfo": {
      "PaymentLines": [
        {
          "CardFee": 0.5,
          "Value": 22.05
        }
      ],
      "Total": 22.55
    },
    "CustomerInfo": {
      "Id": "123456",
      "Email": "contact@just-eat.com",
      "Name": "Just Eat",
      "Address": "Fleet Place House, 2 Fleet Place, London",
      "City": "London",
      "Postcode": "EC4M 7RF",
      "Longitude": -0.12624,
      "Latitude": 51.50015,
      "PhoneNumber": "018727863",
      "DisplayPhoneNumber": "(01) 872 7863",
      "PhoneMaskingCode": "444333222",
      "TimeZone": "GMT Standard Time",
      "LocationSource": "GeodataGeocoder",
      "LocationAccuracyDescription": "ROOFTOP"
    },
    "BasketInfo": {
      "BasketId": "ABCb8DzdnUy7G481b0JN5g",
      "MenuId": 777890,
      "SubTotal": 47.75,
      "Discount": 4.78,
      "DeliveryCharge": 5,
      "Total": 47.97,
      "Discounts": [
        {
          "Id": 21950,
          "Discount": 10,
          "DiscountType": "Percent",
          "QualifyingValue": 4.78
        }
      ],
      "GroupedBasketItems": [
        {
          "CombinedPrice": 3.58,
          "Quantity": 2,
          "MenuCardNumber": "1",
          "BasketItem": {
            "ProductId": 45858074,
            "ProductTypeId": 428,
            "MenuCardNumber": "1",
            "Name": "Mini Fillet Burger",
            "UnitPrice": 1.79,
            "CombinedPrice": 3.58,
            "MealParts": [
              {
                "MealPartId": 45822750,
                "GroupId": 1,
                "Name": "Any Sides?",
                "OptionalAccessories": [
                  {
                    "OptionalAccessoryId": 56168,
                    "Quantity": 1,
                    "UnitPrice": 0.5,
                    "Name": "Add Bacon"
                  }
                ],
                "RequiredAccessories": [
                  {
                    "RequiredAccessoryId": 225025,
                    "GroupId": 3,
                    "UnitPrice": 0.16,
                    "Name": "Coca-Cola Original Taste"
                  }
                ]
              }
            ],
            "OptionalAccessories": [
              {
                "OptionalAccessoryId": 56168,
                "Quantity": 1,
                "UnitPrice": 0.5,
                "Name": "Add Bacon"
              }
            ],
            "RequiredAccessories": [
              {
                "RequiredAccessoryId": 225025,
                "GroupId": 3,
                "UnitPrice": 0.1,
                "Name": "Large Meal"
              }
            ],
            "Discounts": [
              {
                "Amount": 4.5,
                "DiscountType": "Percent"
              }
            ],
            "MultiBuyDiscounts": [
              {
                "Amount": 4.5,
                "DiscountType": "Percent"
              }
            ]
          }
        }
      ]
    }
  }
]

Response

In the event of successful handling of the request, a 201 status code should be returned, indicating acknowledgement of transmission success.