Справка OneFill

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

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

1. Войдите по email

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

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

   Раздел «Интеграции» → «+ Добавить интеграцию». Для большинства площадок достаточно одного API-ключа — остальное OneFill получит сам.

3. Заведите мастер-карточки

   Импортируйте существующие товары с площадок, создайте вручную, загрузите из Excel или передайте по API. В работе участвуют только мастер-карточки: скачанный с площадки товар нужно сначала превратить в карточку — поодиночке или массово.

4. Передайте на площадки

   Кнопка «Отправить на маркетплейсы» — OneFill сам определит, создать товар на площадке или обновить существующий.

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

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

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

   Заказы со всех площадок в одном списке, обновление каждые 5 минут: сборка, этикетки, отгрузки, штрихкоды.

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

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

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

Принцип работы: мастер-карточка

Вся суть OneFill — мастер-карточка. Это единственный источник правды о товаре: контент, медиа, цены и остаток живут в одном месте, а не в пяти кабинетах. Вы меняете мастер-карточку — OneFill разносит изменения по площадкам.

Как это работает на практике

• Одна правка — все площадки. Поменяли цену, описание или фото в мастер-карточке — передали на площадки одной кнопкой. Не нужно ходить по кабинетам.
• OneFill сам решает: создать или обновить. Если товара на площадке ещё нет — он будет создан из мастер-карточки. Если уже есть (найден по артикулу) — обновится существующий.
• Заказы возвращаются в ту же карточку. Продажа на любой площадке списывает остаток мастер-карточки, и новый остаток автоматически разлетается на остальные площадки — оверселла нет.
• Цена у каждой площадки своя. В карточке хранится базовая цена, а на каждую площадку уходит цена, посчитанная по её формуле — с учётом комиссий и логистики.

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

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

Вход по email

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

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

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

Профиль и настройки

Страница профиля открывается из меню. Прямо на странице редактируются имя, фамилия и телефон (клик по полю), загружается аватар (JPEG, PNG или WebP до 5 МБ). Email фиксируется при первом входе и из профиля не меняется.

На профиле также видны: статистика по интеграциям и товарам, занятость видеохранилища, вкладка «Уведомления» и ваша активность в сообществе.

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

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

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

Уведомления

Колокольчик уведомлений — в меню профиля (с бейджем непрочитанного). Уведомления приходят про ответы и комментарии в сообществе и про проблемы с интеграциями: если API-ключ площадки перестал работать, вы получите уведомление в кабинете и письмо на почту.

Подписка и тарифы

OneFill работает по двухуровневой модели: бесплатный тариф и PRO. Граница простая: работа с каталогом внутри OneFill — бесплатно и без ограничений по товарам, а передача на маркетплейсы и автоматика — в PRO.

Цена PRO: 4 990 ₽ 1 490 ₽/мес (акционная цена) или 14 990 ₽/год (−16%, ≈ 1 249 ₽/мес). Оплата через Точка Банк, карта привязывается для автопродления.

Управление подпиской

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

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

Интеграции

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

Раздел «Интеграции» в левом меню → кнопка «+ Добавить интеграцию». В окне сервисы сгруппированы: «Маркетплейсы», «Магазины», «Доставка» — выберите нужный и заполните форму. Во всех формах поле «Название» необязательное: OneFill получит название магазина из API автоматически.

Ozon

Нужны Client ID и API Key из кабинета Ozon Seller.

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

После подключения OneFill автоматически подтянет название магазина и информацию о складах Ozon.

Wildberries

Нужен API-токен из кабинета WB Seller.

1. Войдите в seller.wildberries.ru
2. Перейдите: Настройки → Доступ к API → Создать новый токен
3. Выдайте токену доступ к разделам, с которыми будет работать OneFill: контент, цены и скидки, маркетплейс (заказы), статистика. Не ставьте галочку «только на чтение»
4. Скопируйте токен — WB показывает его только один раз
5. В OneFill вставьте его в поле «Bearer Token», нажмите «Подключить Wildberries»

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

Нужен только API-ключ — номер кампании и тип размещения (FBS/DBS) OneFill определит сам.

1. Войдите в partner.market.yandex.ru
2. Перейдите: Настройки → Разработчикам → Авторизационные токены и создайте ключ
3. В OneFill вставьте его в поле «API Key», нажмите «Подключить Яндекс.Маркет»

AliExpress

Нужен только API-токен из кабинета AliExpress Россия (раздел API-доступа).

1. Получите токен в личном кабинете AliExpress Seller
2. В OneFill вставьте его в поле «API Token», нажмите «Подключить AliExpress»

WooCommerce

Подключение интернет-магазина на WordPress + WooCommerce.

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

СДЭК

Интеграция со СДЭК добавляет доставку: отправления из заказов WooCommerce и произвольные отправления с расчётом стоимости. Подробно — в разделе Доставка СДЭК.

1. В личном кабинете СДЭК откройте: Интеграция → Ключи для интеграции
2. Скопируйте Account и Secure password
3. В OneFill заполните оба поля и нажмите «Подключить СДЭК»
4. На карточке интеграции нажмите «Настроить» и укажите: город отправления, ПВЗ для сдачи отправлений (на карте или списком), адрес для забора курьером и тип договора («Интернет-магазин» / «Доставка»)

Если ключ перестал работать

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

Мастер-карточка

Раздел «Товары» — это ваш единый каталог мастер-карточек. Одна карточка хранит всё о товаре и публикуется на все площадки. Ниже — четыре способа завести карточки в OneFill.

Что хранит мастер-карточка

• Контент — название, описание (с форматированием: жирный, курсив, списки), бренд
• Медиа — до 20 фото (JPG/PNG, до 5 МБ каждое) и 1 видео PRO
• Цены — до и после скидки; процент скидки считается автоматически
• Остаток — количество на выбранном складе, с резервом под несобранные заказы
• Штрихкоды — несколько на карточку
• Код ТН ВЭД — задаётся один раз, уходит на Ozon, WB и Яндекс.Маркет
• Категории и характеристики — отдельно для Ozon, Wildberries и Яндекс.Маркета, с деревом категорий и полями характеристик каждой площадки
• Габариты и вес — для расчёта доставки и логистики площадок
• Статус — «В продаже» / «Снята с продажи», счётчик продаж

Способ 1. Создать вручную

В разделе «Товары» нажмите «Новая карточка» — откроется окно «Создать карточку товара».

1. Основная информация

   Название*, описание (редактор с форматированием), артикул*, бренд*, код ТН ВЭД. У поля ТН ВЭД работают подсказки: выберите категорию Wildberries — и OneFill предложит коды из справочника WB по этому предмету.

2. Размеры, вес и цены

   Вес без/с упаковкой (г)*, длина, ширина, высота (мм)* — объём в литрах считается сам. Цена до и после скидки* — процент скидки тоже.

3. Категории маркетплейсов

   Кнопки «Выбрать категорию» для Ozon, Wildberries и Яндекс.Маркета (нужна активная интеграция). После выбора подгружаются характеристики этой категории с площадки — заполните их сразу, чтобы карточка была готова к публикации. Для Ozon выбирайте конечный «Тип товара», для WB — конечный предмет, для ЯМ — конечную категорию.

4. Медиа и штрихкоды

   Перетащите фото (до 20) и видео (1 файл, MP4/MOV/WEBM до 50 МБ, длительность 8 сек – 5 мин, тариф PRO). Штрихкоды добавляются по одному — их может быть несколько.

5. Наличие

   Склад* (основной предвыбран), количество, тумблер «В продаже». Если включён мультиучёт — здесь же можно привязать карточку к группе общего остатка и указать множитель.

Способ 2. Импорт с маркетплейсов

Если товары уже размещены на площадках, их не нужно заводить заново — импортируйте их в каталог. Работает для Ozon, Wildberries, Яндекс.Маркета и WooCommerce.

1. В разделе «Товары» откройте вкладку «На маркетплейсах»
2. Нажмите «Собрать товары» — OneFill загрузит списки товаров со всех подключённых площадок (повторный сбор — не чаще раза в 10 минут)
3. Товары с разных площадок с одинаковым артикулом автоматически объединяются в одну строку; уже заведённые в каталоге помечены бейджем «На складе»
4. У нужного товара нажмите «+ На склад» — откроется окно импорта
5. Проверьте данные и нажмите «Добавить на склад»

В окне импорта всё под контролем: если товар есть на нескольких площадках, у названия, цен, количества, бренда и габаритов появляется выбор — данные какой площадки взять (или впишите свои). Описание при пустом поле возьмётся с маркетплейса, фото выбираются кликом по миниатюрам со всех площадок, штрихкоды собираются отовсюду, здесь же — ставка НДС, ТН ВЭД с подсказками и категории каждой площадки.

Автоматически переносятся: фото, видео (при PRO-квоте), штрихкоды, реальные габариты и описание, бренд, категории и характеристики площадок.

Массовый импорт

Отметьте товары галочками на вкладке «На маркетплейсах» — появятся кнопки «Добавить выбранное» и «Добавить все». В окне выбираются склад и «источник данных» (площадка, чьи данные главные для объединённых карточек). Товары с существующими артикулами пропускаются, добавление идёт партиями с прогресс-баром.

Способ 3. Загрузка из Excel

Кнопка «Импорт (Excel)» в каталоге открывает 4 операции:

В каждом окне — кнопки «Полный шаблон» (с текущими данными каталога) и «Пустой шаблон». Правила: файл .xlsx до 5 МБ, сопоставление по артикулу без учёта регистра, пустая ячейка не меняет поле, новые товары привязываются к основному складу. Файлы больше 200 строк обрабатываются в фоне (до 50 000 строк за файл).

Способ 4. Через публичный API

Тот же upsert по артикулу доступен по HTTP — для 1С, складских программ и собственных систем: POST /api/products/bulk-upsert/. Создание, обновление, фото и видео по ссылкам, до 50 000 товаров за запрос. Подробности, примеры и ключи — в разделе API для разработчиков.

Массовые действия в каталоге

Отметьте товары галочками — появится панель: «Передать остатки», «Передать цены» и выпадающий список «Ещё»: Синхронизировать (передача карточек), Передать медиа, Категории, Комиссия, Снять с продажи / вернуть, Проставить ТН ВЭД, Штрихкоды Ozon, Объединить остатки.

Передача на площадки PRO

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

Откуда передавать

• Из карточки товара — кнопка «Отправить на маркетплейсы»: выберите площадки в окне отправки. Перед отправкой OneFill проверяет готовность карточки (фото, вес, обязательные характеристики) и показывает, чего не хватает.
• С вкладки конкретной площадки в карточке — если товар на площадке найден: кнопки «Обновить товар» и «Передать остатки» + ссылка «Открыть на маркетплейсе»; если не найден — кнопка «Создать на …».
• Массово из каталога — отметьте товары → «Ещё» → «Синхронизировать»: товары делятся на вкладки «готовые» и «не готовые», готовые отправляются пакетом.
• Только медиа — кнопка передачи фото и видео в галерее вкладки площадки или массовое действие «Передать медиа».

Что уходит на площадку

Название, описание, бренд, штрихкоды, цены (через формулу ценообразования интеграции), габариты и вес, категория и характеристики, фото, видео и код ТН ВЭД. Лимиты фото у площадок свои: Ozon — до 15, Wildberries — до 10, Яндекс.Маркет — до 30, AliExpress — до 6.

Видео по площадкам

• Wildberries, Яндекс.Маркет — видео уходит автоматически вместе с фото
• AliExpress — видео передаётся после обработки его площадкой (занимает время)
• Ozon — загруженный видеофайл через API не передаётся (ограничение Ozon): добавьте видео вручную в кабинете Ozon или используйте YouTube-ссылку
• WooCommerce — видео не поддерживает

Код ТН ВЭД

Задаётся в карточке один раз и при передаче автоматически попадает на Ozon (характеристика «ТН ВЭД»), Wildberries (характеристика предмета) и Яндекс.Маркет (commodityCodes). Массово проставить код на выбранные товары: каталог → «Ещё» → «Проставить ТН ВЭД».

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

Тумблер «В продаже» в карточке — или массово: каталог → «Ещё» → «Снять с продажи / вернуть» с выбором площадок. Товар нигде не удаляется и возвращается в продажу в один клик. Механика у площадок разная:

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

В мастер-карточке хранится базовая цена (до и после скидки). Какая цена уйдёт на каждую площадку — решает режим ценообразования, свой для каждой интеграции. Так одна карточка продаётся на Ozon, WB и ЯМ по разным ценам с учётом комиссий.

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

Возможности режима «Формула»

• Тарифы по категориям — тумблеры «Тарифы Ozon/Wildberries/Яндекс.Маркет по категориям»: комиссия подтягивается из официальных тарифных таблиц по категории товара автоматически, вручную вводить не нужно.
• Индивидуальная комиссия и наценка по товару — задаются в каталоге: отметьте товары → «Ещё» → «Комиссия». Индивидуальные значения приоритетнее общих и тарифных.
• «Удерживать цену» (Wildberries, PRO) — если WB сам изменил вашу скидку, OneFill сбросит её обратно (проверка каждые 30 минут).
• «Запретить автоакции» (Ozon, PRO) — при обновлении цен запрещает Ozon автоматически добавлять товары в акции.

Внизу каждой карточки — проверка цены: введите тестовую цену и сразу увидите, что уйдёт на площадку. Настраивать и проверять формулы можно на любом тарифе; сама передача цен — PRO.

Остатки и автоучёт

Остаток товара хранится в мастер-карточке. При включённой автосинхронизации любое его изменение автоматически разлетается на все подключённые площадки — Ozon, Wildberries, Яндекс.Маркет, AliExpress и WooCommerce, — чтобы нигде не висел «фантомный» остаток.

Что запускает авторассылку

• Продажа или бронирование — заказ на любой площадке списывает/резервирует остаток
• Правка количества в каталоге или карточке
• Загрузка остатков из Excel
• Обновление через публичный API

Тумблер: «Настройки» → «Остатки» → «Автосинхронизация остатков». Он включён по умолчанию; передача на площадки работает на тарифе PRO.

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

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

Как включить

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

Дубли и наборы

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

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

1. В каталоге отметьте карточки одного физического товара
2. «Ещё» → «Объединить остатки» (пункт появляется при включённом мультиучёте)
3. Укажите общий остаток на складе и множитель каждой карточки (для дублей — 1)

После объединения в карточке появляется блок группы: общий остаток, множитель «Штук в карточке» и «Доступно на площадке»; по иконке группы открывается список объединённых карточек — любую можно разъединить в один клик. Привязать карточку к группе можно и сразу при создании (блок «Мультиучёт» в окне создания).

Склады

Раздел: левое меню → «Настройки» → «Склады». Каждая мастер-карточка привязана к одному складу — на нём хранится её остаток. При первом заходе OneFill сам создаёт «Основной склад».

Работа со складами

• «+ Добавить склад» — название (до 30 символов) и адрес (с подсказками при вводе)
• Основной склад — ровно один: он предвыбран при создании и импорте карточек, на него попадают новые товары из Excel и API. Удалить основной склад нельзя
• Название и адрес редактируются прямо в списке, активность — тумблером; по каждому складу видно число товаров и суммарный остаток
• Удаление склада — с выбором, что делать с его товарами: удалить, перенести на основной или на другой склад

Заказы

Раздел «Продажи» — заказы со всех маркетплейсов в одном окне: вкладка на каждый подключённый магазин Ozon, Яндекс.Маркета, WooCommerce, Wildberries и AliExpress, три статуса: «Ожидает сборки» → «Ожидает отправки» → «Доставляется».

На тарифе PRO заказы обновляются в фоне каждые 5 минут (AliExpress — при открытии страницы). Свежий запрос к площадке уходит и при открытии вкладки. Продажа на любой площадке автоматически резервирует и списывает остаток мастер-карточки — включая заказы Wildberries и AliExpress.

Что можно делать с заказами

Заказы Wildberries и AliExpress показываются в режиме просмотра (действия — в кабинетах площадок), но остатки по ним OneFill учитывает полностью: резерв при новом заказе, списание при отгрузке, возврат резерва при отмене.

В карточке заказа Ozon видна шкала тарификации — сколько скидки или штрафа даёт площадка за срок отгрузки.

Отгрузки Ozon

Кнопка «Перейти к отгрузкам» на странице заказов → окно «Отгрузки Ozon»:

1. Вкладка «Создать отгрузку»: укажите дату отгрузки и метод доставки, отметьте заказы — создастся перевозка PRO
2. Вкладка «Созданные отгрузки»: «Подтвердить», затем «Акт (PDF)» — акт приёма-передачи с этикетками и «Штрихкод» — штрихкод отгрузки для сдачи в пункте приёма

Отгрузки Яндекс.Маркета

Та же кнопка на вкладке ЯМ — окно «Отгрузки Яндекс.Маркет»: «Подтвердить отгрузку» PRO, «Скачать акт» (PDF) и перенос заказа в следующую отгрузку кнопкой «Перенести» (первый перенос бесплатный — повторный ЯМ штрафует).

Доставка СДЭК

С подключённой интеграцией СДЭК (как подключить) в OneFill доступны два сценария доставки и архив отправлений.

Из заказа WooCommerce

В заказе нажмите «Отправить СДЭК» — получатель (ФИО, телефон, город, адрес) и товары с габаритами подставятся автоматически, останется проверить и подтвердить.

Произвольное отправление

Пункт меню «Создать отправление»:

1. Откуда: «Сдать в ПВЗ» или «Курьер заберёт» (адреса — из настроек интеграции)
2. Получатель: физлицо (ФИО) или юрлицо (название + ИНН), телефон
3. Грузоместа: найдите товары из каталога — габариты и вес подставятся из мастер-карточек
4. Куда: до ПВЗ (выбор на карте или списком) или курьером до адреса
5. Стоимость считается автоматически по тарифу СДЭК; есть тумблер «Доставка за счёт получателя». Нажмите «Создать отправление»

Архив отправлений

Пункт меню «Отправления» — все отправления СДЭК: статус (обновляется по кнопке ↻), отмена, добавление существующего заказа СДЭК по номеру. На странице отправления — кнопки «Накладная» и «Штрихкод» (PDF для печати) и маршрут с историей статусов.

Аналитика

Раздел «Аналитика» — финансы и продажи по всем магазинам. Данные берутся напрямую из API площадок за последние 12 месяцев. Вкладки: «Общая» (все магазины) и по одной на каждый магазин Ozon, Яндекс.Маркета, Wildberries и WooCommerce.

Вкладка магазина

• Выручка магазина — сумма и график, переключение между «за 12 месяцев» и конкретным месяцем
• Календарь продаж — годовая тепловая карта по дням: сразу видно сильные и слабые дни
• Показатели — заказов за год, средний чек, активных дней из 365, топ-товар
• Топ товаров — до 12 позиций с выручкой, штуками и долей в выручке; клик ведёт в карточку товара

Вкладка «Общая»

Всё то же по всем магазинам сразу + рейтинг «Топ магазинов»: выручка и доля каждой площадки — сразу видно, где продаётся лучше.

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 }
    ]
  }'

Ответ (до 200 товаров — синхронный):

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

Больше 200 товаров — запрос уходит в фоновую обработку, ответ придёт сразу: {"async": true, "job_id": "…", "total": N, "status_url": "/api/products/import-jobs/…/"}. Готовность проверяйте GET-запросом по status_url.

Поля товара

• 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 МБ); скачивается в хранилище OneFill (квота видео — PRO)

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

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

Лимиты

• До 50 000 товаров в одном запросе bulk-upsert; больше 200 — фоновая обработка с job_id
• До 30 фото и 10 штрихкодов на карточку
• Внешние ссылки на фото скачиваются и конвертируются — большие пачки обрабатываются дольше
• До 20 активных API-ключей на аккаунт

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

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

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

Я отменил PRO — что будет с оплаченным периодом и данными?

Оплаченный период не сгорает: PRO работает до конца оплаченного срока, отключается только автопродление. После окончания срока вы переходите на бесплатный тариф — все данные (карточки, интеграции, история заказов) сохраняются, останавливается только передача на площадки и автоматика. Видео хранится ещё 30 дней.

Почему товар не публикуется на площадке?

Перед отправкой OneFill проверяет готовность карточки и показывает, чего не хватает — чаще всего это фото, вес/габариты или обязательные характеристики категории. Если остатки не уходят на Wildberries — проверьте, создан ли склад продавца FBS в кабинете WB.

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

Ключи интеграций хранятся в зашифрованном виде (Fernet-шифрование) и в интерфейсе не отображаются. Ключи публичного API OneFill вообще не хранятся в открытом виде — только хэш; полный ключ показывается один раз при создании.

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

Telegram: @onefillru
Email: info@onefill.ru

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

Нативные приложения для iOS и Android в разработке. Пока веб-версия открывается и в мобильном браузере, но массовые операции с каталогом удобнее делать на десктопе — приложение сфокусируется на аналитике и мониторинге продаж.