Checkout pour Salesforce Commerce Cloud

Une fois metadata.zip préparé, importez-le dans votre sandbox SFCC :

1. Accédez à Business Manager > Administration > Site Development > Site Import & Export.
2. Téléversez metadata.zip en utilisant l'option de téléversement Local.
3. Après le téléversement, localisez l'archive dans la liste et cliquez sur Import.

Cette étape crée les préférences de site, services, identifiants et objets personnalisés requis utilisés par l'intégration Zonos.

Ajoutez la cartouche int_zonos au chemin de cartouches de votre site pour activer ses contrôleurs, scripts et modèles :

1. Accédez à Administration > Sites > Manage Sites > [Your Target Site] > Settings.
2. Insérez int_zonos dans le chemin de cartouches avant la cartouche vitrine SFRA de base (app_storefront_base).

La cartouche inclut 2 Pipelines personnalisés auxquels des alias de pipeline doivent être ajoutés dans Business Manager :

Zonos-OrderConfirmation

Ceci est utilisé pour la confirmation de commande personnalisée dans SFCC une fois la commande finalisée dans le checkout Zonos. L'utilisateur sera redirigé ici. Par exemple, l'alias pourrait être zonos-order-confirmation. Veuillez sélectionner et ajouter un alias approprié pour votre entreprise, différent de l'alias utilisé pour la page de confirmation de commande native SFCC/SFRA (COSummary-Submit).

Zonos-PlaceSFCCOrder

Ceci est utilisé pour le point de terminaison personnalisé permettant de créer la commande Zonos dans SFCC/SFRA et l'alias supposé est zonos-placesfccorder. Si vous utilisez un alias différent ici, vous devrez le noter lors de la configuration des services. Il ne s'agit pas d'une URL publique, l'utilisation de zonos-placesfccorder est donc recommandée pour la configuration initiale afin de faciliter l'utilisation de cette cartouche.

Pour configurer ces deux alias, dans Business Manager, accédez à Merchant Tools > URL Rules > Pipeline URLs.

Avec l'import de site à l'étape 2, deux services SFCC (avec profils et identifiants associés) ont été créés : zonos.api.graphql et create.order.api.sfra.

Configuration site unique

Si votre organisation ne dispose que d'un seul site vitrine au sein de votre organisation SFCC, il n'y a rien de plus à faire ici et vous pouvez passer à l'étape suivante.

Configuration multi-sites

Si votre organisation dispose de plusieurs sites vitrine, ou prévoit d'en avoir plusieurs, au sein de votre organisation SFCC, vous devrez mettre à jour/ajouter des services SFCC. Lorsque vous avez plusieurs sites SFCC qui utiliseront l'intégration Zonos, vous aurez besoin d'un service API de création de commande pour chaque site. Pour chaque site, procédez comme suit :

1. Créez un nouvel identifiant nommé create.order.api.[siteID].
2. Attribuez l'URL de l'identifiant : https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (par exemple : https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Créez un nouveau service nommé create.order.api.[siteID] et assignez-lui le profil create.order.api et l'identifiant create.order.api.[siteID] que vous avez créé à l'étape 1.

Une fois terminé, vous devriez disposer d'un service API de création de commande pour chacun de vos sites.

Note : Si vous n'avez pas renommé le service create.order.api.sfra original pour en faire le service de création de commande de l'un de vos sites et qu'il existe toujours, vous pouvez le supprimer. Conservez le nom du service zonos.api.graphql tel quel. Même avec plusieurs sites, vous n'aurez besoin que d'un seul service API Zonos.

Dans Business Manager, accédez à Merchant Tools > Site Preferences > Custom Preferences, puis cliquez sur le groupe de préférences zonos pour accéder aux préférences de site personnalisées Zonos.

Définissez les préférences de site suivantes pour votre/vos site(s) :

Pendant Zonos Modal Checkout, les acheteurs sélectionnent des modes d'expédition définis dans votre Zonos Dashboard. Lorsque ces commandes sont importées dans SFCC, leurs modes d'expédition doivent correspondre à un mode d'expédition SFCC valide. Pour ce faire :

1. Configurez un ou plusieurs modes d'expédition dans SFCC auxquels vos modes d'expédition Zonos doivent être mappés.
2. Dans la préférence de site personnalisée Zonos Ship Method Mapping décrite ci-dessus, établissez un ou plusieurs mappages de modes d'expédition entre vos modes d'expédition Zonos et vos modes d'expédition SFCC.

Mappage des modes d'expédition

Sous forme d'objet JSON, le mappage des modes d'expédition associe vos modes d'expédition Zonos à vos modes d'expédition SFCC. Ce mappage doit inclure un enregistrement de mappage pour chaque mode d'expédition Zonos potentiel (niveau de service) pouvant être sélectionné dans votre checkout Zonos. Il est fortement recommandé d'inclure également un enregistrement de mappage default qui sera utilisé lorsqu'une commande Zonos est passée avec un mode d'expédition pour lequel aucun mappage vers un mode d'expédition SFCC n'existe, évitant ainsi les échecs en aval causés par l'absence de mode d'expédition dans la commande SFCC.

Le format de l'objet JSON est :

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

Exemple

Supposons que vous ayez activé les niveaux de service suivants dans votre Zonos Dashboard :

Pour diverses raisons (exigences back-office, intégration supplémentaire d'un service d'expédition tiers, etc.), vous pourriez être limité aux modes d'expédition suivants dans SFCC pour votre site :

Lorsqu'une nouvelle commande Zonos est reçue puis placée dans SFCC, le mode d'expédition doit provenir de cette liste.

Pour construire votre mappage, connectez-vous à votre Zonos Dashboard, accédez à Shipping > Manage Rates, puis cliquez sur chacun des Enabled service levels affichés, où vous verrez un affichage similaire à ce qui suit :

Pour chacun, cliquez sur Edit details pour obtenir (ou définir) le code de niveau de service d'expédition Zonos (voir ci-dessous).

Avec le code de niveau de service d'expédition, créez un enregistrement de mappage l'associant au mode d'expédition SFCC que vous souhaitez voir apparaître sur vos commandes SFCC lorsque ce niveau de service d'expédition (mode d'expédition Zonos) est choisi dans le checkout Zonos.

Une fois que vous avez ajouté un enregistrement pour chaque code de niveau de service d'expédition activé, ainsi qu'un mappage de mode d'expédition default, votre objet JSON Zonos Ship Method Mapping devrait ressembler à ceci :

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

Note : Comme il s'agit uniquement d'un mappage des modes d'expédition Zonos vers les modes d'expédition SFCC, il est seulement important d'inclure tous les modes d'expédition Zonos dans le mappage. Il n'est pas nécessaire d'inclure chacun de vos modes d'expédition SFCC dans le mappage.

L'installation inclut deux jobs SFCC pour prendre en charge l'intégration Zonos :

CreateOrdersFromZonos

Ce job recherche les nouvelles références de commande Zonos dans le magasin d'objets personnalisés zonosOrders, récupère les détails complets de la commande depuis Zonos et crée les commandes correspondantes dans SFCC.

Planification : Vous pouvez planifier ce job selon vos besoins métier, mais en général, il devrait être configuré pour s'exécuter à intervalles réguliers, relativement fréquemment (c.-à-d. toutes les 5 à 10 minutes), chaque jour de la semaine.

Paramètres personnalisés : Le job CreateOrdersFromZonos n'inclut aucun paramètre personnalisé.

CreateMissingZonosOrders

Bien que cela devrait être rare, il est possible qu'en raison de circonstances imprévues, des commandes passées dans Zonos n'arrivent pas dans votre instance SFCC via le processus normal. Pour cette raison, nous avons inclus le job CreateMissingZonosOrders. Ce job effectue une vérification croisée entre votre historique de commandes Zonos et SFCC pour identifier et importer les commandes manquantes.

Planification : Vous pouvez planifier ce job selon vos besoins métier, mais vous devriez le planifier pour qu'il s'exécute moins fréquemment que le job CreateOrdersFromZonos. Quelques éléments à considérer lors de la planification de la fréquence d'exécution de ce job :

1. Comme pour tous les jobs, après avoir pris en compte tous les éléments — y compris la charge de traitement/la bande passante et vos besoins métier — vous devriez planifier ce job pour qu'il s'exécute aussi rarement que possible.
2. Comme ce job interrogera toutes les commandes sur une période, les sites à fort volume devraient exécuter ce job plus fréquemment (afin de traiter moins de commandes par exécution), tandis que les sites à faible volume peuvent se contenter d'une fréquence moindre.
3. Notre fréquence de base suggérée pour CreateMissingZonosOrders, que nous pensons adaptée à la plupart des sites, est une fois toutes les 90 minutes.

Paramètres personnalisés : Deux paramètres personnalisés associés à l'étape du job CreateMissingZonosOrders doivent être définis :

1. LookBackHours : Il s'agit du nombre d'heures (à partir du moment où le job s'exécute) en arrière dans le temps pour lesquelles le job doit interroger Zonos à la recherche de commandes manquantes. En fonction de la fréquence planifiée du job, cette valeur doit être au moins égale au temps entre les exécutions du job, et idéalement comporter un chevauchement. Par exemple, si le job est planifié pour s'exécuter toutes les 90 minutes, définissez LookBackHours sur 2 (heures). Valeur par défaut (si aucune valeur n'est définie) : 2
2. OrderSize : Nombre maximum de commandes à récupérer par requête interne à Zonos. Considérez cela comme la taille de page que le job utilise lors de l'interrogation de Zonos pour les commandes. Valeur par défaut (si aucune valeur n'est définie) : 20

Zonos Hello fournit des capacités de localisation côté client telles que la sélection dynamique de la langue, les messages droits/taxes et la conversion de devise inline. Une fois Zonos activé dans les préférences de site, Hello se charge automatiquement sur votre vitrine via le script client Zonos.

Les scripts client Zonos sont ajoutés à l'aide d'un remote include SFCC du point de terminaison Zonos-ClientScriptInclude, situé en bas des modèles overlay suivants :

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

Si votre projet remplace ces modèles dans des cartouches de priorité supérieure, assurez-vous que le remote include est ajouté à vos versions personnalisées :

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

En savoir plus sur Zonos Hello.

Zonos Hello convertit automatiquement les valeurs de prix affichées sur la vitrine dans la devise locale de l'acheteur. Pour que cela fonctionne correctement :

1. Les valeurs de prix doivent être encapsulées dans des éléments HTML utilisant des noms de classe ou des ID sélectionnables via jQuery. Par exemple : <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Ces valeurs de sélecteur doivent être incluses dans la préférence de site Currency Element Selector (ou dans votre Zonos Dashboard).

Modifications du code d'affichage des prix

La cartouche Zonos inclut les modèles overlay suivants pour les emplacements où les prix sont rendus sur le site d'architecture de référence, utilisant les noms de classe zonos-list-price, zonos-sales-price et zonos-price assignés aux éléments HTML contenant ces différents prix :

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

S'il n'y a pas de cartouches contenant ces modèles et configurées au-dessus de int_zonos dans le chemin de cartouches, aucune modification de code n'est nécessaire pour que Zonos Hello convertisse les devises de ces affichages de prix sur votre site. Si vous avez des versions personnalisées de ces modèles dans une ou plusieurs cartouches au-dessus de int_zonos dans le chemin de cartouches, vous devrez inclure un nom de classe unique aux wrappers HTML autour de vos prix (comme illustré ci-dessus) dans ces modèles personnalisés.

Configuration de la chaîne de sélecteur d'éléments de prix

La chaîne de sélecteur de devise est une valeur de chaîne de sélecteur de style jQuery utilisée par le script Zonos pour identifier les éléments HTML contenant des valeurs de prix qui doivent recevoir des mises à jour de conversion de devise. Cette valeur doit être une liste délimitée par des espaces des noms de classe CSS et/ou des ID assignés aux éléments HTML encapsulant les affichages de prix de votre site décrits à l'étape précédente, où les noms de classe sont préfixés par . et les ID par # (sans les guillemets). Par exemple, si votre site utilisera les modèles d'affichage de prix inclus dans la cartouche Zonos, la chaîne de sélecteur sera .zonos-list-price .zonos-sales-price .zonos-price (sans les guillemets).

La chaîne de sélecteur de devise peut être configurée via votre Zonos Dashboard ou dans la préférence de site Currency Element Selector de vos préférences de site personnalisées Zonos dans Business Manager.

Note : Si configuré aux deux endroits, la valeur dans Business Manager aura la priorité.

En savoir plus sur la conversion de devise Zonos Hello.

La chaîne de sélecteur du bouton de paiement est une valeur de chaîne de sélecteur jQuery utilisée par le script Zonos pour identifier les éléments HTML de votre site qui servent de contrôles de bouton et qui, lorsqu'ils sont cliqués, mènent le client dans le flux de paiement de votre site.

Lorsque les acheteurs cliquent sur un bouton Checkout correspondant à votre chaîne de sélecteur configurée, Zonos intercepte automatiquement l'action et ouvre le checkout modal.

La chaîne de sélecteur du bouton de paiement peut être configurée via votre Zonos Dashboard ou dans la préférence de site Place Order (Checkout) Button Selector de vos préférences de site personnalisées Zonos dans Business Manager.

Lorsque l'utilisateur finalise une commande dans le checkout hébergé Zonos, il est redirigé vers un Pipeline personnalisé qui affiche une confirmation de commande dans SFCC (Zonos-OrderConfirmation). Le modèle de rendu principal pour cette confirmation de commande est /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Cette page de confirmation de commande utilise le même style que la page de confirmation de commande native SFCC/SFRA et partage certains fichiers .isml avec la page de confirmation de commande native SFCC/SFRA. Des mises à jour de style peuvent être nécessaires pour correspondre aux mises à jour de style personnalisées déjà apportées au site. Les modèles de rendu de base utilisés par le modèle de confirmation de commande Zonos incluent :

• 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

La fonction sous-jacente liée à ce pipeline personnalisé, en dehors de l'affichage d'une confirmation de commande à l'utilisateur, est liée à un nouveau type d'objet personnalisé inclus dans l'import de données, zonosOrders. Lorsque la confirmation de commande s'affiche pour l'utilisateur, SFCC utilise l'id de commande Zonos affiché dans l'url de la confirmation de commande et crée un objet personnalisé correspondant avec l'ID de commande Zonos comme Key Attribute pour l'objet personnalisé. Celui-ci est ensuite utilisé pour placer la commande dans SFCC via le job CreateOrdersFromZonos. Ce job parcourra tous les objets personnalisés de type zonosOrders avec createdStatus = - None -. Le job effectuera quelques tâches :

1. Interroger Zonos pour les détails de la commande.
2. Utiliser cette réponse pour créer la commande dans SFCC en fonction des paramètres configurés dans les préférences de site pour le mode d'expédition et le mode de paiement + les détails des articles, de l'expédition, de la facturation et du client dans la réponse.
3. Mettre à jour Zonos avec le numéro de commande SFCC via une mutation pour l'associer au numéro de commande Zonos dans Zonos Dashboard.

Si les étapes ci-dessus réussissent, l'attribut d'objet personnalisé createdStatus sera défini sur created pour retirer l'objet des considérations futures. Si les étapes ci-dessus échouent, l'attribut d'objet personnalisé createdStatus sera défini sur failed et un message d'erreur sera noté dans l'objet dans l'attribut errorResponse (Zonos) ou sfccErrorResponse (SFCC) selon le système ayant renvoyé l'erreur pendant le processus.

Si vous devez réessayer de placer la commande, réinitialisez simplement createdStatus sur - None - et cela sera pris en compte lors de la prochaine exécution du job.

Facultatif — Les paramètres suivants sont des paramètres avancés. Des valeurs par défaut sont en place, aucune action n'est donc nécessaire. Si vous souhaitez apporter des ajustements, suivez ces directives :

Create invoice on import

Défini sur Yes par défaut. Zonos créera une facture lors de l'importation de la commande. Si vous choisissez de désactiver cette fonctionnalité, vous devrez créer votre propre facture, et Zonos définira une suspension de révision de fraude au statut zonos_hold. Une fois la fraude levée, nous reviendrons au statut précédent.

Customer login

Défini sur No par défaut. Si vous souhaitez exiger un compte pour le paiement, passez à Yes. Vous devrez également accéder à Customer configuration > Login options et mettre à jour Redirect Customer to Account Dashboard after Logging In sur No.

SFCC order export

Si vous utilisez ou prévoyez d'utiliser l'export de commandes SFCC, assurez-vous que les attributs personnalisés Zonos assignés aux objets Order et Product sont inclus dans vos fichiers d'export de commandes SFCC. Depuis Merchant Tools > Site Preferences > Orders, définissez la version du schéma d'export de commandes sur la dernière version.

Maintenant que vous avez configuré votre compte et votre application, vous êtes prêt à tester votre intégration. Vous devrez activer Checkout et Hello dans SFCC pendant les tests. Pour ce faire :

1. Accédez à Merchant Tools > Site Preferences > Custom Preferences > zonos.
2. Passez Zonos Enabled à Yes.

Une fois vos informations de compte Zonos configurées dans les préférences de site personnalisées de votre site et l'interrupteur de fonctionnalité Zonos Enabled défini sur YES, vous pouvez tester les fonctionnalités Zonos sur votre vitrine en ajoutant le paramètre suivant à l'URL de votre site : zCountry=[code pays d'un pays que vous avez activé dans votre Zonos Dashboard]

Par exemple, si vous avez activé le Canada : https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA

Note : Ceci n'est nécessaire que pour les tests dans des environnements non production, où votre Public API Token Zonos est configuré avec un jeton d'identification test. Lorsqu'il est configuré avec votre jeton API live/production, le paramètre d'URL zCountry n'est ni nécessaire ni attendu.

Si vous n'êtes pas encore prêt à passer en production, n'oubliez pas de repasser Zonos Enabled à No une fois les tests terminés. Après avoir terminé les tests, activez Zonos en utilisant les mêmes étapes ci-dessus.

Les informations produit peuvent avoir un impact sur le montant des droits et taxes dus et sur le coût d'expédition. Plus vous fournissez d'informations produit à Zonos, plus le devis renvoyé sera précis. Zonos peut générer un devis même lorsque ces informations ne sont pas disponibles, mais recommande de fournir les détails produit clés suivants pour améliorer la précision :

• Poids : Le poids impacte votre coût d'expédition, ce qui peut affecter les droits ou taxes. Les poids dans vos fiches produit SFCC sont automatiquement utilisés par Zonos lorsqu'ils sont présents.
• Dimensions : Les dimensions peuvent impacter votre coût d'expédition, ce qui peut affecter les droits ou taxes. Zonos peut utiliser les dimensions produit (longueur, largeur et hauteur) définies sur chaque produit dans SFCC, mais vous devez les mapper dans les préférences de site personnalisées Zonos pour une intégration correcte.
• Codes HS : Les codes HS impactent les taux de droits et peuvent parfois affecter les taxes. Zonos peut utiliser les codes HS définis dans vos fiches produit SFCC, mais vous devez mapper le champ code HS dans les préférences de site personnalisées Zonos.
• Pays d'origine : Le pays d'origine d'un produit impacte les taux de droits et peut affecter les taxes. Le pays d'origine défini dans vos fiches produit SFCC est automatiquement utilisé par Zonos lorsqu'il est présent.

Note : Vous pouvez également saisir les informations dans Catalog, remplaçant les informations stockées et transmises depuis SFCC.

En savoir plus sur les informations produit par plateforme.