Order

@vendure/core Source

An Order is created whenever a Customer adds an item to the cart. It contains all the information required to fulfill an order: which ProductVariants in what quantities; the shipping address and price; any applicable promotions; payments etc.

An Order exists in a well-defined state according to the OrderState type. A state machine is used to govern the transition from one state to another.

Signature

class Order extends VendureEntity implements ChannelAware, HasCustomFields {    constructor(input?: DeepPartial<Order>)    @Column('varchar', { default: OrderType.Regular })    type: OrderType;    @OneToMany(type => Order, sellerOrder => sellerOrder.aggregateOrder)    sellerOrders: Order[];    @Index()    @ManyToOne(type => Order, aggregateOrder => aggregateOrder.sellerOrders)    aggregateOrder?: Order;    @EntityId({ nullable: true })    aggregateOrderId?: ID;    @Column()    @Index({ unique: true })    code: string;    @Column('varchar') state: OrderState;    @Column({ default: true })    active: boolean;    @Column({ nullable: true })    @Index()    orderPlacedAt?: Date;    @Index()    @ManyToOne(type => Customer, customer => customer.orders)    customer?: Customer;    @EntityId({ nullable: true })    customerId?: ID;    @OneToMany(type => OrderLine, line => line.order)    lines: OrderLine[];    @OneToMany(type => Surcharge, surcharge => surcharge.order)    surcharges: Surcharge[];    @Column('simple-array')    couponCodes: string[];    @ManyToMany(type => Promotion, promotion => promotion.orders)    @JoinTable()    promotions: Promotion[];    @Column('simple-json') shippingAddress: OrderAddress;    @Column('simple-json') billingAddress: OrderAddress;    @OneToMany(type => Payment, payment => payment.order)    payments: Payment[];    @ManyToMany(type => Fulfillment, fulfillment => fulfillment.orders)    @JoinTable()    fulfillments: Fulfillment[];    @Column('varchar')    currencyCode: CurrencyCode;    @Column(type => CustomOrderFields)    customFields: CustomOrderFields;    @EntityId({ nullable: true })    taxZoneId?: ID;    @ManyToMany(type => Channel)    @JoinTable()    channels: Channel[];    @OneToMany(type => OrderModification, modification => modification.order)    modifications: OrderModification[];    @Money()    subTotal: number;    @Money()    subTotalWithTax: number;    @OneToMany(type => ShippingLine, shippingLine => shippingLine.order)    shippingLines: ShippingLine[];    @Money({ default: 0 })    shipping: number;    @Money({ default: 0 })    shippingWithTax: number;    discounts: Discount[]    total: number    totalWithTax: number    totalQuantity: number    taxSummary: OrderTaxSummary[]}

Extends: VendureEntity
Implements: ChannelAware, HasCustomFields

type

propertyOrderType

sellerOrders

propertyOrder[]

aggregateOrder

propertyOrder

aggregateOrderId

propertyID

code

propertystring

A unique code for the Order, generated according to the OrderCodeStrategy. This should be used as an order reference for Customers, rather than the Order's id.

state

propertyOrderState

active

propertyboolean

Whether the Order is considered "active", meaning that the Customer can still make changes to it and has not yet completed the checkout process. This is governed by the OrderPlacedStrategy.

orderPlacedAt

propertyDate

The date & time that the Order was placed, i.e. the Customer completed the checkout and the Order is no longer "active". This is governed by the OrderPlacedStrategy.

customer

propertyCustomer

customerId

propertyID

lines

propertyOrderLine[]

surcharges

propertySurcharge[]

Surcharges are arbitrary modifications to the Order total which are neither ProductVariants nor discounts resulting from applied Promotions. For example, one-off discounts based on customer interaction, or surcharges based on payment methods.

couponCodes

propertystring[]

An array of all coupon codes applied to the Order.

promotions

propertyPromotion[]

Promotions applied to the order. Only gets populated after the payment process has completed, i.e. the Order is no longer active.

shippingAddress

propertyOrderAddress

billingAddress

propertyOrderAddress

payments

propertyPayment[]

fulfillments

propertyFulfillment[]

currencyCode

propertyCurrencyCode

customFields

propertyCustomOrderFields

taxZoneId

propertyID

channels

propertyChannel[]

modifications

propertyOrderModification[]

subTotal

propertynumber

The subTotal is the total of all OrderLines in the Order. This figure also includes any Order-level discounts which have been prorated (proportionally distributed) amongst the OrderItems. To get a total of all OrderLines which does not account for prorated discounts, use the sum of OrderLine's discountedLinePrice values.

subTotalWithTax

propertynumber

Same as subTotal, but inclusive of tax.

shippingLines

propertyShippingLine[]

The shipping charges applied to this order.

shipping

propertynumber

The total of all the shippingLines.

shippingWithTax

propertynumber

discounts

propertyDiscount[]

total

propertynumber

Equal to subTotal plus shipping

totalWithTax

propertynumber

The final payable amount. Equal to subTotalWithTax plus shippingWithTax.

totalQuantity

propertynumber

taxSummary

propertyOrderTaxSummary[]

A summary of the taxes being applied to this Order.

Was this chapter helpful?

Report Issue

Edited Apr 20, 2026·Edit this page