Skip to main content
Help Center

Bill HOAI fees

Bill HOAI fees with the HOAI wizard: add a wizard line item to the quote, set the framework conditions (version, work-package, fee zone, fee rate, construction costs) – teamspace generates all work phases automatically.

Prerequisites

  • A quote or order into which you can insert line items (see Create quotes)
  • The HOAI articles (wizard, work phase, surcharge) are stored in the configuration – a one-off setup, see below

The HOAI fee scale (German scale of fees for architects and engineers) defines nine work phases, each with a percentage share of the total fee. You no longer have to build this structure by hand in teamspace: the HOAI wizard takes care of it. You insert it as one line item in your quote, enter the framework conditions (version, work-package, fee zone, fee rate and eligible construction costs) – and teamspace calculates the fee and creates all nine work phases as sub-items.

An HOAI fee in three steps

Quote, tab 'Line items': the 'New line item' dialog with the article selection expanded, in which 'HOAI Wizzard' is highlighted at the bottom
1 In the quote (the 'Line items' tab), insert a new line item and select `HOAI Wizzard` as the article.
Line-item dialog of the 'HOAI Wizzard' article with the 'HOAI' accordion: fields Version (HOAI2021), Work-package (§35 Buildings), Fee zone (III), Fee rate (Mid rate), Eligible construction costs (€900,000.00), the calculated Calculated fee (€118,399.50) plus Surcharge (3%) and Ancillary costs (5%)
2 In the 'HOAI' accordion, set the framework conditions – teamspace immediately shows the 'Calculated fee'.
Quote with the line-item list after the wizard: the HOAI Wizzard line item (001) and below it the automatically generated work phases 001-LP1 Basic evaluation through 001-LP9, plus surcharge and ancillary-cost line items, with the fee total at the top
3 Save – the wizard generates the nine work phases, including surcharges, as sub-items.

Step 2 in detail – the framework conditions

In the HOAI accordion of the wizard line item, you set what is calculated against. teamspace updates the Calculated fee with every change:

  • Version – the HOAI version, e.g. HOAI2021.
  • Work-package – e.g. §35 Buildings (others such as Open spaces, Engineering structures depending on the configuration).
  • Fee zone – the difficulty level, e.g. III.
  • Fee rate – e.g. Mid rate (alternatively minimum/maximum rate).
  • Eligible construction costs – the assessment basis, e.g. €900,000.00.

Optionally below: Surcharge and Ancillary costs as percentage values (e.g. 3% surcharge, 5% ancillary costs), and, via Update work phases (Complete), which phases the wizard recalculates. The Calculated fee is the result of the fee table, zone and rate – in the example €118,399.50.

The HOAI mechanism sits in the wizard. Which percentages apply per work phase follows from the version, work-package, fee zone and rate – the wizard looks them up and distributes the fee. A common starting point for building design:

Work phaseShare
1 Basic evaluation2%
2 Preliminary design7%
3 Design planning15%
4 Approval planning3%
5 Detailed design25%
6 Preparation of the award10%
7 Participation in the award4%
8 Construction supervision32%
9 Project aftercare2%

Several buildings in one quote

Each wizard stands for one building project. If you want to offer several buildings in a single quote, you simply insert several HOAI wizard line items – each with its own version, zone, rate and construction costs. The work phases of each wizard are kept separately under “its” line item (e.g. 001-LP… and 002-LP…), so that the fees are cleanly shown per building.

Quote with two HOAI wizard line items (Building 1 and Building 2), each followed by its own block with the work phases (001-LP… and 002-LP…) and separate fee totals
A quote with two HOAI wizard line items (two buildings), each with its own work-phase block.

Bill phase by phase

In day-to-day work, you bill the work phases individually – usually by project progress or status change. To do this, you open the individual work phase (the Billable line item) and, in the Invoice creation accordion under Billability: Automatic, set the Project status or Project progress criterion. Only once the phase reaches the chosen status (e.g. Completed) does it become billable. This way, the phases flow cleanly into the partial invoices – see the Payment plan or Rules mode in Create and bill orders.

Dialog 'Line item – Billable' of a work phase (Basic evaluation, 001-LP1), accordion 'Invoice creation': Billability 'Automatic', below it the fields 'Project progress' and 'Project status' with the highlighted value 'Completed'
1 On the work phase (the 'Billable' line item), in the 'Invoice creation' accordion, set the 'Project status' or 'Project progress' criterion.
Project view of the HOAI main project: the work phases (Basic evaluation through Construction supervision) as a project structure with a status column per phase
2 In the project view, set the status of the work phases (e.g. 'Completed').
Order confirmation, tab 'Billing': the work-phase line items with the 'Billability' column and statuses such as 'Billed', 'Billable' and 'Pending' depending on the project status
3 In the order view, the line items show their billability depending on the project status (billed, billable, pending).

One-off setup (configuration)

For the wizard to work, the HOAI articles must be stored – you set this up once, after which all quotes use the same wizard.

  1. Store the HOAI articles. Configuration → Finance → Settings, the HOAI accordion: under Default HOAI article, enter the wizard/work-phase article (HOAI Wizzard / HOAI LP), plus the Article for surcharges and Article for ancillary costs. Optionally a Default description scheme for the generated line items.
  2. Check the articles. Under Configuration → Finance → Articles lie the associated articles – HOAI Wizzard, the work-phase article and the surcharge articles. If one is missing, you create it here.
Configuration → Finance → Settings, accordion 'HOAI': the fields Default HOAI article (Other/HOAI Wizzard/HOAI LP), article assignment rules, Default description scheme, Article for surcharges and Article for ancillary costs
1 'Finance → Settings → HOAI': set the default articles, surcharges and ancillary costs.
Configuration → Finance → Articles: the article list with the HOAI articles 'HOAI Wizzard', 'Work phase' and 'Surcharge' highlighted
2 'Finance → Articles': the HOAI articles (Wizzard, Work phase, Surcharge).