| Field |
Type |
Description |
order_id |
String |
The order’s internal identifier. |
order_code |
String |
The order’s alphanumeric code, printed on the receipt. The lookup and deduplication key. |
store_id |
String |
The store identifier, formatted partner_name__store_id. |
order_time |
String |
When the order was accepted, yyyy-MM-dd HH:mm:ss, store local time. |
estimated_pickup_time |
String |
Estimated pick-up time, same format. |
order_type |
String |
pickup (a courier collects it) or delivery (you deliver). See the note below. |
is_picked_up_by_customer |
Boolean |
The customer collects the order in person. |
payment_method |
String |
DELAYED (paid online by card) or CASH (cash on delivery). |
payment_total |
Integer |
The amount to collect, in subunits. |
currency |
String |
The currency, for example RON. |
pick_up_code |
String |
A 3-digit code identifying the order at hand-over. |
cutlery_requested |
Boolean |
The customer asked for cutlery. |
allergy_info |
String |
Free text written by the customer about allergies or preferences. |
special_requirements |
String |
Special requirements, if any. |
customer_cash_payment_amount |
Integer |
The amount the customer pays with, so you can prepare change. Marketplace, cash only. |
minimum_basket_surcharge |
Integer |
Minimum-basket surcharge. Marketplace only. |
loyalty_card |
String |
Loyalty card, when transmitted. |
traceCode, traceId |
String |
Internal request identifiers. You do not need them. |
| Field |
Type |
Description |
products |
Array |
The ordered products. |
courier |
Object |
Courier details. null for marketplace. |
customer |
Object |
Customer details. Complete only for marketplace. |
delivery_address |
Object |
Delivery address. Marketplace only. |
fees |
Array |
Fees paid by the customer. |
discounts |
Array |
Discounts applied. |
detailed_fees |
Array |
Itemised fees, by code. |
glovo_discounts |
Array |
Discounts borne by the platform. |
restaurant_discounts |
Array |
Discounts borne by the restaurant. |
products_total |
Integer |
Product total, before fees and discounts. |
bundled_orders |
Array |
Orders delivered together with this one. |
| Field |
Type |
Description |
id |
String |
The product identifier, exactly as you sent it in the menu. |
purchased_product_id |
String |
Unique identifier of the line within the order. |
name |
String |
Product name. |
quantity |
Integer |
Quantity. |
price |
Integer |
Unit price, in subunits. |
discount |
Integer |
Discount applied at product level. |
attributes |
Array |
Options chosen for this product. |
| Field |
Type |
Description |
id |
String |
The attribute identifier, from the menu you sent. |
name |
String |
Name. |
quantity |
Integer |
Quantity chosen. |
price |
Integer |
Price. 0 means a free option; above 0, a paid extra. |
Attribute prices are separate from the product’s price. The line total is
price × quantity plus the sum of the attributes.
| Field |
Type |
Description |
name |
String |
For courier delivery, only the first name and an initial. |
phone_number |
String |
N/A for courier delivery. |
hash |
String |
An anonymous identifier, stable for the same customer. |
invoicing_details |
Object |
Invoicing details. null when no invoice was requested. |
| Field |
Type |
Description |
name |
String |
Courier name. null for marketplace. |
phone_number |
String |
Courier phone. null for marketplace. |
| Field |
Type |
Description |
label |
String |
The full address, as unstructured text. |
latitude |
Double |
Latitude. |
longitude |
Double |
Longitude. |
The address is not broken down into street, number and city. If you need components, use the
coordinates.
fees, discounts, detailed_fees, glovo_discounts and restaurant_discounts all share the
same shape:
| Field |
Type |
Description |
code |
String |
The fee or discount code. |
description |
String |
Text description. May be null. |
value |
Integer |
The value, in subunits. |
Codes you will see:
| List |
Codes |
detailed_fees |
DeliveryFee, MinimumBasketSurcharge, ServiceFee |
glovo_discounts |
GlovoDiscount, GlovoSupportedDeliveryFee, Other |
restaurant_discounts |
RestaurantDiscount |