These rules apply to every BuildSuite form and list. The other pages describe only what differs.
Document states
Records that affect quantities or money follow the standard Frappe states. This covers purchase documents, work orders, measurements, bills, attendance, expenses and invoices.
| State | What it means | What you can do |
|---|---|---|
| Draft | Saved, not final. Nothing is posted yet | Edit, Delete, Submit |
| Submitted | Final. Stock, cost and accounts are updated | Cancel, plus actions such as Make Payment or Print / PDF |
| Cancelled | Withdrawn and reversed. Kept for history | Amend |
| Amended | A new draft copy of a cancelled record, with a suffix (for example SWO-2026-00016-1) | Edit and submit like any draft |
Note: A submitted record can’t be edited. To correct it, cancel it, amend the copy and submit it again. Records created from another record, such as the attendance registers created from a Field Attendance sheet, are corrected through the original record.
Two badges on one record
Many records show two badges side by side:
- Status and approval, for example Pending · Approved on a material request, or Draft · Pending PM Approval.
- Status and payment, for example Submitted · Partly Paid on a bill.
Lists
Every list has the same tools:
| Tool | What it does |
|---|---|
| Search | Finds records by ID, name or other key fields |
| Status / project / party filters | Narrow the list |
| + Add filter | Filter by any field |
| Sort by | Change the order |
| Columns | Show or hide columns |
| Rows per page | 10, 20, 50 or 100 |
Creating and deleting
- Click + New on a list. Fields marked * are mandatory.
- Delete is offered only on drafts and on records nothing else uses. Use Inactive or Disabled to retire masters such as subcontractors, users or equipment.
Company
A project belongs to one company, chosen when the project is created. Every record under the project takes the same company automatically. When company awareness is on, the company switcher in the top bar limits every list and picker to the selected company. On a one-company site, the company is filled in for you. Shared masters such as the Rate Master have no company.
Cost codes
A cost code is a BOQ group or line, for example A.02 · RCC M30 slab. Material requests, purchase orders, work orders, measurement books, attendance, consumption and expenses can each carry a cost code. Their cost then lands on that part of the estimate as committed (orders) or actual (receipts, bills, attendance, consumption, expenses).
Tip: A line without a cost code is still recorded, but its cost stays outside the estimate, so code everything that belongs to the BOQ.
Amounts and dates
- Amounts are in the company currency, with Indian grouping (₹1,51,200). Large figures on dashboards are shortened, for example ₹1.8L or ₹1.13 Cr.
- Aging on invoices and bills counts from the due date.