Date: Thu, 28 Mar 2024 10:04:58 +0100 (CET) Message-ID: <264214906.929.1711616698216@ac13a6ea341c> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_928_20623504.1711616698216" ------=_Part_928_20623504.1711616698216 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
Inhalt:
In diesem Dokument ist die Magento Schnittstelle n=C3=A4her beschrieben.= Bei Fragen k=C3=B6nnen sie sich gerne an unseren Support wenden. Die Konta= ktdetails sind auf der Seite Logistikschnittstellen zu entnehmen.
Nachdem die Konfiguration der Anbindung gekl=C3=A4rt ist, werden wir die= se auf Wunsch f=C3=BCr sie einrichten. Sie k=C3=B6nnen dann Bestellungen in= das Logistiksystem =C3=BCbergeben und erhalten Lagerbest=C3=A4nde sowie Ve= rsandinformationen aus dem Logistiksystem.
Die Module Auftrags=C3=BCbernahme, Statusr=C3=BCckgabe inkl. Track&T= race sowie die Lagerbestandspflege sind implementiert.
Magento ab Version 2.1 wird unterst=C3=BCtzt. Die Schnittstelle ist zule= tzt mit der Version 2.4 validiert worden.
Die Anbindung ist =C3=BCber die Magento REST API Version 1 realisi= ert.
Wir ben=C3=B6tigen die gew=C3=BCnschten Einstellungen wie die Schnittste= lle auf unserer Seite zu konfigurieren ist. Hierf=C3=BCr bitten wir um die = Beantwortung der nachfolgenden Fragen unter dem Punkt "Konfigurationsoptionen der Schnittstelle".
Option | M=C3=B6gliche Werte | Standardwert | Bemerkung |
---|---|---|---|
Auftr=C3=A4ge =C3=BCbertragen | ja/nein | ja | Aktiviert die =C3=9Cbernahme von Auftr=C3=A4gen.= |
Status & Sendungsdaten =C3=BCbertragen | ja/nein | ja | Aktiviert die R=C3=BCckgabe von Status- un= d Sendungsdaten. |
Lagerbest=C3=A4nde =C3=BCbertragen | ja/nein | ja | Aktiviert die =C3=9Cbernahme von Lagerbest= =C3=A4nden. |
Option | M=C3=B6gliche Werte | Standardwert | Bemerkung |
---|---|---|---|
Magento URL | URL | Die Adresse ihres Magento Shops im Format = http://mein-magentoshop.com oder falls ein g=C3=BCltiges Zertifikat ins= talliert wurde alternativ auch mit https://mein-magentoshop.com.= | |
Consumer Key (Konsumentenschl=C3=BCssel) | Key | Ihr Consumer Key f=C3=BCr den API Zugriff. | |
Consumer Secret (Konsumentengeheimnis) | Secret | Ihr Consumer Secret f=C3=BCr den API Zugriff. | |
Access Token (Zugriffstoken) | Token | Ihr Access Token f=C3=BCr den API Zugriff. | |
Access Token Secret (Zugriffstoken-Geheimnis) | Token Secret | Ihr Access Token Secret f=C3=BCr den API Zugriff= . | |
Wartezeit | 0-65535 | 120 | Wartezeit in Sekunden f=C3=BCr eine Serveroperat= ion. Ist die Serveroperation innerhalb der Zeit nicht abgeschlossen, wird e= in Fehler ausgel=C3=B6st. Standard sind 2 Minuten (120 Sekunden). |
Schreib-/Lesewartezeit | 0-65535 | 300 | Wartezeit in Sekunden f=C3=BCr das Schreiben ode= r Lesen von Daten. Wird das Schreiben oder Lesen eines Datenstrom l=C3=A4ng= er als die Wartezeit unterbrochen, l=C3=B6st das einen Fehler aus. Standard= sind 5 Minuten (300 Sekunden). |
Die Steuerung erfolgt komfortabel durch das Statussystem f=C3=BCr Bestel= lungen in Magento. Die Status Codes k=C3=B6nnen in der Schnittstelle frei k= onfiguriert werden. Somit sind auch benutzerdefinierte Statuscodes realisie= rbar.
Status | Status Code | Bemerkung |
---|---|---|
Freigabe f=C3=BCr Versand | pending | Der Auftrag wird =C3=BCbertragen, wenn dieser St= atus gesetzt ist. |
Gerade im Versand | processing | Die erfolgreiche =C3=9Cbertragung des Auftrags wird durch setzen dieses Status quittiert. Die Schnitt= stelle erstellt zus=C3=A4tzlich noch einen internen Kommentar mit weiteren = Verarbeitungsinformationen. |
Versendet | complete | Die erfolgreiche R=C3=BCckmeldung von S= endungsdaten und des Verladezeitpunkts wird durch setzen dieses Status geke= nnzeichnet. Die Schnittstelle erstellt zus=C3=A4tzlich n= och einen internen Kommentar mit weiteren Verarbeitungsinformationen. |
Magento kennt verschiedene Arten von Artikeln. Da =C3=BCber die Sperre i= n der Regel die Bundles selbst oder auch andere nicht logistisch relevante = Artikel ausgeklammert werden sollen (z. B. virtuelle Artikel) wurde das =C3= =BCber die Artikeltypen gel=C3=B6st.
Option | Typ | Standardwert | M=C3=B6gliche Werte | Bemerkung |
---|---|---|---|---|
Einfacher Artikel | simple | nein | ja/nein | Ist diese Option aktiviert wird ein Artikel mit = dieser Artikelart nicht durch die Schnittstelle =C3=BCbernommen. |
Gruppen Artikel | grouped | ja | ja/nein | |
Konfigurierbarer Artikel | configurable | nein | ja/nein | |
Virtueller Artikel | virtual | ja | ja/nein | |
B=C3=BCndelartikel | bundle | ja | ja/nein | |
Downloadartikel | downloadable | ja | ja/nein |
In der Schnittstellenkonfiguration kann optional eine Versandanweisung k= onfiguriert werden.
Nur falls mehr als eine Versandart verwendet wird, sind angaben erforder= lich. Standardm=C3=A4=C3=9Fig wird immer als versichertes Paket versendet.<= /p>
Die Versandinformation wird aus dem Feld "shipping_description" in der B= estellung entnommen. Die Werte m=C3=BCssen f=C3=BCr ein korrektes Matching = exakt diesem =C3=9Cbergebenen wert entsprechen.
Option | M=C3=B6gliche Werte | Bemerkung |
---|---|---|
Abholung ab Lager | <Code der Versandart> | Die gew=C3=A4hlte Versandmethode f=C3=BChrt zu e= iner Bereitstellung der Waren zur Abholung ab Lager beim Dienstleister. Bit= te geben sie pro Zeile die Bezeichnung der Versandart an, auf die diese Reg= el zutrifft. |
Versicherter Versand | <Code der Versandart> | Die gew=C3=A4hlte Versandmethode f=C3=BChrt zu e= inem versicherten Versand beim Dienstleister. Bitte geben sie pro Zeile die= Bezeichnung der Versandart an, auf die diese Regel zutrifft. |
Unversicherter Versand | <Code der Versandart> | Die gew=C3=A4hlte Versandmethode f=C3=BChrt zu e= inem unversicherten Versand beim Dienstleister. Bitte geben sie pro Zeile d= ie Bezeichnung der Versandart an, auf die diese Regel zutrifft. |
Speditionsversand | <Code der Versandart> | Die gew=C3=A4hlte Versandmethode f=C3=BChrt zu e= inem versicherten Versand per Spedition beim Dienstleister. Bitte geben sie= pro Zeile die Bezeichnung der Versandart an, auf die diese Regel zutrifft.= |
Interner Warenverkehr | <Code der Versandart> | Die gew=C3=A4hlte Versandmethode f=C3=BChrt zu e= inem internen Warenverkehr im Lager des Dienstleisters. Bitte geben sie pro= Zeile die Bezeichnung der Versandart an, auf die diese Regel zutrifft. |
Option | M=C3=B6gliche Werte | Bemerkung |
---|---|---|
Zahlart f=C3=BCr Nachname | <Bezeichnung> | Bezeichnung der Zahlart die zu einer =C3=9Cbe= rgabe des Nachnamebetrags zum Gesch=C3=A4ftspartner f=C3=BChrt. Der o= ffene Bruttogesamtbetrag der Bestellung wird als Einzugsbetrag f=C3=BCr die= Nachname =C3=BCbergeben. Bitte geben sie pro Zeile die Bezeichnung der Zah= lart an, auf die diese Regel zutrifft. |
Die Zahlart wird aus dem Feld "additional_i= nformation" in dem Objekt "payment" in der Bestellung entnommen. Die Werte = m=C3=BCssen f=C3=BCr ein korrektes Matching exakt diesem =C3=9Cbergebenen w= ert entsprechen. Der Betrag wird aus dem Feld "total_due" der Bestellung en= tnommen.
Die Best=C3=A4nde aus dem Warenlager werden nach Magento =C3=BCbertragen= . Der Bestand wird periodisch (Intervall einstellbar) im Artikel hinterlegt= . Hat der Artikel keinen Bestand mehr wird das Merkmal "Lagerbestand" von "= auf Lager" in "nicht auf Lager" ge=C3=A4ndert. Ist wieder ein Bestand vorha= nden wird das Merkmal wieder umgestellt. Das vorgenannte Verhalten kann dur= ch diese Einstellungen beeinflusst werden.
Option | M=C3=B6gliche Werte | Bemerkung |
---|---|---|
Lagerort | g=C3=BCltiges Lager in Magento | Dieser gew=C3=A4hlte Lagerort wird f=C3=BCr Lage= rbestandsupdates genutzt. Nachdem die Shop URL und die Zugangsdaten hinterl= egt sind, kann hier aus den in Magento eingerichteten Lagerorten ein Lager = ausgew=C3=A4hlt werden, das per Schnittstelle gepflegt wird. |
Nachfolgend haben wir ihnen zum besseren Verst=C3=A4ndnis, das Verhalten= der Schnittstelle n=C3=A4her erl=C3=A4utert.
Befindet sich der Auftrag im Status "Freigabe f=C3=BCr Versand" wird die= ser von der Schnittstelle =C3=BCbernommen. Nach der erfolgreichen =C3=9Cber= nahme wird der Status "Gerade im Versand" gesetzt.
Ein bereits =C3=BCbernommener Auftrag wird erneut =C3=BCbertragen, wenn = im Shop der Status "Freigabe f=C3=BCr Versand" wiederholt gesetzt wird= .
Es wird versucht die =C3=9Cbertragung zu wiederholen, bis diese erfolgre= ich verl=C3=A4uft.
Bei der R=C3=BCckmeldung wird der genutzte Versanddienstleister gesetzt.= Hierf=C3=BCr m=C3=BCssen diese in Magento entsprechend konfiguriert werden= . Eine entsprechende Codeliste ist nachstehend beigef=C3=BCgt.
Au=C3=9Ferdem werden die in den Packst=C3=BCcken enthaltenen Artikel mit= der Versandmenge zur=C3=BCckgemeldet. Liegen keine Packst=C3=BCckinhaltsin= formationen vor, wird immer der gesamte Auftrag (alle Positionen mit der be= stellten Menge) zur=C3=BCckgemeldet.
Ist der Frachtf=C3=BChrer in Magento nicht bekannt / angelegt kann die S= endungsinformation nicht zur=C3=BCckgemeldet werden und die Bestellung wird= nicht erfolgreich abgeschlossen.
Code (carrier_code) | Frachtf=C3=BChrer |
---|---|
dhl | DHL (DE) |
deutsche_post | DEUTSCHE POST |
spedition | SPEDITION |
abholung | ABHOLUNG |
intern | INTERN |
2_mann_handling | 2-MANN-HANDLING |
ups | UPS |
dpd | DPD |
amz | Versand mit Amazon |
post_austria | POST AUSTRIA |