Dieser Artikel erläutert, wo die Konfiguration von Delivery Checkout bei Verwendung mit Kustom von der Standardkonfiguration abweicht.
Abschnitte in diesem Artikel:
- Einen Delivery Checkout zur Verwendung mit Kustom erstellen
- Versandoptionen
- Benutzerdefinierte Add-ons
- DeliveryCheckout API
- Weitere Artikel
Einen Delivery Checkout zur Verwendung mit Kustom erstellen
Wenn Sie neu bei Delivery Checkout sind, empfehlen wir, mit dem Lesen dieser Artikel zu beginnen: Erste Schritte mit Checkout und Delivery Checkout einrichten.
- Bevor Sie beginnen, müssen Sie:
- Eine Kustom Checkout (KCOv3)-Integration haben.
- Über Anmeldedaten für das Kustom Merchant Portal verfügen.
- nShift-Kunde sein und über Anmeldedaten für nShift Delivery verfügen.
- Die Delivery Checkout-Struktur entsprechend Ihren Anforderungen erstellen und dabei die relevanten Informationen eingeben, z. B. Dienste, Preise und Agenten. Abhängig von Ihrem Abonnementplan sollten Sie eine der folgenden Vorlagen verwenden: Kustom - Essential, Kustom - Professional, Kustom - Premium oder Kustom standard.
- Befolgen Sie die Einrichtungsanweisungen in Delivery Checkout einrichten und Einen Delivery Checkout erstellen. Beachten Sie den folgenden Abschnitt zu Versandoptionen, der für den Kustom-Ablauf unterschiedlich ist.
-
Fügen Sie die nShift Delivery API-Anmeldedaten im Kustom-Portal hinzu. Wählen Sie „nShift/Unifaun DeliveryCheckout (v1)" als TMS. Die Werte, die Sie hinzufügen müssen, heißen Identifier und Key. Im Folgenden wird erklärt, wo Sie diese finden:
Identifier: Kombinieren Sie den ersten Teil des API-Schlüssels, genannt „ID", mit der Checkout-ID, getrennt durch einen Bindestrich. Den API-Schlüssel finden Sie unter Maintenance > API keys > API key details. Format: [API-Schlüssel-ID]-[Checkout-ID].
Wichtig: Verwenden Sie einen Bindestrich ohne zusätzliche Leerzeichen. Beispiel: GHBAVZ3EXITYS-a361edd1-93bb-471d-adbc-05337f632d86
Die Checkout-ID finden Sie unter Maintenance > Delivery checkout > Search in der Spalte Delivery checkout ID.
Key: Dies ist der zweite Teil des API-Schlüssels, genannt Secret ID, auf der Seite mit den API-Schlüsseldetails in Delivery. Weiterlesen.
Weiterlesen: https://docs.kustom.co/contents/partners/tms-partners/nshift
Delivery Checkout-Ablauf mit Kustom:
Versandoptionen
Für die meisten Versandoptionen, Dienste, Preise und Add-ons ist es möglich, Anwendungsbedingungen einzugeben. Sie können auch erweiterte Bedingungen verwenden, um bestimmte Textfelder dynamisch zu ändern. Bevor Sie Ihren Delivery Checkout erstellen, empfiehlt es sich, Lieferbedingungen näher zu erkunden.
- Der Name, den Sie der Versandoption geben, z. B. „Zuhause", dient nur zur internen Verwendung.
- Aktivieren Sie das Kontrollkästchen Disabled, wenn die Versandoption nicht sofort verwendet werden soll. Sie können den Status „Disabled" jederzeit ändern, z. B. wenn es ein vorübergehendes Problem mit dem Dienst eines Frachtführers gibt oder wenn Sie diese Option nur zu einem bestimmten Zeitpunkt des Jahres einbeziehen möchten.
- Weisen Sie die Versandoption einer Category zu, wenn dies relevant ist. Wenn Sie sowohl Unterebenen als auch Kategorien verwenden, sollten Sie stattdessen die Unterebene einer Kategorie zuweisen. Die Verwendung von Kategorien kann jedoch häufig die Verwendung von Unterebenen ersetzen.
- Wählen Sie einen Dienst im Abschnitt Service aus.
- Klicken Sie auf Add service.
Wenn der Dienst Agenten/Abholpunkte hat, können Sie mithilfe der Geolokalisierung bestimmen, welche und wie viele Agenten angezeigt werden. Der Abstand zu den nächstgelegenen Agenten wird für jede Postleitzahl berechnet. Zum Beispiel bedeutet „20", dass Agenten innerhalb eines Radius von 20 km von einer definierten GPS-Koordinate angezeigt werden.
Die Geolokalisierung kann nur in Belgien (BE), Dänemark (DK), Estland (EE), Finnland (FI), Deutschland (DE), Luxemburg (LU), den Niederlanden (NL), Norwegen (NO), Schweden (SE) und Åland (AX) verwendet werden.- Geben Sie einen Wert in das Feld Maximum radius (km) ein, wenn Sie Agenten basierend auf der Geolokalisierung anzeigen möchten; andernfalls sollte es auf „0" gesetzt werden.
- Mit Maximum number of agents können Sie die Anzahl der auf Basis der Geolokalisierung angezeigten Agenten begrenzen. Max. 15 Agenten.
- Geben Sie einen Wert in das Feld Maximum radius (km) ein, wenn Sie Agenten basierend auf der Geolokalisierung anzeigen möchten; andernfalls sollte es auf „0" gesetzt werden.
- Klicken Sie auf New oder Free shipping im Abschnitt Prices, um den Dienstpreis einzugeben.
- Bei New geben Sie Folgendes in jedem Währungsabschnitt ein:
- Den anzuzeigenden Preis für jede Sprache, z. B. „€ 7" in English (en)
- Den Preis als numerischen Wert, z. B. „7.0" in Price
- Den anzuwendenden Steuersatz, z. B. „12" in Tax rate (%)
- Bei Free delivery geben Sie Folgendes in jedem Währungsabschnitt ein:
- Den anzuzeigenden Text, z. B. „Free", in English (en)
- Den Warenkorbwert, ab dem die Lieferung kostenlos sein soll, z. B. „39.0", in Limit for free delivery
- Klicken Sie im Abschnitt Addons auf das Bearbeitungssymbol
links neben einem Add-on, das Sie aktivieren oder bearbeiten möchten.
- Aktivieren Sie Preselected, Mandatory oder beides, wenn das Add-on im Webshop vorausgewählt und/oder obligatorisch sein soll.
- Klicken Sie auf New im Abschnitt Prices, um Preise für das Add-on einzugeben.
- Geben Sie in jedem Währungsabschnitt den anzuzeigenden Preis für jede Sprache ein, z. B. „€ 1" in English (en), und den Preis als numerischen Wert, z. B. „1.0" in Price.
- Wenn Sie beim Verlassen der Seite Edit addon auf OK klicken, wird das Add-on aktiviert, auch wenn Sie keine Informationen eingegeben haben.
- Im Abschnitt Badges können Sie eine Art Badge auswählen, das für den Dienst sichtbar sein wird, z. B. „eco-friendly" oder „recommended".
- Klicken Sie auf New.
- Klicken Sie auf New.
- Bei New geben Sie Folgendes in jedem Währungsabschnitt ein:
- Klicken Sie auf OK.
- Im Abschnitt Delivery interval können Sie angeben, innerhalb wie vieler Tage die Lieferung frühestens bzw. spätestens erfolgt.
Beispiel:
Earliest delivery (business days): 1
Latest delivery (business days): 3
Das Paket wird innerhalb von 1 bis 3 Tagen geliefert. - Klicken Sie auf New im Abschnitt Fields for titles, wenn Sie einen Titel hinzufügen möchten, der unter bestimmten Bedingungen verwendet werden soll.
- Geben Sie im Abschnitt Language einen Titel in den zuvor definierten Sprachen ein.
Fields for titles ist obligatorisch, wird aber durch Titel aus Ihrem Kustom Checkout überschrieben.
- Geben Sie im Abschnitt Language einen Titel in den zuvor definierten Sprachen ein.
- Klicken Sie auf New im Abschnitt Captions for field 1, um Text hinzuzufügen. Relevanter Text/Informationen hängen von Ihrer Webshop-Konfiguration ab.
- Geben Sie im Abschnitt Language den Text in den zuvor definierten Sprachen ein, z. B. „Relevanter Text" im Feld English (en).
- Geben Sie im Abschnitt Language den Text in den zuvor definierten Sprachen ein, z. B. „Relevanter Text" im Feld English (en).
- Klicken Sie auf New im Abschnitt Sort order, um anzugeben, an welcher Stelle die Versandoption angezeigt werden soll.
- Im Abschnitt Number of days to delivery from today's date können Sie einen Wert eingeben, der ab dem heutigen Datum Tage hinzufügt.
- Klicken Sie auf New und geben Sie eine ganze Zahl in das Feld Value ein.
- Klicken Sie auf New und geben Sie eine ganze Zahl in das Feld Value ein.
-
Beispiel:
Früheste Lieferzeit: 17:00 Uhr
Späteste Lieferzeit: 22:00 Uhr
Wert: 2
Wenn das heutige Datum der 5. Juni ist, wird das Paket zwischen 17:00 und 22:00 Uhr am 7. Juni geliefert.
Um weitere Versandoptionen zum Delivery Checkout hinzuzufügen, klicken Sie auf New option auf der Seite New delivery checkout und befolgen Sie die oben genannten Schritte.
Bei einigen Elementen, wie Versandoptionen und Preisen, können Sie die Reihenfolge ändern, in der sie im Webshop angezeigt werden. Verwenden Sie die Symbole nach oben und nach unten
neben einer Artikelzeile oder verwenden Sie Sort order wie oben beschrieben.
Benutzerdefinierte Agenten werden als Dienst behandelt und werden auf dieselbe Weise wie andere Dienste hinzugefügt.
Klicken Sie auf Test, um zu sehen, wie die Versandoptionen im Webshop angezeigt werden, abhängig davon, welche Parameter Sie eingeben.
„tocity" und „tozipcode" sind immer obligatorisch, aber für einige Frachtführer können auch andere Parameter erforderlich sein.
Verwenden Sie die Suchfunktion, um einen Delivery Checkout anzuzeigen, zu bearbeiten oder zu löschen.
Benutzerdefinierte Add-ons
Das benutzerdefinierte Add-on „Express packaging" ist nicht an bestimmte Versandoptionen gebunden.
- Gehen Sie zu Maintenance > Delivery checkout.
- Beim Erstellen eines neuen Delivery Checkout aktivieren Sie benutzerdefinierte Add-ons auf der Seite New delivery checkout.
- Um benutzerdefinierte Add-ons für einen vorhandenen Delivery Checkout zu aktivieren, klicken Sie auf das Bearbeitungssymbol
links neben dem Delivery Checkout auf der Seite Delivery checkout.
- Klicken Sie auf das Bearbeitungssymbol
links neben einer Add-on-Zeile im Abschnitt Custom addons.
- Aktivieren Sie das Kontrollkästchen Preselected, wenn das Add-on automatisch im Voraus ausgewählt werden soll. Aktivieren Sie das Kontrollkästchen Mandatory, wenn das Add-on für den Dienst erforderlich sein soll.
Hinweis: Wenn Sie beim Verlassen der Seite Edit addon auf OK klicken, wird das Add-on aktiviert, auch wenn Sie keine Informationen eingegeben haben.
Sie deaktivieren ein benutzerdefiniertes Add-on, indem Sie auf das Löschsymbol links neben der Add-on-Zeile klicken.
Parameter – frachtführerspezifische Parameter
Einige Parameter sind bereits im System vorhanden, aber Sie können auch eigene hinzufügen. Parameter werden in der GUI konfiguriert. Wenn Sie keinen Standardwert festlegen, muss der Parameter im API-Aufruf gesetzt werden. Parameter, die mit dem Absender verknüpft sind, werden automatisch gesetzt.
Weiterlesen über Parameter hier.
Hinweise zu Parametern mit Kustom:
- Parameter/Tags (Text) können einen Wert (String) haben. Trennen Sie den Parameter/Tag und den Wert durch einen Doppelpunkt (:).
Beispiel: „products:4"
Sie können keinen numerischen Wert mit relativen Operatoren wie „>" oder „<" verwenden.
Parameter-/Tag-Werte können verwendet werden, um Bedingungen für numerische Werte (Text) zu erstellen, indem Bedingungslisten für gültige/ungültige Werte verwendet werden. - Ein Tag/Parameter kann auch boolesch sein.
Das Tag wird an Kustom gesendet = true.
Das Tag wird nicht an Kustom gesendet = false
Beispiel: „freefreight"
DeliveryCheckoutAPI
DeliveryCheckout API ist ein Integrationsdienst für die Kommunikation zwischen Delivery Checkout und Ihrem Webshop. DeliveryCheckout API verwendet ein REST API-Framework für die Kommunikation mit JSON als Datenträger und bietet eine Reihe von Funktionen.
Die gesamte allgemeine Dokumentation für die DeliveryCheckoutAPI finden Sie hier.
Bei gemeinsamer Verwendung mit Kustom gibt es einige besondere Szenarien, die wir im Folgenden behandeln. Bitte lesen Sie die Dokumentation von Kustom, um zu erfahren, wie Sie KSS mit Delivery Checkout integrieren.
Hinweis:
Wir empfehlen, dass Sie Kustom für jede Checkout-Sitzung eine Fallback-Lösung bereitstellen, falls Kustom keine Antwort von unserer API erhält, zum Beispiel aufgrund von Wartungsarbeiten.
Auf diese Weise stellen Sie sicher, dass Ihren Kunden stets Versandoptionen angezeigt werden.