Standard API
ERP System Integration für Händler mit allen Stammdaten und Transaktionen.
Diese Dokumentation beschreibt eine mögliche Schnittstelle zwischen ordermanager und Lieferant bzw. Händler.
Es wird dabei unterschieden zwischen Basis- und Stammdaten wie z.B. Produktdaten und Transaktionsdaten wie z.B. Bestellungen.
Da die Schnittstellen des ordermanager ständig erweitert werden, muss immer die implementierte Version der Schnittstellen-Spezifikation beachtet werden. Diese Versionsnr. wird im Kopf jeder Schnittstellen-Nachricht übermittelt. Im ordermanager kann die zu verwendende Version der Schnittstellen-Spezifikation eingestellt werden. Hierdurch können auch Systeme unterstützt werden, die nicht die aktuelle Schnittstelle implementieren.
Technische Daten
Folgende Formate werden unterstützt:
Beispiele finden sich hier.
Unabhängig vom Format enthält jede Nachricht/Datei einen vordefinierten Kopf.
Nachrichten - Nachrichtenkopf
Erlaubte Datentypen und Feldformate finden Sie hier.
Basisdaten
Die Übertragung von Basisdaten und Produktdaten kann nur verwendet werden, wenn der ordermanager mit allen Produktdaten aus der Warenwirtschaft gefüllt wird. Kommt zur Datenpflege der productmanager zum Einsatz, so können diese Daten nicht an den ordermanager übermittelt werden.
Der Lagerbestand, die Neukunden sowie Lieferadressen können immer mit dem ordermanager ausgetauscht werden.
Um die Produkt- und Artikeldaten in ordermanager auf dem aktuellen Stand zu halten, überträgt eine Warenwirtschaft Artikeldaten in drei verschiedenen Typen von Nachrichten. Bevor die Produktdaten ausgetauscht werden, sollten zuvor die Daten zu Warengruppen und Herstellern/Lieferanten übertragen werden (nur wenn Daten vorhanden).
Folgende Nachrichtentypen werden unterstützt:
| Typ | Beschreibung | Richtung |
|---|---|---|
| CustomerCreate | Anlage eines neuen Kunden. | ERP -> OM |
| DeliveryAddressUpdate | Anlage oder Aktualisierung einer Lieferadresse | OM -> ERP |
| ManufacturerUpdate | Anlage oder Aktualisierung von Herstellern | ERP -> OM |
| ProductGroupUpdate | Anlage oder Aktualisierung von Kategorien | ERP -> OM |
| ProductUpdate | Anlage oder Aktualisierung von Artikeln | ERP -> OM |
| ProductCustomerUpdate | Anlage oder Aktualisierung von Preisen | ERP -> OM |
| ProductStockUpdate | Aktualisierung von Lagerbeständen | ERP -> OM |
| DocumentUpdate | Anlage und Aktualisieren von Dokumenten zu Artikeln | ERP -> OM |
Transaktionen
Über Transaktionsnachrichten wird der komplette Bestellprozess zwischen Warenwirtschaft und ordermanager abgewickelt.
Die wichtigsten Nachrichtentypen finden Sie hier:
| Typ | Beschreibung | Richtung |
|---|---|---|
| PurchaseOrderSubmit | Neue Bestellung | OM -> ERP |
| PurchaseOrderAck | Technische Empfangsbestätigung | ERP -> OM |
| PurchaseOrderAccept | Auftragsbestätigung | ERP -> OM |
| PurchaseOrderDecline | Auftragsstornierung | ERP -> OM |
| DeliveryNotice | Lieferschein | ERP -> OM |
| Invoice | Rechnung | ERP -> OM |
| CreditNotice | Gutschrift | ERP -> OM |
| PurchaseOrderCreate | Neue Bestellung im OM anlegen | ERP -> OM |
Übertragung
Die Übertragung erfolgt entweder über den HttpConnector
Alternnativ kann direkt mit dem ordermanager über https kommuniziert werden.