Checkout für Salesforce Commerce Cloud

Sobald metadata.zip vorbereitet ist, importieren Sie es in Ihre SFCC-Sandbox:

1. Gehen Sie zu Business Manager > Administration > Site Development > Site Import & Export.
2. Laden Sie metadata.zip mit der Upload-Option Local hoch.
3. Suchen Sie das Archiv nach dem Upload in der Liste und klicken Sie auf Import.

Dieser Schritt erstellt erforderliche Site-Präferenzen, Services, Zugangsdaten und benutzerdefinierte Objekte, die von der Zonos-Integration verwendet werden.

Fügen Sie die Cartridge int_zonos zum Cartridge-Pfad Ihrer Site hinzu, um ihre Controller, Skripte und Templates zu aktivieren:

1. Navigieren Sie zu Administration > Sites > Manage Sites > [Ihre Ziel-Site] > Settings.
2. Fügen Sie int_zonos in den Cartridge-Pfad vor der SFRA-Basis-Storefront-Cartridge (app_storefront_base) ein.

Es gibt 2 benutzerdefinierte Pipelines in der Cartridge, für die Pipeline-Aliase in Business Manager hinzugefügt werden sollten:

Zonos-OrderConfirmation

Dies wird für die benutzerdefinierte Bestellbestätigung in SFCC verwendet, sobald die Bestellung im Zonos-Checkout abgeschlossen ist. Der Nutzer wird hierher weitergeleitet. Der Alias könnte beispielsweise zonos-order-confirmation lauten. Wählen und fügen Sie einen passenden Alias für Ihr Unternehmen hinzu, der sich vom Alias unterscheidet, den Sie für die native SFCC/SFRA-Checkout-Bestellbestätigungsseite (COSummary-Submit) verwenden.

Zonos-PlaceSFCCOrder

Dies wird für den benutzerdefinierten Endpunkt verwendet, um die Zonos-Bestellung in SFCC/SFRA zu erstellen, und es wird angenommen, dass der Alias zonos-placesfccorder lautet. Wenn Sie hier einen anderen Alias verwenden, müssen Sie dies bei der Service-Einrichtung notieren. Dies ist keine öffentlich zugängliche URL, daher wird zonos-placesfccorder für die anfängliche Einrichtung empfohlen, um die Nutzung dieser Cartridge zu vereinfachen.

Um diese beiden Aliase zu konfigurieren, navigieren Sie in Business Manager zu Merchant Tools > URL Rules > Pipeline URLs.

Mit dem Site-Import in Schritt 2 wurden zwei SFCC-Services (mit zugehörigen Profilen und Zugangsdaten) erstellt: zonos.api.graphql und create.order.api.sfra.

Einzelne Site-Einrichtung

Wenn Ihre Organisation eine einzelne Storefront-Site in Ihrer SFCC-Organisation hat, ist hier nichts weiter zu tun, und Sie können mit dem nächsten Schritt fortfahren.

Mehrere Sites-Einrichtung

Wenn Ihre Organisation mehrere Storefront-Sites hat oder plant, mehrere Storefront-Sites in Ihrer SFCC-Organisation zu haben, müssen Sie Aktualisierungen/Ergänzungen an Ihren SFCC-Services vornehmen. Wenn Sie mehrere SFCC-Sites haben, die die Zonos-Integration nutzen, benötigen Sie für jede Site einen Create-Order-API-Service. Führen Sie für jede Site Folgendes aus:

1. Erstellen Sie neue Zugangsdaten mit dem Namen create.order.api.[siteID].
2. Weisen Sie der Zugangsdaten-URL zu: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (zum Beispiel: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Erstellen Sie einen neuen Service mit dem Namen create.order.api.[siteID] und weisen Sie ihm das Profil create.order.api und die in Schritt 1 erstellten Zugangsdaten create.order.api.[siteID] zu.

Nach Abschluss sollten Sie für jede Ihrer Sites einen Create-Order-API-Service haben.

Hinweis: Wenn Sie den ursprünglichen Service create.order.api.sfra nicht in den Create-Order-Service für eine Ihrer Sites umbenannt haben und er noch existiert, können Sie ihn löschen. Lassen Sie den Servicenamen zonos.api.graphql unverändert. Auch bei mehreren Sites benötigen Sie nur einen einzigen Zonos-API-Service.

Navigieren Sie in Business Manager zu Merchant Tools > Site Preferences > Custom Preferences und klicken Sie auf die Präferenzgruppe zonos, um auf die benutzerdefinierten Zonos-Site-Präferenzen zuzugreifen.

Legen Sie die folgenden Site-Präferenzen für Ihre Site(s) fest:

Während des modalen Zonos Checkouts wählen Käufer Versandmethoden, die in Ihrem Zonos Dashboard definiert sind. Wenn diese Bestellungen in SFCC importiert werden, müssen ihre Versandmethoden einer gültigen SFCC-Versandmethode entsprechen. Dazu:

1. Richten Sie eine oder mehrere Versandmethoden in SFCC ein, denen Ihre Versandmethoden in Zonos zugeordnet werden sollen.
2. Legen Sie in der oben beschriebenen benutzerdefinierten Site-Präferenz Zonos Ship Method Mapping eine oder mehrere Versandmethoden-Zuordnungen zwischen Ihren Zonos-Versandmethoden und Ihren SFCC-Versandmethoden fest.

Versandmethoden-Zuordnung

In Form eines JSON-Objekts ordnet die Versandmethoden-Zuordnung Ihre Zonos-Versandmethoden Ihren SFCC-Versandmethoden zu. Diese Zuordnung muss einen Zuordnungseintrag für jede potenzielle Zonos-Versandmethode (Service Level) haben, die in Ihrem Zonos-Checkout ausgewählt werden könnte. Es wird dringend empfohlen, auch einen default-Zuordnungseintrag einzuschließen, der in Fällen verwendet wird, in denen eine Zonos-Bestellung mit einer Versandmethode aufgegeben wird, für die keine Zuordnung zu einer SFCC-Versandmethode existiert, um nachgelagerte Fehler durch fehlende Versandmethoden in der SFCC-Bestellung zu vermeiden.

Das Format für das JSON-Objekt ist:

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

Beispiel

Angenommen, Sie haben die folgenden Service Levels in Ihrem Zonos Dashboard aktiviert:

Aus welchem Grund auch immer (z. B. Backoffice-Anforderungen, eine zusätzliche Drittanbieter-Versandservice-Integration usw.) sind Sie möglicherweise auf die folgenden Versandmethoden in SFCC für Ihre Site beschränkt:

Wenn eine neue Zonos-Bestellung empfangen und dann in SFCC platziert wird, muss die Versandmethode aus dieser Liste stammen.

Um Ihre Zuordnung zu erstellen, melden Sie sich in Ihrem Zonos Dashboard an, gehen Sie zu Shipping > Manage Rates und klicken Sie in jedes der angezeigten Enabled service levels, wo Sie eine Anzeige ähnlich der folgenden sehen:

Klicken Sie in jedem auf Edit details, um den Zonos-Versandservice-Level-Code zu erhalten (oder festzulegen) (siehe unten).

Erstellen Sie mit dem Versandservice-Level-Code einen Zuordnungseintrag, der ihn der SFCC-Versandmethode zuordnet, die auf Ihren SFCC-Bestellungen erscheinen soll, wenn dieser Versandservice-Level (Zonos-Versandmethode) im Zonos-Checkout gewählt wird.

Sobald Sie einen Eintrag für jeden aktivierten Versandservice-Level-Code sowie eine default-Versandmethoden-Zuordnung hinzugefügt haben, sollte Ihr JSON-Objekt Zonos Ship Method Mapping etwa so aussehen:

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

Hinweis: Da dies nur eine Zuordnung von Zonos-Versandmethoden zu SFCC-Versandmethoden ist, ist es nur wichtig, alle Zonos-Versandmethoden in der Zuordnung zu haben. Es ist nicht erforderlich, jede Ihrer SFCC-Versandmethoden in der Zuordnung zu haben.

In der Installation sind zwei SFCC-Jobs zur Unterstützung der Zonos-Integration enthalten:

CreateOrdersFromZonos

Dieser Job sucht nach neu erstellten Zonos-Bestellungsreferenzen im benutzerdefinierten Objektspeicher zonosOrders, ruft vollständige Bestelldetails von Zonos ab und erstellt entsprechende Bestellungen in SFCC.

Zeitplan: Sie können diesen Job an Ihre Geschäftsanforderungen anpassen, aber typischerweise sollte dieser Job in regelmäßigen Abständen relativ häufig konfiguriert werden (z. B. alle 5–10 Minuten) und an jedem Wochentag.

Benutzerdefinierte Parameter: Der Job CreateOrdersFromZonos enthält keine benutzerdefinierten Parameter.

CreateMissingZonosOrders

Obwohl es selten vorkommen sollte, ist es möglich, dass aufgrund unvorhergesehener Umstände Bestellungen in Zonos platziert werden, die nicht über den normalen Prozess in Ihre SFCC-Instanz gelangen. Aus diesem Grund haben wir den Job CreateMissingZonosOrders eingefügt. Dieser Job führt einen Abgleich zwischen Ihrem Zonos-Bestellverlauf und SFCC durch, um fehlende Bestellungen zu identifizieren und zu importieren.

Zeitplan: Sie können diesen Job an Ihre Geschäftsanforderungen anpassen, aber Sie sollten diesen Job seltener als den Job CreateOrdersFromZonos planen. Folgendes ist bei der Planung der Häufigkeit zu berücksichtigen:

1. Wie bei allen Jobs sollten Sie diesen Job so selten wie möglich planen, nachdem alle Faktoren berücksichtigt wurden – einschließlich Verarbeitungslast/Bandbreite und Ihrer Geschäftsanforderungen.
2. Da dieser Job alle Bestellungen über einen Zeitraum abfragt, sollten Sites mit hohem Volumen diesen Job häufiger ausführen (damit weniger Bestellungen pro Job-Lauf verarbeitet werden), während Sites mit geringerem Volumen mit geringerer Häufigkeit auskommen können.
3. Unsere Basis-Empfehlung für die Häufigkeit von CreateMissingZonosOrders, die für die meisten Sites funktionieren sollte, ist einmal alle 90 Minuten.

Benutzerdefinierte Parameter: Es gibt zwei benutzerdefinierte Parameter, die mit dem Job-Schritt CreateMissingZonosOrders verbunden sind und die Sie festlegen sollten:

1. LookBackHours: Dies ist die Anzahl der Stunden (ab dem Zeitpunkt, zu dem der Job läuft) zurück in der Zeit, für die der Job Zonos nach fehlenden Bestellungen abfragen soll. Basierend auf Ihrer geplanten Häufigkeit für den Job sollte dieser Wert mindestens der Zeit zwischen Job-Läufen entsprechen und idealerweise eine Überlappung haben. Wenn der Job beispielsweise alle 90 Minuten geplant ist, setzen Sie LookBackHours auf 2 (Stunden). Standardwert (wenn kein Wert gesetzt): 2
2. OrderSize: Maximale Anzahl der Bestellungen, die pro interner Abfrage von Zonos abgerufen werden. Stellen Sie sich das als die Seitengröße vor, die der Job beim Abfragen von Zonos-Bestellungen verwendet. Standardwert (wenn kein Wert gesetzt): 20

Zonos Hello bietet clientseitige Lokalisierungsfunktionen wie dynamische Sprachauswahl, Zoll-/Steuer-Messaging und Inline-Währungsumrechnung. Sobald Zonos in den Site-Präferenzen aktiviert ist, lädt Hello automatisch über das Zonos-Client-Skript in Ihrem Storefront.

Die Zonos-Client-Skripte werden über ein SFCC-Remote-Include des Endpunkts Zonos-ClientScriptInclude hinzugefügt, der sich am Ende der folgenden Overlay-Templates befindet:

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

Wenn Ihr Projekt diese Templates in Cartridges mit höherer Priorität überschreibt, stellen Sie sicher, dass das Remote-Include zu Ihren angepassten Versionen hinzugefügt wird:

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

Mehr erfahren über Zonos Hello.

Zonos Hello rechnet automatisch auf dem Storefront angezeigte Preiswerte in die lokale Währung des Käufers um. Damit dies korrekt funktioniert:

1. Preiswerte müssen in HTML-Elementen mit Klassennamen oder IDs eingebettet sein, die über jQuery ausgewählt werden können. Zum Beispiel: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Diese Selektorwerte müssen in der Site-Präferenz Currency Element Selector (oder in Ihrem Zonos Dashboard) enthalten sein.

Codeänderungen zur Preisanzeige

Die Zonos-Cartridge enthält die folgenden Overlay-Templates für die Darstellung von Preisen auf der Referenzarchitektur-Site, wobei den HTML-Elementen, die diese verschiedenen Preise enthalten, die Klassennamen zonos-list-price, zonos-sales-price und zonos-price zugewiesen werden:

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

Wenn keine Cartridges diese Templates enthalten und höher als int_zonos im Cartridge-Pfad konfiguriert sind, sind keine Codeänderungen erforderlich, damit Zonos Hello die Währungen dieser Preisdarstellungen auf Ihrer Site umrechnet. Wenn Sie angepasste Versionen dieser Templates in einer oder mehreren Cartridges höher als int_zonos im Cartridge-Pfad haben, müssen Sie einen eindeutigen Klassennamen zu den HTML-Wrappern um Ihre Preise hinzufügen (wie oben illustriert) in diesen angepassten Templates.

Konfiguration des Preiselement-Selektor-Strings

Der Währungsselektor-String ist ein jQuery-Style-Selektor-String-Wert, den das Zonos-Skript verwendet, um HTML-Elemente zu identifizieren, die Preiswerte enthalten und Währungsumrechnungs-Updates erhalten sollen. Dieser Wert sollte eine durch Leerzeichen getrennte Liste der CSS-Klassennamen und/oder IDs sein, die den HTML-Elementen zugewiesen sind, die die Preisdarstellungen Ihrer Site aus Schritt zuvor umschließen, wobei Klassennamen mit . und IDs mit # (ohne Anführungszeichen) vorangestellt werden. Wenn Ihre Site beispielsweise die in der Zonos-Cartridge enthaltenen Templates für die Preisanzeige nutzt, lautet der Selektor-String .zonos-list-price .zonos-sales-price .zonos-price (ohne Anführungszeichen).

Der Währungsselektor-String kann entweder über Ihr Zonos Dashboard oder in der Site-Präferenz Currency Element Selector Ihrer benutzerdefinierten Zonos-Site-Präferenzen in Business Manager konfiguriert werden.

Hinweis: Wenn an beiden Stellen konfiguriert, hat der Wert in Business Manager Vorrang.

Mehr erfahren über die Währungsumrechnung von Zonos Hello.

Der Checkout-Schaltflächen-Selektor-String ist ein jQuery-Selektor-String-Wert, den das Zonos-Skript verwendet, um HTML-Elemente auf Ihrer Site zu identifizieren, die als Schaltflächensteuerungen dienen und bei Klick den Kunden in den Checkout-Ablauf Ihrer Site führen.

Wenn Käufer auf eine Checkout-Schaltfläche klicken, die von Ihrem konfigurierten Selektor-String abgeglichen wurde, fängt Zonos die Aktion automatisch ab und öffnet den modalen Checkout.

Der Checkout-Schaltflächen-Selektor-String kann entweder über Ihr Zonos Dashboard oder in der Site-Präferenz Place Order (Checkout) Button Selector Ihrer benutzerdefinierten Zonos-Site-Präferenzen in Business Manager konfiguriert werden.

Wenn der Nutzer eine Bestellung im gehosteten Zonos-Checkout abschließt, wird er zu einer benutzerdefinierten Pipeline weitergeleitet, die eine Bestellbestätigung in SFCC anzeigt (Zonos-OrderConfirmation). Das primäre Rendering-Template für diese Bestellbestätigung ist /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Diese Bestellbestätigungsseite verwendet dasselbe Styling wie die native SFCC/SFRA-Bestellbestätigungsseite und teilt einige .isml-Dateien mit der nativen SFCC/SFRA-Bestellbestätigungsseite. Möglicherweise sind Styling-Updates erforderlich, um an bereits vorgenommene benutzerdefinierte Styling-Updates der Site anzupassen. Basis-Rendering-Templates, die vom Zonos-Bestellbestätigungs-Template verwendet werden, umfassen:

• 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

Die zugrunde liegende Funktion im Zusammenhang mit dieser benutzerdefinierten Pipeline außerhalb der Anzeige einer Bestellbestätigung für den Nutzer betrifft einen neuen benutzerdefinierten Objekttyp, der im Datenimport enthalten ist: zonosOrders. Wenn die Bestellbestätigung für den Nutzer angezeigt wird, verwendet SFCC die in der URL der Bestellbestätigung angezeigte Zonos-Bestell-ID und erstellt ein entsprechendes benutzerdefiniertes Objekt mit der Zonos-Bestell-ID als Schlüsselattribut. Dies wird dann verwendet, um die Bestellung in SFCC über den Job CreateOrdersFromZonos zu platzieren. Dieser Job iteriert durch alle benutzerdefinierten Objekte vom Typ zonosOrders mit createdStatus = - None -. Der Job führt einige Aufgaben aus:

1. Zonos nach Bestelldetails abfragen.
2. Mit dieser Antwort die Bestellung in SFCC erstellen, basierend auf in den Site-Präferenzen konfigurierten Einstellungen für Versandmethode und Zahlungsmethode sowie Details für Artikel, Versand, Abrechnung und Kunde in der Antwort.
3. Zonos mit der SFCC-Bestellnummer über eine Mutation aktualisieren, um diese im Zonos Dashboard mit der Zonos-Bestellnummer zu verknüpfen.

Wenn die obigen Schritte erfolgreich sind, wird das benutzerdefinierte Objektattribut createdStatus auf created gesetzt, um das Objekt aus zukünftiger Berücksichtigung zu entfernen. Wenn die obigen Schritte nicht erfolgreich sind, wird das benutzerdefinierte Objektattribut createdStatus auf failed gesetzt und eine Fehlermeldung im Attribut errorResponse (Zonos) oder sfccErrorResponse (SFCC) notiert, je nachdem, welches System während des Prozesses mit dem Fehler antwortet.

Wenn Sie die Bestellplatzierung erneut versuchen müssen, setzen Sie createdStatus einfach zurück auf - None -, und es wird beim nächsten Job-Lauf berücksichtigt.

Optional—Die folgenden Einstellungen sind erweiterte Einstellungen. Standardwerte sind vorhanden, daher ist keine Aktion erforderlich. Wenn Sie Anpassungen vornehmen möchten, befolgen Sie diese Richtlinien:

Create invoice on import

Standardmäßig auf Yes gesetzt. Zonos erstellt bei dem Bestellimport eine Rechnung. Wenn Sie diese Funktion deaktivieren, müssen Sie Ihre eigene Rechnung erstellen, und Zonos setzt eine Betrugsprüfungssperre auf den Status zonos_hold. Sobald die Betrugsprüfung aufgehoben ist, kehren wir zum vorherigen Status zurück.

Customer login

Standardmäßig auf No gesetzt. Wenn Sie ein Konto für den Checkout verlangen möchten, wechseln Sie zu Yes. Sie müssen außerdem zu Customer configuration > Login options gehen und Redirect Customer to Account Dashboard after Logging In auf No setzen.

SFCC order export

Wenn Sie den SFCC Order Export nutzen oder planen, stellen Sie sicher, dass die Zonos-benutzerdefinierten Attribute, die den Order- und Product-Objekten zugewiesen sind, in Ihren SFCC-Bestellexportdateien enthalten sind. Gehen Sie von Merchant Tools > Site Preferences > Orders und setzen Sie die Bestellexport-Schemaversion auf die neueste Version.

Produktinformationen können die Höhe der fälligen Zölle und Steuern sowie die Versandkosten beeinflussen. Je mehr Produktinformationen Sie Zonos bereitstellen, desto präziser wird das zurückgegebene Angebot. Zonos kann ein Angebot auch erstellen, wenn diese Informationen nicht verfügbar sind, empfiehlt aber die folgenden wichtigen Produktdetails zur Verbesserung der Genauigkeit:

• Gewicht: Das Gewicht beeinflusst Ihre Versandkosten, was Zölle oder Steuern beeinflussen kann. Gewichte in Ihren SFCC-Produktlisten werden von Zonos automatisch verwendet, wenn vorhanden.
• Abmessungen: Abmessungen können Ihre Versandkosten beeinflussen, was Zölle oder Steuern beeinflussen kann. Zonos kann Produktabmessungen (Länge, Breite und Höhe) nutzen, die bei jedem Produkt in SFCC festgelegt sind, aber Sie müssen sie in den benutzerdefinierten Zonos-Site-Präferenzen zuordnen für eine ordnungsgemäße Integration.
• HS-Codes: HS-Codes beeinflussen Zollsätze und können manchmal Steuern beeinflussen. Zonos kann die in Ihren Produktlisten in SFCC festgelegten HS-Codes verwenden, aber Sie müssen das HS-Code-Feld in den benutzerdefinierten Zonos-Site-Präferenzen zuordnen.
• Ursprungsland: Das Ursprungsland eines Produkts beeinflusst Zollsätze und kann Steuern beeinflussen. Das in Ihren SFCC-Produktlisten festgelegte Ursprungsland wird von Zonos automatisch verwendet, wenn vorhanden.

Hinweis: Alternativ können Sie die Informationen in Catalog eingeben und die von SFCC gespeicherten und übergebenen Informationen überschreiben.

Mehr erfahren über Produktinformationen nach Plattform.