EulandaXtools — Funktionsreferenz
Wandelt eine EULANDA-RECHNUNG-XML-Datei in eine EDIFACT INVOIC-Nachricht.
ConvertTo-EdifactInvoic [-XmlFile] <string> [[-EdiFile] <string>] [-Test] [<CommonParameters>]Diese Funktion verarbeitet eine `EULANDA-META-XML`-Datei vom Dokumententyp `INVOIC` und wandelt sie in eine standardkonforme `EDIFACT`-Nachricht vom Typ `INVOIC` um.
Dabei werden relevante Kopf-, Adress- und Positionsdaten extrahiert, aufbereitet und gemäß der zugrunde liegenden Syntax, `D96A` als voreingestellter Standard, serialisiert. Weitere Syntaxvarianten wie `D97A`, `D01A` usw., können problemlos ergänzt werden, jede davon über eine eigene Gruppen-Syntaxdatei.
Syntaxdateien müssen im Unterordner `syntax` innerhalb des Modulverzeichnisses gespeichert sein und folgen einem benennungsbasierten Aufbau: `EDIFACT-(nachrichtenart)-(syntax)-group.syntax`. Beispiel für eine `ORDERS`-Nachricht mit Syntax `D01B` wäre: `EDIFACT-orders-01b-group.syntax`. In der Datei wird `D` für Draft nicht angegeben, dieser Buchstabe ist nicht Teil der Syntaxkennung.
Der Standard-Modulordner unter PowerShell 5.x (Benutzerkontext) ist typischerweise: `C:\Users\cn\Documents\WindowsPowerShell\Modules\EulandaXTools` Darunter befinden sich die Versions-Ordner und darin jeweils der Ordner `syntax`.
Die resultierende EDIFACT-Nachricht enthält u.a. Rechnungsnummer, Beträge, Währung, Mehrwertsteuer und Rabatte und ist für den elektronischen Datenaustausch (= EDI) geeignet.
Wird der Parameter `-EdiFile` nicht angegeben, erfolgt die Ablage als `ORDERS.edi` im aktuellen Arbeitsverzeichnis.
Über ein eigenes Schedular-Objekt und einen Transport-Service lassen sich Nachrichten automatisch zeitgesteuert über AS2 oder SFTP versenden.
Der verfügbare Web-Server erlaubt das Monitoring udn die Konfiguration der Prozesse.
-XmlFile
Type: stringPfad zur Rechnungsdatei im EULANDA-META-XML-Format; aus dieser werden die Daten gelesen.
-EdiFile
Type: stringOptionaler Pfad zur Ausgabedatei im EDIFACT-Format. Wenn der Wert nicht angegeben ist, wird die Datei `ORDERS.edi` im aktuellen Verzeichnis erstellt.
-Test
Type: switchOptionales Flag zur Markierung der Geschäftsnachricht als Testnachricht. Diese sind über das UNB-Segment als Testdaten gekennzeichnet.
voidKein Rückgabewert. Das EDIFACT-Datei wird auf Dateiebene erzeugt.
# Konvertiert die Rechnung `rechnung.xml` in das EDIFACT-Format und speichert
# sie als `output.edi` in das Arbeitsverzeichnis.
ConvertTo-EdifactInvoic -XmlFile 'rechnung.xml' -EdiFile 'output.edi'# Wenn kein Pfad angegeben ist, wird die Datei `ORDERS.edi` im Arbeitsverzeichnis erzeugt.
ConvertTo-EdifactInvoic -XmlFile `rechnung.xml`