Kurzantwort
Abgerufene Webshop-Bestellungen über PHP-Schnittstellen werden von orgaMAX als XML-Dateien im Ordner Webshop\ImportFiles gespeichert. Die XML-Dateien enthalten unter anderem Kunden-, Bestell-, Zahlungs-, Versand- und Artikeldaten und können als Grundlage für eigene Auswertungen oder individuelle Schnittstellen verwendet werden.
Dieser Artikel richtet sich an Entwickler und technisch versierte Anwender, die die XML-Dateien für eigene Integrationen oder Analysen nutzen möchten.
Schritt-für-Schritt-Anleitung
Schritt 1: XML-Dateien finden
Nach dem Abruf einer Webshop-Bestellung speichert orgaMAX die XML-Datei automatisch im Datenverzeichnis.
Standardmäßig findest Du die Dateien unter:
C:\ProgramData\Deltra\orgaMAX\Webshop\ImportFiles
In diesem Ordner werden alle über den jeweiligen Rechner importierten Webshop-Bestellungen als XML-Dateien abgelegt.
Schritt 2: Kundendaten und Bestellinformationen prüfen
Jede XML-Datei enthält die wichtigsten Informationen zur Bestellung.
Dazu gehören beispielsweise:
- Kundendaten
- Lieferadresse
- Zahlungsart
- Lieferart
- Bestellinformationen
Diese Daten verwendet orgaMAX, um den Vorgang beim Import automatisch anzulegen und mit den passenden Stammdaten zu verknüpfen.
Schritt 3: Liefer- und Zahlungsbedingungen zuordnen
Damit orgaMAX die Liefer- und Zahlungsbedingungen automatisch übernimmt, müssen die Bezeichnungen in der XML-Datei mit den Einträgen in Deinen Stammdaten übereinstimmen.
Prüfe dazu die Einstellungen unter:
Stammdaten > Kleinstammdaten > Lieferbedingungen
und
Stammdaten > Kleinstammdaten > Zahlungsbedingungen
Die Bezeichnungen müssen exakt mit den Werten übereinstimmen, die vom Webshop übergeben werden. Nur dann erfolgt die automatische Zuordnung.
Schritt 4: Artikeldaten auswerten
Neben den Bestellinformationen enthält die XML-Datei auch alle Positionen der Bestellung.
Dazu gehören unter anderem:
- Artikelnummer
- Artikelbezeichnung
- Menge
- Einzelpreis
- Mehrwertsteuersatz
- Versandkosten
Diese Informationen werden von orgaMAX beim Import verwendet, um die Bestellung vollständig anzulegen.
Beispiel:
In den folgenden Zeilen siehst Du die vom Webshop übertragenen Versandkosten und Artikeldaten mit Artikelnummer, Preis, Menge, MwSt.:
Die Versandkosten wurden mit 6,70 € übergeben.
Zusätzlich wurde der Artikel „ABC123“ mit einer Menge von 3 Stück, einem Preis von 15,00 € und dem Mehrwertsteuersatz von 19% übergeben.
Zusätzlich wurde ein Artikel „ZDM4556-4“ mit einer Menge von 2 Stück, einem Preis von 26,00 € und dem Mehrwertsteuersatz 19% übergeben.
Beispiel-XML-Datei: Demobestellung für Webshop
Eine ausführliche Beschreibung der PHP-Schnittstelle findest Du in unserem Downloadbereich unter "Webshop-Anbindung".
Häufige Fragen
Wo speichert orgaMAX die XML-Dateien?
Standardmäßig im Ordner:
C:\ProgramData\Deltra\orgaMAX\Webshop\ImportFiles
Dort werden alle über den jeweiligen Rechner importierten Webshop-Bestellungen gespeichert.
Welche Informationen enthält die XML-Datei?
Die XML-Datei enthält unter anderem Kunden-, Liefer-, Zahlungs- und Artikeldaten sowie Versandkosten und weitere Informationen zur Bestellung.
Warum werden Liefer- oder Zahlungsbedingungen nicht automatisch übernommen?
Die Werte in der XML-Datei müssen exakt mit den Einträgen unter Stammdaten > Kleinstammdaten > Lieferbedingungen beziehungsweise Zahlungsbedingungen übereinstimmen. Stimmen die Bezeichnungen nicht überein, kann orgaMAX keine automatische Zuordnung vornehmen.
Kann ich die XML-Dateien für eigene Entwicklungen verwenden?
Ja. Die XML-Dateien eignen sich als Grundlage für eigene Schnittstellen, Auswertungen oder Automatisierungen. Kenntnisse über die XML-Struktur und die Verarbeitung der Daten werden dabei vorausgesetzt.