Create a Purchase Order from a set of Kanban Cards
Create a Purchase Order from a set of Kanban Cards¶
In MVP2, the main way to create a Purchase Order is from a set of Cards that are in the Order Queue.
Use Case¶
- User selects a set of Cards from the Order Queue
- User clicks on the Order button and selects “new purchase order” (see below for alternative to add to an existing order).
- The system validates the selected cards for compatibility and creates a new Purchase Order.
- The system will transition the Cards to the
REQUESTEDstate in the Backend.
- The system will transition the Cards to the
-
The system then opens the Purchase Order for editing and the use case continues as described in the next section, allowing the user to Edit the HEADER properties of the Purchase Order.
The Logic to create the Purchase Order from the selected cards is:
- All cards must belong to items that have a compatible Supplier or no supplier defined.
- If the cards have a compatible, non-null supplier, that supplier becomes the supplier of the Purchase Order.
- Cards will be grouped by item and unit of measure into individual Order Lines.
- Each order line will have a quantity equal to the sum of the group of cards.
- Unit Costs, Line Costs and Goods Value will be calculated based on the total quantity of the card group and the price of the item from the supplier.
Sequence Diagram¶
API Routes¶
Note
For details see the OpenApiSpecification
This is the authoritative source for the specific routes.
| Step | Route | Notes |
|---|---|---|
| Create Order | POST /v1/order/order/from-kanban-cards |
Body is a List of Card EIds, it returns the Created Order Record |
| Update Header | PUT /v1/order/order/{eId} |
Body is the updated Order Header as an OrderHeaderInput value, it returns the Updated OrderHeader Record |
Copyright: © Arda Systems 2025-2026, All rights reserved