# Orders

The **Orders** dashboard is where you can view a list of the orders placed at your store. You can either view all of the orders, or limit the view per site.

## Order visibility by user role

The orders displayed in the **Orders** module depend on your user role:

**Non-vendor users**

* Always see orders with suborders
* Can view both master orders and their associated suborders

**Vendor users**

* Always see only their own vendor suborders
* Master orders are not displayed
* Only orders assigned to the vendor's vendor ID are visible

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-49b6c77a326480d9232b4a17e7b4400a02f78885%2Forders.png?alt=media" alt=""><figcaption></figcaption></figure>

## Orders list view

In the orders view, you can check and filter the results by any column.

You can also change the default view by using the options available under the orchestration icon.

<div align="left"><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-7cfcfdf2cec4c375b7575ad6c176c07374395af1%2Forchestration.png?alt=media" alt=""></div>

{% hint style="info" %}
With the table orchestration, you can add custom columns to the list view, by adding **mixin** fields as columns. If you have already defined mixin schema for the entity, you'd be able to select the defined mixin fields to display them in the main view.

See example how to do it in the [Displaying mixins in entity list view](https://developer.emporix.io/ce/settings/mixin-schemas#displaying-mixins-in-entity-list-view) documentation.
{% endhint %}

If you expand the view of a specific order in the dashboard, you can also see a summary of the **products** that were ordered, their **quantity** and **price**.

Additionally, use the icons on the left to:

* View and download an invoice for the order
* Change the order status
* Open a specific order and view its details
* Delete an order

<div align="left"><figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-71e2e505763280eeb732fd02e9a9807783ed4a36%2Forder_icon.png?alt=media" alt="" width="182"><figcaption></figcaption></figure></div>

The statuses used in orders are:

* **Created** - a new order that was placed
* **Completed** - realized order request
* **Declined** - for orders that could not be realized
* **In-checkout** - awaiting invoice payment
* **Confirmed** - paid order that should be realized
* **Shipped** - order that has been dispatched and sent to the customer

Possible order status transitions:

* **Created** → **Confirmed**, or **Declined**
* **In-checkout** → **Created**, or **Declined**
* **Confirmed** → **Declined**, or **Completed**
* **Shipped** → **Completed**
* **Declined** and **Completed** cannot be changed (no further transitions)

If you need to export the list of orders, you can download a `.csv` file with orders that are currently displayed in the list. Choose the download option to get the `.csv` file and then select the time frame for the list.

<div align="left"><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-63a797b42f89983a7dea10a63320b55102b9264e%2Fdownload_csv.png?alt=media" alt=""></div>

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-1e0ec583c62fb29870f6ffb8a13512a0f08e3a49%2Fexport.png?alt=media" alt="" width="297"><figcaption></figcaption></figure>

{% hint style="warning" %}
For the orders that were created by guest users, the **Customer Number** field is marked as **Anonymous**. If the guest customer later chooses to create an account, the customer number **Anonymous** is replaced with the real customer ID. Also, since the guest orders are associated with the email address provided at checkout, if a guest customer chooses to register, they are able to view the created orders under **My Account -> Order Overview**.
{% endhint %}

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-6663b46f2a61a6dd7dc2ce5333b724fd18196dd3%2Fguest-order.png?alt=media" alt=""><figcaption></figcaption></figure>

## Orders details

When you open a specific order view, you can check detailed information related to the order in different tabs. There are tabs that are main ones and are visible for every order, but depending on the mixins set up of the ordered products, you can also see some additional tabs with more order and product details.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-7d878230e49e8463ffa0fccbc8a7d598a7644168%2Forder_details.png?alt=media" alt=""><figcaption></figcaption></figure>

### Main tabs

**Data**

The **Data** tab includes all of the general information. You can check the following:

* **Order** - Details with information about the order number, status, payments with detailed information about the pricing calculations.
* **Customer** - Data with ID, name and contact details of the customer that placed the order.
* **Delivery** - Address to which the order should be delivered and details of the delivery date and time.
* **Invoice Address** - Company address that should be visible in the invoice.

This tab allows you to perform a variety of actions for each order, including

* **Print a delivery note** - You can download a PDF file with a summary of the ordered products and acknowledgment of receipt to be signed by the customer. By signing the delivery note customers also commit to pay an invoice within the specified time period.
* **Send delivery confirmation** - When you click the button, a delivery confirmation is sent to the customer by email.
* **Create and send invoice** - When you click the button, a job starts that processes the creation of the invoice and sends it to the customer by email.

You can also see the **Cart Number** which relates to the order the cart created by the customer, to see the cart's details simply click the number - it opens the cart view in MD.

If you have configuration for site permissions or for custom restrictions, you might also have the **Restriction** value. The restriction is either inherited from a customer or applied programmatically by the storefront (depending on your configuration). If an order shows **Restriction**, it means that it can be seen only by the employees that have proper access scopes connected to a specific site (or custom restriction).

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-31758bb753862085ca83ea782bab2a0a525a92ce%2Forder_restricted.png?alt=media" alt="Order restriction"><figcaption><p>Order restriction</p></figcaption></figure>

{% hint style="info" %}
For more information about site permissions, see the [Site permissions](https://developer.emporix.io/ce/system-management/authentication-and-authorization/authorization/site-permissions).
{% endhint %}

**Entries**

The **Entries** tab includes information about the products that were ordered. You can see a basic summary which contains a product name, quantity and all the pricing details.

The tab allows you to modify the list of products that were ordered by a customer. You can modify the order by changing the amount of entries or adding new ones to the list. The changes in the order are possible as long as the total sum does not exceed the total authorized amount. Changes are allowed only if the modified order is of equal or lesser value. If the modified order exceeds the previous value, you get a notification that the changes cannot be saved. For example:

Original order:

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-d1c203e96aaffce2877a8e165efbce166446b043%2Forder_original.png?alt=media" alt=""><figcaption></figcaption></figure>

Order modification that is not allowed as it exceeds the original total price:

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-f96ac1e4ff118b7fc50b2729f554bac7747451d1%2Forder_modification_not_approved.png?alt=media" alt=""><figcaption></figcaption></figure>

Order modification that is allowed and can be saved:

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-5e7cbb38e1e394527371aadfd216d187616c8078%2Forder_modification_approved.png?alt=media" alt=""><figcaption></figcaption></figure>

If the order was already paid, it cannot be modified. The **Add entry** button is disabled.

**Payment Info**

This tab has all the details related to payment methods and transactions.

**General Attributes**

Includes a summary of basic order information together with coupon and feedback invitation sent to the customer.

**Payments**

Check the total payment information including taxes.

### Additional tabs

Depending on your configuration, you can have some additional tabs in the orders view, for example:

**Changelog**

Check the history of the order since it was placed at the store.

**Delivery Options**

Check and define the details of the delivery packaging, pickup or holding time. You can also mark if the product can be substituted by a different one, or not.

**Delivery Times**

Check and define the details of delivery time like with a confirmation of a delivery cost.

**Payment**

Includes payment details with account and bank information, card and payment details.

## Vendors order splitting

When the customer completes the checkout, a single order is created containing all the selected products. Each order entry retains the vendor information and is a standard order but with vendor details.

{% hint style="warning" %}

* Only orders in the CREATED status can be split.
* Orders that are already suborders or have been split before cannot be split again.
* Orders with discounts cannot be split.
  {% endhint %}

### Order split example

Check how the order splitting flow works on the example:

1. A vendor creates a product → it’s automatically assigned to their vendor ID.
2. A customer adds products to the cart → vendor info stays with each product.
3. Checkout creates a single combined order.
4. Calling /split transforms it into:
   * One master order (ORD5001)
   * Multiple suborders (ORD5002, ORD5003) — one per vendor and one for non-vendor items.

Vendors can only view and manage their own suborders.

If a master order was split, you can view the split details in Management Dashboard. The split icon indicates the order was divided per vendor and when you click on it you can see the split details.

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-311502040979a861309d0f90e5fa81b6cd60345d%2Fvendor_ordersplit.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-fd82163a32b1deade0eeb5d32ffbfa3657713d50%2Fvendor_ordersplit2.png?alt=media" alt=""><figcaption></figcaption></figure>

The split details are also visible in the order details view as suborders:

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-333097c4f36ccde3b4bde1861537f545e125a5da%2Fvendor_ordersplit3.png?alt=media" alt=""><figcaption></figcaption></figure>

When you open the suborder, you can see to which vendor it was assigned and the master order relation:

<figure><img src="https://3057647601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbTY7EwZtYYQYC6GOcdTj%2Fuploads%2Fgit-blob-73488f8f2a62fd99264a0fa4577026b4a35818c3%2Fvendor_ordersplit4.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For more details about vendors, see the following guides:

* [Vendor Products](https://developer.emporix.io/ce/products-module/products#vendor-related-products)
* [Vendor User Groups](https://developer.emporix.io/ce/administration/usersandgroups#vendor-groups)
* [Vendor Service](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/companies-and-customers/vendor-service)
* [Vendor API Tutorial](https://app.gitbook.com/s/d4POTWomuSS7d3dnh4Dg/api-guides/companies-and-customers/vendor-service)
  {% endhint %}
