Free tool · GAEB viewer

X81 file: the GAEB description of works

An X81 is a Leistungsbeschreibung (description of works) in GAEB DA XML: the bill of quantities as the planner hands it to the client, with texts and usually without prices. Drop yours into the viewer to read it or export it to Excel; below, an X81 is explained element by element.

GAEB viewer

Drop a GAEB file here

orGAEB DA XML, GAEB 2000 and GAEB 90 · X81–⁠X86, P81–⁠P86, D81–⁠D86 · up to 50 MBYour file never leaves your computer.

File contents

What is in an X81

First what an X81 holds, then a short X81 with three items, valid against the GAEB DA XML 3.3 schema.

What the file holds

ContentIn the fileNote
Project and LVYesProject, LV name and currency.
Sections and item numbers (OZ)YesUp to five section levels before the item number; the whole OZ has at most 14 characters.
Short and long textsYesFormatted text, lists and tables.
Quantities and unitsYesExcept where the quantity is left to the bidder (free quantity).
Item typesYesContingency, basic and alternative, lump-sum, hourly-wage and surcharge items.
Bidder text additionsIf asked forGaps for the later bidder, such as the offered make.
Unit prices and totalsUsually notThe phase 81 schema allows prices, but according to GAEB a description of works usually has none.

The sample, explained

SampleWhat it says
X81 with three items
<?xml version="1.0" encoding="UTF-8"?>
<GAEB xmlns="http://www.gaeb.de/GAEB_DA_XML/DA81/3.3">
XML declaration and root element. The namespace names the exchange phase (DA81) and the version of GAEB DA XML (3.3).
<GAEBInfo><Version>3.3</Version><VersDate>2021-05</VersDate><Date>2026-11-09</Date><ProgSystem>Mercura</ProgSystem><ProgName>GAEB-Viewer Beispieldatei</ProgName></GAEBInfo>
<PrjInfo><NamePrj>MUS-2026-017</NamePrj><LblPrj>Neubau Bürogebäude Musterstraße 12</LblPrj></PrjInfo>
GAEBInfo: version of GAEB DA XML and the program that wrote the file. PrjInfo: project number and name.
<Award>
<DP>81</DP>
<AwardInfo><Cur>EUR</Cur><CurLbl>Euro</CurLbl></AwardInfo>
The award block. DP is the exchange phase: 81 = Leistungsbeschreibung (description of works). AwardInfo holds the currency; there is no bid deadline yet.
<BoQ ID="BOQ1">
<BoQInfo><Name>LV 05</Name><LblBoQ>Sanitär- und Heizungsinstallation</LblBoQ><Date>2026-11-09</Date><OutlCompl>AllTxt</OutlCompl><BoQBkdn><Type>BoQLevel</Type><Length>2</Length><Num>Yes</Num></BoQBkdn><BoQBkdn><Type>BoQLevel</Type><Length>2</Length><Num>Yes</Num></BoQBkdn><BoQBkdn><Type>Item</Type><Length>4</Length><Num>Yes</Num></BoQBkdn></BoQInfo>
The bill of quantities: name, description, date and the structure of the item number. Two levels of two digits and a four-digit item number give OZ 01.01.0010.
<BoQBody>
<BoQCtgy ID="C1" RNoPart="01"><LblTx><p><span>Sanitärinstallation</span></p></LblTx>
<BoQBody>
<BoQCtgy ID="C2" RNoPart="01"><LblTx><p><span>Abwasserleitungen</span></p></LblTx>
<BoQBody>
<Itemlist>
Two section levels: 01 Sanitärinstallation and, inside it, 01.01 Abwasserleitungen. RNoPart is each level's part of the OZ.
<Item ID="I1" RNoPart="0010">
<Qty>48.500</Qty><QU>m</QU>
Item 01.01.0010: quantity 48.5, unit m, no price.
<Description><CompleteText>
<DetailTxt><Text><p><span>HT-Abwasserrohr DN 110 aus Polypropylen nach DIN EN 1451, einschließlich Rohrschellen mit Schallschutzeinlage.</span></p></Text></DetailTxt>
<OutlineText><OutlTxt><TextOutlTxt><p><span>HT-Rohr DN 110</span></p></TextOutlTxt></OutlTxt></OutlineText>
</CompleteText></Description>
</Item>
The item's long text (DetailTxt) and short text (OutlineText).
<Item ID="I2" RNoPart="0020">
<Provis>WithoutTotal</Provis><Qty>4.000</Qty><QU>St</QU>
Provis WithoutTotal makes 01.01.0020 a contingency item (Bedarfsposition ohne GB): it gets a unit price, but no total that counts towards the LV.
<Description><CompleteText>
<DetailTxt><Text><p><span>Revisionsöffnung in Schachtwand, 300 x 300 mm, mit Rahmen und Deckel, nur auf Anordnung der Bauleitung.</span></p></Text></DetailTxt>
<OutlineText><OutlTxt><TextOutlTxt><p><span>Revisionsöffnung 300 x 300 mm</span></p></TextOutlTxt></OutlTxt></OutlineText>
</CompleteText></Description>
</Item>
</Itemlist>
</BoQBody>
</BoQCtgy>
</BoQBody>
</BoQCtgy>
Its texts, then the end of the item list and of both sections.
<BoQCtgy ID="C3" RNoPart="02"><LblTx><p><span>Heizungsinstallation</span></p></LblTx>
<BoQBody>
<BoQCtgy ID="C4" RNoPart="01"><LblTx><p><span>Heizflächen</span></p></LblTx>
<BoQBody>
<Itemlist>
Section 02 Heizungsinstallation with 02.01 Heizflächen.
<Item ID="I3" RNoPart="0010">
<Qty>14.000</Qty><QU>St</QU>
Item 02.01.0010: 14 pieces (St).
<Description><CompleteText>
<DetailTxt><Text><p><span>Flachheizkörper Typ 22, Bauhöhe 600 mm, Baulänge 1.200 mm, weiß RAL 9016, inkl. Wandkonsolen.</span></p><p><span>Angebotenes Fabrikat: </span><TextComplement Kind="Bidder" MarkLbl="1"><ComplBody><p><span>..........</span></p></ComplBody></TextComplement></p></Text></DetailTxt>
<OutlineText><OutlTxt><TextOutlTxt><p><span>Flachheizkörper Typ 22, 600 x 1200</span></p></TextOutlTxt></OutlTxt></OutlineText>
</CompleteText></Description>
</Item>
The long text already holds the gap for the offered make (TextComplement Kind="Bidder").
</Itemlist>
</BoQBody>
</BoQCtgy>
</BoQBody>
</BoQCtgy>
</BoQBody>
</BoQ>
</Award>
</GAEB>
End of the item list, the sections, the LV, the award block and the file.

Tender phase

Where the X81 fits in a tender

81 is the first step for an LV: the description of works in planning. For the tender, the LV goes out to bidders as an 83.

PhaseNameWhat it is
80Universal LV dataAny LV data, not tied to a step of the tender.
81Leistungsbeschreibung (description of works)
this file
The LV with its texts, as the planner hands it to the client. Usually without prices.
82Kostenanschlag (cost estimate)The LV with estimated prices, for award decisions and cost control.
83Angebotsaufforderung (request for quotation)The LV without prices, sent to the companies invited to bid.
84Angebotsabgabe (bid)The bidder's prices, text additions and free quantities, sent back to the client.
85Nebenangebot (alternative bid)A bid with an alternative way of execution, if the client allows it.
86Auftragserteilung (contract award)The award to the most economical bid. With it, the construction contract is concluded.
87Auftragsbestätigung (order confirmation)The contractor confirms the order.
89Rechnung (invoice)The invoice with items and quantities, which can be backed by quantity take-offs.
93–97Trade (Handel)Between contractor and manufacturer or wholesaler: price request (93), price offer (94), order (96), order confirmation (97).

Three generations of the format

FormatFilesStatus
GAEB DA XML
this file
.X80 to .X89, plus other phasesThe current standard, version 3.3 (edition 2023-01).
GAEB DA 2000.P81 to .P86Keyword format. No longer supported by the GAEB.
GAEB 90.D81 to .D86Line format with fixed columns. No longer supported by the GAEB.

Open and convert

How to open and convert an X81

An X81 opens like any other GAEB file. These are the usual ways.

TaskHow
Read it nowDrop the file into the viewer at the top of this page. It opens X8x, P8x and D8x files in your browser; the file is not uploaded.
Excel or CSVIn the viewer, choose Excel (.xlsx) or CSV: one row per item with OZ, short and long text, quantity, unit and prices.
PDFOpen the print view in the viewer and save it as PDF.
Work with itAVA or estimating software with a GAEB interface. The BVBS certifies such interfaces for GAEB DA XML 3.1 to 3.3.
Send it to biddersFor the tender, the same LV goes out to bidders as an X83, usually from AVA software.
Text editorAn X81 is XML: a text editor or browser opens it, but the texts sit between tags.

PDF and Excel tenders

Not every tender comes as GAEB.


Many bills of quantities still arrive as PDF, scan or Excel, and someone types them in. Mercura reads tenders in GAEB and PDF and suggests matching articles from your catalogue for every item, so a PDF tender is handled like an X83.

FAQ

Questions about GAEB files.

An X81 is a Leistungsbeschreibung (description of works) in GAEB DA XML, exchange phase 81. It carries the bill of quantities: the items in order of their item numbers with short and long texts, quantities and units, and usually no prices.

According to GAEB, the architect or engineer hands the LV to the client as an X81 during planning. For the tender, the client then sends it to the bidders as an X83.

Drop it into the GAEB viewer on this page. It shows the sections, items and long texts in your browser and exports them to Excel, CSV or PDF. The file is not uploaded.

Both carry the bill of quantities with its texts. The X81 is the description of works from planning; the X83 is the request for quotation sent to bidders, with a bid deadline and no price fields at all.

The phase 81 schema allows unit prices and totals, but according to GAEB a description of works usually has none. An LV with estimated prices is phase 82, the Kostenanschlag (cost estimate).

Yes: D81 in GAEB 90 and P81 in GAEB DA 2000. The phase names 81 to 86 are the same in all GAEB versions, and the viewer opens all of them.

Book a demo

See Mercura on

your own tenders.

Bring a real GAEB file. We’ll show you how Mercura reads it and matches every item to your catalog.

Book a demo

See Mercura on

your own tenders.

Bring a real GAEB file. We’ll show you how Mercura reads it and matches every item to your catalog.

Book a demo

See Mercura on

your own tenders.

Bring a real GAEB file. We’ll show you how Mercura reads it and matches every item to your catalog.