Ozon и 1С: обмен заказами и остатками, отчёты и Seller API

Связка Ozon с 1С распадается на три слоя, и ломается каждый по-своему. Товары, цены и остатки уходят из 1С на площадку. Заказы и статусы идут обратно. Деньги приходят раз в месяц одним закрывающим документом, который надо провести. Инструкции в выдаче обычно описывают первый слой и обрываются на словах «укажите Client ID и API-ключ».

Ниже — все три слоя: где взять ключ и почему он перестанет работать через полгода, чем обмен остатками по FBS отличается от FBO, как заказы доезжают до 1С и что из этого закрывает Seller API. Если вы только выходите на площадку, начните с общей инструкции — как начать продавать на Ozon.

Что передаётся между Ozon и 1С

Ozon называет свой программный интерфейс Seller API. Через него система продавца обменивается с площадкой данными в обе стороны: одни методы меняют данные магазина, другие только читают. Рабочий адрес — api-seller.ozon.ru, авторизация идёт заголовками Client-Id и Api-Key.

Слои независимы. Можно завести только загрузку отчёта о реализации и оставить остатки на ручном режиме, а можно наоборот. Ошибка новичка — считать «настроить интеграцию» одним действием.

Ключ Seller API: где взять и почему он однажды перестанет работать

Ключ выпускается в кабинете продавца: раздел «Настройки → Seller API», кнопка «Сгенерировать ключ». В форме задаются название ключа, уровень доступа и цель использования: для личного пользования либо для внешнего сервиса. Во втором случае нужно указать название сервиса. Ключей можно завести несколько — например, по одному на каждого пользователя со своим уровнем доступа.

Дальше начинается то, о чём в инструкциях по модулям не пишут.

Отсюда простое правило эксплуатации: дату выпуска ключа нужно записать туда же, куда вы пишете сроки лицензий 1С, и поставить напоминание за месяц. Если ключ попал в посторонние руки, порядок обратный: сначала удалить текущий в разделе «Настройки → Seller API», потом создать новый. Запросы к API меняют данные вашего магазина, поэтому чужой доступ к ключу — это чужое управление ассортиментом и ценами.

Срок ключа, лимит запросов и часовой пояс ломают обмен тихо и не в тот день, когда его настраивали. В SelSup этот слой держит сервис: ключ Ozon заводится один раз, обмен заказами и остатками идёт по расписанию сервиса, а продление доступа не превращается в аварию посреди распродажи. Посмотреть, как устроен обмен Ozon с 1С в SelSup, можно на своих товарах и своих заказах.

Остатки: FBS и FBO живут по разным правилам

Главное различие, которое продавцы узнают не сразу: по схеме FBO остатки обновляются автоматически по факту продажи. Товар лежит на складе площадки, площадка сама его и списывает. Выгружать туда остатки из 1С не нужно и невозможно. Ручное обновление остатков относится только к FBS и realFBS, где товар лежит у вас.

Для FBS остатки передаёт метод /v2/products/stocks: одним запросом до 100 товаров, обязательно с идентификатором склада. Цены обновляет /v1/product/import/prices — отдельно цену до скидок, цену для подписчиков Ozon Premium, цену на карточке и минимальную цену после акций. Товары загружаются методом /v3/product/import, тоже по 100 штук за запрос, и возвращают номер задания task_id, статус которого проверяется отдельно.

Прочитать остатки обратно можно тремя способами: /v4/product/info/stocks отдаёт количество по FBO, FBS, realFBS и FBP, /v2/product/info/stocks-by-warehouse/fbs — по складам FBS и realFBS, а /v1/analytics/stocks собирает отчёт по складам Ozon для планирования поставок. Отдельная тонкость: заказы юридических лиц резервируют товар до оплаты, и в ответе методов работы с отправлениями такое отправление помечено признаком is_legal. Обновляя остаток, нужно учитывать и свободный, и зарезервированный товар. Как эти цифры сводятся с управленческим учётом, разобрано в статье учёт продаж на маркетплейсах: заказы, остатки, прибыль.

Заказы: как они доезжают до 1С

По FBS обмен начинается со списка необработанных отправлений — /v3/posting/fbs/unfulfilled/list. Отправления приходят в статусах awaiting_packaging, awaiting_approve или awaiting_verification; полный список с фильтрами отдаёт /v3/posting/fbs/list. По каждому отправлению блок requirements сообщает, какие товары подлежат обязательной маркировке и нужно ли передать номер таможенной декларации.

Дальше цепочка жёсткая. Коды маркировки проверяются на соответствие требованиям «Честного ЗНАКа» методом /v5/fbs/posting/product/exemplar/validate, привязываются к экземплярам через /v6/fbs/posting/product/exemplar/set, и только после этого отправление можно собрать методом /v4/posting/fbs/ship. Без переданных кодов маркировки сборка не пройдёт. Этикетку отдаёт /v2/posting/fbs/package-label.

По FBO картина проще: отправления читаются методами /v2/posting/fbo/list и /v2/posting/fbo/get, а работа сводится к поставкам. Заявка собирается из черновика (/v1/draft/direct/create для прямой поставки), затем выбирается таймслот. Здесь есть ограничение, о котором стоит помнить при планировании: доступные таймслоты видны максимум на 28 календарных дней вперёд.

Опрашивать площадку по расписанию — не единственный вариант. У Ozon есть пуш-уведомления: площадка сама отправляет событие на ваш сервер, предусмотрены повторная отправка и формат ответа вашего сервиса. Для 1С, которая живёт за корпоративным периметром, это чаще всего означает промежуточный сервис, но нагрузка на API и задержка при этом падают.

Отчёт о реализации: что с ним делать в 1С

Закрывающий документ месяца грузится в типовую форму «Отчёт комиссионера (агента) о продажах». До первой загрузки в базе должен быть заведён контрагент ООО «Интернет Решения» и договор с видом «С комиссионером (агентом) на продажу», иначе документ не проведётся. Отчёт создаётся в двух вариантах: позаказном, где каждая продажа идёт отдельной строкой, и свёрнутом, где позиции с совпадающими ценами объединяются.

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

Данные о продажах за день можно получать и по API — методом /v1/finance/realization/by-day, но он доступен только по подпискам Premium Plus и Premium Pro и не глубже 32 календарных дней. Часть методов Ozon вынесена в отдельный премиум-раздел документации и без подписки не работает. Где искать сами документы в кабинете и как сверить их с выплатой, разобрано в статье отчёт о реализации Ozon: где найти и как сверить выплату. Проводки по комиссионной схеме, налоги и НДС — в разборе бухгалтерия на маркетплейсах в 2026 году, а отражение возвратов площадки — в статье учёт возвратов в 1С.

Пять причин, по которым обмен встаёт

Ещё одна ловушка касается самописных решений: с 16 мая 2025 года к Seller API можно обращаться только с сервера на сервер: прямые запросы из браузера запрещены и падают с ошибкой политики CORS.

Модуль в 1С, сервис или своя разработка

Готовые модули встраиваются расширением и живут внутри базы: рабочее место с товарами, заказами и ценами появляется прямо в 1С. Плата за это — привязка к версии конфигурации и к тому, насколько быстро разработчик модуля успевает за изменениями API. Сервис-посредник забирает обмен на свою сторону и отдаёт в 1С уже сведённые данные, зато добавляет ещё одно звено. Своя разработка оправдана, когда склад работает по нетиповым процессам, но тогда лимиты, версии методов и продление ключа становятся вашей эксплуатационной задачей.

Сравнение вариантов по деньгам и рискам с чек-листом вопросов подрядчику собрано в отдельном материале — интеграция 1С с маркетплейсами: архитектура и варианты. Если магазин на Ozon не единственный, смотреть надо сразу на связку со всеми площадками: форматы отчётов и циклы выплат у них разные.

Что закрывает API, а что остаётся людям

Seller API закрывает рутину с объёмом: загрузку и обновление товаров, цены и остатки, получение заказов и статусов, возвраты, накладные, финансовые и аналитические отчёты, чаты с покупателями. Всё, что требует решения, остаётся человеку: сопоставить спорную позицию, ответить на заявку покупателя о скидке, взвесить участие в акции, разобрать расхождение по приёмке. Что из этого видно в кабинете бесплатно, а за чем придётся идти в сторонние отчёты, разобрано в статье аналитика продаж Ozon: отчёты, прибыль и юнит-экономика.

Обмен с Ozon часто держится на одном ключе, одном модуле и одном человеке, который помнит, когда всё это настраивали. Если это похоже на вашу ситуацию, схему стоит посмотреть со стороны. На разборе смотрим ваш кабинет Ozon и вашу базу 1С: что уже идёт по API, что грузится файлами, где теряются заказы и остатки. Записаться на разбор обмена Ozon и 1С.

Частые вопросы

Сколько действует API-ключ Ozon?

Шесть месяцев. После этого ключ нужно сгенерировать заново в кабинете. Дату истечения можно получить заранее — она приходит в параметре expires_at метода /v1/roles.

Нужно ли выгружать остатки на Ozon по схеме FBO?

Нет. По FBO остатки на складе площадки обновляются автоматически по факту продажи. Выгрузка остатков из 1С относится только к FBS и realFBS.

Что делать, если API-ключ потерян?

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

Сколько запросов к Seller API можно делать?

Не больше 50 запросов в секунду на все методы с одного Client ID. При потоке одинаковых или ошибочных запросов Ozon может ограничить доступ без предупреждения, поэтому расписание обмена лучше разреживать.

Можно ли не поднимать интеграцию с Ozon самим?

Можно, если готовы отдать этот слой сервису. Тогда ключ, лимиты запросов, смена версий методов и продление доступа остаются на его стороне, а в 1С приходят сведённые заказы, остатки и документы. Своя разработка оправдана, когда процессы на складе нетиповые и готовый модуль под них не гнётся. Посмотреть, что SelSup забирает на себя в связке Ozon и 1С.

Почему заказ пришёл в 1С не тем числом?

Seller API работает по UTC. Если обмен переносит дату как есть, вечерние заказы уезжают в соседние сутки. Приводить время к часовому поясу базы нужно на стороне обмена.

Что почитать дальше

• Интеграция 1С с Wildberries: модуль, токен и настройка обмена — вторая площадка со своим API и без модуля от самого маркетплейса.
• Интеграция Яндекс Маркета с 1С: модуль, отчёты и проводки — третья площадка и разбор загрузки отчёта комиссионера по шагам.
• API Яндекс Маркета: что можно автоматизировать продавцу — сравните набор методов и лимиты, если планируете один обмен на две площадки.
• Расходы на маркетплейсах в 2026 году — какие удержания площадки принимаются в расходы на упрощёнке.