OZON ПВЗ

Оперативная поддержка — быстро отвечаем и помогаем! Предлагайте новые функции и настройки — добавим их по вашим пожеланиям.

OZON ПВЗ — доставка в пункты выдачи для Webasyst

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

Системный плагин не привязан к конкретному домену или хостингу. Для каждого магазина используются собственные реквизиты Ozon. Работа с картой, дополнительными полями и оформлением зависит от возможностей приложения Webasyst и темы.

Что получает покупатель

Выбор доступного пункта выдачи в своём городе и регионе России.

Адрес и сведения о ПВЗ, которые предоставляет Ozon.

Стоимость и срок доставки с учётом настроек магазина.

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

Что можно настроить владельцу магазина

Подключение через Client ID, Client Secret и штрихкод метода отгрузки Ozon Delivery API.

Наценку в рублях и процентах к тарифу перевозчика.

Фиксированную стоимость доставки для покупателя.

Бесплатную доставку при достижении заданной суммы товаров после скидок.

Дополнительные календарные дни на сборку заказа.

Резервные вес и размеры упаковки для расчёта, ограничения веса.

Режим расчёта списка ПВЗ, срок хранения расчётов в кэше и количество новых обращений к API.

Параметры обновления справочника пунктов и допустимый возраст данных.

Как рассчитывается цена доставки

Сначала проверяются ограничения пункта и возможность доставки через Ozon. Затем применяются условия магазина: порог бесплатной доставки, фиксированная цена либо тариф с наценками. Недоступный маршрут или ошибка API не превращаются в бесплатную доставку.

Для тарифа перевозчика используется формула: (доставка + страховка + наценка в рублях) × (1 + наценка в процентах / 100) .

Пример: если доставка и страховка вместе стоят 300 ₽, наценка в рублях составляет 20 ₽, а процентная наценка — 10%, покупатель увидит 352 ₽. Это пример работы формулы, а не действующий тариф Ozon.

Фиксированная цена: пустое поле оставляет расчёт по API. Значение 0 означает бесплатную доставку для всех подходящих заказов. Наценки к фиксированной цене не прибавляются.

Бесплатно от суммы: учитывается сумма товаров после скидок. Пустое поле или 0 отключает порог. Выполненный порог имеет приоритет перед фиксированной ценой.

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

Два режима расчёта ПВЗ

Индивидуальный расчёт включён по умолчанию. Показываются варианты, для которых получен собственный расчёт. Чтобы ограничить время ожидания, количество новых запросов за одно обращение задаётся в настройках; по умолчанию — 5. Готовые расчёты используются из кэша. Поэтому список в этом режиме может содержать меньше пунктов, чем загружено в справочник.

Предварительная оценка по городу — дополнительный режим. Его можно использовать только после проверки, что оформление заказа повторно рассчитывает доставку после выбора конкретного пункта. Оценка не заменяет окончательную проверку выбранного ПВЗ.

Вес, упаковка и доступность

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

Обновление пунктов выдачи

Справочник загружается порциями через планировщик заданий. Большой список может потребовать нескольких запусков. Следующий запуск продолжает незавершённое обновление. После успешной загрузки полный цикл повторяется каждые 12 часов. В настройках можно проверить состояние обновления. Просроченные пункты исключаются из предложений.

Для Shop-Script настройте запуск каждые 5 минут: php /абсолютный/путь/к/сайту/cli.php shop shipping . Путь к PHP и сайту уточняется в панели хостинга. Для другого приложения требуется его штатный механизм синхронизации системных доставок.

Подключение по шагам

Установите плагин и добавьте способ доставки «OZON ПВЗ» в настройках приложения.

Получите собственные Client ID, Client Secret и штрихкод метода отгрузки для Ozon Delivery API. Введите их в разделе подключения.

Проверьте параметры посылки, наценки, фиксированную цену, бесплатную доставку и дополнительные дни на сборку.

Настройте планировщик и дождитесь завершения первого обновления справочника.

Включите доставку. До завершения настройки она выключена по умолчанию.

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

Требования и совместимость

Webasyst с интерфейсом системных доставок и синхронизацией, фреймворк 1.13 или новее.

PHP 7.4 или новее, 64-разрядная версия, расширения cURL и mbstring.

Доступ сервера к HTTPS-адресам xapi.ozon.ru и api-delivery.ozon.ru.

Действующее подключение Ozon Delivery API и подходящий метод отгрузки.

Приложение должно передавать адрес и телефон получателя и поддерживать системные плагины доставки.

Для Shop-Script рекомендуется актуальная версия со штатным оформлением заказа. Сторонние темы и нестандартное оформление требуют отдельной проверки.

Данные подключения

В поставке нет ключей конкретного магазина. Справочники разделены по Client ID; служебные данные подключения и кэш размещаются в защищённой области Webasyst. Телефон получателя передаётся в Ozon для расчёта. Ключи и содержимое запросов не записываются в журнал плагина. При использовании Nginx должны действовать штатные правила защиты служебных каталогов Webasyst.

Частые вопросы

Почему список ПВЗ пуст?

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

Обязательно ли указывать телефон?

Для окончательного расчёта нужен телефон получателя. Резервный статичный телефон предназначен только для предварительного списка и не заменяет телефон покупателя.

Будет ли карта в любой теме?

Плагин передаёт координаты штатному механизму Webasyst. Отображение карты зависит от приложения, темы оформления и настройки картографического сервиса.

Создаёт ли плагин отправления?

Версия 1.1.0 предназначена для выбора ПВЗ и расчёта доставки. Создание отправлений, печать этикеток, вызов курьера и отслеживание в неё не входят. Это интеграция Ozon Delivery API, а не Ozon Seller API.

География и валюта

Расчёт доставки по России, стоимость в рублях. Доступность конкретного направления определяет Ozon.

В галерее показан реальный интерфейс настроек версии 1.1.0 на отдельной демонстрационной копии без подключения к Ozon: общий экран, тарифы и сроки, параметры справочника ПВЗ. Это не снимки действующего расчёта или реального заказа.

Статус версии 1.1.0

Выполнены локальные проверки PHP и 31 тестовый сценарий с базовыми классами Webasyst и тестовыми данными приложения, базы и API. Полная установка с MySQL и живой расчёт Ozon на отдельном магазине ещё требуют проверки до публичного выпуска.

Разработчик: Prof-inet. Независимая интеграция, не официальный продукт Ozon.