Checkout для Miva

В течение 24 часов после регистрации выделенный представитель по адаптации свяжется с вами для начала индивидуального процесса интеграции.

Важно: Инструкции ниже приведены для справки, и вы будете проведены через них представителем по адаптации.

1. Загрузите модуль из Miva App Store или запросите файл zonos.mvc напрямую у Zonos.
2. В админ-панели Miva перейдите в Domain Settings -> Modules -> Add Module, загрузите файл zonos.mvc и нажмите Add.

3. Перейдите в Settings -> Modules, найдите Zonos и нажмите Install. Убедитесь, что отображается статус Installed.

В Miva перейдите в Users -> API Tokens и нажмите Add API Token. Настройте его следующим образом:

• Name: Zonos Checkout
• Allowed IP Addresses: 0.0.0.0/0, ::/0
• Signature: Require Signature with Key -- нажмите Generate, чтобы создать ключ подписи
• Timestamp: Require Timestamp Within 30 seconds

На следующем экране включите Customer Service & Sales, чтобы разрешить токену создавать и изменять заказы. Нажмите Save.

Перейдите к модулю Checkout в Miva, выбрав Miva -> Utility Settings -> Zonos, затем заполните следующие поля:

1. Store ID: Скопируйте номер вашей учетной записи Zonos с Dashboard -> Settings -> Account -> Integrations.
2. Zonos API Key: Ваш секретный API-ключ (никогда не сообщайте его никому).
3. Zonos Public Key: Ваш публичный ключ.
4. Store Currency: Базовая валюта вашего магазина (например, USD).
5. Environment: Выберите Live для боевой среды или Test для тестирования.
6. Checkout Button Selector: CSS-селектор для кнопки оформления заказа (пример: a[href*="checkout.html"]).
7. Hidden Selectors: Для скрытия внутренних способов оплаты и других данных, которые могут не относиться к международным покупателям.
8. Import Orders: Установите флажок для автоматического импорта завершенных заказов Zonos в админ-панель Miva. Для этого необходимо зарегистрировать вебхуки на следующем шаге.

Нажмите Update в верхнем правом углу, чтобы сохранить настройки перед продолжением.

Заказы импортируются через вебхук в модуле версии 10.x. В предыдущих версиях модуля вместо этого использовался URL/эндпоинт успешного заказа.

После сохранения настроек нажмите Register Webhooks. Это подключает ваш магазин к Zonos, чтобы завершенные заказы автоматически импортировались, отмены синхронизировались, а обновления доставки передавались обратно в Miva.

Вебхуки должны быть зарегистрированы до того, как заработают импорт заказов, синхронизация отмен и обновления доставки. Флажок Import Orders требует регистрации вебхуков.

Прокрутите вниз, чтобы заполнить оставшиеся поля:

1. Miva API Token: Access Token из API-токена, созданного на шаге Создание API-токена.
2. Miva API Signature: Signing Key из той же записи API-токена.
3. Image Type: Выбирает, какой размер изображения товара отображается в Zonos Checkout (для большинства магазинов подходит Main).
4. Additional Field Mappings: При необходимости сопоставьте пользовательские поля Miva с атрибутами/метаданными Zonos (цвет, материал, размер и т. д.). Мы рекомендуем сопоставить код HS, если вы установили коды HS для конкретных товаров в ваших списках товаров Miva. Это не требуется для получения расценки пошлины и налога, так как мы можем использовать коды HS для конкретных товаров, введенные вами в Catalog, либо использовать ваш код HS по умолчанию. Однако это рекомендуется: точность расчетов общей стоимости значительно повысится с правильно классифицированными товарами. Чтобы сопоставить поле в Miva, создайте пользовательское поле для кода HS, а затем сопоставьте его в разделе Utility Settings -> Zonos.

Нажмите Update, чтобы сохранить все настройки.

Теперь, когда вы настроили учетную запись и модуль, вы готовы к тестированию, выполнив следующие действия:

• Протестируйте расценки доставки
• Разместите тестовый заказ на вашем сайте
• Протестируйте поток заказов через ваши системы
• Протестируйте ваш веб-сайт

Узнайте, как запустить эти тесты. На время тестирования вам нужно будет установить в поле Environment модуля значение Test.

После завершения тестирования вы готовы к запуску! Установите Environment в значение Live, убедитесь, что ваши учетные данные Zonos указаны верно, и убедитесь, что вебхуки зарегистрированы в вашем боевом магазине.

1. Перейдите на dashboard.zonos.com -> Hello -> Hello Settings.
2. Включите Currency behavior.
3. Введите CSS-селектор, который указывает на элементы цены товара в вашем магазине (например, .price).

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

Габариты доставки, страна происхождения и код HS, заданные в каталоге Miva, автоматически передаются в Zonos и используются для расчета общей стоимости и расценок доставки, если они заполнены. Дополнительная настройка сопоставления не требуется.

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

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

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

Требования

• Ваш магазин уже должен заполнять пользовательские столбцы габаритов для товаров корзины при добавлении товаров в корзину (это реализуется на стороне Miva, вне рамок модуля Zonos).
• Вам нужно знать точные названия используемых столбцов.

Настройка

Введите эти названия столбцов в три соответствующих поля в админ-панели модуля Zonos. Оставьте их пустыми, чтобы использовать стандартные Product Shipping Rules -- эта функция полностью опциональна и не влияет на магазины, которые ее не используют.

Когда в панели управления Zonos создается транспортная этикетка или вводится номер отслеживания, номер отслеживания и статус отправки автоматически передаются в соответствующий заказ в админ-панели Miva. Для этого требуется зарегистрировать вебхуки (см. шаг Регистрация вебхуков выше).

Отслеживание также можно ввести напрямую в Miva. Используйте диалоговое окно Enter Tracking Number для любого заказа Zonos -- номер отслеживания и статус отправки автоматически синхронизируются обратно в панель управления Zonos.

Журнал отладки доступен внутри админ-панели Miva, в настройках модуля Zonos. Он фиксирует полный жизненный цикл каждого события заказа, обрабатываемого модулем, -- импорт, синхронизацию отслеживания, отмены и исходящие запросы на отмену в Zonos, -- включая как успешные, так и неуспешные операции.

Каждая запись содержит идентификатор заказа Zonos, идентификатор заказа Miva и, где это уместно, данные на уровне покупателя, например, ответ об ошибке от API Miva или Zonos. Это делает журнал наиболее полным источником информации для диагностики проблем.

Журнал хранит только последние 500 строк. Более старые записи не архивируются, поэтому проверяйте журнал сразу после возникновения проблемы -- более ранние события могут быть уже перезаписаны.

Публичный журнал ошибок (без входа в систему)

Доступен второй, общедоступный журнал по прямой ссылке -- без входа в админ-панель Miva. Он фиксирует только ошибки (без успешных операций) и не содержит персональных данных покупателей или конфиденциальной информации. Каждая запись начинается с версии модуля (например, [v10.09]) для быстрой идентификации.

Формат URL:

https://[store-domain]/mm5/json.mvc?Store_Code=[miva_store_code]&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Пример:

https://dts4509.mivamerchantdev.com/mm5/json.mvc?Store_Code=Test&Function=Module&Module_Code=igs&Session_Type=runtime&Module_Function=JSON_WebHook&publiclog=1

Store Code: miva_store_code возвращается в массиве metadata в ответе API для всех заказов панели управления.

Все возвраты платежей должны обрабатываться напрямую через панель управления Zonos. Кнопки Refund, Capture и Void в Miva недоступны для заказов, импортированных из Zonos, -- это сделано намеренно. Любые возвраты, обработанные в Zonos, не обновляют автоматически суммы платежей по соответствующему заказу в Miva -- заказ в Miva сохраняет исходные списанные суммы и не синхронизируется с активностью по возвратам в Zonos.

Для отмены заказа поведение зависит от текущего статуса заказа:

• Open (еще не отправлен): Отмена в Miva также отменит заказ в Zonos и аннулирует авторизацию платежа. Поскольку Zonos не списывает оплату до отправки заказа, с покупателя фактически никогда не взимается плата, и отдельный возврат не требуется.
• Shipped или Completed: Отмена в Miva пометит заказ в Miva как отмененный, но Zonos отклонит отмену, поскольку заказ уже выполнен и больше не подходит для автоматической отмены. В этом случае к заказу в Miva добавляется заметка, видимая только сотрудникам магазина (и никогда не покупателю), объясняющая, что заказ нужно обработать в Zonos. Также отправляется уведомление по электронной почте на основной адрес электронной почты аккаунта магазина, оповещающее продавца о необходимости действий в панели управления Zonos, где он может вручную оформить применимый возврат.

Симптом: Заказы завершаются в Zonos Checkout и отображаются в панели управления Zonos, но ничего не появляется в админ-панели Miva.

Причина: Zonos отправляет вебхук ORDER_CREATED (HTTP POST) на эндпоинт /mm5/json.mvc вашего магазина. На dev-сайтах защита на уровне сервера часто блокирует этот запрос до того, как он достигнет Miva. Распространенные причины:

• HTTP Basic Auth -- Если на dev-сайте есть запрос пароля (Plesk, cPanel, .htaccess и т. д.), вебхук отклоняется с ошибкой 401 Unauthorized. Внесите IP-адреса Zonos в белый список в конфигурации .htaccess или Plesk, чтобы они обходили запрос авторизации.
• Cloudflare WAF / IP Access Rules -- Если сайт проксируется через Cloudflare, его правила безопасности могут блокировать POST-запрос до того, как он достигнет вашего сервера. Добавьте правило WAF, разрешающее POST-запросы, путь URL которых содержит /mm5/json.mvc, либо внесите IP-адреса Zonos напрямую в белый список в Cloudflare IP Access Rules.
• Ограничение доступа по IP на уровне сервера -- Если dev-сайт ограничивает трафик только определенными IP-адресами (что распространено на staging-средах, привязанных к офисным или платформенным IP), запросы вебхуков Zonos будут молча отклоняться без какого-либо ответа. Добавьте все IP-адреса доставки вебхуков Zonos в белый список вашего сервера (Plesk IP Access Restriction Manager, cPanel IP Blocker или настройки безопасности вашего файрвола/хостинг-панели).

IP-адреса доставки вебхуков Zonos

195.85.106.100/32
67.207.37.24/29
18.118.243.230/32
18.191.115.116/32
18.216.243.49/32
18.218.198.53/32
18.221.118.18/32
18.223.39.35/32
3.128.123.176/32
3.132.179.92/32
3.138.165.252/32
3.19.11.176/32
3.22.153.63/32
52.15.215.38/32

Обычно это затрагивает только dev/staging-сайты -- боевые сайты Miva, как правило, публичны и не требуют внесения IP в белый список. Если вы не уверены, как это настроить, обратитесь к своему хостинг-провайдеру или в поддержку Miva.

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

• Вес: Вес влияет на стоимость доставки, что может влиять на пошлины или налоги. Веса в ваших справочниках продуктов Miva автоматически используются Zonos при наличии.
• Размеры: Размеры могут влиять на стоимость доставки, что может влиять на пошлины или налоги. Zonos может использовать размеры продукции (длину, ширину и высоту), установленные для каждого продукта в Miva, но вы должны сопоставить их в приложении Zonos для надлежащей интеграции.
• Коды HS: Коды HS влияют на размер пошлин и могут иногда влиять на налоги. Zonos может использовать коды HS, установленные в ваших справочниках продуктов в Miva, но вы должны сопоставить поле кода HS в приложении Zonos.
• Страна происхождения: Страна происхождения продукта влияет на размер пошлин и может влиять на налоги. Miva не может отправить страну происхождения ваших продуктов в Zonos, поэтому их необходимо добавить с помощью Zonos Catalog.

Детали продукта, передаваемые в Zonos компанией Miva 

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

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