Appearance
Documents and their states
Also known as
- state machine
- status
- workflow
- draft
- posted
- cancelled
- stage rail
- lifecycle
- document number
- void
Every business document in Roari ERP (purchase order, sales order, journal entry, vendor bill, goods receipt, leave request, work order …) moves through a fixed set of states. The document page always shows where it is, what happened so far and what you can do next. This page explains the parts every document page shares, so you can read any of them the same way.
The parts of a document page
| Part | Where | What it tells you |
|---|---|---|
| Number and status | Header, top left | The document number (from Numbering sequences) and a coloured status tag, for example Pending approval or Posted. A new document has no number until you save it. |
| Actions | Header, top right | Only the actions the current state allows: Submit for approval, Recall, Post, Send to vendor, Cancel order, Void, Reverse … The main action is the dark button. |
| Banners | Above the form | Why you cannot edit (for example "Approvals are decided in the approvals inbox." with Open approvals inbox), a rejection reason, a hold reason. |
| Form and lines | Main column | The header fields and the lines. Fields are greyed out once the document has left Draft. |
| Stage panel | Right column | The stage rail: the states in order. Done stages show a filled diamond, the current one is gold, the next ones are outlined. A cancelled or rejected document shows the current stage in red. |
| Totals | Right column | Subtotal, tax, total and, where it applies, received, billed or paid amounts. |
| Approvals | Right column | The approval request, its steps and who must decide. See Approvals workflow. |
| Attachments | Right column | Files on the document. See Attachments. |
| Activity | Right column | Who did what and when, with the field changes. See Audit trail and activity. |
On a narrow screen (below about 1,000 pixels) the right column moves under the form.
Read the stage rail
- Open the document from its list (select the row or press Enter on it).
- Look at the Stage panel. The gold diamond is the state the document is in now.
- Read the date and person under a done stage (for example the time the order was confirmed or shipped) when the document records them.
- To see every change in detail, open Show changes under an entry in the Activity panel.
The rail shows the main path. Side states such as On hold, Credit hold, Partially shipped or Part paid appear as a status tag on the stage they belong to.
Common states
Each module documents its own states on the document's page. Most documents follow the same pattern:
| Status | Meaning | What you can do next |
|---|---|---|
| Draft | Saved, not yet in effect. Nothing has moved in stock or the ledger. | Edit, delete lines, Submit for approval or post/confirm directly, cancel. |
| Pending approval (rail: Approval) | Waiting for the approvers of the matching approval rule. The document is read-only. | The requester can Recall it to draft; approvers decide in Approvals. |
| Approved | Every approval step agreed. | The next business step: send the order, post the bill, release the work order. |
| Confirmed / Sent / Released | Committed to a customer, vendor or the shop floor. | Receive, ship, issue, invoice. |
| Partially … (Receiving, Part paid, Partially shipped) | Some of the quantity or amount is done. | Continue with the remaining quantity. |
| Posted | Written to the general ledger. Amounts and accounts can no longer change. | Pay or collect, Reverse (journals), Void (bills and invoices), issue a credit note. |
| Closed / Paid / Completed | Finished. Nothing more is expected. | Read only. |
| Cancelled / Rejected / Void | Stopped. Cancelled and rejected documents never posted; a voided document's posting is reversed. | Read only; copy it (Duplicate) if you need it again. |
When nothing needs approving (no rule matches) a submitted document goes straight to Approved and you see a message such as "PO-2026-00045 approved (no approval rule applies)".
Change a document after it has left Draft
You cannot edit a document that is waiting for approval or posted. Use the action that fits the state:
| You want to | On | Do this |
|---|---|---|
| Change something while it waits for approval | Any document in Approval | Select Recall (sales orders: Back to draft). It returns to Draft; edit and submit again. The pending request is cancelled. |
| Correct a posted journal | Journal entry | Select Reverse, pick the date. A mirror entry is posted and the original becomes Reversed; both stay in the ledger. Then post a new, correct entry. |
| Undo a posted bill or invoice | Vendor bill, customer invoice | Select Void and give a Reason. The posting is reversed. This cannot be undone. For a partial correction, post a credit note instead. |
| Change a sent purchase order | Purchase order | Revise it: the order returns to draft as the next revision and needs approval again; received quantities are kept. |
| Stop a document that has not posted | Order, requisition, RFQ, return … | Select Cancel … and confirm. Orders with receipts or bills cannot be cancelled; close them instead. |
Posting into a closed period
Posting needs an open accounting period. If the document's date falls in a closed or locked period you see "Period … is closed; postings are not allowed". Change the date or ask finance to reopen the period (Close and report).
What a transition does elsewhere
Many transitions have effects in other modules, inside the same save: shipping moves stock and posts cost of goods sold, receiving goods posts to inventory and GRNI, posting a bill clears GRNI against payables. The process pages show these effects step by step with their ledger entries:
- Order to cash and Procure to pay
- Plan to produce and Quality hold and rejection
- Project to bill, Hire to pay, Service to cash
If a transition is not allowed in the current state (for example someone else posted the document a moment ago) you see "Cannot change status from … to …". Reload the page to see the current state.
Where you find documents with states
| Module | Documents (examples) |
|---|---|
| Finance | Journal entry, Vendor bill, Customer invoice, Payment run |
| Procurement | Requisition, Purchase order, Blanket order |
| Sales & CRM | Quote, Sales order, Return |
| Inventory | Goods receipt, Shipment, Adjustment |
| Manufacturing | Work order, Engineering change order |
| People | Leave request, Pay run, Job offer |
| Projects | Timesheet, Expense claim, Project invoice |
| Quality | Inspection, Non-conformance, CAPA |
| Service | Case, Service work order |
| Assets | Maintenance work order |
Differences by role
- Who may run a transition depends on the module's permissions (for example
finance.journal.postto post a journal). Without the permission the button is not shown. See Permissions and segregation of duties. - Documents are never deleted once they have a number: they are cancelled, voided or reversed, so the history stays complete.
