Skip to main content

Order List

The order list shows vendors the orders received from their connected customers. Use it to review incoming orders, open details, check customer information, and follow up on orders that still need processing.

What it is

The order list is the main overview for vendor orders. It helps vendors see:
  • Which orders have been received
  • Which customer placed the order
  • When the order was placed
  • Which delivery location belongs to the order
  • Whether an order is still open
  • Whether more details are available

Who can access it?

The list is available to vendor users. A vendor can only view orders that belong to their own vendor company.
Vendors cannot view orders for other vendor companies.

Data shown in the list

The overview can include information such as:
FieldMeaning
Order IDInternal Mathership order identifier
CustomerCustomer company that placed the order
Delivery locationLocation selected for the order
Placed atDate and time when the order was placed
StatusCurrent order status
MessageOptional message from the customer
ItemsProducts included in the order
The exact fields shown can depend on the user interface and serializer configuration.

Opening the overview

To open the order list:
  1. Go to Vendors
  2. Open your vendor company
  3. Go to Orders
  4. Review the list of received orders
From there, you can open an individual order to view the full details.

Sorting

Orders are normally shown with the newest orders first. This helps vendors see the most recent incoming orders at the top of the list.

Pagination

The list can use pagination. Pagination helps load larger order histories in smaller parts instead of loading all orders at once. Typical pagination values include:
ParameterMeaning
limitNumber of orders to load
offsetStarting point for the list
has_moreShows whether more orders are available
totalTotal number of matching orders
Example:
limit = 20
offset = 0
This means Mathership loads the first 20 orders.

Filtering by customer

Vendors can view all orders for their company or filter by a specific customer. This is useful when a vendor wants to check the order history for one restaurant or customer company. Example use cases:
  • Review all orders from one customer
  • Check whether a customer has placed a recent order
  • Find orders related to a specific customer relationship
  • Support customer service questions

Draft and scheduled orders

Vendor order lists normally exclude orders that are not sent yet. Orders with the following email statuses may be hidden from the standard vendor view:
Email statusMeaning
draftThe order was saved as a draft
scheduledThe order is scheduled for later sending
This prevents vendors from seeing orders that the customer has not actually sent yet.
Draft and scheduled orders are not treated like fully sent orders in the standard vendor order list.

Open orders

Mathership can also show a short list of recent open orders. The dashboard-style open order view can include:
  • The last 10 open orders
  • The total count of open orders
This helps vendors quickly identify orders that may still need attention.

Status

Orders can have a status that helps vendors track processing. The available statuses depend on the order model configuration. A typical workflow may include values such as:
StatusMeaning
OpenOrder still needs processing
In progressOrder is being handled
CompletedOrder has been processed
ArchivedOrder is hidden from normal active views
Archived orders may be excluded from some customer-facing order history views.

Updating status

Vendors can update the status of an order if the order belongs to their vendor company. When updating a status, Mathership checks that:
  • The user is a vendor
  • The order belongs to the vendor company
  • The new status is valid
  • The order exists
If the status is invalid, Mathership rejects the update.
Only vendors can update order statuses.
Order lists can support search fields depending on the view. Search may include values such as:
  • Order number
  • Delivery location
  • Vendor contact
  • Customer-related information
Use search when the list becomes too long to scan manually.

Customer history

Customers can also view order history for a specific vendor relationship. Customer order history is different from the vendor order list.
ViewUsed byPurpose
Vendor order listVendorReview incoming orders
Customer order historyCustomerReview orders placed with a vendor

Overview or details?

The order list is an overview. Order details show the full order.
PagePurpose
Order ListShows many orders in a compact list
Order DetailsShows one order with all order items and details
Use the order list to find an order, then open the details to review the full order.

Typical workflow

A typical vendor workflow looks like this:
  1. Customer sends an order
  2. Mathership creates the order
  3. Mathership sends the order email to the vendor
  4. The order appears in the vendor order list
  5. Vendor opens the details
  6. Vendor checks the items and delivery location
  7. Vendor updates the status when needed

Example: Review new orders

A vendor wants to check recently received orders.
StepAction
1Open the vendor company
2Go to Orders
3Review newest orders first
4Open an order
5Check products, quantities, and delivery location

Example: Find orders for one customer

A vendor wants to review orders from one restaurant.
StepAction
1Open the vendor order list
2Filter by customer
3Review the matching orders
4Open the relevant details

Example: Check open orders

A vendor wants to see orders that still need processing.
StepAction
1Open the vendor dashboard or order overview
2Review recent open orders
3Open each order
4Process the order
5Update the status

Best practices

Review new orders regularly

Check the order list regularly so incoming customer orders are not missed.

Use customer filters

Use customer filters when you need to investigate orders for a specific restaurant or company.

Keep statuses updated

Order statuses help your team understand which orders still need work.

Open details before processing

The list is only an overview. Always open the details before processing an order.

Check delivery locations

Make sure the delivery location is correct before preparing or dispatching the order.

Common problems

Order is not visible

Check that:
  • The order was actually sent
  • The order is not only a draft
  • The order is not scheduled for later
  • You are logged in as the correct vendor
  • You opened the correct vendor company

Vendor cannot access the list

Check that:
  • The user is logged in
  • The user has the vendor role
  • The vendor company belongs to the user

Order belongs to another vendor

Vendors can only access orders for their own company. If an order belongs to another vendor company, access is denied.

Status cannot be updated

Check that:
  • The user is a vendor
  • The order belongs to the vendor company
  • The submitted status is valid
  • The order has not been deleted or hidden

Too many orders are shown

Use pagination, customer filters, or search to narrow the list.

Order Details

View the full details of a single order.

Open Orders

Review recent open orders.

Email Notifications

Learn how order emails are sent to vendors.

CSV and PDF Attachments

Understand order email attachments.

Order Exports

Learn how order data can be exported.

Customer Details

View customer information and delivery locations.
Last modified on May 9, 2026