Seitenhistorie
Die Realisierung des ZUGFeRD-Standards für profiforms Produkte geschieht in einem ZUGFeRD-Modul, dass in mehreren Produkten Anwendung findet.
Das ZUGFeRD-Modul ist eine Klassenbibliothek, mit allen Klassen, die der ZUGFeRD-Standard für ein CrossIndustryDocument vorsieht inkl. der dazugehörigen Hierarchie.
Das oberste Element ist dabei das CrossIndustryDocument selbst, das als internes CrossIndustryDocument im RAM gehalten wird. Dabei besitzt das ZUGFeRD-Modul zwei Schnittstellen zur Interaktion mit dem internen CrossIndustryDocument:
...
- Lesen einer ZUGFeRD-XML-Datei in ein internes CrossIndustryDocument (in Arbeit)
- Schreiben einer ZUGFeRD-XML-Datei aus einem internen CrossIndustryDocument (realisiert)
- Setzen von Werten des internen CrossIndustryDocument über Kommandosprache (realisiert)
- Lesen von Werten vom internen CrossIndustryDocument über Kommandosprache (in Arbeit)
- Validieren des internen CrossIndustryDocument (realisiert)
...
Adressieren von Elementen der internen ZUGFeRD-XML-Datei
...
Die Element-Namen der ZUGFeRD-XML-Datei werden nicht in dieser Dokumentation beschrieben, da es davon Hunderte gibt. Für diesen Zweck gibt es die „Technische Dokumentation“ die als Arbeitsmittel unentbehrlich ist. In der vorliegenden Implementierung wird ein Element-Name über einen Path beschrieben, der den genauen Ort des Elements beschreibt. Dabei werden die Element-namen ohne NameSpace-Angaben durch einen Punkt aneinander gereiht.
CrossIndustryDocument.SpecifiedSupplyChainTradeTransaction.ApplicableSupplyChainTradeSettlement.SpecifiedTradeSettlementMonetarySummation.ChargeTotalAmount
...
Handelt es sich bei der Ortsangabe um eine Array, dann erfolgt die Angabe des Array-Elements mit eckigen Klammern und dem Index-Angabe dazwischen. Das erste Element eines Array hat als Index-Nummer die Nummer 0. Wird ein Array-Index angesprochen, das ein nicht existierendes Element bezeichnet, so wird mit dem Befehl das fehlende Element und alle davor fehlende Elementen hinzugefügt.
CrossIndustryDocument.SpecifiedSupplyChainTradeTransaction.IncludedSupplyChainTradeLineItem[0]
Da die Pfadnamen sehr lang werden können, gibt es mehrere Wege der Vereinfachung. Zu allererst ist es zulässig den ersten Namen CrossIndustryDocument wegfallen zu lassen, da grundsätzlich jeder Pfad-Name mit CrossIndustryDocument beginnt und er damit selbsterklärend ist.
Weiterhin gibt es Möglichkeit über IDs zu arbeiten. Jedes Element besitzt eine ID über die es angesprochen werden kann. Der Set-Befehl liefert zum entsprechenden Pfad immer die ID zurück. Zukünfige Zugriffe können dann auch über die ID erfolgen.
Befehl | Pfad | Rückgabewert |
|---|---|---|
| 1. Set-Befehl | CrossIndustryDocument.SpecifiedSupplyChainTradeTransaction | 4 |
| 2. Set-Befehl | 4.IncludedSupplyChainTradeLineItem[0] | 0 |
...
| Anker | ||||
|---|---|---|---|---|
|
...
Das ZUGFeRD-Modul bietet einen Set-Befehl, der sehr universell verwendet werden kann.
Der Set-Befehl hat folgende Parameter:
Befehl | Parameter |
|---|---|
| 1 | ID |
| 2 | Path |
| n | Value (0-N) |
...
Die beiden Übergabeparameter ID und Path dienen zum Adressieren eines Elements. Die ID wird selbständig zum übergebenen Pfad hinzugefügt. Alles anderen Übergabeparameter sind Values und definieren den Inhalt des Elements bzw. den Inhalt seiner Unterelemente. :
Pfad: 8.ApplicableTradeTax[0]
Value | Beispiel |
|---|---|
| Value1 |
...
| “19,00 €,” (CalculatedAmount) | |
| Value2 |
...
| "VAT"( TypeCode) | |
| Value3 |
...
| “100,00 €” (BasisAmount) | |
| Value4 |
...
| “19%” (ApplicablePercent) |
Mit einem Set-Befehl werden gleich vier Unterelemente von ApplicableTradeTax gesetzt.
Natürlich kann auch jeder der vier Werte in einem separaten Set-Befehl gesetzt werden. Durch die Angabe spezieller Operatoren mit mehreren Werten spart man jedoch erheblich Schreibarbeit.
Dafür ist es jetzt schwerer zu verstehen, welcher Value welchen Wert setzt.
Die folgende Auflistung beschreibt, welche Element Operatoren mit mehreren Werten besitzen und der wievielte Value welches Unterelement setzt.
Objekt | Stellungsparameter | Unterobjekt |
|---|---|---|
| GuidelineSpecifiedDocumentContextParameter | 1 | ID |
| BusinessProcessSpecifiedDocumentContextParameter | 1 | ID |
| SpecifiedExchangedDocumentContext | 1 | GuidelineSpecifiedDocumentContextParameter.ID |
| IncludedNote | 1 2 | |
IncludedNote
...
3 | SubjectCode |
...
ContentCode |
...
Content[0] |
| EffectiveSpecifiedPeriod | 1 | CompleteDateTime |
...
| HeaderExchangedDocument | 1 2 3 4 5 n | ID |
...
Name |
...
TypeCode |
...
IssueDateTime |
...
CopyIndicator |
...
LanguageID[N] |
| SpecifiedTaxRegistration | 1 2 | ID |
...
ID.setSchemeID | ||
PostalTradeAddress
Bei einem Parameter
...
Da die profiforms-Produkte bereits über Lokalisierungs-Funktionen verfügen, ist es lediglich erforderlich das entsprechende Locale per per Befehl zu setzen.
SetLocale(locale)
...
Zahlen und Einheiten werden auf deutsche Sprache und Deutschland umgestellt.
...
| Anker | ||||
|---|---|---|---|---|
|
Im ZUGFeRD-Modul ist ein Validierer enthalten, der es erlaubt, das interne CrossIndustryDocument zu validieren. Der Validierer ist demnach kein XML-Validiere, der über eine XSD-Schemaprüfung arbeitet. Ganz im Gegenteil wurde auf die XSD-Schemaprüfung bewusst verzichtet, da der interne Validierer diese Aufgabe mit übernimmt.
...
Überblick
Inhalte