Ozon: настройка интеграции с нуля
Проблема
Подключаем обмен с Ozon: какие доступы получить, какую схему работы выбрать (FBO, FBS или rFBS), как создать и заполнить настройку обмена, сопоставить товары, настроить остатки и три вида цены, работать с заказами, стикерами и отгрузкой. Нужна пошаговая инструкция.
Решение
К записи приложена полная инструкция в PDF: 20 разделов, со скриншотами экранов. Ниже — карта документа и то, обо что чаще всего спотыкаются. СОДЕРЖАНИЕ ИНСТРУКЦИИ 1. Что подготовить до начала. 2. Схемы работы Ozon и что от них зависит. 3. Создать настройку обмена. 4. Заполнить подключение и проверить связь. 5. Настроить обработку заказов и возвратов. 6. Резервирование. 7. Настроить склады и остатки. 8. Отборы — что именно выгружается. 9. Настроить цены. 10. Создание документов 1С. 11. Карточки товаров и сопоставление. 12. Первая выгрузка. 13. Ежедневная работа: от заказа до отгрузки. 14. Работа по FBO: заявки на поставку. 15. Работа по rFBS: трек-номера и статусы доставки. 16. Сканер штрихкодов, маркировка и печать. 17. Акты по отгрузкам, отчёт комиссионера, акции и чаты. 18. Проверка и диагностика. 19. Типовые ошибки и что делать. 20. Что важно помнить. НА ЧТО ОБРАТИТЬ ВНИМАНИЕ Схем работы три: FBO, FBS и rFBS. Схема выбирается в настройке обмена и определяет всё остальное: какие кнопки есть в рабочем месте, какие колонки в списке заказов, какие вкладки и какие права можно раздать сотрудникам. Схему нельзя поменять после первого успешного обмена с площадкой — поле блокируется. Поэтому на каждую схему заводится своя настройка обмена: работаете и по FBO, и по FBS — у вас будет две настройки, это штатный режим. Схемы различаются не только процессом, но и составом интерфейса. На FBO нет остатков, сборки, печати и маркировки, зато есть заявки на поставку, таймслоты и данные водителя. Команда «Передать в доставку» относится только к FBS. Ручные «Доставляется» и «Доставлено», а также передача трек-номера — только к rFBS. Стикеров заказов на rFBS нет: этикетку на отправление формирует ваша служба доставки, в меню «Печать» остаётся лист подбора. Колонка и группа «Грузоместа» появляются на схемах, где вы отгружаете сами, и только при включённом флаге «Доверительная приёмка». Полная таблица различий — во втором разделе приложенной инструкции. «У меня нет такой кнопки» — почти всегда не поломка. Состав каждого меню зависит сразу от двух вещей: от схемы работы и от того, какая статусная закладка выбрана. Например, в меню «Печать» на закладке «Ожидают сборки» есть только «Лист подбора», а пункт «Стикеры по заказам» появляется на закладке «Ожидают отгрузки» — там же в списке добавляется колонка «Стикер». Это объясняет большинство обращений «пропала печать стикеров». На схеме FBO рабочее место выглядит иначе. Командных кнопок три вместо семи: нет маркировки, серий и ГТД, управления доставкой и всей группы «Печать» — собирает и отгружает площадка. Появляется вкладка «Заявки на поставку» (получить заявки, сформировать заявку из 1С, создать заказ клиента, выбрать таймслот и отправить, отправить данные водителя и автомобиля, печать), а вкладка «Акты по отгрузкам» пропадает. В настройке исчезают вкладки «Отборы» и «Честный знак», нет поля «Настройка FBO», а вместо «Доверительной приёмки» — «Контролировать зоны размещения». Вкладка «Склады и остатки» на FBO не исчезает, но ужимается: остаются только флаг «Загружать остатки товаров с маркетплейса» и список складов — они нужны, чтобы модуль знал, какой склад ставить в создаваемые документы. Создание заказа клиента и реализации по FBO по умолчанию скрыто; если эти документы нужны в 1С, включите флаг «Отображать функции работы с заказами при схеме ФБО» (виден только на схеме FBO). Остатки FBO в настройке FBS не видны сами по себе. В настройке FBS есть поле «Настройка FBO» с подсказкой «Для корректного отображения остатков по FBO в FBS». Укажите в нём вашу FBO-настройку — и рядом с вашим складским остатком будет виден остаток на складе Ozon. Не заполнили — данных просто не будет, это не ошибка модуля. Три идентификатора товара, и они разные по смыслу. Offer ID — артикул продавца, его задаёте вы. SKU — идентификатор товара на площадке. Product ID — внутренний идентификатор карточки в кабинете. Оба последних выдаёт Ozon. Когда площадка или поддержка просит «пришлите SKU», уточняйте, какой именно идентификатор имеется в виду: путаница между Offer ID и SKU регулярно приводит к «товар не найден». Отдельно: архивные и непромодерированные карточки через API не отдаются, поэтому в каталог модуля они не попадают — статус карточки проверяется в кабинете. Цен три. Вид цены без скидки, вид цены со скидкой и вид цены минимальная (акционная) — у каждого своя формула расчёта. Минимальная цена ограничена площадкой по частоте: устанавливать не чаще одного раза в день и не реже одного раза в 30 дней. Флажок «Исключить» на вкладке «Отборы» — первое, что нужно проверить, если остатки перестали уходить. Он меняет смысл отбора на противоположный: «выгружать всё, кроме перечисленного». Если флажок включён, а список при этом пуст, отбор может отработать так, что не выгрузится ничего. Симптом узнаваемый: обмен проходит без ошибок, в журнале всё зелёное, а на площадке остатки не меняются. Габариты решают, куда встанет остаток. В таблице складов у каждого склада есть признаки МГТ и КГТ (мало- и крупногабаритный товар). Признак должен соответствовать тому, что заведено в кабинете, иначе остатки «уходят, но их нет». Заказы за прошлые дни глубиной не добираются. Модуль начинает опрос от даты последнего уже загруженного заказа, поэтому увеличение «Глубины заказов» не расширяет окно назад. Пропущенные дни добираются командой «Дополнительно — Получить новые за период». Расписания подбирайте кнопкой «Расчитать минимальный период» — она есть и на вкладке остатков, и на вкладке цен. Модуль замеряет, сколько занимает сбор именно ваших данных, и подсказывает минимально допустимый интервал. Слишком частое расписание упирается в лимиты площадки, и обмен встаёт. По той же причине выпускайте отдельный ключ под 1С: общий ключ означает общий лимит на все ваши сервисы. Регламентные задания должны быть включены. Без них обмен выполняется не в фоне, а прямо в сеансе пользователя — обработка заказов становится заметно медленнее. Модуль предупреждает об этом в шапке настройки. «Параметры пользователя» персональные. Настройки отображения, поведение сканера и список видимых статусных закладок хранятся отдельно для каждого пользователя 1С. Если у сотрудника «выглядит по-другому» — сравнивать нужно эту вкладку, а не общую настройку обмена. Комиссионная торговля включается в 1С. Хозяйственная операция «Передача на комиссию» в настройке создания документов недоступна, пока комиссионная торговля не включена в самой 1С. Это ограничение конфигурации, а не модуля. ПЕЧАТЬ СТИКЕРОВ: ПОЧЕМУ ПЕЧАТАЕТСЯ НЕ ТО Этикетки печатаются в отдельной обработке — она открывается из рабочего места командой «Печать» — «Стикеры по заказам». Свои настройки она запоминает персонально для каждого пользователя и каждой площадки, поэтому у двух сотрудников может вести себя по-разному. Всё начинается с настройки «Вариант заполнения». В варианте «Заказ / Номенклатура» верхний уровень списка — заказ, внутри его товары; это режим поштучной печати: выделяете строку конкретного заказа и печатаете стикер только этого отправления. В варианте «Номенклатура / Заказ» верхний уровень — товар, а внутри все заказы с этим товаром. ПЕЧАТАЮТСЯ СТИКЕРЫ ВСЕХ ЗАКАЗОВ ПО ТОВАРУ. Так устроен вариант «Номенклатура / Заказ»: сканер ищет строку ТОВАРА, а не отправления — считанный штрихкод сопоставляется с номенклатурой и характеристикой верхнего уровня, и печать по этой строке выводит этикетки всех заказов, которые лежат под ней. Это не сбой. Если печатать нужно поштучно, по мере отбора, переключите вариант на «Заказ / Номенклатура» либо снимите флаг «Печать стикера при считывании ШК» и запускайте печать сами по выбранным строкам. Флаг «Печать стикера при считывании ШК» виден только при включённом подключаемом оборудовании. Когда он снят, скан лишь переводит курсор на найденную строку. Повторное сканирование того же штрихкода подряд обработка игнорирует. Если товар по штрихкоду найден в базе, но его нет в загруженном списке, обработка так и пишет: «найдена в БД, но в списке товаров не найден» — значит заказ с этим товаром в обработку не попал, проверьте отбор и статусную закладку. Флаг «Контролировать напечатанные стикеры» заставляет пропускать заказы, по которым этикетка уже печаталась: повторно они на печать не пойдут. Отметка хранится не в обработке, а в регистре сведений «Регистрация печати стикеров». КОМАНДЫ СБРОСА ПРИЗНАКА В ОБРАБОТКЕ НЕТ: отметка ставится только в одну сторону, в момент печати. Если стикеры ушли на печать ошибочно и нужно напечатать их заново при включённом контроле, отметку снимают удалением соответствующих записей этого регистра — операция уровня администратора базы, делайте её по конкретным заказам, а не очисткой регистра целиком. ПАУЗА ПОСЛЕ ПЕЧАТИ. После каждой печати обработка заново опрашивает состояние этикетки по каждому заказу, загруженному в список, а не только по напечатанному. Поэтому задержка растёт вместе с количеством открытых заказов. Рабочий обход — открывать печать стикеров партиями по 20–50 заказов, а не по всему списку сразу: пауза сокращается пропорционально. КЛАСТЕРЫ И СКЛАДЫ FBO Ozon распределяет поставки по кластерам — географическим группам складов. Модуль хранит их в справочниках «Маркетплейсы: Кластеры FBO» и «Маркетплейсы: Склады FBO», заполняются они кнопкой «Загрузить кластеры и склады FBO» в карточке настройки — кнопка есть только у записанной настройки Ozon со схемой FBO. Сами склады появятся только после получения остатков с площадки (об этом написано прямо в справочнике). ВАЖНО: форма «Сформировать заявку на поставку» раскладывает товар по колонкам-кластерам и берёт только те склады, у которых колонка «Кластер» заполнена. Склад без кластера в раскладку не попадёт — молча, без ошибки. Поэтому колонку «Кластер» надо проверять ДО формирования заявки. Справочник складов общий для площадок; у не-Ozon строк кластер пустой, и это нормально. ОТЧЁТ КОМИССИОНЕРА Загрузить отчёт можно двумя путями. По API — только у Ozon, Wildberries, Яндекс.Маркета, СберМегаМаркета и Лемана ПРО: в рабочем месте есть команда «Запросить отчёт комиссионера за предыдущий месяц». Из файла — универсальным загрузчиком, он читает отчёт в виде таблицы Excel и работает по любой площадке. За загрузку отвечают две отдельные внешние обработки («Загрузка отчёта комиссионера маркетплейсов» и та же «из файла»); после обновления модуля их нужно переустанавливать. В поставке уже есть готовые разметки под Ozon, Wildberries (две редакции), Яндекс.Маркет, СберМегаМаркет, Лемана ПРО и Lamoda — кнопка «Загрузить настройки по умолчанию» в справочнике «Маркетплейсы: Настройки загрузки отчётов». Своя настройка нужна, только если ваш файл отличается от типового. Разметка задаётся на четырёх вкладках: листы, секции (с типом данных «продажи / возвраты / невыкупы» и множителем), фильтры строк и поля с источником «константа / колонка / выражение». Номенклатура ищется по sku, offer_id, штрихкоду, артикулу или наименованию (с порогом похожести). В карточке есть «Открыть образец» и «Тестовая загрузка» — прогнать разметку по вашему файлу, не создавая документов. Настройку можно перенести между базами файлом JSON. Подробности — в разделе про отчёт комиссионера в приложенной инструкции. СНАЧАЛА ОБНОВИТЕСЬ Часть того, с чем к нам обращаются по Ozon, в актуальных сборках модуля уже исправлена. Из недавнего: расчёт цены по валютам, курс которых котируется за 10 или 100 единиц (в старых сборках кратность не учитывалась и цена уходила завышенной в 10 или 100 раз — касается всех, кто торгует не в рублях); отправка остатков при поступлении заказов (теперь уходит только тот товар, который был в поступивших заказах, а не весь список); загрузка отчёта комиссионера из файла (выбор периода перестал быть обязательным); скорость получения заказов. Поэтому порядок такой: сначала убедитесь, что вы на свежей версии, и только потом разбирайте проблему. Что именно вошло в ваше обновление, показывают команды «История версий» и «Что изменилось?» в самом модуле. ЕСЛИ ЧТО-ТО НЕ ЗАРАБОТАЛО Раздел 18 инструкции — порядок диагностики, раздел 19 — таблица типовых ошибок с разбором. Если после них проблема осталась, напишите в поддержку: приложите версию модуля и конфигурации, наименование настройки обмена и схему работы, номер заказа или поставки, скриншот ошибки и фрагмент лога с ответом площадки. Ключи и логины из выгрузки для техподдержки удаляйте: в форме сбора информации есть флаг, который добавляет в текст настройки подключения. СМЕЖНЫЕ СТАТЬИ «Заказ не загрузился в 1С: что проверить», «Остатки: откуда берётся число, которое уходит на маркетплейс», «После обновления модуля перестало работать: что делать и как откатиться», «Ozon: заказы клиентов не создаются автоматически», инструкции по настройке других площадок.
Не помогло? Напишите в поддержку — разберём вашу ситуацию и дополним материал.