Om je snel op weg te helpen met nShift Checkout, kun je je bestaande DeliveryCheckout-configuratie (v1) importeren. Hierdoor kun je een groot deel van je huidige setup hergebruiken in plaats van alles vanaf nul op te bouwen.

Deze handleiding begeleidt je bij het exporteren van je configuratie uit DeliveryCheckout en het importeren ervan in nShift Checkout, evenals bij belangrijke zaken om rekening mee te houden vóór en na de import.
 

Voordat je begint

Controleer vóór het exporteren van je configuratie het volgende:
 

1. Controleer je template

Zorg ervoor dat je DeliveryCheckout-configuratie een template gebruikt met Essential, Professional of Premium in de naam. Elke template met Standard in de naam is een verouderde template en moet vóór export worden bijgewerkt.

Hoe je de template wijzigt

1. Ga in nShift Delivery naar Maintenance > DeliveryCheckout.
2. Klik op het weergavepictogram naast de configuratie die je wilt bijwerken.
3. Klik op de detailpagina van DeliveryCheckout op Change template.
4. Selecteer in het dropdownmenu de juiste template (Essential, Professional of Premium).
5. Zorg ervoor dat het selectievakje Create new DeliveryCheckout Id is aangevinkt.
6. Klik op OK.

Er wordt een nieuwe DeliveryCheckout-ID aangemaakt met de bijgewerkte template, terwijl je bestaande live-configuratie ongewijzigd blijft.

2. Stel een afzender in nShift Checkout in

Voordat je een configuratie importeert, moet er minimaal één afzender zijn geconfigureerd in je nShift Portal-account.

Lees meer: Afzenders instellen

3. Bereid aangepaste afhaallocaties voor

Als je aangepaste PUDO’s gebruikt (bijvoorbeeld afhalen in de winkel), worden deze niet opgenomen in het exportbestand en moeten ze handmatig worden ingesteld in nShift Portal.

Als je alle gegevens van je aangepaste locaties (ID’s, adres, coördinaten, openingstijden enzovoort) elders beschikbaar hebt, kun je die direct gebruiken. Als je aangepaste PUDO-informatie alleen in DeliveryCheckout bestaat, kun je de informatie daarvandaan exporteren:

1. Ga in nShift Delivery naar Maintenance > DeliveryCheckout > Agent lists.
2. Klik op Search om je agentlijsten weer te geven.
3. Download de lijsten die je wilt exporteren.

Houd er rekening mee dat het formaat dat in nShift Portal wordt gebruikt anders is. De JSON die vanuit DeliveryCheckout wordt geëxporteerd, kan niet ongewijzigd worden hergebruikt en moet opnieuw worden geformatteerd voordat deze in nShift Portal wordt geüpload.

Je eigen afhaallocaties toevoegen (aangepaste PUDO’s)

4. Exporteer en importeer je voorwaardenlijsten

Alle voorwaardenlijsten die in je DeliveryCheckout-configuratie worden gebruikt, moeten ook handmatig worden gemigreerd. Exporteer je voorwaardenlijsten uit DeliveryCheckout en importeer ze in nShift Checkout voordat je je configuratie importeert, zodat ze beschikbaar zijn wanneer dat nodig is tijdens het importproces.

Houd er rekening mee dat voorwaardenlijsten en aangepaste PUDO-lijsten niet aanwezig hoeven te zijn voordat je je configuratie importeert. Je kunt ze later instellen. Ze moeten echter op een bepaald moment nog steeds handmatig worden gemigreerd als ze nog relevant zijn en in de nieuwe Checkout gebruikt moeten worden.

Stap 1: Exporteer configuratie vanuit Delivery Checkout

1. Ga naar je DeliveryCheckout-configuratie (v1).
2. Klik op Export > Export JSON om de configuratie als JSON-bestand te exporteren.
3. Sla het bestand lokaal op.

Stap 2: Importeer configuratie in nShift Checkout

1. Log in op nShift Portal.
2. Bevestig dat je een afzender hebt ingesteld.
3. Navigeer naar nShift Checkout > Configurations.
4. Selecteer Import.
5. Upload je geëxporteerde JSON-bestand.
6. Controleer de geïmporteerde inhoud en corrigeer eventuele fouten die in de interface worden aangegeven.
7. Opslaan.

Wat gebeurt er tijdens het importeren?

Wanneer je een configuratie importeert, wordt je bestaande setup overgezet naar nShift Checkout. De kernstructuur blijft behouden, maar wordt aangepast aan het nieuwe systeem.

Houd er rekening mee dat nShift Checkout op een aantal fundamentele manieren anders werkt dan DeliveryCheckout. In v1 moest dezelfde voorwaarde vaak afzonderlijk worden geschreven op elke plek waar deze iets moest activeren. In de nieuwe Checkout kan één enkele regel meerdere acties tegelijk activeren, bijvoorbeeld een tekst wijzigen, een prijs aanpassen en een leveringsoptie verbergen, allemaal vanuit één voorwaarde.

Dit betekent dat een geïmporteerde configuratie weliswaar werkt, maar mogelijk niet optimaal profiteert van de manier waarop nShift Checkout is ontworpen. In veel gevallen, vooral bij complexere configuraties, zal opnieuw opbouwen vanaf nul resulteren in een slankere en beter onderhoudbare setup.

In DeliveryCheckout worden voorwaarden doorgaans geschreven om te bepalen wanneer een optie moet worden weergegeven. In nShift Checkout kun je kiezen of een leveringsoptie standaard zichtbaar is en door regels wordt verborgen, of standaard verborgen is en door regels wordt geactiveerd. Bij import worden leveringsopties ingesteld als inactief, waarbij regels ze activeren wanneer aan voorwaarden wordt voldaan, wat de logica van DeliveryCheckout weerspiegelt. Het is de moeite waard om dit na import te controleren, omdat de nieuwe aanpak je mogelijk in staat stelt je regels te vereenvoudigen, afhankelijk van je setup.

Verouderde voorwaarden worden automatisch omgezet in regels in de Rule Engine. Waar dezelfde voorwaarde op meerdere plaatsen in DeliveryCheckout werd gebruikt, resulteert dit in één enkele regel met meerdere acties in nShift Checkout, wat weerspiegelt hoe de nieuwe rule engine is ontworpen om te werken.

Na import krijgen alle geconverteerde regels de namen Rule 1, Rule 2, enzovoort. We raden aan om je regels door te nemen en ze betekenisvolle namen te geven. Dit maakt je configuratie in de toekomst eenvoudiger te onderhouden en problemen op te lossen.

Na import: Wat moet je controleren

Na het importeren van je configuratie raden we sterk aan om je setup te controleren en te valideren.

Gebruik het testpaneel in nShift Checkout om je configuratie te valideren. De test- en ontwikkelaarsmodus gebruiken

Het testpaneel is beschikbaar op de pagina Configurations bewerken. Klik op Change test input aan de rechterkant van het scherm om het te openen.

Vul de parameters in met testgegevens om verschillende scenario’s te simuleren, zoals verschillende winkelwagenwaarden, locaties of producttypes. De parameters in het testpaneel weerspiegelen de parameters die in je configuratie zijn ingeschakeld. Terwijl je de testgegevens wijzigt, wordt de widgetvoorbeeldweergave in realtime bijgewerkt, waardoor je een what-you-see-is-what-you-get-weergave krijgt van precies welke leveringsopties worden geretourneerd voor een bepaalde set invoerwaarden.

Dit maakt het eenvoudig om te verifiëren dat je regels zich zoals verwacht gedragen in verschillende scenario’s, inclusief edge cases.

We raden sterk aan om na de import een reeks scenario’s te testen voordat je live gaat.

Leveringsopties

• Zorg ervoor dat alle verwachte leveringsopties beschikbaar zijn.
• Controleer naamgeving, zichtbaarheid en prijzen.
   

Prijzen

• Controleer of prijzen zich correct gedragen in verschillende scenario’s.

In nShift Checkout heeft elke leveringsoptie een standaardprijs die wordt weergegeven tenzij een regel anders aangeeft. Als alle prijzen in je DeliveryCheckout-configuratie voorwaardelijk waren, zal het standaardprijsveld na import leeg zijn. Zorg ervoor dat je een standaardprijs instelt voor elke leveringsoptie in de interface van nShift Checkout. Dit is een verplicht veld, en zonder dit kun je de configuratie niet opslaan.

Regels en logica

• Controleer of geconverteerde regels zich gedragen zoals verwacht.
• Pas de logica waar nodig aan om deze af te stemmen op de nieuwe rule engine.
   

Controleer de volgorde van je regels

Regels bovenaan hebben prioriteit boven regels daaronder. Zorg er na import voor dat de volgorde overeenkomt met je beoogde logica en test verschillende scenario’s om te bevestigen dat je de verwachte resultaten krijgt. Regels kunnen opnieuw worden geordend via slepen en neerzetten.

Hulp nodig?

Als je problemen ondervindt tijdens export of import, of hulp nodig hebt bij het controleren van je setup, neem dan contact op met support.