Контрольный список интеграции
Следуйте этому полному контрольному списку для установки учетной записи Zonos Dashboard и интеграции расширения Zonos Checkout для WooCommerce.
Создайте учетную запись Zonos
Для начала свяжитесь с нашей командой продаж, чтобы создать учетную запись и подписать соглашение. После подписания соглашения вы получите два микродепозита в вашу учетную запись, которые необходимо проверить.
Пожалуйста, отправьте суммы микродепозитов на адрес accounting@zonos.com со своим идентификатором магазина Dashboard (CC вашего торгового представителя).
После проверки ваши реквизиты банка появятся в разделе Dashboard -> Settings -> Billing.
Настройте параметры Dashboard и Checkout
После создания учетной записи Zonos вам необходимо настроить параметры в Dashboard, чтобы Checkout правильно работал с вашим магазином. В этом разделе рассматриваются все необходимые конфигурации Dashboard.
Установите выплаты
Подключите банковский счет для получения своевременных выплат из Checkout. Выплаты обрабатываются ежедневно в течение 2 дней с момента захвата платежа. Для этого выполните следующие действия:
- Перейдите на страницу Dashboard -> Settings -> Checkout settings .
- Нажмите кнопку Add bank account.
- Вы будете перенаправлены на портал Stripe для завершения настройки и предоставления следующей информации:
- Информация о банковском счете.
- EIN компании.
- Номер социального страхования владельца компании, владеющего 25%. Дополнительную информацию о том, почему это требуется, см. в документации Stripe.
Примечание: Если вам необходимо обновить график выплат, обратитесь в support@zonos.com
Установите разрешенные домены
Zonos Checkout требует список разрешенных доменов в целях безопасности. Это предотвращает загрузку Checkout неавторизованными сайтами и гарантирует его запуск только на одобренных вами доменах. Без этой конфигурации Checkout вернет ошибки разрешения.
Для установки:
- Перейдите на страницу Dashboard -> Settings -> Checkout settings.
- В разделе URLs добавьте свой полный домен и любые поддомены, где будет использоваться Checkout. Например, если ваш домен
example.com, вы должны добавитьexample.comиtest.example.com.
Настройте параметры фирменного стиля
Настройте параметры фирменного стиля в Dashboard, чтобы они соответствовали внешнему виду вашего магазина.
Для этого выполните следующие действия:
- Перейдите на страницу Dashboard -> Settings -> Checkout settings -> Branding
- Настройте следующие параметры:
- Логотип.
- Цвета бренда и акцента.
- Тема, стиль и шрифт.
Дополнительную информацию о параметрах фирменного стиля см. в нашей документации.
Подключите перевозчика доставки
Чтобы получить расценки доставки при оформлении заказа, вам необходимо подключить перевозчика доставки к вашей учетной записи Zonos. Это позволит вам включить определенные уровни услуг доставки при оформлении заказа.
Чтобы подключить перевозчика доставки, выполните следующие действия:
- Перейдите на страницу Dashboard -> Settings -> Shipping -> Rates.
- Нажмите кнопку Add carrier.
- Следуйте инструкциям по настройке перевозчика.
Дополнительную информацию о подключении учетных записей перевозчиков см. в нашей документации.
Установите зоны доставки
Зоны доставки позволяют вам настроить, какие перевозчики доставки и уровни услуг доступны для разных регионов мира.
Чтобы установить зоны доставки, выполните следующие действия:
- Перейдите на страницу Dashboard -> Settings -> Shipping -> Locations.
- Нажмите кнопку New zone.
- Введите название зоны и выберите страны, в которые вы хотите доставлять товары.
- Выберите перевозчика и уровень обслуживания, которые вы хотите предложить.
Дополнительную информацию о зонах доставки см. в нашей документации.
Установите страну происхождения и код HS по умолчанию
Страна происхождения и код HS используются для расчета точных таможенных платежей и налогов.
Если вы не предоставите конкретную страну происхождения или код HS, мы будем использовать значения по умолчанию, установленные в Dashboard.
Чтобы установить страну происхождения и код HS по умолчанию:
- Перейдите на страницу Dashboard -> Settings -> Shipping -> Catalog.
- Для страны происхождения выберите страну, где производится большинство ваших товаров.
- Для кода HS введите код HS наиболее часто встречающегося товара. Если у вас нет кода HS, перейдите на страницу Classify в Dashboard и введите название и описание вашего товара для создания точного кода HS.
Установите и настройте расширение Checkout для WooCommerce
Следуйте этим шагам для установки и настройки расширения Checkout для WooCommerce.
Установите расширение
- Войдите в административную панель WordPress.
- В разделе плагины найдите расширение Zonos Checkout for WooCommerce.
- Нажмите кнопку Install and activate.
Подключите расширение к вашей учетной записи Zonos
-
В административной панели WordPress нажмите на расширение Zonos Checkout в левой навигации.
-
Нажмите на General Settings.
-
Введите ваш Private API key и Store ID, чтобы связать параметры Zonos Dashboard с вашим сайтом WooCommerce.
-
Найдите приватный API ключ вашего магазина в Dashboard. Доступны несколько различных API ключей. Выберите API ключ с названием вашего магазина, у которого Type (Тип) имеет значение Secret (Секрет) и Token начинается с
credential_live. Введите этот API ключ в поле Private API Key в разделе General settings расширения. -
Скопируйте ваш Store ID из Dashboard и введите его в поле Store ID в разделе General settings расширения.
-
-
Включите приложение в режиме тестирования.
- По умолчанию Test mode включен. Когда режим тестирования включен, покупатели не будут перенаправлены на Zonos Checkout.
Настройте кнопку международного оформления заказа
У вас есть два варианта для настройки того, как международные покупатели получают доступ к Zonos Checkout.
Используйте вашу текущую кнопку оформления заказа для отечественных и международных покупателей:
Настройте вашу текущую кнопку оформления заказа, чтобы автоматически перенаправлять международных покупателей на Zonos Checkout, сохраняя стандартный процесс оформления заказа для отечественных покупателей. Для этого выполните следующие действия:
- В разделе General settings расширения введите CSS селектор вашей кнопки оформления заказа (например,
#checkout-buttonили.woocommerce-checkout-button). - Нажмите кнопку Save general settings.
Чтобы найти ваш CSS селектор, щелкните правой кнопкой мыши на кнопке оформления заказа, выберите "Inspect" и посмотрите на атрибут id или class в HTML. Если у вас есть несколько кнопок оформления заказа, либо включите CSS селектор каждой кнопки, либо настройте все кнопки для перенаправления на страницу корзины и используйте селектор кнопки оформления заказа со страницы корзины.
Добавьте выделенную кнопку международного оформления заказа
Создайте выделенную кнопку международного оформления заказа, которая идеально подходит, если у вас много пользователей VPN или покупателей из США, которым нужно доставлять товары по международным адресам.
Для создания отдельной кнопки для международных покупателей:
-
В разделе General settings расширения введите CSS селектор вашей кнопки оформления заказа (например,
#checkout-buttonили.woocommerce-checkout-button). -
Переведите переключатель International checkout button вправо.
-
Настройте внешний вид кнопки:
- Введите текст кнопки (например, "International Checkout" или "Global Checkout").
- (Опционально) Добавьте пользовательский CSS для соответствия дизайну вашего магазина, как показано в примере ниже. Если пользовательский CSS не предоставлен, кнопка будет использовать основную цветовую схему вашего магазина. Мы рекомендуем протестировать внешний вид кнопки на настольных и мобильных устройствах.
-
Нажмите кнопку Save general settings.
Включить США в зоны доставки: Когда включено, выделенная кнопка международного оформления заказа будет появляться для всех покупателей. Чтобы разрешить покупателям из США использовать международное оформление заказа (например, при использовании VPN или доставке по международному адресу), вам необходимо включить США в Shipping zones в Dashboard. Без этого параметра покупатели из США не будут перенаправлены на Zonos Checkout.
Сопоставьте параметры WooCommerce
Настройте Zonos для бесшовной интеграции с вашим магазином WooCommerce, обеспечивая точные расчеты таможенных платежей, налогов и доставки. Используйте вкладку Mapping settings для приведения в соответствие деталей товара и атрибутов с вашей электронной коммерцией. Хотя предоставляются значения по умолчанию, вы можете настроить эти параметры в соответствии с уникальными требованиями вашего магазина.
Детали товара, пользовательские детали, вес и размеры
Эти поля сопоставлены со значениями по умолчанию. Поля, отмеченные звездочкой (*), являются обязательными. Если вы используете стороннее приложение, которое переопределяет любые поля (*), убедитесь, что эти поля (*) правильно сопоставлены со значениями, которые использует стороннее приложение.
Атрибуты товара
Если ваши товары имеют уникальные атрибуты, такие как цвет или размер, применяемые к вариантам, вам необходимо сопоставить эти атрибуты в расширении Zonos. Это гарантирует, что при выполнении заказа ваш магазин WooCommerce и инвентарь будут обновлены с правильным товаром, который был отправлен. Для сопоставления атрибутов следуйте инструкциям в нашей документации по сопоставлению атрибутов товаров WooCommerce.
Примечание: Если у вас есть вопросы или вам нужна помощь в сопоставлении вариантов товаров, обратитесь в support@zonos.com.
Протестируйте вашу интеграцию
Теперь, когда вы установили свою учетную запись и приложение, вы готовы протестировать вашу интеграцию.
Для размещения тестового заказа при оформлении заказа:
- Добавьте
?zonosTestMode=1к URL вашего магазина, чтобы быть перенаправленным на Zonos Checkout. - Измените Zonos Hello на страну, которую вы хотите протестировать, нажав на флаг Hello и выбрав страну, которую вы хотите протестировать. Это необходимо, иначе вы не будете перенаправлены на Zonos Checkout, если используете одну кнопку оформления заказа. Вы можете обновить Hello, изменив zCountry= в URL на любую страну, которую вы хотите протестировать. Например, если вы хотите протестировать Канаду, вы должны ввести CA в zCountry=CA.
- Пройдите через процесс оформления заказа и разместите заказ. Дополнительную информацию см. в нашей документации по тестированию.
- После завершения тестирования включите Zonos, переведя Test mode на off. Это сделает вашу интеграцию активной и позволит международным покупателям использовать Zonos Checkout.
Помните о следующем:
- De minimis — если промежуточный итог корзины вашего заказа ниже de minimis страны доставки, может не быть никаких таможенных платежей или налогов. Это отражается в наших расчетах.
- Возвраты и отмены — мы собираем платеж, поэтому если вам нужно произвести возвраты или отмены, пожалуйста, обработайте их в Dashboard.
- Этикетки — печатайте этикетки для всех международных заказов в Dashboard, если вы не сертифицированы для печати этикеток вне Dashboard. Это требуется, чтобы Zonos мог уплатить таможенные платежи и налоги от вашего имени.
Post-интеграция
Ваше расширение Zonos будет автоматически импортировать заказы из Zonos в WooCommerce. Однако могут быть редкие случаи, когда заказ может не импортироваться или статус заказа в WooCommerce может быть рассинхронизирован с Dashboard. Вы можете использовать следующие функции в расширении для импорта заказов, синхронизации статусов заказов вручную и включения расширенных параметров для диагностики проблем.
Вручную импортируйте заказы
Если заказ Zonos не был импортирован в WooCommerce, вы можете использовать вкладку Order import для ручного импорта заказов в WooCommerce:
- Войдите в Dashboard.
- Перейдите на страницу Orders.
- Щелкните на заказ, который необходимо импортировать, и скопируйте номер заказа Zonos.
- В административной панели WordPress перейдите на вкладку Order import в расширении Zonos и введите номер заказа Zonos в поле Zonos order number.
- Нажмите кнопку Import order. Если заказ был успешно импортирован, заказ появится в WooCommerce и вы увидите баннер "Order imported successfully" в верхней части страницы. Если импорт заказа не удался, вы увидите баннер с деталями сообщения об ошибке.
Вручную синхронизируйте заказы
Если статус заказа в WooCommerce не совпадает со статусом в Zonos, вы можете вручную синхронизировать заказ.
- Войдите в Dashboard.
- Перейдите на страницу Orders.
- Щелкните на заказ, который необходимо импортировать, и скопируйте номер заказа Zonos.
- В административной панели WordPress перейдите на вкладку Order sync в расширении Zonos и введите номер заказа Zonos в поле Zonos order number.
- Нажмите кнопку Sync order. Статус заказа в WooCommerce должен совпадать со статусом заказа в Dashboard.
Расширенные параметры
Режим отладки
Включите Debug mode для отправки детальных журналов в Zonos, чтобы помочь вам диагностировать любые проблемы и улучшить производительность вашей интеграции.
Ограничение скорости
Максимальное количество запросов webhook, разрешенных для одного IP адреса в минуту. По умолчанию значение составляет 30, чтобы защитить от потенциального злоупотребления.
Общее устранение неполадок
Если вы используете приложение для кэширования, такое как WP Rockett, вам необходимо очистить кэш при внесении изменений в ваше расширение Zonos.
Часто задаваемые вопросы
Какую информацию о товаре я должен предоставить для наиболее точной оценки таможенных платежей, налогов и стоимости доставки?
Информация о товаре может влиять на размер подлежащих оплате таможенных платежей и налогов, а также на общую стоимость доставки. Чем больше информации о товаре вы предоставите Zonos, тем точнее будет полученная оценка. Zonos может создать оценку даже при отсутствии этой информации, но рекомендует предоставить следующие ключевые детали товара для улучшения точности:
- Вес: Вес влияет на стоимость доставки, которая может влиять на таможенные платежи или налоги. Веса в ваших списках товаров WooCommerce автоматически используются Zonos при сопоставлении. Вы также можете добавить вес в Catalog в Dashboard, чтобы обеспечить точные расчеты доставки.
- Размеры: Размеры используются для расчета габаритного веса. Перевозчики начисляют большее значение между физическим весом и габаритным весом. Zonos может использовать размеры товара (длину, ширину и высоту), установленные для каждого товара в WooCommerce, для расчета габаритного веса, чтобы убедиться, что вы собираете от ваших клиентов правильную сумму доставки. Вы также можете добавить размеры в Catalog в Dashboard, чтобы обеспечить точные расчеты доставки.
- Коды HS: Коды HS влияют на таможенные ставки и иногда могут влиять на налоги. Вы можете сопоставить значения кода HS в WooCommerce или использовать Catalog в Dashboard.
- Страна происхождения: Страна происхождения товара влияет на таможенные ставки и может влиять на налоги. Вы можете сопоставить значения страны происхождения в WooCommerce или использовать Catalog в Dashboard.
Zonos Checkout для WooCommerce
Интегрируйте расширение Checkout для WooCommerce.