Skip to main content

The order object

Order

ParameterData typeDefaultDescription
order_numberstringThe order number for this order
typestringThe order type of the order
customer_idintThe customer of the order
internal_statusstringdraftPossible values: draft, selection, approved
cancelledbooleanfalseIs the order cancelled?
archivedbooleanfalseIs the order archived?
statusstringThe status label of the order
comments_internalstringA comment on the order that should not be viewed by the customer
comments_externalstringA comment on the order that should be viewable by the customer
meta{}An object with {"key": "value"} with custom meta data of the order. This is used for storing custom fields
price_before_discountfloatThe total price of the order before discount and ex VAT
discount_amountfloatThe total discount given as an amount ex VAT
discount_percentagefloatThe total discount given as a percentage
net_pricefloatThe total price of the order ex VAT, shipping and handling fee and after discount
shippingfloatThe shipping amount ex VAT
handling_feefloatThe handling fee amount ex VAT
vat_amountfloatThe total VAT amount
total_price_after_vatfloatThe total price of the order incl VAT
created_atdatetime
updated_atdatetime
lines.*If eager loadedAn array of object order line

Order line

ParameterData typeDefaultDescription
product_idintThe product bought
variant_idintThe variant bought
quantityintThe quantity bought. This will not decrease as the order is delivered and invoiced
shippedintThe quantity that has been shipped. NOTE: This increases when pieces are sent to warehouse, not when they are actually delivered
invoicedintThe quantity invoiced. This increases whenever an invoice for the order is booked
meta{}An object with {"key": "value"} with custom meta data of the order line. This is used for storing custom fields
price_before_discountfloatThe unit price of the line before discount and ex VAT
discount_amountfloatThe unit discount given as an amount ex VAT
discount_percentagefloatThe discount given as a percentage
net_pricefloatThe unit price of the line ex VAT and after discount
vat_amountfloatThe unit VAT amount
total_pricefloatThe total price of the line ex VAT. This is calculated as quantity * net_price
total_price_after_vatfloatThe total price of the line incl VAT
created_atdatetime
updated_atdatetime