Skonto in field BT-20 is not valid in XRechnung for some cases

[roggyse]

Hello,
first of all, thank you for your great work.

Until now it worked well, but now I implemented the support for Skonto (Profile XRechnung 3.0). For this I added the skonto string as described in the official documentation: #SKONTO#TAGE=21#PROZENT=3.00#
The result is:

<ram:SpecifiedTradePaymentTerms>
        <ram:Description>#SKONTO#TAGE=28#PROZENT=14.00#</ram:Description>
        <ram:DueDateDateTime>
          <udt:DateTimeString format="102">20241223</udt:DateTimeString>
        </ram:DueDateDateTime>
</ram:SpecifiedTradePaymentTerms>

The kosit validator throws an error for this:

Das XML ist nicht valide.

Profil: urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0
Bestandene Regeln: 15
Gescheiterte Regeln: 1

Details

Error
[BR-DE-18] Skonto Zeilen in rsm:CrossIndustryInvoice muessen diesem regulärem Ausdruck entsprechen: #(SKONTO)#TAGE=([0-9]+#PROZENT=[0-9]+\.[0-9]{2})(#BASISBETRAG=-?[0-9]+\.[0-9]{2})?#$. 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. [ID BR-DE-18] from /xslt/XR_30/XRechnung-CII-validation.xslt)
/rsm:CrossIndustryInvoice

That means, each Skonto term must be written in a own line. So if I edit the XML-File like this it works (manually add line breaks on tag ram:Description):
ram:SpecifiedTradePaymentTerms
ram:Description
#SKONTO#TAGE=28#PROZENT=14.00#
</ram:Description>
ram:DueDateDateTime
<udt:DateTimeString format="102">20241223</udt:DateTimeString>
</ram:DueDateDateTime>
</ram:SpecifiedTradePaymentTerms>

Is there a possibility to add line breaks on your function "->addDocumentPaymentTerm()" or is this kind of skonto not supported yet?

Best regards
Dennis

[horstoeko]

HI @roggyse,

thank you for your contribution. Have you tried the following (look for the \n in the end of the string):

$document->addDocumentPaymentTerm("#SKONTO#TAGE=28#PROZENT=14.00#\n");

This will also work:

$document->addDocumentPaymentTerm("14 Prozent Skonto innerhalb von 2 Tagen\n#SKONTO#TAGE=28#PROZENT=14.00#\n");

This works for me

[horstoeko]

Hi @roggyse,

lookout for the release 1.0.81 - there is a new method addDocumentPaymentTermXRechnung. This should help you. All validators said: "Okay" :-)

Kind regards

[roggyse]

Hi @horstoeko,
I use Kosit Validator 1.5.0. For example https://erechnungsvalidator.service-bw.de/

I will checkout your changes tomorrow and give you some feedback here :-)

Thank you for your efforts.

[roggyse]

Hey @horstoeko ,
I checked your updates and this is working well.
Just check attached image. The description is mandatory, so I can't add the Skonto days/percents without giving them a description.
So I have to add it this way:
ram:Description#SKONTO#TAGE=21#PROZENT=3.00#
Die Rechnung ist zum 23.12.2024 fällig. Bei Zahlung innerhalb von 21 Tagen erhalten Sie 3% Skonto.</ram:Description>

I think this is not a problem at all, but would be nice if I could just add the first part (#SKONTO#TAGE=21#PROZENT=3.00#)

But it is a great feature ;)

[horstoeko]

Hi @roggyse,

you're absolutely right. I will improve that.

But it is a great feature ;)

Thank you.

Kind regards

[horstoeko]

Hi @roggyse,

I experimented a bit with the validator of kosIT. If I interpret the validation rules correctly, a plain text description is expected at the end. My manual tests also led to the same result. Do you have any other information?