Checkout dla Salesforce Commerce Cloud

Po przygotowaniu metadata.zip zaimportuj je do piaskowni SFCC:

1. Przejdź do Business Manager > Administration > Site Development > Site Import & Export.
2. Prześlij metadata.zip korzystając z opcji przesyłania Local.
3. Po przesłaniu zlokalizuj archiwum na liście i kliknij Import.

Ten krok tworzy wymagane preferencje witryny, usługi, poświadczenia i obiekty niestandardowe używane przez integrację Zonos.

Dodaj kartridż int_zonos do ścieżki kartridża Twojej witryny, aby aktywować jego kontrolery, skrypty i szablony:

1. Przejdź do Administration > Sites > Manage Sites > [Twoja docelowa witryna] > Settings.
2. Wstaw int_zonos do ścieżki kartridża przed podstawowym kartridżem witryny SFRA (app_storefront_base).

Kartridż zawiera 2 niestandardowe pipeline, które powinny mieć aliasy pipeline dodane w Business Manager:

Zonos-OrderConfirmation

Jest używany do potwierdzenia niestandardowego zamówienia w SFCC po zakończeniu zamówienia w kasie Zonos. Użytkownik będzie tu przekierowany. Na przykład alias może być zonos-order-confirmation. Wybierz i dodaj odpowiedni alias dla Twojej firmy, który jest inny od aliasu, który używasz dla natywnej strony potwierdzenia zamówienia SFCC/SFRA (COSummary-Submit).

Zonos-PlaceSFCCOrder

Jest używany dla niestandardowego punktu końcowego używanego do utworzenia zamówienia Zonos w SFCC/SFRA i zakłada się, że alias to zonos-placesfccorder. Jeśli używasz innego aliasu tutaj, będziesz musiał to zanotować podczas konfiguracji usługi. To nie jest publicznie dostępny adres URL, dlatego używanie zonos-placesfccorder jest zalecane dla początkowej konfiguracji, aby ułatwić korzystanie z tego kartridża.

Aby skonfigurować te dwa aliasy, w Business Manager przejdź do Merchant Tools > URL Rules > Pipeline URLs.

W wyniku importu witryny w kroku 2 utworzono dwie usługi SFCC (z towarzyszącymi profilami i poświadczeniami): zonos.api.graphql i create.order.api.sfra.

Konfiguracja jednej witryny

Jeśli Twoja organizacja ma jedną witrynę sklepu w Twojej organizacji SFCC, nie ma tutaj nic dodatkowego do zrobienia i możesz przejść do następnego kroku.

Konfiguracja wielu witryn

Jeśli Twoja organizacja ma wiele witryn sklepów lub planuje mieć wiele witryn sklepów w Twojej organizacji SFCC, będziesz musiał dokonać aktualizacji/dodatków usług SFCC. Gdy masz wiele witryn SFCC, które będą korzystać z integracji Zonos, będziesz potrzebować usługi API tworzenia zamówień dla każdej witryny. Dla każdej witryny wykonaj poniższe czynności:

1. Utwórz nowe poświadczenie o nazwie create.order.api.[siteID].
2. Przypisz adres URL poświadczenia na: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (na przykład: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Utwórz nową usługę o nazwie create.order.api.[siteID] i przypisz jej profil create.order.api oraz poświadczenie create.order.api.[siteID], które utworzyłeś w kroku 1.

Po zakończeniu powinieneś mieć usługę API tworzenia zamówień dla każdej z Twoich witryn.

Uwaga: Jeśli nie zmieniłeś nazwy oryginalnej usługi create.order.api.sfra na usługę tworzenia zamówień dla jednej z Twoich witryn i nadal istnieje, możesz ją usunąć. Pozostaw nazwę usługi zonos.api.graphql takiej, jaka jest. Nawet w przypadku wielu witryn będziesz potrzebować tylko jednej usługi Zonos API.

W Business Manager przejdź do Merchant Tools > Site Preferences > Custom Preferences, a następnie kliknij grupę preferencji zonos, aby uzyskać dostęp do niestandardowych preferencji witryny Zonos.

Ustaw następujące preferencje witryny dla swoich witryn:

Podczas kasy w trybie modalnym Zonos kupujący wybierają metody wysyłki zdefiniowane w pulpicie nawigacyjnym Zonos. Gdy te zamówienia są importowane do SFCC, ich metody wysyłki muszą odpowiadać ważnej metodzie wysyłki SFCC. Aby to obsługiwać:

1. Skonfiguruj jedną lub więcej metod wysyłki w SFCC, do której powinny być mapowane Twoje metody wysyłki w Zonos.
2. W niestandardowej preferencji witryny Zonos Ship Method Mapping opisanej powyżej, ustanów jedno lub więcej mapowań metody wysyłki między Twoimi metodami wysyłki Zonos a Twoimi metodami wysyłki SFCC.

Mapowanie metody wysyłki

W formie obiektu JSON mapowanie metody wysyłki mapuje Twoje metody wysyłki Zonos na Twoje metody wysyłki SFCC. To mapowanie musi mieć rekord mapowania dla każdej potencjalnej metody wysyłki Zonos (poziomu usługi), która może zostać wybrana w Twojej kasie Zonos. Jest wysoce zalecane, aby uwzględnić również rekord mapowania default, który będzie używany w przypadkach, gdy zamówienie Zonos zostanie złożone z metodą wysyłki, dla której mapowanie na metodę wysyłki SFCC nie istnieje, zapobiegając w ten sposób niepowodzeniom na etapie wdrażania spowodowanym brakiem metody wysyłki w zamówieniu SFCC.

Format obiektu JSON to:

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

Przykład

Załóżmy, że w pulpicie nawigacyjnym Zonos włączyłeś następujące poziomy usług:

Z jakiegoś powodu (tj. wymagania backoffice, dodatkowa integracja usługi wysyłkowej innej firmy itp.), możesz być ograniczony do następujących metod wysyłki w SFCC dla Twojej witryny:

Gdy nowe zamówienie Zonos zostanie odebrane, a następnie umieszczone w SFCC, metoda wysyłki musi pochodzić z tej listy.

Aby zbudować mapowanie, zaloguj się do pulpitu nawigacyjnego Zonos, przejdź do Shipping > Manage Rates, a następnie kliknij każdy z wyświetlonych Enabled service levels, gdzie zobaczysz ekran podobny do poniższego:

W każdym z nich kliknij Edit details, aby uzyskać (lub ustawić) kod poziomu usługi wysyłkowej Zonos (patrz poniżej).

Mając kod poziomu usługi wysyłkowej, utwórz rekord mapowania, mapując go na metodę wysyłki SFCC, którą chcesz, aby pojawiła się w zamówieniach SFCC, gdy ten poziom usługi wysyłkowej (metoda wysyłki Zonos) zostanie wybrany w kasie Zonos.

Po dodaniu rekordu dla każdego włączonego kodu poziomu usługi wysyłkowej, a także domyślnego mapowania metody wysyłki, Twój obiekt JSON Zonos Ship Method Mapping powinien wyglądać mniej więcej tak:

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

Uwaga: Ponieważ jest to tylko mapowanie metod wysyłki Zonos na metody wysyłki SFCC, jest ważne, aby mieć wszystkie metody wysyłki Zonos zawarte w mapowaniu. Nie jest konieczne posiadanie każdej z Twoich metod wysyłki SFCC zawartej w mapowaniu.

W instalacji znajdują się dwa zadania SFCC wspierające integrację Zonos:

CreateOrdersFromZonos

To zadanie szuka nowo utworzonych odwołań zamówień Zonos w magazynie obiektów niestandardowych zonosOrders, pobiera pełne szczegóły zamówienia z Zonos i tworzy odpowiadające zamówienia w SFCC.

Harmonogram: Możesz zaplanować to zadanie, aby spełnić potrzeby biznesowe, ale zwykle to zadanie powinno być skonfigurowane do uruchomienia w oparciu o interwał, stosunkowo często (tj. co 5-10 minut) i każdego dnia tygodnia.

Parametry niestandardowe: Zadanie CreateOrdersFromZonos nie zawiera żadnych parametrów niestandardowych.

CreateMissingZonosOrders

Chociaż powinno to być rzadkie, możliwe jest, że z powodu nieprzewidzianych okoliczności mogą istnieć zamówienia złożone w Zonos, które nie dotrą do Twojej instancji SFCC zwykłą drogą. Z tego powodu dołączyliśmy zadanie CreateMissingZonosOrders. To zadanie wykonuje sprawdzenie krzyżowe między historią zamówień Zonos a SFCC, aby zidentyfikować i zaimportować wszelkie brakujące zamówienia.

Harmonogram: Możesz zaplanować to zadanie, aby spełnić potrzeby biznesowe, ale powinieneś zaplanować uruchomienie tego zadania rzadziej niż zadanie CreateOrdersFromZonos. Kilka rzeczy do rozważenia przy planowaniu częstotliwości uruchamiania tego zadania:

1. Jak w przypadku wszystkich zadań, biorąc pod uwagę wszystko – w tym obciążenie przetwarzania/przepustowość i potrzeby biznesowe – powinieneś zaplanować uruchomienie tego zadania tak rzadko, jak czujesz, że możesz.
2. Ponieważ to zadanie będzie wysyłać zapytania do wszystkich zamówień w danym okresie, witryny o wysokim wolumenie powinny uruchamiać to zadanie częściej (więc mniej zamówień przetworzonych na uruchomienie zadania), podczas gdy witryny o niższym wolumenie mogą obejść się przy mniejszej częstotliwości.
3. Nasza wstępnie sugerowana częstotliwość dla CreateMissingZonosOrders, którą uważamy za odpowiednią dla większości witryn, to raz co 90 minut.

Parametry niestandardowe: Istnieją dwa parametry niestandardowe powiązane z etapem zadania CreateMissingZonosOrders, które powinieneś ustawić:

1. LookBackHours: Jest to liczba godzin (od czasu uruchomienia zadania) wstecz w czasie, dla której zadanie powinno wysyłać zapytania do Zonos w poszukiwaniu brakujących zamówień. Na podstawie zaplanowanej częstotliwości tego zadania wartość ta powinna być co najmniej równa czasowi między uruchomieniami zadania, a idealnie powinna mieć nakładanie się. Na przykład, jeśli zadanie jest planowane do uruchomienia co 90 minut, ustaw LookBackHours na 2 (godziny). Domyślna wartość (jeśli nie ustawiono żadnej wartości): 2
2. OrderSize: Maksymalna liczba zamówień do pobrania na wewnętrzne zapytanie do Zonos. Pomyśl o tym jako o rozmiarze strony, który zadanie używa podczas wysyłania zapytań do Zonos o zamówienia. Domyślna wartość (jeśli nie ustawiono żadnej wartości): 20

Zonos Hello zapewnia możliwości lokalizacji po stronie klienta, takie jak dynamiczny wybór języka, komunikaty dotyczące cła/podatku i wbudowana konwersja waluty. Po włączeniu Zonos w preferencjach witryny, Hello ładuje się automatycznie na Twojej witrynie za pośrednictwem skryptu klienta Zonos.

Skrypty klienta Zonos są dodawane przy użyciu zdalnego włączenia SFCC punktu końcowego Zonos-ClientScriptInclude, zlokalizowanego na dole następujących szablonów nakładki:

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

Jeśli projekt przesłania te szablony w wyższych priorytetowych kartridżach, upewnij się, że zdalne włączenie jest dodane do Twoich dostosowanych wersji:

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

Dowiedz się więcej o Zonos Hello.

Zonos Hello automatycznie konwertuje wartości cen wyświetlane na Twojej witrynie na lokalną walutę kupującego. Aby to działało prawidłowo:

1. Wartości cen muszą być zawarte w elementach HTML przy użyciu nazw klas lub identyfikatorów, które można wybrać za pośrednictwem jQuery. Na przykład: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Te wartości selektora muszą być uwzględnione w preferencji witryny Currency Element Selector (lub w pulpicie nawigacyjnym Zonos).

Zmiany kodu wyświetlania ceny

Kartridż Zonos zawiera następujące szablony nakładki dla miejsc, w których ceny są renderowane w całej witrynie architektury odniesienia, wykorzystując nazwy klas zonos-list-price, zonos-sales-price i zonos-price przypisane do elementów HTML zawierających te różne ceny:

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

Jeśli nie ma kartridży zawierających te szablony i skonfigurowanych wyżej niż int_zonos w ścieżce kartridża, żadne zmiany kodu nie są konieczne, aby Zonos Hello konwertował waluty tych renderowań cen na Twojej witrynie. Jeśli masz dostosowane wersje tych szablonów w jednym lub więcej kartridżach wyższych niż int_zonos w ścieżce kartridża, musisz dołączyć unikalną nazwę klasy do opakowań HTML wokół Twoich cen (jak pokazano powyżej) w tych dostosowanych szablonach.

Konfigurowanie ciągu selektora elementów ceny

Ciąg selektora waluty to wartość selektora w stylu jQuery używana przez skrypt Zonos do identyfikacji elementów HTML zawierających wartości cen, które powinny otrzymać aktualizacje konwersji waluty. Ta wartość powinna być listą oddzieloną spacją nazw klas CSS i/lub identyfikatorów przypisanych do elementów HTML opakowujących wyświetlacze cen Twojej witryny opisane w poprzednim kroku, gdzie nazwy klas są poprzedzone ., a identyfikatory są poprzedzone # (bez cudzysłowów). Na przykład, jeśli Twoja witryna będzie korzystać z szablonów wyświetlania cen zawartych w kartridżu Zonos, ciąg selektora będzie .zonos-list-price .zonos-sales-price .zonos-price (bez cudzysłowów).

Ciąg selektora waluty można skonfigurować za pośrednictwem pulpitu nawigacyjnego Zonos lub w preferencji witryny Currency Element Selector niestandardowych preferencji witryny Zonos w Business Manager.

Uwaga: Jeśli skonfigurowano w obu miejscach, wartość w Business Manager będzie miała pierwszeństwo.

Dowiedz się więcej o konwersji waluty Zonos Hello.

Ciąg selektora przycisku kasy to wartość selektora jQuery używana przez skrypt Zonos do identyfikacji elementów HTML na Twojej witrynie, które służą jako kontrolki przycisków, które po kliknięciu przenoszą klienta do przepływu kasy Twojej witryny.

Gdy kupujący klikną przycisk kasy, który został dopasowany przez skonfigurowany ciąg selektora, Zonos automatycznie przejmuje akcję i otwiera kaszę modalną.

Ciąg selektora przycisku kasy można skonfigurować za pośrednictwem pulpitu nawigacyjnego Zonos lub w preferencji witryny Place Order (Checkout) Button Selector niestandardowych preferencji witryny Zonos w Business Manager.

Gdy użytkownik ukończy zamówienie w kasie hostowanej Zonos, jest przekierowany do niestandardowego pipeline, który wyświetla potwierdzenie zamówienia w SFCC (Zonos-OrderConfirmation). Główny szablon renderowania dla tego potwierdzenia zamówienia to /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Ta strona potwierdzenia zamówienia wykorzystuje to samo formatowanie co natywna strona potwierdzenia zamówienia SFCC/SFRA i dzieli niektóre pliki .isml z natywną stroną potwierdzenia zamówienia SFCC/SFRA. Może to wymagać niektórych aktualizacji stylów w celu dopasowania do wszelkich niestandardowych aktualizacji stylów już wprowadzonych na witrynie. Szablony renderowania bazowego używane przez szablon potwierdzenia zamówienia Zonos obejmują:

• 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

Funkcja bazowa związana z tym niestandardowym pipeliną poza wyświetlaniem potwierdzenia zamówienia użytkownikowi jest związana z nowym typem obiektu niestandardowego zawartym w imporcie danych, zonosOrders. Gdy potwierdzenie zamówienia wyświetla się dla użytkownika, SFCC używa identyfikatora zamówienia Zonos wyświetlanego w adresie URL dla potwierdzenia zamówienia i tworzy odpowiadający obiekt niestandardowy z identyfikatorem zamówienia Zonos jako atrybutem klucza dla obiektu niestandardowego. Jest to następnie używane do umieszczenia zamówienia w SFCC za pośrednictwem zadania CreateOrdersFromZonos. To zadanie będzie iterować przez wszystkie obiekty niestandardowe typu zonosOrders z createdStatus = - None -. Zadanie będzie wykonywać kilka zadań:

1. Zapytanie Zonos o szczegóły zamówienia.
2. Użyj tej odpowiedzi, aby utworzyć zamówienie w SFCC na podstawie ustawień skonfigurowanych w preferencjach witryny dla metody wysyłki i metody płatności + szczegóły dotyczące przedmiotów, wysyłki, rozliczeń i klienta w odpowiedzi.
3. Zaktualizuj Zonos o numerze zamówienia SFCC za pośrednictwem mutacji, aby skojarzyć to z numerem zamówienia Zonos w pulpicie nawigacyjnym Zonos.

Jeśli powyższe kroki się powiedzie, atrybut obiektu niestandardowego createdStatus będzie następnie ustawiony na created, aby usunąć obiekt z przyszłych rozważań. Jeśli powyższe kroki się nie powiedzie, atrybut obiektu niestandardowego createdStatus będzie następnie ustawiony na failed i wiadomość o błędzie będzie odnotowana w obiekcie w atrybucie errorResponse (Zonos) lub sfccErrorResponse (SFCC) w zależności od systemu odpowiadającego z błędem podczas procesu.

Jeśli musisz ponowić próbę umieszczenia zamówienia, po prostu resetuj createdStatus na - None - i będzie to brane pod uwagę w następnym uruchomieniu zadania.

Opcjonalnie — Poniższe ustawienia to ustawienia zaawansowane. Istnieją ustawienia domyślne, więc nie jest wymagane żadne działanie. Jeśli chciałbyś dokonać dostosowań, postępuj zgodnie z poniższymi wytycznymi:

Utwórz fakturę podczas importu

Domyślnie ustawione na Tak. Zonos będzie tworzyć fakturę po imporcie zamówienia. Jeśli zdecydujesz się wyłączyć tę funkcję, będziesz musiał utworzyć własną fakturę, a Zonos ustawi blokadę przeglądu oszustw na stan zonos_hold. Po usunięciu oszustwa wrócimy do poprzedniego stanu.

Logowanie klienta

Domyślnie ustawione na Nie. Jeśli chcesz wymagać konta do kasy, przełącz na Tak. Będziesz również musiał przejść do Customer configuration > Login options i zaktualizować Redirect Customer to Account Dashboard after Logging In na Nie.

Eksport zamówień SFCC

Jeśli używasz lub planujesz używać eksportu zamówień SFCC, upewnij się, że niestandardowe atrybuty Zonos przypisane do obiektów zamówień i produktów są zawarte w plikach eksportu zamówień SFCC. Z Merchant Tools > Site Preferences > Orders, ustaw wersję schematu eksportu zamówień na najnowszą wersję.

Teraz, gdy skonfigurowałeś swoje konto i aplikację, jesteś gotowy do przetestowania integracji. Podczas testowania będziesz musiał włączyć Checkout i Hello w SFCC. Aby to zrobić:

1. Przejdź do Merchant Tools > Site Preferences > Custom Preferences > zonos.
2. Przełącz Zonos Enabled na Tak.

Po skonfigurowaniu informacji o koncie Zonos w niestandardowych preferencjach witryny oraz ustawieniu przełącznika funkcji Zonos Enabled na Tak, możesz przetestować funkcje Zonos na swojej witrynie, dodając następujący parametr do adresu URL witryny: zCountry=[country code of a country you have enabled in your Zonos Dashboard]

Na przykład, jeśli masz włączoną Kanadę: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Uwaga: Jest to konieczne tylko do testowania w środowiskach nieprodukcyjnych, gdzie publiczny token API Zonos jest skonfigurowany z tokenem poświadczeń testowych. Po skonfigurowaniu za pomocą tokenu API na żywo/produkcyjnym, parametr adresu URL zCountry nie jest konieczny ani oczekiwany.

Jeśli nie jesteś jeszcze gotowy do wdrażania, pamiętaj, aby przełączyć Zonos Enabled z powrotem na Nie po zakończeniu testowania. Po ukończeniu testowania włącz Zonos, korzystając z tych samych kroków.

Informacje o produktach mogą wpłynąć na wysokość należnych ceł i podatków oraz koszt wysyłki. Im więcej informacji o produkcie podasz do Zonos, tym bardziej precyzyjna będzie zwrócona wycena. Zonos może wygenerować wycenę nawet, gdy te informacje są niedostępne, ale zaleca podanie następujących kluczowych szczegółów produktu, aby poprawić dokładność:

• Waga: Waga wpływa na koszt wysyłki, który może wpłynąć na cła lub podatki. Wagi w Twoich listach produktów SFCC są automatycznie używane przez Zonos, gdy są dostępne.
• Wymiary: Wymiary mogą wpłynąć na koszt wysyłki, który może wpłynąć na cła lub podatki. Zonos może wykorzystać wymiary produktu (długość, szerokość i wysokość) ustawione na każdym produkcie w SFCC, ale musisz je mapować w niestandardowych preferencjach witryny Zonos, aby zapewnić prawidłową integrację.
• Kody HS: Kody HS wpływają na stawki celne i czasami mogą wpłynąć na podatki. Zonos może używać kodów HS ustawionych w Twoich listach produktów w SFCC, ale musisz mapować pole kodu HS w niestandardowych preferencjach witryny Zonos.
• Kraj pochodzenia: Kraj pochodzenia produktu wpływa na stawki celne i może wpłynąć na podatki. Kraj pochodzenia ustawiony w Twoich listach produktów SFCC jest automatycznie używany przez Zonos, gdy jest dostępny.

Uwaga: Alternatywnie możesz wpisać informacje do katalogu, zastępując przechowywane informacje i przesyłane z SFCC.

Dowiedz się więcej o informacjach o produktach według platformy.