hogast Order
TransdatiX.Convert hogast Order
Version 2.0.0 vom 17.01.2005
Inhalt
Allgemeines
Mit diesem Konverter können Sie die hogast-Bestelldaten in bequeme CSV-Dateien umwandeln, die Sie in Ihr System importieren können.
Hinweise
Dieses Format entspricht dem allgemeinen hogast XML-Transaktionsformat, das auch bei den hogast Lieferscheinen verwendet wird.Der Konverter erwartet die Bestelldatei der hogast als Input-Parameter und generiert zwei CSV-Dateien:
- Order.csv - Bestellkopf
Hier befinden sich alle Daten der Datengruppen Order und OrderTax. - Order.csv - Bestellkopf
Hier befinden sich alle Daten der Datengruppen OrderPos, OrderPosCharge und OrderPosTax. Da die Positionen einen einzigen MwSt-Prozentsazt und maximal einen Rabatt enthalten können, werden diese zwei Spalten (OrderPosChargePercentage und OrderPosTaxPercentage) angehängt.
Technische Aufbereitung der Daten und 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 + Übermittlung zu automatisieren. Mehr Information über den TransdatiX.Configurator und andere Anbindungstechniken befindet sich hier.
Technische Daten des Konverters
| Konvertername: | Convert.Hogast.Order.txf |
| Konverterpfad: | Applications\Convert\Hogast\Order\ |
| Schnittstellenname: | ConvertFiles |
| Parameter: | |
| - @InputFile1 | Pfad zur Inputdatei im hogast XML-Transaktion Format |
| - @TempFile1 (optional) | Pfad zur Zwischendatei, die bei der Konvertierung verwendet wird |
| - @OutputFile1 | Pfad zur Outputdatei für Envelope-Daten |
| - @OutputFile2 | Pfad zur Outputdatei für Order-Daten |
| - @OutputFile3 | Pfad zur Outputdatei für OrderPos-Daten |
Beispiele
| \Input\InputFile.xml | Datei mit Daten im hogast XML-Transaktionsformat |
| \Output\Envelope.csv | Outputdatei 1 |
| \Output\Order.csv | Outputdatei 2 |
| \Output\OrderPos.csv | Outputdatei 3 |
Wichtiger Hinweis:
Bitte vergewissern Sie sich, dass die Datei _Trans.dtd im gleichen Verzeichnis liegt wie die XML-Inputdatei. Die _Trans.dtd Datei befindet sich im Verzeichnis /InputDatenstruktur - Ü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 |
| Message | Root-Element |
| Envelope | Übertragungsdaten |
| SenderId | Absender |
| RecipientId | Empfänger |
| TransmissionId | Übertragungsreferenz |
| TestFlag | Testbetrieb |
| Order | Bestellkopf |
| OrderID | Interne Bestellnnummer |
| Number | Bestellnummer |
| Date | Bestelldatum |
| DeliveryDate | Gewünschtes Lieferdatum |
| InvoiceDate | Gewünschtes Rechnungsdatum |
| DeliveryGLN | Lieferanschrift |
| DeliveryName | Name der Lieferanschrift |
| DeliveryStreet | Straße der Lieferanschrift |
| DeliveryCity | Ort der Lieferanschrift |
| DeliveryZipCode | PLZ der Lieferanschrift |
| DeliveryContactTelephone | Telefonnummer der Lieferanschrift |
| DeliveryContactFax | Faxnummer der Lieferanschrift |
| DeliveryContactEmail | Email-Adresse der Lieferanschrift |
| DeliveryContactWeb | Homepage der Lieferanschrift |
| DeliveryFreeText | Freier Text |
| InvoiceReceiverGLN | Rechnungsempfänger |
| InvoiceReceiverName | Name des Rechnungsempfängers |
| InvoiceReceiverStreet | Straße des Rechnungsempfängers |
| InvoiceReceiverCity | Ort des Rechnungsempfängers |
| InvoiceReceiverZipCode | PLZ des Rechnungsempfängers |
| InvoiceReceiverContactTelephone | Telefonnummer des Rechnungsempfängers |
| InvoiceReceiverContactFax | Faxnummer des Rechnungsempfängers |
| InvoiceReceiverContactEmail | Email-Adresse des Rechnungsempfängers |
| InvoiceReceiverContactWeb | Homepage des Rechnungsempfängers |
| InvoiceReceiverFreeText | Freier Text |
| Currency | Währung |
| TotalPositionAmount | Gesamtpositionsbetrag |
| TotalAmount | Rechnungsendbetrag |
| OrderCharge | Positionsrabatt |
| Percentage | Gesamtrabatt in Prozent |
| OrderPos | Lieferscheinposition |
| OrderID | Interne Bestellnummer |
| OrderPosID | Eindeutige Positionsnummer |
| Number | Positionsnummer |
| ItemEANCustomer | EAN |
| ItemNumber | Artikelnummer des Lieferanten |
| ItemName | Artikelbezeichnung |
| Quantity | Menge |
| Unit | Einheit |
| QuantityPriceBasis | Verkaufsmenge |
| UnitPriceBasis | Verkaufseinheit |
| QuantityDelivery | Liefermenge |
| UnitDelivery | Liefereinheit |
| NettPrice | Nettopreis |
| GrossPrice | Bruttopreis |
| FreeText | Freier Text |
| OrderPosTax | Mehrwertsteuersatz f. Artikel |
| Percentage | Steuersatz |
| OrderPosCharge | Positionsrabatt |
| Percentage | Rabatt in Prozent |
| Datengruppe | Envelope | - | Übertragungsdaten |
SenderId - Absender
Mussfeld: ja
Format: Alphanumerisch mit max. 13 stelle(n)
Hinweis: GLN = Mailbox-ID des Absenders
RecipientId - Empfänger
Mussfeld: nein
Format: Alphanumerisch mit max. 13 stelle(n)
Hinweis: GLN von Spar = 9100000000015
TransmissionId - Übertragungsreferenz
Mussfeld: nein
Format: Alphanumerisch
Hinweis: Eindeutige Referenz der Übertragung, vergeben vom Sender. Wenn nicht übergeben, dann wird eine Referenz bezogen auf das aktuelle Datum und Uhrzeit gestellt
TestFlag - Testbetrieb
Mussfeld: nein
Mögliche Werte:
| 1 | = | Testbetrieb |
| Datengruppe | Order | - | Bestellkopf |
Enthält die Daten des Bestellkopfes
OrderID - Interne Bestellnnummer
Keyfeld
Format: Alphanumerisch
Number - Bestellnummer
Mussfeld: ja
Format: Alphanumerisch mit max. 16 stelle(n)
Date - Bestelldatum
Mussfeld: ja
Format: Datum
DeliveryDate - Gewünschtes Lieferdatum
Mussfeld: ja
Format: Datum
InvoiceDate - Gewünschtes Rechnungsdatum
Mussfeld: nein
Format: Datum
DeliveryGLN - Lieferanschrift
Mussfeld: nein
Format: Alphanumerisch mit max. 13 stelle(n)
Hinweis: GLN des Warenempfängers bzw. Lieferanschrift oder Hogast-Mitgliedsnummer
DeliveryName - Name der Lieferanschrift
Mussfeld: ja
Format: Alphanumerisch
DeliveryStreet - Straße der Lieferanschrift
Mussfeld: nein
Format: Alphanumerisch
DeliveryCity - Ort der Lieferanschrift
Mussfeld: ja
Format: Alphanumerisch
DeliveryZipCode - PLZ der Lieferanschrift
Mussfeld: ja
Format: Alphanumerisch
DeliveryContactTelephone - Telefonnummer der Lieferanschrift
Mussfeld: nein
Format: Alphanumerisch
DeliveryContactFax - Faxnummer der Lieferanschrift
Mussfeld: nein
Format: Alphanumerisch
DeliveryContactEmail - Email-Adresse der Lieferanschrift
Mussfeld: nein
Format: Alphanumerisch
DeliveryContactWeb - Homepage der Lieferanschrift
Mussfeld: nein
Format: Alphanumerisch
DeliveryFreeText - Freier Text
Mussfeld: nein
Format: Alphanumerisch
InvoiceReceiverGLN - Rechnungsempfänger
Mussfeld: nein
Format: Alphanumerisch mit max. 13 stelle(n)
Hinweis: GLN des Rechnungsempfängers
InvoiceReceiverName - Name des Rechnungsempfängers
Mussfeld: ja
Format: Alphanumerisch
InvoiceReceiverStreet - Straße des Rechnungsempfängers
Mussfeld: nein
Format: Alphanumerisch
InvoiceReceiverCity - Ort des Rechnungsempfängers
Mussfeld: ja
Format: Alphanumerisch
InvoiceReceiverZipCode - PLZ des Rechnungsempfängers
Mussfeld: ja
Format: Alphanumerisch
InvoiceReceiverContactTelephone - Telefonnummer des Rechnungsempfängers
Mussfeld: nein
Format: Alphanumerisch
InvoiceReceiverContactFax - Faxnummer des Rechnungsempfängers
Mussfeld: nein
Format: Alphanumerisch
InvoiceReceiverContactEmail - Email-Adresse des Rechnungsempfängers
Mussfeld: nein
Format: Alphanumerisch
InvoiceReceiverContactWeb - Homepage des Rechnungsempfängers
Mussfeld: nein
Format: Alphanumerisch
InvoiceReceiverFreeText - Freier Text
Mussfeld: nein
Format: Alphanumerisch
Currency - Währung
Mussfeld: ja
Format: Alphanumerisch mit max. 3 stelle(n)
Hinweis: ISO-Code der Rechnung (3 Buchstaben)
TotalPositionAmount - Gesamtpositionsbetrag
Mussfeld: nein
Format: Decimal
Hinweis: Summe der Netto-Positionsbeträge
TotalAmount - Rechnungsendbetrag
Mussfeld: nein
Format: Decimal
Hinweis: Bruttobetrag der Rechnung inkl. Ab-/Zuschlägen und Steuern
| Datengruppe | OrderCharge | - | Positionsrabatt |
Percentage - Gesamtrabatt in Prozent
Mussfeld: nein
Format: Decimal
| Datengruppe | OrderPos | - | Lieferscheinposition |
OrderID - Interne Bestellnummer
Keyfeld
Format: Alphanumerisch
OrderPosID - Eindeutige Positionsnummer
Keyfeld
Format: Alphanumerisch
Hinweis: Nummer zur eindeutigen Identifizieren der Bestellposition
Number - Positionsnummer
Mussfeld: nein
Format: Ganzzahl
ItemEANCustomer - EAN
Mussfeld: nein
Format: Alphanumerisch mit max. 14 stelle(n)
Hinweis: EAN des Artikels
ItemNumber - Artikelnummer des Lieferanten
Mussfeld: ja
Format: Alphanumerisch mit max. 14 stelle(n)
ItemName - Artikelbezeichnung
Mussfeld: nein
Format: Alphanumerisch mit max. 35 stelle(n)
Hinweis: Klarschriftbezeichnung für die Beschreibung von Artikeln, Produkten, Waren oder Dienstleistungen.
Quantity - Menge
Mussfeld: ja
Format: Decimal
Unit - Einheit
Mussfeld: ja
Format: Alphanumerisch
QuantityPriceBasis - Verkaufsmenge
Mussfeld: nein
Format: Decimal
UnitPriceBasis - Verkaufseinheit
Mussfeld: nein
Format: Alphanumerisch
QuantityDelivery - Liefermenge
Mussfeld: nein
Format: Decimal
UnitDelivery - Liefereinheit
Mussfeld: nein
Format: Alphanumerisch
NettPrice - Nettopreis
Mussfeld: ja
Format: Decimal
Hinweis: Preis (inkl. ev. Rabatte, ohne Steuer)
GrossPrice - Bruttopreis
Mussfeld: ja
Format: Decimal
Hinweis: Preis (ohne ev. Rabatte, ohne Steuer)
FreeText - Freier Text
Mussfeld: nein
Format: Alphanumerisch
| Datengruppe | OrderPosTax | - | Mehrwertsteuersatz f. Artikel |
Percentage - Steuersatz
Mussfeld: ja
Format: Decimal
Hinweis: Steuersatz in Prozent
| Datengruppe | OrderPosCharge | - | Positionsrabatt |
Percentage - Rabatt in Prozent
Mussfeld: nein
Format: Decimal
Rechtserklärung
Alle Informationen in diesem Dokument werden ohne Abgabe von Garantien, welcher Art auch immer, zur Verfügung gestellt. MicroTown Software 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 MicroTown Software, oder ihre 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 MicroTown Software oder ihre Lieferanten auf die Möglichkeit derartiger Schäden hingewiesen haben. In jedem Fall werden Haftungsansprüche bis zum gesetzlich höchstmöglichen Ausmass abgelehnt.
© 2005 MicroTown Software - TransdatiX Homepage