Free tool · GAEB viewer

X83 file: the GAEB request for quotation

An X83 is the GAEB DA XML file a client sends to bidders with a request for quotation: the bill of quantities with texts and quantities, but without prices. Drop yours into the viewer to read it or export it to Excel. Below: what an X83 holds, where it sits in the tender and how to open or convert it.

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 X83

First what an X83 holds, then a short X83 with three items, valid against the GAEB DA XML 3.3 schema and explained element by element.

What the file holds

ContentIn the fileNote
Project and LVYesProject, LV name, currency and bid deadline.
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 the bidder fills in, such as the offered make.
Unit prices and totalsNoThe phase 83 schema has no price fields. The prices come back in the X84.

The sample, explained

SampleWhat it says
X83 with three items
<?xml version="1.0" encoding="UTF-8"?>
<GAEB xmlns="http://www.gaeb.de/GAEB_DA_XML/DA83/3.3">
XML declaration and root element. The namespace names the exchange phase (DA83) 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>83</DP>
<AwardInfo><Cur>EUR</Cur><CurLbl>Euro</CurLbl><BidDate>2026-11-20</BidDate></AwardInfo>
The award block. DP is the exchange phase: 83 = Angebotsaufforderung (request for quotation). AwardInfo holds the currency and the bid deadline (BidDate).
<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. There is no unit price: the phase 83 schema has no field for it.
<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 ends with a bidder text addition (TextComplement Kind="Bidder"): a gap for the offered make that the bidder fills in with the X84.
</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 X83 fits in a tender

GAEB numbers the steps of a tender as exchange phases. 83 is the request for quotation: the client sends it to the bidders, and they answer with an 84.

PhaseNameWhat it is
80Universal LV dataAny LV data, not tied to a step of the tender.
81Leistungsbeschreibung (description of works)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)
this file
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 X83

You do not need AVA software to read an X83. These are the usual ways, depending on what you want to do with it.

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.
Reply with pricesYour estimating or AVA software reads the X83 and writes the X84 with your prices. In the GAEB converter you enter your unit prices in the browser and download the X84.
Text editorAn X83 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 X83 is a GAEB DA XML file of exchange phase 83, Angebotsaufforderung (request for quotation). It holds the bill of quantities with item numbers, short and long texts, quantities and units, but no prices. Bidders answer it with an X84.

Drop it into the GAEB viewer on this page. It shows the sections, items and long texts in your browser without installing anything, and the file is not uploaded. To answer it with your prices, use your estimating or AVA software or the free GAEB converter.

Open the X83 in the viewer and choose Excel or CSV for a table with one row per item, or open the print view and save it as PDF. The conversion runs in your browser.

The X83 is the request: texts and quantities, no prices. The X84 is the bidder's reply: for each item number it carries the unit price and, where it counts, the total, but usually no texts.

All three are phase 83, a request for quotation. The letter names the format: X for GAEB DA XML, the current standard, P for GAEB DA 2000 and D for GAEB 90. The viewer opens all three.

Not in the X83 itself: the phase 83 schema has no price fields. The prices go into the X84 you return. Estimating or AVA software writes it from the X83, and so does the free GAEB converter at mercura.ai/tools/gaeb-converter, where you type your unit prices in the browser.

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.