Skip to content

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

  1. User selects a set of Cards from the Order Queue
  2. User clicks on the Order button and selects “new purchase order” (see below for alternative to add to an existing order).
  3. The system validates the selected cards for compatibility and creates a new Purchase Order.
    1. The system will transition the Cards to the REQUESTED state in the Backend.
  4. 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:

    1. All cards must belong to items that have a compatible Supplier or no supplier defined.
    2. If the cards have a compatible, non-null supplier, that supplier becomes the supplier of the Purchase Order.
    3. Cards will be grouped by item and unit of measure into individual Order Lines.
    4. Each order line will have a quantity equal to the sum of the group of cards.
    5. 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

uml 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

Comments