Трансформируйте ваш магазин SFCC для глобальной торговли с помощью Zonos Checkout.
Zonos Checkout интегрируется непосредственно в витрину Salesforce Commerce Cloud (SFCC), обеспечивая беспрепятственные международные транзакции с встроенными расчетами Landed Cost, локализованными вариантами платежей и автоматизированным управлением заказами между Zonos и SFCC Business Manager.
Для ваших клиентов: Локализованный checkout на их языке и валюте с предварительными расчетами Landed Cost, защита от мошенничества и без неожиданных сборов при доставке.
Для вашей команды: Беспрепятственные международные расчеты, управление заказами в SFCC Business Manager с автоматической синхронизацией заказов и безопасная обработка платежей, полностью обработанная Zonos.
Если вы еще не зарегистрировались в Zonos, заполните нашу форму обратной связи с продажами для начала работы. Выделенный представитель по адаптации свяжется с вами в течение 24 часов, чтобы провести вас через процесс интеграции после того, как соглашение вашего аккаунта будет заключено.
Беспрепятственно интегрируйте Checkout с вашим магазином Salesforce Commerce Cloud, следуя этим шагам:
1
Создайте архив метаданных
Перед установкой картриджа убедитесь, что у вас есть рабочая песочница с сайтом на основе установленного SFRA. Затем создайте архив импорта метаданных сайта:
В извлеченном картридже Zonos LINK переименуйте папку /link_zonos/metadata/sites/RefArch на ID вашего сайта SFCC. Например, если ваш ID сайта "GlobalEcom", переименуйте так, чтобы у вас была /link_zonos/metadata/sites/GlobalEcom в структуре папок.
Создайте архив Zip вашей папки /link_zonos/metadata и назовите архив zip как metadata.zip. Примечание: Включите саму папку /metadata в архив zip.
2
Импортируйте архив метаданных
После того как metadata.zip подготовлен, импортируйте его в вашу песочницу SFCC:
Перейдите на Business Manager > Administration > Site Development > Site Import & Export.
Загрузите metadata.zip, используя опцию загрузки Local.
После загрузки найдите архив в списке и нажмите Import.
Этот шаг создает необходимые настройки сайта, услуги, учетные данные и пользовательские объекты, используемые интеграцией Zonos.
3
Добавьте картридж в путь картриджа
Добавьте картридж int_zonos в путь картриджа вашего сайта для активации его контроллеров, скриптов и шаблонов:
Вставьте int_zonos в путь картриджа перед основным картриджем витрины SFRA (app_storefront_base).
4
Настройте псевдонимы конвейера
Два пользовательских конвейера включены с картриджем, которые должны иметь добавленные псевдонимы конвейера в 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.
5
Настройте услуги SFCC
С импортом сайта на шаге 2 были созданы две услуги SFCC (с сопровождающими профилями и учетными данными): zonos.api.graphql и create.order.api.sfra.
Установка с одним сайтом
Если ваша организация имеет один сайт витрины в вашей организации SFCC, здесь больше ничего делать не нужно, и вы можете переходить к следующему шагу.
Установка с несколькими сайтами
Если ваша организация имеет несколько сайтов витрины или планирует иметь несколько сайтов витрины в вашей организации SFCC, вам нужно будет сделать обновления/добавления к вашим услугам SFCC. Если у вас есть несколько сайтов SFCC, которые будут использовать интеграцию Zonos, вам потребуется служба создания API заказов для каждого сайта. Для каждого сайта выполните следующее:
Создайте новые учетные данные с именем create.order.api.[siteID].
Создайте новую услугу с именем create.order.api.[siteID] и назначьте ей профиль create.order.api и учетные данные create.order.api.[siteID], которые вы создали на шаге 1.
После завершения у вас должна быть служба создания API заказов для каждого из ваших сайтов.
Примечание: Если вы не переименовали исходную услугу create.order.api.sfra в службу создания заказов для одного из ваших сайтов, и она все еще существует, вы можете удалить ее. Оставьте имя услуги zonos.api.graphql как оно есть. Даже при наличии нескольких сайтов вам понадобится только одна служба API Zonos.
6
Настройте пользовательские настройки сайта Zonos
В Business Manager перейдите на Merchant Tools > Site Preferences > Custom Preferences, затем нажмите на группу настроек zonos для доступа к пользовательским настройкам сайта Zonos.
Установите следующие предпочтения сайта для вашего сайта(сайтов):
Имя предпочтения↕
Описание↕
Zonos Enabled
Переключатель функции, используемый для включения/отключения интеграции Zonos на витрине. Если не установлено, используется значение по умолчанию (No).
Main Zonos Script
(Требуется) URL скрипта на стороне клиента (браузера) для интеграции Zonos. Предоставляется Zonos. Если не установлено, используется значение по умолчанию (https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/loadZonos.js).
Blur OnInit Script
(Опционально) URL скрипта на стороне клиента (браузера) для размытия начальных значений цен при включенном автоматическом преобразовании валюты. Предоставляется Zonos.
Public API Token
(Требуется) Токен открытой интеграции. Это значение можно найти в вашем Zonos Dashboard (Settings > Integrations > API Keys: Public Credential).
Private API Token
(Требуется) Токен интеграции Private. Это значение можно найти в вашем Zonos Dashboard (Settings > Integrations > API Keys: Zonos API).
Zonos Store ID
(Требуется) ID магазина, предоставленный Zonos. Это значение можно найти в вашем Zonos Dashboard (Settings > Integrations > App credentials: Store ID).
Currency Element Selector
(Опционально) строка селектора в стиле jQuery (без кавычек) для значений цен, к которым Zonos должен применить преобразование валюты.
Place Order (Checkout) Button Selector
(Опционально) строка селектора в стиле jQuery (без кавычек) для кнопок, которые должны инициировать модальный checkout Zonos.
Zonos Payment Method ID
ID способа оплаты SFCC, используемый при создании заказа Zonos в SFCC. Включенный в импорт данных — это новый способ платежа и обработчик платежей, оба с id ZONOS. Этот новый id способа оплаты также является значением по умолчанию для этого пользовательского предпочтения сайта. Если вы предпочитаете иметь другой способ оплаты, связанный с заказами Zonos, значение здесь можно изменить на ID любого действительного способа платежа, настроенного в Business Manager.
Zonos Ship Method Mapping
Отображение JSON способов доставки ID из ответа деталей заказа Zonos на ID способов доставки SFCC при размещении заказов Zonos в SFCC. Установите сопоставление по умолчанию, чтобы, если явно не сопоставлено, несопоставленные способы доставки Zonos отображались на способ доставки SFCC по умолчанию. См. раздел "Настройте способы доставки" ниже для более подробного объяснения.
Place Order Password
(Требуется) Это значение используется SFCC для обеспечения того, чтобы запросы на создание заказа API исходили из надежного внутреннего источника (т.е. задания SFCC). Это значение может быть любой строкой символов (заглавных/строчных букв, цифр и стандартных специальных символов), которую вы хотите. Пример: X$7eo$33B!z=
SFCC Storefront Password
Пароль витрины для сайта SFCC (если защищено).
Place Order Service Name
(Требуется) Имя услуги API создания заказов, которую вы настроили на шаге 5. Примечание: это имя должно точно совпадать с именем услуги.
Origin Shipping Address
Исходный адрес для склада доставки, отправленный в Zonos, формат JSON. Пример: {"administrativeArea": "Pennsylvania", "administrativeAreaCode": "PA", "countryCode": "US", "line1": "975 S Tech Ridge Dr", "line2": "", "locality": "Harrisburg", "postalCode": "17025"}
Zonos Default HS Code
(Требуется) HS код Zonos по умолчанию, используемый, если значение продукта имеет нулевое значение. Если пусто, используется значение по умолчанию (6109.10).
7
Настройте способы доставки
Во время модального checkout Zonos покупатели выбирают способы доставки, определенные в вашем Zonos Dashboard. Когда эти заказы импортируются в SFCC, их способы доставки должны соответствовать действительному способу доставки SFCC. Для поддержки этого:
Установите один или несколько способов доставки в SFCC, к которым должны быть сопоставлены способы доставки в Zonos.
В пользовательском предпочтении сайта Zonos Ship Method Mapping, описанном выше, установите одно или несколько сопоставления способов доставки между вашими способами доставки Zonos и способами доставки SFCC.
Сопоставление способов доставки
В виде объекта JSON сопоставление способа доставки отображает ваши способы доставки Zonos на ваши способы доставки SFCC. Это сопоставление должно иметь запись сопоставления для каждого потенциального способа доставки Zonos (уровня обслуживания), который может быть выбран в вашем checkout Zonos. Настоятельно рекомендуется также включить запись сопоставления default, которая будет использоваться в случаях, когда заказ Zonos размещен со способом доставки, для которого сопоставление со способом доставки SFCC не существует, таким образом предотвращая нисходящие сбои, вызванные отсутствием способа доставки в заказе SFCC.
Предположим, вы включили следующие уровни обслуживания в вашем Zonos Dashboard:
По какой бы то ни было причине (т.е. требования бэк-офиса, дополнительная интеграция службы доставки третьей стороны и т.д.), вы можете быть ограничены следующими способами доставки в SFCC для вашего сайта:
Когда новый заказ Zonos получен и затем размещен в SFCC, способ доставки должен быть из этого списка.
Чтобы построить ваше сопоставление, войдите в Zonos Dashboard, перейдите на Shipping > Manage Rates, а затем нажмите на каждый из отображаемых Enabled service levels, где вы увидите отображение, похожее на следующее:
В каждом нажмите на Edit details, чтобы получить (или установить) код уровня обслуживания доставки Zonos (см. ниже).
Используя код услуги доставки, создайте запись сопоставления, отображающую его на способ доставки SFCC, который вы хотите увидеть в заказах SFCC, когда этот уровень обслуживания доставки (способ доставки Zonos) выбран в checkout Zonos.
Как только вы добавили запись для каждого кода включенного уровня обслуживания доставки, а также сопоставление способа доставки default, ваш объект JSON Zonos Ship Method Mapping должен выглядеть примерно так:
Примечание: Поскольку это только сопоставление методов доставки Zonos с методами доставки SFCC, важно только иметь все методы доставки Zonos, включенные в сопоставление. Нет необходимости иметь каждый из ваших методов доставки SFCC, включенных в сопоставление.
8
Настройте задачи
Включены два задания SFCC для поддержки интеграции Zonos:
CreateOrdersFromZonos
Это задание ищет вновь созданные ссылки на заказы Zonos в хранилище пользовательских объектов zonosOrders, получает полные детали заказа из Zonos и создает соответствующие заказы в SFCC.
График: Вы можете запланировать это задание в соответствии с потребностями вашего бизнеса, но обычно это задание должно быть настроено на периодический запуск, относительно часто (т.е. каждые 5-10 минут), и каждый день недели.
Пользовательские параметры: задание CreateOrdersFromZonos не включает никакие пользовательские параметры.
CreateMissingZonosOrders
Хотя это должно быть редко, возможно, что из-за непредвиденных обстоятельств, могут быть заказы размещены в Zonos, которые не доходят до вашего экземпляра SFCC через обычный процесс. По этой причине мы включили задание CreateMissingZonosOrders. Это задание выполняет перекрестную проверку между историей заказов Zonos и SFCC для выявления и импорта любых отсутствующих заказов.
График: Вы можете запланировать это задание в соответствии с потребностями вашего бизнеса, но вы должны запланировать это задание на запуск менее часто, чем задание CreateOrdersFromZonos. Некоторые вещи, которые следует учитывать при планировании частоты запуска этого задания:
Как и в случае со всеми заданиями, после рассмотрения всего, включая нагрузку обработки/пропускную способность и потребности вашего бизнеса, вы должны запланировать это задание на запуск как можно реже, как вы чувствуете.
Поскольку это задание будет запрашивать все заказы за период времени, сайты с высоким объемом должны запускать это задание чаще (поэтому меньше заказов обработано за запуск задания), тогда как сайты с низким объемом могут справиться с меньшей частотой.
Наша базовая предлагаемая частота для CreateMissingZonosOrders, которую мы считаем подходящей для большинства сайтов, — один раз в 90 минут.
Пользовательские параметры: Есть два пользовательских параметра, связанных с этапом задания CreateMissingZonosOrders, которые вы должны установить:
LookBackHours: Это количество часов (от времени запуска задания) в прошлое, за которое задание должно запрашивать Zonos, ища недостающие заказы. На основе вашей запланированной частоты для задания это значение должно быть как минимум равно времени между запусками заданий и в идеале должно иметь перекрытие. Например, если задание запланировано на запуск каждые 90 минут, установите LookBackHours на 2 (часа). Значение по умолчанию (если значение не установлено): 2
OrderSize: Максимальное количество заказов для получения за внутренний запрос Zonos. Думайте об этом как о размере страницы, который использует задание при запросе заказов из Zonos. Значение по умолчанию (если значение не установлено): 20
9
Настройте Zonos Hello
Zonos Hello предоставляет возможности локализации на стороне клиента, такие как динамический выбор языка, сообщения о пошлинах/налогах и встроенное преобразование валюты. После включения Zonos в настройки сайта, Hello автоматически загружается на вашей витрине через скрипт клиента Zonos.
Скрипты клиента Zonos добавляются с использованием удаленного включения SFCC конечной точки Zonos-ClientScriptInclude, расположенной в нижней части следующих шаблонов наложения:
Если ваш проект переопределяет эти шаблоны в картриджах с более высоким приоритетом, убедитесь, что удаленное включение добавлено к вашим настроенным версиям:
Zonos Hello автоматически преобразует значения цен, отображаемые на витрине, в местную валюту покупателя. Чтобы это работало правильно:
Значения цен должны быть обернуты в элементы HTML, используя имена классов или ID, которые могут быть выбраны через jQuery. Например: <p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>
Эти значения селектора должны быть включены в предпочтение сайта Currency Element Selector (или в вашем Zonos Dashboard).
Изменения кода отображения цен
Картридж Zonos включает следующие шаблоны наложения для мест, где цены отображаются по всему сайту эталонной архитектуры, используя имена классов zonos-list-price, zonos-sales-price и zonos-price, назначенные элементам HTML, содержащим эти различные цены:
Если нет картриджей, содержащих эти шаблоны и настроенные выше int_zonos в пути картриджа, никакие изменения кода не требуются для преобразования валют Hello на вашем сайте. Если у вас есть настроенные версии этих шаблонов в одном или нескольких картриджах выше int_zonos в пути картриджа, вам нужно будет включить уникальное имя класса оборачивающим элементам HTML вокруг ваших цен (как показано выше) в эти настроенные шаблоны.
Настройка строки селектора элементов цены
Строка селектора валюты — это значение селектора в стиле jQuery, используемое скриптом Zonos для идентификации элементов HTML, содержащих значения цен, которые должны получить обновления преобразования валюты. Это значение должно быть разделенным пробелом списком имен классов CSS и/или ID, назначенных элементам HTML, оборачивающим отображение цен на вашем сайте, описанным в предыдущем шаге, где имена классов имеют префикс . и ID имеют префикс # (без кавычек). Например, если ваш сайт будет использовать шаблоны для отображения цен, включенные в картридж Zonos, строка селектора будет .zonos-list-price .zonos-sales-price .zonos-price (без кавычек).
Строка селектора валюты может быть настроена либо через Zonos Dashboard, либо в предпочтении сайта Currency Element Selector пользовательских настроек сайта Zonos в Business Manager.
Примечание: Если настроено в обоих местах, значение в Business Manager будет иметь приоритет.
Строка селектора кнопки checkout — это значение селектора jQuery, используемое скриптом Zonos для идентификации элементов HTML на вашем сайте, которые служат элементами управления кнопки, которые при нажатии переносят клиента в процесс checkout вашего сайта.
Когда покупатели нажимают кнопку Checkout, которая совпадала с вашей настроенной строкой селектора, Zonos автоматически перехватывает действие и открывает модальный checkout.
Строка селектора кнопки checkout может быть настроена либо через Zonos Dashboard, либо в предпочтении сайта Place Order (Checkout) Button Selector пользовательских настроек сайта Zonos в Business Manager.
12
Разберитесь в подтверждении заказа и пользовательских объектах
Когда пользователь завершает заказ в размещенном checkout Zonos, он перенаправляется на пользовательский конвейер, отображающий подтверждение заказа в SFCC (Zonos-OrderConfirmation). Основной шаблон рендеринга для этого подтверждения заказа — это /int_zonos/cartridge/templates/default/checkout/confirmation/zonosConfirmation.isml.
Эта страница подтверждения заказа использует тот же стиль, что и страница подтверждения собственного заказа SFCC/SFRA, и делится некоторыми файлами .isml с страницей подтверждения собственного заказа SFCC/SFRA. Это может потребовать некоторых обновлений стиля, чтобы соответствовать любым пользовательским обновлениям стиля, уже внесенным на сайт. Основные шаблоны рендеринга, используемые шаблоном подтверждения заказа Zonos:
Основная функция, связанная с этим пользовательским конвейером, помимо отображения подтверждения заказа пользователю, связана с новым пользовательским типом объекта, включенным в импорт данных, zonosOrders. Когда подтверждение заказа отображается для пользователя, SFCC использует ID заказа Zonos, отображаемый в URL для подтверждения заказа и создания соответствующего пользовательского объекта с ID заказа Zonos в качестве атрибута ключа для пользовательского объекта. Затем это используется для размещения заказа в SFCC через задание CreateOrdersFromZonos. Это задание будет выполнять итерацию через все пользовательские объекты типа zonosOrders с createdStatus = - None -. Задание будет выполнять несколько задач:
Запросить из Zonos детали заказа.
Используйте этот ответ для создания заказа в SFCC на основе настроек, заданных в настройках сайта для способа доставки и способа платежа, а также деталей для элементов, доставки, выставления счетов и клиента в ответе.
Обновить Zonos с номером заказа SFCC через мутацию для связи этого с номером заказа Zonos в Zonos Dashboard.
Если вышеуказанные шаги успешны, атрибут пользовательского объекта createdStatus затем будет установлен на created, чтобы удалить объект из рассмотрения в будущем. Если вышеуказанные шаги не успешны, атрибут пользовательского объекта createdStatus затем будет установлен на failed, и сообщение об ошибке будет отмечено в объекте в атрибуте errorResponse (Zonos) или sfccErrorResponse (SFCC) в зависимости от системы, отвечающей ошибкой во время процесса.
Если вам нужно попытаться повторно разместить заказ, просто повторно установите createdStatus на - None -, и это будет принято во внимание в следующем запуске задания.
13
Отрегулируйте дополнительные параметры
Опционально — следующие параметры — это дополнительные параметры. Значения по умолчанию на месте, поэтому никакое действие не требуется. Если вы хотели бы внести корректировки, следуйте этим рекомендациям:
Создать накладную при импорте
Установите на 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 установите версию схемы экспорта заказов на последнюю версию.
14
Протестируйте вашу интеграцию
Теперь, когда вы настроили свой аккаунт и приложение, вы готовы к тестированию вашей интеграции. Вам нужно будет включить Checkout и Hello в SFCC при тестировании. Для этого:
Перейдите на Merchant Tools > Site Preferences > Custom Preferences > zonos.
Переключите Zonos Enabled на Yes.
После того как вы настроили информацию вашего аккаунта Zonos в пользовательских настройках сайта вашего сайта и переключатель функции Zonos Enabled установлен на YES, вы можете протестировать функции Zonos на вашей витрине, добавив следующий параметр к URL вашего сайта: zCountry=[country code of a country you have enabled in your Zonos Dashboard]
Например, если у вас включена Канада: https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CA
Примечание: Это требуется только для тестирования в непроизводственных окружениях, где публичный токен API Zonos настроен с токеном учетных данных теста. При настройке с вашим живым/производственным токеном API параметр URL zCountry не требуется и не ожидается.
Если вы еще не готовы перейти в режим «live», помните, что нужно переключить Zonos Enabled обратно на No после завершения тестирования. После завершения тестирования включите Zonos, используя те же шаги выше.
Нужна помощь?
Если у вас есть вопросы, пожалуйста, свяжитесь с нашей командой поддержки. Если вы в настоящее время работаете с Professional Services Project Manager для адаптации вашего аккаунта, пожалуйста, обратитесь к нему за помощью.
Номера отслеживания, добавленные в SFCC, автоматически синхронизируются с Zonos. Однако номера отслеживания, добавленные в Zonos Dashboard, не синхронизируются обратно в SFCC. Если вы добавляете или обновляете номера отслеживания в Zonos Dashboard, вам также нужно будет вручную обновить их в SFCC Business Manager.
Узнайте больше о том, какие интеграции поддерживают синхронизацию номеров отслеживания.
Удаление картриджа должно выполняться опытным разработчиком SFCC. Свяжитесь с вашей командой разработки SFCC или поддержкой Zonos для помощи с удалением.
Какую информацию о продукте я должен предоставить для наиболее точной котировки по пошлинам, налогам и стоимости доставки?
Информация о продукте может влиять на размер задолженности пошлин и налогов, а также на стоимость доставки. Чем больше информации о продукте вы предоставляете Zonos, тем точнее будет полученная котировка. Zonos может создать котировку даже при отсутствии этой информации, но рекомендует предоставить следующие ключевые детали продукта для повышения точности:
Вес: Вес влияет на стоимость доставки, что может влиять на пошлины или налоги. Веса в списках продуктов SFCC автоматически используются Zonos при наличии.
Размеры: Размеры могут влиять на стоимость доставки, что может влиять на пошлины или налоги. Zonos может использовать размеры продуктов (длина, ширина и высота), установленные для каждого продукта в SFCC, но вам нужно сопоставить их в пользовательских настройках сайта Zonos для правильной интеграции.
Коды HS: Коды HS влияют на ставки пошлин и иногда могут влиять на налоги. Zonos может использовать HS коды, установленные в списках продуктов в SFCC, но вам нужно сопоставить поле HS кода в пользовательских настройках сайта Zonos.
Страна происхождения: Страна происхождения продукта влияет на ставки пошлин и может влиять на налоги. Страна происхождения, установленная в списках продуктов SFCC, автоматически используется Zonos при наличии.
Примечание: В качестве альтернативы вы можете ввести информацию в Catalog, переопределяя информацию, сохраненную и переданную из SFCC.
Salesforce Commerce Cloud
Checkout для Salesforce Commerce Cloud
Трансформируйте ваш магазин SFCC для глобальной торговли с помощью Zonos Checkout.
Zonos Checkout интегрируется непосредственно в витрину Salesforce Commerce Cloud (SFCC), обеспечивая беспрепятственные международные транзакции с встроенными расчетами Landed Cost, локализованными вариантами платежей и автоматизированным управлением заказами между Zonos и SFCC Business Manager.
Для ваших клиентов: Локализованный checkout на их языке и валюте с предварительными расчетами Landed Cost, защита от мошенничества и без неожиданных сборов при доставке.
Для вашей команды: Беспрепятственные международные расчеты, управление заказами в SFCC Business Manager с автоматической синхронизацией заказов и безопасная обработка платежей, полностью обработанная Zonos.
Как интегрировать
Если вы еще не зарегистрировались в Zonos, заполните нашу форму обратной связи с продажами для начала работы. Выделенный представитель по адаптации свяжется с вами в течение 24 часов, чтобы провести вас через процесс интеграции после того, как соглашение вашего аккаунта будет заключено.
Беспрепятственно интегрируйте Checkout с вашим магазином Salesforce Commerce Cloud, следуя этим шагам:
Создайте архив метаданных
Перед установкой картриджа убедитесь, что у вас есть рабочая песочница с сайтом на основе установленного SFRA. Затем создайте архив импорта метаданных сайта:
/link_zonos/metadata/sites/RefArchна ID вашего сайта SFCC. Например, если ваш ID сайта "GlobalEcom", переименуйте так, чтобы у вас была/link_zonos/metadata/sites/GlobalEcomв структуре папок./link_zonos/metadataи назовите архив zip какmetadata.zip. Примечание: Включите саму папку/metadataв архив zip.Импортируйте архив метаданных
После того как
metadata.zipподготовлен, импортируйте его в вашу песочницу SFCC:metadata.zip, используя опцию загрузки Local.Этот шаг создает необходимые настройки сайта, услуги, учетные данные и пользовательские объекты, используемые интеграцией Zonos.
Добавьте картридж в путь картриджа
Добавьте картридж
int_zonosв путь картриджа вашего сайта для активации его контроллеров, скриптов и шаблонов: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.
Настройте услуги SFCC
С импортом сайта на шаге 2 были созданы две услуги SFCC (с сопровождающими профилями и учетными данными):
zonos.api.graphqlиcreate.order.api.sfra.Установка с одним сайтом
Если ваша организация имеет один сайт витрины в вашей организации SFCC, здесь больше ничего делать не нужно, и вы можете переходить к следующему шагу.
Установка с несколькими сайтами
Если ваша организация имеет несколько сайтов витрины или планирует иметь несколько сайтов витрины в вашей организации SFCC, вам нужно будет сделать обновления/добавления к вашим услугам SFCC. Если у вас есть несколько сайтов SFCC, которые будут использовать интеграцию Zonos, вам потребуется служба создания API заказов для каждого сайта. Для каждого сайта выполните следующее:
create.order.api.[siteID].https://[Sandbox Host]/s/[Site ID]/Zonos-PlaceSFCCOrder(например:https://wxyz-001.dx.commercecloud.salesforce.com/s/RefArch/zonos-placesfccorder).create.order.api.[siteID]и назначьте ей профильcreate.order.apiи учетные данныеcreate.order.api.[siteID], которые вы создали на шаге 1.После завершения у вас должна быть служба создания API заказов для каждого из ваших сайтов.
Настройте пользовательские настройки сайта Zonos
В Business Manager перейдите на Merchant Tools > Site Preferences > Custom Preferences, затем нажмите на группу настроек zonos для доступа к пользовательским настройкам сайта Zonos.
Установите следующие предпочтения сайта для вашего сайта(сайтов):
https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/loadZonos.js).ZONOS. Этот новый id способа оплаты также является значением по умолчанию для этого пользовательского предпочтения сайта. Если вы предпочитаете иметь другой способ оплаты, связанный с заказами Zonos, значение здесь можно изменить на ID любого действительного способа платежа, настроенного в Business Manager.X$7eo$33B!z={"administrativeArea": "Pennsylvania", "administrativeAreaCode": "PA", "countryCode": "US", "line1": "975 S Tech Ridge Dr", "line2": "", "locality": "Harrisburg", "postalCode": "17025"}6109.10).Настройте способы доставки
Во время модального checkout Zonos покупатели выбирают способы доставки, определенные в вашем Zonos Dashboard. Когда эти заказы импортируются в SFCC, их способы доставки должны соответствовать действительному способу доставки SFCC. Для поддержки этого:
Сопоставление способов доставки
В виде объекта JSON сопоставление способа доставки отображает ваши способы доставки Zonos на ваши способы доставки SFCC. Это сопоставление должно иметь запись сопоставления для каждого потенциального способа доставки Zonos (уровня обслуживания), который может быть выбран в вашем checkout Zonos. Настоятельно рекомендуется также включить запись сопоставления
default, которая будет использоваться в случаях, когда заказ Zonos размещен со способом доставки, для которого сопоставление со способом доставки SFCC не существует, таким образом предотвращая нисходящие сбои, вызванные отсутствием способа доставки в заказе SFCC.Формат объекта JSON:
{ "[Zonos Shipping Service Level Code]": "[SFCC Shipping Method ID]", ... "default": "[Default SFCC Shipping Method ID]" }Пример
Предположим, вы включили следующие уровни обслуживания в вашем Zonos Dashboard:
По какой бы то ни было причине (т.е. требования бэк-офиса, дополнительная интеграция службы доставки третьей стороны и т.д.), вы можете быть ограничены следующими способами доставки в SFCC для вашего сайта:
Когда новый заказ Zonos получен и затем размещен в SFCC, способ доставки должен быть из этого списка.
Чтобы построить ваше сопоставление, войдите в Zonos Dashboard, перейдите на 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" }Настройте задачи
Включены два задания SFCC для поддержки интеграции Zonos:
CreateOrdersFromZonos
Это задание ищет вновь созданные ссылки на заказы Zonos в хранилище пользовательских объектов
zonosOrders, получает полные детали заказа из Zonos и создает соответствующие заказы в SFCC.График: Вы можете запланировать это задание в соответствии с потребностями вашего бизнеса, но обычно это задание должно быть настроено на периодический запуск, относительно часто (т.е. каждые 5-10 минут), и каждый день недели.
Пользовательские параметры: задание
CreateOrdersFromZonosне включает никакие пользовательские параметры.CreateMissingZonosOrders
Хотя это должно быть редко, возможно, что из-за непредвиденных обстоятельств, могут быть заказы размещены в Zonos, которые не доходят до вашего экземпляра SFCC через обычный процесс. По этой причине мы включили задание
CreateMissingZonosOrders. Это задание выполняет перекрестную проверку между историей заказов Zonos и SFCC для выявления и импорта любых отсутствующих заказов.График: Вы можете запланировать это задание в соответствии с потребностями вашего бизнеса, но вы должны запланировать это задание на запуск менее часто, чем задание
CreateOrdersFromZonos. Некоторые вещи, которые следует учитывать при планировании частоты запуска этого задания:CreateMissingZonosOrders, которую мы считаем подходящей для большинства сайтов, — один раз в 90 минут.Пользовательские параметры: Есть два пользовательских параметра, связанных с этапом задания
CreateMissingZonosOrders, которые вы должны установить:LookBackHoursна2(часа). Значение по умолчанию (если значение не установлено):220Настройте Zonos Hello
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 автоматически преобразует значения цен, отображаемые на витрине, в местную валюту покупателя. Чтобы это работало правильно:
<p class="text-right sub-total zonos-price">${pdict.totals.subTotal}</p>Изменения кода отображения цен
Картридж 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 Dashboard, либо в предпочтении сайта Currency Element Selector пользовательских настроек сайта Zonos в Business Manager.
Узнайте больше о преобразовании валюты Zonos Hello.
Настройте кнопку checkout
Строка селектора кнопки checkout — это значение селектора jQuery, используемое скриптом Zonos для идентификации элементов HTML на вашем сайте, которые служат элементами управления кнопки, которые при нажатии переносят клиента в процесс checkout вашего сайта.
Когда покупатели нажимают кнопку Checkout, которая совпадала с вашей настроенной строкой селектора, Zonos автоматически перехватывает действие и открывает модальный checkout.
Строка селектора кнопки checkout может быть настроена либо через Zonos Dashboard, либо в предпочтении сайта 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.ismlapp_storefront_base\cartridge\templates\default\checkout\shipping\shippingSummary.ismlint_zonos\cartridge\templates\default\checkout\billing\billingSummary.ismlapp_storefront_base\cartridge\templates\default\checkout\orderProductSummary.ismlapp_storefront_base\cartridge\templates\default\checkout\orderTotalSummary.ismlОсновная функция, связанная с этим пользовательским конвейером, помимо отображения подтверждения заказа пользователю, связана с новым пользовательским типом объекта, включенным в импорт данных,
zonosOrders. Когда подтверждение заказа отображается для пользователя, SFCC использует ID заказа Zonos, отображаемый в URL для подтверждения заказа и создания соответствующего пользовательского объекта с ID заказа Zonos в качестве атрибута ключа для пользовательского объекта. Затем это используется для размещения заказа в SFCC через заданиеCreateOrdersFromZonos. Это задание будет выполнять итерацию через все пользовательские объекты типаzonosOrdersсcreatedStatus = - None -. Задание будет выполнять несколько задач:Если вышеуказанные шаги успешны, атрибут пользовательского объекта
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 установите версию схемы экспорта заказов на последнюю версию.
Протестируйте вашу интеграцию
Теперь, когда вы настроили свой аккаунт и приложение, вы готовы к тестированию вашей интеграции. Вам нужно будет включить Checkout и Hello в SFCC при тестировании. Для этого:
После того как вы настроили информацию вашего аккаунта Zonos в пользовательских настройках сайта вашего сайта и переключатель функции Zonos Enabled установлен на YES, вы можете протестировать функции Zonos на вашей витрине, добавив следующий параметр к URL вашего сайта:
zCountry=[country code of a country you have enabled in your Zonos Dashboard]Например, если у вас включена Канада:
https://abcd-001.dx.commercecloud.salesforce.com/on/demandware.store/Sites-RefArch-Site?zCountry=CAЕсли вы еще не готовы перейти в режим «live», помните, что нужно переключить Zonos Enabled обратно на No после завершения тестирования. После завершения тестирования включите Zonos, используя те же шаги выше.
Если у вас есть вопросы, пожалуйста, свяжитесь с нашей командой поддержки. Если вы в настоящее время работаете с Professional Services Project Manager для адаптации вашего аккаунта, пожалуйста, обратитесь к нему за помощью.
Синхронизация номеров отслеживания
Номера отслеживания, добавленные в SFCC, автоматически синхронизируются с Zonos. Однако номера отслеживания, добавленные в Zonos Dashboard, не синхронизируются обратно в SFCC. Если вы добавляете или обновляете номера отслеживания в Zonos Dashboard, вам также нужно будет вручную обновить их в SFCC Business Manager.
Узнайте больше о том, какие интеграции поддерживают синхронизацию номеров отслеживания.
Удалить Checkout
Удаление картриджа должно выполняться опытным разработчиком SFCC. Свяжитесь с вашей командой разработки SFCC или поддержкой Zonos для помощи с удалением.
Часто задаваемые вопросы
Какую информацию о продукте я должен предоставить для наиболее точной котировки по пошлинам, налогам и стоимости доставки?
Информация о продукте может влиять на размер задолженности пошлин и налогов, а также на стоимость доставки. Чем больше информации о продукте вы предоставляете Zonos, тем точнее будет полученная котировка. Zonos может создать котировку даже при отсутствии этой информации, но рекомендует предоставить следующие ключевые детали продукта для повышения точности:
Узнайте больше об информации о продукте по платформе.
Была ли эта страница полезной?