Skip to main content

Order

Orders Resource

KeyTypeDescription
idIntegerThe ID of the order.
uuidStringThe universally unique identifier (UUID) for the order. This UUID is used specifically for guest users to fetch order details.
userObjectAn object containing customer-related information.
dateDatetimeThe date and time when the order was created.
payment_method_objectIntegerAn object containing information about the payment method used.
installmentObjectAn object representing the installment payment plan. This object is included when creating an order with an installment payment plan.
by_affiliateBooleanIndicates whether the order was made by an affiliate.
user_agentStringThe user agent of the device used to place the order. It can have values like "web," "android," or "ios" to indicate the type of device used for the order.
stateObjectAn object containing information about the state of the order.
statesArrayAn array of objects representing the different states of the order.
cancellation_idIntegerThe ID of the cancellation, which is relevant if the order was cancelled.
cancellation_reasonStringThe reason for the cancellation, which is relevant if the order was cancelled.
cancellation_textStringText related to the cancellation of the order.
itemsArrayAn array of objects representing the items included in the order.
missing_itemsArrayAn array of objects representing any missing items in the order.
returned_itemsArrayAn array of objects representing any returned items in the order.
rateIntegerThe rating given to the order, typically ranging from 1 to 5 stars.
driver_rateIntegerThe rating given to the delivery driver. typically ranging from 1 to 5 stars.
is_skipIntegerIndicates whether the order is a skipped order when the user chose to skip rating for this order.
addressObjectAn object containing the delivery address information.
notesIntegerAdditional notes or comments related to the order.
invoiceObjectAn object containing information about the invoice associated with the order.
scheduled_atDatetimethe date and time for order delivery, used for scheduling or specifying a delivery time slot.
delivererIntegerThe delivery person or company responsible for delivering the order.
transaction_idIntegerThe ID of the transaction associated with the order.
affiliate_total_amountIntegerThe total amount attributed to the affiliate.
branchObjectThe branch associated with the order.
time_slot_enStringThe time slot for delivery in English.
time_slot_arStringThe time slot for delivery in Arabic.
reference_orderStringThe reference order for the current order.

Order Items Resource

KeyTypeDescription
idIntegerThe ID of the order item.
amountIntegerThe quantity or number of items in the order.
serial_numberStringThe serial number associated with the item.
skuStringThe stock keeping unit (SKU) code of the item.
barcodeStringThe barcode associated with the item.
nameStringThe English name of the item.
name_arStringThe Arabic name of the item.
imageStringThe URL or path to the image of the item.
priceIntegerThe original price of the item.
discount_priceIntegerThe discounted price of the item.
activeIntegerIndicates whether the item is active.
rateIntegerThe rating given to the item.
optionsArrayAn array of objects representing the options or variants chosen for the item.
missingIntegerIndicates whether the item is missing from the order.
returnedIntegerIndicates whether the item has been returned.
missing_priceIntegerThe price of the missing item.
missing_discount_priceIntegerThe discounted price of the missing item.
missing_tax_amountIntegerThe tax amount associated with the missing item.

Order User Resource

KeyTypeDescription
idIntegerThe ID of the customer (e.g., 1031094).
full_nameStringThe full name of the customer.
phoneStringThe phone number associated with the customer.
is_guestIntegerIndicates whether the customer is a guest (0 for false, 1 for true).

Invoice Resource

KeyTypeDescription
idIntegerThe unique identifier of the invoice.
cod_amountStringThe amount of money that the buyer will pay in cash on delivery.
cost_amountIntegerThe cost incurred by the seller for providing the products.
delivery_feesIntegerThe amount of money charged by the seller for delivering the products.
discountIntegerThe amount of discount, if any, applied to the total amount owed by the buyer.
free_deliveryIntegerA flag indicating whether the delivery was free or not.
grand_totalIntegerThe total amount of money that the buyer owes to the seller, including delivery fees and any discounts.
invoice_numberStringThe unique number assigned to the invoice by the seller.
invoice_urlStringThe URL of the invoice document, if available.
loyalty_discountIntegerThe amount of discount, if any, applied to the total amount owed by the buyer due to loyalty points or rewards.
loyalty_pointsIntegerThe number of loyalty points earned by the buyer for this transaction.
online_paid_amountIntegerThe amount of money paid online by the buyer.
original_delivery_feesIntegerThe original amount of money charged by the seller for delivering the products or services, before any discounts or changes.
paid_amountIntegerThe total amount of money paid by the buyer, including any online payments and cash on delivery.
promo_idIntegerThe unique identifier of any promotion or discount code used for this transaction.
qr_codeIntegerThe QR code associated with the invoice.
tax_amountIntegerThe amount of tax, if any, charged on the products or services provided.
total_amountIntegerThe total amount of money charged for the products or services provided, before any discounts or changes.
wallet_paid_amountIntegerThe amount of money paid using a digital wallet or e-wallet.
total_cash_amountIntegerThe total amount of money paid in cash, including any cash on delivery and any refunds.
refund_amountIntegerThe amount of money refunded to the buyer.
total_invoiceIntegerThe total amount of money charged for the products or services provided, including any delivery fees and taxes.
refunded_online_paid_amountIntegerThe amount of money refunded to the buyer for any online payments made.
refunded_wallet_amountIntegerThe amount of money refunded to the buyer for any payments made using a digital or e-wallet.
refunded_loyalty_amountIntegerThe amount of money refunded to the buyer for any loyalty discounts or rewards claimed.

State Resource

KeyTypeDescription
idIntegerThe ID of the order state.
nameStringThe English name of the order state.
name_arStringThe Arabic name of the order state.

Order Payment Method

KeyTypeDescription
idIntegerthe unique identifier for the payment method.
nameStringthe name of the payment method in English.
name_arStringthe name of the payment method in Arabic.
is_onlineIntegerindicator whether this payment method is online. In this case, 0 indicates that it's not an online payment method.
iconStringthe URL to an image icon that represents this payment method.