---
title: "Order requires delivery acceptance"
method: PUT
path: "/order-requires-delivery-acceptance"
tags: ["Order Delivery Webhooks", "publicly-accessible"]
---

# Order requires delivery acceptance

`PUT /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.

## Request body

- Connectorder[]
  - `OrderId` string — 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.
  - `FriendlyOrderReference` string — 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.
  - `Id` string — 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.
  - `CustomerOrderId` number — This is a deprecated customer-facing ID that we maintain to support existing implementations.
  - `OrderReference` string — 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.
  - `IsAMiniFistPumpOrder` boolean — Legacy Promotion - Ignore.
  - `Restrictions` OrderItemRestriction[] — This is a list of types of restricted items contained in the order.
    - `Type` 'Alcohol' — The type of restricted item contained in the order. The only supported value is 'Alcohol'.
  - `Order` object — Order data
    - `NoteToRestaurant` string — Notes from the customer about their order. In addition to notes for the restaurant, this field can also delivery instructions - and should be displayed to the delivery driver.
    - `ServiceType` 'Collection' | 'Delivery' — Type of the Order.
    - `PlacedDate` string, date-time — Date Customer placed the order. Note that JUST EAT accepts pre-orders therefore there may be a significant difference between Placed Date and Due Date This Date/Time is set as UTC without an offset, regardless of Country.
    - `RdsPickupTimeWithUtcOffset` string, date-time — When the Delivery Partner needs to be at the Restaurant to pickup the Order.
    - `DueDate` string, date-time — Ignore - use `DueDateWithUtcOffset`.
    - `DueDateWithUtcOffset` string, date-time — The DateTime when the Customer has been told they will receive the Order.
    - `InitialDueDate` string, date-time — Ignore - use `IntialDueDateWithUtcOffset`.
    - `InitialDueDateWithUtcOffset` string, date-time — When the Customer was originally told the order would be delivered (prior to Restaurant adjustment)
    - `PickupNoticePeriod` string, timespan — Desired minimum amount of notice needed before the driver arrives to pickup the order at the restaurant. This is to allow restaurant enough time to prepare the order. If less notice is given the driver may have to wait for the order to be prepared. Field is in the format "hh:mm:ss"
    - `PromptAsap` boolean — Did the Customer request the Order to ready ASAP
  - `RestaurantInfo` object — Restaurant data
    - `Id` string — Unique ID of the Restaurant.
    - `Name` string — The name of the Restaurant.
    - `PhoneNumber` string — The Restaurant phone number.
    - `AddressLines` string[] — Restaurant address.
    - `City` string — The name of the city where the Restaurant is located
    - `Postcode` string — The post code where Restaurant is located
    - `Longitude` number, double — Restaurant address longitude. Will be 0 if not provided.
    - `Latitude` number, double — Restaurant address latitude. Will be 0 if not provided.
    - `EmailAddress` string — Email address for the Restaurant.
    - `PickupNotes` string — Order pickup instructions for the Delivery Partner.
    - `DispatchMethod` string — `DispatchMethod` to use.
  - `PaymentInfo` object — Payment data
    - `PaymentLines` object[] — How the Customer has paid for the Order.
      - `Type` 'Card' — How was the order Paid.
      - `CardFee` number, double — Was there a fee for the payment mechanism.
      - `Value` number, double — The value of the payment.
    - `DriverTipValue` number, double — The value of the tip given to the Driver.
    - `Total` number, double — The total order value.
    - `TotalComplementary` number, double — Order amount covered by JUST EAT.
    - `PaidDate` string, date-time — DateTime when the Order was Paid (excludes UTC offset).
    - `CashOnDelivery` boolean — Is the Customer paying on Delivery.
  - `CustomerInfo` object — Customer data
    - `Id` string — The JUST EAT Customer Id.
    - `Email` string — Email address for the Customer.
    - `Name` string — The name of the Customer.
    - `Address` string — Customer Address. Note that Address is comma delimited.
    - `City` string — The name of the city where the Customer is located.
    - `Postcode` string — The post code where Customer is located.
    - `Longitude` number, double — Customer address longitude. Will be 0 if not provided.
    - `Latitude` number, double — Customer address latitude. Will be 0 if not provided.
    - `PhoneNumber` string — The customer's unmasked phone number. Please don't expose this to drivers, instead use this number to provide your own phone masking number or use the JustEat masked number `DisplayPhoneNumber` below
    - `DisplayPhoneNumber` string — The customer's masked phone number.
    - `PhoneMaskingCode` string — Code to use when calling customer phone masked number (`DisplayPhoneNumber`) about this order. Null if phone masking not enabled
    - `TimeZone` string — Customer timezone, e.g. 'Central European Standard Time'.
    - `PreviousRestuarantOrderCount` number — The number of Orders the Customer has placed at this Restaurant via JUST EAT
    - `LocationSource` string — Provider of the location data.
    - `LocationAccuracyInMeters` number, double — Accuracy of the location data in meters.
    - `LocationAccuracyDescription` string — Location accuracy description
  - `BasketInfo` object — Basket data
    - `BasketId` string — Unique Basket Id for the Order.
    - `MenuId` number — Id of the Restaurant's menu.
    - `SubTotal` number, double — The Basket total cost, excluding any discounts.
    - `ToSpend` number, double — Amount to spend.
    - `MultiBuyDiscount` number, double — MultiBuy discount.
    - `Discount` number, double — The discount amount, used in conjunction with `DiscountType`.
    - `DeliveryCharge` number, double — Amount of cost that comes from delivery.
    - `Total` number, double — Total price of the Order.
    - `Discounts` object[] — Any Discounts applied to the Order.
      - `Id` number — Basket item id.
      - `Discount` number — The discount amount, used in conjunction with `DiscountType`.
      - `DiscountType` string — The type of discount, e.g. a percentage or the order or fixed amount.
      - `QualifyingValue` number, double — The minimum order amount in order for this discount to be applicable.
    - `GroupedBasketItems` object[] — Grouped basket items
      - `CombinedPrice` number, double — The total price of the Basket Item (including discounts).
      - `Quantity` number — The quantity of Basket Items requested.
      - `OrderSubId` number — Order `SubId`
      - `MenuCardNumber` string — Menu card number.
      - `BasketItem` object — An item in the Basket.
        - `ProductId` number — Id of the Product.
        - `ProductTypeId` number — Id of the Product.
        - `MenuCardNumber` string — Menu card number.
        - `Name` string — The Item name, e.g. Chicken Tikka Masala or Family Meal Deal 3.
        - `Synonym` string — Legacy - ignore.
        - `UnitPrice` number, double — The price of the item.
        - `CombinedPrice` number, double — Unit Price plus individual Meal Part item cost.
        - `MealParts` object[] — Represents sub-parts of a meal.
          - `MealPartId` number — The meal part Id.
          - `GroupId` number — The group Id.
          - `Name` string — The name of the meal part.
          - `Synonym` string — The synonym of the meal part.
          - `OptionalAccessories` object[] — Optional accessories
            - `OptionalAccessoryId` number — The accessory Id.
            - `Quantity` number — The quantity of the accessory.
            - `UnitPrice` number, double — The unit price of the accessory.
            - `Name` string — The name of the accessory.
          - `RequiredAccessories` object[] — Required accessories
            - `RequiredAccessoryId` number — The accessory Id.
            - `GroupId` number — The group Id of the accessory.
            - `UnitPrice` number, double — The unit price of the accessory.
            - `Name` string — The name of the accessory.
        - `OptionalAccessories` object[] — An option item added to the Basket Item, this may be options such as Garlic Bread or a bottle of Coke.
          - `OptionalAccessoryId` number — The accessory Id.
          - `Quantity` number — The quantity of the accessory.
          - `UnitPrice` number, double — The unit price of the accessory.
          - `Name` string — The name of the accessory.
        - `RequiredAccessories` object[] — Items required as part of the Item, for example, Pizza base sauce.
          - `RequiredAccessoryId` number — The accessory Id.
          - `GroupId` number — The group Id of the accessory.
          - `UnitPrice` number, double — The unit price of the accessory.
          - `Name` string — The name of the accessory.
        - `Discounts` object[] — Any discounts applied to this specific item.
          - `Amount` number, double — Amount of the discount applied
          - `DiscountType` string — Type of the discount applied
        - `MultiBuyDiscounts` object[] — Any multi-purchase discounts applied to this item.
          - `OrderItemId` string — Id of the Order item.
          - `Amount` number, double — Amount of the discount applied
          - `DiscountType` string — Type of the discount applied
          - `ProductTypeId` number — The Id of the product type the discount applies to.

## Response `201`

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

## Other responses

- `default` — In the case that the order cannot be accepted, an appropriate HTTP status code, such as 400 (Bad request) or 500 (Internal server error) should be returned. In addition to the HTTP status code, a specific reason code and explanatory message should be provided within the response body

---

[API](https://skmtc.net/just-eat/apis/just-eat-api.md) · [All operations](https://skmtc.net/just-eat/apis/just-eat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/just-eat/just-eat-api/revisions/4b25c7d97a53/schema)
