Ozon Доставка для бизнеса: подключение и настройка Delivery API

Сервис «Ozon Доставка для бизнеса» доставляет посылки из вашего интернет-магазина через отдельный кабинет Ozon. Размещать карточки товаров на маркетплейсе не требуется. Плагин рассчитывает перевозку и страхование, создаёт заказ через Delivery API, подтверждает отправление к отгрузке и получает этикетку.

Ниже описаны подключение и настройки этого сервиса. Общая установка плагина приведена в инструкции по настройке, отправка и отмена — в статье об обработке заказов.

1. Что подготовить

• Установленный плагин «Ozon Доставка» в Shop-Script.
• Отдельный кабинет доставки Ozon с завершённым подключением и договором страхования.
• Метод доставки в кабинете Ozon с пунктом отгрузки и пунктом получения возвратов.
• Частное приложение с доступом к Delivery API и его Client ID и Client Secret.
• Вес, длину, ширину и высоту товаров в Shop-Script.
• Ключ Яндекс «Геокодер (HTTP)», если будете предлагать курьерскую доставку.
• Средства на балансе кабинета доставки — для подтверждения реальных отправлений.

В этом режиме нет настроек FBO/FBS/MIX, сопоставления товаров с каталогом Ozon и передачи покупательской стоимости доставки. В каждом способе доставки выбирается один сервис; для работы с продавцами и бизнесом одновременно создайте два способа.

2. Подключите кабинет доставки Ozon

Шаг 1. Создайте кабинет

Если кабинет продавца уже есть, откройте Настройки → Кабинет доставки и выберите создание нового кабинета или объединение кабинетов. Раздел доступен сотруднику с ролью «Управляющий». При регистрации с нуля выберите в поле «Сфера деятельности на Ozon» значение «Доставка», заполните данные компании и завершите проверку Ozon.

Шаг 2. Подключите страхование

В кабинете доставки откройте Настройки → Договоры → Заключить договор страхования и завершите подключение. Страхование требуется для работы сервиса. Сумму страхования плагин получает в расчёте Ozon; фиксированный процент в настройках плагина задавать не нужно.

Шаг 3. Создайте метод доставки

На вкладке «Методы доставки» нажмите «Добавить метод доставки». Укажите название, контактный телефон, пункт отгрузки и пункт получения возвратов. Проверьте настройку крупногабаритных товаров при создании метода: встроенная инструкция плагина предупреждает, что позже её изменить нельзя.

Для работы через этот сценарий API используется самостоятельная сдача посылки в пункт Ozon. Курьерская доставка в плагине означает доставку покупателю; вызов курьера для забора посылок со склада магазина плагин не оформляет.

Запишите номер метода доставки, особенно если методов несколько. «Метод доставки» в кабинете Ozon определяет отгрузку, а «способ доставки» в Shop-Script — настройки плагина в магазине.

Порядок действий в кабинете и условия сервиса уточняйте в материалах Ozon: подключение Ozon Доставки для бизнеса и работа через API.

3. Создайте частное приложение Delivery API

В кабинете доставки откройте «Управление частными приложениями», нажмите «Создать» и укажите название, например «Доставка из Shop-Script». Выберите все четыре уровня доступа:

• delivery-api.delivery — расчёт условий доставки;
• delivery-api.delivery-point — пункты выдачи и постаматы;
• delivery-api.order — заказы;
• delivery-api.posting — отправления, подтверждение, статусы, отмена и этикетки.

Используйте ключи этого приложения. Ключи Seller API и уровни доступа seller-api.… из инструкции для продавцов не заменяют доступы Delivery API.

4. Подключите способ доставки в Shop-Script

1. Откройте Магазин → Настройки → Доставка, добавьте «Ozon Доставка», сохраните способ и откройте его настройки.
2. В поле «Сервис» выберите «Ozon Доставка для бизнеса».
3. Заполните «client_id (UUID)» и «client-secret» ключами частного приложения.
4. Сохраните настройки и нажмите «Проверить соединение».
5. Проверьте результат возле кнопки и состояние доступа.

Плагин получает токен автоматически по Client ID и Client Secret. В этом сервисе не нужны redirect URL, кнопка «Авторизоваться» и подтверждение доступа во всплывающем окне. Проверка соединения подтверждает получение токена и обращение к справочнику точек; готовность к реальной отгрузке дополнительно зависит от метода доставки, данных посылки и баланса.

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

5. Укажите метод доставки и загрузите пункты

1. В поле «Метод доставки» укажите номер из кабинета Ozon, если методов несколько.
2. Если метод единственный, поле можно оставить пустым: плагин определит номер по загруженному справочнику пунктов выдачи.
3. Сохраните настройки, нажмите «Обновить пункты выдачи» и дождитесь окончания загрузки.

Автоопределение метода зависит от справочника даже при работе только с курьером. Если пункты не загружены или в них обнаружено несколько методов, укажите номер вручную. Иначе плагин не сможет рассчитать доставку.

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

6. Подготовьте товары и посылку

В Shop-Script заполните вес, длину, ширину и высоту всех отправляемых товаров. Используйте характеристики, которые Shop-Script передаёт плагинам доставки, и проверьте их единицы измерения. Произвольное текстовое поле с размерами эти данные не заменяет.

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

• Один заказ — одно отправление. Автоматического распределения заказа по нескольким коробкам в текущей версии нет.
• Без заполненных габаритов плагин скрывает вариант доставки и записывает причину со списком товаров в журнал.
• Объявленная стоимость берётся из стоимости товаров заказа. В запросе Delivery API она передаётся в рублях.
• Проверка в текущей версии плагина: объявленная стоимость должна быть больше нуля и не превышать 500 000 ₽ на отправление. При превышении плагин не создаёт посылку и предлагает разбить заказ в кабинете Ozon.

Проверку доступности выбранного ПВЗ и конкретного маршрута выполняет Ozon с учётом отправления. Не обещайте покупателю доставку только на основании наличия пункта на карте — дождитесь расчёта.

7. Настройте цену для покупателя

Для курьерской доставки и самовывоза цена задаётся отдельно:

• «Стоимость для покупателя» — ваш базовый тариф; по умолчанию 0.
• «Прибавлять стоимость перевозки» — добавляет оценку перевозки из ответа Ozon; по умолчанию включено.
• «Прибавлять страхование» — добавляет оценку страхования из ответа Ozon; по умолчанию выключено.

Цена доставки = базовый тариф + перевозка, если включена + страхование, если включено. Затем на итог могут повлиять правила и скидки магазина.

Например, при условном тарифе магазина 50 ₽, расчёте перевозки 300 ₽ и страховании 30 ₽ покупатель увидит 350 ₽ с включённой перевозкой или 380 ₽ с обеими надбавками — до скидок. Это пример формулы, а не тариф Ozon.

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

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

Валюта

Delivery API рассчитывает суммы в рублях. Если в способе доставки выбрана другая валюта, плагин использует курсы Shop-Script: переводит объявленную стоимость в RUB, а полученные расходы Ozon — в валюту тарифа. Для этого в магазине должен быть настроен рубль и корректные курсы. Проще начать с валюты RUB.

8. Настройте варианты и сроки

Курьерская доставка

Включите курьера, укажите название варианта и ключ Яндекс «Геокодер (HTTP)». Сохраните настройки и нажмите «Проверить ключ». Для расчёта нужен точный адрес с улицей и номером дома; плагин передаёт его координаты в Ozon.

В режиме для бизнеса показывается расчётный срок в днях. Поля «Дата доставки Ozon» с выбором интервала и отдельного поля «Комментарий курьеру» из режима для продавцов здесь нет.

Самовывоз

Включите самовывоз и при необходимости измените названия пунктов выдачи и постаматов. Список строится по справочнику, а доступность выбранной точки проверяется для посылки. Состав сведений о точках зависит от ответа Delivery API.

Комплектация

Если магазину нужно время на сборку, включите «Учитывать время на комплектацию» и настройте дополнительное время и рабочие часы обработки заказов в Shop-Script. Плагин сдвинет плановую отгрузку, от которой Ozon рассчитывает срок доставки.

Данные получателя

При оформлении нужны город, телефон получателя и выбранный ПВЗ либо точный адрес для курьера. Используйте телефон, которым получатель пользуется на Ozon. Без номера Delivery API не выполняет полный расчёт; если номер можно ввести в форме, плагин показывает соответствующую подсказку. Явный отказ Ozon в доставке этому получателю скрывает способ.

9. Проверьте подключение и начните отправку

1. Оставьте включёнными «Тестовый режим» и «Виден только сотрудникам».
2. Оформите пробный заказ в браузере, в котором вошли в бэкенд. Проверьте телефон, адрес, варианты доставки и цену.
3. Откройте заказ в Shop-Script. В предварительном расчёте проверьте содержимое, вес, размеры, объявленную стоимость, перевозку и страхование.
4. Выполните действие «Отправлен». Убедитесь, что получен номер TEST-…. В Ozon тестовая посылка не создаётся, реальная этикетка не выдаётся.
5. Удалите пробный заказ с отменой тестовой доставки. Убедитесь, что готовы принимать реальные заказы, затем выключите оба ограничения и сохраните настройки.
6. Перед первой реальной отправкой проверьте баланс кабинета Ozon. Плагин после создания заказа автоматически отправит подтверждение готовности к отгрузке.
7. После подтверждения откройте «Этикетка Ozon» среди печатных форм заказа, распечатайте PDF, наклейте этикетку и передайте посылку в пункт отгрузки выбранного метода.

Тестовый режим не проверяет успешность реального подтверждения на балансе Ozon. Если заказ создан, но не подтверждён, его номер сохранится в Shop-Script, а в ленте появится сообщение. Проверьте баланс и подтвердите существующее отправление в кабинете доставки; повторное действие «Отправлен» не выполняет повторное подтверждение уже существующего заказа.

10. Частые затруднения

• Нет кнопки «Авторизоваться»: это штатно для бизнеса. Сохраните ключи и нажмите «Проверить соединение».
• Метод не определён: загрузите пункты выдачи или явно укажите номер метода доставки.
• В кабинете несколько методов: выберите нужный номер в плагине.
• Нет расчёта: проверьте телефон, габариты, объявленную стоимость, выбранный метод и журнал плагина.
• Нет курьера: проверьте ключ HTTP-геокодера и точность адреса.
• Нет выбора даты: Delivery API возвращает расчётный срок, выбор слота в этом режиме не предусмотрен.
• Не хватает баланса или ошибка подтверждения: заказ уже мог быть создан. Найдите его по сохранённому номеру, пополните баланс при необходимости и подтвердите отправление в кабинете Ozon.
• Нет этикетки: проверьте, что отправление реальное и подтверждено к отгрузке; дождитесь статуса «Готово к отгрузке».
• Изменённые товары не обновились в Ozon: плагин не пересоздаёт уже отправленный заказ при сохранении. Проверьте возможность отмены и повторной отправки по инструкции обработки заказов.

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