Praktiker Bestellungen

TransdatiX.Convert Praktiker Bestellungen

Version 2.0.1 vom 2008-05-06

Inhalt

Allgemeines

Mit diesem Konverter können Bestellungen der Praktiker Bau- und Heimwerkermärkte Holding AG im EDIFACT-Format in XML oder CSV umgewandelt werden.

Aufruf des Konverters

Dieser TransdatiX.Convert konvertiert Ihre Eingangsdaten nach XML oder CSV im unten beschriebenen Format. Diese Daten können dann entweder direkt in ein Programm importiert werden oder mittels eines TransdatiX.Adapt an ein Zielsystem übergeben werden.

Sie können diesen TransdatiX.Convert beispielsweise in einem Prozess gemeinsam mit dem für Ihr Zielsystem benötigten TransdatiX.Adapt automatisiert aufrufen. Auch eine integrierte Datenübermittlung in einem Prozess ist möglich. Lesen Sie hier mehr über die Definition von Prozessen mit dem TransdatiX.Configurator.

Hinweise

Der Konverter erwartet als Eingabe die Bestelldaten von Praktiker im EDIFACT-Format.

Es sind zwei Schnittstellen enthalten, mit denen die EDIFACT-Daten entweder nach XML oder nach CSV konvertiert werden können.

Die Schnittstelle ConvertToXml erzeugt eine Ausgabedatei im XML-Format, die die gesamte Datenstruktur enthält.

Die Schnittstelle ConvertToCsv erzeugt vier Ausgabedateien im CSV-Format:
  • Envelope - Übertragungsdaten
    Hier befinden sich alle Daten der Datengruppe Envelope

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

  • Pos - Bestellpositionen
    Hier befinden sich alle Daten der Datengruppe Pos

  • PosCharge - Positionsrabatte
    Hier befinden sich alle Daten der Datengruppe PosCharge

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

 
RootRoot-Element
 
  MessageNachricht
    MessageIDInterne eindeutige Kennung
 
    EnvelopeÜbertragungsdaten
      MessageIDReferenz auf MessageID in Datengruppe Message
      SenderIdAbsender
      RecipientIdEmpfänger
      MessageTypeEDIFACT-Nachrichtentyp
      TransmissionIdÜbertragungsreferenz
      TestFlagTestbetrieb
 
    OrderBestellkopf
      MessageIDReferenz auf MessageID in Datengruppe Message
      OrderIDInterne eindeutige Kennung
      StatusBestellart
      NumberBestellnummer
      DateBestelldatum
      DeliveryDateGeforderter Liefertermin
      EarliestDeliveryDateFrühester Liefertermin
      LatestDeliveryDateSpätester Liefertermin
      FreeText1Freier Liefertext
      FreeText2Freier Liefertext
      FreeText3Freier Liefertext
      PromotionalDealNumberAktionsnummer
      UltimateCustomerReferenceNumberReferenznummer des Endkunden
      BuyerGLNGLN des Käufers (Praktiker-Zentrale)
      BuyerNameName des Käufers
      BuyerStreetStrasse des Käufers
      BuyerCityStadt des Käufers
      BuyerZipCodePLZ des Käufers
      BuyerCountryCodeLand des Käufers
      SupplierGLNGLN des Lieferanten
      DeliveryGLNGLN des Praktiker-Marktes, der die Ware empfängt
      DeliveryNameName des Warenemfängers
      DeliveryStreetStrasse des Warenemfängers
      DeliveryCityStadt des Warenemfängers
      DeliveryZipCodePLZ des Warenemfängers
      DeliveryCountryCodeLand des Warenemfängers
      UltimateCustomerNameName des Endkunden
      UltimateCustomerStreetStrasse des Endkunden
      UltimateCustomerCityStadt des Endkunden
      UltimateCustomerZipCodePLZ des Endkunden
      UltimateCustomerCountryCodeLand des Endkunden
      UltimateCustomerContactTelephoneTelefonnummer des Endkunden
      InvoiceeGLNRechnungsempfänger GLN (wenn abweichend vom Käufer)
      CurrencyWährung
      PaymentDaysZahlungsziel in Tagen
 
      PosBestellpositionen
        MessageIDReferenz auf MessageID in Datengruppe Message
        OrderIDReferenz auf OrderID in Datengruppe Order
        PosIDInterne eindeutige Kennung
        NumberPositionsnummer
        ItemEANSupplierLieferanten-EAN des Artikels
        ItemEANCustomerKunden-EAN des Artikels
        ItemIdSupplierArtikelnummer des Lieferanten
        ItemIdBuyerTeilennummer des Käufers (Praktiker)
        ItemNameArtikeltext
        ItemName2Artikeltext 2
        QuantityMenge
        UnitEinheit
        FreeText1Freie Textinformation
        NetPriceNettopreis
        GrossPriceBruttopreis
 
        PosChargePositionsbezogene Zu-/Abschläge
          MessageIDReferenz auf MessageID in Datengruppe Message
          OrderIDReferenz auf InvoiceID in Datengruppe Invoice
          PosIDReferenz auf PosID in Datengruppe Pos
          StatusZu- oder Abschlagstyp
          QualifierZu-/Abschlagsart
          CalculationLevelKalkulationsstufe
          QuantityMenge
          UnitEinheit
          PercentageProzentsatz
          AmountBetrag


Datengruppe Message - Nachricht
Mussfeld: ja, beliebig wiederholbar

MessageID - Interne eindeutige Kennung
Keyfeld
Format: Alphanumerisch
Hinweis:

Datengruppe Envelope - Übertragungsdaten
Mussfeld: ja

MessageID - Referenz auf MessageID in Datengruppe Message
Keyfeld
Format: Alphanumerisch
Hinweis:
SenderId - Absender
Mussfeld: ja
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis: Mailbox-ID des Absenders

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

MessageType - EDIFACT-Nachrichtentyp
Mussfeld: nein
Format: Alphanumerisch mit max. 14 Stelle(n)
Hinweis: Wenn eine Envelope nur Nachrichten eines Typs enthält kann als Information für den Empfänger im Kopf der Nachrichtentyp angegeben werden.

TransmissionId - Übertragungsreferenz
Mussfeld: nein
Format: Alphanumerisch mit max. 14 Stelle(n)
Hinweis: Eindeutige Referenz der Übertragung, vergeben vom Sender.

TestFlag - Testbetrieb
Mussfeld: nein
Mögliche Werte:
1=Testbetrieb
Hinweis: Wird nur bei Datenaustausch im Testlauf verwendet


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

MessageID - Referenz auf MessageID in Datengruppe Message
Keyfeld
Format: Alphanumerisch
Hinweis:
OrderID - Interne eindeutige Kennung
Keyfeld
Format: Alphanumerisch
Hinweis:
Status - Bestellart
Mussfeld: nein
Mögliche Werte:
220=Bestellung
Hinweis:
Number - Bestellnummer
Mussfeld: ja
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
Date - Bestelldatum
Mussfeld: ja
Format: Datum
Hinweis:
DeliveryDate - Geforderter Liefertermin
Mussfeld: ja
Format: Datum
Hinweis:
EarliestDeliveryDate - Frühester Liefertermin
Mussfeld: nein
Format: Datum
Hinweis:
LatestDeliveryDate - Spätester Liefertermin
Mussfeld: nein
Format: Datum
Hinweis:
FreeText1 - Freier Liefertext
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis:
FreeText2 - Freier Liefertext
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis:
FreeText3 - Freier Liefertext
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis:
PromotionalDealNumber - Aktionsnummer
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
UltimateCustomerReferenceNumber - Referenznummer des Endkunden
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis: Wenn diese Information verfügbar ist, dann handelt es sich um eine spezielle Bestellung für einen Endkunden

BuyerGLN - GLN des Käufers (Praktiker-Zentrale)
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis:
BuyerName - Name des Käufers
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
BuyerStreet - Strasse des Käufers
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
BuyerCity - Stadt des Käufers
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
BuyerZipCode - PLZ des Käufers
Mussfeld: nein
Format: Alphanumerisch mit max. 9 Stelle(n)
Hinweis:
BuyerCountryCode - Land des Käufers
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
SupplierGLN - GLN des Lieferanten
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis:
DeliveryGLN - GLN des Praktiker-Marktes, der die Ware empfängt
Mussfeld: ja
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis:
DeliveryName - Name des Warenemfängers
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
DeliveryStreet - Strasse des Warenemfängers
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
DeliveryCity - Stadt des Warenemfängers
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
DeliveryZipCode - PLZ des Warenemfängers
Mussfeld: nein
Format: Alphanumerisch mit max. 9 Stelle(n)
Hinweis:
DeliveryCountryCode - Land des Warenemfängers
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
UltimateCustomerName - Name des Endkunden
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis: Nur verwendet, wenn die Ware an diese Adresse geliefert werden sollen

UltimateCustomerStreet - Strasse des Endkunden
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis: Nur verwendet, wenn die Ware an diese Adresse geliefert werden sollen

UltimateCustomerCity - Stadt des Endkunden
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis: Nur verwendet, wenn die Ware an diese Adresse geliefert werden sollen

UltimateCustomerZipCode - PLZ des Endkunden
Mussfeld: nein
Format: Alphanumerisch mit max. 9 Stelle(n)
Hinweis: Nur verwendet, wenn die Ware an diese Adresse geliefert werden sollen

UltimateCustomerCountryCode - Land des Endkunden
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis: Nur verwendet, wenn die Ware an diese Adresse geliefert werden sollen

UltimateCustomerContactTelephone - Telefonnummer des Endkunden
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis: Nur verwendet, wenn die Ware an diese Adresse geliefert werden sollen

InvoiceeGLN - Rechnungsempfänger GLN (wenn abweichend vom Käufer)
Mussfeld: nein
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis:
Currency - Währung
Mussfeld: nein
Format: Alphanumerisch mit max. 3 Stelle(n)
Hinweis: ISO-Code der Bestellwährung

PaymentDays - Zahlungsziel in Tagen
Mussfeld: nein
Format: Ganzzahl
Hinweis:

Datengruppe Pos - Bestellpositionen
Mussfeld: ja, beliebig wiederholbar

MessageID - Referenz auf MessageID in Datengruppe Message
Keyfeld
Format: Alphanumerisch
Hinweis:
OrderID - Referenz auf OrderID in Datengruppe Order
Keyfeld
Format: Alphanumerisch
Hinweis:
PosID - Interne eindeutige Kennung
Keyfeld
Format: Alphanumerisch
Hinweis:
Number - Positionsnummer
Mussfeld: nein
Format: Ganzzahl
Hinweis:
ItemEANSupplier - Lieferanten-EAN des Artikels
Mussfeld: nein
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis:
ItemEANCustomer - Kunden-EAN des Artikels
Mussfeld: nein
Format: Alphanumerisch mit max. 13 Stelle(n)
Hinweis:
ItemIdSupplier - Artikelnummer des Lieferanten
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
ItemIdBuyer - Teilennummer des Käufers (Praktiker)
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
ItemName - Artikeltext
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
ItemName2 - Artikeltext 2
Mussfeld: nein
Format: Alphanumerisch mit max. 35 Stelle(n)
Hinweis:
Quantity - Menge
Mussfeld: ja
Format: Decimal
Hinweis:
Unit - Einheit
Mussfeld: nein
Format: Alphanumerisch mit max. 3 Stelle(n)
Hinweis:
FreeText1 - Freie Textinformation
Mussfeld: nein
Format: Alphanumerisch mit max. 70 Stelle(n)
Hinweis:
NetPrice - Nettopreis
Mussfeld: nein
Format: Decimal
Hinweis: Nettopreis pro Einheit (Preis mit Zu-/Abschläge, ohne MwSt)

GrossPrice - Bruttopreis
Mussfeld: nein
Format: Decimal
Hinweis: Bruttopreis pro Einheit (Preis ohne Zu-/Abschläge, ohne MwSt)


Datengruppe PosCharge - Positionsbezogene Zu-/Abschläge
Mussfeld: nein, maximal 15 Wiederholungen

MessageID - Referenz auf MessageID in Datengruppe Message
Keyfeld
Format: Alphanumerisch
Hinweis:
OrderID - Referenz auf InvoiceID in Datengruppe Invoice
Keyfeld
Format: Alphanumerisch
Hinweis:
PosID - Referenz auf PosID in Datengruppe Pos
Keyfeld
Format: Alphanumerisch
Hinweis:
Status - Zu- oder Abschlagstyp
Mussfeld: ja
Mögliche Werte:
A=Abschlag
C=Zuschlag
Hinweis:
Qualifier - Zu-/Abschlagsart
Mussfeld: nein
Mögliche Werte:
DI=Rabatt
Hinweis:
CalculationLevel - Kalkulationsstufe
Mussfeld: nein
Format: Ganzzahl
Hinweis: Mussfeld bei mehr als einem Ab- bzw. Zuschlag

Quantity - Menge
Mussfeld: nein
Format: Decimal
Hinweis:
Unit - Einheit
Mussfeld: nein
Format: Alphanumerisch mit max. 3 Stelle(n)
Hinweis:
Percentage - Prozentsatz
Mussfeld: nein
Format: Decimal
Hinweis:
Amount - Betrag
Mussfeld: nein
Format: Decimal
Hinweis:

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 - 2007 TransdatiX Software


Automatisch generiert 2008-05-06, 15:52:20