Delivery Status Workflow
Configure the stages a delivery moves through and the buttons that move it from one stage to the next.
Overview
The Delivery Status Workflow is one of the configurable workflows under Settings β Workflows. It defines a set of stages (the statuses a delivery can be in) and the connections between them (the allowed moves from one stage to the next, each shown as an action button).
This is a generic workflow editor β the same screen is used for the Purchase Request and Liquidation workflows. For deliveries, the workflow code is delivery.
Opening the Page
- Click Settings in the sidebar.
- Open Workflows.
- Click Delivery Status Workflow.
The page heading reads Delivery Status Workflow, with the breadcrumb Settings β Delivery Status Workflow.
Page Layout
The page shows the current workflow as two read-only tables, plus a button to open the visual editor.
- Flow Chart button (top right) β opens the fullscreen visual editor where you add stages and draw connections.
- Stages table β lists every stage in the workflow.
- Connections table β lists every allowed move between stages.
Stages Table
| Column | Description |
|---|---|
| # | Row number |
| Color | The stage's accent color swatch |
| Name | The stage name (e.g. the status shown on a delivery) |
| Key | The stage's internal key (uppercase, underscores) |
| Type | Start for the first stage (no incoming connections) or End for a final stage (no outgoing connections); blank otherwise |
| Assignee | Who acts on the stage β Department, Role, User, or Supervisor β if set |
The heading shows the stage count, e.g. Stages (5).
Connections Table
| Column | Description |
|---|---|
| From Stage | The stage the delivery moves from |
| To Stage | The stage the delivery moves to |
| Button Name | The label on the button that performs the move |
| Button Color | The button's color swatch |
| Dialog Type | The dialog shown when the button is pressed (if any) |
The heading shows the connection count, e.g. Connections (4).
First-Time Setup
If no workflow has been configured yet, the page shows the message "No workflow configured for Delivery Status Workflow." with a single button:
- Click Create Workflow.
- The empty workflow is created and the Stages and Connections tables appear (both empty).
- Click Flow Chart to begin adding stages and connections.
Common Tasks
Adding a Stage
Stages are added from the visual editor.
- Click Flow Chart to open the fullscreen editor.
- Click Add Stage in the toolbar.
- In the Add Stage dialog, enter the Stage Name (required) β for example, "Pending Approval".
- A Key is generated automatically from the name (uppercase letters and underscores). It is shown below the name field.
- Click Add Stage to save, or Cancel to discard.
The new stage appears on the canvas with a default blue accent color.
You cannot create two stages with the same key. If the generated key already exists, the dialog shows "A stage with this key already exists."
Editing a Stage
- In the Flow Chart, click a stage to open the Stage Details panel on the right.
- Edit the fields:
- Name β the stage name.
- Key β read-only; it cannot be changed after creation.
- Accent Color β pick from the preset color swatches, or use the custom color picker.
- Click Save to apply, or Close to discard.
Deleting a Stage
- In the Flow Chart, hover over the stage and click the β button in its corner.
- Confirm the prompt "Delete stage β¦ ?".
Connecting Stages
A connection is the allowed move from one stage to the next, shown to users as an action button.
- In the Flow Chart, drag from a connection point (the small dots on the top, right, bottom, and left edges of a stage) to the target stage.
- Release on the target stage to create the connection. New connections default to a button named Submit.
The editor prevents:
- Loops β a connection that would create an infinite cycle is rejected ("Cannot create this connection as it would create an infinite loop.").
- Duplicates β a second connection between the same two stages is rejected ("A connection already exists between these stages.").
Editing a Connection
- In the Flow Chart, click the connection line (or its label) to open the Connection Details panel.
- The panel shows the move as From Stage β To Stage. Edit:
- Button Name β the label on the action button (e.g. "Submit", "Approve").
- Button Color β pick from the preset swatches or the custom color picker.
- Click Save to apply, Delete to remove the connection (with confirmation), or Close to discard.
Arranging the Diagram
In the Flow Chart you can:
- Drag a stage to reposition it; the layout is saved automatically.
- Add Stage / + / β / Fit toolbar buttons β add a stage, zoom in, zoom out, or fit the whole diagram to the screen. The current zoom percentage is shown next to the buttons.
- Pan by dragging an empty area of the canvas, and zoom with the mouse wheel.
Close the editor with the β in the fullscreen header to return to the tables.
Start and End Stages
You do not set start/end stages manually β the editor detects them automatically:
- A stage with no incoming connections is marked Start.
- A stage with no outgoing connections is marked End.
These badges appear on the stage card in the Flow Chart and in the Type column of the Stages table.
Related Pages
- Purchase Request Workflow β same editor, configures the purchase-request workflow
- Liquidation Workflow β same editor, configures the liquidation workflow
π‘ Note: Changes you make here take effect across the system wherever the delivery workflow is used. Plan the stages and connections so each move maps to a clear action button users will understand.