Problemfälle

Owned by Philipp Kern
Last updated: 15. Sept 2016
9 min read

Die innerhalb GAEB getroffenen Festlegungen sind in einigen Bereichen nicht ausreichend. Für folgende Problemfälle wurden zusätzliche Festlegungen getroffen.


Annahme von D83 durch den Handel

Der Eingang von Leistungsverzeichnissen (D83) beim Handel stellt die Regel dar und wird auch für die Zukunft als relevant angesehen.

Aus diesem Grund soll dies in die Liste der Datenaustauschphasen bzw. Prozesse aufgenommen werden.

Durch den Handel soll in jedem Fall ein Preisangebot (D94) bereitgestellt werden, da nur hier die Ausweisung der konkreten Artikel möglich ist.


Nicht übertragene Positionen im Preisangebot

Nicht übertragene Positionen werden immer als nicht angeboten betrachtet.


Teilerfüllung einer Position

Das Problem tritt nur auf, wenn ein Leistungsverzeichnis (D83) an den Handel gegeben wird. 

Im Fall, dass benötigtes Material nicht angeboten wird, wird hierfür eine gesonderte Position übertragen. 

Diese besitzt eine entsprechendes Lieferkennzeichen, welches noch festzulegen ist. Alle im LV (D83) genannten Dienstleistungen die nicht durch den Handel erbracht werden, werden nicht im Preisangebot (D94) genannt. 

Dienstleistungen die durch den Handel erbracht werden, werden explizit angeboten.


Anbieten von Artikeln ohne konkrete Artikelnummer

Die Position wird ohne Artikelnummer übertragen. Eine Bestellung erfolgt über die Angabe der Position aus dem Angebot.


Anbieten von Artikeln die keine Eindeutige Artikelnummer besitzen (Varianten)

Muss nicht gesondert betrachtet werden, da entweder eine Artikelnummer übertragen wird, mit der dann auch bestellt wird oder keine Artikelnummer übertragen wird (siehe Anbieten von Artikeln ohne konkrete Artikelnummer).


Es wird ein anderer Artikel angeboten (Eckventil)

Der Artikel muss als Alternativ-Position angeboten und gekennzeichnet werden.


Referenzierung und OZ

Innerhalb der Referenzangaben stehen zwei parallele Referenzierungen für den Kunden und den Verkäufer zur Verfügung. 

Hierbei gilt, dass die Handwerkssoftware die Referenzierung des Kunden vergibt und das Großhandels- System die des Verkäufers.
Im Fall, dass ein Leistungsverzeichnis (D83) an den Handel übertragen wird, wird nur die OZ als Referenz des Kunden genutzt.


Sets

Die Übertragung erfolgt als Position mit Unterposition.
Hierbei werden die Unterpositionen entsprechend gekennzeichnet (ItemType ="jumbo-sub") und erhalten als Unterpositionsnummer die Nummer der Position. 

Die Unterpositionen sind rein zur Information und weder Bestell- noch Preisrelevant.

InhaltOZGH-PosNr.GH-ArtikelnummerGH-UnterPosNr.MengeNettopreisZusätzliches Positionskennzeichen
GAEB Element bezogen auf das Element OrderItemRefItem/ CostumerRefItems/ SupplierRefItems/ SupplierSubNoArtNoQtyNetPriceItemType

Position 1000 bestehend aus
4 mal der Unterposition 1001 und
4 mal der Unterposition 1002 

1001000-XYZ12200-
Unterposition zu 100010010011000XYZ14-„jumbo-sub“
Unterposition zu 100010010021000XYZ24-„jumbo-sub“
Position 20001002000-ABC5100-
Position 30001003000-XYZ11500-

Mengen der Unterpositionen beziehen sich immer auf die Menge „1“ der Position.

Beispiel:


<?xml version="1.0" encoding="UTF-8"?>
<!-- Mit XMLSpy v2006 rel. 3 sp2 bearbeitet (http://www.altova.com) von Manfred Nagel (BVBS - Bundesverband Bausoftware e.V.) -->
<GAEB xmlns="http://www.gaeb.de/GAEB_DA_XML/200706"
      xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://www.gaeb.de/GAEB_DA_XML/200706
      GAEB_DA_XML_Order.xsd">
  <GAEBInfo>
    <Version>3.1</Version>
    <VersDate>2004-07</VersDate>
    <Date>2010-03-22</Date>
  </GAEBInfo>
  <Order>
    <DP>94</DP>
    <OrderInfo>
      <Inquiry>project-inquires</Inquiry>
    </OrderInfo>
    <OrderItem ID="I100">
      <ItemChara>normal</ItemChara>
      <RefItems>
        <Costumer>100</Costumer>
        <Supplier>1000</Supplier>
      </RefItems>
      <ArtNo>XYZ</ArtNo>
      <Qty>1</Qty>
      <QU>PCE</QU>
      <Description>
        <CompleteText>
          <DetailTxt>
            <Text>
              <span>Position 1000 bestehend aus 4 mal der Unterposition 1001 und 4 mal der Unterposition 1002</span>
            </Text>
          </DetailTxt>
        </CompleteText>
      </Description>
      <NetPrice>2200</NetPrice>
    </OrderItem>
    <OrderItem ID="I200">
      <ItemChara>normal</ItemChara>
      <ItemType>jumbo-sub</ItemType>
      <RefItems>
         <Costumer>100</Costumer>
         <Supplier>1001</Supplier>
         <SupplierSubNo>1000</SupplierSubNo>
      </RefItems>
      <ArtNo>XYZ1</ArtNo>
      <Qty>4</Qty>
      <QU>PCE</QU>
      <Description>
        <CompleteText>
          <DetailTxt>
            <Text>
              <span>Unterposition zu 1000</span>
            </Text>
          </DetailTxt>
        </CompleteText>
      </Description>
    </OrderItem>
    <OrderItem ID="I300">
      <ItemChara>normal</ItemChara>
      <ItemType>jumbo-sub</ItemType>
      <RefItems>
        <Costumer>100</Costumer>
        <Supplier>1002</Supplier>
        <SupplierSubNo>1000</SupplierSubNo>
      </RefItems>
      <ArtNo>XYZ2</ArtNo>
      <Qty>4</Qty>
      <QU>PCE</QU>
      <Description>
        <CompleteText>
          <DetailTxt>
            <Text>
              <span>Unterposition zu 1000</span>
            </Text>
          </DetailTxt>
        </CompleteText>
      </Description>
    </OrderItem>
    <OrderItem ID="I400">
      <ItemChara>normal</ItemChara>
      <RefItems>
        <Costumer>100</Costumer>
        <Supplier>2000</Supplier>
      </RefItems>
      <ArtNo>ABC</ArtNo>
      <Qty>5</Qty>
      <QU>PCE</QU>
      <Description>
        <CompleteText>
          <DetailTxt>
            <Text>
              <span>Position 2000</span>
            </Text>
          </DetailTxt>
        </CompleteText>
      </Description>
      <NetPrice>100</NetPrice>
    </OrderItem>
    <OrderItem ID="I500">
      <ItemChara>normal</ItemChara>
      <RefItems>
        <Costumer>100</Costumer>
        <Supplier>3000</Supplier>
      </RefItems>
      <ArtNo>XYZ1</ArtNo>
      <Qty>1</Qty>
      <QU>PCE</QU>
      <Description>
        <CompleteText>
          <DetailTxt>
            <Text>
              <span>Position 3000</span>
            </Text>
          </DetailTxt>
        </CompleteText>
      </Description>
      <NetPrice>500</NetPrice>
    </OrderItem>
  </Order>
</GAEB>


Preise

Analog zur Schnittstelle Shop-Anbindung werden folgende Preise übertragen: 


Angebotspreis 

Brutto-, Listenpreis 


Nettopreis 

Einkaufspreis des Kunden. Beinhaltet Rabatte bzw. Rohstoffanteile und bezieht sich immer auf 1 Einheit der Menge bzw. auf 1 Abrechnungsmengeneinheit. Siehe auch Regeln zu OrderItem.


Bitte beachten: Bei der IDS Shop-Schnittstelle bezieht sich der Nettopreis bei Version 1.01 auf eine Mengeneinheit. Ab Versin 1.03 ist der Nettopreis der Positionseinkaufspreis, also EK * Menge.

Rohstoffanteil, DEL-Notierung


Problemstellung

Innerhalb einer GAEB Nachricht können Artikel angeboten werden bei denen eine berücksichtigung von Rohstoffanteilen und  DEL-Notierungen relevant sind.

Beispielartikel

50 Meter Ring Kabel 

Preis 10.000,00 € pro 1.000 Meter 

Kupfergewicht beträgt 96 Kilogramm pro 100 Meter

Der Preis ist mit einem Kupferpreis von 150 € pro 100 Kilogramm verkalkuliert. 

Der aktuelle Kupferpreis beträgt 300 € pro 100 Kilogramm 

Der Rabatt entspricht 10%

Dateninhalt BeispielAnmerkungGAEB Element
Anfrage- / Angebotsmenge (AM)50
<Qty>50</Qty>
Anfrage- / Angebots-Mengeneinheit (AME)MTR für Meter
<QU>MTR</QU>
Angebotspreis (AP)10000
<OfferPrice>10000.00</OfferPrice>
Nettopreis (NP)522
<NetPrice>522.00</NetPrice>
Preisbasis (PB)1000
<PriceBasis>1000</PriceBasis>
Rohstoff (R)KupferDie Übertragung erfolgt lediglich als Name der Preismodifikation<PriceModification>
  <Name>Kupfer</Name>
  ...
</PriceModification>
Gewichtsanteilswert (GAW)96Eine Übertragung ist in der aktuellen Version GAEB nicht möglich. Hier wird eine erweiterung der GAEB Nachrichtangestrebt. (Siehe Erweiterungen zum GAEB 3.1)
Gewichtsanteilseinheit (GAE) KGM für KilogrammEine Übertragung ist in der aktuellen Version GAEB nicht möglich. Hier wird eine erweiterung der GAEB Nachrichtangestrebt. (Siehe Erweiterungen zum GAEB 3.1)
Basiswert (BW) 100Eine Übertragung ist in der aktuellen Version GAEB nicht möglich. Hier wird eine erweiterung der GAEB Nachrichtangestrebt. (Siehe Erweiterungen zum GAEB 3.1)
Basiseinheit (BE) MTR für MeterEine Übertragung ist in der aktuellen Version GAEB nicht möglich. Hier wird eine erweiterung der GAEB Nachrichtangestrebt. (Siehe Erweiterungen zum GAEB 3.1)
Basis DEL-Notierung pro 100 Kilogramm (BN)150Eine Übertragung ist in der aktuellen Version GAEB nicht möglich. Hier wird eine erweiterung der GAEB Nachrichtangestrebt. (Siehe Erweiterungen zum GAEB 3.1)
Aktuelle DEL-Notierung pro 100 Kilogramm (AN)300
<Quotation>
   <Kind ID="CU150"/>
   <PriceFrom>150.00</PriceFrom>
   <Cur ISO="EUR"/>
   <Weight>100.00</Weight>
   <UW>KGM</UW>
</Quotation>
Rabatt (R)10,00%
<PriceModification>
  ...
  <DiscountPcnt>10.00</DiscountPcnt>
</PriceModification>

Berechnung Kupferzuschlag und Nettopreis

Kupferzuschlag (KZ) = AM * (GAW / BW) * (AN- BN) 

                              = 50 m * (96 kg / 100 m) * ((300 € / 100 kg) – (150 € / 100 kg)) 

                              = 72 € 

Nettopreis (NP)        = (PB * (AP / PB) – R + KZ ) 

                              = 50 m * ((10.000 € / 1000 m ) -1.000 € / 1000 m) + 72 € 

                              = 10.000 € - 1.000 €+ 1440 € = 522 €

Beispielnachricht

<?xml version="1.0" encoding="UTF-8"?>
<GAEB xmlns="http://www.gaeb.de/GAEB_DA_XML/200706" 
  xmlns:ds="http://www.w3.org/2000/09/xmldsig#" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:schemaLocation="http://www.gaeb.de/GAEB_DA_XML/200706 
  C:\Entwicklung\gaebxml\GAEBXML31\GAEB_DA_XML_Order.xsd">
  <GAEBInfo>
    <Version>3.1</Version>
    <VersDate>2004-07</VersDate>
    <Date>2009-11-16</Date>
  </GAEBInfo>
  <Order>
    <DP>94</DP>
    <OrderInfo>
      <Inquiry>project-inquires</Inquiry>
      <Quotation>                              <!-- Angabe der aktuellen DEL-Notierung -->
        <Kind ID="CU150"/>
        <PriceFrom>150.00</PriceFrom>
        <Cur ISO="EUR"/>
        <Weight>100.00</Weight>
        <UW>KGM</UW>
      </Quotation>
    </OrderInfo>
    <OrderItem ID="I200">
      <Qty>50</Qty>
      <QU>MTR</QU>
      <Description>
        <CompleteText>
          <DetailTxt> 
            <Text>
              <p>
                <span>50 Meter Ring Kabel</span>
              </p>
            </Text>
          </DetailTxt>
        </CompleteText>
      </Description>
      <OfferPrice>10000.00</OfferPrice>
      <NetPrice>522.00</NetPrice>
      <PriceBasis>1000</PriceBasis>
      <PriceModification>
        <Name>Kupfer</Name>
        <Quotation IDRef="CU150"/>              <!-- Verweis auf die im Kopf definierte DEL Notierung -->
        <DiscountPcnt>10.00</DiscountPcnt>
      </PriceModification>
    </OrderItem>
  </Order>
</GAEB>


Alternativposition 90er Phasen

Alternativpositionen in den 90er Phasen werden vom Grundsatz her wie normale Positionen abgebildet. 

Sie treten direkt nach der Position auf die sie sich beziehen.

Gekennzeichnet werden sie durch das Element "ItemChara" mit dem Inhalt "alternate".

Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Mit XMLSpy v2006 rel. 3 sp2 bearbeitet (http://www.altova.com) von Manfred Nagel (BVBS - Bundesverband Bausoftware e.V.) -->
<GAEB xmlns="http://www.gaeb.de/GAEB_DA_XML/200706" 
      xmlns:ds="http://www.w3.org/2000/09/xmldsig#" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://www.gaeb.de/GAEB_DA_XML/200706
      C:\Entwicklung\gaebxml\GAEBXML31\GAEB_DA_XML_Order.xsd">
	<GAEBInfo>
		<Version>3.1</Version>
		<VersDate>2004-07</VersDate>
		<Date>2009-11-16</Date>
	</GAEBInfo>
	<Order>
		<DP>94</DP>
		<OrderInfo>
			<Inquiry>project-inquires</Inquiry>
			<Quotation>
				<Kind ID="CU150"/>
				<PriceFrom>150.00</PriceFrom>
				<Cur ISO="EUR"/>
				<Weight>100.00</Weight>
				<UW>KGM</UW>
			</Quotation>
		</OrderInfo>
		<OrderItem ID="I200">
			<ItemChara>normal</ItemChara> 
			<Qty>50</Qty>
			<QU>MTR</QU>
			<Description>
				<CompleteText>
					<DetailTxt>
						<Text>
							<p>
								<span>50 Meter Ring Kabel</span>
							</p>
						</Text>
					</DetailTxt>
				</CompleteText>
			</Description>
			<OfferPrice>10000.00</OfferPrice>
			<NetPrice>522.00</NetPrice>
			<PriceBasis>1000</PriceBasis>
			<PriceModification>
				<Name>Kupfer</Name>
				<Quotation IDRef="CU150"/>
				<DiscountPcnt>10.00</DiscountPcnt>
			</PriceModification>
		</OrderItem>
		<OrderItem ID="I300">
			<ItemChara>alternate</ItemChara> 
			<Qty>2</Qty>
			<QU>Stck</QU>
			<Description>
				<CompleteText>
					<DetailTxt>
						<Text>
							<p>
								<span>25 Meter Ring Kabel</span>
							</p>
						</Text>
					</DetailTxt>
				</CompleteText>
			</Description>
			<OfferPrice>10000.00</OfferPrice>
			<NetPrice>522.00</NetPrice>
			<PriceBasis>1000</PriceBasis>
		</OrderItem>
	</Order>
</GAEB>


Eventualposition / Bedarfspositionen

Der in der Praxis meist verwendete Begriff Bedarfsposition kann auch gegen die Bezeichnung Eventualposition ausgetauscht werden. Beide Bezeichnungen sind fachlich richtig. 

In einer Bedarfsposition beschreibt der Auftraggeber/Handwerker eine Produkt/Leistung, die nur im Bedarfsfall ausgeführt/geliefert werden soll. Bedarfspositionen dürfen nur ausnahmsweise in dem Bestellwesen aufgenommen werden, wenn sie erfahrungsgemäß zur Ausführung der vertraglichen Leistung erforderlich werden können und ihre Notwendigkeit zum Zeitpunkt der Aufstellung der Bestellpositionen trotz aller örtlichen und technischen Kenntnisse nicht festzustellen ist. 

Bedarfspositionen werden durch das Element "ItemChara" mit dem Inhalt "provis" gekennzeichnet.

Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Mit XMLSpy v2006 rel. 3 sp2 bearbeitet (http://www.altova.com) von Manfred Nagel (BVBS - Bundesverband Bausoftware e.V.) -->
<GAEB xmlns="http://www.gaeb.de/GAEB_DA_XML/200706" 
      xmlns:ds="http://www.w3.org/2000/09/xmldsig#" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://www.gaeb.de/GAEB_DA_XML/200706
      C:\Entwicklung\gaebxml\GAEBXML31\GAEB_DA_XML_Order.xsd">
	<GAEBInfo>
		<Version>3.1</Version>
		<VersDate>2004-07</VersDate>
		<Date>2009-11-16</Date>
	</GAEBInfo>
	<Order>
		<DP>94</DP>
		<OrderInfo>
			<Inquiry>project-inquires</Inquiry>
			<Quotation>
				<Kind ID="CU150"/>
				<PriceFrom>150.00</PriceFrom>
				<Cur ISO="EUR"/>
				<Weight>100.00</Weight>
				<UW>KGM</UW>
			</Quotation>
		</OrderInfo>
		<OrderItem ID="I200">
			<ItemChara>normal</ItemChara> 
			<Qty>50</Qty>
			<QU>MTR</QU>
			<Description>
				<CompleteText>
					<DetailTxt>
						<Text>
							<p>
								<span>50 Meter Ring Kabel</span>
							</p>
						</Text>
					</DetailTxt>
				</CompleteText>
			</Description>
			<OfferPrice>10000.00</OfferPrice>
			<NetPrice>522.00</NetPrice>
			<PriceBasis>1000</PriceBasis>
			<PriceModification>
				<Name>Kupfer</Name>
				<Quotation IDRef="CU150"/>
				<DiscountPcnt>10.00</DiscountPcnt>
			</PriceModification>
		</OrderItem>
		<OrderItem ID="I300">
			<ItemChara>provis</ItemChara> 
			<Qty>1</Qty>
			<QU>Stck</QU>
			<Description>
				<CompleteText>
					<DetailTxt>
						<Text>
							<p>
								<span>Transportwagen</span>
							</p>
						</Text>
					</DetailTxt>
				</CompleteText>
			</Description>
			<OfferPrice>20.00</OfferPrice>
			<NetPrice>20.00</NetPrice>
		</OrderItem>
	</Order>
</GAEB>


Dienstleistungen die durch den Handel erbracht werden

<?xml version="1.0" encoding="UTF-8"?>
<!-- Mit XMLSpy v2006 rel. 3 sp2 bearbeitet (http://www.altova.com) von Manfred Nagel (BVBS - Bundesverband Bausoftware e.V.) -->
<GAEB xmlns="http://www.gaeb.de/GAEB_DA_XML/200706" 
      xmlns:ds="http://www.w3.org/2000/09/xmldsig#" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://www.gaeb.de/GAEB_DA_XML/200706
      C:\Entwicklung\gaebxml\GAEBXML31\GAEB_DA_XML_Order.xsd">
	<GAEBInfo>
		<Version>3.1</Version>
		<VersDate>2004-07</VersDate>
		<Date>2009-11-16</Date>
	</GAEBInfo>
	<Order>
		<DP>94</DP>
		<OrderInfo>
			<Inquiry>project-inquires</Inquiry>
			<Cur ISO="EUR"></Cur>
		</OrderInfo>
		<OrderItem ID="I200">
			<ItemChara>normal</ItemChara> 
			<DeliveryChara>no supply</DeliveryChara>  <!-- Keine Lieferung -->
			<Qty>10</Qty>
			<QU>Std</QU>
			<Description>
				<CompleteText>
					<DetailTxt>
						<Text>
							<p>
								<span>Heizungsanlage aufstellen</span>
							</p>
						</Text>
					</DetailTxt>
				</CompleteText>
			</Description>
			<NetPrice>55.00</NetPrice>
		</OrderItem>
	</Order>
</GAEB>


Abbildung von globalen Zuschläge oder Rabatt

Globale Zuschläge / Rabatte werden durch das Element "PriceModification" im Element "OrderInfo" übertragen.

Die Anwendung der globalen Zuschläge und Rabatte muss in der Reihenfolgen des Auftretens in der Nachricht erfolgen. Es gelten immer erst die angaben der Position und dann die Angaben im Kopf.

Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Mit XMLSpy v2006 rel. 3 sp2 bearbeitet (http://www.altova.com) von Manfred Nagel (BVBS - Bundesverband Bausoftware e.V.) -->
<GAEB xmlns="http://www.gaeb.de/GAEB_DA_XML/200706" 
    xmlns:ds="http://www.w3.org/2000/09/xmldsig#" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://www.gaeb.de/GAEB_DA_XML/200706
    C:\Entwicklung\gaebxml\GAEBXML31\GAEB_DA_XML_Order.xsd">
	<GAEBInfo>
		<Version>3.1</Version>
		<VersDate>2004-07</VersDate>
		<Date>2009-11-16</Date>
	</GAEBInfo>
	<Order>
		<DP>94</DP>
		<OrderInfo>
			<Inquiry>project-inquires</Inquiry>
			<Cur ISO="EUR"></Cur>
			<PriceModification>
				<DiscountPcnt>10.0</DiscountPcnt> <!-- Nachlass 10% -->
			</PriceModification>
			<PriceModification>
				<MarkupAbs>30.0</MarkupAbs>	<!-- Zuschlag 30,- Euro -->
			</PriceModification>
			<Quotation>
				<Kind ID="CU150"/>
				<PriceFrom>150.00</PriceFrom>
				<Cur ISO="EUR"/>
				<Weight>100.00</Weight>
				<UW>KGM</UW>
			</Quotation>
		</OrderInfo>
		<OrderItem ID="I200">
			<ItemChara>normal</ItemChara> 
			<Qty>50</Qty>
			<QU>MTR</QU>
			<Description>
				<CompleteText>
					<DetailTxt>
						<Text>
							<p>
								<span>50 Meter Ring Kabel</span>
							</p>
						</Text>
					</DetailTxt>
				</CompleteText>
			</Description>
			<OfferPrice>10000.00</OfferPrice>
			<NetPrice>522.00</NetPrice>
			<PriceBasis>1000</PriceBasis>
			<PriceModification>
				<Name>Kupfer</Name>
				<Quotation IDRef="CU150"/>
				<DiscountPcnt>10.00</DiscountPcnt>
			</PriceModification>
		</OrderItem>
	</Order>
</GAEB>