Order List¶

The order list provides a central overview of all orders in the system. It is provided via the BookingController in the Laravel API and allows filtering, sorting, and managing orders.

Overview¶

The order list is the entry point to the order module. It displays all orders with their current status and key details.

Route: /bookings

List View¶

Column	Description	Sortable
Order Number	Unique identifier of the order	Yes
Customer	Name of the client	Yes
Status	Current processing status	Yes
Order Date	Date the order was created	Yes
Delivery Date	Desired or agreed delivery date	Yes
Items	Number of order items	No
Total	Order total	Yes

The order list offers extensive filtering capabilities:

Status — Filter by one or more statuses (multiple selection)
Customer — Full-text search by customer name or number
Time Period — Filter by order or delivery date (From/To)
Order Number — Direct search by order number
Category — Filter by order category

Tip

Filter settings can be saved as views to quickly access frequently used filter sets.

Status Overview¶

Status	Color	Description
New	Blue	Order has been created but not yet processed
In Progress	Orange	Order is being actively processed
Completed	Green	All items completed, order finished
Cancelled	Red	Order has been cancelled

Bulk Operations¶

Using the checkboxes in the left column, multiple orders can be selected simultaneously. The following bulk actions are available:

Change Status — Move selected orders to a new status
Export — Export orders as CSV or PDF
Delete — Delete selected orders

Warning

Orders with status "Completed" cannot be deleted. They must be cancelled first.

Quick Actions¶

The following actions are available via the three-dot menu in each row:

Edit order
Duplicate order
Export order as PDF
Cancel order

Order History of a Device¶

The device detail view (/v2/inventory/[id]) has an Aufträge (Orders) tab listing every order the device has ever been a line position of — with order number, date, status and customer. Clicking the order number opens the order.

The match runs over the line position (article) with article_type = inventory: if a device sits on several positions of the same order, that order still appears exactly once. Positions of other kinds (catalog articles, device types) do not count.

Order cockpit¶

The detail page of an order opens with the process header: position in the order chain, delivery and billing progress, and the next allowed step. See Order Cockpit.

API Endpoints¶

GET    /api/v2/bookings                    # List with filters and pagination
GET    /api/v2/bookings/{id}               # Retrieve a single order
GET    /api/v2/inventories/{mtag}/bookings # Orders of a device
DELETE /api/v2/bookings/{id}               # Delete order

Permissions¶

Reading the order list requires the booking_view permission. The booking_manage permission is required for editing.