Fehler in AllowanceCharge Reihenfolge

[NickSOAD]

Hallo,

folgendes ist mir beim Erstellen von cac:AllowanceChargeElementen in einer InvoiceLine aufgefallen:

1. Die AllowanceCharge wird über die Funktion TradeLineItem.AddTradeAllowanceCharge in dem Unterpunkt cac:Price erstellt. Sollte cac:AllowanceCharge nicht ein direktes Child von cac:InvoiceLine sein?
2. In der Funktion TradeLineItem.AddTradeAllowanceCharge wird das element chargePercentage und reason nicht in die xml geschrieben.

Danke und Grüße
Niklas :)

[tobitege]

Soviel ich weiss, gehört der Zu-/Abschlag direkt zu Price:

<cac:Price>
    <cbc:PriceAmount currencyID="USD">100.00</cbc:PriceAmount>
    <cbc:BaseQuantity unitCode="EA">1</cbc:BaseQuantity>
    <cac:AllowanceCharge>
        <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
        <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode>
        <cbc:AllowanceChargeReason>Volume discount</cbc:AllowanceChargeReason>
        <cbc:MultiplierFactorNumeric>0.10</cbc:MultiplierFactorNumeric>
        <cbc:Amount currencyID="USD">10.00</cbc:Amount>
        <cbc:BaseAmount currencyID="USD">100.00</cbc:BaseAmount>
    </cac:AllowanceCharge>
</cac:Price>

[NickSOAD]

Erstmal Danke für die Antwort :)

Wenn ich es so mache, wie du beschrieben hast, kommt im Validator der Fehler:
PEPPOL-EN16931-R120 und PEPPOL-EN16931-R046
Die bekomme ich auch nicht weg, obwohl Preise eigentlich alle Stimmen.

Als Beispiel:

<cac:InvoiceLine>
    <cbc:ID>1</cbc:ID>
    <cbc:InvoicedQuantity unitCode="C62">2.00</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="EUR">128.52</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Name>CabinLED7-3030-EB-3pol-w (5600K)                  </cbc:Name>
      <cac:SellersItemIdentification>
        <cbc:ID>020466              </cbc:ID>
      </cac:SellersItemIdentification>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>19.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">71.40</cbc:PriceAmount>
      <cbc:BaseQuantity unitCode="C62">1.00</cbc:BaseQuantity>
      <cac:AllowanceCharge>
        <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
        <cbc:Amount currencyID="EUR">14.28</cbc:Amount>
        <cbc:BaseAmount currencyID="EUR">142.80</cbc:BaseAmount>
      </cac:AllowanceCharge>
    </cac:Price>
  </cac:InvoiceLine>

Ändere ich das nun in

<cac:InvoiceLine>
    <cbc:ID>1</cbc:ID>
    <cbc:InvoicedQuantity unitCode="C62">2.00</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="EUR">128.52</cbc:LineExtensionAmount>
    <cac:AllowanceCharge>
      <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
      <cbc:AllowanceChargeReason>Deswegen</cbc:AllowanceChargeReason>
      <cbc:MultiplierFactorNumeric>10</cbc:MultiplierFactorNumeric>
      <cbc:Amount currencyID="EUR">14.28</cbc:Amount>
      <cbc:BaseAmount currencyID="EUR">142.80</cbc:BaseAmount>
    </cac:AllowanceCharge>
    <cac:Item>
      <cbc:Name>CabinLED7-3030-EB-3pol-w (5600K)                  </cbc:Name>
      <cac:SellersItemIdentification>
        <cbc:ID>020466              </cbc:ID>
      </cac:SellersItemIdentification>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>19.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">71.40</cbc:PriceAmount>
      <cbc:BaseQuantity unitCode="C62">1.00</cbc:BaseQuantity>      
    </cac:Price>
  </cac:InvoiceLine>

Läuft alles ohne Probleme durch (Sofern ich die AllowanceChargeReason und MultiplierFactorNumeric noch händisch hinzufüge).

[tobitege]

Hallo @NickSOAD ,
hmm ich habe grade mal in UBL Invoice 2.1 geschaut, wo applies to a price component steht
und ich das so lese, dass AllowanceCharge halt zum Price gehört.

         <xsd:element ref="cac:AllowanceCharge" minOccurs="0" maxOccurs="unbounded">
            <xsd:annotation>
               <xsd:documentation>
                  <ccts:Component>
                     <ccts:ComponentType>ASBIE</ccts:ComponentType>
                     <ccts:DictionaryEntryName>Invoice. Allowance Charge</ccts:DictionaryEntryName>
                     <ccts:Definition>A discount or charge that applies to a price component.</ccts:Definition>
                     <ccts:Cardinality>0..n</ccts:Cardinality>
                     <ccts:ObjectClass>Invoice</ccts:ObjectClass>
                     <ccts:PropertyTerm>Allowance Charge</ccts:PropertyTerm>
                     <ccts:AssociatedObjectClass>Allowance Charge</ccts:AssociatedObjectClass>
                     <ccts:RepresentationTerm>Allowance Charge</ccts:RepresentationTerm>
                  </ccts:Component>
               </xsd:documentation>
            </xsd:annotation>
         </xsd:element>

Habe auch dies gefunden:
https://www.oioubl.info/Classes/en/Price.AllowanceCharge.html

Jetzt weiss, ich nicht, wie sehr sich diese ganzen UBL Versionen unterscheiden.

P.S.: jetzt erst gesehen: wie bei ZUGFeRD auch, es gibt AllowanceCharge auf beiden Ebenen, sowohl InvoiceLine und Price. 😄

https://www.oioubl.info/Classes/en/InvoiceLine.html

[NickSOAD]

Okay, Interessant, doch etwas undurchsichtig alles. :)
Ich habe noch etwas rumprobiert und es scheint, dass die InvoiceLine.Price.AllowanceCharge nicht in die LegalMonetaryTotal.AllowanceTotalAmount mit rein zählt. Daher immer die o.g. Fehler.
Besteht hier irgendwie die Möglichkeit in die InvoiceLine die AllowanceCharge mit ein zu bauen, da ich im LegalMonetaryTotal natürlich auch den AllowanceTotalAmount Betrag angeben möchte.

[tobitege]

Nur als Info/Referenz, falls das mal jemand zum Codieren braucht.

Beispieldatei: https://docs.oasis-open.org/ubl/os-UBL-2.3/xml/UBL-Invoice-2.1-Example.xml

Die LegalMonetaryTotal.AllowanceTotalAmount enthält wohl tatsächlich NUR Zu-/Abschläge auf Dokumentenebene.
(Da ich beruflich bisher nur mit CII zu tun gehabt habe, war das erstmal verwirrend.)

Stark reduzierter Auszug nur mit den hier relevanten Zeilen:

	<cac:InvoiceLine>
		<cac:AllowanceCharge>
			<cbc:ChargeIndicator>false</cbc:ChargeIndicator>
			<cbc:AllowanceChargeReason>Damage</cbc:AllowanceChargeReason>
			<cbc:Amount currencyID="EUR">12</cbc:Amount>
		</cac:AllowanceCharge>
		<cac:AllowanceCharge>
			<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
			<cbc:AllowanceChargeReason>Testing</cbc:AllowanceChargeReason>
			<cbc:Amount currencyID="EUR">10</cbc:Amount>
		</cac:AllowanceCharge>
		<cac:Price>
			<cbc:PriceAmount currencyID="EUR">1273</cbc:PriceAmount>
			<cbc:BaseQuantity unitCode="C62">1</cbc:BaseQuantity>
			<cac:AllowanceCharge>
				<cbc:ChargeIndicator>false</cbc:ChargeIndicator>
				<cbc:AllowanceChargeReason>Contract</cbc:AllowanceChargeReason>
				<cbc:MultiplierFactorNumeric>0.15</cbc:MultiplierFactorNumeric>
				<cbc:Amount currencyID="EUR">225</cbc:Amount>
				<cbc:BaseAmount currencyID="EUR">1500</cbc:BaseAmount>
			</cac:AllowanceCharge>
		</cac:Price>
	</cac:InvoiceLine>

Rechenweg: 1500 - 15% + 10 - 12 = 1273

Das habe ich jetzt noch nicht im Code nachgeschaut, ob das dort bereits komplett implementiert ist oder ggf. noch Elemente fehlen sollten (ist schon 1:38 Uhr).

[tobitege]

Hallo @NickSOAD ,
In deinem 1. Beispiel waren nicht das Hinzufügen von AllowanceChargeReason und MultiplierFactorNumeric ausschlaggebend (beide sind optional in UBL?),
sondern dass der Rabatt "verschoben" wurde (auf Positionsebene statt Einzelpreis), sodass die Validierung im 2. Auszug dann klappte.

Die genannte PEPPOL Regeln geben da die passenden Hinweise, wie sich z.B. der Positionsbetrag ergeben muss:
https://test-docs.peppol.eu/poacc/billing/3.0/rules/ubl-peppol/PEPPOL-EN16931-R120/

Im ersten Beispiel, wo Price den Rabatt enthielt, waren die Werte inkorrekt:

    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">71.40</cbc:PriceAmount>
      <cbc:BaseQuantity unitCode="C62">1.00</cbc:BaseQuantity>
      <cac:AllowanceCharge>
        <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
        <cbc:Amount currencyID="EUR">14.28</cbc:Amount>
        <cbc:BaseAmount currencyID="EUR">142.80</cbc:BaseAmount>
      </cac:AllowanceCharge>
    </cac:Price>

Korrekte Version:
Im Price Element (ohne USt) werden ja "brutto" und "netto"-Betrag auf den Artikel bezogen, nicht die Positionszeile.

Somit ist der eigentliche BaseAmount also 71,40 ("brutto"), und bei 10% Rabatt ergibt dies als PriceAmount nun 64,26 ("netto").
Multipliziert mit der Positionsmenge (hier: 2) ergibt sich dann in LineExtensionAmount der Wert von 128.52:

    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">64.26</cbc:PriceAmount>
      <cbc:BaseQuantity unitCode="C62">1.00</cbc:BaseQuantity>
      <cac:AllowanceCharge>
        <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
        <cbc:Amount currencyID="EUR">7.14</cbc:Amount>
        <cbc:BaseAmount currencyID="EUR">71.40</cbc:BaseAmount>
      </cac:AllowanceCharge>
    </cac:Price>

Ich habe das so jetzt nicht durch einen Validator geschickt, sondern einfach von der Regel hergeleitet.

Hoffentlich habe ich (mit zu wenig Kaffee am Morgen) die Begrifflichkeiten nicht verdreht oder andere Fehler begangen. 😄

Wie im vorherigen Post schon geschrieben, steht die Codierung auf einem anderen Blatt Papier, den UBL Writer müsste ich mir erst noch genauer anschauen.

[NickSOAD]

Hallo @tobitege,

danke für die Ausführliche Rückmeldung.
Im großen und ganzen hast du da recht.
Ich habe gestern noch etwas mit dem ganzen AllowanceCharge Thema rum gespielt.
Auf der InvoiceLine.AllowanceCharge ebene ist das Feld AllowanceChargeReason Pflicht. In der Price Ebene allerdings nicht.
Genauso ist MultiplierFactorNumeric Pflicht, wenn ich einen BaseAmount angebe, warum auch immer.

Dann kommt allerdings die "Frage" auf, dass wenn die Funktion TradeLineItem.AddTradeAllowanceCharge die AllowanceChrage auf der Price Ebene hinzufügt, wieso die ganzen Parameter mit angegeben werden müssen. Eigentlich braucht man in dem Fall für die Funktion dann nur den ChargeIndicator und Amount. Alles andere Interessiert auf der Ebene eigentlich nicht.
Außerdem wäre es ggfls. gut, eine Möglichkeit zu haben, sowohl auf der Price, als auch auf der TradeLineItem Ebene eine AllowanceCharge hinzuzufügen.

Danke für die Infos! :)

[tobitege]

Es gibt ja 2 Methoden dazu in TradeLineItem:
AddSpecifiedTradeAllowanceCharge für InvoiceLine.AllowanceCharge Element
und
AddTradeAllowanceCharge für Price.AllowanceCharge Element.
Hattest du schon beide probiert?