What the field is for
The specification's description (above, in German) translates as: "A textual description of the payment terms that apply to the amount due for payment (including a description of possible early payment discount terms)." BT-20 describes the payment terms in words: due date, early payment discount (German Skonto), notes on payment. The field is optional. If an amount is due (BT-115), BT-20 or the due date BT-9 should however be given (BR-CO-25).
Skonto: a fixed format
In XRechnung an early payment discount must not be a free sentence if it is to be read by a machine. The specification prescribes one line per discount level:
#SKONTO#TAGE=14#PROZENT=2.25#
#SKONTO#TAGE=14#PROZENT=2.25#BASISBETRAG=357.93#
- first segment
SKONTO, secondTAGE=n(days), thirdPROZENT=n(percent); - the percentage with a dot and exactly two decimals, without a sign:
2.00, not2or2,00; BASISBETRAG(base amount) only if the discount does not apply to the whole amount due;- everything in capitals, no spaces;
- every line starts and ends with
#, followed by a line break — after the last line too.
Free text may be there as well, but must not contain #. Every line that starts with # is
checked by rule BR-DE-18 as a discount line.
Which rules check the field
| Rule | What it requires | Level in XRechnung |
|---|---|---|
| BR-DE-18 | every line starting with # has the Skonto format |
error |
| BR-CO-25 | with an amount > 0, BT-9 or BT-20 is given | no longer checked (CEN 1.3.16) |
Where the field is in the file
| Syntax | Element |
|---|---|
| CII | ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradePaymentTerms/ram:Description |
| UBL | cac:PaymentTerms/cbc:Note |
Common mistakes
We checked all of these with the XRechnung 3.0.2 configuration — each one leads to BR-DE-18 and the invoice is rejected:
| Written | What is wrong |
|---|---|
#Skonto#Tage=14#Prozent=2.00# |
lower case |
#SKONTO#TAGE=14#PROZENT=2# |
percentage without two decimals |
#SKONTO#TAGE=14#PROZENT=2,00# |
comma instead of dot |
#SKONTO# TAGE=14#PROZENT=2.00# |
space |
#SKONTO#TAGE=14#PROZENT=2.00# with no line break at the end |
line break missing |
#1001 Zahlbar innerhalb von 14 Tagen |
free text starts with # |
A sentence like "2 % discount if paid within 7 days" is accepted — but no buyer's program can work out the discount from it.
Example
<!-- CII: two discount levels and a due date -->
<ram:SpecifiedTradePaymentTerms>
<ram:Description>#SKONTO#TAGE=7#PROZENT=3.00#
#SKONTO#TAGE=14#PROZENT=2.00#
Zahlbar innerhalb von 30 Tagen ohne Abzug.</ram:Description>
</ram:SpecifiedTradePaymentTerms>
<!-- UBL -->
<cac:PaymentTerms>
<cbc:Note>#SKONTO#TAGE=14#PROZENT=2.00#
</cbc:Note>
</cac:PaymentTerms>
Sources: KoSIT, XRechnung specification 3.0.2 (BT-20 with the Skonto format, BR-DE-18); XRechnung 3.0.2 validator configuration (regular expression of rule BR-DE-18).