> ## 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 History

> View, search, filter, export, archive, and open previous, draft, and scheduled orders

# Order History

Order History shows the orders created by your restaurant company.

Use it to review previous orders, find drafts and scheduled orders, check order status, open order details, export the order list, and archive orders that no longer need to appear in the active list.

<CardGroup cols={3}>
  <Card title="Find orders quickly" icon="search">
    Search and filter orders by vendor, status, delivery location, dates, and transfer status.
  </Card>

  <Card title="Review details" icon="clipboard-list">
    Open an order to review products, quantities, delivery location, dates, totals, and status.
  </Card>

  <Card title="Export or archive" icon="download">
    Download the order list as CSV or archive selected orders from the active view.
  </Card>
</CardGroup>

## What Order History is used for

Use Order History when you want to:

* Review previous orders
* Find a draft or scheduled order
* Check the status of an order
* See which vendor an order belongs to
* Check the delivery location used on an order
* Review delivery or estimated delivery dates
* See whether order items still need inventory transfer
* Open full order details
* Export the order list as CSV
* Archive orders you no longer need in the active list

## Access Order History

To open Order History:

<Steps>
  <Step title="Open Orders">
    Go to the ordering area in Mathership.
  </Step>

  <Step title="Open Order History">
    Select **Order History**.
  </Step>

  <Step title="Review the order list">
    Use the table, filters, search field, and column controls to find the order you need.
  </Step>
</Steps>

If you manage multiple companies or locations, make sure the correct company is selected before opening Order History.

## What the table shows

The Order History table shows orders for the selected company.

Each row represents one order.

| Column             | Description                                                                    |
| ------------------ | ------------------------------------------------------------------------------ |
| Order #            | Order number or internal order ID                                              |
| Vendor             | Vendor or vendor contact                                                       |
| Location           | Delivery location                                                              |
| Transferred        | Whether the order still has items waiting to be transferred into inventory     |
| Date               | Order creation or placed date                                                  |
| Delivery date      | Actual delivery date, if available                                             |
| Estimated delivery | Estimated delivery date, hidden by default but available in table view options |
| Items              | Number of order items                                                          |
| Total              | Total order value, where visible                                               |
| Status             | Current order status                                                           |

<Note>
  The **Estimated delivery** column can be shown through the table view options.
</Note>

## Order statuses

Order History supports several order statuses.

| Status    | Meaning                                           |
| --------- | ------------------------------------------------- |
| Draft     | Order is saved but not sent yet                   |
| Scheduled | Order is prepared for later sending               |
| Pending   | Order has been sent or is waiting for processing  |
| Failed    | Order could not be processed or sent successfully |
| Received  | Order has been received                           |
| Preparing | Vendor is preparing the order                     |
| Completed | Order has been completed                          |
| Cancelled | Order has been cancelled                          |

Status names may appear as badges in the table.

## Search orders

Use the search field to find orders quickly.

Search is useful when you know part of the order information, such as:

* Order number
* Vendor name
* Vendor contact
* Delivery location
* Other searchable order text, depending on available order data

The search updates automatically after a short delay.

The result count is shown in the search field area.

## Filters

Order History supports several filters.

| Filter            | Description                                                      |
| ----------------- | ---------------------------------------------------------------- |
| Vendor            | Show orders for one vendor or vendor contact                     |
| Status            | Show orders with selected statuses                               |
| To transfer       | Show orders that still have items waiting for inventory transfer |
| Delivery date     | Filter by delivery date range                                    |
| Created date      | Filter by order creation date range                              |
| Delivery location | Show orders for one delivery location                            |

Click **Add filter** to show optional filters such as delivery date, created date, or delivery location.

Click **Clear all** to reset filters.

## Saved filters

Order History can remember filters for the selected company.

When you navigate away and return, your previous filters may still be applied.

The search text itself is temporary and is not treated as a permanent saved filter.

Use **Clear all** if you want to return to the default view.

## Vendor filter

Use the **Vendor** filter to show orders for a specific vendor.

The filter can include:

* Connected vendor companies
* Vendor contacts

This helps when you want to review all orders related to one supplier.

## Status filter

Use the **Status** filter to focus on a specific order workflow.

Common examples:

| Goal                            | Status filter |
| ------------------------------- | ------------- |
| Find unfinished orders          | Draft         |
| Find orders scheduled for later | Scheduled     |
| Check failed orders             | Failed        |
| Review completed orders         | Completed     |
| Review cancelled orders         | Cancelled     |

You can select more than one status at the same time.

## To transfer filter

Use **To transfer** to find orders with products still waiting to be transferred into inventory.

This is useful for inventory workflows when received or ordered products still need to be posted into stock.

The **Transferred** column shows a visual indicator:

| Indicator  | Meaning                                |
| ---------- | -------------------------------------- |
| Check mark | No items are waiting to be transferred |
| X mark     | Items still need to be transferred     |

<Note>
  The uploaded frontend currently shows the dedicated transfer preview page as a placeholder. The Order History table still exposes the transfer status so users can identify orders that need inventory attention.
</Note>

## Delivery date filter

Use the **Delivery date** filter to find orders by delivery period.

This is helpful when you want to review orders delivered or expected during a specific week, month, or accounting period.

## Created date filter

Use the **Created date** filter to find orders based on when they were created.

This is useful when you remember when an order was placed but not when it was delivered.

## Delivery location filter

Use the **Delivery location** filter to show orders for one location.

This is useful for:

* Multi-location restaurants
* Central kitchens
* Storage-specific purchasing
* Delivery-location reporting
* Reviewing orders for one branch

## Sorting

Some columns can be sorted.

Sortable columns include:

* Order #
* Date
* Delivery date
* Estimated delivery
* Items
* Total

Click a sortable column header to change the sort direction.

Sorting resets the table to the first page.

## Pagination

Order History is paginated so it stays fast even with many orders.

You can change:

* Current page
* Page size

The default page size is 20 rows.

## Table view options

Use table view options to show or hide available columns.

For example, **Estimated delivery** is hidden by default but can be enabled if you need it.

## Open order details

Click an order row to open the full order details.

The detail view can show saved order information such as:

* Order number
* Vendor or vendor contact
* Products
* Quantities
* Product information
* Delivery location
* Order message, if one was added
* Order status
* Order date
* Estimated delivery date
* Delivery date, if available
* Total value, where visible

Orders linked to a vendor can open in a vendor-specific order detail view.

Orders created from My Inventory open in the My Inventory order detail view.

## Draft and scheduled orders

Draft and scheduled orders can appear in Order History.

Use the **Status** filter to find them.

Depending on available actions in the order detail view, you may be able to:

* Review a draft
* Send a draft
* Review a scheduled order
* Change a scheduled time
* Send a scheduled order immediately

Only draft and scheduled orders can usually be changed before sending.

Orders that have already been sent cannot be edited in the same draft workflow.

## Export Order History as CSV

Use the **CSV** button to download the order list.

The CSV export follows the active filters.

For example, if you filter by vendor, status, delivery location, or date range, the CSV download uses those filters.

<Steps>
  <Step title="Open Order History">
    Go to **Order History**.
  </Step>

  <Step title="Apply filters if needed">
    Filter by vendor, status, delivery location, delivery date, created date, or transfer status.
  </Step>

  <Step title="Click CSV">
    Use the **CSV** button in the toolbar.
  </Step>

  <Step title="Open the downloaded file">
    Open the CSV file in a spreadsheet program if needed.
  </Step>
</Steps>

<Note>
  CSV export is for the order list. It is different from an individual order attachment.
</Note>

## Archive orders

You can select one or more orders and archive them.

Archived orders are removed from the active Order History list.

Archiving does not necessarily delete the order permanently. It removes it from the normal active order view.

<Steps>
  <Step title="Select orders">
    Use row selection in Order History.
  </Step>

  <Step title="Click Archive">
    Use the archive action in the table footer.
  </Step>

  <Step title="Confirm">
    Confirm the archive dialog.
  </Step>
</Steps>

If one order is selected, the confirmation dialog shows the order number.

If multiple orders are selected, it shows the number of selected orders.

## Archived orders

Archived orders are hidden from the regular active Order History view.

Existing information stays associated with the order.

Use archiving when an order no longer needs to appear in your active list.

## Company-specific order history

Order History belongs to the selected company.

If you manage multiple companies or locations:

1. Switch to the correct company
2. Open Order History
3. Review orders for that company only

Orders from one company are not automatically shown in another company's Order History.

## Multi-order note

The uploaded frontend scripts show dedicated multi-order pages as placeholders.

For now, this page focuses on the active Order History table and My Inventory order detail behavior.

<Note>
  Multi-order history should be documented separately once the multi-order user interface is active.
</Note>

## Common workflows

### Find a draft order

1. Open **Order History**
2. Open the **Status** filter
3. Select **Draft**
4. Click the order row to open details

### Find scheduled orders

1. Open **Order History**
2. Open the **Status** filter
3. Select **Scheduled**
4. Review the listed orders

### Find orders for one vendor

1. Open **Order History**
2. Use the **Vendor** filter
3. Select the vendor or vendor contact
4. Review the matching orders

### Find orders for one delivery location

1. Open **Order History**
2. Click **Add filter**
3. Select **Delivery location**
4. Choose the location
5. Review the matching orders

### Find orders that still need inventory transfer

1. Open **Order History**
2. Enable **To transfer**
3. Review rows with the transfer indicator
4. Open the order to review details

### Export a filtered order list

1. Open **Order History**
2. Apply the filters you need
3. Click **CSV**
4. Open the downloaded CSV file

### Archive old orders

1. Open **Order History**
2. Select one or more orders
3. Click **Archive**
4. Confirm the dialog

## Best practices

<CardGroup cols={2}>
  <Card title="Use filters first" icon="filter">
    Narrow the list by vendor, status, location, or date before searching manually.
  </Card>

  <Card title="Check the company" icon="building">
    Make sure you are viewing the correct company before reviewing or exporting orders.
  </Card>

  <Card title="Review transfer status" icon="package-check">
    Use the To transfer filter when working with inventory receiving.
  </Card>

  <Card title="Export with filters" icon="file-csv">
    Apply filters before downloading CSV so the export contains only the orders you need.
  </Card>

  <Card title="Archive finished work" icon="archive">
    Archive orders that no longer need to appear in the active list.
  </Card>

  <Card title="Use table options" icon="columns">
    Show optional columns such as Estimated delivery when they help your workflow.
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="I cannot see an order">
    Check that:

    * You are using the correct company
    * Filters are not hiding the order
    * The order was successfully created
    * The order has not been archived
    * You have permission to view orders for this company
  </Accordion>

  <Accordion title="Search does not find my order">
    Try clearing filters first.

    Then search by order number, vendor, vendor contact, or delivery location where available.
  </Accordion>

  <Accordion title="The CSV does not contain the orders I expected">
    The CSV uses the current filters.

    Clear filters or adjust them before downloading again.
  </Accordion>

  <Accordion title="I cannot edit an order">
    Only draft and scheduled orders can usually be edited before sending.

    Sent orders cannot be edited in the same way.
  </Accordion>

  <Accordion title="I archived the wrong order">
    Archived orders are removed from the active list.

    Contact an administrator or support if you need help recovering or reviewing archived orders.
  </Accordion>

  <Accordion title="The transfer indicator looks wrong">
    Open the order detail and review the order items.

    Inventory transfer status depends on whether order items still need to be transferred into inventory.
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={3}>
  <Card title="Placing Orders" icon="cart-shopping" href="/en/restaurants/ordering/placing-orders">
    Learn how to add products, review the cart, and create an order.
  </Card>

  <Card title="Shopping Basket" icon="basket-shopping" href="/en/restaurants/ordering/shopping-basket">
    Review selected products and quantities before creating an order.
  </Card>

  <Card title="Order Drafts and Scheduling" icon="clock" href="/en/restaurants/ordering/order-drafts-and-scheduling">
    Save orders as drafts or schedule them where available.
  </Card>

  <Card title="Order Attachments" icon="paperclip" href="/en/restaurants/ordering/order-attachments">
    Understand PDF and CSV order attachments.
  </Card>

  <Card title="Delivery Locations" icon="location-dot" href="/en/restaurants/settings/delivery-locations">
    Manage delivery locations used on orders.
  </Card>

  <Card title="Receiving Orders" icon="boxes-stacked" href="/en/restaurants/inventory/receiving-orders">
    Receive ordered products into inventory.
  </Card>
</CardGroup>
