State Transition
Define the lifecycle statuses and transitions for each document type. Status names appear throughout the cockpit.
Use State Transition to define the workflow statuses that documents can move through for each document type. These names appear on documents, in Inbox Queues, and on the Dashboard.
Open Configuration → State Transition in the side menu.

Configuration lifecycle
Statuses and transitions are scoped to a document type. All sub-types of that document type share the same workflow; use transition conditions when sub-types need different paths.
Changes take effect as soon as you select Save. There is no draft or deployment step. Existing documents keep their current status until the state machine runs and moves them; saving a configuration does not reprocess documents.
Status list
Statuses are grouped by document type tabs (for example Non PO Invoice, Order, or PO Invoice). For the selected type, the table shows:
Code – Stable identifier for the status
Name – Label shown in the cockpit
Terminal – Yes if the status ends the workflow, otherwise No
Transitions – Number of outgoing transitions from this status
Select New status to add a status for the active document type. Use the row's Edit or Delete action at the end of the row. Status flow appears below the table.
Status flow
Status flow shows how statuses connect. The small circle at the top is a diagram element, not the runtime initial status. The diagram treats every status with no incoming transition as a root. Runtime initialization instead uses the status code START, whether or not that status is a diagram root. Each arrow can show a condition – the rule that decides whether that path applies. When the transition always applies, the arrow has no condition. Terminal statuses are highlighted.
The example below is an Order flow: Start → Parsed, then Validation Errors or Pending Approval. From Pending Approval, the document can move to Approved or Rejected.

Creating or editing a status
Set the basic details
Provide:
Status code – Uppercase when you create the status. Read-only when you edit.
Name – English display label shown in the cockpit.
Document type – The type this status belongs to.
Each Status code must be unique within its document type. Choose a code you can keep because it cannot be changed after creation.
Avoid changing Document type on an existing status. The change does not retarget incoming transitions or documents that already use its code.
Add outgoing transitions
Under Transitions, select Add transition for each allowed next step. Configure the fields described in Transition settings.
Transition settings
Each outgoing transition sets when it applies, which status comes next, and whether a function or assignment follows:
Condition – Empty when the transition always applies. Otherwise an expression.
Priority – Evaluation order. The first matching condition wins.
Target status – The next status.
Cloud function – Optional tenant function that runs after the transition. None when the transition does not call a function.
Assignment – Optional User, Group, or Reference field. No assignment leaves the current assignment unchanged.
A Reference field reads a non-empty user ID from the document at transition time, without checking IAM. Use a unique Priority for every outgoing transition. Transition order is controlled by these numbers, not drag handles. When priorities are equal, stored row order determines evaluation, but that order is not a safe workflow contract.
An empty condition always passes. If a condition cannot be parsed or evaluated, it is treated as not matched. Test conditions with representative document values.
The new status and assignment are saved before the transition's cloud function runs. A function failure does not roll back the status or assignment.
Under Cloud function, use Type to search… to find a tenant function.

Under Assignment, choose No assignment, User, Group, or Reference field. Use Type to search… to filter this list. When the type is User, select the employee.

Open the Condition cell to build a rule with Compare, or enter it as an Advanced expression. Use Add condition and Add group to extend the rule. The dialog groups rows under AND. In the figure, Compare checks that mixins.documentMetadata.approvalStatus equals ACCEPTED, and Advanced expression shows document.mixins.documentMetadata.approvalStatus == 'ACCEPTED'. Select Apply to save the condition, or Cancel to discard it.

Each invocation evaluates the current status and takes at most one outgoing transition. The first passing transition by Priority wins. If no transition matches, the status does not change. If a non-terminal status has no outgoing transitions, confirm that the workflow is intentionally parked.
Statuses in day-to-day work
The status you configure appears in the views used to track a document:
As status badges on Documents and in Managing Documents.
In Inbox Queues filters and the Progress column, when configured.
In document History, under Status history.
On the Dashboard, in In workflow and Completed summaries.
A document leaves a status such as Parsed when document-status-state-machine runs after the fields used by its conditions have been updated, and one outgoing transition passes. See Managing Documents.
Last updated
Was this helpful?


