Checkout voor Salesforce Commerce Cloud

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

1. Go to Business Manager > Administration > Site Development > Site Import & Export.
2. Upload metadata.zip using the Local upload option.
3. After uploading, locate the archive in the list and click 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. Navigate to Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Insert int_zonos into the cartridge path before the base 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. Create a new credential with the name create.order.api.[siteID].
2. Assign the credential URL to be: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (for example: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Create a new service with the name create.order.api.[siteID] and assign to it the create.order.api profile, and the create.order.api.[siteID] credential you created in step 1.

Once complete, you should have a create order API service for each of your 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. Damit dit correct werkt:

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

The underlying function related to this custom pipeline outside of displaying an order confirmation to the user is related to a new custom object type that is included within the data import, zonosOrders. When the order confirmation displays for the user, SFCC is using the Zonos order id displayed in the url for the order confirmation and creating a corresponding custom object with the Zonos order ID as the Key Attribute for the custom object. This is then used to place the order within SFCC via job CreateOrdersFromZonos. This job will iterate through all custom objects of type zonosOrders with createdStatus = - None -. The job will perform a few tasks:

1. Query Zonos for order details.
2. Use this response to create the order within SFCC based on settings configured within site prefs for ship method and payment method + details for items, shipping, billing and customer within the response.
3. Update Zonos with the SFCC order number via a mutation to associate this with the Zonos order number within the Zonos Dashboard.

If the above steps are successful, the custom object attribute createdStatus will be then set to created to remove the object from future consideration. If the above steps are not successful, the custom object attribute createdStatus will be then set to failed and an error message will be noted within the object in attribute errorResponse (Zonos) or sfccErrorResponse (SFCC) depending on the system responding with the error during the process.

If you need to re-try to place the order, just re-set the createdStatus to - None - and this will be taken into consideration in the next 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.

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.