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

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

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

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

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

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

1
Зарегистрируйтесь и подключите магазин. Основной способ — авторизация Ozon (OAuth); дополнительный — Client-Id и Api-Key.
2
На странице Поставка загрузите файл .xlsx или .xls, выберите формулу и города. 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, Company и Report. Supply order используется для черновиков, слотов, заявок, состава грузомест и этикеток; товары запрашиваются только на чтение.

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

Поставки

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

Поддерживаются форматы .xlsx и .xls.

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

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

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

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

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

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

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

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

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

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

Поставки

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

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

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

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

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

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

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

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

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

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

Умная сборка

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

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

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

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

Расширение 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.

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

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

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

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

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

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

Поддержка

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