Skip to content

Add new Lines from a set of Kanban Cards to a Purchase Order

Add new Lines from a set of Kanban Cards to a Purchase Order

Given an existing Draft Purchase Order, the user can add new lines to it by selecting additional sets of Kanban Cards.

Use Case

  1. User selects a set of Cards from the Order Queue
  2. User clicks on the Order button and selects “add to existing order”
  3. The system presents a selection of the orders that the user can add the cards to. These are the Orders in the NEW status, ordered in most-recent first.
  4. User selects an order and clicks on Add
  5. The system validates the selected cards for compatibility with the selected order.
  6. The system adds the new lines to the order and displays the updated order.

    1. The added cards are transitioned to the REQUESTED status by the backend.

    The Logic to create the Purchase Order from the selected cards is the same as the Create Purchase Order from Kanban Cards use case, with the following exceptions:

    1. If All selected cards do not belong to items that have a compatible Supplier with the selected order, or no supplier defined, the system will show an error.
    2. Cards that are compatible with pre-existing lines (same item and unit of measure) will be added to existing lines.
    3. Cards that are not compatible with pre-existing lines (different item or unit of measure) will be added as new lines, grouped as in the create use case.

Sequence Diagram

uml diagram

API Routes

Note

For details see the OpenApiSpecification
This is the authoritative source for the specific routes.

Step Route Notes
List Order Headers with Status NEW POST /v1/order/order/query Body is a query object with a filter for status NEW and page = 0, it returns a page of Order Header Records.
Add Cards to Order PUT /v1/order/order/from-kanban-cards/{eId} Body is a list of Card EIds, it returns the Updated Full Order Record.
List Cards in Status REQUESTING POST /v1/kanban/kanban-card/query Body is a query object with a filter for status REQUESTINGand page = 0, it returns a page of Kanban Card Records.

Copyright: © Arda Systems 2025-2026, All rights reserved

Comments