# General Concepts Ordering
# Order Structure
Within Procurement an Order is composed out of several different entities as shown in the graph below:
┌─────────────────────┐ ┌─────────────────────┐
│ Contracts │ │ SKU │
└─────────────────────┘ └─────────────────────┘
▲ ▲
│ │
│ │
│ │
┌ ─ ─ ─ ─ ─ ─ ─ ┼ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┼ ─ ─ ─ ─ ─ ─ ─ ┐
│ │
│ │ │ │
┌─────────────────────┐ ┌─────────────────────┐
│ │ Order │◀────────│ OrderLineItem │ │
└─────────────────────┘ └─────────────────────┘
│ ▲ ▲ │
│ │
│ │ │ │
│ │
│ ┌─────────────────────┐ ┌─────────────────────┐ │
│ Delivery │◀────────│ DeliveryLineItem │
│ └─────────────────────┘ └─────────────────────┘ │
│ │
─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─
To learn more on how these interact, please read more here: Introduction to Orders and Deliveries (opens new window)
# Order Attributes
This is a list of all available order attributes including a short description:
| Attribute | Description |
|---|---|
contract | The Contract the order belongs to. This will implicitly also determine the Supplier of the order |
currency | The currency to be used for the order |
delivery_mode | The delivery mode of an order. Can either be complete or splitted.The complete delivery mode says that all Items of the order should and will be delivered to the same address at the same point in time.The splitted delivery mode allows you to specify different delivery destinations and/or delivery dates for the items within the order.❗️ Currently only complete is fully supported |
exclusive_sales_group | The exclusive sales group to be used for the order |
gross_total | The gross total of the order in the given currency |
net_handling_fee | For example a fee for customization or a minimum quantity surcharge |
net_shipping_fee | Additional fees for shipping |
net_total | The net total of the order in the given currency |
person | If known, this field will hold information about the Zaikio Account that created the Order |
references | This field can be used to add additional references to an order, e.g. an internal ID or similar. The first value returned will always be a unique Order Number generated by Procurement |
state | The current state the order is in. To learn more about order states, see the section below. |
${state_transition}_at | For each available state there is also a date indicating when the Order was moved into the respective state |
state_reason | A text written be the supplier that describes the reason for the current state. This text might include information about errors, cancelation reasons or reasons for delay. |
taxes | The taxes on the order in the given currency |
taxes_on_fees | The taxes on additional fees in the given currency |
# Order States
All available order states are listed here: Order States (opens new window)