Checkout til Salesforce Commerce Cloud

Når metadata.zip er forberedt, skal du importere den til din SFCC sandbox:

1. Gå til Business Manager > Administration > Site Development > Site Import & Export.
2. Upload metadata.zip ved hjælp af uploadmuligheden Local.
3. Efter upload skal du finde arkivet på listen og klikke på Import.

Dette trin opretter nødvendige webstedspræferencer, tjenester, legitimationsoplysninger og brugerdefinerede objekter, der bruges af Zonos-integrationen.

Tilføj int_zonos-patronen til dit websteds patronsti for at aktivere dens controllere, scripts og skabeloner:

1. Naviger til Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Indsæt int_zonos i patronstien før den grundlæggende SFRA-butiksfacadepatron (app_storefront_base).

Der er 2 brugerdefinerede Pipelines inkluderet i patronen, som skal have pipeline-aliaser tilføjet i Business Manager:

Zonos-OrderConfirmation

Dette bruges til den brugerdefinerede ordrebekræftelse i SFCC, når ordren er fuldført i Zonos Checkout. Brugeren omdirigeres hertil. For eksempel kan aliaset være zonos-order-confirmation. Vælg og tilføj et passende alias for din virksomhed, der er forskelligt fra aliaset, du bruger til den native SFCC/SFRA Checkout-ordrebekræftelsesside (COSummary-Submit).

Zonos-PlaceSFCCOrder

Dette bruges til det brugerdefinerede endpoint, der opretter Zonos-ordren i SFCC/SFRA, og det antages, at aliaset er zonos-placesfccorder. Hvis du bruger et andet alias her, skal du notere dette, når du når til serviceopsætning. Dette er ikke en offentlig URL, så det anbefales at bruge zonos-placesfccorder til indledende opsætning for at bevare nem brug af denne patron.

For at konfigurere disse to aliaser skal du i Business Manager navigere til Merchant Tools > URL Rules > Pipeline URLs.

Med webstedsimporten i trin 2 blev to SFCC-tjenester (med tilhørende profiler og legitimationsoplysninger) oprettet: zonos.api.graphql og create.order.api.sfra.

Opsætning med enkelt websted

Hvis din organisation har et enkelt butiksfacade-websted i din SFCC-organisation, er der intet yderligere at gøre her, og du kan fortsætte til næste trin.

Opsætning med flere websteder

Hvis din organisation har flere butiksfacade-websteder, eller planlægger at have flere butiksfacade-websteder, i din SFCC-organisation, skal du foretage opdateringer/tilføjelser til dine SFCC-tjenester. Når du har flere SFCC-websteder, der skal bruge Zonos-integrationen, skal du have en create order API-tjeneste for hvert websted. For hvert websted skal du gøre følgende:

1. Opret en ny legitimationsoplysning med navnet create.order.api.[siteID].
2. Tildel legitimationsoplysningens URL til at være: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (for eksempel: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Opret en ny tjeneste med navnet create.order.api.[siteID], og tildel den create.order.api-profilen samt create.order.api.[siteID]-legitimationsoplysningen, du oprettede i trin 1.

Når du er færdig, bør du have en create order API-tjeneste for hvert af dine websteder.

Bemærk: Hvis du ikke omdøbte den oprindelige create.order.api.sfra-tjeneste til create order-tjenesten for et af dine websteder, og den stadig findes, kan du slette den. Lad zonos.api.graphql-tjenestenavnet være, som det er. Selv med flere websteder behøver du kun en enkelt Zonos API-tjeneste.

I Business Manager skal du navigere til Merchant Tools > Site Preferences > Custom Preferences og derefter klikke på præferencegruppen zonos for at få adgang til Zonos brugerdefinerede webstedspræferencer.

Indstil følgende webstedspræferencer for dit/dine websted(er):

Under Zonos Modal Checkout vælger kunder forsendelsesmetoder defineret i dit Zonos Dashboard. Når disse ordrer importeres til SFCC, skal deres forsendelsesmetoder svare til en gyldig SFCC-forsendelsesmetode. For at understøtte dette:

1. Opsæt en eller flere forsendelsesmetoder i SFCC, som dine forsendelsesmetoder i Zonos skal mappes til.
2. I den brugerdefinerede webstedspræference Zonos Ship Method Mapping beskrevet ovenfor skal du etablere en eller flere forsendelsesmetode-mapping(s) mellem din(e) Zonos-forsendelsesmetode(r) og din(e) SFCC-forsendelsesmetode(r).

Forsendelsesmetode-mapping

I form af et JSON-objekt mapper forsendelsesmetode-mappingen din(e) Zonos-forsendelsesmetode(r) til din(e) SFCC-forsendelsesmetode(r). Denne mapping skal have en mappingpost for hver potentiel Zonos-forsendelsesmetode (serviceniveau), der kan vælges i din Zonos Checkout. Det anbefales stærkt, at du også inkluderer en default-mappingpost, der bruges i tilfælde, hvor en Zonos-ordre placeres med en forsendelsesmetode, som der ikke findes mapping til for en SFCC-forsendelsesmetode, og dermed forhindrer downstream-fejl forårsaget af manglende forsendelsesmetode i SFCC-ordren.

Formatet for JSON-objektet er:

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

Eksempel

Antag, at du har aktiveret følgende serviceniveauer i dit Zonos Dashboard:

Uanset årsag (f.eks. backoffice-krav, en yderligere tredjeparts forsendelsesserviceintegration osv.) kan du være begrænset til følgende forsendelsesmetoder i SFCC for dit websted:

Når en ny Zonos-ordre modtages og derefter placeres i SFCC, skal forsendelsesmetoden være fra denne liste.

For at opbygge din mapping skal du logge ind på dit Zonos Dashboard, gå til Shipping > Manage Rates og derefter klikke ind i hvert af de viste Enabled service levels, hvor du vil se en visning lignende følgende:

I hver skal du klikke på Edit details for at få (eller indstille) Zonos forsendelsesserviceniveau-koden (se nedenfor).

Med forsendelsesserviceniveau-koden skal du oprette en mappingpost, der mapper den til den SFCC-forsendelsesmetode, du vil have vist på dine SFCC-ordrer, når det serviceniveau (Zonos-forsendelsesmetode) vælges i Zonos Checkout.

Når du har tilføjet en post for hver aktiveret forsendelsesserviceniveau-kode samt en default forsendelsesmetode-mapping, bør dit Zonos Ship Method Mapping JSON-objekt se ud som dette:

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

Bemærk: Fordi dette kun er en mapping af Zonos-forsendelsesmetoder til SFCC-forsendelsesmetoder, er det kun vigtigt at have alle Zonos-forsendelsesmetoder inkluderet i mappingen. Det er ikke nødvendigt at have hver af dine SFCC-forsendelsesmetoder inkluderet i mappingen.

Inkluderet i installationen er to SFCC-jobs til at understøtte Zonos-integrationen:

CreateOrdersFromZonos

Dette job leder efter nyligt oprettede Zonos-ordrereferencer i zonosOrders custom object store, henter fulde ordredetaljer fra Zonos og opretter tilsvarende ordrer i SFCC.

Plan: Du kan planlægge dette job efter dine forretningsbehov, men typisk bør dette job konfigureres til at køre med interval, relativt hyppigt (f.eks. hvert 5.-10. minut) og hver dag i ugen.

Brugerdefinerede parametre: CreateOrdersFromZonos-jobbet inkluderer ingen brugerdefinerede parametre.

CreateMissingZonosOrders

Selvom det bør være sjældent, er det muligt, at der på grund af uforudsete omstændigheder kan være ordrer placeret i Zonos, der ikke når ind i din SFCC-instans via den normale proces. Derfor har vi inkluderet CreateMissingZonosOrders-jobbet. Dette job udfører en krydstjek mellem din Zonos ordrehistorik og SFCC for at identificere og importere manglende ordrer.

Plan: Du kan planlægge dette job efter dine forretningsbehov, men du bør planlægge dette job til at køre mindre hyppigt end CreateOrdersFromZonos-jobbet. Nogle ting at overveje ved planlægning af hyppigheden for dette job:

1. Som med alle jobs bør du, efter alle hensyn er taget — inklusive behandlingsbelastning/båndbredde og dine forretningsbehov — planlægge dette job til at køre så sjældent, som du føler, du kan.
2. Da dette job forespørger alle ordrer over en tidsperiode, bør websteder med højt volumen køre dette job hyppigere (så færre ordrer behandles pr. jobkørsel), mens websteder med lavere volumen kan klare sig med lavere hyppighed.
3. Vores baseline-anbefalede hyppighed for CreateMissingZonosOrders, som vi mener vil virke for de fleste websteder, er én gang hvert 90. minut.

Brugerdefinerede parametre: Der er to brugerdefinerede parametre tilknyttet CreateMissingZonosOrders-jobtrinnet, som du bør indstille:

1. LookBackHours: Dette er antallet af timer (fra tidspunktet, jobbet kører) tilbage i tid, som jobbet skal forespørge Zonos efter manglende ordrer. Baseret på din planlagte hyppighed for jobbet bør denne værdi mindst svare til tiden mellem jobkørsler og ideelt have overlap. Hvis jobbet f.eks. er planlagt til at køre hvert 90. minut, skal du sætte LookBackHours til 2 (timer). Standardværdi (hvis ingen værdi er sat): 2
2. OrderSize: Maksimalt antal ordrer at hente pr. intern forespørgsel til Zonos. Tænk på dette som sidestørrelsen, jobbet bruger, når det forespørger Zonos om ordrer. Standardværdi (hvis ingen værdi er sat): 20

Zonos Hello leverer lokaliseringsfunktioner på klientsiden såsom dynamisk sprogvalg, told-/skatbeskeder og inline valutaomregning. Når Zonos er aktiveret i webstedspræferencer, indlæses Hello automatisk på din butiksfacade via Zonos-klientscriptet.

Zonos-klientscripts tilføjes ved hjælp af en SFCC remote include af Zonos-ClientScriptInclude-endpointet, placeret nederst i følgende overlay-skabeloner:

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

Hvis dit projekt tilsidesætter disse skabeloner i patroner med højere prioritet, skal du sikre, at remote include tilføjes til dine tilpassede versioner:

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

Få mere at vide om Zonos Hello.

Zonos Hello konverterer automatisk prisværdier, der vises på butiksfacaden, til kundens lokale valuta. For at dette fungerer korrekt:

1. Prisværdier skal pakkes ind i HTML-elementer ved hjælp af klassenavne eller id'er, der kan vælges via jQuery. For eksempel: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Disse vælgerværdier skal inkluderes i webstedspræferencen Currency Element Selector (eller i dit Zonos Dashboard).

Ændringer i prisvisningskode

Zonos-patronen inkluderer følgende overlay-skabeloner for, hvor priser gengives på hele referencearkitekturwebstedet, ved at bruge klassenavnene zonos-list-price, zonos-sales-price og zonos-price tildelt HTML-elementerne, der indeholder disse forskellige 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

Hvis der ikke er patroner, der indeholder disse skabeloner og er konfigureret højere end int_zonos i patronstien, er ingen kodeændringer nødvendige for, at Zonos Hello kan konvertere valutaerne for disse prisvisninger på dit websted. Hvis du har tilpassede versioner af disse skabeloner i en eller flere patroner højere end int_zonos i patronstien, skal du inkludere et unikt klassenavn i HTML-wrapperne omkring dine priser (som vist ovenfor) i disse tilpassede skabeloner.

Konfiguration af vælgerstreng for priselementer

Valutavælgerstrengen er en jQuery-lignende vælgerstreng, som Zonos-scriptet bruger til at identificere HTML-elementer, der indeholder prisværdier, som skal modtage valutaomregningsopdateringer. Denne værdi bør være en mellemrumsadskilt liste over CSS-klassenavne og/eller id'er tildelt HTML-elementerne, der wrapper dit websteds prisvisninger beskrevet i forrige trin, hvor klassenavne præfixes med . og id'er præfixes med # (uden anførselstegn). Hvis dit websted f.eks. vil bruge skabelonerne til prisvisning inkluderet i Zonos-patronen, vil vælgerstrengen være .zonos-list-price .zonos-sales-price .zonos-price (uden anførselstegn).

Valutavælgerstrengen kan konfigureres enten via dit Zonos Dashboard eller i webstedspræferencen Currency Element Selector i dine Zonos brugerdefinerede webstedspræferencer i Business Manager.

Bemærk: Hvis konfigureret begge steder, har værdien i Business Manager forrang.

Få mere at vide om Zonos Hello valutaomregning.

Checkout-knapvælgerstrengen er en jQuery-vælgerstreng, som Zonos-scriptet bruger til at identificere HTML-elementer på dit websted, der fungerer som knapkontroller, som når de klikkes, fører kunden ind i dit websteds Checkout-flow.

Når kunder klikker på en Checkout-knap, der blev matchet af din konfigurerede vælgerstreng, opsnapper Zonos automatisk handlingen og åbner modal Checkout.

Checkout-knapvælgerstrengen kan konfigureres enten via dit Zonos Dashboard eller i webstedspræferencen Place Order (Checkout) Button Selector i dine Zonos brugerdefinerede webstedspræferencer i Business Manager.

Når brugeren fuldfører en ordre i Zonos hostet Checkout, omdirigeres de til en brugerdefineret Pipeline, der viser en ordrebekræftelse i SFCC (Zonos-OrderConfirmation). Den primære renderingsskabelon for denne ordrebekræftelse er /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Denne ordrebekræftelsesside bruger samme styling som den native SFCC/SFRA ordrebekræftelsesside og deler nogle .isml-filer med den native SFCC/SFRA ordrebekræftelsesside. Dette kan kræve stylingopdateringer for at matche eventuelle tilpassede stylingopdateringer allerede foretaget på webstedet. Grundlæggende renderingsskabeloner brugt af Zonos ordrebekræftelsesskabelonen inkluderer:

• 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 underliggende funktion relateret til denne brugerdefinerede pipeline ud over at vise en ordrebekræftelse til brugeren er relateret til en ny brugerdefineret objekttype, der er inkluderet i dataimporten, zonosOrders. Når ordrebekræftelsen vises for brugeren, bruger SFCC Zonos ordre-id'et vist i URL'en for ordrebekræftelsen og opretter et tilsvarende brugerdefineret objekt med Zonos ordre-id'et som Key Attribute for det brugerdefinerede objekt. Dette bruges derefter til at placere ordren i SFCC via job CreateOrdersFromZonos. Dette job vil iterere gennem alle brugerdefinerede objekter af typen zonosOrders med createdStatus = - None -. Jobbet udfører nogle få opgaver:

1. Forespørg Zonos om ordredetaljer.
2. Brug dette svar til at oprette ordren i SFCC baseret på indstillinger konfigureret i webstedspræferencer for forsendelsesmetode og betalingsmetode + detaljer for varer, forsendelse, fakturering og kunde i svaret.
3. Opdater Zonos med SFCC-ordrenummeret via en mutation for at associere dette med Zonos-ordrenummeret i Zonos Dashboard.

Hvis ovenstående trin er succesfulde, vil det brugerdefinerede objektattribut createdStatus derefter blive sat til created for at fjerne objektet fra fremtidig overvejelse. Hvis ovenstående trin ikke er succesfulde, vil det brugerdefinerede objektattribut createdStatus derefter blive sat til failed, og en fejlmeddelelse vil blive noteret i objektet i attributten errorResponse (Zonos) eller sfccErrorResponse (SFCC) afhængigt af hvilket system der svarer med fejlen under processen.

Hvis du har brug for at prøve at placere ordren igen, skal du blot nulstille createdStatus til - None -, og dette vil blive taget i betragtning ved næste jobkørsel.

Valgfrit — Følgende indstillinger er avancerede indstillinger. Standarder er på plads, så ingen handling er nødvendig. Hvis du vil foretage justeringer, skal du følge disse retningslinjer:

Opret faktura ved import

Sat til Yes som standard. Zonos opretter en faktura ved ordreimport. Hvis du vælger at deaktivere denne funktion, skal du oprette din egen faktura, og Zonos sætter et fraud review hold til status zonos_hold. Når svindelen er ophævet, vender vi tilbage til den tidligere status.

Kundelogin

Sat til No som standard. Hvis du vil kræve en konto til Checkout, skal du skifte til Yes. Du skal også gå til Customer configuration > Login options og opdatere Redirect Customer to Account Dashboard after Logging In til No.

SFCC ordreeksport

Hvis du bruger eller planlægger at bruge SFCC Order Export, skal du sikre, at Zonos brugerdefinerede attributter tildelt Order- og Product-objekterne er inkluderet i dine SFCC ordreeksportfiler. Fra Merchant Tools > Site Preferences > Orders skal du indstille ordreeksport schema-versionen til den nyeste version.

Nu hvor du har konfigureret din konto og din app, er du klar til at teste din integration. Du skal aktivere Checkout og Hello i SFCC, mens du tester. Sådan gør du:

1. Gå til Merchant Tools > Site Preferences > Custom Preferences > zonos.
2. Skift Zonos Enabled til Yes.

Når du har dine Zonos-kontooplysninger konfigureret i dit websteds brugerdefinerede webstedspræferencer, og Zonos Enabled funktionsomskifteren sat til YES, kan du teste Zonos-funktioner på din butiksfacade ved at tilføje følgende parameter til dit websteds URL: zCountry=[country code of a country you have enabled in your Zonos Dashboard]

Hvis du f.eks. har Canada aktiveret: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Bemærk: Dette er kun nødvendigt til test i ikke-produktionsmiljøer, hvor dit Zonos Public API Token er konfigureret med et test credential token. Når det er konfigureret med dit live/produktions-API-token, er zCountry URL-parameteren hverken nødvendig eller forventet.

Hvis du ikke er klar til at gå live endnu, skal du huske at skifte Zonos Enabled tilbage til No, når du er færdig med at teste. Efter afsluttet test skal du aktivere Zonos ved hjælp af de samme trin ovenfor.

Produktoplysninger kan påvirke mængden af told og skat samt forsendelsesomkostninger. Jo flere produktoplysninger du giver Zonos, jo mere præcist bliver det returnerede tilbud. Zonos kan generere et tilbud, selv når disse oplysninger ikke er tilgængelige, men anbefaler at angive følgende nøgleproduktdetaljer for at forbedre nøjagtigheden:

• Vægt: Vægt påvirker dine forsendelsesomkostninger, hvilket kan påvirke told eller skat. Vægte i dine SFCC-produktlister bruges automatisk af Zonos, når de er til stede.
• Dimensioner: Dimensioner kan påvirke dine forsendelsesomkostninger, hvilket kan påvirke told eller skat. Zonos kan bruge produktdimensioner (længde, bredde og højde) sat på hvert produkt i SFCC, men du skal mappe det i Zonos brugerdefinerede webstedspræferencer for korrekt integration.
• HS-koder: HS-koder påvirker toldsatser og kan nogle gange påvirke skatter. Zonos kan bruge HS-koderne sat i dine produktlister i SFCC, men du skal mappe HS-kodefeltet i Zonos brugerdefinerede webstedspræferencer.
• Oprindelsesland: Et produkts oprindelsesland påvirker toldsatser og kan påvirke skatter. Oprindelseslandet sat i dine SFCC-produktlister bruges automatisk af Zonos, når det er til stede.

Bemærk: Alternativt kan du indtaste oplysningerne i Catalog og tilsidesætte oplysningerne gemt og sendt fra SFCC.

Få mere at vide om produktoplysninger efter platform.