1. Введение

Система автоматически переносит заказы из Ozon в МойСклад, создаёт отгрузки и отправляет заказы в отгрузки Ozon, а также синхронизирует остатки товаров. Всё управляется через веб-интерфейс.

Инструкция детально описывает каждый шаг настройки, объясняет, как работают механизмы, и даёт рекомендации по использованию.

2. Возможности и тарифы

Возможности интеграции

• Автоматическое создание заказов в МоемСкладе – заказы из Ozon автоматически переносятся в МойСклад с полной детализацией.
• Автоотгрузка в МоемСкладе – после создания заказа автоматически формируется реализация (отгрузка).
• Автоматическая сборка заказов Ozon – заказы автоматически собираются и добавляются в отгрузки Ozon.
• Синхронизация остатков – остатки товаров автоматически передаются на склады Ozon.
• Режимы FBS и FBO – гибкое управление отправкой остатков в зависимости от наличия товара на складе Ozon.
• Сопоставление складов – возможность привязать склады МоегоСклада к конкретным складам Ozon.
• Суммирование остатков – автоматический выбор склада МоегоСклада с ненулевым остатком для резервирования.
• Поддержка нескольких аккаунтов Ozon – работа с несколькими магазинами в одном интерфейсе.
• Автоматическое получение этикеток – PDF-этикетки загружаются из Ozon и прикрепляются к заказам в МоемСкладе.
• Разделение отправлений – автоматическое дробление отправлений Ozon по количеству товаров или штук (см. раздел 5.4).
• Экспорт данных – выгрузка товаров, синхронизаций и заказов в Excel.

Тарифы

3. Настройка API и аккаунтов

3.1. Инициализация атрибутов МоегоСклада

После установки приложения через магазин МоегоСклада токен доступа сохраняется автоматически. Для корректной работы интеграции необходимо создать в МоемСкладе специальные атрибуты заказов и отгрузок, а также загрузить справочники (организации, контрагенты, проекты, каналы продаж).

Атрибуты, которые будут созданы в МоемСкладе:

• «Этикетка Ozon» (тип «Ссылка») – сюда будет записываться ссылка на скачанную PDF-этикетку заказа.
• «Комментарий покупателя Ozon» (тип «Строка») – комментарий из адреса доставки Ozon.
• «Номер отправления Ozon» (тип «Строка») – posting_number из Ozon.

⚠️ Перед нажатием кнопки «Обновить атрибуты» убедитесь, что в МоемСкладе присутствуют все необходимые статусы для заказов и отгрузок.

Статусы заказа покупателя

Необходимые статусы: Новый, На сборке, На проверке, Готов, Отгружен, Отменен. Они находятся в разделе «Настройки → Статусы».

Статусы заказа (часть 1)

Статусы заказа (часть 2)

Статусы отгрузки

Необходимые статусы: Новая, Собирается, Отгружено.

Статусы отгрузки (часть 1)

Статусы отгрузки (часть 2)

Если каких-то статусов нет, создайте их вручную в настройках МоегоСклада до нажатия кнопки «Обновить атрибуты».

Как выполнить инициализацию:

1. Перейдите в раздел «Настройки API» (меню слева).
2. В блоке «Системные действия» нажмите кнопку «Обновить» рядом с «Обновить атрибуты МоегоСклада».
3. Дождитесь уведомления об успешном завершении.

3.2. Добавление аккаунта Ozon

Рекомендация: перед добавлением аккаунта Ozon убедитесь, что вы выполнили шаг 3.1 (нажали «Обновить атрибуты»).

В блоке «Подключённые магазины Ozon» нажмите «+ Добавить новый кабинет» и заполните поля:

• Название магазина – любое название для вашего удобства (например, «Магазин Одежды»).
• Client-Id – идентификатор продавца из личного кабинета Ozon Seller.
• Api-Key – API-ключ, полученный в личном кабинете Ozon Seller.

Нажмите «Добавить». Если у вас несколько магазинов, повторите для каждого. Количество аккаунтов ограничено тарифом.

4. Настройка компании

Для каждого аккаунта Ozon перейдите в «Настройки → Компания».

Поля для заполнения:

• Организация продавца – выберите вашу организацию из списка МоегоСклада.
• Канал продаж – опционально, можно выбрать «Ozon» или оставить пустым.
• Контрагент покупателя – выберите контрагента, который будет покупателем в заказе.
• Проект – опционально, для группировки заказов по проектам.

Нажмите «Сохранить».

5. Настройка заказов

Перейдите в «Настройки → Заказы» для каждого аккаунта Ozon.

5.1. Основные опции

• Автосборка заказа в МоемСкладе – включает автоматическое создание заказа покупателя в МоемСкладе. Заказы, пришедшие до включения, созданы не будут (чтобы не дублировать ручные).
• Резервировать остатки – при создании заказа резервируется товар на складе.
• Снимать резерв при отгрузке – резерв снимается автоматически после отгрузки.
• Автоотгрузка в МоемСкладе – после создания заказа сразу формируется отгрузка (реализация).
• Учитывать НДС – если включено, укажите ставку НДС.

5.2. Выбор цены для заказа

• МойСклад – цена закупки или продажи (выберите поле).
• Ozon – цена из отправления (с учётом скидок, цена товара или цена для покупателя).

5.3. Автоматическая сборка заказов Ozon

Включите опцию «Автоматическая сборка заказов Ozon» для автоматического выполнения двух действий:

1. Перевод отправления в статус "Готов к отгрузке".
2. Добавление отправления в отгрузку Ozon.

Если активная отгрузка для нужного метода доставки не найдена, система создаст новую.

5.4. Разделение отправлений

Функция позволяет автоматически разделять одно отправление Ozon на несколько, если в нём слишком много разных товаров или штук одного товара. Это бывает полезно, когда заказ физически не влезает в одну посылку.

Включите «Разделять отправления» – появится блок с двумя независимыми правилами:

🔹 По количеству разных товаров

• Если товаров больше (порог N) – правило срабатывает только если в отправлении больше N уникальных SKU.
• Делить по (товаров в отправлении) (K) – максимальное количество разных товаров в одном новом отправлении.

Пример: порог 2, размер 1. Отправление из 5 разных товаров будет разбито на 5 отправлений по 1 товару.

🔹 По количеству штук одного товара

• Если штук больше (порог M) – правило срабатывает только если хотя бы по одному товару количество штук больше M.
• Делить по (штук в отправлении) (L) – максимальное количество штук одного товара в одном новом отправлении.

Пример: порог 10, размер 2. Товар в количестве 15 шт будет разбит на части: 2, 2, 2, 2, 2, 2, 2, 1.

5.5. Сохранение настроек

Нажмите «Сохранить настройки». Изменения вступят в силу при следующем цикле обработки заказов (раз в минуту).

6. Настройка складов

Перейдите в «Настройки → Склады». Здесь вы определяете, с каких складов МоегоСклада списывать товары и на какой склад Ozon отправлять остатки.

6.1. Суммирование остатков (гибкий подход)

Включите «Суммирование остатков».

• Приоритетный склад МоегоСклада – основной склад, проверяется в первую очередь.
• Дополнительные склады МоегоСклада – используются, если на приоритетном складе нет остатка.
• Выбрать склад Ozon – склад Ozon, на который отправляются остатки (только для синхронизации).

6.2. Сопоставление складов один к одному (жёсткая привязка)

Включите «Сопоставление складов один к одному».

• Для каждого склада МоегоСклада выберите соответствующий склад Ozon.
• Это создаёт маппинг: склад МоегоСклада ↔ склад Ozon.

7. Структура

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

7.1. Таблица «Товары и связи - МойСклад»

Отображает товары из МоегоСклада для выбранного аккаунта Ozon. Столбцы:

• Чекбокс – для выбора товаров (используется для экспорта).
• Название – наименование товара в МоемСкладе.
• ID товара – внутренний идентификатор МоегоСклада (UUID из метаданных).
• Артикул – артикул товара (используется для синхронизации по артикулу).
• Штрихкоды – все штрихкоды товара.
• Код – код товара в МоемСкладе.
• Закуп.цена – закупочная цена.
• Цена продажи – розничная цена.
• Остатки – общий остаток на всех складах МоегоСклада.
• Синхронизация – поле для поиска и привязки товара Ozon.

7.2. Таблица «Товары Ozon»

Отображает номенклатуру из выбранного аккаунта Ozon. Столбцы:

• Чекбокс – для выбора товаров (экспорт).
• Категория – категория товара Ozon.
• Артикул (offer_id) – ваш артикул продавца в Ozon.
• Название – название товара.
• Product ID – внутренний номер товара Ozon.
• SKU – идентификатор товара Ozon (FBS SKU).
• Баркод – штрихкод.
• Предельная цена товара без акций – цена до скидки.
• Зачеркнутая цена – старая цена (old_price).
• Предельная цена товара с учётом акций – маркетинговая цена.
• Цена конкурентов на другой площадке – внешняя минимальная цена (external min price).
• Цена конкурентов на Ozon – минимальная цена Ozon-индекса.
• Скидка % – размер скидки (вычисляется от old_price).
• Синхронизирован – есть ли связь с товаром МоегоСклада.

7.3. Таблица «Синхронизация»

Показывает все созданные связи между товарами МоегоСклада и Ozon. Подробно описана в разделе «Синхронизация товаров» (раздел 8).

В этой таблице вы управляете отправкой остатков, выбираете режим FBS/FBO, устанавливаете минимальный остаток и можете удалить связь.

7.4. Таблица «Заказы Ozon»

Отображает все заказы из Ozon для выбранного аккаунта. Подробно описана в разделе «Работа с заказами» (раздел 9).

7.5. Экспорт данных

В каждой таблице есть кнопка «Экспорт». Она позволяет выгрузить данные в Excel.

• Экспорт всех данных – просто нажмите кнопку «Экспорт», и выгрузится вся текущая таблица (с учётом поиска и фильтрации).
• Экспорт выбранных строк – отметьте нужные строки с помощью чекбоксов в первом столбце, затем нажмите «Экспорт» – будут выгружены только отмеченные записи.

8. Синхронизация товаров

В этом разделе вы связываете товары МоегоСклада с товарами Ozon и управляете передачей остатков. Для каждого аккаунта Ozon доступна отдельная таблица синхронизации.

8.1. Как создать связь товаров

1. Перейдите в раздел «Товары и связи → МойСклад» для нужного аккаунта Ozon.
2. В таблице найдите нужный товар (поиск по названию, артикулу или коду).
3. В последнем столбце таблицы («Синхронизация») начните вводить артикул продавца (offer_id), Product ID или SKU товара Ozon – система предложит подходящие варианты.
4. Выберите нужный товар – связь будет создана, и он появится в таблице «Синхронизация».

8.2. Управление синхронизированными товарами

В таблице «Синхронизация» отображаются все созданные связи. Для каждого товара доступны следующие настройки (столбцы):

🔹 Столбец «Отправлять остатки»

• Включите – остатки этого товара будут передаваться в Ozon согласно выбранному режиму.
• Выключите – остатки не передаются (синхронизация для товара отключена).

🔹 Столбец «FBO / FBS»

Здесь вы выбираете, как именно будут отправляться остатки в Ozon. Активна только одна кнопка.

🟢 Режим FBS (кнопка «FBS»)

• Каждую синхронизацию система отправляет в Ozon текущий остаток товара с МоегоСклада в соответствии с выбранным порядком в разделе «Настройки → Склады».
• Остатки отправляются всегда, без каких-либо ограничений.
• Этот режим подходит, если вы храните товар на своём складе и хотите, чтобы остатки в Ozon всегда совпадали с вашими фактическими остатками.

🔵 Режим FBO (кнопка «FBO»)

• Каждую синхронизацию система проверяет текущий остаток товара на складе Ozon (FBO).
• Если минимальный остаток выключен (или не задан):
• Если остаток на складе Ozon больше 0 (на складе Ozon есть товар) – система отправляет остаток равный 0 для склада FBS по выбранному товару.
• Если остаток на складе Ozon равен 0 (склад Ozon пуст) – система отправляет остаток для склада FBS в соответствии с выбранным складом в разделе «Настройки → Склады».
• Если минимальный остаток включён и задано пороговое значение N:
• Если остаток на складе Ozon больше N – система отправляет 0.
• Если остаток на складе Ozon меньше либо равен N – система отправляет остаток с соответствующего привязанного склада в МоемСкладе на склад FBS Ozon.
• Таким образом, система не позволяет превысить нужный уровень остатков на складе Ozon, отправляя 0, когда запас в Ozon уже достаточен. Это помогает избежать переполнения склада Ozon и лишних затрат на хранение.
• FBO доступен только на тарифе «Бизнес». На других тарифах кнопка FBO неактивна.

🔹 Столбец «Минимальный остаток» (только для FBO)

• Включите чекбокс и введите число (порог N).
• Выключите – порог считается равным 0, и отправка остатка происходит только когда остаток FBO == 0.

8.3. Примеры работы

8.4. Удаление синхронизированных товаров

Если связь между товарами больше не нужна, её можно удалить.

1. В таблице «Синхронизация» отметьте нужные товары (поставьте галочки в первом столбце).
2. В правом верхнем углу таблицы появится кнопка «Удалить выбранные».
3. Нажмите её, чтобы удалить все отмеченные связи.

8.5. Важные замечания

• Режимы FBS и FBO влияют только на синхронизацию остатков. Обработка заказов (создание заказов в МоемСкладе, резервирование, отгрузки) происходит одинаково, независимо от выбранного режима.
• Списание заказов (сначала со склада Ozon, потом со склада продавца) настраивается в личном кабинете Ozon Seller, а не в нашей системе.
• Лимит товаров с отправкой остатков определяется вашим тарифом (см. раздел «Возможности и тарифы»).

8.6. Автосинхронизация и массовое управление настройками

Автосинхронизация товаров Ozon

В таблице «Товары Ozon» есть кнопка «Автосинхронизация». Она позволяет автоматически создать связи между всеми товарами Ozon и товарами МоегоСклада, используя один из двух способов сопоставления:

• По артикулу – система ищет товар в МоемСкладе с таким же артикулом, как offer_id товара Ozon.
  ⚠️ Если в МоемСкладе есть несколько товаров с одинаковым артикулом, автосинхронизация по артикулу не сможет определить, какой именно товар нужно привязать – такие товары будут пропущены. Для них потребуется ручная синхронизация через таблицу «Товары и связи - МойСклад».
• По штрихкоду – система ищет товар в МоемСкладе с таким же штрихкодом, как у товара Ozon. Если штрихкод уникален в МоемСкладе, связь будет создана. Если штрихкод повторяется у нескольких товаров МоегоСклада, такие товары также пропускаются. Если у товара МоегоСклада несколько штрихкодов, проверяется каждый и синхронизация происходит при первом совпадении.

После выбора способа нажмите кнопку в диалоге – система выполнит синхронизацию и покажет результат (сколько товаров синхронизировано, сколько пропущено).

Массовое управление настройками синхронизированных товаров

В таблице «Синхронизация» в заголовках столбцов «Отправлять остатки», «FBO/FBS» и «Минимальный остаток» есть стрелки ▼. При нажатии на них открывается небольшое меню, позволяющее применить соответствующее действие ко всем синхронизированным товарам сразу.

• Отправлять остатки – в меню можно включить или выключить отправку остатков для всех товаров. При включении система проверяет, не превышен ли лимит товаров с отправкой остатков (согласно вашему тарифу). Если лимит будет превышен, операция не выполнится, и вы увидите сообщение.
• FBO/FBS – в меню можно выбрать режим FBS или FBO для всех товаров. Если ваш тариф не поддерживает FBO, выбор FBO не сработает.
• Минимальный остаток – в меню можно ввести число (порог N) и нажать «Применить». Тогда для всех товаров будет включена опция «Минимальный остаток» с указанным порогом. Это работает только для товаров в режиме FBO.

Все массовые действия применяются мгновенно и сопровождаются подтверждением. После выполнения таблица автоматически обновляется.

9. Работа с заказами

Все заказы из Ozon для выбранного аккаунта отображаются в таблице «Заказы Ozon». В этом разделе вы можете отслеживать все этапы обработки заказов – от получения до создания в МоемСкладе и добавления в отгрузки Ozon.

9.1. Откуда берутся заказы

Заказы автоматически подгружаются из Ozon через API. Система запрашивает новые отправления в статусе Ожидает сборки и обновляет статусы уже существующих.

• Частота обновления: каждую минуту.
• Принцип: при каждом обновлении система загружает новые отправления и обновляет статусы для всех активных заказов (не доставленных и не отменённых).
• Отбор: загружаются только заказы, у которых хотя бы один SKU синхронизирован с товаром в МоемСкладе. Если товар не синхронизирован, заказ не будет отображаться в таблице «Заказы Ozon».

9.2. Статусы заказов

В таблице «Заказы Ozon» отображаются следующие статусы:

• Статус отправления – статус из Ozon. Возможные значения:
  • Ожидает сборки (awaiting_packaging) – заказ поступил, ожидает обработки.
  • Готов к отгрузке (awaiting_deliver) – собран, ожидает добавления в отгрузку.
  • Доставляется (delivering) – в пути к покупателю.
  • У водителя (driver_pickup) – передан водителю.
  • Доставлен (delivered) – доставлен покупателю.
  • Отменён (cancelled) – отменён.
  • Не принято (not_accepted) – не принято.

9.3. Синхронизация статусов с МоимСкладом

Если для заказа включена «Автосборка заказа в МоемСкладе» (раздел 5.1), то при поступлении нового заказа система автоматически создаёт заказ покупателя в МоемСкладе, а затем (если включена автоотгрузка) – отгрузку. После этого статус в МоемСкладе будет изменяться в соответствии с изменениями статуса заказа в Ozon:

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

9.4. Загрузка этикеток

Когда заказ переходит в статус Готов к отгрузке или Доставляется, система автоматически:

1. Создаёт задание на формирование PDF-этикетки в Ozon.
2. Записывает ссылку в атрибут «Этикетка Ozon» заказа покупателя в МоемСкладе.

9.5. Что отображается в таблице «Заказы Ozon»

Кроме статусов, в таблице доступна подробная информация по каждому заказу:

• Номер отправления – номер отправления в Ozon.
• Номер заказа – номер заказа Ozon.
• Внутренний ID – числовой ID заказа Ozon.
• Дата создания – дата и время оформления.
• Дата отгрузки – крайняя дата отгрузки.
• Товары – список товаров: количество, offer_id, название, SKU, цена.
• Общая цена – суммарная стоимость отправления.
• Способ доставки – название службы доставки.
• ID склада – ID склада Ozon.
• Адрес покупателя – собранный из частей адреса Ozon.
• Комментарий – комментарий из адреса доставки.
• Статус – статус из Ozon (см. раздел 9.2).
• Подстатус – детализация статуса.
• Номер заказа в МоемСкладе – номер созданного заказа покупателя в МоемСкладе.
• Номер отгрузки в МоемСкладе – номер созданной отгрузки в МоемСкладе.
• Синхронизация – все ли товары отправления синхронизированы с МоимСкладом (● Синхр. / ⚠ Частично).

9.6. Экспорт заказов

Вы можете выгрузить заказы в Excel:

• Экспорт всех заказов – нажмите кнопку «Экспорт».
• Экспорт выбранных заказов – отметьте нужные строки чекбоксами и нажмите «Экспорт».

10. Отгрузки Ozon

При включённой опции «Автоматическая сборка заказов Ozon» система выполняет два действия для каждого отправления:

1. Переводит отправление в статус Готов к отгрузке.
2. Добавление в отгрузку – ищет активную отгрузку для метода доставки и добавляет в нее отправление. Если активной отгрузки нет — создаёт новую.

10.1. Как работает добавление в отгрузку

• Для каждого метода доставки система ищет активную отгрузку на сегодня, вчера, позавчера или завтра.
• Если активная отгрузка найдена — новое отправление добавляется в неё.
• Если отгрузки нет — создаётся новая и в неё добавляется отправление.

10.2. Рекомендации

• Отключите все виды автоотгрузок в кабинете Ozon Seller (автосборка, автоподтверждение, автосоздание отгрузки) — на всех складах FBS.
• Проверяйте состав отгрузки в личном кабинете Ozon Seller перед подтверждением.
• Не подтверждайте отгрузку вручную в Ozon Seller, пока не убедитесь, что все заказы добавлены — иначе новые заказы пойдут в новую отгрузку.
• Если в интеграции произошла ошибка добавления, система повторит попытку при следующем цикле (раз в минуту).

11. Частые проблемы и решения

❌ Заказы не обрабатываются, ошибка 409 Conflict или ship не срабатывает

Причина: в личном кабинете Ozon Seller на складе включена автосборка или автоподтверждение отгрузки. Ozon самостоятельно переводит отправления в статус awaiting_deliver и/или создаёт свои отгрузки раньше, чем это делает интеграция.

Решение: перейдите в Ozon Seller → «Логистика → Мои склады» (или «Настройки → Склады FBS») и отключите для всех складов:

• Автосборку (автоперевод в «Готов к отгрузке»);
• Автоподтверждение отгрузки;
• Автоматическое формирование отгрузки.

Всю работу по сборке и добавлению в отгрузки интеграция берёт на себя. После отключения автоотгрузок перезапустите обновление заказов (кнопка «Обновить» в разделе «Заказы Ozon» или дождитесь следующего цикла — раз в минуту).

❌ Заказ не создаётся в МоемСкладе, «Не заполнены настройки компании»

Причина: не заполнена организация или контрагент в настройках компании.

Решение: перейдите в «Настройки → Компания» и заполните оба поля.

❌ Заказ не создаётся, «Нет подходящего склада»

Причина: не настроены склады либо на всех указанных складах нет остатка.

Решение: настройте склады в разделе «Склады»; проверьте наличие остатков.

❌ Отгрузка Ozon не создаётся, ошибка 409 Conflict

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

Решение: используйте разные методы доставки для разных складов. Система автоматически разделяет заказы по delivery_method_id.

❌ Старые заказы не создаются после включения автосборки

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

Решение: создайте их вручную или проигнорируйте. Если нужно автоматически – удалите из МоегоСклада и дайте системе пересоздать (рискованно).

❌ Не скачивается этикетка

Причина: Ozon формирует PDF-этикетку не мгновенно — это может занять до 60 секунд. Также возможно превышение лимитов API.

Решение: подождите, система автоматически повторит попытку при следующем цикле. Если проблема сохраняется более 10 минут — проверьте права Api-Key (должен быть доступ к разделу «Posting FBS»).

❌ Автосинхронизация не находит товары

Причина: возможны дубликаты артикулов или штрихкодов в МоемСкладе.

Решение: используйте ручную синхронизацию через таблицу «Товары и связи - МойСклад» для таких товаров. Система пропускает неоднозначные совпадения намеренно, чтобы избежать неверных связей.

❌ Разделение отправлений не работает

Причина: Ozon может вернуть ошибку, если разделение невозможно (например, отправление уже в отгрузке).

Решение: проверьте, что отправление ещё в статусе Ожидает сборки и не добавлено ни в одну отгрузку.