> ## Documentation Index
> Fetch the complete documentation index at: https://help.mathership.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Order Details

> View detailed information about a specific customer order

# Order Details

Order details show the full information for one specific order.

Use this page when you want to review what was ordered, who placed the order, which vendor received it, and which delivery location belongs to the order.

## What are order details?

Order details are the complete view of a single order.

They can include information such as:

* Order ID
* Customer company
* Vendor company
* Delivery location
* Ordered products
* Quantities
* Product prices, if available
* Order message
* Order status
* Order date
* Related vendor-customer relationship

## Who can view order details?

Order details can be viewed by authorized users only.

There are two main cases:

| User type | Can view                                    |
| --------- | ------------------------------------------- |
| Customer  | Orders placed by their own customer company |
| Vendor    | Orders received by their own vendor company |

<Warning>
  Users can only view order details when they are part of the related customer-vendor relationship.
</Warning>

## Customer order details

Customers can view the details of orders they placed with a vendor.

Mathership checks that:

* The logged-in user owns the customer company
* The vendor company exists
* A valid customer-vendor relationship exists
* The order belongs to that customer and vendor

If these checks pass, Mathership returns the full order details.

## Vendor order details

Vendors can view details of orders received from customers.

Mathership checks that:

* The logged-in user belongs to the vendor company
* The order belongs to that vendor
* The order is not a draft or scheduled email order
* The order exists and is accessible

This helps vendors review incoming orders before processing them.

## Order items

The order detail view includes the ordered products.

Each order item can include:

| Field          | Meaning                             |
| -------------- | ----------------------------------- |
| Product        | The ordered product                 |
| Article number | Vendor article number, if available |
| Article name   | Product name                        |
| Quantity       | Ordered amount                      |
| Packaging      | Product packaging or unit           |
| Price          | Product price, if available         |

<Note>
  Prices may be missing if the vendor has not stored prices for all products.
</Note>

## Delivery location

Each order is connected to a delivery location.

The delivery location helps the vendor understand where the order should be delivered.

A delivery location can include information such as:

* Location name
* Street and street number
* Postal code
* City
* Customer-specific delivery details

## Order message

Customers can add a message when placing an order.

This message can be used for additional instructions, for example:

* Preferred delivery time
* Special handling notes
* Internal reference information
* Comments for the vendor

## Order status

Orders can have a status.

The status helps vendors track the processing state of the order.

Typical examples may include:

| Status type | Meaning                         |
| ----------- | ------------------------------- |
| Open        | The order still needs attention |
| In progress | The order is being processed    |
| Completed   | The order has been handled      |
| Archived    | The order is no longer active   |

<Note>
  The exact available statuses depend on the configured order status choices in Mathership.
</Note>

## Updating the order status

Vendors can update the status of an order.

When a vendor updates an order status, Mathership checks that:

* The user is a vendor
* The order belongs to the vendor company
* The submitted status is valid

If the status is not valid, Mathership rejects the update.

## Draft and scheduled orders

Some orders can be created as drafts or scheduled orders.

These are not always shown in the same way as normal sent orders.

| Email status | Meaning                                |
| ------------ | -------------------------------------- |
| Draft        | Order was saved but not sent           |
| Scheduled    | Order is planned for later sending     |
| Pending      | Order is ready to be sent or processed |

Vendor order detail views may exclude draft and scheduled orders from normal order access.

## Order emails and attachments

When an order is sent, Mathership can send an email notification to the vendor.

This email can include order details and an attachment.

Depending on the customer's settings, the attachment can be:

* PDF
* CSV

The order detail page and the email attachment are related, but they are not the same thing.

The order detail page is the in-app view.

The attachment is the file sent with the email.

## Example: Customer views an order

A customer wants to check what they ordered from a vendor.

| Step | Action                                             |
| ---- | -------------------------------------------------- |
| 1    | Customer opens order history                       |
| 2    | Customer selects an order                          |
| 3    | Mathership checks the customer-vendor relationship |
| 4    | Mathership shows the order details                 |

## Example: Vendor views an order

A vendor receives a new order and opens the order detail page.

| Step | Action                                                     |
| ---- | ---------------------------------------------------------- |
| 1    | Vendor opens received orders                               |
| 2    | Vendor selects an order                                    |
| 3    | Mathership checks vendor access                            |
| 4    | Vendor reviews products, quantities, and delivery location |
| 5    | Vendor updates the order status if needed                  |

## Example order information

| Field             | Example             |
| ----------------- | ------------------- |
| Order ID          | 123                 |
| Customer          | Main Restaurant     |
| Vendor            | Fresh Food Supplier |
| Delivery location | Main Kitchen        |
| Product           | Tomato Sauce        |
| Quantity          | 12                  |
| Status            | Open                |

## Best practices

### Check the delivery location

Always review the delivery location before processing an order.

This is especially important when a customer has multiple locations.

### Review customer messages

Customer messages may contain important delivery or handling instructions.

### Keep statuses updated

Vendors should update order statuses when the order moves through the workflow.

This keeps the order overview useful for the whole team.

### Check missing prices

If prices are missing, the order can still exist, but totals may be incomplete.

Review product prices if your workflow depends on price calculations.

## Common problems

### Order details are not visible

Check that:

* The user is logged in
* The user belongs to the correct company
* The customer-vendor relationship exists
* The order belongs to the selected customer and vendor
* The order has not been deleted or made inaccessible

### Vendor cannot open an order

Check that:

* The logged-in user is connected to the vendor company
* The order belongs to that vendor
* The order is not only a draft or scheduled order
* The order ID is correct

### Customer cannot open an order

Check that:

* The order belongs to the customer's company
* The selected vendor company is correct
* The customer-vendor relationship exists
* The customer is using the correct company account

### Status update fails

Check that:

* The user is a vendor
* The order belongs to the vendor
* The submitted status is valid
* The order still exists

### Product information looks incomplete

Check whether:

* The product still exists
* The article number is available
* The product has a price
* The packaging information is maintained

## Related pages

<CardGroup cols={2}>
  <Card title="Open Orders" icon="inbox" href="/en/vendors/orders/open-orders">
    View orders that still require vendor attention.
  </Card>

  <Card title="Order History" icon="clock-rotate-left" href="/en/vendors/orders/order-history">
    Review previous and current orders.
  </Card>

  <Card title="Email Notifications" icon="envelope" href="/en/vendors/orders/email-notifications">
    Learn how order emails are sent to vendors.
  </Card>

  <Card title="CSV and PDF Attachments" icon="file-lines" href="/en/vendors/orders/csv-pdf-attachments">
    Understand order email attachments.
  </Card>
</CardGroup>
