Inhalt:
Allgemeines
In diesem Dokument ist die Shopware 5 Schnittstelle näher beschrieben. Bei Fragen können sie sich gerne an unseren Support wenden. Die Kontaktdetails sind auf der Seite Logistikschnittstellen zu entnehmen.
Nachfolgend erhalten sie wichtige Informationen zur Shopware Schnittstelle. Nachdem die Konfiguration der Anbindung geklärt ist, werden wir diese auf Wunsch für sie einrichten. Sie können dann Bestellungen in das Logistiksystem übergeben und erhalten Lagerbestände und Versandinformationen aus dem Logistiksystem.
Leistungsumfang
Implementierte Funktionen
Die Module Auftragsübernahme, Statusrückgabe inkl. Track&Trace sowie die Lagerbestandspflege sind implementiert.
Unterstützte Versionen
Shopware ab Version 5.0.0 wird unterstützt.
Technische Anbindung
Die Shopware-Anbindung ist über die Shopware API realisiert.
Voraussetzungen
Zur Anbindung benötigen wir die Shop URL, den Benutzernamen und den zugehörigen API-Key.
Außerdem benötigen wir eine Vorgabe wie die Schnittstelle auf unserer Seite zu konfigurieren ist. Hierfür bitten wir um die Beantwortung der nachfolgenden Fragen unter dem Punkt "Konfigurationsoptionen der Schnittstelle".
Optionale PDF Belegübergabe
Optional können die zum Auftrag existierenden Belege übernommen werden. Beigefügt erhalten sie zwei Plugins für ihr Shopware Setup. Diese sind nur erforderlich, wenn zugehörige PDF Dokumente übergeben werden sollen. Ist nicht geplant PDF Dokumente mitzugeben, bedarf es keiner Installation der Plugins. Die Plugins können kostenfrei aus dem Shopware Store bezogen werden.
Funktion der Plugins (Kompatibel zu Shopware 5):
Erweiterung der API um das PDF-Dokument.
Bezugsquelle: http://store.shopware.com/bauer15235570746/bestelldokumente-api.html
Automatisches erstellen der PDF Dokumente mit Cronjob, nach Bestellabschluss.
Bezugsquelle: http://store.shopware.com/bauer96565885332/automatische-dokumenterstellung-rechnung-oder/und-lieferschein.html
Konfigurationsoptionen der Schnittstelle
Übertragungseinstellungen
| Option | Mögliche Werte | Bemerkung |
|---|---|---|
| Aufträge übertragen | ja/nein | Aktiviert die Übernahme von Aufträgen. |
| Status & Sendungsdaten übertragen | ja/nein | Aktiviert die Rückgabe von Status- und Sendungsdaten. |
| Lagerbestände übertragen | ja/nein | Aktiviert die Übernahme von Lagerbeständen. |
Dokumente
| Option | Mögliche Werte | Bemerkung |
|---|---|---|
| Auf PDF Dokumente warten und Auftrag erst dann übernehmen | ja/nein | |
| Lieferschein übertragen | ja/nein | Ist die Option "Auf PDF Dokumente warten und Auftrag erst dann übernehmen" mit "nein" belegt, hat diese Option keine Funktion. |
| Rechnung übertragen | ja/nein | Ist die Option "Auf PDF Dokumente warten und Auftrag erst dann übernehmen" mit "nein" belegt, hat diese Option keine Funktion. |
Artikel
| Option | Mögliche Werte | Bemerkung |
|---|---|---|
| Ausgeschlossene Artikelnummern | <Artikelnummern> | |
| Artikelnummer == SKU | ja/nein | |
| Attributfeld für SKU, fall nicht Artikelnummer | 0 - 20 | Ist die Option "Artikelnummer == SKU" mit "ja" belegt, hat diese Option keine Funktion. |
Lagerbestand
| Option | Mögliche Werte | Bemerkung |
|---|---|---|
| Reservieren der Artikel | ja/nein | Falls ja, dann ist der frei verfügbare Lagerbestand - Menge in offenen Bestellungen des Shops = Lagerbestand im Shop |
| Lagerbestand in Shop übertragen | ja/nein |
Tracking
| Option | Mögliche Werte | Bemerkung |
|---|---|---|
| Trackingdaten in Shop übertragen | ja/nein |
Status
| Option | Mögliche Werte | Bemerkung |
|---|---|---|
| Freigabe zum Versand | Auftragsstatus: offen Zahlstatus: "komplett bezahlt" ODER "komplett in Rechnung gestellt" | Die vorstehenden Angaben sind die Standardwerte der Schnittstelle, bitte anpassen falls abweichend. Es sind alle in Shopware zuläsigen Statuswerte, die in der Standardinstallation verfügbar sind (Shopware Core). |
| Bestellung ist übertragen | Auftragsstatus: "zur Lieferung bereit" | Die vorstehenden Angaben sind die Standardwerte der Schnittstelle, bitte anpassen falls abweichend. Der Zahlstatus wird nicht mehr ausgewertet oder verändert. |
| Bestellung ist abgeschlossen | Auftragsstatus: "komplett ausgeliefert" | Die vorstehenden Angaben sind die Standardwerte der Schnittstelle, bitte anpassen falls abweichend. Der Zahlstatus wird nicht mehr ausgewertet oder verändert. |
| Fehler in der Bestellung | Auftragsstatus: "klärung notwendig" | Details hierzu stehen, bei einem Fehler, im internen Kommentar der Bestellung. Die vorstehenden Angaben sind die Standardwerte der Schnittstelle, bitte anpassen falls abweichend. Der Zahlstatus wird nicht mehr ausgewertet oder verändert. |
Versand
Nur falls mehr als eine Versandart verwendet wird, sind angaben erforderlich. Standardmäßig wird immer als versichertes Paket versendet.
| Option | Mögliche Werte | Bemerkung |
|---|---|---|
| Abholung ab Lager | <Name der Versandart(en)> | |
| Versicherter Versand | <Name der Versandart(en)> | Dies ist die Standardversandart. |
| Unversicherter Versand | <Name der Versandart(en)> | |
| Speditionsversand | <Name der Versandart(en)> |
Zahlung
| Option | Mögliche Werte | Bemerkung |
|---|---|---|
| Zahlarten ID für Nachname | <ID der Zahlart im Shop> | Standardwert ist "3" (Shopware Standard). Bei dieser Zahlart wird der Bruttogesamtbetrag der Bestellung als Einzugsbetrag übergeben. |
Verhalten der Schnittstelle
Nachfolgend haben wir ihnen zum besseren Verständnis, das Verhalten der Schnittstelle näher erläutert.
Übergabe von Aufträgen
Befindet sich der Auftrag im Status "Freigabe zum Versand" wird dieser von der Schnittstelle übernommen. Nach der erfolgreichen Übernahme wird der Status "Bestellung ist übertragen" gesetzt.
Ein bereits übernommener Auftrag wird erneut übertragen, wenn im Shop der Status "Freigabe zum Versand" wiederholt gesetzt wird.
Aktivierte PDF Übernahme zum Auftrag, ohne obligatorisch erforderliche Plugineinrichtung im Shop
In diesem Fall, wird der Auftrag nicht übernommen.
FAQ
Welche Rechte sind im Shop für den API Benutzer zu hinterlegen?
| API-Endpunkt | Rechte | |||||
|---|---|---|---|---|---|---|
| URL | Ressource | erstellen | lesen | aktualisieren | löschen | Bemerkungen |
/api/articles | articles | - | X | - | - | X = erteilt / - = nicht erforderlich |
/api/caches | caches | - | - | - | - | |
/api/categories | categories | - | X | - | - | |
/api/customerGroups | CustomerGroup | - | X | - | - | |
/api/customers | customer | - | X | - | - | |
/api/generateArticleImages | article | - | - | - | - | |
/api/media | media | - | - | - | - | |
/api/orders | order | - | X | X | - | |
/api/propertyGroups | PropertyGroup | - | X | - | - | |
/api/shops | shop | - | X | - | - | |
/api/translations | translations | - | - | - | - | |
/api/variants | variants | - | X | - | - | |
/api/version | version | - | X | - | - | |
/api/documents | order/documents | - | X | - | - | Dokumentenabruf (Plugin) |