Dit artikel legt uit waarin de configuratie van Delivery Checkout, wanneer deze samen met Kustom wordt gebruikt, afwijkt van de standaardconfiguratie. 

Onderwerpen in dit artikel:

• Een Delivery Checkout maken voor gebruik met Kustom
• Leveringsopties
• Aangepaste addons
• DeliveryCheckout API
• Aanvullende artikelen

Een Delivery Checkout maken voor gebruik met Kustom

Als u nieuw bent met Delivery Checkout, raden wij aan te beginnen met het lezen van deze artikelen: Aan de slag met Checkout en Delivery Checkout instellen.

1. Voordat u begint, moet u:
   • Beschikken over een Kustom Checkout (KCOv3)-integratie.
   • Beschikken over inloggegevens voor het Kustom Merchant Portal.
   • nShift-klant zijn en beschikken over inloggegevens voor nShift Delivery.
      
2. Maak de Delivery Checkout-structuur aan volgens uw behoeften door de relevante informatie in te voeren, bijvoorbeeld diensten, prijzen en afhaalpunten. Afhankelijk van uw abonnement dient u een van de volgende sjablonen te gebruiken: Kustom - Essential, Kustom - Professional, Kustom - Premium of Kustom standard.
    
3. Volg de installatie-instructies in Delivery Checkout instellen en Een Delivery Checkout maken. Besteed bijzondere aandacht aan het onderstaande gedeelte over Leveringsopties, omdat dit afwijkt binnen de Kustom-flow.
    

4. Voeg de API-referenties van nShift Delivery toe in het Kustom Portal. Kies "nShift/Unifaun DeliveryCheckout (v1)" als TMS. De waarden die u moet toevoegen heten Identifier en Key. Hieronder wordt uitgelegd waar u deze kunt vinden:

   Identifier: Combineer het eerste deel van de API-sleutel, genaamd "ID", met het checkout-ID, gescheiden door een koppelteken. De API-sleutel vindt u onder Maintenance > API keys > API key details. Formaat:

   [API key ID]-[checkout ID]

   Belangrijk: Gebruik een koppelteken zonder extra spaties.

   Voorbeeld:

   GHBAVZ3EXITYS-a361edd1-93bb-471d-adbc-05337f632d86

   

   Het checkout-ID vindt u onder Maintenance > Delivery checkout > Search in de kolom Delivery checkout ID.

   

   
   Key: Dit is het tweede deel van de API-sleutel, het zogenaamde Secret ID, op de pagina met API-sleuteldetails in Delivery. Lees meer.

   

   Lees meer hier: https://docs.kustom.co/contents/partners/tms-partners/nshift

Delivery Checkout-flow met Kustom:

Leveringsopties

Voor de meeste leveringsopties, diensten, prijzen en addons is het mogelijk om voorwaarden toe te passen. U kunt ook geavanceerde voorwaarden gebruiken om bepaalde tekstvelden dynamisch te wijzigen. Voordat u uw Delivery Checkout aanmaakt, raden wij aan om meer te lezen over leveringsvoorwaarden.

1. De naam die u aan de leveringsoptie geeft, bijvoorbeeld "Home", is uitsluitend bedoeld voor intern gebruik.
    
2. Schakel het selectievakje Disabled in als u niet wilt dat de leveringsoptie onmiddellijk wordt gebruikt. U kunt de status Disabled op elk moment wijzigen, bijvoorbeeld als er een tijdelijk probleem is met een dienst van een vervoerder of als u deze optie alleen in een bepaalde periode van het jaar wilt aanbieden.
    
3. Wijs de leveringsoptie toe aan een Category, indien van toepassing. Als u zowel subniveaus als categorieën gebruikt, dient u het subniveau aan een categorie toe te wijzen. In veel gevallen kunnen categorieën echter subniveaus vervangen.
    
4. Selecteer een dienst in de sectie Service.
    
5. Klik op Add service.
   Als de dienst afhaalpunten ondersteunt, kunt u via geolocatie bepalen welke en hoeveel afhaalpunten worden weergegeven. De afstand tot de dichtstbijzijnde afhaalpunten wordt berekend voor elke postcode. Bijvoorbeeld: "20" betekent dat afhaalpunten binnen een straal van 20 km van een gedefinieerde GPS-coördinaat worden weergegeven.
   
   Geolocatie kan alleen worden gebruikt in België (BE), Denemarken (DK), Estland (EE), Finland (FI), Duitsland (DE), Luxemburg (LU), Nederland (NL), Noorwegen (NO), Zweden (SE) en Åland (AX).
   1. Voer een waarde in het veld Maximum radius (km) in als u afhaalpunten op basis van geolocatie wilt tonen; anders moet deze waarde op "0" staan.
       
   2. Met Maximum number of agents kunt u het aantal afhaalpunten beperken dat op basis van geolocatie wordt weergegeven. Maximaal 15 afhaalpunten.
       
6. Klik op New of Free shipping in de sectie Prices om de prijs van de dienst in te voeren.
   1. Als u New kiest, voert u in elke valutasectie het volgende in:
      • de prijs die voor elke taal moet worden weergegeven, bijvoorbeeld "€ 7" in English (en)
      • de prijs als numerieke waarde, bijvoorbeeld "7.0" in Price
      • het toe te passen belastingtarief, bijvoorbeeld "12" in Tax rate (%)
         
   2. Als u Free delivery kiest, voert u in elke valutasectie het volgende in:
      • de weer te geven tekst, bijvoorbeeld "Gratis", in Dutch (nl)
      • de winkelwagenwaarde vanaf welke levering gratis moet zijn, bijvoorbeeld "39.0", in Limit for free delivery
         
   3. In de sectie Addons klikt u op het bewerkingspictogram links van een addon die u wilt activeren of bewerken.
      • Schakel Preselected, Mandatory of beide in als de addon vooraf geselecteerd en/of verplicht moet zijn in de webshop.
      • Klik op New in de sectie Prices om prijzen voor de addon in te voeren.
      • Voer in elke valutasectie de weer te geven prijs voor elke taal in, bijvoorbeeld "€ 1" in Dutch (nl), en de numerieke prijswaarde, bijvoorbeeld "1.0" in Price.
         
   4. Als u op OK klikt wanneer u de pagina Edit addon verlaat, wordt de addon geactiveerd, zelfs als u geen informatie hebt ingevoerd.
       
   5. In de sectie Badges kunt u een type badge selecteren dat zichtbaar wordt voor de dienst, bijvoorbeeld 'milieuvriendelijk' of 'aanbevolen'.
      • Klik op New.
         
7. Klik op OK.
    
8. In de sectie Delivery interval kunt u aangeven binnen hoeveel dagen de levering uiterlijk en minimaal zal plaatsvinden. 
   
   Voorbeeld:
   Earliest delivery (business days): 1
   Latest delivery (business days): 3
   Het pakket wordt binnen 1 tot 3 werkdagen geleverd.
    
9. Klik op New in de sectie Fields for titles als u een titel wilt toevoegen die onder bepaalde voorwaarden moet worden gebruikt.
   • Voer in de sectie Language een titel in voor de talen die u eerder hebt gedefinieerd.
     
     Fields for titles are verplicht, maar worden overschreven door titels uit uw Kustom Checkout.
      
10. Klik op New in de sectie Captions for field 1 om tekst toe te voegen. Welke tekst relevant is, hangt af van de configuratie van uw webshop.
    • Voer in de sectie Language de tekst in voor de talen die u eerder hebt gedefinieerd, bijvoorbeeld "Relevante tekst" in het veld Dutch (nl).
       
11. Klik op New in de sectie Sort order om aan te geven op welke positie de leveringsoptie moet verschijnen.
     
12. In de sectie Number of days to delivery from today's date kunt u een waarde invoeren die dagen toevoegt vanaf de huidige datum.
    • Klik op New en voer een geheel getal in het veld Value in.
       
13. Voorbeeld:
    Earliest delivery time: 17:00
    Latest delivery time: 22:00
    Value: 2
    Als de huidige datum 5 juni is, wordt het pakket op 7 juni tussen 17:00 en 22:00 geleverd.

Om meer leveringsopties aan de Delivery Checkout toe te voegen, klikt u op New option op de pagina New delivery checkout en volgt u de bovenstaande stappen.

Voor sommige onderdelen, zoals leveringsopties en prijzen, kunt u de volgorde wijzigen waarin ze in de webshop verschijnen. Gebruik de omhoog en omlaag pictogrammen naast een rij of gebruik Sort order zoals hierboven beschreven.

Aangepaste afhaalpunten worden als een dienst behandeld en op dezelfde manier toegevoegd als andere diensten.

Klik op Test om te zien hoe de leveringsopties in de webshop worden weergegeven op basis van de ingevoerde parameters.

tocity en tozipcode zijn altijd verplicht, maar voor sommige vervoerders kunnen aanvullende parameters vereist zijn.

Gebruik de zoekfunctie om een Delivery Checkout weer te geven, te bewerken of te verwijderen.

Aangepaste addons

Aangepaste addons zijn niet gekoppeld aan een specifieke leveringsoptie, maar kunnen worden weergegeven voor meerdere leveringsopties binnen de checkout.

Ze kunnen worden gebruikt om extra diensten of keuzes aan de consument aan te bieden tijdens het afrekenproces.

Voorbeelden van aangepaste addons:

• Cadeauverpakking
• Levering zonder handtekening
• Klimaat- of milieubijdrage
• Extra verzekering
• Andere webshop-specifieke diensten

Zo activeert u aangepaste addons:

1. Ga naar Maintenance > Delivery checkout.
2. Open of maak een Delivery Checkout aan.
3. Ga naar de sectie met addons.
4. Activeer de gewenste addons.

Voor iedere addon kunt u het volgende configureren:

• Title
• Description
• Price
• Preselected
• Mandatory
• Sort order

Preselected betekent dat de addon automatisch geselecteerd wordt wanneer de checkout wordt weergegeven.

Mandatory betekent dat de consument de addon niet kan uitschakelen.

Prijzen van addons worden afzonderlijk weergegeven en toegevoegd aan de totale leveringsprijs.

Addons kunnen ook worden beheerd met behulp van leveringsvoorwaarden en geavanceerde voorwaarden.

Hierdoor kunnen addons alleen worden weergegeven voor specifieke landen, postcodes, producten of orderwaarden.

Parameters – vervoerderspecifieke parameters

Vervoerderspecifieke parameters worden gebruikt om aanvullende informatie van Delivery Checkout naar Kustom te verzenden.

De parameters worden geconfigureerd op de leveringsopties binnen Delivery Checkout.

Ze kunnen worden gebruikt om specifieke functionaliteit binnen de checkout te activeren of te beheren.

Er zijn twee soorten parameters:

Tekstparameters

Tekstparameters worden verzonden als sleutel/waarde-paren.

Voorbeeld:

products:4

Hier wordt de parameter products verzonden met de waarde 4.

Andere voorbeelden zijn:

deliverytype:home
category:express
service:pickup

Booleaanse parameters

Booleaanse parameters hebben geen waarde.

Voorbeeld:

freefreight

Wanneer de parameter naar Kustom wordt verzonden, wordt deze geïnterpreteerd als true.

Wanneer de parameter niet wordt verzonden, wordt deze geïnterpreteerd als false.

Hiermee kunnen functies worden geactiveerd of gedeactiveerd zonder een expliciete waarde te verzenden.

Gebruik van parameters

Parameters kunnen worden gebruikt voor:

• Het aansturen van checkout-logica.
• Het categoriseren van leveringsopties.
• Het activeren van specifieke checkout-functionaliteit.
• Vervoerderspecifieke functionaliteit.
• Integraties met oplossingen van derden.

De parameters worden samen met de geselecteerde leveringsoptie naar Kustom verzonden en kunnen vervolgens binnen de checkout-flow worden gebruikt.

Het wordt aanbevolen om gebruikte parameters intern te documenteren om consistente configuratie en onderhoud te waarborgen.

DeliveryCheckout API

DeliveryCheckout API is de integratieservice tussen Delivery Checkout en uw webshop.

De API maakt gebruik van een REST API-framework met JSON als gegevensdrager en maakt het mogelijk om leveringsopties op te halen en te verwerken tijdens het checkoutproces.

Wanneer Delivery Checkout samen met Kustom wordt gebruikt, verloopt de communicatie tussen Kustom en DeliveryCheckout API automatisch via de integratie.

Kustom verzendt de benodigde informatie over de bestelling van de consument naar DeliveryCheckout API en ontvangt vervolgens de relevante leveringsopties als antwoord.

De geretourneerde leveringsopties worden daarna in de checkout weergegeven, zodat de consument de gewenste leveringsoptie kan selecteren.

De geselecteerde optie wordt vervolgens als onderdeel van de bestelgegevens teruggestuurd naar Kustom.

De Kustom-integratie maakt gebruik van de parameters, diensten, prijzen, afhaalpunten, addons en leveringsvoorwaarden die in Delivery Checkout zijn geconfigureerd.

Daarom wordt aanbevolen om alle scenario’s grondig te testen voordat de checkout live wordt gezet.

Fallback-oplossing

Het wordt sterk aanbevolen om een fallback-oplossing in Kustom te configureren.

Een fallback-oplossing zorgt ervoor dat consumenten nog steeds leveringsopties kunnen zien wanneer Kustom tijdelijk geen verbinding kan maken met de nShift API.

Voorbeelden van situaties waarin een fallback-oplossing nodig kan zijn:

• Gepland onderhoud.
• Tijdelijke netwerkproblemen.
• Timeouts tussen systemen.
• Tijdelijke onbeschikbaarheid van diensten van derden.

Door een fallback-oplossing te configureren wordt het risico op afgebroken checkoutprocessen en verloren bestellingen verminderd.

Raadpleeg de documentatie van Kustom voor aanbevelingen met betrekking tot fallback-configuraties.

Aanvullende artikelen

De volgende artikelen kunnen nuttig zijn bij het configureren en beheren van Delivery Checkout in combinatie met Kustom:

• Aan de slag met Checkout
• Delivery Checkout instellen
• Een Delivery Checkout maken
• Introductie tot leveringsvoorwaarden
• Functies voor geavanceerde voorwaarden
• Property reference guide
• Abonnementen en functies

Aanvullende documentatie over de integratie is beschikbaar bij Kustom:

• nShift DeliveryCheckout-integratie

Voor technische details over de DeliveryCheckout API verwijzen wij naar de API-documentatie:

https://api.unifaun.com/rs-docs/