Skip to main content

Update Order Status

Vendors can update the status of an order after the order has been received. Use order statuses to track whether an order is still open, being processed, completed, or archived.

What is order status?

Order status shows the current processing state of an order. It helps vendors understand:
  • Which orders still need attention
  • Which orders are already being processed
  • Which orders have been completed
  • Which orders should no longer appear in active views

Who can update an order status?

Only vendor users can update order statuses. A vendor can only update orders that belong to their own vendor company.
Vendors cannot update orders from other vendor companies.

Order status data

An order status is stored directly on the order. The exact available status values depend on the order configuration. Typical status values can include:
StatusMeaning
OpenOrder still needs processing
In progressOrder is currently being handled
CompletedOrder has been processed
ArchivedOrder is hidden from normal active views
The frontend should only offer status values that are accepted by Mathership.

Updating an order status

To update an order status:
  1. Open the vendor order list
  2. Open the relevant order
  3. Select the new status
  4. Save the change
Mathership then checks whether the status update is allowed.

Status update rules

When a vendor updates an order status, Mathership checks that:
  • The user is logged in
  • The user has the vendor role
  • The order belongs to the vendor company
  • The submitted status is valid
  • The order exists
If one of these checks fails, the status is not updated.

Successful update

If the order exists, belongs to the vendor, and the new status is valid, Mathership updates the order status. After the update, the order keeps its new status in the order list and order details.

Example: Mark an order as completed

A vendor has finished processing an order and wants to mark it as completed.
StepAction
1Open the order
2Check the order items and delivery location
3Select the completed status
4Save the change
The order is then marked as completed.

Example: Archive an order

A vendor wants to remove an order from active views.
StepAction
1Open the order
2Check that the order no longer needs active processing
3Change the status to archived
4Save the change
Archived orders may be excluded from some active order views.

Common problems

User is not a vendor

Only vendor users can update order statuses. If a customer tries to update an order status, Mathership rejects the update.

Order does not belong to vendor

A vendor can only update orders that belong to their own vendor company. If the order belongs to another vendor, access is denied.

Invalid status

If the submitted status is not part of the allowed order status values, Mathership rejects the update. Check that the selected status is available in the user interface.

Order cannot be found

Check that:
  • The order ID is correct
  • The order belongs to the vendor company
  • The order has not been deleted or hidden
  • The vendor is logged into the correct company

Best practices

Keep statuses updated

Update order statuses regularly so the team can clearly see which orders still need work.

Use consistent status values

Only use status values that are available in Mathership.

Check order details first

Open the order details before changing the status to make sure the correct order is being updated.

Avoid unnecessary archiving

Only archive orders when they no longer need to appear in active order views.

Order List

View and manage received orders.

Order Details

View all details of a single order.

Open Orders

Review orders that still need processing.

Order Exports

Learn how order data can be exported.
Last modified on May 6, 2026