Resource analysis

On this page
  1. Resource analysis or direct price
  2. Shared analyses: identical positions are priced together
  3. How to open the resource analysis panel
  4. Parts of the panel
  5. Resource types
  6. Resource columns
  7. How to add a material
  8. How to add labor, machinery and services
  9. How to edit or delete a resource
  10. Validation messages
  11. Cost summary, additional costs and profit
  12. Analysis status and the Complete button
  13. The Report (several positions)
  14. Table view and list view
  15. Exporting one analysis to Excel
  16. Correcting an analysis on an accepted budget or a signed contract
  17. When the BoQ version is locked
  18. BORO and the resource analysis
  19. Common questions
  20. Related
WhereBoQ editor → tick the checkbox of a position; the panel opens on the right. URLs /projects/{project}/drafts/{boq}, /projects/{project}/offers/{boq}, /projects/{project}/budget/{boq} (read-only), and out-of-contract positions on a payment application
Who canProject permission Resource analysis (Ресурсен анализ): View to see the panel, Edit to add, change and delete resources, set percentages, complete the analysis and use templates. Searching the library needs the company permission Nomenclature (Номенклатура). Needs a paid plan (Starter or higher) or a trial, and a licensed seat.
RelatedTask templates and price history, Profit, additional costs and totals, Company library (nomenclatures)

Resource analysis or direct price

Every BoQ position is priced in one of two ways:

  • Resource analysis — a full breakdown of the unit price into materials, labor, machinery and services, with additional costs and profit. Use it when you need to know and defend where the price comes from.
  • Direct price — you type the unit price in the Unit price cell of the BoQ editor. BuildColab then replaces the analysis with a single "Unit price" line, with no add-ons and 0% profit. Any earlier breakdown is removed from the current version. See Working in the BoQ editor.

Shared analyses: identical positions are priced together

Within one BoQ, positions with the same description, unit and note point to one shared resource analysis. Changing it reprices every one of them at once. This is deliberate: the same work in the same BoQ should have the same price. To give a position its own analysis, change its description (choose Rename only this item when asked) or its note. Sharing works only inside one BoQ, never across BoQs.

When Include categories is switched off in Controls, the panel shows Location in the structure (Местоположение в структурата) — the path from the BoQ root to the position — and, for a shared position, Found in {n} locations (Намерена в {n} локации) with one path per place.

How to open the resource analysis panel

  1. Open a BoQ in the editor.
  2. Tick the checkbox of one position. The panel Resource analysis (Ресурсен анализ) opens on the right. There is no separate button: selecting a row opens it.
  3. Tick several positions or a whole category to get the read-only summary Report (Справка) instead.
  4. Close the panel with ×. This only hides it; your selection stays. The panel comes back with your next selection (on a narrow screen, only with a new selection).

The panel does not open when: the BoQ is quantity-only (an offer-request base), the offer-requests panel is open, a selection mode is active, the Contract with a contractor dialog is open, or you lack Resource analysis at View (a permission message explains why). The panel is read-only when you view an old version, on the accepted budget or a signed contract (there you can still correct an analysis, see below), without Edit permission, while you preview a historical analysis, and in Report mode.

Parts of the panel

PartENBGWhat it shows
TitleResource analysis / ReportРесурсен анализ / СправкаSingle position / several positions.
ButtonsComplete, ExportЗавърши, ЕкспортMark the analysis as finished; download it to Excel. Single position only.
Position cardShowing the resource analysis forПоказва се ресурсният анализ заDescription, UoM, Quantity, Total value, Unit price (highlighted) and Note. Updates live.
TemplateAnalysis templateШаблон на анализаThe task template linked to this position, suggestions and history. See Task templates and price history.
Cost summaryDirect costs / Add. costs (% and Value) / Total; ProfitПреки разходи / Доп. разходи (% и Стойност) / Общо; ПечалбаOne row per resource type, a Total row and the Profit row ending in the unit price.
ResourcesResourcesРесурсиCount chips per type and the table/list view switch.
SectionsMaterials, Labour, Machinery, ServicesМатериали, Труд, Механизация, УслугиThe resource rows of each type, with a + button and the section value.
The resource analysis panel with the cost summary and four resource sections filled

OUTDATED SCREENSHOT This screenshot is out of date; the text on this page describes the current screen.

Figure: The resource analysis of one position

  1. The ticked position in the BoQ grid.
  2. The Complete and Export buttons.
  3. The position card with UoM, Quantity, Total value and the highlighted Unit price.
  4. The Analysis template section.
  5. The cost summary: Direct costs, Add. costs % and Value, Total, and the Profit row with the unit price.
  6. The Materials section header with its value and the + button (click the header to show the resource rows).
  7. The table / list view switch in the Resources header.

Resource types

Type (EN)Type (BG)UnitPrice fieldWhere the name comes from
MaterialsМатериалиThe material's unit from the libraryPrice per unitCompany library — required
LabourТрудAlways m.h. (ч.ч., man-hours)Hourly rateCompany library — required
MachineryМеханизацияAlways m.d. (м.д., machine-days)Daily rateCompany library — required
ServicesУслугиNo unitPrice per unit of serviceFree text, not stored in the library

Resource columns

Column (EN)Column (BG)MeaningRule
№№Row number, filled automatically.—
NameИмеThe material, worker type, machine or service.Library item for materials, labor, machinery; text of at least 2 characters for services.
UoMм.ед.Unit of the resource.Filled automatically; not for services.
CR (consumption rate)РН (разходна норма)How much of the resource ONE unit of the position consumes, for example 0.12 m³ of concrete per m², or 0.8 man-hours per m².Greater than 0, up to 4 decimals. Typing 0 becomes 0.01.
PriceЦенаPrice per material unit, per man-hour, per machine-day or per service unit.Greater than 0. The default 0 must be changed.
DSC %ДСР %Delivery and storage costs: a percentage added on top of the material price for transport and storage. Example: a material at 100.00 with DSC 10% counts as 110.00.Materials only; 0 or more; default 0.
ACДКAdditional coefficient: a multiplier for waste or difficulty. Always a coefficient, never a percent.1 or more; 1 means no change; default 1.
ValueСтойностThe cost of this resource for ONE unit of the position. Calculated, read-only, 3 decimals.—

How the Value of a resource row is calculated:

  • Material: price × consumption rate × (1 + DSC% ÷ 100) × AC
  • Labor: hourly rate × consumption rate × AC
  • Machinery: daily rate × consumption rate × AC
  • Service: price × consumption rate × AC

Materials, labour and machinery from the library are shown as a chip with an icon for the kind. Hover over it to see the item's last price and how often it is used. Click its (i) button to open its price history and where it is used. A click on the name still opens the row for editing. Services are typed per analysis, so they stay plain text. See Company library (nomenclatures).

How to add a material

  1. In the resource analysis panel, click + on the Materials (Материали) section. A new editable row appears.
  2. In Name, type in "Search for material..." (Търсене на материал...). Results from your company library appear with a match percentage; the search compares meaning, so slightly different wording still finds the item.
  3. Pick a result. The name and unit fill in and the cursor jumps to the consumption rate. The price is not pre-filled.
  4. If nothing fits, choose + Add material (+ Добави материал). In the dialog Create nomenclature (Създай номенклатура), check Nomenclature name and pick the Unit of measure, then click Create (Създай). The material is added to the company library and selected. When the search itself is down, the list says Material search is not available right now. Try again in a moment, or add the material yourself. (Търсенето на материали не е достъпно в момента. Опитайте отново след малко или добавете материала ръчно.); + Add material still works.
  5. Fill in CR, Price, DSC % and AC. Value recalculates as you type.
  6. Click the green save button below the row or press Enter. Esc or the red ✗ cancels.

A material must come from the library: typing a name without picking gives "Please select a material from the list or create a new one." The same material can appear only once in one analysis; adding it twice fails with "An error occurred while creating the material resource". If a field is invalid, the box Please correct the following errors lists every problem. On success: Resource created successfully (Успешно създаден ресурс).

A new material row with the library search results and the Add material option
Figure: Adding a material from the company library
  1. The + button on the Materials section.
  2. The Search for material... field in the new row.
  3. The CR, Price, DSC % and AC fields and the live Value.
  4. + Add material creates a new library material.
  5. The green save button below the row.
  6. Library results with their match percentage.

How to add labor, machinery and services

  • Labour (Труд): click +, search your library labor items, or create one with + Add labour (+ Добави труд). The unit is fixed to m.h. Fill in CR (man-hours per unit of the position), the hourly Price and AC.
  • Machinery (Механизация): click +, search your library machines, or create one with + Add machine (+ Добави машина); its dialog asks only for the name, because the unit is always m.d. Fill in CR (machine-days per unit), the daily Price and AC. Always pick the machine from the search list; a typed name that was not picked is rejected.
  • Services (Услуги): click + and type the name directly — services use no library and have no unit and no DSC. Fill in CR (how many units of the service per unit of the position), Price and AC.

Save each row with the green button or Enter, exactly as for materials.

How to edit or delete a resource

  1. In the resource analysis panel, click any cell of the resource row. The row becomes editable and the cursor goes to that cell. For materials, labor and machinery you can also replace the library item.
  2. Change the values and save with the green button or Enter.

Esc, ✗ or a click outside the row cancels without saving. On success: Resource edited successfully.

To delete a resource, click the red bin on its row. It is deleted immediately: there is no confirmation and no undo; the previous state remains only in older locked versions. A service row that is the basis of an active line commitment in a subcontract cannot be deleted; you see only the generic error "An error occurred while deleting the resource".

Validation messages

RuleEN messageBG message
Consumption rate missingConsumption rate is requiredРазходната норма е задължителна
Consumption rate ≤ 0Consumption rate must be greater than 0Разходната норма трябва да е по-голяма от 0
Price missingUnit price is required / Hourly rate is required / Daily rate is requiredЕдиничната цена е задължителна / Почасовата ставка е задължителна / Дневната ставка е задължителна
Price ≤ 0Unit price must be greater than 0Единичната цена трябва да е по-голяма от 0
DSC below 0Delivery and storage costs must be greater than or equal to 0Доставно Складовите разходи трябва да са по-големи или равни на 0
AC below 1The additional coefficient must be greater than or equal to 1Допълнителният коефициент трябва да е по-голям или равен на 1
Service name too shortThe name must be at least 2 charactersИмето трябва да е поне 2 символа
Additional costs below 0Additional costs must be greater than or equal to 0Допълнителните разходи трябва да са по-големи или равни на 0

Cost summary, additional costs and profit

The cost summary at the top of the resource analysis panel has one row per type (materials, labor, machinery, services) with Direct costs (sum of the type's resource values), Add. costs as a % and a Value, and the Total for the type. The Total row adds them up. The Profit: row has the profit %, "+ profit value", and in the last column the unit price "/ unit".

How to set additional costs or profit

  1. Click into the % field of a type row (additional costs) or of the Profit: row. ✓ and ✗ appear.
  2. Type the percentage. Empty means 0; negative values are refused.
  3. Press Enter or ✓ to save; Esc or ✗ restores the old value.

Additional costs (доп. разходи) are overheads such as site and general costs, set separately per resource type and applied to that type's direct costs. Profit is applied to the total of all costs. The unit price and every position that uses this analysis are recalculated immediately; there is no Recalculate button. Toasts: Additional costs updated successfully, Profit updated successfully. The full formulas and a worked example are on Profit, additional costs and totals.

Worked example

Position "Floor tiles", 120 m². Resources per 1 m²: tiles 1.05 m² × 20.00 EUR with DSC 3% and AC 1.00 = 21.63; labor 0.6 m.h. × 15.00 EUR with AC 1.1 = 9.90. Additional costs: materials 0%, labor 50% = 4.95. Total costs = 21.63 + 9.90 + 4.95 = 36.48. Profit 10% = 3.648. Unit price = 40.13 EUR per m². Position value = 40.13 × 120 = 4,815.60 EUR.

Analysis status and the Complete button

Every analysis has a completion status, shown as a colored dot before the position description in an offer's BoQ (not on the budget and not in a received offer):

DotStatusWhen it happens
GreyNot startedNew analysis with no price yet.
OrangeIn progressAutomatically, as soon as a position using the analysis gets a non-zero unit price, and again after any change to a completed analysis.
GreenCompletedAfter you click Complete (Завърши).

Click Complete in the resource analysis panel when the price is agreed and final. The button is shown for one position with Edit permission and is inactive when the latest version is locked, when the analysis is already completed or while it loads. Any later change — adding, editing or deleting a resource, changing a percentage, changing the unit price — puts the dot back to orange; press Complete again. There is no button to go back to "not started".

Offer BoQ rows with gray, orange and green status dots and the Complete button
Figure: Completion status of analyses
  1. An orange dot: analysis in progress.
  2. A grey dot: analysis not started.
  3. A green dot: analysis completed.
  4. The Complete button in the resource analysis panel.

The Report (several positions)

When you tick several positions or a whole category, the panel becomes Report (Справка). It shows "{n} selected work items" and their Total value, and a summary weighted by each position's quantity:

  • resources are grouped by library item, and the Qty (К-во) column shows consumption rate × position quantity added up;
  • rates and AC are quantity-weighted averages;
  • the additional-cost % and profit % shown are the effective weighted percentages, and the last column reads "summed".

You cannot add or change resources in the Report, and there is no template section, Complete or Export.

Table view and list view

Two icon buttons in the Resources (Ресурси) header switch between the table view (default, like a spreadsheet) and a compact list view with color per type (materials purple, labor orange, machinery dark blue, services green). In the list view, an empty section shows a button Add {type}. Your choice is saved in your user account and follows you to other devices.

Exporting one analysis to Excel

Click Export (Експорт) in the resource analysis panel of a single position to download Resource_Analysis.xlsx to your computer. Chrome and Edge ask where to save; other browsers download directly. The sheet starts with "Resource analysis" (Ресурсен анализ) in the top-left cell, then the title "UNIT PRICE BUILD-UP ANALYSIS" (АНАЛИЗ ЗА ОБРАЗУВАНЕ НА ЕДИНИЧНИТЕ ЦЕНИ), the position name as the panel shows it, the columns No. according to the nomenclature, Official name, Unit, Consumption rate, Unit price, DSC %, Add. Coef., Amount, the material, machinery, labor and service rows, the additional-cost percentages, total direct costs, total additional costs, profit %, the final price and "Prepared by". Resource names appear as in the panel: a position priced directly, without resources, has the row "Unit price" (Единична цена). Prices, amounts and totals are numbers with two decimals, so Excel can sum them; consumption rates, percentages and coefficients keep up to four decimals. Amounts are rounded the same way as in the panel. Bold subtotal styling is applied when you export with the interface in Bulgarian. This file is not saved to the File Manager.

Correcting an analysis on an accepted budget or a signed contract

On an accepted investor budget and on a signed contract's BoQ, the resource analysis panel is read-only, because the unit prices are agreed. You can still fix mistakes in an analysis, such as a missing resource or a wrong rate, without changing the agreed price: click Correct analysis (Коригирай анализа) in the resource analysis panel of a single position. The unit price, the quantity, the position's total and the BoQ total never change. Instead, the profit % of the analysis is recalculated so that the costs plus the profit still give exactly the same unit price.

How to correct an analysis

  1. Open the accepted budget or the signed contract and tick one position. The resource analysis panel opens on the right.
  2. Click Correct analysis (Коригирай анализа). The panel stays the ordinary resource analysis editor, now in correction mode: a note Unit price locked at … (Единичната цена е фиксирана на …) at the top, then the same summary table and the same sections Materials, Labour, Machinery and Services with the same columns (№, Name, UoM, CR, Price, DSC %, AC, Value). The sections that have resources open by themselves. The table/list switch is hidden: a correction is edited in the table view.
  3. To change a resource, click a cell of its row, change CR, Price, DSC % or AC, and press Enter or the green save button, exactly as in the ordinary editor. The row's Value and the section's value recalculate. The change goes into the correction; nothing is saved to the analysis yet. A row keeps its library item: to replace one, remove the row and add the other item.
  4. To remove a resource, click the red bin on its row. The row stays, crossed out and tagged Removed (Премахнат), until you save; the restore button in place of the bin, Undo (Отмени), brings it back.
  5. To add a missing resource, click + on its section and fill in the new row as in the ordinary editor: search your company library for materials, labor and machinery (+ Add material, + Add labour and + Add machine create a new library item first), or type a service name. Save the row with Enter or the green button. The new row is tagged New (Нов). Every changed or added row needs CR and Price above 0 and AC of at least 1.
  6. Check the result. About half a second after each change, the summary table at the top shows the previewed analysis, highlighted: the new direct and additional costs, the total cost, the recalculated profit % and value, and the unchanged unit price. A negative profit is shown in red, without the "+" sign. Below the sections, Profit changes from …% to …% (Печалбата се променя от …% на …%) shows the profit before and after, rounded to two decimals. If the new profit is negative, a red Loss (Загуба) tag and the warning The cost is above the unit price: the line will be sold at a loss. appear. While the preview is calculated, Calculating… (Изчисляване…) is shown.
  7. Click Save correction (Запази корекцията). All your changes are saved together in one step, and the toast The analysis was corrected confirms it. While the correction is being saved, its rows cannot be changed. Cancel (Отказ) leaves correction mode and drops every change. If the save is refused, the reason appears below the sections and Save correction stays unavailable until you change the correction again.

Nothing is saved until you click Save correction; the result shown while you edit is only a preview. Other people who have the budget open see the corrected analysis and the loss tag without reloading.

Correction messages

MessageWhat it means
Keep at least one priced resource in the analysis.The correction would leave the analysis without any cost. Keep or add a resource with a price.
This service holds a price offered or awarded by a subcontractor and cannot be changed.You changed or removed a service line that carries a price a subcontractor offered or was awarded. Leave that line as it is.
The lines that share this analysis have different unit prices, so it cannot be corrected here.Several positions share this analysis but are priced differently, so no single profit % keeps all their prices.
A resource you added is not in your company library. Pick it again from the search.The material, labor or machine of a new row is not (or no longer) in your company library. Remove the row and add the item again from the search.
This line is changed in an open change order, or a change order is still being prepared. Correct the analysis in the change order, or try again later.An open change order has already changed this position, so finalizing it would overwrite the correction: correct the analysis inside the change order. The same message appears while a change order of this BoQ is still being prepared; try again once it is ready. A position that an open change order carries unchanged is corrected without this message.
This analysis can be edited directly — reload the page.The BoQ is not an accepted budget or signed contract (anymore). Reload and use the ordinary editor.
This analysis was changed while you were editing. Reload it to continue from the latest version.Someone else (or BORO) changed this analysis after you started the correction. Save correction stays unavailable; click Reload (Презареди) to start again from the current analysis. Your unsaved changes are dropped.
Every changed row needs a consumption rate and a price above 0, and a new row needs its resource.A row you changed or added has a zero, empty or invalid value. Fix it; the preview and Save correction stay unavailable until then.

The Loss tag

A position whose analysis has a negative profit % is sold below its cost. The resource analysis panel then shows a red Loss (Загуба) tag next to its title, and the Profit: row shows the profit % and value in red without the "+" sign. In the BoQ of the accepted budget or signed contract, every such position carries the red Loss tag next to its name, so you can find loss lines at a glance.

When the BoQ version is locked

If the BoQ's latest version is locked, any change in the resource analysis panel — adding, editing or deleting a resource, changing additional costs or profit, applying from history — first shows New version warning (Предупреждение за нова версия). Continue opens a new BoQ version and applies the change; Cancel drops it. The warning is skipped after Finish base on version 1 and on payment-application workspace lists. Assigning a template does not ask.

BORO and the resource analysis

BORO can read and edit analyses for you: add, change and delete resources (up to 20 actions at once), set additional costs and profit, apply analyses from template history (up to 15 positions at once), copy an analysis between positions and set the completion status. In the BORO panel each change waits for your approval by default (a company can set a tool to run without approval); AI tools connected through MCP show no approval card and, with write access, apply changes immediately. See What BORO can do.

Common questions

Can I add up the amounts in the exported resource analysis?

Yes. In Resource_Analysis.xlsx the prices, amounts and totals are numbers, not text, so Excel and other spreadsheet programs can sum them and use them in formulas. They show two decimals and are rounded the same way as in the resource analysis panel.

Can I fix a resource analysis after the budget was accepted or the contract was signed?

Yes. On the accepted budget or the signed contract, tick the position and click Correct analysis (Коригирай анализа) in the resource analysis panel. You can add, change and remove resources; the unit price and the totals stay the same, and the profit % is recalculated.

Why does a position show a red Loss tag?

Its analysis has a negative profit %: the costs are higher than the agreed unit price, so the position is sold at a loss. This usually follows a correction on an accepted budget or signed contract that added costs. The tag appears in the resource analysis panel and next to the position in the budget's BoQ.

Why can't I change the profit or additional costs in Correct analysis?

In a correction the unit price is fixed, so the profit % is the result: it is recalculated from the corrected costs. Additional costs stay as they are on an accepted budget or signed contract.

Why does a correction say "This service holds a price offered or awarded by a subcontractor and cannot be changed."?

That service line carries a price a subcontractor offered or was awarded, so it is that subcontractor's price. Correct the other resources and leave the line as it is.

Why doesn't the resource analysis panel open when I tick a position?

You may lack the Resource analysis permission, your company may be on the Free plan or your seat may be unlicensed, the BoQ may be quantity-only, the offer-requests panel may be open, or you closed the panel during this selection. Clear the selection and tick the position again.

Why did changing one analysis change other positions too?

Positions with the same description, unit and note share one analysis. Give the position a different note or description to separate it.

Why can't I type a material name freely?

Materials, labor and machinery must come from the company library so they can be reused and searched. Pick a search result or create the item with + Add material. Only services are free text.

Why does the material search show percentages?

The percentage is semantic similarity between what you typed and the library item: the search compares meaning, so different word order or singular/plural still match.

The green dot turned orange again. Why?

Any change to a completed analysis returns it to "in progress". Press Complete again when you are done.

Why is the Complete button gray?

It is inactive when the BoQ's latest version is locked, when the analysis is already completed, or while it loads. Edit the BoQ (which opens a new version) to be able to complete it.

I deleted a resource by mistake. Can I undo it?

No. Resource deletion has no confirmation and no undo. Add the resource again, or read the old values from a locked version in History. The exception is Correct analysis (Коригирай анализа) on an accepted budget or signed contract: there a removed row stays crossed out until you click Save correction, and Undo (Отмени) brings it back.

What is the difference between DSC % and AC?

DSC % (delivery and storage costs) is a percentage on materials only. AC (additional coefficient) is a multiplier of 1 or more, for any resource type, for waste or difficulty. A resource added without an AC, for example by BORO or through the API, uses 1 (no adjustment).

Where are the additional costs as a fixed amount?

The panel has no fixed-amount line. Additional costs are percentages per resource type. For a fixed amount, add a service row.

Saving a resource says the item is not in my company's nomenclature. Why?

A resource analysis uses materials, labor and machinery from your own company library only. Picking another company's item is refused with "This item is not in your company's nomenclature. Pick one from your own nomenclature. Nothing was changed." The search in the Name (Име) field offers only your company's items, so this appears only when the item came from somewhere else, for example a request made through BORO. Pick the item from your library, or add it there first.

A change says some resource analyses "were not found or are not your company's". What happened?

A change that names an analysis or a resource of another company is refused as a whole, and nothing is changed, not even your own rows: "Some of the resource analyses or resources ({count}) were not found or are not your company's. Nothing was changed." This applies to adding, editing and deleting resources and to setting the profit % or the additional costs for several positions at once. Reload the bill of quantities (BoQ) and try again on your own positions.