Интеграция Ozon доставки с Woocommerce

Инструкция по установке и настройке WP LAB — Ozon Доставка

В этой инструкции рассмотрим подключение Ozon Delivery к интернет-магазину WooCommerce: от установки плагина и получения API-ключей до выбора пунктов выдачи покупателями и обработки отправлений.

1. Установка плагина

1. Скачайте ZIP-архив плагина WP LAB — Ozon Доставка.
2. Откройте административную панель WordPress.
3. Перейдите в раздел Плагины → Добавить плагин → Загрузить плагин.
4. Выберите скачанный ZIP-архив и нажмите «Установить».
5. После установки нажмите «Активировать плагин».

После активации в административном меню WordPress появится раздел «Ozon Доставка». Важно: для работы необходим установленный и активированный WooCommerce.

2. Активация лицензии

Перед настройкой интеграции необходимо активировать лицензию WP LAB.

1. Откройте раздел Ozon Доставка → Лицензия.
2. Введите лицензионный ключ, полученный после приобретения плагина.
3. Выполните активацию лицензии.
4. Убедитесь, что лицензия имеет активный статус.

Лицензия используется для получения доступных обновлений.

3. Получение Client ID и Client Secret Ozon

Для взаимодействия с Ozon Delivery API необходимо создать приложение и получить учётные данные.

1. Войдите в кабинет Ozon, в котором доступна интеграция с Ozon Delivery API.
2. Откройте раздел управления API-интеграциями или приложениями.
3. Перейдите к созданию частного приложения.
4. При настройке разрешений выберите «Все методы Delivery API».
5. Создайте приложение.
6. Скопируйте выданные Client ID и Client Secret.

Обратите внимание: Client Secret является конфиденциальным ключом. Не публикуйте его на сайте и не передавайте посторонним лицам. Для успешной работы доставки в аккаунте Ozon также должны быть доступны необходимые логистические методы и пункты отгрузки.

4. Подключение Ozon Delivery API

1. Откройте Ozon Доставка в административной панели WordPress.
2. Найдите блок «Подключение Ozon Delivery».
3. Введите полученные Client ID и Client Secret.
4. Нажмите «Проверить и сохранить».
5. Дождитесь результата проверки подключения.

После успешной проверки учётные данные будут сохранены. Плагин сможет получать OAuth-токен и взаимодействовать с Ozon Delivery API. Если требуется заменить ключи, воспользуйтесь кнопкой «Изменить». Для удаления сохранённых данных предусмотрена кнопка «Очистить данные». Важно: если проверка подключения завершилась ошибкой, убедитесь в правильности ключей, наличии необходимых разрешений и доступности Ozon API с сервера вашего сайта.

5. Настройка методов доставки Ozon

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

1. На странице настроек найдите блок «Методы доставки Ozon».
2. Нажмите «Показать доступные методы».
3. Дождитесь загрузки методов из Ozon Delivery API.
4. Выберите подходящий метод доставки.
5. Проверьте выбранные пункты отгрузки и возврата.

Если нужного метода нет, воспользуйтесь кнопкой «+ Создать новый метод». В форме создания метода заполните необходимые параметры, включая пункты отгрузки и возврата. Пункты можно выбирать из списка или через интерактивную карту. Для использования карты необходимо предварительно подключить Яндекс Карты. Если пункт возврата совпадает с пунктом отгрузки, используйте переключатель «Совпадает с пунктом отгрузки». Важно: доступность методов определяется настройками и возможностями вашего аккаунта Ozon. Если Ozon не возвращает подходящие методы, проверьте настройки логистики и доступность соответствующих услуг в кабинете.

6. Загрузка базы пунктов выдачи

Плагин использует локальную базу ПВЗ Ozon для быстрого поиска пунктов выдачи при оформлении заказов. Перед началом использования необходимо загрузить базу пунктов.

1. Откройте блок «База пунктов выдачи Ozon».
2. Нажмите «Обновить сейчас».
3. Дождитесь начала загрузки данных.
4. Для просмотра прогресса используйте кнопку «Обновить статус».
5. После завершения убедитесь, что в базе появились пункты выдачи.

Обновление базы выполняется в фоновом режиме с использованием WP-Cron. Во время обновления действующая база продолжает работать. Новые данные начинают использоваться после успешного завершения обновления.

Импорт и экспорт базы ПВЗ

Если база пунктов выдачи уже загружена на другом сайте, её можно перенести без повторного получения полного списка из API Ozon. Экспорт базы:

1. Откройте раздел «Импорт и экспорт базы ПВЗ».
2. Нажмите «Экспортировать базу (.csv)».
3. Сохраните полученный CSV-файл.

Импорт базы:

1. Откройте тот же раздел на сайте, куда необходимо перенести базу.
2. Выберите CSV-файл в поле «Файл базы ПВЗ (.csv)».
3. Нажмите «Импортировать базу».
4. Отслеживайте процесс с помощью кнопки «Обновить статус импорта».

Примечание: при импорте большого файла на сервере должны быть установлены достаточные ограничения на размер загружаемых файлов.

7. Подключение Яндекс Карт

Яндекс Карты позволяют покупателям выбирать пункты выдачи в удобном всплывающем окне с поиском, списком адресов и интерактивной картой. Подключение карты не является обязательным. Без API-ключа покупатели смогут выбирать ПВЗ из списка.

Получение API-ключа

1. Перейдите на сайт Яндекс Maps API.
2. Авторизуйтесь в аккаунте Яндекса.
3. Создайте API-ключ для JavaScript API и HTTP Геокодера либо подходящего продукта JavaScript API Карт.
4. Убедитесь, что ключ поддерживает JavaScript API версии 2.1.
5. При необходимости настройте оплату или тариф в соответствии с условиями Яндекса.
6. Добавьте ограничение использования ключа по домену вашего сайта (HTTP Referer).
7. Скопируйте полученный API-ключ.

Добавление ключа в плагин

1. Перейдите в настройки WP LAB — Ozon Доставка.
2. Откройте блок «Яндекс Карты».
3. Вставьте ключ в поле «API-ключ Яндекс Карт».
4. Нажмите «Сохранить ключ».
5. Откройте оформление заказа и проверьте работу карты.

После подключения покупателям будет доступен выбор ПВЗ на карте. Та же карта используется в настройках методов для выбора пунктов отгрузки и возврата. Важно: если карта не отображается, проверьте правильность API-ключа, разрешённый домен и доступность API Яндекса.

8. Добавление доставки Ozon в WooCommerce

После настройки Ozon API необходимо добавить способ доставки в соответствующую зону WooCommerce.

1. Перейдите в WooCommerce → Настройки → Доставка → Зоны доставки.
2. Откройте существующую зону или создайте новую.
3. Убедитесь, что зона охватывает нужные регионы доставки.
4. Нажмите «Добавить способ доставки».
5. Выберите «Ozon Доставка».
6. Добавьте способ в зону и включите его.
7. Откройте настройки добавленного способа.
8. Проверьте название и режим расчёта стоимости.
9. Сохраните изменения.

Для расчёта актуальной стоимости через Ozon необходимо использовать режим расчёта по API. Если выбран режим бесплатной доставки, стоимость будет определяться соответствующей настройкой способа, а не тарифом Ozon API. Обратите внимание: покупателю отображаются только те способы доставки, которые доступны для его зоны доставки WooCommerce.

9. Настройка расчёта стоимости

В настройках плагина находится блок «Предварительный расчёт». В нём доступен переключатель «Требовать телефон покупателя для расчёта стоимости». Если переключатель включён, расчёт доставки выполняется после указания номера телефона покупателя. Если переключатель выключен, для предварительного запроса стоимости используется технический номер телефона, предусмотренный плагином. Технический номер не заменяет телефон покупателя в оформленном заказе. При расчёте стоимости учитываются выбранный ПВЗ, метод отгрузки и параметры товаров в корзине. При необходимости Ozon может включать дополнительные расходы, например страхование.

10. Настройка автоматического создания отправлений

Плагин позволяет создавать отправления Ozon вручную или автоматически при изменении статуса заказа WooCommerce. Откройте настройки плагина и найдите параметры создания отправлений.

Ручной режим

При выборе режима «Вручную» отправление создаётся администратором непосредственно из карточки заказа WooCommerce. Этот режим рекомендуется использовать для первоначального тестирования интеграции.

Автоматический режим

1. В поле «Способ создания» выберите «Автоматически».
2. В поле «Статус WooCommerce для автоматического создания» выберите статус, при котором нужно создавать отправление.
3. При необходимости включите «Автоматически подтверждать созданный заказ в Ozon».
4. Сохраните настройки.

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

12. Работа с отправлениями из карточки заказа

После оформления заказа откройте WooCommerce → Заказы и выберите нужный заказ. При использовании Ozon Delivery в карточке доступны сведения о доставке и инструменты управления отправлением. В зависимости от текущего состояния можно:

• Создать отправление Ozon.
• Проверить данные перед отправкой.
• Подтвердить созданное отправление.
• Обновить статус отправления.
• Отменить отправление.
• Скачать этикетку PDF.

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

13. Скачивание этикетки PDF

Для подготовки отправления к отгрузке можно получить этикетку Ozon непосредственно из WooCommerce.

1. Откройте заказ WooCommerce с созданным отправлением Ozon.
2. Убедитесь, что отправление подтверждено и находится в подходящем статусе.
3. Нажмите «Скачать этикетку PDF».
4. Дождитесь получения документа через Ozon Delivery API.
5. Сохраните PDF-файл и распечатайте этикетку.

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

14. Журнал событий

Для диагностики интеграции предусмотрен встроенный журнал. В блоке «Дополнительно» доступен переключатель «Включить журнал логов». Для просмотра записей нажмите «Открыть логи». Также доступны действия:

• «Скачать лог» — сохранение журнала в файл.
• «Очистить логи» — удаление текущих записей.
• «Обновить» — загрузка актуальных записей журнала.

Журнал рекомендуется оставлять включённым при первоначальной настройке и тестировании.

15. Частые проблемы и решения

Ozon API не подключается

Проверьте правильность Client ID и Client Secret, наличие разрешений Delivery API и возможность сервера устанавливать исходящие HTTPS-соединения.

Не отображаются пункты выдачи

Убедитесь, что локальная база ПВЗ загружена и выбран правильный город. При необходимости выполните обновление базы или импорт CSV.

На карте нет пунктов или карта не открывается

Проверьте ключ Яндекс Карт и ограничение по домену. Убедитесь, что ключ подходит для JavaScript API 2.1. Если карта недоступна, попробуйте выбрать ПВЗ из списка.

Стоимость доставки не рассчитывается

Проверьте выбранный метод доставки Ozon, пункт выдачи, параметры товаров и наличие доступных тарифов для данного направления. Также убедитесь, что способ доставки WooCommerce настроен на расчёт по API, а не на бесплатный режим. Дополнительную информацию об ошибке можно найти в журнале.

Нет доступных методов доставки Ozon

Проверьте настройки логистики в кабинете Ozon, доступность пунктов отгрузки и права API-приложения. Список методов зависит от возможностей и настроек конкретного аккаунта.

Отправление не создаётся

Убедитесь, что заказ содержит необходимые данные получателя, выбран ПВЗ, настроен метод отгрузки и доступно создание отправлений через Ozon API. Посмотрите сообщение об ошибке в карточке заказа и журнале событий.

Не скачивается этикетка

Проверьте, что отправление создано и подтверждено. Если Ozon вернул ошибку, изучите соответствующие записи журнала.

16. Проверка после установки

Перед использованием плагина с реальными заказами рекомендуется выполнить полную проверку интеграции.

1. Проверьте подключение Ozon Delivery API.
2. Убедитесь, что выбран действующий метод доставки.
3. Загрузите локальную базу пунктов выдачи.
4. Настройте зону доставки WooCommerce.
5. Откройте оформление заказа и выберите ПВЗ.
6. Проверьте расчёт стоимости доставки.
7. Измените город и убедитесь, что стоимость обновляется после выбора нового пункта.
8. Оформите тестовый заказ.
9. Проверьте сохранение выбранного ПВЗ в заказе WooCommerce.
10. Проверьте создание отправления и дальнейшие доступные операции Ozon.
11. После подтверждения попробуйте скачать этикетку PDF.

Готово! После успешного выполнения проверок WP LAB — Ozon Доставка готов к использованию в интернет-магазине WooCommerce. Для дополнительной помощи по настройке и работе плагина обращайтесь в поддержку WP LAB.