ECR Bestellungen

TransdatiX.Convert ECR Bestellungen

Version 2.0.0 vom 03.01.2006

Inhalt

Allgemeines

Dieser Konverter wandelt Ihre Bestelldaten in gültige EDIFACT ORDERS D.96A gemäß den Empfehlungen von ECR-Österreich Phase II Update 2005 oder umgekehrt.

Aufruf des Konverters

Um diesen TransdatiX.Convert zu benützen, müssen Sie zuerst Ihre Daten in CSV- oder XML-Dateien exportieren. Alles was Sie brauchen, um Ihre Daten für diesen Konverter aufzubereiten, befindet sich hier.

Sie haben dann viele Möglichkeiten, den TransdatiX.Convert aufzurufen, z.B. Sie definieren ein Prozess, in welchem Sie einen TransdatiX.Comm miteinbeziehen, um Konvertierung und Übermittlung zu automatisieren. Mehr Information über den TransdatiX.Configurator und andere Anbindungstechniken befindet sich hier.

Hinweise

Der Konverter arbeitet bidirektional und enthält sowohl Schnittstellen zur Erzeugung von EDIFACT ORDERS aus CSV- oder XML-Dateien (Ausgangsverarbeitung) als auch Schnittstellen zur Erzeugung von CSV- oder XML-Dateien aus EDIFACT ORDERS (Eingangsverarbeitung).

Der Konverter enthält vier Schnittstellen:
  • Ausgangsverarbeitung:
    • ConvertXmlToEdi
      • Konvertiert XML-Daten nach EDIFACT
    • ConvertCsvToEdi
      • Konvertiert CSV-Daten nach EDIFACT
  • Eingangsverarbeitung:
    • ConvertEdiToXml
      • Konvertiert EDIFACT nach XML
    • ConvertEdiToCsv
      • Konvertiert EDIFACT nach CSV
Bei der Verarbeitung eingehender Nachrichten erfolgt vor der eigentlichen Konvertierung eine Überprüfung, ob die EDIFACT-Eingabedatei der ECR-Empfehlung entspricht. Nicht ECR-konforme Nachrichten können mit diesem Konverter nicht verarbeitet werden.

Die Schnittstelle ConvertXmlToEdi erzeugt aus bis zu 10 XML-Fragmentdateien, die die Datenstruktur enthalten, eine EDIFACT ORDERS Datei.

Die Schnittstelle ConvertCsvToEdi erzeugt aus bis zu 10 CSV-Fragmentdateien, die die Datenstruktur enthalten, eine EDIFACT ORDERS Datei.

Die Schnittstelle ConvertEdiToXml erzeugt aus einer EDIFACT ORDERS Datei eine Ausgabedatei im XML-Format, die die gesamte Datenstruktur enthält.

Die Schnittstelle ConvertToCsv erzeugt aus einer EDIFACT ORDERS Datei drei Ausgabedateien im CSV-Format:
  • Envelope.csv - Übertragungsdaten
    Hier befinden sich alle Daten der Datengruppe Envelope

  • Order.csv - Bestellkopf
    Hier befinden sich alle Daten der Datengruppe Order

  • OrderPos.csv - Bestellpositionen
    Hier befinden sich alle Daten der Datengruppe OrderPos


Zu beachten: Das gewünschte Lieferdatum ist entweder im Bestellkopf anzugeben und gilt dann für alle Positionen oder wird bei jeder Artikelposition eigens angeführt. Wird kein Lieferdatum angegeben, so bedeutet das gemäß der ECR-Richtlinie "prompte Lieferung".

Technische Daten des Konverters

Konvertername:Convert.ECR.Order.txf
Konverterpfad:Applications\Convert\ECR\Order\
Schnittstellenname:ConvertXmlToEdi
Parameter:
- @InputFile1 bis
@InputFile10		XML-Eingangsdateifragmente
- @OutputFile1Ausgangsdatei EDIFACT ORDERS
- @TempFile1Zwischendatei
Standard: Applications\Convert\ECR\Order\Temp\Order.xml.tmp
Schnittstellenname:ConvertCsvToEdi
Parameter:
- @InputFile1 bis
@InputFile10		CSV-Eingangsdateifragmente
- @OutputFile1Ausgangsdatei EDIFACT ORDERS
- @TempFile1Zwischendatei
Standard: Applications\Convert\ECR\Order\Temp\Order.xml.tmp
Schnittstellenname:ConvertEdiToXml
Parameter:
- @InputFile1EDIFACT-Eingangsdatei
- @OutputFile1XML-Ausgabedatei
Schnittstellenname:ConvertEdiToCsv
Parameter:
- @InputFile1EDIFACT-Eingangsdatei
- @OutputFile1CSV-Ausgabedatei Envelope-Daten
- @OutputFile2CSV-Ausgabedatei Order-Daten
- @OutputFile3CSV-Ausgabedatei OrderPos-Daten
- @TempFile1Zwischendatei
Standard: Applications\Convert\ECR\Order\Temp\Order.xml.tmp

Beispiele

\Input\Order.xmlBeispiel-Eingabedatei im XML-Format zur Konvertierung EDIFACT aus XML
\Input\Order.min.ediBeispiel-Eingabedatei im Format EDIFACT ORDERS
Minimalvariante: es sind nur die notwendigsten Informationen enthalten
\Input\Order.max.ediBeispiel-Eingabeddatei im Format EDIFACT ORDERS
Maximalvariante: komplexere Variante am Beispiel eines Cross Docking Auftrags
\Output\Order.ediBeispiel-Ausgabedatei einer Konvertierung EDIFACT aus XML
\Output\Order.min.xmlBeispiel-Ausgabedatei einer Konvertierung XML aus EDIFACT
Minimalvariante
\Output\Order.max.xmlBeispiel-Ausgabedatei einer Konvertierung XML aus EDIFACT
Maximalvariante
\Output\Order.min.Envelope.csvBeispiel-Ausgabedatei Envelope-Daten einer Konvertierung CSV aus EDIFACT
Minimalvariante
\Output\Order.min.Order.csvBeispiel-Ausgabedatei Order-Daten einer Konvertierung CSV aus EDIFACT
Minimalvariante
\Output\Order.min.OrderPos.csvBeispiel-Ausgabedatei OrderPos-Daten einer Konvertierung CSV aus EDIFACT
Minimalvariante
\Output\Order.max.Envelope.csvBeispiel-Ausgabedatei Envelope-Daten einer Konvertierung CSV aus EDIFACT
Maximalvariante
\Output\Order.max.Order.csvBeispiel-Ausgabedatei Order-Daten einer Konvertierung CSV aus EDIFACT
Maximalvariante
\Output\Order.max.OrderPos.csvBeispiel-Ausgabedatei OrderPos-Daten einer Konvertierung CSV aus EDIFACT
Maximalvariante
\Temp\Order.xml.tmpZwischendatei einer Beispielkonvetierung

Datenstruktur - Übersicht

Folgende Liste zeigt die formelle Struktur der Daten, die der Konverter akzeptiert. Beschreibungen in Fettschrift bedeutet, dass das Element ein Mussfeld ist, außer wenn in der Beschreibung des Elementen eine Bedingung ausdrücklich formuliert wird.


Elementname

Beschreibung

 
MessageRoot-Element
 
  EnvelopeÜbertragungsdaten
    EnvelopeIDInterne Kennung
    SenderIdAbsender
    RecipientIdEmpfänger
    TransmissionIdÜbertragungsreferenz
    TestFlagTest-Kennzeichen
 
  OrderBestellkopf
    EnvelopeIDÜbertragungs-Referenz
    OrderIDInterne Kennung
    StatusArt der Bestellung
    FunctionNachrichtenfunktion
    NumberBestellnummer
    DateBestelldatum
    DeliveryDateGewünschtes Lieferdatum
    PurchasingInformationText1Beschaffungsinformation
    PurchasingInformationText2Beschaffungsinformation
    PurchasingInformationText3Beschaffungsinformation
    PurchasingInformationText4Beschaffungsinformation
    PurchasingInformationText5Beschaffungsinformation
    BuyerGLNKäufer
    SupplierGLNLieferant
    DeliveryGLNLieferanschrift
    DeliveryLocationIdNummer der Abladestelle
    UltimateCustomerGLNEndempfänger
    OrderedByGLNBesteller
    InvoiceeGLNRechnungsempfänger
    CurrencyWährung
    TransportModeTransportart
    TransportMediumArt des Transportmittels
    TransportTermsFunctionKennung Abholung/Lieferung
 
    OrderPosBestellpositionen
      OrderIDBestellkopf-Referenz
      OrderPosIDInterne Kennung
      NumberPositionsnummer
      ItemEANCustomerEAN
      ItemColorCodeCode aus Industriecodeliste für die Farbe
      ItemColorCodeListNumberNummer der Industriecodeliste für die Farbe
      ItemSizeCodeCode aus Industriecodeliste für die Größe
      ItemSizeListNumberNummer der Industriecodeliste für die Größe
      ItemNameArtikelbezeichnung
      QuantityBestellenge
      UnitEinheit
      DeliveryDateGewünschtes Lieferdatum dieser Position
      MinimumShelfLifeRequestedGeforderte mindeste Restlaufzeit
      PurchasingInformationText1Beschaffungsinformation
      PurchasingInformationText2Beschaffungsinformation
      PurchasingInformationText3Beschaffungsinformation
      PurchasingInformationText4Beschaffungsinformation
      PurchasingInformationText5Beschaffungsinformation
      NetPriceNettoeinkaufspreis je Einheit


Datengruppe Envelope - Übertragungsdaten
Mussfeld: ja, beliebig wiederholbar

EnvelopeID - Interne Kennung
Keyfeld
Format: Alphanumerisch
Hinweis: Kennung zur eindeutigen Identifikation einer Übertragung

SenderId - Absender
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN = Mailbox-ID des Absenders

RecipientId - Empfänger
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN = Mailbox-ID des Empfängers

TransmissionId - Übertragungsreferenz
Mussfeld: nein
Format: Alphanumerisch mit max. 14 Stelle(n)
Hinweis: Eindeutige Referenz der Übertragung, vergeben vom Sender. Wenn nicht übergeben, dann wird eine Referenz bezogen auf das aktuelle Datum und Uhrzeit gestellt

TestFlag - Test-Kennzeichen
Mussfeld: nein
Mögliche Werte:
1=Testbetrieb
Hinweis: Lt. Vereinbarung mit dem Partner


Datengruppe Order - Bestellkopf
Mussfeld: ja, beliebig wiederholbar
Enthält die Daten des Bestellkopfes

EnvelopeID - Übertragungs-Referenz
Keyfeld
Format: Alphanumerisch
Hinweis: Referenz auf die eindeutige Kennung der Übertragung

OrderID - Interne Kennung
Keyfeld
Format: Alphanumerisch
Hinweis: Kennung zur eindeutigen Identifikation eines Bestellkopfes

Status - Art der Bestellung
Mussfeld: nein
Mögliche Werte:
220=Bestellung (default)
Es handelt sich um eine gewöhnliche Bestellung
50E=Cross Docking Auftrag
Es handelt sich um eine Bestellung, die vom Lieferanten vorkommissioniert angeliefert werden muss
224=Eilauftrag
22E=CRP-Bestellung
Dieser Typ ist zu verwenden, wenn im Rahmen von CRP (Continuous Replenishment Program) Bestellungen von der Industrie zum Handel fließen
Hinweis: dcefiniert genauer, um welche Art Bestellung es sich handelt

Function - Nachrichtenfunktion
Mussfeld: nein
Mögliche Werte:
9=Original (default)
42=Bestätigung
Zur Bestätigung eines bereits - z.B. per Telefon - erteilten Auftrags.
Nicht als Auftragsbestätigung zu verwenden. Dazu dient die Nachricht ORDRSP.
Hinweis: dcefiniert genauer, um welche Art Bestellung es sich handelt

Number - Bestellnummer
Mussfeld: ja
Format: Alphanumerisch mit max. 35 Stelle(n)

Date - Bestelldatum
Mussfeld: ja
Format: Datum

DeliveryDate - Gewünschtes Lieferdatum
Mussfeld: nein
Format: Datum
Hinweis: Das Lieferdatum kann entweder auf Kopfebene angegeben werden kann oder in jeder Position. Wird beides angegeben, so übersteuert die Information auf Positionsebene die Information auf Kopfebene (siehe dazu auch Lieferdatum auf Positionsebene). Wird das Lieferdatum nicht angegeben, so bedeutet dies "prompte Lieferung".

PurchasingInformationText1 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

PurchasingInformationText2 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

PurchasingInformationText3 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

PurchasingInformationText4 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

PurchasingInformationText5 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

BuyerGLN - Käufer
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN des Käufers

SupplierGLN - Lieferant
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN des Lieferanten

DeliveryGLN - Lieferanschrift
Mussfeld: nein
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN des Warenempfängers
Angabe erforderlich wenn vom Käufer abweichend

DeliveryLocationId - Nummer der Abladestelle
Mussfeld: nein
Format: Alphanumerisch ***

UltimateCustomerGLN - Endempfänger
Mussfeld: nein
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN des Endempfängers
Diese Angabe wird für Cross Docking benötigt.
Hinweise zu Cross Docking:
  • als OrderType muss 50E angegeben werden, um eine Bestellung als Cross Docking Auftrag zu kennzeichnen
  • als DeliveryGLN muss die GLN des Cross Docking Punkts - also z.B. des Lagers, in dem die Anlieferung erfolgen soll - eingestellt werden
  • Als UltimtameCustomerGLN muss die GLN des Warenendempfängers - also z.B. der Filiale, für die die Ware vom Liefeanten vorkommissioniert angeliefert werden soll - eingestellt werden


OrderedByGLN - Besteller
Mussfeld: nein
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN des Bestellers
Angabe erforderlich wenn vom Käufer abweichend

InvoiceeGLN - Rechnungsempfänger
Mussfeld: nein
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis: GLN des Rechnungsempfängers
Angabe erforderlich wenn vom Käufer abweichend

Currency - Währung
Mussfeld: nein
Format: Alphanumerisch mit max. 3 Stelle(n)
Hinweis: ISO-Code der Bestellungswährung
Angabe erforderlich wenn auf Positionsebene Preisangaben erfolgen

TransportMode - Transportart
Mussfeld: nein
Mögliche Werte:
20=Bahntransport
30=Straßentransport
50=Post
Hinweis: Es können Einzelheiten zum gewünschten Transport angegeben werden. Die Übermittlung von Transportinformationen mit der Bestellung wird nicht empfohlen. Die Art des Transports sollte bilateral verinbart werden.

TransportMedium - Art des Transportmittels
Mussfeld: nein
Mögliche Werte:
25=Bahnexpress
34=Straßen-Paketexpreß
51=Paketdienst der Post
53=Normaler Postversand
55=Luftpost
Hinweis: Es können Einzelheiten zum gewünschten Transport angegeben werden. Die Übermittlung von Transportinformationen mit der Bestellung wird nicht empfohlen. Die Art des Transports sollte bilateral verinbart werden.

TransportTermsFunction - Kennung Abholung/Lieferung
Mussfeld: nein
Format: Alphanumerisch ***


Datengruppe OrderPos - Bestellpositionen
Mussfeld: ja, maximal 9999 Wiederholungen

OrderID - Bestellkopf-Referenz
Keyfeld
Format: Alphanumerisch
Hinweis: Referenz auf die eindeutige Kennung des Bestellkopfes

OrderPosID - Interne Kennung
Keyfeld
Format: Alphanumerisch
Hinweis: Kennung zur eindeutigen Identifikation einer Position

Number - Positionsnummer
Mussfeld: nein
Format: Ganzzahl
Hinweis: Vom Absender vergebene innerhalb der Bestellung eindeutige Positionsnummer
Wird bei der Eingangsverarbeitung (von EDIFACT nach XML oder CSV) gefüllt. Nicht erforderlich beim Ausgangsverarbeitung (XML oder CSV nach EDIFACT), da die Positionsnummer bei der EDIFACT-Erstellung automatisch generiert wird. Wird ignoriert, falls angegeben.

ItemEANCustomer - EAN
Mussfeld: ja
Format: Alphanumerisch mit max. 14 Stelle(n)
Hinweis: EAN des Artikels

ItemColorCode - Code aus Industriecodeliste für die Farbe
Mussfeld: nein
Format: Alphanumerisch mit max. 17 Stelle(n)
Hinweis: Von der Verwendung dieser Information wird von ECR explizit abgeraten! Diese Angabe wird nur verwendet, wenn die Identifizierung des Artikels nicht ausschließlich über die EAN erfolgen kann.

ItemColorCodeListNumber - Nummer der Industriecodeliste für die Farbe
Mussfeld: nein
Format: Alphanumerisch mit max. 3 Stelle(n)
Hinweis: Von der Verwendung dieser Information wird von ECR explizit abgeraten! Diese Angabe wird nur verwendet, wenn die Identifizierung des Artikels nicht ausschließlich über die EAN erfolgen kann.

ItemSizeCode - Code aus Industriecodeliste für die Größe
Mussfeld: nein
Format: Alphanumerisch mit max. 17 Stelle(n)
Hinweis: Von der Verwendung dieser Information wird von ECR explizit abgeraten! Diese Angabe wird nur verwendet, wenn die Identifizierung des Artikels nicht ausschließlich über die EAN erfolgen kann.

ItemSizeListNumber - Nummer der Industriecodeliste für die Größe
Mussfeld: nein
Format: Alphanumerisch mit max. 3 Stelle(n)
Hinweis: Von der Verwendung dieser Information wird von ECR explizit abgeraten! Diese Angabe wird nur verwendet, wenn die Identifizierung des Artikels nicht ausschließlich über die EAN erfolgen kann.

ItemName - Artikelbezeichnung
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis: Die Artikelbezeichnung kann optional angegeben werden, ist jedoch nicht erforderlich, da die eindeutige Identifizierung des Artikels über die EAN erfolgt.

Quantity - Bestellenge
Mussfeld: ja
Format: Decimal

Unit - Einheit
Mussfeld: nein
Mögliche Werte:
PCE=Stück (default)
KGM=Kilogramm
LTR=Liter
MTK=Quadratmeter
MTQ=Kubikmeter
MTR=Meter

DeliveryDate - Gewünschtes Lieferdatum dieser Position
Mussfeld: nein
Format: Datum
Hinweis: Das Lieferdatum muss entweder auf Kopfebene angegeben werden oder in jeder Position. Wird beides angegeben, so übersteuert die Information auf Positionsebene die Information auf Kopfebene. Die Angabe von unterschiedlichen Anlieferzeitpunkten je Position ist somit möglich, wird jedoch ausdrücklich nicht empfohlen. Werden unterschiedliche Lieferzeitpunkte gewünscht, so wird die Anlage mehrerer Bestellungen mit je einem Lieferdatum pro Auftrag empfohlen.

MinimumShelfLifeRequested - Geforderte mindeste Restlaufzeit
Mussfeld: nein
Format: Ganzzahl
Hinweis: Bei verderblichen Gütern kann an dieser Stelle dem Lieferanten in der Bestellung mitgeteilt werden, wie viele Tage das Produkt bei Anlieferung mindestens noch haltbar sein muss.

PurchasingInformationText1 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

PurchasingInformationText2 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

PurchasingInformationText3 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

PurchasingInformationText4 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

PurchasingInformationText5 - Beschaffungsinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis: Freier Text

NetPrice - Nettoeinkaufspreis je Einheit
Mussfeld: nein
Format: Decimal
Hinweis: Werden Preise übermittelt, so muss im Kopf die Referenzwährung festgelegt werden.
Die Angabe von Preisen in der Bestellung wird nicht empfohlen.

Rechtserklärung

Alle Informationen in diesem Dokument werden ohne Abgabe von Garantien, welcher Art auch immer, zur Verfügung gestellt. TransdatiX lehnt alle Haftungsansprüche, ausdrückliche oder implizite, einschliesslich Ansprüchen bezüglich Verkaufbarkeit und Eignung für bestimmte Zwecke, ausdrücklich ab. In keinem Fall kann TransdatiX oder dessen Lieferanten für irgendwelche Schäden, die direkt oder indirekt, zufällig oder als Folgeschaden auftreten, verantwortlich gemacht werden. Insbesondere sind Geschäftsverluste, Datenverluste oder spezielle Schäden von Haftungsansprüchen explizit ausgeschlossen, auch wenn TransdatiX oder dessen Lieferanten auf die Möglichkeit derartiger Schäden hingewiesen haben. In jedem Fall werden Haftungsansprüche bis zum gesetzlich höchstmöglichen Ausmass abgelehnt.

© 2002 - 2010 TransdatiX Software


Automatisch generiert 2011-08-25, 06:46:12