Справка OneFill

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

OneFill — это единый кабинет управления маркетплейсами. Вы создаёте одну карточку товара и управляете всеми площадками из одного места: Ozon, Wildberries, Яндекс.Маркет, AliExpress, WooCommerce.

1. Зарегистрируйтесь

   Введите email, получите код и войдите. Или нажмите «Войти через Яндекс» — займёт 10 секунд.

2. Подключите маркетплейсы

   Добавьте API-ключи от ваших магазинов на площадках — Ozon, Wildberries, Яндекс.Маркет, AliExpress, WooCommerce.

3. Импортируйте или создайте товары

   Загрузите существующие карточки с маркетплейсов или создайте новые прямо в OneFill.

4. Опубликуйте на всех площадках

   Передайте обновлённые карточки или создайте новые на всех подключённых маркетплейсах одновременно.

5. Контролируйте остатки и цены

   Настройте ценообразование для каждой платформы и следите за остатками из одного окна.

6. Обрабатывайте заказы

   Все заказы со всех площадок в одном списке. Аналитика и статистика без переключения между кабинетами.

Веб-версия и мобильное приложение

Веб-версия (onefill.ru) — основной инструмент. OneFill работает с большими объёмами данных: создание и редактирование карточек, массовое управление ценами и остатками, обработка заказов — всё это в табличном виде, с которым удобно работать на десктопе. Ворочать такой объём данных с экрана телефона тяжело, поэтому основную работу мы держим в вебе.

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

Регистрация и вход

В OneFill нет паролей. Вход происходит по одноразовому коду на email или через Яндекс ID. Отдельной страницы «Создать аккаунт» тоже нет — первый вход автоматически создаёт аккаунт.

Вход по email

1. Перейдите на страницу входа и введите ваш email
2. Нажмите «Получить код» — на почту придёт письмо с 6-значным кодом
3. Введите код в поле на сайте и нажмите «Войти»

Быстрый вход через Яндекс ID

1. На странице входа нажмите кнопку «Войти через Яндекс»
2. Разрешите доступ к вашему аккаунту Яндекс
3. Готово — вы в системе. Аккаунт создаётся автоматически

Профиль

Страница профиля доступна по ссылке «Профиль» в верхнем меню после входа. Здесь хранятся ваши личные данные и настройки аккаунта.

Что можно настроить

• Аватар — загрузите фото или изображение (JPEG, PNG, WebP, до 5 МБ)
• Имя и фамилия — отображаются в профиле и письмах
• Телефон — опционально, для связи
• Email — основной адрес для входа и уведомлений

Меню «Настройки»

Настройки находятся не в профиле, а в левом меню — пункт «Настройки» (иконка шестерёнки). Он раскрывается в разделы:

• Склады — складские локации
• Ценообразование — формула цены для каждой площадки
• Остатки — автосинхронизация и мульти-остатки
• API-ключи — доступ к публичному API

Подписка

OneFill работает по двухуровневой модели: бесплатный тариф и PRO.

Управление подпиской: Профиль → Подписка. Оплата через Точка Банк, автопродление можно отключить в любой момент.

Интеграции

Интеграция — это подключение конкретного магазина (аккаунта) на маркетплейсе. Один аккаунт OneFill может управлять несколькими интеграциями одновременно.

Раздел интеграций: Меню → Интеграции. Нажмите «Добавить» и выберите тип маркетплейса.

Ozon

Для подключения нужны Client ID и API-ключ из личного кабинета Ozon Seller.

1. Войдите в seller.ozon.ru
2. Перейдите: Настройки → API-ключи → Создать ключ
3. Укажите тип: Seller API
4. Скопируйте Client ID (числовой) и API-ключ
5. Вставьте оба значения в форму добавления интеграции OneFill

Wildberries

Для подключения нужен API-токен из личного кабинета WB Seller.

1. Войдите в seller.wildberries.ru
2. Перейдите: Настройки → Доступ к API → Создать новый токен
3. Выберите нужные права (рекомендуется: Контент, Цены/скидки, Статистика, Заказы)
4. Скопируйте токен — он показывается только один раз
5. Вставьте токен в форму добавления интеграции OneFill

Яндекс.Маркет

Для подключения нужны OAuth-токен и ID кампании.

1. Войдите в partner.market.yandex.ru
2. Перейдите: Настройки → Разработчикам → Выдать токен
3. Скопируйте OAuth-токен
4. ID кампании — числовой ID магазина (виден в URL страницы магазина)
5. Укажите тип работы с заказами: FBS (со своего склада) или DBS (доставка своей службой)
6. Вставьте данные в форму OneFill

AliExpress

Интеграция с AliExpress Россия работает через Seller API.

1. Войдите в seller.aliexpress.ru
2. В разделе API-доступа создайте приложение и получите App Key и App Secret
3. Пройдите OAuth-авторизацию и получите Access Token
4. Укажите Seller ID (ID вашего магазина)
5. Вставьте данные в форму OneFill

WooCommerce

Интеграция с интернет-магазином на WordPress + WooCommerce.

1. В панели WordPress перейдите: WooCommerce → Настройки → Расширенные → REST API
2. Нажмите «Добавить ключ», выберите права: Чтение/Запись
3. Скопируйте Consumer Key и Consumer Secret
4. Укажите URL магазина (например: https://myshop.ru)
5. Вставьте данные в форму OneFill

СДЭК

Интеграция со СДЭК даёт два сценария использования:

• Отправка заказов из WooCommerce — в карточке заказа появляется кнопка «Отправить через СДЭК». Нажали — система создаёт отправление автоматически
• Произвольное отправление — накидываете любые товары из каталога, система рассчитывает стоимость доставки по объёму и весу, выбираете ПВЗ или адрес и подтверждаете

Подключение СДЭК

1. Зарегистрируйтесь или войдите в личный кабинет СДЭК
2. Получите Client ID и Client Secret в разделе API-интеграций
3. Вставьте данные в форму OneFill
4. Укажите реквизиты отправителя: ФИО, телефон, адрес склада

Товары

Раздел «Товары» — это единый каталог. Здесь хранятся мастер-карточки товаров, которые вы публикуете на нескольких маркетплейсах сразу.

Создание товара

Нажмите «Добавить товар» и заполните карточку:

• Название — отображается на всех маркетплейсах
• Артикул — ваш внутренний код товара
• Штрихкод — EAN/UPC, нужен для большинства маркетплейсов
• Код ТН ВЭД — задаётся один раз, передаётся на все площадки; для многих товаров обязателен
• Категория — выбирается для каждого маркетплейса отдельно
• Описание, характеристики — общее для всех площадок
• Фотографии — загружаются один раз, публикуются на все маркетплейсы
• Видео — загружается один раз, публикуется на поддерживающие площадки (тариф PRO)
• Вес и габариты — нужны для расчёта доставки
• Цена — базовая цена; для каждого маркетплейса можно задать формулу наценки
• Остаток — количество на складе

Импорт с маркетплейса

Если у вас уже есть товары на маркетплейсах — их можно импортировать:

1. Перейдите в раздел интеграции (Ozon, WB и т.д.)
2. Нажмите «Загрузить товары»
3. Система загрузит список товаров с маркетплейса
4. Выберите нужные товары и нажмите «Импортировать в каталог»

Цены и остатки

Базовая цена и остаток задаются в карточке. Как настроить цену отдельно для каждой площадки, включить автосинхронизацию остатков и вести общий остаток для дублей и наборов — в разделах Настройка цены, Синхронизация остатков и Мультиучёт остатков.

Видео в карточках

Видео загружается в карточку один раз и публикуется на площадки, которые его поддерживают: Ozon, Wildberries, Яндекс.Маркет и AliExpress (WooCommerce видео не принимает). Один видеофайл на карточку, формат MP4 или MOV.

Видео — функция тарифа PRO: включено 5 ГБ хранилища. Нужно больше — докупаются блоки по 50 ГБ (299 ₽/мес). После ухода с PRO видео хранится ещё 30 дней, затем удаляется.

Код ТН ВЭД

Код ТН ВЭД задаётся в карточке один раз и автоматически передаётся на Ozon, Wildberries и Яндекс.Маркет при синхронизации. Проставить его можно в карточке товара, массово в списке товаров или через Excel и API.

Снятие с продажи и возврат

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

Массовые операции

• Экспорт в Excel — выгрузка каталога с ценами и остатками
• Импорт из Excel — массовое обновление цен, остатков и других полей по артикулу
• Массовые действия — для выбранных товаров сразу: передача на площадки, снятие с продажи и возврат, проставление ТН ВЭД, объединение в общий остаток, обновление цен и остатков

Настройка цены

В карточке товара задаётся базовая цена (до и после скидки). А то, какая цена уйдёт на каждый маркетплейс, определяет формула ценообразования — своя для каждой интеграции. Так одна карточка может продаваться на Ozon, Wildberries и Яндекс.Маркете по разным ценам с учётом комиссий площадок.

Раздел: в меню слева «Настройки» → «Ценообразование». Выберите интеграцию и режим расчёта.

Как настроить

1. Откройте Ценообразование и выберите нужную интеграцию
2. Выберите режим: «Как есть», «Наценка», «Комиссия» или «Формула»
3. Заполните проценты и поля режима — рядом виден предпросчёт итоговой цены на примере
4. Сохраните — формула применится при следующей передаче цен на площадку

Синхронизация остатков

Остаток товара хранится в OneFill централизованно. Когда вы меняете его в карточке или он списывается при продаже — новое значение можно автоматически разослать на все подключённые площадки, чтобы нигде не висел «фантомный» остаток и не приходили заказы на то, чего уже нет.

Как включить автосинхронизацию остатков

1. В меню слева откройте «Настройки» → «Остатки» (иконка шестерёнки)
2. Включите тумблер «Автосинхронизация остатков»

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

Мультиучёт остатков

Мультиучёт нужен, когда один и тот же физический товар продаётся несколькими карточками (разные названия, разные площадки) или наборами и комплектами. Он держит все такие карточки на одном общем остатке, чтобы продажа в одной сразу уменьшала доступное количество в остальных.

Как включить

1. В меню слева откройте «Настройки» → «Остатки»
2. Включите тумблер «Ведение мульти-остатков» — включайте, только если это вам нужно, остальным он не мешает

Общий остаток для дублей карточек

Объединяете дубли одного товара в группу с единым остатком. Продажа в любой карточке уменьшает общий остаток, остальные карточки пересчитываются и рассылаются на площадки автоматически. Больше не нужно вручную выравнивать остатки между карточками на Ozon, Wildberries и Яндекс.Маркете.

Продажа наборами и комплектами

У каждой карточки в группе есть множитель — сколько базовых единиц списывается со склада за одну продажу. Пример: на складе 1000 карандашей. Карточка «Карандаши 20 штук» с множителем 20 показывает на площадке 50 наборов, карточка «Карандаши 3 штуки» с множителем 3 — 333 набора. Продали 1 набор из 20 — со склада уходит 20, остаётся 980, обе карточки пересчитываются (49 и 326). Дубли — это частный случай набора с множителем 1.

Как объединить карточки в один остаток

1. В каталоге отметьте галочками карточки одного физического товара
2. В массовых действиях нажмите «Объединить»
3. Укажите общий остаток на складе и множитель каждой карточки — для дублей оставьте 1, для наборов поставьте количество штук

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

Склад

Раздел «Склад» позволяет вести учёт остатков по нескольким складским локациям.

Добавление склада

1. Перейдите в Меню → Склад
2. Нажмите «Добавить склад»
3. Укажите название и адрес
4. Один склад помечается как основной — с него берутся остатки по умолчанию

Остатки товаров привязываются к складу. Когда продажа происходит — остаток списывается с основного склада (или с указанного в заказе).

Заказы

Раздел «Продажи» — все заказы со всех маркетплейсов в одном списке. Больше не нужно переключаться между кабинетами.

Список заказов

Заказы фильтруются по маркетплейсу, статусу и дате. Кликните на заказ — откроется детальная информация: состав, покупатель, адрес доставки, статус.

Этикетки

Для отгрузки нужны этикетки — они печатаются прямо из OneFill:

• Ozon — выберите заказы → «Печать этикеток» → PDF готов к печати
• Яндекс.Маркет — аналогично, поддерживается FBS и DBS
• СДЭК — после создания отправления доступна печать накладной и штрихкода

Создание отправления СДЭК

Два способа создать отправление:

Из заказа WooCommerce — откройте заказ, нажмите кнопку «Отправить через СДЭК». Данные заполняются автоматически из заказа.

Произвольная отправка — перейдите в «Продажи → Создать отправление», добавьте товары из каталога, укажите получателя и адрес доставки. Система рассчитает стоимость по объёму и весу, предложит доступные тарифы и ПВЗ на карте. После подтверждения — печать накладной и штрихкода.

Отгрузка на Ozon

1. Перейдите в «Продажи → Отгрузки Ozon»
2. Создайте перевозку — выберите заказы для отгрузки
3. Укажите метод доставки (Ozon Логистика)
4. Подтвердите отгрузку

Аналитика

Раздел «Аналитика» показывает статистику продаж по всем маркетплейсам в одном дашборде.

Что показывает дашборд

• Выручка — общая и по каждому маркетплейсу
• Количество заказов — динамика по дням/неделям
• Средний чек
• Топ товаров — по выручке и количеству продаж
• Сравнение площадок — где продаётся лучше

Финансовые отчёты

Раздел «Финансы» в аналитике позволяет выгрузить финансовые данные по реализации: выручка, комиссии маркетплейсов, чистая прибыль. Доступен экспорт в Excel.

API для разработчиков

OneFill можно подключить к своим системам — 1С, складским программам, собственному сайту — через REST API. Тот же сценарий, что у Excel-загрузки, доступен по HTTP: массовое создание и обновление карточек товаров по артикулу.

Шаг 1. Получите API-ключ

1. В меню слева откройте «Настройки» → «API-ключи»
2. Введите название ключа (например, «1С») и нажмите «Создать ключ»
3. Скопируйте ключ — он показывается только один раз. Храните его в секрете
4. Ненужный ключ можно отозвать там же — приложения с ним сразу потеряют доступ

Шаг 2. Аутентификация

Передавайте ключ в заголовке запроса одним из двух способов:

Authorization: Api-Key of_ВАШ_КЛЮЧ
# либо
X-Api-Key: of_ВАШ_КЛЮЧ

Виды API

Создание и обновление товаров

POST https://onefill.ru/api/products/bulk-upsert/

Логика — как в Excel-загрузке: артикул — это ключ. Нет такого артикула в каталоге — карточка создаётся; есть — обновляются только переданные поля (остальное не трогается). Фото — список ссылок, первая становится главной (до 30). При обновлении список фото заменяется целиком. Для создания новой карточки обязательны: article, name, brand, price_before, price_after.

curl -X POST https://onefill.ru/api/products/bulk-upsert/ \
  -H "Authorization: Api-Key of_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "article": "ART-001",
        "name": "Кофемолка Acme",
        "brand": "Acme",
        "price_before": 3990,
        "price_after": 2990,
        "vat": 10,
        "quantity": 15,
        "barcodes": ["4600000000017"],
        "weight_without": 800, "weight_with": 950,
        "length": 120, "width": 110, "height": 200,
        "photos": [
          "https://example.com/main.jpg",
          "https://example.com/second.jpg"
        ],
        "videos": ["https://example.com/promo.mp4"]
      },
      { "article": "ART-002", "price_after": 1490 }
    ]
  }'

Ответ:

{
  "created": 1,
  "updated": 1,
  "total": 2,
  "skipped": [],
  "errors": []
}

Поля товара

• article — артикул, ключ сопоставления (обязателен)
• name, brand, description — название, бренд, описание
• price_before, price_after — цена до и после скидки (₽)
• vat — НДС: 0, 5, 7, 10 или 22
• quantity — остаток на складе
• barcodes — массив штрихкодов (до 10)
• weight_without, weight_with — вес без/с упаковкой (граммы)
• length, width, height — габариты (мм)
• photos — массив ссылок на фото; первая — главная (до 30)
• videos — ссылка на видео (1 шт., MP4/MOV ≤50 МБ); качается к нам на S3 и публикуется на маркетплейсы

Получение списка товаров

curl "https://onefill.ru/api/products/?limit=50&offset=0" \
  -H "X-Api-Key: of_ВАШ_КЛЮЧ"

Лимиты

• До 1000 товаров в одном запросе bulk-upsert
• До 30 фото и 10 штрихкодов на карточку
• Внешние ссылки на фото скачиваются и конвертируются в webp — большие пачки обрабатываются дольше

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

Можно ли подключить несколько магазинов одного маркетплейса?

Да. Каждый магазин/аккаунт — это отдельная интеграция. Вы можете добавить несколько интеграций Ozon, нескольких YM-кампаний и т.д. Все они будут управляться из одного аккаунта OneFill.

Что происходит с данными при отмене PRO?

Данные не удаляются. Вы продолжаете работать на бесплатном тарифе — доступны все базовые функции, автоматическая синхронизация останавливается.

Насколько безопасны мои API-ключи?

Все API-ключи хранятся в зашифрованном виде (Fernet-шифрование). В интерфейсе ключи не отображаются полностью — только последние символы.

Как связаться с поддержкой?

Telegram: @onefillru
Email: info@onefill.ru

Есть ли мобильное приложение OneFill?

Нативные приложения для iOS и Android в разработке — выйдут в App Store и Google Play. Пока их нет, веб-версия открывается и в мобильном браузере. Важно понимать: OneFill работает с большими объёмами данных, и массовые операции с каталогом, ценами и заказами удобнее делать на десктопе. Приложение сфокусируется на аналитике и мониторинге продаж, а не на тяжёлой работе с данными.