Purchase Orders (Q2 2026)

Note

This is a snapshot of the purchase order system as it ships in Q2 2026. The designed replacement (build pending) is the Orders module, tracked by the Orders with Lifecycle project.

Consolidation of procurement demand into vendor commitments — PO creation, line management, editing, submission, document generation (vendor-ready PDFs), and the data rules that govern line pre-population from Item / ItemSupply. As orders are created and submitted, the workflow advances Kanban Cards through REQUESTING → REQUESTED → IN_PROCESS. Canonical use cases: PRO::PO.

Business workflow

The procurement workflow moves kanban cards through the ordering and receiving lifecycle:

1. Cards for an item are listed from the Items view.
2. A card is added to the procurement queue by sending it the ACCEPTED signal, which transitions it to the REQUESTED state.
3. The user reviews the procurement queue: a list of all cards in REQUESTED state, grouped by Vendor and Order Method.
4. The user selects cards and orders them:
   • For online orders: the item URL for the vendor opens.
   • For other methods (e-mail, phone, etc.): a side panel displays message text for the user to send manually.
5. The Order action sends a start_processing signal, transitioning the card to IN_PROCESS.
6. The Receiving view shows all IN_PROCESS cards. Receiving a card sends the receive signal, transitioning it to FULFILLED.

Kanban card state mapping

Workflow step	Kanban card state
Added to queue	REQUESTED
Order placed	IN_PROCESS
Item received	FULFILLED

The workflow uses the standard Kanban Cards Module lifecycle transitions.

Detailed subtopics

Page	Contents
Order Creation	Creating purchase orders from Kanban Cards, empty orders, copy of existing order, and from prescribed header and lines
Order Line Management	Adding single lines, adding lines from cards or items, and removing lines from a draft order
Order Lifecycle	Updating order headers, viewing and listing orders, processing an order through its states, and submitting to vendors
Order Implementation Notes	Data model changes, UI/UX information structure, and Kanban Card/Item dependency propagation rules

Linear

• Initiative: Product / Procurement / Purchase Orders

API

• OpenAPI: https://dev.alpha002.io.arda.cards/v1/order/docs/openApi.json
• Swagger UI: https://dev.alpha002.io.arda.cards/v1/order/docs/openapi/index.html