Financial dashboard: committed, certified, margin
On this page
| Where | Project sidebar → Financial dashboard (Финансово табло), Execution phase only; or the Certified this month tile → Financial dashboard → on the project page. URL: /projects/{project}/financial-dashboard. |
|---|---|
| Who can | Project permission Financial dashboard (Финансово табло) at View (Преглед), and Budget preparation (Изготвяне на бюджет) at View, because the dashboard reads the budget; without it the page shows "You don't have access to this type of document". The executed and remaining figures come from payment applications and also need Reports (Отчети) at View. Linking lines is for the company that awarded the contract. Paid plans or trial; not in the Free plan. |
| Related | Investment budget, Costs, Payment applications, Change orders and extensions |
Committed, certified and margin
Once you award work to subcontractors, every line of your budget gets a cost side. BuildColab keeps three figures per budget line and shows them both in the budget (columns switched on in Categories) and in this dashboard:
| Figure (EN / BG) | Meaning | How it is calculated |
|---|---|---|
| Committed / Ангажимент | What you have contracted with subcontractors for this budget line. | The sum of the active commitments on the line: signed quantity × signed unit price of every subcontract line attributed to it. |
| Certified / Сертифицирано | How much of the commitment your subcontractors have claimed and you have approved. | The sum of approved payment-application amounts on the subcontract lines attributed to this budget line. |
| Margin / Марж | What is left between your budget and your costs. | Budget value of the line − committed. The percentage is margin ÷ budget value × 100, one decimal; empty when the budget value is 0. Negative margin is shown in red. |
- Commitments are automatic. A commitment is created when a subcontract is signed and changes when a change order on it is accepted: the old commitment becomes Superseded (Заменен) or Released (Освободен) and the new one is Active (Активен). You never type commitments by hand.
- Each subcontract line counts once. It is attributed to exactly one budget line, so nothing is counted twice.
- Category rows show the sum of their lines.
- Totals also include amounts that are not on a budget line at the moment (unlinked lines and commitments without a live line), because it is still money you owe.
- Only downstream contracts count. Contracts your company awarded to other companies are costs; an investor's contract with itself is not.
- Only the company that owns the budget sees its cost figures.
How a subcontract line finds its budget line
- Direct link. When you award lines from your budget, BuildColab remembers which budget line each contract line came from.
- By structure. If there is no direct link, BuildColab looks for the same task in the same place of the bill of quantities (BoQ) structure. Such matches are labeled "by structure" (по структура), with "note differs" (бележката е различна) if the notes are different.
- Unlinked. If neither works, for example because the contract was built from a separate offer with different lines, the line is Unlinked (Несвързани). It is not lost and not attached to a random line: it is listed in the Unlinked block of the dashboard until you link it.
The dashboard screen
The page title is Financial dashboard with "{project} · budget lines against actual costs". Data reloads when you open the page and whenever you return to the browser tab.
Totals strip
Total (Общо) · Budget (Бюджет) with the budget total · Costs (Разходи) with the committed total · Spent (Усвоено) with committed ÷ budget as a percentage. "Spent" therefore shows how much of the budget is already contracted, not how much has been paid.
Table columns
Each row is a line of the budget BoQ, grouped by its categories.
| Group (EN / BG) | Columns | Source |
|---|---|---|
| Budget lines / Бюджетни линии | DESCRIPTION, UNIT (ОПИСАНИЕ, МЕРНА ЕД.) | The budget line. Show or hide the unit with "Show/Hide unit of measure". |
| Budget / Бюджет | QUANTITY, UNIT PRICE, TOTAL, NOTE (КОЛИЧЕСТВО, ЕД. ЦЕНА, СТОЙНОСТ, ЗАБЕЛЕЖКА) | The current budget version. The header shows the budget total and "Base plan · 100%". |
| "Pay App #n · Executed to date" (Отчет #n · Изпълнено до момента) | Quantity, unit price, value | The cumulative quantity and value approved up to and including the latest approved payment application on the budget. |
| "Pay App #n · Progress" (Отчет #n · Прогрес) | A progress bar per row | The completion percentage of the line in that payment application. |
| "Pay App #n · Remaining" (Отчет #n · Остатък) | Quantity, unit price, value | max(0, budget quantity − executed quantity), times the unit price. |
| Costs / Разходи | QUANTITY, UNIT PRICE, TOTAL, NOTE | TOTAL = committed. QUANTITY = the sum of the contracted quantities. UNIT PRICE is shown only when one subcontract line contributes. NOTE lists the subcontractors and "by structure". The header shows the committed total and "{pct}% of budget". |
| Costs payment-application groups | Executed to date, Progress, Remaining | Executed = certified; remaining = max(0, committed − certified); progress = certified ÷ committed. |
- "#n" is the real number of the latest approved payment application on that side, for example "Pay App #3". Without one, the group is titled "Pay App · none approved" (Отчет · няма одобрени), executed is 0 and remaining is the full amount.
- Rows are highlighted when nothing is committed on them, when the committed value is higher than the budget value, or when nothing has been executed yet.
- If the budget has no lines: "No work items in this contract" (Няма задачи в договора).
- The floating buttons bottom right: Expand all (Отвори всички), Collapse all (Затвори всички), Full screen (Цял екран) / Exit full screen (Изход от цял екран).
- The Columns (Колони) button.
- The totals strip: Total, Budget, Costs, Spent.
- The notice "There is an open pay app #n" with Go to pay app →.
- The Budget (Бюджет) column group.
- The "Pay App · Executed to date" and "Remaining" groups (here "none approved", because no pay app on the client side is approved yet).
- The Costs (Разходи) column group with the subcontractors in NOTE.
Notices above the table
- "There is an open pay app #{n}" (Има отворен отчет #{n}) with "(draft)" or "(sent for approval)" and the button Go to pay app → (Към отчета →), which opens it for review. The notice follows the payment applications of one of your contracts with subcontractors when you have one, otherwise of the budget. Open payment applications on your other contracts are not announced here; check the Report Register.
- "The costs could not be loaded — the cost columns are incomplete." with Try again (Опитай отново).
How to choose the visible columns
- Click Columns (Колони) in the page header. The menu Visible columns (Видими колони) opens.
- Tick or untick:
- Budget · executed and remaining by pay app (Бюджет · изпълнено и остатък по отчет)
- Budget · row progress (between executed and remaining) (Бюджет · прогрес по ред (между изпълнено и остатък))
- Costs · executed and remaining by pay app (Разходи · изпълнено и остатък по отчет)
- Costs · row progress (between executed and remaining) (Разходи · прогрес по ред (между изпълнено и остатък))
- The table changes at once. All four are on by default. Your choice is remembered in this browser only; colleagues keep their own.
How to link unlinked contract lines
Below the table, the block Unlinked · {count} (Несвързани · {count}) with its total lists "Signed contract lines with no budget line (no pointer and no structural match)". Each row shows the description, the subcontractor and contract, the amount, the certified amount and the button Link lines (Свържи позиции).
- Click Link lines (Свържи позиции) on a row. The window Link contract lines to the budget (Свържи позициите с бюджета) opens for that contract: "Lines of this contract that are not linked to a budget line. Confirmed links become commitments and count in the Costs columns."
- For each Contract line (Позиция от договора) with its Amount (Стойност), BuildColab suggests a Budget line (Позиция от бюджета) with a confidence label:
- Exact (Точно) — same task and same note;
- Note differs (Бележката е различна) — same task, different note;
- Same task (Същата задача) — only the task matches; check it carefully.
- To choose another budget line, click Other line… (Друга позиция…) and search with "Search the budget by name or section"; your choice is labeled Chosen (Избрана). "No matching budget line" means nothing matches the search.
- Use Accept all exact ({count}) (Приеми всички точни) to take every exact match at once, or Clear selection (Изчисти избора) to start over.
- Click Confirm ({count}) (Потвърди). You see "{count} lines linked". The lines move to their budget lines and count in Committed. When nothing is left: "Every line of this contract is linked."
To undo a link you made by hand, open the window again and use Unlink (Премахни връзката) in Linked by hand ({count}) (Свързани ръчно). You see "Link removed". A line that already has a certified amount cannot be unlinked ("{amount} is already certified on this line — it cannot be unlinked"), and links that BuildColab made automatically cannot be removed here.
- Accept all exact ({count}) (Приеми всички точни) takes every exact suggestion; Clear selection (Изчисти избора) empties the choices.
- The Contract line (Позиция от договора) with its amount.
- The Budget line (Позиция от бюджета) column. When BuildColab finds a match it suggests a line with a confidence label; otherwise, as here, choose one with Other line… (Друга позиция…).
- Confirm ({count}) (Потвърди) saves the chosen links.
Messages in the linking window
| Message | Meaning |
|---|---|
| "Only the company that awarded the contract can link its lines" | Linking is done by the client of the contract, not by the subcontractor. |
| "Lines can be linked only on a signed contract with a subcontractor" | The contract is not signed, or it is a contract of your company with itself. |
| "No budget BoQ was found for this project — open the panel from the budget to link." | The project has no accepted budget for your company yet. |
| "Some lines were linked in the meantime — the list was refreshed" | A colleague linked lines at the same time. Check the list and confirm again. |
| "Its budget line was removed" | The suggested budget line no longer exists in the current budget; choose another one. |
| "Only links made by hand can be removed here" | The link was made automatically when the contract was signed. |
Invoiced, paid and warranty deductions held: the Contract finance blocks
Below the table and the unlinked lines, members who hold the company permission Contract finance (Финанси по договори) see the project's contracts from your company's contract-finance register, in one block per direction:
- Contract finance · Owed to us by the client (Финанси по договори · Очаквам от възложителя): "Our contracts with the client on this project, from the finance register." Your contract with the client: what you invoice and are paid.
- Contract finance · We owe subcontractors (Финанси по договори · Дължа на изпълнители): "Our subcontracts on this project, from the finance register." Your subcontracts: what you are invoiced and pay.
A block is not shown when its direction has no contract on the project that can be included in contract finance (for example, when your company is its own investor, there is no client block); when neither has any, the subcontractors' block says "No subcontracts on this project." The figures come from the certificates of acceptance and payment, invoices and payments registered there, not from the payment applications. Without the permission, or when the feature is not available, the block is not shown.
- Each block's header shows its totals Invoiced (Фактурирано), Paid (Платено) and Overdue (Просрочено) and the Hide / Show (Скрий / Покажи) button. The first block also has the link Open contract finance (Отвори финансите по договори), which opens this project's Contract finance page. Each block opens and closes on its own and remembers your choice; the tables are open by default, except on a phone.
- One row per contract with the columns Contract, Finance (the status: Not included, Draft, Active, Paused), Confirmed certificates, Confirmed, not invoiced, Invoiced, Paid, Upcoming, Due, Overdue, Warranty held (Задържани гаранционни) and the advance Available, and a total row "Total · {count} contracts". A contract with a share of a change order signed with its own financial terms has Main contract and change orders ({count}) (Основен договор и анекси) under its name: it opens a line for the Main contract and one for each Change order No. {n} with the same columns; these lines add up to the contract. Hide the change orders (Скрий анексите) closes them.
- Upcoming, Due and Overdue add up to what is still open on the invoices. Warranty deductions that are still held are counted only under Warranty held.
See Contract finance: certificates, invoices and payments.
Common questions
Why don't I see the Financial dashboard?
It appears only in the Execution phase, needs the Financial dashboard permission and a paid plan. Without the permission the project page tile is hidden and the sidebar entry is locked.
Why does the dashboard say "No accepted budget yet"?
The project has no accepted budget for your company yet; for a contractor, the contract with the client is not signed yet. The table fills in once the budget is accepted; until then the totals strip shows only the cost figures.
What is the difference between Committed and Certified?
Committed is what you signed with subcontractors; Certified is the part of it they have claimed in payment applications that you approved.
Does the dashboard show what was invoiced and paid?
Only in the Contract finance blocks below the table, for members with the Contract finance permission, and only for contracts your company has included in contract finance: Contract finance · Owed to us by the client for your contract with the client, Contract finance · We owe subcontractors for your subcontracts. The rest of the dashboard works from payment applications, which carry no invoices or payments.
Does "Spent" mean money already paid?
No. Spent is committed ÷ budget: the share of the budget already contracted to subcontractors.
Why is the cost side 0 on a line I subcontracted?
The subcontract line could not be placed on that budget line. Look for it in the Unlinked block and link it with Link lines.
Why are the executed and remaining columns empty?
No payment application is approved yet on that side ("Pay App · none approved"), the columns are switched off in Columns, or you lack the Reports permission.
Why doesn't the dashboard warn me about an open payment application on another subcontract?
The notice follows only one contract. Use the Report Register to see every open payment application of the project.
Why can't I remove a link?
Either the line already has a certified amount, or the link was created automatically. Only hand-made links without certified money can be removed.