In diesem How-To-Kapitel erklären wir Ihnen Schritt für Schritt, wie Sie die einheitliche Versandschnittstelle shipcloud mit dem myfactory-System verzahnen können. Hierzu zeigen wir Ihnen, wie Sie die grundlegende Konfiguration für die shipcloud-Anbindung mithilfe eines API-Schlüssels vornehmen, die benötigten Versandtemplates einrichten und die Versandarten korrekt mit dem Verpackungsdialog der Belegerfassung verknüpfen.

So konfigurieren Sie die myfactory für die Anbindung der shipcloud-Schnittstelle
So legen Sie shipcloud-Versandtemplates an
So verknüpfen Sie die myfactory-Versandarten mit den shipcloud-Services
So erzeugen Sie shipcloud-Paketscheine



Zum Anfang


Zum Anfang


Im nächsten Schritt ordnen Sie die soeben erstellte Versandvorlage einer passenden Versandart zu und hinterlegen als Versandschnittstelle entsprechend "shipcloud". Damit stellen Sie vor allem sicher, dass Sie im weiteren Verlauf die in die myfactory eingelesenen shipcloud Services-Grunddaten für das Erzeugen von shipcloud-Paketscheinen nutzen können. Außerdem hat dies den Vorteil, dass Sie diese beiden grundlegenden Informationen nur einmal pro Versandart hinterlegen, und nicht für jedes Paket einzeln im Verpackungsdialog eingeben müssen (siehe auch das folgende Unterkapitel).



Anders als bei der DPD-Versandschnittstelle lassen sich Paketscheine mit der shipcloud API nur aus dem Verpackungsdialog in der Verkaufsbelegerfassung (oder Schnellerfassung) heraus erstellen.Verpackungsmaße (Länge x Breite x Höhe) und Verpackungsinformationen (z.B. zum Verpackungstyp) werden zwingend benötigt. Alternativ können Sie die shipcloud-Paketscheine auch über die Versandschnittstelle im Dialog "Datenübertragung" erzeugen und hierüber direkt an shipcloud übermitteln.

Für beide Generierungsarten gilt im Übrigen, dass stets eine mit der shipcloud-API verknüpfte Versandart in den Belegdetails eines Versandauftrags bzw. Lieferscheins hinterlegt sein muss (d.h. im Versandartenstamm ist als Versandschnittstelle für die jeweils gewünschte Versandart zwingend "shipcloud" auszuwählen). Andernfalls kann kein Paketschein über die Schnittstelle übertragen werden.


Zum Anfang


shipcloud-Paketscheine lassen sich sowohl über die Verkaufsbelegerfassung als auch über die Verkaufsschnellerfassung erstellen. In beiden Erfassungsdialogen klicken Sie zu diesem Zweck die [ Beleg ]-Schaltfläche an und wechseln im sich öffnenden Menü zum Menüpunkt "Verpackungsdialog".


Daraufhin wird der Beleg-Einzelverpackungsdialog geöffnet. Nach dem Auswählen Ihres gewünschten Verpackungstyps legen Sie Ihr Augenmerk bitte zunächst auf den rechten oberen Dialogabschnitt mit der Überschrift "Verpackung Details".


Haben Sie im Belegkopf (den Belegdetails) noch keine mit shipcloud verknüpfte Versandart hinterlegt, so tragen Sie diese bitte noch in das Eingabefeld "Versandart der Verpackung" ein, um die restlichen Verpackungsdetails freizuschalten. Vergessen Sie nach Beendigung des Verpackungsdialogs jedoch nicht, die Versandart in den Belegdetails nachzutragen. Andernfalls wird der erzeugte Paketschein nicht über die shipcloud-Schnittstelle übertragen.

Sofern Sie vor Bearbeitung des Verpackungsdialogs bereits eine Versandart im Belegkopf hinterlegt haben, so ist die Versandart der Verpackung in den Verpackungsdetails bereits vorbelegt und die übrigen Verpackungsdetails schon zur weiteren Bearbeitung freigeschaltet.


Nach dem Eintragen der Verpackungsversandart können Sie sich über die Schaltfläche [ Preisvorschlag (netto) ] noch einen "Kostenvoranschlag" für Ihr zu versendendes Paket einholen.

Damit werden die bei der Versandart hinterlegte Versandvorlage, das Gewicht sowie die allgemeinen Verpackungsdaten zur Berechnung der geschätzten Nettokosten an shipcloud übergeben. Der voraussichtliche Preis wird anschließend automatisch in das nebenstehende Feld geschrieben. Bitte beachten Sie, dass hierbei noch kein Paketschein erstellt wird. Die dem verwendeten Verpackungstyp zugeordneten Verpackungsmaße (Länge x Höhe x Breite) sollten ferner in ganzen cm angegeben werden.


Im Anschluss haben Sie im unteren Dialogbereich die Möglichkeit, eine oder mehrerer Ihrer Belegpositionen Ihrem oben gewählten Verpackungstypen zuzuordnen. Dem in dem Feld "Gesamtgewicht in kg" vorbelegten Gewicht des jeweiligen Verpackungstypen wird in den Verpackungsdetails automatisch das Gesamtgewicht der unten selektierten Artikelpositionen hinzuaddiert und eingetragen.


Nun haben Sie alle nötigen Einstellungen getroffen, um mit dem Erstellen des Paketscheins fortzufahren. Anders als bei der DPD-Schnittstelle ist es aktuell nicht möglich, einen oder mehrere Paketscheine für den gesamten Beleg zu erzeugen. Vielmehr lassen sich derzeit ausschließlich Paketscheine für einzelne Verpackungen generieren. Betätigen Sie daher bitte die entsprechende Schaltfläche zum Erstellen eines Verpackungspaketscheins.


Ist dies geschehen, so wird automatisch das Feld "Paketversandnummer" mit der Trackingnummer für die Sendungsverfolgung eingetragen. Zudem wird das Versanddatum mit Uhrzeit in das entsprechende Feld der Verpackungsdetails geschrieben.


Anschließend können Sie den Verpackungsdialog mit der [ Schließen ]-Schaltfläche verlassen und den erzeugten Paketschein im Bereich der Belegdokumente einsehen, herunterladen und bei einem dem Versandtemplate zugeordneten Druckernamen entsprechend auch ausdrucken.



Auch in der shipcloud-Oberfläche können Sie erkennen, dass z.B. im Bereich des Dashboards ein Versandlabel (also ein Paketschein) übertragen wurde. Alternativ ist dies auch im Menüpunkt "Sendungen" nachverfolgbar.


Öffnen Sie den Detailbereich eines übermittelten Paketscheins, so sehen Sie dort alle Einzelheiten zu dem zugehörigen Versandprozess, unter anderem auch die Trackingnummer.


Im Dialog "Datenübertragung" (unter "Verkauf / Kommissionierung / Versandschnittstelle / Datenübertragung") können Sie unter "Versanddienstleister" nun auf die "shipcloud API" filtern und anhand der neben der Spalte "Trackingnummer" befindlichen "Trackingstatus"-Spalte per Webhook ausgelöste Tracking-Ereignisse nachvollziehen (mehr dazu im folgenden Unterkapitel).

Zum Anfang


Wenn die Paketdaten im Beleg hinterlegt sind, dann können Sie die Paketscheine auch direkt über den Dialog "Datenübertragung" der Versandschnittstelle an shipcloud übertragen.

Zu den im Lieferschein zu hinterlegenden Paketdaten zählen insbesondere die shipcloud-kompatible Versandart im Belegkopf sowie der im Verpackungsdialog gewählte Verpackungstyp. Haben Sie Letzteren im Verpackungsdialog ausgewählt und zugeordnet, so klicken Sie anstelle der Schaltfläche [ Verpackungspaketschein ] einfach auf [ Schließen ].

Nun sehen Sie im Dialog "Datenübertragung" im Bereich "Versandschnittstelle" sämtlich erstellte Paketscheine. Über die Auswahlbox "Anzeige" können Sie sich aus Gründen der Übersichtlichkeit nur die "Nicht übergebenen" Paketscheine anzeigen lassen.

Die einer Versandart und einem Verpackungstyp zugeordneten Paketscheine sind dann zur Übermittlung an shipcloud bereit. Für den Schnittstellentransfer haken Sie bitte die die Checkbox in der Splte "Übergeben" an und klicken anschließend auf die [ Übertragen ]-Schaltfläche in der rechten unteren Button-Leiste.


Nach Betätigen dieser Schaltfläche gelangen Sie automatisch in den Dialog "Versandprotokoll", den Sie auch jederzeit manuell über den Menüpfad "Verkauf / Kommissionierung / Versandschnittstelle / Verdsandprotokoll" erreichen können.

Hier können Sie sämtliche Informationen zu der Übertragung des Paketscheins noch einmal nachvollziehen. In dem Screenshot-Beispiel war die Erstellung und Übermittlung des Paketscheins erfolgreich, wie sich anhand der "Message"-Spalte feststellen lässt. Außerdem ist hier erkennbar, dass eine Trackingnummer erzeugt wurde.


Wechseln Sie anschließend zurück in den Dialog "Datenübertragung", so werden Sie feststellen, dass Trackingnummer dort ebenfalls automatisch in die zugehörige Spalte eingetragen wurde.

Auf Basis dieser Trackingnummer wird der Trackingstatus dann per Webhook aktualisiert. Bitte beachten Sie diesbezüglich, dass der Trackingstatus sich in der shipcloud-API ausschließlich via Webhook abrufen lässt. Das heißt, ein manueller Abruf über die Schaltfläche [ Trackingstatus ] in der rechten unteren Toolbar bzw. Buttonleiste ist anders als bei DPD dann nicht möglich. Dies hat jedoch den Vorteil, dass der Trackingstatus stets automatisch (und anhand der günstigsten Tarifvariante) aktualisiert wird.

Ähnlich wie bei DPD können Sie sich per Rechtsklick auch die "Tracking-Detailinfos" über den gleichnamigen Kontextmenüeintrag einholen, um sich genauere Informationen zum Zustellstatus eines Pakets anzeigen zu lassen (z.B. wann wo ein Paket angekommen ist).




Auf diese Weise erzeugte Paketscheine sind dann ebenfalls im Dashboard (oder unter "Sendungen“; siehe folgende Screenshots) einsehbar.



Zum Anfang