Документация

Как работает FBOly

От подключения магазина и расчёта поставки до слота, сборки и этикеток — пошагово.

Начало работы

Быстрый старт

Основной путь от регистрации до готовой поставки состоит из четырёх шагов.

1
Зарегистрируйтесь и подключите магазин. Основной способ — авторизация Ozon (OAuth); дополнительный — Client-Id и Api-Key.
2
На странице Поставка загрузите файл .xlsx, выберите формулу и города. FBOly сопоставит товары, рассчитает распределение и подготовит черновики.
3
На странице Слоты задайте окно дат и времени, выберите города и запустите поиск с автоподтверждением или без него.
4
После создания заявки откройте Умную сборку: соберите товары по списку, сканером или голосовыми командами, создайте грузоместа и этикетки.
Далее
Зарегистрироваться и начать →
Начало работы

Подключение Ozon

Магазин Ozon подключается через авторизацию Ozon (OAuth) — это основной способ. Дополнительно доступно подключение по Client-Id и Api-Key, которые вы создаёте в кабинете Ozon Seller самостоятельно и выдаёте им нужные роли.

Для OAuth нажмите «+» → «Войти через Ozon», выберите кабинет и подтвердите разрешения. Только при этом способе создавать и копировать ключи вручную не требуется. Для дополнительного входа выберите «Подключить через Ozon API» и укажите Client-Id и Api-Key.

На тарифе «Про» можно подключить до 3 магазинов Ozon и переключаться между ними в разделе «Магазин».

Для текущего набора функций нужны разрешения Supply order, Warehouse, Product read-only, Posting FBO read-only, Posting FBS, Company и Report. Supply order используется для FBO-черновиков, слотов, заявок, грузомест и этикеток. Posting FBS используется для получения и сборки FBS-отправлений, передачи маркировки, получения оригинальных PDF-этикеток Ozon и формирования актов. Товары запрашиваются только на чтение.

Если OAuth-подключение потеряло часть разрешений, нажмите «Переподключить». API-ключ можно проверить или заменить в настройках магазина. Доступ любого типа можно отозвать в профиле и на стороне Ozon.

Поставки

Формат Excel-файла

Используйте формат .xlsx. Старый файл .xls откройте в Excel и сохраните как «Книга Excel (.xlsx)». Простое переименование файла не меняет его формат.

Проще всего подготовить файл через расширение FBOly: выберите товары в Ozon Seller, укажите количество и скачайте Excel. Если заполняете список вручную, скачайте пример на странице поставки. Нужны только SKU Ozon или артикул и количество.

Строки с нулевым количеством и пустые строки пропускаются автоматически. Остальные товары продолжают участвовать в расчёте; после обработки видно, сколько строк с нулями пропущено. Для поставки укажите целое количество больше нуля. Если во всём файле только нули, FBOly предложит добавить количество хотя бы одному товару.

КолонкаОписание
SKU Ozon / артикулИдентификатор товара в подключённом кабинете Ozon
КоличествоЦелое количество к распределению
НазваниеНеобязательно: FBOly может получить его из Ozon

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

Отрицательное, дробное или незаполненное количество нужно исправить: FBOly покажет причину и номер строки в Excel. Если товар не найден, проверьте выбранный магазин и идентификатор — нужен SKU или артикул Ozon.
Поставки

Формула распределения

Сохранённая формула задаёт источник спроса, горизонт запаса, минимальное количество на город, выбранные города и правила для отдельных SKU или групп товаров.

В списке «Не возить» укажите SKU Ozon через запятую, пробел или с новой строки. Эти позиции не участвуют в распределении и остаются в файле остатков. После изменения правила пересчитайте ранее подготовленную поставку.

Для крупногабаритных товаров включите проверку КГТ. Расчёт по городам остаётся предварительным: после создания черновика FBOly проверяет ответ Ozon по его составу и допускает к подбору слота только подтверждённые варианты приёмки. Если подтверждения нет, вы увидите причину и сможете выбрать другой склад или город. Перед бронированием проверка выполняется повторно.

Стратегия «По спросу · 28 дней» использует среднесуточные продажи Ozon за 28 дней. Для выбранных городов применяется матрица Москва ×3, Санкт-Петербург ×2, основные города ×1 и общий хвост для остальных. При малом объёме обязательный минимум на город имеет приоритет над точной пропорцией.

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

Кластеры и черновики

Ozon группирует склады в логистические кластеры. FBOly рассчитывает количество по выбранным городам и готовит виртуальные API-черновики. Они сохраняются в FBOly; поставки появляются в личном кабинете Ozon после бронирования слота на странице «Охота на слоты».

Прогресс создания показывается по каждому городу. Если Ozon отклоняет отдельные SKU или направление, FBOly отображает причину и доступные действия, не маскируя ошибку бесконечным пересозданием.

Поставки

Прямая поставка и кроссдокинг

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

Кроссдокинг — вся партия одной поставкой уезжает в единую точку отгрузки, а Ozon сам развозит товар по складам дальше. Точку кроссдокинга и склад прямой поставки можно найти поиском на странице «Поставка»; в списке показываются только точки, доступные вашему магазину Ozon.

Тип поставки фиксируется при создании черновика. Менять тип и точку отгрузки нужно до запуска создания; при изменении подготовленные данные пересобираются под новый вариант.
Слоты

Охотник на слоты

После создания черновиков переходите на страницу «Слоты». Укажите диапазон дат и времени и формат поставки (короба/паллеты), выберите города для охоты и нажмите «Начать охоту». Охотник бронирует только слоты, попадающие в заданное окно времени — например, при настройке «с 22:00» слоты на 18:00 будут пропущены.

В режиме «Автоматически бронировать» система сразу захватывает первый подходящий слот. В режиме уведомления она только сообщает о найденном окне, а бронирование остаётся за вами. Если для прямой поставки выбран конкретный склад приёмки, охотник ищет слоты только на нём.

На пробном периоде и тарифе «Про» можно отметить приоритетные города: они ставятся раньше в обработку и повторно проверяются чаще внутри вашей охоты. Это не даёт глобального приоритета перед другими пользователями.

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

Автоматизация

Умная сборка

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

Телефон подключается к текущей поставке по QR-ссылке. Сборщики видят общий прогресс и могут переключаться между городами. Голосовой помощник выполняет только складские команды: добавление и уменьшение количества, переход к следующему товару, работу с коробами, увеличение фото, отмену и завершение.

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

Автоматизация

Планер закупок

Планер разделяет два решения: что уже пора отправить на Ozon и что заранее заказать у поставщика. Расчёт учитывает спрос, остатки Ozon, активные заявки, собственный склад и товары в производстве.

На вкладке «Мой склад» сохраняется фактический остаток. Для SKU можно указать поставщика, срок поставки, минимальную партию, кратность, себестоимость и ожидаемый ADS. Из рекомендации создаётся заказ поставщику с отслеживанием статуса и фактического прихода.

Автоматизация

Расширение Chrome

Расширение необязательно для работы FBOly. Оно добавляет кнопку «+» на странице списка товаров Ozon Seller, собирает выбранные SKU и количества и локально формирует совместимый файл .xlsx.

Список поставки хранится в браузере. Для проверки активного тарифа расширение связывается с аккаунтом FBOly по отдельному токену. Установка и политика конфиденциальности доступны на странице Расширения.

Автоматизация

Telegram-уведомления

Telegram подключается добровольно в профиле. Можно получать нейтральные сервисные уведомления о найденном слоте или изменении статуса и открывать подробности только после входа в FBOly.

Настройки уведомлений можно изменить, а привязку — удалить в профиле. Через Telegram не отправляются остатки, продажи, email, реквизиты пользователя, состав или номер поставки.

Прочее

Тарифы и лимиты

После регистрации доступен пробный период на 3 дня — возможности тарифа «Про» для одного магазина. После его окончания нужна подписка «Плюс» или «Про». Поставки и SKU на обоих платных тарифах не ограничены.

ДоступМагазиныПроверка городов
Пробный период, 3 дня1Ускоренная
Плюс1Обычная
ПроДо 3Ускоренная для выбранных

Полное сравнение и варианты оплаты — на странице Тарифов.

Прочее

Безопасность данных

Магазин Ozon подключается через авторизацию Ozon (OAuth) — это основной способ. Дополнительно доступно подключение по Client-Id и Api-Key, которые вы создаёте в кабинете Ozon Seller самостоятельно и выдаёте им нужные роли. Пароль от кабинета FBOly не получает и не хранит ни при одном способе.

И ключи, и выданные Ozon токены хранятся на сервере в зашифрованном виде — алгоритм AES-256-GCM, ключ шифрования вынесен в отдельный серверный секрет и не хранится вместе с данными. В браузере ни ключи, ни токены не сохраняются. Ключ можно в любой момент удалить в профиле или отозвать в кабинете Ozon.

Каждый магазин и все данные FBO-поставок и FBS-заказов жёстко привязаны к вашему аккаунту: сервер проверяет владельца на каждом запросе, поэтому чужие доступы или поставки недоступны даже при подмене параметров.

МеханизмЧто защищает
HTTPS (Let's Encrypt)Весь трафик между вами и FBOly шифруется
AES-256-GCMТокены доступа Ozon зашифрованы в базе отдельным секретом
CSRF-защитаБлокирует запросы с посторонних сайтов от вашего имени
Cache-Control: no-storeСлужебные ответы не кэшируются браузером и прокси
Привязка к аккаунтуМагазины и поставки доступны только их владельцу

Пароль аккаунта хранится только в виде необратимого хэша (scrypt). Регистрация подтверждается 6-значным кодом на почту, смена пароля завершает все остальные сеансы входа.

Для работы FBOly запрашивает у Ozon 7 разрешений: Supply order, Warehouse, Product read-only, Posting FBO read-only, Posting FBS, Company и Report. Они позволяют работать с товарами, складами, FBO-поставками и FBS-заказами, но не дают доступа к выводу средств или управлению финансами.

Токены доступа не передаются посторонним лицам и используются только для разрешённых операций с вашим кабинетом Ozon. Отозвать доступ можно в любой момент: нажмите «Отключить доступ» в профиле FBOly или отключите приложение в кабинете Ozon.

Ещё вопросы?
Смотрите частые вопросы →
Прочее

Поддержка

Поддержка по email support@fboly.ru и в Telegram — отвечаем в течение рабочего дня. В обращении укажите шаг, на котором возникла проблема, и текст ошибки. Не отправляйте API-ключи, пароли, платёжные реквизиты и другие секреты.