Интеграции по API: что подключается и что заполняется само

8 сентября 2026

Заводить второй магазин руками никто не станет: карточки, фотографии, цены, остатки — это неделя работы, а через месяц всё разъедется с площадкой. Поэтому каталог в QRючке не заполняется. Он подключается.

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

Пять интеграций

что подключается	что для этого нужно	что даёт
Wildberries	один токен	карточки, цены, остатки FBO и FBS, фотографии
Ozon Seller API	Client-Id и Api-Key	то же по своей витрине
СДЭК	account и secure password	расчёт, заявка, трек-номер
Boxberry	токен	то же
Яндекс Доставка	OAuth-токен	то же

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

Раздел «Настройки» в кабинете продавца QRючка: карточки подключения Wildberries API, Ozon Seller API, служб доставки СДЭК, Boxberry и Яндекс Доставка, а также брендового бота, с полями для ключей и пояснениями — Раздел «Настройки». Под каждым полем написано, где взять ключ и какие права ему нужны. Кнопки «Импортировать каталог» и «Синк цен и остатков» запускают то же, что потом идёт по расписанию.

Что заезжает после подключения

Импорт каталога тянет по каждой карточке:

название товара;
цену — итоговую, после всех скидок площадки, а не базовую из карточки;
остаток — FBO и FBS вместе;
заглавную фотографию — она скачивается к нам и отдаётся с нашего домена.

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

Описание с площадки не переносится

Единственное поле, которое импорт сознательно пропускает. Описания на маркетплейсах написаны под их поиск: ключевые слова, повторы, перечисления синонимов. В магазине бренда это читается плохо, поэтому описание остаётся на усмотрение продавца.

Цены и остатки обновляются каждые полчаса

Синхронизация идёт по расписанию, без нажатий. По каждому товару обновляются цена после скидок, остаток и метка свежести — время последней сверки.

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

Повторный импорт не затирает вашу работу Запускать импорт можно сколько угодно раз. У товаров, которые уже есть, обновится только название. Цена для своих, описание, статус и цикл потребления — поля продавца, импорт их не трогает.

Ключи проверяются при сохранении

Ключ не складывается в базу молча. При сохранении делается живой запрос: у Wildberries проверяются категории «Контент» и «Цены и скидки», у СДЭК запрашивается OAuth-токен, который выдаётся только на верную пару доступов, у Boxberry вызывается лёгкий метод проверки.

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

Ozon достаточно роли Admin read only: витрине нужно только чтение. Просить больше прав, чем нужно для работы, мы не станем — и вам не советуем соглашаться на это ни с каким сервисом.

Что всё-таки заполняет продавец

Три поля, и все три — по делу:

Себестоимость. Её знает только продавец, взять её неоткуда. Нужна для расчёта маржи.
Цикл потребления в днях. Через сколько у покупателя закончится товар. Из него считаются напоминания о повторной покупке.
Цена для своих — если она отличается от цены площадки. По умолчанию стоит режим «= цене МП», и тогда ничего вводить не нужно.

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

Что это меняет на практике

Онбординг занимает около получаса, и почти всё это время уходит на то, чтобы создать токены в кабинетах площадок. Каталог из сотни товаров появляется за один прогон импорта.

Дальше продавец ведёт товары там же, где вёл всегда — в кабинете площадки. Поменял цену на Wildberries — она поменяется в магазине бренда в течение получаса. Второй каталог вести не нужно, и в этом весь смысл.

Коротко: частые вопросы

Нужно ли заполнять каталог товаров руками?

Нет. После подключения ключа площадки каталог заезжает целиком: названия, цены после скидок, остатки и заглавные фотографии карточек. Ни одно поле товара вводить не нужно. Единственное, что продавец вставляет вручную, — сами ключи доступа.

Какие интеграции по API есть у QRючка?

Wildberries Content API и API цен, Ozon Seller API, а также три службы доставки: СДЭК, Boxberry и Яндекс Доставка. Каждая подключается своим ключом в разделе «Настройки» кабинета продавца.

Как часто обновляются цены и остатки?

Каждые 30 минут по расписанию. Обновляются итоговая цена после скидок и остаток по каждому товару, а также метка свежести. Товар с нулевым остатком скрывается с витрины автоматически, чтобы покупатель не заказал то, чего нет.

Какой токен Wildberries нужен и какие категории в нём отметить?

Токен создаётся в кабинете WB: Настройки → Доступ к API. Обязательные категории — «Контент» и «Цены и скидки», они проверяются при сохранении. «Статистика и аналитика» нужна для остатков FBO, «Маркетплейс» — для остатков FBS со своего склада.

Какие права нужны ключу Ozon?

Роль Admin read only — витрине достаточно чтения. Ключ создаётся в кабинете Ozon: Настройки → Seller API → «Сгенерировать ключ», Client-Id указан на той же странице над списком ключей.

Проверяется ли ключ при сохранении?

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

Откуда берутся фотографии товаров?

Заглавная фотография карточки скачивается на наш сервер и отдаётся с нашего домена, а не по ссылке на CDN площадки. Ссылки на CDN площадок со временем перестают работать, поэтому витрина на них не опирается.

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

По теме: что нужно собрать, чтобы продавать напрямую — полный состав канала; сколько это стоит — цена и порог окупаемости.

QRючок — самостоятельный сервис. Не является партнёром, представителем или аффилированным лицом ООО «РВБ», Wildberries, ООО «Интернет Решения», Ozon и иных торговых площадок.