ConvertTo-EdifactInvoic

EulandaXtools — Funktionsreferenz

ConvertTo-EdifactInvoic

ÜBERSICHT

Wandelt eine EULANDA-RECHNUNG-XML-Datei in eine EDIFACT INVOIC-Nachricht.

SYNTAX

ConvertTo-EdifactInvoic [-XmlFile] <string> [[-EdiFile] <string>] [-Test] [<CommonParameters>]

BESCHREIBUNG

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.

PARAMETER

-XmlFile

Type: string

Pfad zur Rechnungsdatei im EULANDA-META-XML-Format; aus dieser werden die Daten gelesen.

-EdiFile

Type: string

Optionaler Pfad zur Ausgabedatei im EDIFACT-Format. Wenn der Wert nicht angegeben ist, wird die Datei `ORDERS.edi` im aktuellen Verzeichnis erstellt.

-Test

Type: switch

Optionales Flag zur Markierung der Geschäftsnachricht als Testnachricht. Diese sind über das UNB-Segment als Testdaten gekennzeichnet.

AUSGABEN

void

Kein Rückgabewert. Das EDIFACT-Datei wird auf Dateiebene erzeugt.

BEISPIELE

# 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`

HINWEISE