Skontoangaben im Zahlungstext korrekt formatieren

Fehler BR-DE-18 XRechnung

Skonto Zeilen in <name/> muessen diesem regulärem Ausdruck entsprechen: <value-of select="$XR-SKONTO-REGEX"/>. Die Informationen zur Gewährung von Skonto müssen wie folgt im Element "Payment terms" (BT-20) übermittelt werden: Anzugeben ist im ersten Segment "SKONTO", im zweiten "TAGE=n", im dritten "PROZENT=n". Prozentzahlen sind ohne Vorzeichen sowie mit Punkt getrennt von zwei Nachkommastellen anzugeben. Liegt dem zu berechnenden Betrag nicht BT-115, "fälliger Betrag" zugrunde, sondern nur ein Teil des fälligen Betrags der Rechnung, ist der Grundwert zur Berechnung von Skonto als viertes Segment "BASISBETRAG=n" gemäß dem semantischen Datentypen Amount anzugeben. Jeder Eintrag beginnt mit einer #, die Segmente sind mit einer # getrennt und eine Zeile schließt mit einer # ab. Am Ende einer vollständigen Skontoangabe muss ein XML-konformer Zeilenumbruch folgen. Alle Angaben zur Gewährung von Skonto müssen in Großbuchstaben gemacht werden. Zusätzliches Whitespace (Leerzeichen, Tabulatoren oder Zeilenumbrüche) ist nicht zulässig. Andere Zeichen oder Texte als in den oberen Vorgaben genannt sind nicht zulässig.

Pflichtregel: Solange sie verletzt ist, ist die Rechnung ungültig und wird von Validatoren abgewiesen.
Was nicht stimmt

Eine Skontoangabe in ram:Description entspricht nicht dem geforderten Format. Die Segmente müssen mit # beginnen und getrennt werden; erforderlich sind SKONTO, TAGE=n und PROZENT=n. Wenn die Berechnungsgrundlage nicht BT-115 ist, muss zusätzlich BASISBETRAG=n angegeben werden. Die Werte müssen großgeschrieben sein, der Prozentsatz muss ohne Vorzeichen und mit Punkt sowie zwei Nachkommastellen angegeben werden. Unzulässige Leerzeichen, andere Inhalte oder ein fehlender XML-konformer Zeilenumbruch am Ende führen ebenfalls zum Fehler.

Was die Regel bedeutet

Die Zahlungsbedingungen übermitteln die Angaben zur Gewährung von Skonto in einem festgelegten Textformat. Der Grundbetrag ist erforderlich, wenn der Skonto nicht auf dem fälligen Betrag BT-115, sondern auf einem Teilbetrag berechnet wird.

Betroffene Felder BT-20 BT-115
Bitte formatieren Sie die Skontoangaben in den Zahlungsbedingungen korrekt

Die Skontoangaben im Zahlungstext entsprechen nicht dem vorgeschriebenen Aufbau. Passen Sie die Segmente, den Prozentsatz und den abschließenden Zeilenumbruch an.

Was ist zu tun?
  1. Prüfen Sie die erste ram:Description unter ram:SpecifiedTradePaymentTerms.
  2. Geben Sie die Segmente in der Reihenfolge SKONTO, TAGE=n und PROZENT=n an und trennen Sie sie mit #.
  3. Wenn die Berechnungsgrundlage nicht BT-115 ist, ergänzen Sie BASISBETRAG=n; schließen Sie den Eintrag mit # und einem XML-konformen Zeilenumbruch ab.
  4. Prüfen Sie die Skontoangaben über AddTradePaymentTerms(...) oder PaymentTerms.
  5. Erzeugen Sie die Rechnung erneut und prüfen Sie sie erneut.
So sieht es aus
✗ Führt zur Meldung
<ram:SpecifiedTradePaymentTerms>
  <ram:Description>#SKONTO#TAGE=14#PROZENT=2#</ram:Description>
</ram:SpecifiedTradePaymentTerms>
✓ In Ordnung
<ram:SpecifiedTradePaymentTerms>
  <ram:Description>#SKONTO#TAGE=14#PROZENT=2.00#</ram:Description>
</ram:SpecifiedTradePaymentTerms>
In FactoorSharp prüfen
  • FacturXInvoice.AddTradePaymentTerms(description, dueDate, paymentTermsType, dueDays, percentage, baseAmount, actualAmount, maturityDate) (BT-20)
  • FacturXInvoice.ClearTradePaymentTerms() (BT-20)
  • FacturXInvoice.DuePayableAmount (BT-115)
  • FacturXInvoice.GetTradePaymentTerms() (BT-20)
  • FacturXInvoice.PaymentTerms (BT-20)
Technische Details

Der Test prüft jede mit # beginnende Zeile der ersten ram:Description gegen $XR-SKONTO-REGEX. Zusätzlich muss der Text nach dem letzten vollständigen Skontoeintrag mit einem Zeilenumbruch beginnen.

Wo die Regel greift

Die Regel prüft die erste Beschreibung unter ram:SpecifiedTradePaymentTerms in den Zahlungsangaben des Rechnungskopfs.

Kontext (rule/@context)
/rsm:CrossIndustryInvoice
Prüfausdruck (assert/@test)
every $line in rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ ram:SpecifiedTradePaymentTerms/ram:Description[1]/tokenize(. , '(\r?\n)')[starts-with( normalize-space(.) , '#')] satisfies matches ( normalize-space ($line), $XR-SKONTO-REGEX ) and matches( rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ ram:SpecifiedTradePaymentTerms/ram:Description[1]/tokenize(. , '#.+#')[last()], '^\s*\n' )