Checkout for Salesforce Commerce Cloud

Når metadata.zip er forberedt, importer det til din SFCC-sandkasse:

1. Gå til Business Manager > Administration > Site Development > Site Import & Export.
2. Last opp metadata.zip ved hjelp av Local-opplastingsalternativet.
3. Etter opplasting, finn arkivet i listen og klikk Import.

Dette trinnet oppretter nødvendige områdeinnstillinger, tjenester, legitimasjon og tilpassede objekter som brukes av Zonos-integrasjonen.

Legg til int_zonos-kassetten i områdets kassettbane for å aktivere dens kontrollere, skript og maler:

1. Naviger til Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Sett inn int_zonos i kassettbanen før basen SFRA-butikkkassetten (app_storefront_base).

Det er 2 tilpassede rørledninger som følger med kassetten som skal ha rørledningsaliaser lagt til i Business Manager:

Zonos-OrderConfirmation

Dette brukes for den tilpassede ordrebekreftelsen i SFCC når ordren er fullført innen Zonos checkout. Brukeren vil bli omdirigert her. For eksempel kunne aliaset være zonos-order-confirmation. Velg og legg til et passende alias for virksomheten din som er forskjellig fra aliaset du bruker for den native SFCC/SFRA checkout-ordrebekreftelsessiden (COSummary-Submit).

Zonos-PlaceSFCCOrder

Dette brukes for det tilpassede endepunktet som brukes til å opprette Zonos-ordren i SFCC/SFRA, og det antas at aliaset er zonos-placesfccorder. Hvis du bruker et annet alias her, må du notere dette når du kommer til tjenesteoppsett. Dette er ikke en offentlig URL, så å bruke zonos-placesfccorder anbefales for initialt oppsett for å opprettholde lettheten ved bruk av denne kassetten.

For å konfigurere disse to aliasene, naviger i Business Manager til Merchant Tools > URL Rules > Pipeline URLs.

Med områdeimporten i trinn 2, ble to SFCC-tjenester (med medfølgende profiler og legitimasjon) opprettet: zonos.api.graphql og create.order.api.sfra.

Enkelt områdeoppsett

Hvis organisasjonen din har ett enkelt butikkområde innen din SFCC-organisasjon, er det ingenting ekstra å gjøre her, og du kan fortsette til neste trinn.

Oppsett for flere områder

Hvis organisasjonen din har flere butikkområder, eller planlegger å ha flere butikkområder, innen din SFCC-organisasjon, må du gjøre oppdateringer/tillegg til dine SFCC-tjenester. Når du har flere SFCC-områder som skal bruke Zonos-integrasjonen, trenger du en opprettelses-API-tjeneste for hvert område. For hvert område, gjør følgende:

1. Opprett en ny legitimasjon med navn create.order.api.[siteID].
2. Tildel legitimasjons-URL-en til å være: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (for eksempel: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Opprett en ny tjeneste med navn create.order.api.[siteID] og tildel den create.order.api-profilen og create.order.api.[siteID]-legitimasjonen du opprettet i trinn 1.

Når det er gjort, bør du ha en opprettelses-API-tjeneste for hver av områdene dine.

Merk: Hvis du ikke ga nytt navn til den opprinnelige create.order.api.sfra-tjenesten for å være opprettelsestjenesten for ett av områdene dine, og den eksisterer fortsatt, kan du slette den. La zonos.api.graphql-tjenestenavnet slik det er. Selv med flere områder, trenger du bare én Zonos API-tjeneste.

I Business Manager, naviger til Merchant Tools > Site Preferences > Custom Preferences, og klikk deretter på innstillingsgruppen zonos for å få tilgang til Zonos tilpassede områdeinnstillinger.

Angi følgende områdeinnstillinger for områdene dine:

Under Zonos Modal Checkout velger kjøpere forsendelsesmetoder definert i Zonos Dashboard. Når disse ordrene importeres til SFCC, må deres forsendelsesmetoder samsvare med en gyldig SFCC-forsendelsesmetode. For å støtte dette:

1. Sett opp en eller flere forsendelsesmetoder i SFCC som dine forsendelsesmetoder i Zonos skal kartlegges til.
2. I innstillingen Zonos Ship Method Mapping tilpasset område beskrevet ovenfor, etabler en eller flere kartlegginger av forsendelsesmetode mellom dine Zonos forsendelsesmetoder og dine SFCC forsendelsesmetoder.

Ship Method Mapping

I form av et JSON-objekt kartlegger denne forsendelsesmetodekartleggingen dine Zonos-forsendelsesmetoder til dine SFCC-forsendelsesmetoder. Denne kartleggingen må ha en kartleggingspost for hver potensiell Zonos forsendelsesmetode (servicenivå) som kan velges i din Zonos checkout. Det anbefales på det sterkeste at du også inkluderer en default-kartleggingspost som skal brukes i tilfeller der en Zonos-ordre er plassert med en forsendelsesmetode som det ikke finnes en kartlegging til en SFCC-forsendelsesmetode, og dermed forhindrer nedstrøms feil forårsaket av mangel på 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

Anta at du har aktivert følgende servicenivåer i Zonos Dashboard:

Uansett din grunn (dvs. backoffice-krav, en tilleggs tredjeparts forsendelsestjenesteintegrasjon osv.), kan du være begrenset til følgende forsendelsesmetoder i SFCC for området ditt:

Når en ny Zonos-ordre mottas og deretter plasseres i SFCC, må forsendelsesmetoden være fra denne listen.

For å bygge kartleggingen din, logg inn på Zonos Dashboard, gå til Shipping > Manage Rates, og klikk deretter på hver av de viste Enabled service levels, der du vil se en visning som ligner på følgende:

I hver, klikk på Edit details for å få (eller angi) Zonos forsendelsestjenestens nivåkode (se nedenfor).

Med forsendelsestjenestens nivåkode, opprett en kartleggingspost som kartlegger den til SFCC-forsendelsesmetoden du ønsker skal vises på dine SFCC-ordrer når det forsendelsestjenestens nivå (Zonos forsendelsesmetode) velges i Zonos checkout.

Når du har lagt til en post for hver aktivert forsendelsestjeneste nivåkode, samt en default-forsendelsesmethodekartlegging, bør Zonos Ship Method Mapping JSON-objektet ditt se omtrent slik ut:

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

Merk: Fordi dette bare er en kartlegging av Zonos forsendelsesmetoder til SFCC forsendelsesmetoder, er det bare viktig å ha alle Zonos forsendelsesmetodene inkludert i kartleggingen. Det er ingen grunn til å ha hver av dine SFCC forsendelsesmetoder inkludert i kartleggingen.

Inkludert i installasjonen er to SFCC-jobber for å støtte Zonos-integrasjonen:

CreateOrdersFromZonos

Denne jobben ser etter nyopprettede Zonos-ordreferanser i det zonosOrders tilpassede objektlageret, henter fullstendige ordredetaljer fra Zonos, og oppretter korresponderende ordrer i SFCC.

Tidsplan: Du kan planlegge denne jobben for å imøtekomme dine forretningsbehov, men vanligvis bør denne jobben konfigureres til å kjøre på grunnlag av intervall, relativt hyppig (dvs. hver 5-10 minutter), og hver dag i uken.

Tilpassede parametere: CreateOrdersFromZonos-jobben inkluderer ikke tilpassede parametere.

CreateMissingZonosOrders

Selv om det skal være sjeldent, er det mulig at det, på grunn av uforutsette omstendigheter, kan være ordrer som er plassert i Zonos som ikke kommer inn i SFCC-instansen din via normal prosess. Av denne grunn har vi inkludert CreateMissingZonosOrders-jobben. Denne jobben utfører en krysskontroll mellom Zonos-ordrehistorikken din og SFCC for å identifisere og importere manglende ordrer.

Tidsplan: Du kan planlegge denne jobben for å imøtekomme dine forretningsbehov, men du bør planlegge denne jobben til å kjøre mindre hyppig enn CreateOrdersFromZonos-jobben. Noen ting å vurdere når du planlegger frekvensen for denne jobben til å kjøre:

1. Som det er tilfelle med alle jobber, etter at alt er vurdert – inkludert behandlingsbelastning/båndbredde og dine forretningsbehov – bør du planlegge denne jobben til å kjøre så sjeldent som du føler du kan.
2. Siden denne jobben vil spørre alle ordrer over en tidsperiode, bør høyvolumsider kjøre denne jobben hyppigere (så færre ordrer behandlet per jobkjøring), mens sider med lavere volum kan klare seg med mindre frekvens.
3. Vår grunnlinjeforeslåtte frekvens for CreateMissingZonosOrders, som vi tror vil fungere for de fleste sider, er en gang hver 90. minutt.

Tilpassede parametere: Det er to tilpassede parametere som er knyttet til CreateMissingZonosOrders-jobbtrinnet som du bør angi:

1. LookBackHours: Dette er antall timer (fra tidspunktet jobben kjøres) tilbake i tid som jobben skal søke i Zonos etter manglende ordrer. Basert på din planlagte frekvens for jobben, bør denne verdien være minst lik tiden mellom jobkjøringer, og ideelt sett bør ha overlapping. For eksempel, hvis jobben er planlagt til å kjøre hver 90. minutt, sett LookBackHours til 2 (timer). Standardverdi (hvis ingen verdi er angitt): 2
2. OrderSize: Maksimalt antall ordrer som skal hentes per intern spørring av Zonos. Tenk på dette som sidestørrelsen jobben bruker når den spør Zonos for ordrer. Standardverdi (hvis ingen verdi er angitt): 20

Zonos Hello gir lokalisering på klientsiden, for eksempel dynamisk språkvalg, told-/avgiftsmeldinger og innebygd valutakonvertering. Når Zonos er aktivert i områdeinnstillinger, lastes Hello automatisk inn på butikken din via Zonos-klientskriptet.

Zonos-klientskriptene legges til ved å bruke en SFCC-fjerninkludering av Zonos-ClientScriptInclude-endepunktet, plassert nederst i følgende overlaymaler:

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

Hvis prosjektet ditt overstyrer disse malene i høyere prioritet kassetter, sikrer du at fjerninkluderingen legges til i dine tilpassede versjoner:

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

Lær mer om Zonos Hello.

Zonos Hello konverterer automatisk prissverdier som vises på butikken til kjøperens lokale valuta. For at dette skal fungere korrekt:

1. Prisverdier må være innpakket i HTML-elementer ved hjelp av klassesnavn eller IDer som kan velges via jQuery. For eksempel: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Disse velgerverdiene må inkluderes i områdeinnstillingen Currency Element Selector (eller i Zonos Dashboard).

Endringer i kode for prisvisning

Zonos-kassetten inkluderer følgende overlaymaler for hvor priser gjengis gjennom hele referansearkkitekturbygningen, og bruker klassesnavn zonos-list-price, zonos-sales-price, og zonos-price tildelt til HTML-elementene som inneholder disse ulike prisene:

• /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 det ikke finnes kassetter som inneholder disse malene og som er konfigurert høyere enn int_zonos i kassettbanen, er det ikke nødvendig med kodeendringer for at Zonos Hello skal konvertere valutaene til disse prisgjengivelsene på siden din. Hvis du har tilpasset versjoner av disse malene i en eller flere kassetter høyere enn int_zonos i kassettbanen, må du inkludere et unikt klassenavn til HTML-omsluttelsen rundt prisene dine (som illustrert ovenfor) i disse tilpassede malene.

Konfigurere velgerstrengen for priselementer

Valutavalgerstrengen er en jQuery-stil velgerstringverdi som brukes av Zonos-skriptet for å identifisere HTML-elementer som inneholder prisverdier som skal motta valutakonverteringsoppdateringer. Denne verdien bør være en mellomromsavgrenset liste over klassesnavn og/eller IDer som er tildelt HTML-elementene som omslutter områdets prisgjengivelser som beskrevet i forrige trinn, der klassesnavn har prefikset . og IDer har prefikset # (uten anførselstegnene). For eksempel, hvis området ditt vil bruke malene for prisvisning som er inkludert i Zonos-kassetten, vil velgerstrengen være .zonos-list-price .zonos-sales-price .zonos-price (uten anførselstegnene).

Valutavalgerstrengen kan konfigureres enten via Zonos Dashboard eller i områdeinnstillingen Currency Element Selector i dine Zonos tilpassede områdeinnstillinger i Business Manager.

Merk: Hvis konfigurert på begge steder, vil verdien i Business Manager ha forrang.

Lær mer om Zonos Hello valutakonvertering.

Kasseknappvelgerstrengen er en jQuery-velgerstringverdi som brukes av Zonos-skriptet for å identifisere HTML-elementer på siden din som fungerer som knappkontroller som når det klikkes, tar kunden inn i kasseflyten på siden din.

Når kjøpere klikker en Kasseknapp som ble samsvart av din konfigurerte velgerstring, avskjærer Zonos automatisk handlingen og åpner den modale kassen.

Kasseknappvelgerstrengen kan konfigureres enten via Zonos Dashboard eller i områdeinnstillingen Place Order (Checkout) Button Selector i dine Zonos tilpassede områdeinnstillinger i Business Manager.

Når brukeren fullfører en ordre innen Zonos-vertsbasert kasse, blir de omdirigert til en tilpasset rørledning som viser en ordrebekreftelse innen SFCC (Zonos-OrderConfirmation). Primærgjengivelsesmalen for denne ordrebekreftelsen er /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Denne ordrebekreftelsessiden bruker samme stil som den native SFCC/SFRA ordrebekreftelsessiden og deler noen .isml-filer med den native SFCC/SFRA ordrebekreftelsessiden. Dette kan trenge noen stiloppdateringer for å samsvare med egendefinerte stiloppdateringer som allerede er gjort på stedet. Basiske gjengivelsesmaler som brukes av Zonos ordrebekreftelsesmalen 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 funksjonen knyttet til denne tilpassede rørledningen, bortsett fra å vise en ordrebekreftelse til brukeren, er knyttet til en ny tilpasset objekttype som er inkludert i dataimporten, zonosOrders. Når ordrebekreftelsen vises for brukeren, bruker SFCC Zonos ordre-IDen som vises i URL-en for ordrebekreftelsen og oppretter et tilsvarende tilpasset objekt med Zonos ordre-IDen som nøkkelattributt for det tilpassede objektet. Dette brukes deretter til å plassere ordren innen SFCC via jobben CreateOrdersFromZonos. Denne jobben vil gjennomløpe alle tilpassede objekter av type zonosOrders med createdStatus = - None -. Jobben vil utføre noen få oppgaver:

1. Søk i Zonos for ordredetaljer.
2. Bruk dette svaret til å opprette ordren innen SFCC basert på innstillinger som er konfigurert innen områdeprefs for forsendelsesmetode og betalingsmetode + detaljer for varer, forsendelse, fakturering og kunde innen svaret.
3. Oppdater Zonos med SFCC-ordrenummeret via en mutasjon for å knytte dette til Zonos-ordrenummeret i Zonos Dashboard.

Hvis trinnene ovenfor er vellykkede, vil det tilpassede objektattributtet createdStatus bli satt til created for å fjerne objektet fra fremtidig vurdering. Hvis trinnene ovenfor ikke er vellykkede, vil det tilpassede objektattributtet createdStatus bli satt til failed, og en feilmelding vil bli notert innen objektet i attributtet errorResponse (Zonos) eller sfccErrorResponse (SFCC) avhengig av systemet som svarer med feilen under prosessen.

Hvis du trenger å prøve å plassere ordren igjen, bare sett createdStatus tilbake til - None -, og dette vil bli tatt i betraktning i neste jobkjøring.

Valgfritt – Følgende innstillinger er avanserte innstillinger. Standarder er på plass, så ingen handling er nødvendig. Hvis du skulle ønske å gjøre justeringer, følg disse retningslinjene:

Create invoice on import

Sett til Yes som standard. Zonos vil opprette en faktura ved ordrimporten. Hvis du velger å deaktivere denne funksjonen, må du opprette din egen faktura, og Zonos vil sette et svindelgjennomganghold til status zonos_hold. Når svindelen løftes, vil vi gå tilbake til forrige status.

Customer login

Satt til No som standard. Hvis du vil kreve en konto for kassering, bytt til Yes. Du må også gå til Customer configuration > Login options og oppdatere Redirect Customer to Account Dashboard after Logging In til No.

SFCC order export

Hvis du bruker, eller planlegger å bruke, SFCC Order Export, sikrer du at Zonos tilpassede attributter som er tildelt til orden- og produktobjektene, er inkludert i dine SFCC ordreeksportfiler. Fra Merchant Tools > Site Preferences > Orders, sett ordreeksportskjemaversjon til den siste versjonen.

Nå som du har satt opp kontoen din og appen din, er du klar til teste integrasjonen din. Du må aktivere Checkout og Hello i SFCC under testing. For å gjøre det:

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

Når du har ditt Zonos-kontoinformasjon konfigurert i områdets tilpassede områdeinnstillinger, og funksjonsbrytaren Zonos Enabled er satt til YES, kan du teste Zonos-funksjoner på butikken din ved å legge til følgende parameter i områdets URL: zCountry=[country code of a country you have enabled in your Zonos Dashboard]

For eksempel, hvis du har aktivert Canada: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Merk: Dette er bare nødvendig for testing i ikke-produksjonsmiljøer, hvor din Zonos Public API Token er konfigurert med et test-legitimasjonstoken. Når det er konfigurert med din live/produksjons-API-token, er zCountry URL-parameteren ikke nødvendig eller forventet.

Hvis du ikke er klar til å være live ennå, husk å bytte Zonos Enabled tilbake til No når du er ferdig med testingen. Etter å ha fullført testingen, aktiverer du Zonos ved hjelp av de samme trinnene ovenfor.

Produktinformasjon kan påvirke mengden tollavgifter og skatter på grunn og forsendelseskostnaden. Jo mer produktinformasjon du gir til Zonos, desto mer presist vil sitatet som returneres være. Zonos kan generere et tilbud selv når denne informasjonen ikke er tilgjengelig, men anbefaler å gi følgende viktige produktdetaljer for å forbedre nøyaktigheten:

• Vekt: Vekt påvirker forsendelseskostnaden din, som kan påvirke tollavgifter eller skatter. Vekter i SFCC-produktlistene dine brukes automatisk av Zonos når de er til stede.
• Dimensjoner: Dimensjoner kan påvirke forsendelseskostnaden din, som kan påvirke tollavgifter eller skatter. Zonos kan bruke produktdimensjoner (lengde, bredde og høyde) satt på hvert produkt i SFCC, men du må kartlegge det i de Zonos tilpassede områdeinnstillingene for riktig integrasjon.
• HS-koder: HS-koder påvirker tollsatser og kan noen ganger påvirke skatter. Zonos kan bruke HS-kodene som er satt i produktlistene dine i SFCC, men du må kartlegge HS-kodefeltet i de Zonos tilpassede områdeinnstillingene.
• Opprinnelsesland: Et produkts opprinnelsesland påvirker tollsatser og kan påvirke skatter. Opprinnelseslandet satt i SFCC-produktlistene dine brukes automatisk av Zonos når det er til stede.

Merk: Alternativt kan du legge inn informasjonen i Catalog, og overstyre informasjonen som er lagret og sendt fra SFCC.

Lær mer om produktinformasjon etter plattform.