Checkout voor Salesforce Commerce Cloud

Zodra metadata.zip is voorbereid, importeert u het in uw SFCC sandbox:

1. Ga naar Business Manager > Administration > Site Development > Site Import & Export.
2. Upload metadata.zip met de upload-optie Local.
3. Zoek na het uploaden het archief in de lijst op en klik op Import.

Deze stap maakt vereiste site preferences, services, credentials en custom objects aan die door de Zonos-integratie worden gebruikt.

Voeg de int_zonos cartridge toe aan het cartridge path van uw site om de controllers, scripts en templates te activeren:

1. Navigeer naar Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Voeg int_zonos toe aan het cartridge path, vóór de basis SFRA storefront cartridge (app_storefront_base).

Er zijn 2 custom Pipelines bij de cartridge inbegrepen waarvoor pipeline aliases moeten worden toegevoegd in Business Manager:

Zonos-OrderConfirmation

Dit wordt gebruikt voor de aangepaste orderbevestiging binnen SFCC zodra de bestelling is voltooid in Zonos checkout. De gebruiker wordt hierheen doorgestuurd. De alias kan bijvoorbeeld zonos-order-confirmation zijn. Selecteer en voeg een passende alias toe voor uw bedrijf die verschilt van de alias die u gebruikt voor de native SFCC/SFRA checkout orderbevestigingspagina (COSummary-Submit).

Zonos-PlaceSFCCOrder

Dit wordt gebruikt voor het custom endpoint om de Zonos-bestelling binnen SFCC/SFRA aan te maken en ervan wordt uitgegaan dat de alias zonos-placesfccorder is. Als u hier een andere alias gebruikt, moet u dit noteren wanneer u bij service set-up komt. Dit is geen public facing url, dus zonos-placesfccorder wordt aanbevolen voor initiële set-up om het gebruik van deze cartridge eenvoudig te houden.

Om deze twee Aliases te configureren, ga in Business Manager naar Merchant Tools > URL Rules > Pipeline URLs.

Met de site import in stap 2 zijn twee SFCC services (met bijbehorende profiles en credentials) aangemaakt: zonos.api.graphql en create.order.api.sfra.

Single site setup

Als uw organisatie één storefront site heeft binnen uw SFCC-organisatie, hoeft u hier niets extra te doen en kunt u doorgaan naar de volgende stap.

Multiple sites setup

Als uw organisatie meerdere storefront sites heeft, of van plan is meerdere storefront sites te hebben, binnen uw SFCC-organisatie, moet u updates/toevoegingen aanbrengen aan uw SFCC services. Wanneer u meerdere SFCC sites hebt die de Zonos-integratie gebruiken, hebt u een create order API service nodig voor elke site. Doe voor elke site het volgende:

1. Maak een nieuwe credential aan met de naam create.order.api.[siteID].
2. Stel de credential URL in op: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (bijvoorbeeld: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Maak een nieuwe service aan met de naam create.order.api.[siteID] en wijs hier het create.order.api profile en de create.order.api.[siteID] credential toe die u in stap 1 hebt aangemaakt.

Zodra dit is voltooid, hebt u een create order API service voor elk van uw sites.

Opmerking: Als u de originele create.order.api.sfra service niet hebt hernoemd naar de create order service voor een van uw sites en deze nog bestaat, kunt u deze verwijderen. Laat de servicenaam zonos.api.graphql ongewijzigd. Zelfs met meerdere sites hebt u slechts één Zonos API service nodig.

Ga in Business Manager naar Merchant Tools > Site Preferences > Custom Preferences en klik op de zonos preferences group om toegang te krijgen tot de Zonos custom site preferences.

Stel de volgende site preferences in voor uw site(s):

Tijdens Zonos Modal Checkout selecteren shoppers shipping methods gedefinieerd in uw Zonos Dashboard. Wanneer deze bestellingen in SFCC worden geïmporteerd, moeten hun shipping methods overeenkomen met een geldige SFCC shipping method. Om dit te ondersteunen:

1. Stel een of meer shipping methods in SFCC in waarnaar uw shipping methods in Zonos moeten mappen.
2. Stel in de Zonos Ship Method Mapping custom site preference hierboven een of meer shipping method mapping(s) in tussen uw Zonos shipping method(s) en uw SFCC shipping method(s).

Ship Method Mapping

In de vorm van een JSON object mapt de ship method mapping uw Zonos shipping method(s) naar uw SFCC shipping method(s). Deze mapping moet een mapping record hebben voor elke potentiële Zonos shipping method (service level) die in uw Zonos checkout kan worden geselecteerd. Het is sterk aanbevolen ook een default mapping record op te nemen dat wordt gebruikt wanneer een Zonos-bestelling wordt geplaatst met een shipping method waarvoor geen mapping naar een SFCC shipping method bestaat, om downstream failures door ontbrekende shipping method in de SFCC-bestelling te voorkomen.

Het formaat voor het JSON object is:

{
  "[Zonos Shipping Service Level Code]": "[SFCC Shipping Method ID]",
  ...
  "default": "[Default SFCC Shipping Method ID]"
}

Voorbeeld

Stel dat u de volgende service levels hebt ingeschakeld in uw Zonos Dashboard:

Om welke reden dan ook (bijv. backoffice-vereisten, een extra third-party shipping service-integratie, enz.) bent u mogelijk beperkt tot de volgende shipping methods in SFCC voor uw site:

Wanneer een nieuwe Zonos-bestelling wordt ontvangen en vervolgens in SFCC wordt geplaatst, moet de shipping method uit deze lijst komen.

Om uw mapping op te bouwen, logt u in op uw Zonos Dashboard, gaat u naar Shipping > Manage Rates en klikt u op elk van de weergegeven Enabled service levels, waar u een weergave ziet vergelijkbaar met het volgende:

Klik in elk op Edit details om de Zonos shipping service level code op te halen (of in te stellen) (zie hieronder).

Met de shipping service level code maakt u een mapping record dat deze mapt naar de SFCC shipping method die u op uw SFCC-bestellingen wilt wanneer dat shipping service level (Zonos shipping method) wordt gekozen in Zonos checkout.

Zodra u een record hebt toegevoegd voor elke ingeschakelde shipping service level code, evenals een default shipping method mapping, zou uw Zonos Ship Method Mapping JSON object er ongeveer zo uit moeten zien:

{
  "ups.worldwide_saver": "004",
  "ups.standard": "002",
  "ups.worldwide_expedited": "012",
  "ups.worldwide_express": "012",
  "default": "001"
}

Opmerking: Omdat dit alleen een mapping is van Zonos shipping methods naar SFCC shipping methods, is het alleen belangrijk dat alle Zonos shipping methods in de mapping zijn opgenomen. Het is niet nodig elke SFCC shipping method in de mapping op te nemen.

Bij de installatie zijn twee SFCC jobs inbegrepen ter ondersteuning van de Zonos-integratie:

CreateOrdersFromZonos

Deze job zoekt naar nieuw aangemaakte Zonos order references in de zonosOrders custom object store, haalt volledige bestelgegevens op bij Zonos en maakt corresponderende bestellingen aan in SFCC.

Schedule: U kunt deze job plannen passend bij uw bedrijfsbehoeften, maar doorgaans moet deze job op intervalbasis draaien, relatief frequent (bijv. elke 5-10 minuten), en elke dag van de week.

Custom Parameters: De CreateOrdersFromZonos job bevat geen custom parameters.

CreateMissingZonosOrders

Hoewel het zeldzaam zou moeten zijn, is het mogelijk dat door onvoorziene omstandigheden bestellingen in Zonos worden geplaatst die via het normale proces niet in uw SFCC-instantie komen. Daarom hebben we de CreateMissingZonosOrders job opgenomen. Deze job voert een cross-check uit tussen uw Zonos order history en SFCC om ontbrekende bestellingen te identificeren en te importeren.

Schedule: U kunt deze job plannen passend bij uw bedrijfsbehoeften, maar u moet deze job minder frequent laten draaien dan de CreateOrdersFromZonos job. Enkele overwegingen bij het plannen van de frequentie:

1. Zoals bij alle jobs geldt: na afweging van processing load/bandwidth en uw bedrijfsbehoeften, plant u deze job zo infrequent als u kunt.
2. Omdat deze job alle bestellingen over een periode bevraagt, moeten high-volume sites deze job frequenter draaien (minder bestellingen per job run), terwijl lower volume sites met minder frequentie kunnen.
3. Onze baseline aanbevolen frequentie voor CreateMissingZonosOrders, die voor de meeste sites werkt, is eens per 90 minuten.

Custom Parameters: Er zijn twee custom parameters gekoppeld aan de CreateMissingZonosOrders job step die u moet instellen:

1. LookBackHours: Het aantal uren (vanaf het moment dat de job draait) terug in de tijd waarvoor de job Zonos moet bevragen op ontbrekende bestellingen. Op basis van uw geplande frequentie moet deze waarde minstens gelijk zijn aan de tijd tussen job runs en idealiter overlap hebben. Als de job elke 90 minuten draait, stel LookBackHours in op 2 (uren). Standaardwaarde (indien niet ingesteld): 2
2. OrderSize: Maximum aantal bestellingen per interne query van Zonos. Zie dit als de page size die de job gebruikt bij het bevragen van Zonos. Standaardwaarde (indien niet ingesteld): 20

Zonos Hello biedt client-side localisatiemogelijkheden zoals dynamische taalselectie, duty/tax messaging en inline valutaconversie. Zodra Zonos is ingeschakeld in site preferences, laadt Hello automatisch op uw storefront via het Zonos client script.

De Zonos client scripts worden toegevoegd via een SFCC remote include van het Zonos-ClientScriptInclude endpoint, onderaan de volgende overlay templates:

• /cartridge/templates/default/common/layout/page.isml
• /cartridge/templates/default/common/layout/checkout.isml

Als uw project deze templates overschrijft in cartridges met hogere prioriteit, zorg dat de remote include wordt toegevoegd aan uw aangepaste versies:

<isinclude url="${URLUtils.url('Zonos-ClientScriptInclude', 'pageType', pdict.action)}"/>

Meer informatie over Zonos Hello.

Zonos Hello converteert automatisch prijswaarden op de storefront naar de lokale valuta van de shopper. Om dit correct te laten werken:

1. Prijswaarden moeten worden gewrapped in HTML-elementen met class names of ID's die via jQuery kunnen worden geselecteerd. Bijvoorbeeld: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Deze selector-waarden moeten worden opgenomen in de Currency Element Selector site preference (of in uw Zonos Dashboard).

Wijzigingen in price display code

De Zonos cartridge bevat de volgende overlay templates waar prijzen worden gerenderd op de reference architecture site, met class names zonos-list-price, zonos-sales-price en zonos-price toegewezen aan de HTML-elementen met die prijzen:

• /cartridge/templates/default/cart/productCard/cartCouponDisplay.isml
• /cartridge/templates/default/cart/cartTotals.isml
• /cartridge/templates/default/checkout/billing/billingSummary.isml
• /cartridge/templates/default/checkout/cart/miniCart.isml
• /cartridge/templates/default/chackout/productCard/productCardProductTotalPrice.isml
• /cartridge/templates/default/product/components/pricing.isml
• /cartridge/templates/default/product/components/setPrice.isml

Als er geen cartridges zijn met deze templates die hoger dan int_zonos in het cartridge path zijn geconfigureerd, zijn geen codewijzigingen nodig voor Zonos Hello om de valuta's van deze prijsweergaven op uw site te converteren. Als u aangepaste versies van deze templates hebt in een of meer cartridges hoger dan int_zonos in het cartridge path, moet u een unieke class name toevoegen aan de HTML wrappers rond uw prijzen (zoals hierboven geïllustreerd) in die aangepaste templates.

Configureren van de price elements selector string

De currency selector string is een jQuery-style selector string waarde die door het Zonos script wordt gebruikt om HTML-elementen te identificeren met prijswaarden die currency conversion updates moeten ontvangen. Deze waarde moet een spatie-gescheiden lijst zijn van CSS class names en/of ID's toegewezen aan HTML-elementen rond de prijsweergaven van uw site uit de vorige stap, waarbij class names worden voorafgegaan door . en ID's door # (zonder quotes). Als uw site bijvoorbeeld de templates voor prijsweergave uit de Zonos cartridge gebruikt, is de selector string .zonos-list-price .zonos-sales-price .zonos-price (zonder quotes).

De currency selector string kan worden geconfigureerd via uw Zonos Dashboard of in de Currency Element Selector site preference van uw Zonos custom site preferences in Business Manager.

Opmerking: Indien op beide plaatsen geconfigureerd, heeft de waarde in Business Manager voorrang.

Meer informatie over Zonos Hello currency conversion.

De checkout button selector string is een jQuery selector string waarde die door het Zonos script wordt gebruikt om HTML-elementen op uw site te identificeren die als knoppen fungeren en bij klik de klant naar de checkout flow van uw site leiden.

Wanneer shoppers op een Checkout-knop klikken die overeenkomt met uw geconfigureerde selector string, onderschept Zonos automatisch de actie en opent de modal checkout.

De checkout button selector string kan worden geconfigureerd via uw Zonos Dashboard of in de Place Order (Checkout) Button Selector site preference van uw Zonos custom site preferences in Business Manager.

Wanneer de gebruiker een bestelling voltooit in de Zonos hosted checkout, wordt hij doorgestuurd naar een custom Pipeline die een orderbevestiging binnen SFCC toont (Zonos-OrderConfirmation). De primaire rendering template voor deze orderbevestiging is /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Deze orderbevestigingspagina gebruikt dezelfde styling als de native SFCC/SFRA orderbevestigingspagina en deelt enkele .isml-bestanden met de native SFCC/SFRA orderbevestigingspagina. Mogelijk zijn styling-updates nodig om aangepaste style-updates van de site te matchen. Base rendering templates gebruikt door de Zonos orderbevestigingstemplate omvatten:

• app_storefront_base\cartridge\templates\default\checkout\confirmation\confirmationDetails.isml
• app_storefront_base\cartridge\templates\default\checkout\shipping\shippingSummary.isml
• int_zonos\cartridge\templates\default\checkout\billing\billingSummary.isml
• app_storefront_base\cartridge\templates\default\checkout\orderProductSummary.isml
• app_storefront_base\cartridge\templates\default\checkout\orderTotalSummary.isml

De onderliggende functie van deze custom pipeline, naast het tonen van een orderbevestiging aan de gebruiker, houdt verband met een nieuw custom object type dat is opgenomen in de data import: zonosOrders. Wanneer de orderbevestiging aan de gebruiker wordt getoond, gebruikt SFCC het Zonos order-ID dat wordt weergegeven in de URL van de orderbevestiging en maakt het een bijbehorend custom object aan met het Zonos order-ID als Key Attribute voor dat custom object. Dit wordt vervolgens gebruikt om de bestelling binnen SFCC te plaatsen via de job CreateOrdersFromZonos. Deze job doorloopt alle custom objects van het type zonosOrders met createdStatus = - None -. De job voert een aantal taken uit:

1. Vraag bij Zonos de bestelgegevens op.
2. Gebruik deze response om de bestelling in SFCC aan te maken, op basis van de instellingen die in de site prefs zijn geconfigureerd voor ship method en payment method, plus de details voor items, shipping, billing en customer in de response.
3. Werk Zonos bij met het SFCC-bestelnummer via een mutation, om dit te koppelen aan het Zonos-bestelnummer in het Zonos Dashboard.

Als de bovenstaande stappen slagen, wordt het custom object attribute createdStatus vervolgens ingesteld op created, zodat het object niet langer in aanmerking komt bij een volgende run. Als de bovenstaande stappen niet slagen, wordt het custom object attribute createdStatus vervolgens ingesteld op failed en wordt een foutmelding vastgelegd in het attribute errorResponse (Zonos) of sfccErrorResponse (SFCC), afhankelijk van welk systeem tijdens het proces de fout meldt.

Als u de bestelling opnieuw wilt proberen te plaatsen, zet u createdStatus gewoon terug op - None -; dit wordt dan meegenomen in de volgende job run.

Optioneel — De volgende instellingen zijn geavanceerde instellingen. Standaardwaarden zijn ingesteld, dus geen actie nodig. Als u aanpassingen wilt maken, volg dan deze richtlijnen:

Create invoice on import

Standaard ingesteld op Yes. Zonos maakt een factuur aan bij orderimport. Als u deze functie uitschakelt, moet u uw eigen factuur aanmaken en zet Zonos een fraud review hold op status zonos_hold. Zodra de fraude is opgeheven, keren we terug naar de vorige status.

Customer login

Standaard ingesteld op No. Als u een account voor checkout wilt vereisen, schakel over naar Yes. U moet ook gaan naar Customer configuration > Login options en Redirect Customer to Account Dashboard after Logging In bijwerken naar No.

SFCC order export

Als u de SFCC Order Export gebruikt of van plan bent te gebruiken, zorg dat de Zonos custom attributes toegewezen aan Order- en Product-objecten zijn opgenomen in uw SFCC order export-bestanden. Stel vanuit Merchant Tools > Site Preferences > Orders de order export schema version in op de nieuwste versie.

Nu u uw account en app hebt ingesteld, bent u klaar om uw integratie te testen. U moet Checkout en Hello inschakelen in SFCC tijdens testen. Doe het volgende:

1. Ga naar Merchant Tools > Site Preferences > Custom Preferences > zonos.
2. Zet Zonos Enabled op Yes.

Zodra u uw Zonos accountinformatie hebt geconfigureerd in de custom site preferences van uw site en de Zonos Enabled feature switch op YES staat, kunt u Zonos-functies op uw storefront testen door de volgende parameter aan de URL van uw site toe te voegen: zCountry=[country code of a country you have enabled in your Zonos Dashboard]

Als u bijvoorbeeld Canada hebt ingeschakeld: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Opmerking: Dit is alleen nodig voor testen in non-production omgevingen, waar uw Zonos Public API Token is geconfigureerd met een test credential token. Bij configuratie met uw live/production API token is de zCountry URL parameter niet nodig of verwacht.

Als u nog niet klaar bent om live te gaan, zet Zonos Enabled terug op No zodra u klaar bent met testen. Na het voltooien van testen schakelt u Zonos in met dezelfde stappen hierboven.

Productinformatie kan het bedrag aan verschuldigde invoerrechten en belastingen en de verzendkosten beïnvloeden. Hoe meer productinformatie u aan Zonos levert, hoe preciezer de geretourneerde offerte is. Zonos kan een offerte genereren zelfs wanneer deze informatie niet beschikbaar is, maar raadt aan de volgende belangrijke productdetails te leveren om de nauwkeurigheid te verbeteren:

• Weight: Gewicht beïnvloedt uw verzendkosten, wat invoerrechten of belastingen kan beïnvloeden. Gewichten in uw SFCC-productlijsten worden automatisch door Zonos gebruikt wanneer aanwezig.
• Dimensions: Afmetingen kunnen uw verzendkosten beïnvloeden, wat invoerrechten of belastingen kan beïnvloeden. Zonos kan productafmetingen (lengte, breedte en hoogte) gebruiken die op elk product in SFCC zijn ingesteld, maar u moet dit mappen in de Zonos custom site preferences voor correcte integratie.
• HS codes: HS codes beïnvloeden invoerrechtentarieven en kunnen soms belastingen beïnvloeden. Zonos kan de HS codes gebruiken die in uw productlijsten in SFCC zijn ingesteld, maar u moet het HS code-veld mappen in de Zonos custom site preferences.
• Country of origin: Het country of origin van een product beïnvloedt invoerrechtentarieven en kan belastingen beïnvloeden. Het country of origin dat in uw SFCC-productlijsten is ingesteld, wordt automatisch door Zonos gebruikt wanneer aanwezig.

Opmerking: U kunt de info ook invoeren in Catalog, waarmee de informatie die is opgeslagen en doorgegeven vanuit SFCC wordt overschreven.

Meer informatie over productinfo per platform.