---
title: "Common conventions"
space: "BuildSuite Core"
url: "https://wiki.buildsuite.io/core/introduction/common-conventions"
updated: "2026-11-16"
---

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**.