انتقل إلى المحتوى الرئيسي

BOQ — Bill of Quantities

The BOQ is the priced quantity list that defines what your team will deliver and how each line gets paid. In ORKSTRA, the BOQ is the spine the rest of finance hangs off — IPCs, variations, cost reports, cash-flow forecasts all read from the BOQ.

Overview​

A project has at least one BOQ. The BOQ has a stable structure (code, description, unit, planned quantity) and a revision chain that grows as the project absorbs variations. Each revision is immutable once locked — past IPCs always cite a specific revision so the audit chain holds.

Screenshot: BOQ table with grouping, rates, planned vs. claimed columns

Key concepts​

Line. A single BOQ row — code, description (AR + EN), unit, planned quantity, unit rate, currency. Lines can be standalone or grouped into sections.

Section. A logical grouping (e.g., "1. Earthworks", "2. Substructure"). Sections roll up totals.

Revision. A snapshot of the BOQ at a point in time. New revisions are created when variations are absorbed or when scope changes are formalized.

Locked vs. open. A revision is open while being edited and locked once it's used for the first IPC. Locked revisions cannot be edited; you must create a new revision instead.

Bilingual. Every BOQ line stores AR and EN descriptions. AR descriptions appear when the user's locale is Arabic; EN appears when English. Both export to PDFs.

Step-by-step: create a BOQ from scratch​

  1. Go to Project → BOQ → New BOQ.
  2. Pick a template (optional) — e.g., FIDIC standard layout.
  3. Add sections in order.
  4. Inside each section, add lines: code, AR + EN descriptions, unit, planned quantity, rate.
  5. Save — the BOQ is now in revision v1, open.
  6. Click Lock revision when ready to use for IPCs. Lock requires BOQ_REVISE permission.

Step-by-step: import from Excel​

For large BOQs, use the BOQ Smart Importer — it parses Excel files, maps columns, dry-runs validation, and commits with full audit.

Step-by-step: create a new revision​

  1. Open the current BOQ.
  2. Click New revision.
  3. ORKSTRA copies the current revision into a new open revision.
  4. Apply the variation lines (typically auto-applied if the variation is linked to BOQ items).
  5. Lock the new revision when ready.

Common tasks​

  • Find a line: Ctrl+F inside the BOQ — searches AR + EN descriptions and codes.
  • Bulk edit rates: export to Excel, edit, re-import via the Smart Importer.
  • Print BOQ: PDF export with selectable AR-only, EN-only, or AR+EN layouts.
  • Compare revisions: BOQ → Revisions → Compare highlights added, removed, modified lines.
  • Roll up sections: click any section header to collapse / expand totals.

Troubleshooting​

  • "I can't edit the BOQ." — Either the revision is locked, or you lack BOQ_EDIT. Check the revision status badge.
  • "BOQ totals don't match my Excel." — Most often a unit mismatch. The Smart Importer flags these in the dry-run report.
  • "Some lines show no rate." — Rate may be zero, or stored in a different currency than the display currency. Use the currency filter to verify.
  • "Revision is stuck in 'open' but I want to lock it." — Check the bottom-bar warnings — there may be incomplete required fields or zero-rate lines blocking the lock.

Permissions reference​

PermissionWho needs it
BOQ_VIEWAnyone reading BOQ
BOQ_EDITQSes, planners
BOQ_REVISESenior QSes
BOQ_IMPORTQSes
BOQ_EXPORTQSes, finance
BOQ_LOCKSenior QSes

See also: BOQ Smart Importer, IPC, Variations, QTO.