BoQ Automation for Construction Supply: Handling GAEB, Complex Specifications, and Variants – turian

BoQ Automation for Construction Supply:
Handling GAEB, Complex Specifications,
and Variants

If your sales team receives tender documents from architects, general contractors, or public procurement offices in Germany, Austria, or Switzerland, a significant portion of them arrive as GAEB files. The .x83 file in the inbox is a bidding order: a structured request for your prices against a defined specification, formatted according to the GAEB DA XML standard that governs electronic construction tendering across the DACH region.

For suppliers in building materials distribution, technical installation, or construction-related manufacturing, handling these files efficiently is a direct competitive variable. The contractor who submitted the GAEB has a tender deadline. They sent it to multiple suppliers simultaneously. Your response time and the completeness of your pricing determine whether you are on the shortlist.

GAEB files are not just PDFs with a different extension. They carry a specific structure, a defined hierarchy, and positional logic that generic document processing tools are not built to handle.

The standard

What GAEB Is, and What
the File Contains

GAEB stands for Gemeinsamer Ausschuss Elektronik im Bauwesen, the joint committee that developed and maintains the standard. The format has existed since the 1980s and has been continually updated, with the current XML-based standard now used in virtually all building projects in Germany. Most governmental contracts require its use.

The GAEB DA XML standard uses exchange phases marked with file extension codes. The phases most relevant for suppliers are:

Extension Phase Direction What it contains
.X81 Bill of quantities transfer Architect or engineer to project owner BoQ data prepared by the design team, passed to the owner for procurement
.X83 Incoming Bidding order Project owner to supplier BoQ requesting prices from the supplier. This is what arrives in your inbox.
.X84 Outgoing Bidding offer Supplier to project owner The supplier's priced response, with unit rates filled in for each position. This is what you send back.
.D83 Bidding order (legacy) Project owner to supplier GAEB 90 format equivalent of X83. Still in use in older systems.
.D84 Bidding offer (legacy) Supplier to project owner GAEB 90 format equivalent of X84.

Regardless of the format variant, a GAEB file replicates the structure of a classic paper specification. It contains tender texts, quantity specifications, and quantity units organized according to the GAEB classification structure. For a supplier, the incoming file is almost always an X83 or D83. The expected response is an X84 or D84 with unit rates filled in for each position.

Why it matters

The OZ position numbers in a GAEB file are the reference system for the entire tender. Your priced X84 must match the same position numbers from the X83, line by line, for the project owner to compare your response against competitors.

The structure

The Structure That Makes GAEB
Different from a PDF or Excel File

A GAEB file is not a flat list of line items. It is a hierarchical document with a defined structure that carries meaning at every level.

Element

LOS and LV structure

Leistungsbereich / Leistungsverzeichnis

The file is organized into sections: trade sections (Leistungsbereiche) that group related work items. A BoQ for a commercial building might have sections for earthworks, concrete, masonry, steelwork, glazing, heating, plumbing, and electrical. A supplier of heating components receives the full file but is typically only pricing the sections relevant to their product range.

Element

OZ position numbers

Ordnungszahlen

Every line item has a unique hierarchical reference number called an OZ. A position numbered 03.02.0010 belongs to section 3, sub-section 2, position 10. These numbers are the reference system for the entire document. When a supplier returns a priced X84, the prices are attached to the same OZ numbers from the X83. The numbers are what allow the project owner to compare multiple suppliers' responses position by position.
Example OZ 03.02.0010 → Section 3 (Heating), Sub-section 2 (Radiators), Position 10

Element

Long text and short text

Langtext / Kurztext

Each position has a short description (Kurztext), typically one line, and a long text (Langtext) that provides the full specification detail. The long text is where the technical requirements live: material grades, surface treatments, installation standards, compliance references, tolerance specifications.
Example long text excerpt Heizkörperventil, DN15, PN10, Rotguss, Klemmverschraubung, Durchgangsform, stellbar, inkl. Schutzkappe, DIN EN 215

Element

Quantity and unit

Menge / Einheit

Each position specifies the required quantity and the unit of measure: metres, square metres, pieces, sets, lots. The supplier prices per unit; the file calculates the total.

Element

Provisional and alternative positions

Bedarfs- / Alternativpositionen

GAEB files can include positions that are provisional (Bedarfspositionen), items the project owner may or may not order, and alternative positions (Alternativpositionen) that represent alternative specifications for the same work. These require different handling from standard positions.

Common processing error

Provisional and alternative positions are a frequent source of manual processing errors when teams process GAEB files without automation. Pricing them incorrectly or omitting them creates discrepancies in the returned X84 that the project owner has to reconcile manually.
BoQ Automation for Construction Supply: Where Generic Tools Fail – turian

Where tools fall short

Where Generic Automation Tools
Fail on GAEB

A document extraction tool that has not been built for GAEB will attempt to parse the file as if it were a structured document: extracting text strings and looking for patterns. It may extract some content correctly. It will fail in predictable ways.

01

Failure point

The hierarchy is lost

What happens Treating a GAEB file as a flat text extract loses the OZ position structure entirely. A position numbered 03.02.0010 belongs to a specific section and sub-section: that relationship is lost if the hierarchy is flattened.
Why it matters When the supplier needs to return a priced X84 with prices attached to the correct OZ numbers, a tool that lost the hierarchy on import cannot produce a valid response file. The returned bid cannot be used.
02

Failure point

Position type handling breaks

What happens Provisional sums and alternative positions require different pricing logic and different handling in the response file. A generic tool that treats all positions identically will either misprice them or leave a human to find and correct them manually.
Why it matters This defeats the purpose of automation. The most error-prone positions in a GAEB file are exactly the ones a generic tool is least equipped to handle.
03

Failure point

Long text is ignored or treated as prose

What happens A tool that extracts only the short text has missed most of the information that determines which product to price. A tool that extracts both but treats the long text as unstructured prose, rather than a specification to be interpreted against a product catalog, has not solved the matching problem.
Why it matters The long text is where the technical requirements live: material grades, pressure ratings, installation standards, compliance references. Ignoring it means matching against incomplete data.
04

Failure point

No valid X84 output

What happens If the supplier needs to return a priced GAEB file, which is standard in public procurement and most private construction projects, the automation tool needs to write prices back into the GAEB structure and export a valid X84.
Why it matters This requires understanding the format well enough to write it, not just read it. Generic extraction tools stop at reading. The supplier still has to produce the response file manually.

The key distinction

Generic extraction tools stop at reading. A GAEB-aware system writes prices back into the structure and exports a valid X84 response file, ready for review and submission.

What good looks like

What GAEB-Aware Automation
Actually Handles

A system built for construction supply tendering approaches GAEB files differently from a generic document processor.

Capability

Schema-aware parsing

Parses the file according to the GAEB DA XML schema, preserving the OZ hierarchy, section structure, position types, and all metadata. Positions are read as structured objects with their relationships intact, not extracted as text strings.

Capability

Long text interpretation

Reads "DN50, PN16, flanged gate valve, cast iron body, rising stem, handwheel actuated, as DIN EN 1171" and interprets each element: nominal diameter, pressure rating, end connection, body material, actuation type, applicable standard, before attempting to match it against the product catalog. The specification is the input to the matching logic, not the output of it.

Capability

Scope filtering

Removes positions outside the supplier's product range before they reach the inside sales team. A heating components supplier does not price the concrete or glazing sections. On a large multi-trade file, filtering by relevance removes a significant manual review burden before anyone opens the document.

Capability

Variant configuration resolution

Handles the common case of configurable construction products: valves with selectable body materials and pressure ratings, cable management systems with variable lengths and fixing types, lighting fixtures with selectable lumen outputs and colour temperatures. The long text defines the configuration; the system resolves it to the correct product variant in the catalog rather than flagging every configurable item as an exception.

Capability

Valid X84 output

Once positions are priced and confirmed, writes unit rates back into the GAEB structure and generates a valid X84 file, ready for review, approval, and submission. The project owner receives a correctly formatted electronic bid.

The detail that catches teams out

Provisional Sums and Alternative Positions:
The Detail That Catches Teams Out

These two position types are worth addressing directly because they appear in most GAEB files and are consistently mishandled in manual processing.

Position type

Provisional Sums

Bedarfspositionen

Items the project owner may order, optionally. They are included in the BoQ for pricing purposes but may not appear in the final order. Some suppliers price them at their standard rate; others apply a different margin given the uncertain demand.

The system needs to flag these as provisional so the inside sales team can apply the appropriate pricing logic rather than treating them as confirmed positions.
Position type

Alternative Positions

Alternativpositionen

A specification alternative: a standard valve and a higher-pressure alternative for the same installation point, for example. The project owner selects one; both are priced in the tender. The system needs to identify which positions are alternatives to which, price them separately, and present them correctly in the X84 response.

Both types are identified in the GAEB XML schema by specific attributes. A system that parses the schema correctly handles them natively; a system that does not will either miss them or treat them as standard positions.
Both types are not ambiguous in a correctly parsed GAEB file. The schema defines them clearly. Mishandling them is a tooling problem, not a complexity problem.
BoQ Automation for Construction Supply: ERP Integration and the Right Questions – turian

ERP integration

Integration With Quoting Tools Used
in Construction Supply

Construction supply companies typically use one of several ERP and quoting systems: SAP (Business One or S/4HANA), Microsoft Dynamics 365, Infor, ProAlpha, or sector-specific systems like Navision-based solutions common in building materials distribution.

The connection between BoQ automation and the ERP needs to cover two directions.

On intake

The system reads from the ERP

To validate and price the BoQ positions, the system reads:

  • Product master data to match BoQ specifications to internal SKUs
  • Customer records to identify the project owner and apply relevant pricing
  • Pricing data to validate unit rates against current price lists or customer-specific agreements

On output

The system writes to the ERP

Once positions are priced and confirmed:

  • Confirmed prices and quote records are written back to the ERP
  • The quotation record is created and attached to the customer and project
  • Follow-on workflow is triggered if the tender is awarded

GAEB-specific output step

For GAEB workflows, the output step also includes generating the X84 response file: a requirement that has no equivalent in standard order intake automation, and that requires the BoQ automation layer to understand the GAEB format well enough to write it correctly.

Turian's BoQ automation agent handles GAEB files as a native format: parsing the full schema, preserving the OZ hierarchy, interpreting long text specifications, filtering by supplier scope, resolving variant configurations, and generating valid X84 response files. It connects bidirectionally to the ERPs used in construction supply.

SAP Business One SAP S/4HANA Microsoft Dynamics 365 Infor ProAlpha Other ERPs

The right question to ask

For construction supply companies receiving GAEB files as a standard part of their tendering workflow, the question to ask any automation vendor is not "do you support GAEB?" Most will say yes. The question is:

"Show me how your system handles a 400-position X83 file with multiple trade sections, provisional sums, and alternative positions. Walk me through what the inside sales team sees and what the X84 output looks like."

The answer will tell you whether the vendor has built for GAEB or is claiming GAEB support based on basic XML parsing. There is a significant difference between the two.

See how turian handles GAEB BoQ automation end-to-end

From X83 intake to priced X84 output, via your ERP.

See the BoQ use case