Установка Ozon Доставки 3.1.0 для 1С-Битрикс

Полный пакет 3.1.0

Инструкция относится к ручному полному пакету bbcoding.ozonlogistic-3.1.0.zip. Его корневая папка — bbcoding.ozonlogistic. SHA-256: 3ce369277349efcb60ef9c06364c1a45e241196a4677ca36e7ffd469a16d520c.

Для первой установки не используйте дельту 3.1.0.zip: это обновление с 3.0.1, а не полный модуль. Выпуск включает оформление доставки Business/Seller из админки и исправление переноса веса отгрузки. Подготовка пакета не означает его публикацию в Marketplace.

Окружение и резервная копия

Нужен магазин 1С-Битрикс с модулями main и sale, доступ администратора и подключение выбранного контура Ozon. В зафиксированной native-приёмке использовались PHP 8.2.33, main 26.750.0 и sale 26.400.0. Числовой минимум Битрикс по одной этой установке не объявляется. Таблица требований на странице ограничена проверенной связкой; другие комбинации проверяйте отдельно.

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

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

Распакуйте корневую папку bbcoding.ozonlogistic в local/modules/. Должен получиться путь local/modules/bbcoding.ozonlogistic/install/version.php. Не создавайте вторую копию рядом с установленным Marketplace-модулем в bitrix/modules: для существующего модуля нужен его штатный канал обновления.

Откройте стандартный раздел установки модулей в административной части 1С-Битрикс и установите Ozon Доставку. Установщик проверяет наличие main и sale и готовность используемых возможностей перед созданием собственных ресурсов.

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

Выбор и подключение контура

Seller предназначен для продавцов Ozon. Для товаров требуется сопоставление с каталогом Ozon по offer_id; подключение выполняется через предусмотренный Seller OAuth-сценарий. Откройте подключение Ozon, пройдите авторизацию выбранного продавца и после возврата проверьте статус подключения.

Business использует отдельное Business-подключение и отдельные службы ПВЗ/курьера. Карточка товара на Ozon для этого контура не требуется. Его доступы хранятся отдельно в crypto-vault Битрикса и не переносятся в Seller-настройки.

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

Проверка расчёта и заказа

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

Сохраните тестовый заказ. Отдельно проверьте предусмотренный выбранным контуром сценарий создания отправления и чтения статуса. Успешный расчёт не означает, что отправление уже создано. Не включайте автоматическую отправку оплаченных заказов до этой проверки.

Для Business доступны предусмотренные сценарием подтверждение, PDF-этикетки, отмена и просмотр возвратов; не переносите эти действия автоматически на любой Seller-заказ. В админке проверьте сохранённые способ доставки, пункт или адрес, стоимость и вес отгрузки после редактирования.

Обновление и помощь

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

В поддержку передайте версию 3.1.0, контур, версии PHP/main/sale, шаг ошибки и ожидаемый результат. Уберите телефоны, адреса покупателей, OAuth-токены и секреты API. Сохраните исходный номер внутреннего обращения и продолжайте переписку в кабинете.