Checkout för Salesforce Commerce Cloud

När metadata.zip är förberedd importerar ni den till er SFCC-sandbox:

1. Gå till Business Manager > Administration > Site Development > Site Import & Export.
2. Ladda upp metadata.zip med uppladdningsalternativet Local.
3. När uppladdningen är klar letar ni upp arkivet i listan och klickar på Import.

Detta steg skapar nödvändiga site preferences, tjänster, autentiseringsuppgifter och anpassade objekt som används av Zonos-integrationen.

Lägg till cartridgen int_zonos i er sajts cartridge path för att aktivera dess controllers, skript och mallar:

1. Navigera till Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Infoga int_zonos i cartridge path före den grundläggande SFRA storefront-cartridgen (app_storefront_base).

Det finns 2 anpassade Pipelines som ingår i cartridgen och som bör ha pipeline-alias tillagda i Business Manager:

Zonos-OrderConfirmation

Denna används för den anpassade orderbekräftelsen i SFCC när ordern har slutförts i Zonos checkout. Användaren omdirigeras hit. Alias kan till exempel vara zonos-order-confirmation. Välj och lägg till ett lämpligt alias för er verksamhet som skiljer sig från det alias ni använder för den inbyggda SFCC/SFRA checkout-sidan för orderbekräftelse (COSummary-Submit).

Zonos-PlaceSFCCOrder

Denna används för den anpassade endpoint som används för att skapa Zonos-ordern i SFCC/SFRA, och det förutsätts att aliaset är zonos-placesfccorder. Om ni använder ett annat alias här behöver ni notera det när ni kommer till tjänstekonfigurationen. Detta är inte en offentlig URL, så att använda zonos-placesfccorder rekommenderas vid den initiala konfigurationen för att underlätta användningen av denna cartridge.

För att konfigurera dessa två alias, navigera i Business Manager till Merchant Tools > URL Rules > Pipeline URLs.

Med site-importen i steg 2 skapades två SFCC-tjänster (med tillhörande profiler och autentiseringsuppgifter): zonos.api.graphql och create.order.api.sfra.

Konfiguration för en sajt

Om er organisation har en enda storefront-sajt inom er SFCC-organisation behöver ni inte göra något mer här och kan fortsätta till nästa steg.

Konfiguration för flera sajter

Om er organisation har flera storefront-sajter, eller planerar att ha flera storefront-sajter, inom er SFCC-organisation behöver ni göra uppdateringar/tillägg till era SFCC-tjänster. När ni har flera SFCC-sajter som ska använda Zonos-integrationen behöver ni en create order API-tjänst för varje sajt. För varje sajt gör ni följande:

1. Skapa en ny autentiseringsuppgift med namnet create.order.api.[siteID].
2. Ange autentiseringsuppgiftens URL till: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (till exempel: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Skapa en ny tjänst med namnet create.order.api.[siteID] och tilldela den profilen create.order.api samt autentiseringsuppgiften create.order.api.[siteID] som ni skapade i steg 1.

När det är klart bör ni ha en create order API-tjänst för var och en av era sajter.

Obs: Om ni inte döpte om den ursprungliga tjänsten create.order.api.sfra till create order-tjänsten för en av era sajter, och den fortfarande finns kvar, kan ni ta bort den. Låt tjänstnamnet zonos.api.graphql vara som det är. Även med flera sajter behöver ni bara en enda Zonos API-tjänst.

I Business Manager, navigera till Merchant Tools > Site Preferences > Custom Preferences, och klicka sedan på preferensgruppen zonos för att komma åt Zonos anpassade site preferences.

Ange följande site preferences för er/era sajt(er):

Under Zonos Modal Checkout väljer shoppare fraktmetoder som definierats i er Zonos Dashboard. När dessa ordrar importeras till SFCC måste deras fraktmetoder motsvara en giltig SFCC-fraktmetod. För att stödja detta:

1. Konfigurera en eller flera fraktmetoder i SFCC som era fraktmetoder i Zonos ska mappas till.
2. I den anpassade site preferencen Zonos Ship Method Mapping som beskrivs ovan, upprätta en eller flera mappningar mellan er/era Zonos-fraktmetod(er) och er/era SFCC-fraktmetod(er).

Ship Method Mapping

I form av ett JSON-objekt mappar ship method-mappningen er/era Zonos-fraktmetod(er) till er/era SFCC-fraktmetod(er). Denna mappning måste ha en mappningspost för varje potentiell Zonos-fraktmetod (service level) som kan väljas i er Zonos checkout. Det rekommenderas starkt att ni också inkluderar en default-mappningspost som används när en Zonos-order läggs med en fraktmetod för vilken det inte finns någon mappning till en SFCC-fraktmetod, vilket förhindrar efterföljande fel orsakade av saknad fraktmetod i SFCC-ordern.

Formatet för JSON-objektet är:

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

Exempel

Anta att ni har aktiverat följande service levels i er Zonos Dashboard:

Av vilken anledning som helst (t.ex. backoffice-krav, en ytterligare tredjepartsintegration för frakt med mera) kan ni vara begränsade till följande fraktmetoder i SFCC för er sajt:

När en ny Zonos-order tas emot och sedan läggs i SFCC måste fraktmetoden komma från denna lista.

För att bygga er mappning loggar ni in i er Zonos Dashboard, går till Shipping > Manage Rates och klickar sedan in i var och en av de visade Enabled service levels, där ni ser en visning som liknar följande:

I varje, klicka på Edit details för att hämta (eller ange) Zonos shipping service level-koden (se nedan).

Med shipping service level-koden skapar ni en mappningspost som mappar den till den SFCC-fraktmetod ni vill ska visas på era SFCC-ordrar när den shipping service level (Zonos-fraktmetod) väljs i Zonos checkout.

När ni har lagt till en post för varje aktiverad shipping service level-kod, samt en default-fraktmetodsmappning, bör ert JSON-objekt för Zonos Ship Method Mapping se ut ungefär så här:

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

Obs: Eftersom detta endast är en mappning från Zonos-fraktmetoder till SFCC-fraktmetoder är det bara viktigt att alla Zonos-fraktmetoder ingår i mappningen. Det finns inget behov av att ha var och en av era SFCC-fraktmetoder inkluderade i mappningen.

I installationen ingår två SFCC-jobb för att stödja Zonos-integrationen:

CreateOrdersFromZonos

Detta jobb letar efter nyligen skapade Zonos-orderreferenser i den anpassade objektlagringen zonosOrders, hämtar fullständiga orderdetaljer från Zonos och skapar motsvarande ordrar i SFCC.

Schedule: Ni kan schemalägga detta jobb efter era verksamhetsbehov, men normalt bör detta jobb konfigureras att köras med intervall, relativt ofta (t.ex. var 5–10:e minut), och varje dag i veckan.

Custom Parameters: Jobbet CreateOrdersFromZonos inkluderar inga anpassade parametrar.

CreateMissingZonosOrders

Även om det bör vara sällsynt är det möjligt att, på grund av oförutsedda omständigheter, ordrar som lagts i Zonos inte hamnar i er SFCC-instans via den normala processen. Av den anledningen har vi inkluderat jobbet CreateMissingZonosOrders. Detta jobb gör en korskontroll mellan er Zonos-orderhistorik och SFCC för att identifiera och importera eventuella saknade ordrar.

Schedule: Ni kan schemalägga detta jobb efter era verksamhetsbehov, men ni bör schemalägga det att köras mer sällan än jobbet CreateOrdersFromZonos. Några saker att tänka på när ni schemalägger hur ofta detta jobb ska köras:

1. Precis som med alla jobb, efter att ni vägt in allt—inklusive processbelastning/bandbredd och era verksamhetsbehov—bör ni schemalägga detta jobb att köras så sällan ni känner att ni kan.
2. Eftersom detta jobb frågar efter alla ordrar under en tidsperiod bör sajter med hög volym köra detta jobb oftare (så att färre ordrar bearbetas per jobbköning), medan sajter med lägre volym kan köra det mer sällan.
3. Vår baslinje för föreslagen frekvens för CreateMissingZonosOrders, som vi tror fungerar för de flesta sajter, är en gång var 90:e minut.

Custom Parameters: Det finns två anpassade parametrar kopplade till jobbsteget CreateMissingZonosOrders som ni bör ange:

1. LookBackHours: Detta är antalet timmar (från tidpunkten då jobbet körs) bakåt i tiden som jobbet ska fråga Zonos efter saknade ordrar. Baserat på er schemalagda frekvens för jobbet bör detta värde minst vara lika med tiden mellan jobbköningar, och helst ha en överlappning. Om jobbet till exempel är schemalagt att köras var 90:e minut, ange LookBackHours till 2 (timmar). Standardvärde (om inget värde anges): 2
2. OrderSize: Maximalt antal ordrar att hämta per intern fråga till Zonos. Tänk på detta som sidstorleken som jobbet använder när det frågar Zonos efter ordrar. Standardvärde (om inget värde anges): 20

Zonos Hello ger klientlokalisering såsom dynamiskt språkval, meddelanden om tull/skatt och inline-valutakonvertering. När Zonos är aktiverat i site preferences laddas Hello automatiskt i er storefront via Zonos klientskript.

Zonos klientskript läggs till med en SFCC remote include av endpointen Zonos-ClientScriptInclude, som finns längst ner i följande overlay-mallar:

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

Om ert projekt åsidosätter dessa mallar i cartridges med högre prioritet, se till att remote include läggs till i era anpassade versioner:

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

Läs mer om Zonos Hello.

Zonos Hello konverterar automatiskt prisvärden som visas i storefronten till shopparens lokala valuta. För att detta ska fungera korrekt:

1. Prisvärden måste omslutas av HTML-element med klassnamn eller ID:n som kan väljas via jQuery. Till exempel: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Dessa selectorvärden måste ingå i site preferencen Currency Element Selector (eller i er Zonos Dashboard).

Kodändringar för prisvisning

Zonos-cartridgen inkluderar följande overlay-mallar för var priser renderas i hela reference architecture-sajten, med klassnamnen zonos-list-price, zonos-sales-price och zonos-price tilldelade HTML-elementen som innehåller dessa olika priser:

• /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

Om det inte finns några cartridges som innehåller dessa mallar och är konfigurerade högre än int_zonos i cartridge path behövs inga kodändringar för att Zonos Hello ska konvertera valutorna för dessa prisrenderingar på er sajt. Om ni har anpassade versioner av dessa mallar i en eller flera cartridges högre än int_zonos i cartridge path måste ni inkludera ett unikt klassnamn på HTML-omslutningarna runt era priser (som illustreras ovan) i dessa anpassade mallar.

Konfigurera selectorsträngen för priselement

Valutaselectorsträngen är ett jQuery-liknande selectorsträngsvärde som används av Zonos-skriptet för att identifiera HTML-element som innehåller prisvärden som ska få uppdateringar för valutakonvertering. Detta värde bör vara en blankstegsavgränsad lista över CSS-klassnamn och/eller ID:n som tilldelats HTML-elementen som omsluter er sajts prisvisningar som beskrivs i föregående steg, där klassnamn prefixas med . och ID:n prefixas med # (utan citattecken). Om er sajt till exempel använder mallarna för prisvisning som ingår i Zonos-cartridgen blir selectorsträngen .zonos-list-price .zonos-sales-price .zonos-price (utan citattecken).

Valutaselectorsträngen kan konfigureras antingen via er Zonos Dashboard eller i site preferencen Currency Element Selector i era Zonos anpassade site preferences i Business Manager.

Obs: Om den är konfigurerad på båda ställena har värdet i Business Manager företräde.

Läs mer om Zonos Hello valutakonvertering.

Selectorsträngen för checkout-knappen är ett jQuery-selectorsträngsvärde som används av Zonos-skriptet för att identifiera HTML-element på er sajt som fungerar som knappkontroller som, när de klickas, tar kunden in i er sajts checkout-flöde.

När shoppare klickar på en Checkout-knapp som matchades av er konfigurerade selectorsträng fångar Zonos automatiskt upp åtgärden och öppnar modal checkout.

Selectorsträngen för checkout-knappen kan konfigureras antingen via er Zonos Dashboard eller i site preferencen Place Order (Checkout) Button Selector i era Zonos anpassade site preferences i Business Manager.

När användaren slutför en order i den Zonos-hostade checkouten omdirigeras de till en anpassad Pipeline som visar en orderbekräftelse i SFCC (Zonos-OrderConfirmation). Den primära renderingsmallen för denna orderbekräftelse är /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Denna orderbekräftelsesida använder samma stil som den inbyggda SFCC/SFRA-sidan för orderbekräftelse och delar vissa .isml-filer med den inbyggda SFCC/SFRA-sidan för orderbekräftelse. Detta kan kräva vissa stiluppdateringar för att matcha eventuella anpassade stiluppdateringar som redan gjorts på sajten. Basrenderingsmallar som används av Zonos-mallen för orderbekräftelse inkluderar:

• 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

Den underliggande funktionen för denna anpassade pipeline, utöver att visa en orderbekräftelse för användaren, är kopplad till en ny anpassad objekttyp som ingår i dataimporten, zonosOrders. När orderbekräftelsen visas för användaren använder SFCC det Zonos-order-id som visas i URL:en för orderbekräftelsen och skapar ett motsvarande anpassat objekt med Zonos-order-ID:t som Key Attribute för det anpassade objektet. Detta används sedan för att lägga ordern i SFCC via jobbet CreateOrdersFromZonos. Detta jobb itererar genom alla anpassade objekt av typen zonosOrders med createdStatus = - None -. Jobbet utför några uppgifter:

1. Fråga Zonos efter orderdetaljer.
2. Använd detta svar för att skapa ordern i SFCC baserat på inställningar som konfigurerats i site prefs för fraktmetod och betalningsmetod + detaljer för artiklar, frakt, fakturering och kund i svaret.
3. Uppdatera Zonos med SFCC-ordernumret via en mutation för att koppla detta till Zonos-ordernumret i Zonos Dashboard.

Om stegen ovan lyckas sätts det anpassade objektattributet createdStatus sedan till created för att ta bort objektet från framtida övervägande. Om stegen ovan inte lyckas sätts det anpassade objektattributet createdStatus sedan till failed och ett felmeddelande noteras i objektet i attributet errorResponse (Zonos) eller sfccErrorResponse (SFCC) beroende på vilket system som svarar med felet under processen.

Om ni behöver försöka lägga ordern igen, återställ bara createdStatus till - None - så beaktas den i nästa jobbköning.

Valfritt—Följande inställningar är avancerade. Standardvärden är på plats, så ingen åtgärd behövs. Om ni vill göra justeringar följer ni dessa riktlinjer:

Create invoice on import

Inställt på Yes som standard. Zonos skapar en faktura vid orderimporten. Om ni väljer att inaktivera denna funktion behöver ni skapa er egen faktura, och Zonos sätter ett hold för bedrägerigranskning till statusen zonos_hold. När bedrägerigranskningen hävs återgår vi till föregående status.

Customer login

Inställt på No som standard. Om ni vill kräva ett konto för checkout, växla till Yes. Ni behöver också gå till Customer configuration > Login options och uppdatera Redirect Customer to Account Dashboard after Logging In till No.

SFCC order export

Om ni använder, eller planerar att använda, SFCC Order Export, se till att Zonos anpassade attribut som tilldelats Order- och Product-objekten ingår i era SFCC order export-filer. Från Merchant Tools > Site Preferences > Orders, ange order export schema-versionen till den senaste versionen.

Nu när ni har konfigurerat ert konto och er app är ni redo att testa er integration. Ni behöver aktivera Checkout och Hello i SFCC under testningen. Gör så här:

1. Gå till Merchant Tools > Site Preferences > Custom Preferences > zonos.
2. Växla Zonos Enabled till Yes.

När ni har konfigurerat er Zonos-kontoinformation i er sajts anpassade site preferences, och funktionsväxeln Zonos Enabled är satt till YES, kan ni testa Zonos-funktioner i er storefront genom att lägga till följande parameter i er sajts URL: zCountry=[country code of a country you have enabled in your Zonos Dashboard]

Till exempel, om ni har aktiverat Kanada: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Obs: Detta behövs endast för testning i icke-produktionsmiljöer, där er Zonos Public API Token är konfigurerad med en testtoken. När den är konfigurerad med er live-/produktions-API-token behövs eller förväntas inte URL-parametern zCountry.

Om ni ännu inte är redo att gå live, kom ihåg att växla Zonos Enabled tillbaka till No när ni är klara med testningen. Efter att ni slutfört testningen aktiverar ni Zonos med samma steg som ovan.

Produktinformation kan påverka beloppet för tullar och skatter samt fraktkostnaden. Ju mer produktinformation ni tillhandahåller till Zonos, desto mer exakt blir den returnerade offerten. Zonos kan generera en offert även när denna information saknas, men rekommenderar att ni tillhandahåller följande nyckelproduktdetaljer för att förbättra noggrannheten:

• Vikt: Vikten påverkar er fraktkostnad, vilket kan påverka tullar eller skatter. Vikter i era SFCC-produktlistningar används automatiskt av Zonos när de finns.
• Mått: Mått kan påverka er fraktkostnad, vilket kan påverka tullar eller skatter. Zonos kan använda produktmått (längd, bredd och höjd) som anges på varje produkt i SFCC, men ni måste mappa dem i Zonos anpassade site preferences för korrekt integration.
• HS-koder: HS-koder påverkar tullsatser och kan ibland påverka skatter. Zonos kan använda HS-koderna som anges i era produktlistningar i SFCC, men ni måste mappa HS-kodfältet i Zonos anpassade site preferences.
• Ursprungsland: En produkts ursprungsland påverkar tullsatser och kan påverka skatter. Ursprungslandet som anges i era SFCC-produktlistningar används automatiskt av Zonos när det finns.

Obs: Alternativt kan ni ange informationen i Catalog, vilket åsidosätter informationen som lagras och skickas från SFCC.

Läs mer om produktinformation per plattform.