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

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

Для каждого способа получения можно включить собственные правила вместо общих. Например, сделать доставку в ПВЗ бесплатной от одной суммы заказа, а курьером — от другой.
В отгрузке сохраняется состав расчёта: менеджер видит, как получилась цена для покупателя.
Обрабатывайте отправления в БитриксеРаботайте с доставкой из заказа и отгрузки, через раздел «Транспортная заявка»:

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

Отчёт «Товары без веса и габаритов» помогает найти незаполненные позиции каталога. Для таких товаров используются значения по умолчанию, поэтому каталог стоит проверить до начала отправлений.
Сверяйте расчёт с фактическими списаниямиПредварительная стоимость из API может отличаться от итогового списания Ozon. Модуль не скрывает это различие.
Загрузите CSV из финансового отчёта кабинета Ozon в раздел «Калибровка упаковки». Модуль сопоставит списания с предварительным расчётом и поможет оценить, насколько выбранные параметры упаковки соответствуют реальным отправлениям.
Возвраты и диагностикаДля выбора ПВЗ карта не обязательна: список с поиском работает без ключа Яндекс Карт.
Что нужно для подключенияВ штатном оформлении заказа sale.order.ajax виджет подключается автоматически. Для нестандартного оформления предусмотрены компоненты модуля; их подключение может потребовать работы разработчика.
Для обновления справочников и статусов должны выполняться фоновые задачи Битрикса. Получение статусов отправлений включается в настройках автоматизации интернет-магазина.
Что важно знать до установкиНажмите «Попробовать», подключите кабинет Ozon и проверьте полный сценарий: выбор ПВЗ или курьера, расчёт доставки, сохранение данных в заказе и работу с отправлением.
Не уверены, подойдёт ли модуль вашему оформлению заказа? Напишите в поддержку и пришлите адрес магазина, название шаблона и используемый компонент оформления. Это поможет заранее определить, потребуется ли адаптация.
Подготовьте подключение к сервису «Ozon Доставка для бизнеса». Для настройки понадобятся Client ID, Client secret приложения Delivery API и номер метода доставки.
Для курьерской доставки потребуется ключ DaData или Яндекс.Геокодера. Для отображения пунктов выдачи на карте — ключ Яндекс Карт. Без карты выбор ПВЗ работает через список с поиском.
1. Установите модульЗагрузите и установите решение topman.ozondelivery через Marketplace в административной панели сайта.
Служебные свойства заказа и фоновые задачи создаются автоматически.
2. Создайте службу доставкиОткройте:
Магазин → Настройки → Службы доставки → Добавить службу → Ozon Доставка для бизнеса.
В карточке службы заполните:
Используйте реквизиты приложения для «Ozon Доставки для бизнеса», а не ключи интеграции для выгрузки товаров через Seller API.
Сохраните службу и откройте её карточку снова: вверху появится результат проверки — авторизация, пункты выдачи и найденные методы доставки. Номер в поле «Номер метода доставки» должен совпадать с одним из найденных.
3. Добавьте способы полученияНа вкладке «Профили» карточки службы нажмите «Добавить профиль» и создайте нужные способы получения:
Можно подключить оба способа или только один. Служебные свойства заказа привязываются к профилям автоматически.
4. Настройте цену для покупателяОткройте настройки модуля кнопкой «Настройки» в списке установленных решений.
На вкладке «Цена для покупателя» задайте наценку, минимальную стоимость, округление и условия бесплатной доставки. Проверьте настройку учёта страхования.
Если для ПВЗ и курьера нужны отдельные условия, включите в соответствующем профиле «Задать свои правила цены вместо общих».
Важно: правила профиля полностью заменяют общие, а не прибавляются к ним. Проверьте все поля этого блока.
5. Настройте упаковку и адресаНа вкладке «Упаковка» выберите способ определения размеров посылки: справочник коробок, расчёт по объёму товаров или фиксированную коробку.
Проверьте вес и габариты товаров. Позиции с незаполненными данными можно найти в отчёте «Товары без веса и габаритов». Для них модуль использует значения по умолчанию, что влияет на точность расчёта.
Для курьерской доставки на вкладке «Адреса» выберите геокодер и укажите его ключ. При необходимости подключите Яндекс Карты на вкладке «Карта».
6. Загрузите пункты выдачиОткройте страницу «Пункты выдачи» и запустите синхронизацию либо дождитесь фоновой загрузки.
Первичная загрузка справочника требует времени: в нём почти 90 тысяч пунктов. Фоновая задача запускается раз в 10 минут и загружает справочник порциями: при агентах на кроне это около часа, при агентах на хитах — зависит от посещаемости, на сайте без посетителей может занять до суток. Кнопка «Синхронизировать сейчас» загружает одну порцию, её можно нажимать повторно. Убедитесь, что фоновые задачи Битрикса выполняются, а синхронизация завершилась.
На странице «Состояние модуля» (меню Top Man Digital → Ozon Доставка) проверьте, что справочник пунктов заполнен и нет предупреждения о выключенном отслеживании статусов. Подключение и номер метода проверяются в карточке службы доставки (шаг 2), выполнение фоновых задач — в разделе «Настройки → Настройки продукта → Агенты».
7. Проверьте оформление заказаОформите контрольный заказ с реальным телефоном получателя, зарегистрированного в Ozon.
Проверьте:
Пока не выбран пункт выдачи (или не введён адрес) и не указан телефон, вместо стоимости показывается подсказка: Ozon считает цену только по телефону и точке доставки. В корзине стоимость доставки Ozon не показывается.
В штатном шаблоне sale.order.ajax виджет подключается автоматически. Для нестандартного оформления разработчик может использовать компоненты topman:ozondelivery.point.select и topman:ozondelivery.address.
8. Настройте обработку отправленийОткройте заказ, а в нём — отгрузку. На странице отгрузки кнопка «Транспортная заявка» создаёт отправление в Ozon; после создания там же доступны подтверждение, этикетка и отмена. Созданная заявка видна в карточке заказа ссылкой в блоке отгрузки.
Создавайте отправление в Ozon только тогда, когда готовы передать заказ в доставку: действие может повлечь расходы. Автоматическое создание выключено по умолчанию.
Включите получение статусов: «Настройки → Настройки продукта → Настройки модулей → Интернет-магазин», вкладка «Автоматизация процессов». Отметьте «Включить автоматическое обновление», задайте «Период обновления (ч)» — 1–3 часа — и сохраните форму: фоновая задача создаётся при сохранении. Там же можно сопоставить «Статусы отправлений» со «Статусами отгрузок». Без этого статусы Ozon на сайт не приходят.
В настройках модуля на вкладке «Статусы» укажите, при каких состояниях посылки ставить отметки «разрешена доставка» и «отгружено» и в какой статус переводить заказ. По умолчанию статус заказа не меняется.
После проверки оформления заказа и обработки отправлений модуль готов к работе.
Как понять, что настройка завершена
Создание отправления в Ozon может повлечь расходы. Не создавайте и не подтверждайте отправления только ради проверки кнопок. Сначала проверьте оформление и расчёт; отправление создавайте для заказа, который готовы передать в доставку.