Checkout для Salesforce Commerce Cloud

После того как metadata.zip подготовлен, импортируйте его в вашу песочницу SFCC:

1. Перейдите на Business Manager > Administration > Site Development > Site Import & Export.
2. Загрузите metadata.zip, используя опцию загрузки Local.
3. После загрузки найдите архив в списке и нажмите Import.

Этот шаг создает необходимые настройки сайта, услуги, учетные данные и пользовательские объекты, используемые интеграцией Zonos.

Добавьте картридж int_zonos в путь картриджа вашего сайта для активации его контроллеров, скриптов и шаблонов:

1. Перейдите на Administration > Sites > Manage Sites > [Ваш целевой сайт] > Settings.
2. Вставьте int_zonos в путь картриджа перед основным картриджем витрины SFRA (app_storefront_base).

Два пользовательских конвейера включены с картриджем, которые должны иметь добавленные псевдонимы конвейера в Business Manager:

Zonos-OrderConfirmation

Это используется для пользовательского подтверждения заказа в SFCC после завершения заказа в checkout Zonos. Пользователь будет перенаправлен здесь. Например, псевдоним может быть zonos-order-confirmation. Пожалуйста, выберите и добавьте соответствующий псевдоним для вашего бизнеса, отличающийся от псевдонима, который вы используете для страницы подтверждения собственного заказа SFCC/SFRA (COSummary-Submit).

Zonos-PlaceSFCCOrder

Это используется для пользовательской конечной точки, используемой для создания заказа Zonos в SFCC/SFRA, и предполагается, что псевдоним zonos-placesfccorder. Если вы используете другой псевдоним здесь, вам нужно будет отметить это при настройке услуги. Это не публичный URL-адрес, поэтому использование zonos-placesfccorder рекомендуется для первоначальной настройки для облегчения использования этого картриджа.

Чтобы настроить эти два псевдонима, в Business Manager перейдите на Merchant Tools > URL Rules > Pipeline URLs.

С импортом сайта на шаге 2 были созданы две услуги SFCC (с сопровождающими профилями и учетными данными): zonos.api.graphql и create.order.api.sfra.

Установка с одним сайтом

Если ваша организация имеет один сайт витрины в вашей организации SFCC, здесь больше ничего делать не нужно, и вы можете переходить к следующему шагу.

Установка с несколькими сайтами

Если ваша организация имеет несколько сайтов витрины или планирует иметь несколько сайтов витрины в вашей организации SFCC, вам нужно будет сделать обновления/добавления к вашим услугам SFCC. Если у вас есть несколько сайтов SFCC, которые будут использовать интеграцию Zonos, вам потребуется служба создания API заказов для каждого сайта. Для каждого сайта выполните следующее:

1. Создайте новые учетные данные с именем create.order.api.[siteID].
2. Назначьте URL учетных данных: https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder (например: https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).
3. Создайте новую услугу с именем create.order.api.[siteID] и назначьте ей профиль create.order.api и учетные данные create.order.api.[siteID], которые вы создали на шаге 1.

После завершения у вас должна быть служба создания API заказов для каждого из ваших сайтов.

Примечание: Если вы не переименовали исходную услугу create.order.api.sfra в службу создания заказов для одного из ваших сайтов, и она все еще существует, вы можете удалить ее. Оставьте имя услуги zonos.api.graphql как оно есть. Даже при наличии нескольких сайтов вам понадобится только одна служба API Zonos.

В Business Manager перейдите на Merchant Tools > Site Preferences > Custom Preferences, затем нажмите на группу настроек zonos для доступа к пользовательским настройкам сайта Zonos.

Установите следующие предпочтения сайта для вашего сайта(сайтов):

Во время модального checkout Zonos покупатели выбирают способы доставки, определенные на панели управления Zonos. Когда эти заказы импортируются в SFCC, их способы доставки должны соответствовать действительному способу доставки SFCC. Для поддержки этого:

1. Установите один или несколько способов доставки в SFCC, к которым должны быть сопоставлены способы доставки в Zonos.
2. В пользовательском предпочтении сайта Zonos Ship Method Mapping, описанном выше, установите одно или несколько сопоставления способов доставки между вашими способами доставки Zonos и способами доставки SFCC.

Сопоставление способов доставки

В виде объекта JSON сопоставление способа доставки отображает ваши способы доставки Zonos на ваши способы доставки SFCC. Это сопоставление должно иметь запись сопоставления для каждого потенциального способа доставки Zonos (уровня обслуживания), который может быть выбран в вашем checkout Zonos. Рекомендуется очень highly также включить запись сопоставления default, которая будет использоваться в случаях, когда заказ Zonos размещен со способом доставки, для которого сопоставление со способом доставки SFCC не существует, таким образом предотвращая нисходящие сбои, вызванные отсутствием способа доставки в заказе SFCC.

Формат объекта JSON:

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

Пример

Предположим, вы включили следующие уровни обслуживания на панели управления Zonos:

По какой бы то ни было причине (т.е. требования бэк-офиса, дополнительная интеграция службы доставки третьей стороны и т.д.), вы можете быть ограничены следующими способами доставки в SFCC для вашего сайта:

Когда новый заказ Zonos получен и затем размещен в SFCC, способ доставки должен быть из этого списка.

Чтобы построить ваше сопоставление, войдите в панель управления Zonos, перейдите на Shipping > Manage Rates, а затем нажмите на каждый из отображаемых Enabled service levels, где вы увидите отображение, похожее на следующее:

В каждом нажмите на Edit details, чтобы получить (или установить) код уровня обслуживания доставки Zonos (см. ниже).

Используя код услуги доставки, создайте запись сопоставления, отображающую его на способ доставки SFCC, который вы хотите увидеть в заказах SFCC, когда этот уровень обслуживания доставки (способ доставки Zonos) выбран в checkout Zonos.

Как только вы добавили запись для каждого кода включенного уровня обслуживания доставки, а также сопоставление способа доставки default, ваш объект JSON Zonos Ship Method Mapping должен выглядеть примерно так:

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

Примечание: Поскольку это только сопоставление методов доставки Zonos с методами доставки SFCC, важно только иметь все методы доставки Zonos, включенные в сопоставление. Нет необходимости иметь каждый из ваших методов доставки SFCC, включенных в сопоставление.

Включены два задания SFCC для поддержки интеграции Zonos:

CreateOrdersFromZonos

Это задание ищет вновь созданные ссылки на заказы Zonos в хранилище пользовательских объектов zonosOrders, получает полные детали заказа из Zonos и создает соответствующие заказы в SFCC.

График: Вы можете запланировать это задание в соответствии с потребностями вашего бизнеса, но обычно это задание должно быть настроено на периодический запуск, относительно часто (т.е. каждые 5-10 минут), и каждый день недели.

Пользовательские параметры: задание CreateOrdersFromZonos не включает никакие пользовательские параметры.

CreateMissingZonosOrders

Хотя это должно быть редко, возможно, что из-за непредвиденных обстоятельств, могут быть заказы размещены в Zonos, которые не доходят до вашего экземпляра SFCC через обычный процесс. По этой причине мы включили задание CreateMissingZonosOrders. Это задание выполняет перекрестную проверку между историей заказов Zonos и SFCC для выявления и импорта любых отсутствующих заказов.

График: Вы можете запланировать это задание в соответствии с потребностями вашего бизнеса, но вы должны запланировать это задание на запуск менее часто, чем задание CreateOrdersFromZonos. Некоторые вещи, которые следует учитывать при планировании частоты запуска этого задания:

1. Как и в случае со всеми заданиями, после рассмотрения всего, включая нагрузку обработки/пропускную способность и потребности вашего бизнеса, вы должны запланировать это задание на запуск как можно реже, как вы чувствуете.
2. Поскольку это задание будет запрашивать все заказы за период времени, сайты с высоким объемом должны запускать это задание чаще (поэтому меньше заказов обработано за запуск задания), тогда как сайты с низким объемом могут справиться с меньшей частотой.
3. Наша базовая предлагаемая частота для CreateMissingZonosOrders, которую мы считаем подходящей для большинства сайтов, — один раз в 90 минут.

Пользовательские параметры: Есть два пользовательских параметра, связанных с этапом задания CreateMissingZonosOrders, которые вы должны установить:

1. LookBackHours: Это количество часов (от времени запуска задания) в прошлое, за которое задание должно запрашивать Zonos, ища недостающие заказы. На основе вашей запланированной частоты для задания это значение должно быть как минимум равно времени между запусками заданий и в идеале должно иметь перекрытие. Например, если задание запланировано на запуск каждые 90 минут, установите LookBackHours на 2 (часа). Значение по умолчанию (если значение не установлено): 2
2. OrderSize: Максимальное количество заказов для получения за внутренний запрос Zonos. Думайте об этом как о размере страницы, который использует задание при запросе заказов из Zonos. Значение по умолчанию (если значение не установлено): 20

Zonos Hello предоставляет возможности локализации на стороне клиента, такие как динамический выбор языка, сообщения о пошлинах/налогах и встроенное преобразование валюты. После включения Zonos в настройки сайта, Hello автоматически загружается на вашей витрине через скрипт клиента Zonos.

Скрипты клиента Zonos добавляются с использованием удаленного включения SFCC конечной точки Zonos-ClientScriptInclude, расположенной в нижней части следующих шаблонов наложения:

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

Если ваш проект переопределяет эти шаблоны в картриджах с более высоким приоритетом, убедитесь, что удаленное включение добавлено к вашим настроенным версиям:

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

Узнайте больше о Zonos Hello.

Zonos Hello автоматически преобразует значения цен, отображаемые на витрине, в местную валюту покупателя. Чтобы это работало правильно:

1. Значения цен должны быть обернуты в элементы HTML, используя имена классов или ID, которые могут быть выбраны через jQuery. Например: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
2. Эти значения селектора должны быть включены в предпочтение сайта Currency Element Selector (или на панели управления Zonos).

Изменения кода отображения цен

Картридж Zonos включает следующие шаблоны наложения для мест, где цены отображаются по всему архитектурному сайту ссылок, используя имена классов zonos-list-price, zonos-sales-price и zonos-price, назначенные элементам HTML, содержащим эти различные цены:

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

Если нет картриджей, содержащих эти шаблоны и настроенные выше int_zonos в пути картриджа, никакие изменения кода не требуются для преобразования валют Hello на вашем сайте. Если у вас есть настроенные версии этих шаблонов в одном или нескольких картриджах выше int_zonos в пути картриджа, вам нужно будет включить уникальное имя класса оборачивающим элементам HTML вокруг ваших цен (как показано выше) в эти настроенные шаблоны.

Настройка строки селектора элементов цены

Строка селектора валюты — это значение селектора в стиле jQuery, используемое скриптом Zonos для идентификации элементов HTML, содержащих значения цен, которые должны получить обновления преобразования валюты. Это значение должно быть разделенным пробелом списком имен классов CSS и/или ID, назначенных элементам HTML, оборачивающим отображение цен на вашем сайте, описанным в предыдущем шаге, где имена классов имеют префикс . и ID имеют префикс # (без кавычек). Например, если ваш сайт будет использовать шаблоны для отображения цен, включенные в картридж Zonos, строка селектора будет .zonos-list-price .zonos-sales-price .zonos-price (без кавычек).

Строка селектора валюты может быть настроена либо через панель управления Zonos, либо в предпочтении сайта Currency Element Selector пользовательских настроек сайта Zonos в Business Manager.

Примечание: Если настроено в обоих местах, значение в Business Manager будет иметь приоритет.

Узнайте больше о преобразовании валюты Zonos Hello.

Строка селектора кнопки checkout — это значение селектора jQuery, используемое скриптом Zonos для идентификации элементов HTML на вашем сайте, которые служат элементами управления кнопки, которые при нажатии переносят клиента в процесс checkout вашего сайта.

Когда покупатели нажимают кнопку Checkout, которая совпадала с вашей настроенной строкой селектора, Zonos автоматически перехватывает действие и открывает модальный checkout.

Строка селектора кнопки checkout может быть настроена либо через панель управления Zonos, либо в предпочтении сайта Place Order (Checkout) Button Selector пользовательских настроек сайта Zonos в Business Manager.

Когда пользователь завершает заказ в размещенном checkout Zonos, он перенаправляется на пользовательский конвейер, отображающий подтверждение заказа в SFCC (Zonos-OrderConfirmation). Основной шаблон рендеринга для этого подтверждения заказа — это /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.

Эта страница подтверждения заказа использует тот же стиль, что и страница подтверждения собственного заказа SFCC/SFRA, и делится некоторыми файлами .isml с страницей подтверждения собственного заказа SFCC/SFRA. Это может потребовать некоторых обновлений стиля, чтобы соответствовать любым пользовательским обновлениям стиля, уже внесенным на сайт. Основные шаблоны рендеринга, используемые шаблоном подтверждения заказа Zonos:

• 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

Основная функция, связанная с этим пользовательским конвейером, помимо отображения подтверждения заказа пользователю, связана с новым пользовательским типом объекта, включенным в импорт данных, zonosOrders. Когда подтверждение заказа отображается для пользователя, SFCC использует ID заказа Zonos, отображаемый в URL для подтверждения заказа и создания соответствующего пользовательского объекта с ID заказа Zonos в качестве атрибута ключа для пользовательского объекта. Затем это используется для размещения заказа в SFCC через задание CreateOrdersFromZonos. Это задание будет выполнять итерацию через все пользовательские объекты типа zonosOrders с createdStatus = - None -. Задание будет выполнять несколько задач:

1. Запросить из Zonos детали заказа.
2. Используйте этот ответ для создания заказа в SFCC на основе параметров, настроенных в прикладных программах для способа доставки и способа платежа + детали для элементов, доставки, выставления счетов и клиента в ответе.
3. Обновить Zonos с номером заказа SFCC через мутацию для связи этого с номером заказа Zonos на панели управления Zonos.

Если вышеуказанные шаги успешны, атрибут пользовательского объекта createdStatus затем будет установлен на created, чтобы удалить объект из рассмотрения в будущем. Если вышеуказанные шаги не успешны, атрибут пользовательского объекта createdStatus затем будет установлен на failed, и сообщение об ошибке будет отмечено в объекте в атрибуте errorResponse (Zonos) или sfccErrorResponse (SFCC) в зависимости от системы, отвечающей ошибкой во время процесса.

Если вам нужно попытаться повторно разместить заказ, просто повторно установите createdStatus на - None -, и это будет принято во внимание в следующем запуске задания.

Опционально — следующие параметры — это дополнительные параметры. Значения по умолчанию на месте, поэтому никакое действие не требуется. Если вы хотели бы внести корректировки, следуйте этим рекомендациям:

Создать накладную при импорте

Установите на Yes по умолчанию. Zonos создаст накладную при импорте заказа. Если вы выберете отключить эту функцию, вам нужно будет создать собственную накладную, и Zonos установит проверку мошенничества на статус zonos_hold. После снятия мошенничества мы вернемся к предыдущему статусу.

Вход клиента

Установите на No по умолчанию. Если вы хотите требовать аккаунт для checkout, переключитесь на Yes. Вам также нужно будет перейти на Customer configuration > Login options и обновить Redirect Customer to Account Dashboard after Logging In на No.

Экспорт заказов SFCC

Если вы используете или планируете использовать экспорт заказов SFCC, убедитесь, что пользовательские атрибуты Zonos, назначенные объектам Order и Product, включены в файлы экспорта заказов SFCC. Из Merchant Tools > Site Preferences > Orders установите версию схемы экспорта заказов на последнюю версию.

Информация о продукте может влиять на размер задолженности пошлин и налогов, а также на стоимость доставки. Чем больше информации о продукте вы предоставляете Zonos, тем точнее будет полученная котировка. Zonos может создать котировку даже при отсутствии этой информации, но рекомендует предоставить следующие ключевые детали продукта для повышения точности:

• Weight: Вес влияет на стоимость доставки, что может влиять на пошлины или налоги. Веса в списках продуктов SFCC автоматически используются Zonos при наличии.
• Dimensions: Размеры могут влиять на стоимость доставки, что может влиять на пошлины или налоги. Zonos может использовать размеры продуктов (длина, ширина и высота), установленные для каждого продукта в SFCC, но вам нужно сопоставить их в пользовательских настройках сайта Zonos для правильной интеграции.
• HS codes: Коды HS влияют на ставки пошлин и иногда могут влиять на налоги. Zonos может использовать HS коды, установленные в списках продуктов в SFCC, но вам нужно сопоставить поле HS кода в пользовательских настройках сайта Zonos.
• Country of origin: Страна происхождения продукта влияет на ставки пошлин и может влиять на налоги. Страна происхождения, установленная в списках продуктов SFCC, автоматически используется Zonos при наличии.

Примечание: Кроме того, вы можете ввести информацию в Catalog, переопределяя информацию, сохраненную и переданную из SFCC.

Узнайте больше о информации о продукте по платформе.