Озон логистика

Акутальная документация к модулю

Модуль Ipakor: Озон логистика обеспечивает интеграцию интернет-магазина на 1С-Битрикс с логистикой Ozon.

Как работает модуль

Модуль работает по следующей схеме:

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

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

Проверка товаров — перед показом службы доставки модуль проверяет, что все товары из корзины продаются на Ozon с остатками на складе (в зависимости от выбранной схемы: FBO, FBS или MIX).

Оплата заказа — при успешной оплате заказа модуль автоматически создаёт заявку на доставку в Ozon.

Отмена заказа — при отмене заказа на сайте модуль отменяет соответствующий заказ в Ozon.

В этой инструкции мы разберём: создание и настройку приложения в кабинете Ozon, установку и настройку модуля, настройку службы доставки в 1С-Битрикс, а также пример оформления заказа.

Настройка приложения в кабинете Ozon

Ссылка на официальную инструкцию по настройке приложения: https://dev.ozon.ru/start/446-Ozon-Logistika-podkliuchenie-nastroika-i-poriadok-raboty-s-novym-funkt...

Для начала в кабинете продавца нужно перейти в верхнем меню в раздел Товары -> Приложения -> Ozon Доставка. Если у вас ещё не пройдена проверка сайта, то здесь будет кнопка «Подключить». Нажмите кнопку «Подключить».

После этого вы будете перенаправлены во вкладку «Анкета». Здесь необходимо указать контактные данные и ответить на вопросы. Нажмите кнопку «Далее».

Затем заполните информацию о вашем магазине, прикрепите логотип и нажмите «Подключить». Название и логотип магазина будут отображаться в личном кабинете покупателя, позволяя ему определить интернет-магазин, где был оформлен заказ. Ссылка на магазин необходима для перехода покупателя на ваш сайт и выполнения операций с заказом, например, отмены.

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

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

Создание частного приложения

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

Для начала надо заново войти в личный кабинет продавца. Затем заходим в Настройки -> Приложения и разрешения. Выбираем вкладку «Приложения». В правом углу нажимаем кнопку «Создать».

Вводим имя нашего приложения — абсолютно произвольное и на любом языке. Далее видим список разрешений для нашего приложения. Это очень важный момент. Необходимый список разрешений впоследствии нужно будет добавить в настройки модуля Озон логистики.

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

- Позволяет работать с Ozon Логистикой

- Позволяет получать информацию и управлять товарами

- Позволяет получать информацию и управлять постингами в схеме FBS

- Позволяет получать информацию о постингах в схеме FBO

- Позволяет получать информацию и управлять возвратами товаров

- Позволяет получать отчёты

Это 6 разрешений. Можно добавить ещё, если вам понадобится это в будущем, но обязательно не забывать указывать их в настройках модуля. Иначе невозможно будет получить OAuth-токены для работы с Ozon логистикой.

Приложение создано. Можно перейти к системным настройкам приложения. Мы оставим системные настройки открытыми в отдельной вкладке. Вернёмся к этой странице во время настройки модуля.

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

Установка модуля

Итак, установка модуля стандартная. Переходим в административную часть 1С-Битрикс -> Маркетплейс -> Установленные решения. В списке решений ищем решение «IPAKor Интеграция с Ozon логистикой». По клику на бургер слева в выпадающем меню выбираем пункт «Установить». На этом всё, никаких дополнительных действий производить не требуется.

Настройка модуля

Начинаем с перехода на страницу настроек модуля. Для этого в левом меню ищем Настройки -> Настройки продукта -> Настройки модулей -> Ipakor Интеграция с Ozon логистикой.

Первым делом видим вкладку «FAQ» — здесь можно посмотреть ответы на частые вопросы, думаю, такой формат всем уже давно знаком.

Сейчас нас интересует вкладка «Главные настройки API Ozon». Сразу же видим красный индикатор «Нет соединения с API Ozon» и чуть ниже причину: «No token found in database». Ошибка говорящая — очевидно, не настроен OAuth-токен. Давайте настроим.

Первый инпут «Redirect URI» — это обратный URL для приложения Ozon. Фактически здесь можно ввести любой адрес. По этому адресу Ozon отправит несколько параметров, по которым получается OAuth-токен, но рекомендуется оставить адрес как есть, потому что по этому пути при установке модуля копируется файл ozon_callback.php, внутри которого происходит получение и запись OAuth-токена в таблицу приложения. Поэтому я копирую этот адрес и возвращаюсь на страницу настроек частного приложения Ozon.

Здесь этот адрес я вставляю в поле Redirect URI и нажимаю кнопку «Сохранить». Теперь копируем client_id и client_secret со страницы настроек частного приложения и переносим их в настройки нашего модуля в одноимённые поля.

Ниже мы видим поля для Scope. Это как раз минимальный список необходимых разрешений приложения. Такой список стоит в модуле по умолчанию. Если при создании частного приложения вы выбрали другой список Scope, то тогда его нужно отредактировать. Это важно. Если список Scope в частном приложении и в настройках модуля не совпадёт, ссылка на авторизацию для получения OAuth-токена сформируется неправильно, и OAuth-токен не будет получен.

Следующим шагом нажимаем на кнопку «Получить ссылку на авторизацию». Ссылка получена — можем смело переходить!

Если всё в порядке, то должно появиться вот такое окно. Нажимаем «Далее», разрешаем предоставить права. И в этот момент получаем редирект на наш сайт — именно на тот путь, который указан в настройках частного приложения. Здесь сформировался OAuth-токен. Можем возвращаться на страницу настроек модуля для дальнейшей настройки функционала.

Теперь индикатор подключения к Ozon API стал зелёным! Статус: «Соединение с API Ozon успешно установлено».

Настройки модуля

Переходим на следующую вкладку настроек модуля. Нужно настроить схему доставки товаров. Это может быть MIX (то есть система сама определит, каким способом лучше отправить товар), либо можно жёстко указать доставку по FBO или FBS.

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

- Номер телефона. По этому полю определяется, доступна ли пользователю доставка Ozon логистикой. Ведь заказ создаётся в кабинете Ozon пользователя, поэтому он должен обязательно иметь кабинет на Ozon.

- Контактное лицо. Модуль разбивает значение из этого поля через пробел и получает ФИО пользователя.

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

- API-ключ Яндекс.Карт. Это поле не обязательно для заполнения, если у вас на сайте на странице оформления заказа уже подключены Яндекс.Карты, но очень рекомендуется его заполнить. Этот API-ключ используется для центрирования карты по выбранному местоположению на странице оформления заказа. В противном случае карта будет всё время открываться в Москве.

- Также есть галочка «Не подключать скрипт API Яндекс.Карт». Нужно установить эту галочку, если уже другой модуль на странице оформления заказа подключает Яндекс.Карты, чтобы не было конфликта.

Для отладки работы модуля можно включить логирование и выбрать уровень, до которого логировать события в модуле. Тип логирования также можно выбрать. Это может быть файловое логирование (сохраняется в папке модуля в директорию logs), журнал событий Битрикс, либо можно прописать собственный класс логирования, отвечающий требованиям PSR-3, и организовать логирование в нужном месте.

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

Итак, переходим к синхронизации данных.

Синхронизация данных

Следующий шаг — синхронизация данных Ozon с сайтом. На этой вкладке отображён статус синхронизации данных. Есть 3 типа данных: товары, точки на карте и тарифы. Товары и точки на карте синхронизируются в автоматическом режиме, если на вкладке «Настройки» не задано обратное поведение.

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

Тарифы синхронизируются и попадают на сайт из статичной таблицы, которая была взята с сайта Ozon: https://seller-edu.ozon.ru/libra/commissions-tariffs/commissions-tariffs-ozon/rashody-na-dostavku-ch... — это таблица тарифов, универсальные тарифы.

Ozon использует систему ОВХ (объёмно-весовые характеристики). https://seller-edu.ozon.ru/libra/commissions-tariffs/additional-information/obyom-i-obyomnyi-ves

Для расчёта доставки используется количество литров посылки. В модуле ОВХ считается по формуле: Длина (мм) x Ширина (мм) x Высота (мм) / 1 000 000 / 5. Далее идёт сравнение с фактическим весом товара в килограммах и берётся наибольшее значение. Именно по получившемуся значению цена доставки берётся из таблицы тарифов.

Можно загрузить таблицу со своими тарифами, главное, чтобы она соответствовала по структуре таблице от Ozon.

Таблица точек на карте. Здесь какие-то подробные объяснения излишни — это просто координаты точек для отрисовки на карте. Синхронизируется с Ozon 1 раз в день, так как пункты ПВЗ постоянно открываются и закрываются. Информация должна постоянно актуализироваться.

Таблица синхронизации товаров — важнейшая таблица в модуле. По этой таблице модуль сопоставляет товары на сайте и карточки в кабинете Ozon. По умолчанию синхронизация происходит каждые полчаса для того, чтобы информация о возможном способе доставки FBO/FBS была актуальной. Можно указать свой период либо проводить синхронизацию вручную.

Также можно вручную поменять соответствие артикула и bitrix_id на сайте. Может случиться такое, что артикул на Ozon не соответствует ни одному из товаров на сайте либо соответствует не тому товару. Этот момент можно отредактировать вручную — при синхронизации bitrix_id не поменяется.

Служба доставки

Переходим к созданию службы доставки Ozon логистикой.

В административном меню переходим Магазин -> Настройки -> Службы доставки. В правом верхнем углу — Добавить -> Доставка Ozon логистикой. Выбираем название, логотип, описание.

На вкладке «Настройка обработчика Ozon» можно установить наценку на доставку. Тарифы Ozon логистики очень низкие, любая другая доставка стоит в разы дороже, поэтому есть возможность сделать какую-то наценку к тарифам Ozon, чтобы окупить накладные расходы.

Нажимаем «Сохранить». Служба доставки готова к работе. Можно проверять!

Тестовый заказ с Ozon логистикой

Давайте посмотрим, как это работает.

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

При переходе на страницу оформления заказа идёт проверка пользователя по номеру телефона и проверка доступности товара по выбранному типу доставки на Ozon. Если хотя бы одна из проверок не проходит, доставка Ozon не выводится.

Заполняем данные заказа. Выбираем доставку Ozon логистикой. Далее необходимо выбрать пункт выдачи Ozon на карте. Карта центрируется относительно выбранного местоположения в заказе. Если в вашем интернет-магазине не используется стандартное местоположение Битрикс, карта откроется отцентрированной на Москве по умолчанию.

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

Нажимаем кнопку «Забрать здесь». Модуль отправляет запрос в Ozon на возможность доставки в выбранный ПВЗ. Если доставка возможна, это отобразится внизу под логотипом модуля. Далее нажимаем «Оформить заказ». Создаётся заказ со службой доставки Ozon.

Чтобы заказ оформился в кабинете Ozon и начал своё движение по инфраструктуре Ozon, необходимо оплатить заказ. На этом видео я сделаю это руками из административной части.

Захожу в список заказов, выбираю свой заказ, провожу оплату. После этого заказ создаётся в кабинете Ozon. Проверим это, перейдя в кабинет покупателя на сайте Ozon. Здесь мы видим созданный нами заказ с сайта.

Если по какой-то причине заказ не смог создаться в кабинете Ozon (например, клиент долго оплачивал и за это время закончились остатки на нужном складе), то заказ в Битрикс пометится как проблемный и сверху будет написано: «Не удалось создать заказ в Ozon логистике!»

Отмена заказа

При отмене заказа в Битрикс автоматически отменяется заказ в кабинете Ozon. Проверим. Отменю заказ через административную часть. Для этого отменю оплату, затем отменяю заказ. Проверяем наш кабинет Ozon и видим, что заказ отменён.

На этом всё, спасибо за внимание!

В ближайших обновлениях модуля планируется доставка курьером, расширенный список тарифов с привязкой к локациям.