SelSup Developers

API для интеграторов

Подключите свой сервис к SelSup

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

GET /api/brand/find
curl 'https://api.selsup.ru/api/brand/find?query=Base' \
  --header 'Authorization: YOUR_API_TOKEN'

HTTP/1.1 200 OK
{
  "rows": [{ "brandId": 8124, "name": "Base" }],
  "hasNextPage": false
}

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

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

Получите токен в кабинете SelSup и выполните запрос на чтение данных, например запрос списка брендов.

01

Получите токен

Откройте настройки API, введите название подключения и нажмите «Добавить токен». Скопируйте полученный токен.

02

Передавайте токен в запросах

Укажите токен в заголовке Authorization без префикса Bearer.

03

Обрабатывайте ошибки

Поле error содержит код ошибки, по которому программа может выбрать действие. В localMessage приходит сообщение для пользователя.

Authorization

Авторизация

Отправляйте запросы на https://api.selsup.ru и передавайте токен в заголовке Authorization. Для запросов с JSON указывайте Content-Type: application/json.

Shell
curl 'https://api.selsup.ru/api/brand/all' \
  --header 'Authorization: YOUR_API_TOKEN'

Справочник API

API по задачам

Выберите раздел, чтобы посмотреть доступные методы, параметры запросов, поля ответа и возможные ошибки.

{ }

Акции

Акции маркетплейсов, товары в акциях и обновление их данных.

Методы: 11→
{ }

Аналитика

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

Методы: 108→
{ }

Биллинг

Операции биллинга за выбранный период.

Методы: 1→
{ }

Бренды

Создавайте и находите бренды, связывайте их с Ozon и 1С, управляйте логотипами и безопасно объединяйте дубликаты.

Методы: 9→
{ }

Вебхуки

Создание, просмотр и удаление подписок на уведомления об изменениях в SelSup.

Методы: 3→
{ }

Возвраты

Получение возвратов товаров, поиск и выгрузка в Excel.

Методы: 3→
{ }

Групповые карточки

Создание, изменение и объединение групповых карточек.

Методы: 6→
{ }

Документы

Документы для маркировки товаров, работы с Честным знаком и ЭДО.

Методы: 20→
{ }

Доставка

Тарифы и пункты доставки, создание заказов в службах доставки и получение накладных.

Методы: 18→
{ }

Задачи

Поиск фоновых задач и получение результатов их выполнения.

Методы: 4→
{ }

Заказы

Создание и поиск заказов, изменение их состава и статусов.

Методы: 51→
{ }

Заказы со склада поставщика (FBS)

Сборка заказов FBS, грузоместа, поставки и отгрузочные документы.

Методы: 94→
{ }

Закупки

Закупки: товары, статусы, импорт и связанные документы.

Методы: 17→
{ }

Знания о товарах

Справочники для работы с товарами, штрихкодами и этикетками.

Методы: 33→
{ }

Импорт

Загрузка товаров, изображений и других данных из файлов и внешних сервисов.

Методы: 31→
{ }

Кабинет и интеграции

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

Методы: 74→
{ }

Калькулятор

Расчёт прибыли по цене товара и цены по заданным параметрам.

Методы: 2→
{ }

Кассовые чеки

Создание кассовых чеков для заказов и проверка их статуса.

Методы: 4→
{ }

Категории

Категории SelSup, их параметры и связи с категориями маркетплейсов.

Методы: 23→
{ }

Ключевые слова

Ключевые слова, группы слов и их связи с товарами.

Методы: 12→
{ }

Конкуренты

Связи товаров с карточками конкурентов и история их цен.

Методы: 12→
{ }

Контрагенты

Контрагенты, поставщики товаров и их внешние идентификаторы.

Методы: 17→
{ }

Маркировка Честный знак

Коды маркировки: получение, проверка и складские операции.

Методы: 53→
{ }

Медиа

Загрузка видео сборки заказа.

Методы: 1→
{ }

Метки товаров

Создание и поиск меток, привязка меток к товарам и моделям.

Методы: 9→
{ }

Модели

Получение, создание и редактирование карточки с цветами, размерами и параметрами.

Методы: 14→
{ }

Настройки

Получение и изменение настроек SelSup.

Методы: 3→
{ }

Остатки (WMS)

Получение и изменение остатков, размещение товаров по ячейкам и работа с резервами.

Методы: 53→
{ }

Параметры

Поиск параметров и создание собственных параметров товаров.

Методы: 5→
{ }

Позиции товаров

Поиск и создание позиций товаров.

Методы: 3→
{ }

Покупатели

Покупатели и управление чёрным списком.

Методы: 5→
{ }

Поставки

Поставки: состав, статусы, документы и планирование.

Методы: 67→
{ }

Приёмки на склад

Приёмки на склад: товары, грузоместа, статусы и расхождения.

Методы: 19→
{ }

Производители

Создание, поиск и изменение производителей товаров.

Методы: 5→
{ }

Работы

Справочник работ, логистические точки и импорт каталога работ.

Методы: 10→
{ }

Реклама

Рекламные кампании: товары, ставки, статусы и статистика.

Методы: 16→
{ }

Репрайсер

Стратегии репрайсера, настройки товаров и обмен ценами.

Методы: 15→
{ }

Сервис МойСклад

Обмен заказами, перемещениями и другими документами с МойСклад.

Методы: 12→
{ }

Сертификаты качества

Сертификаты качества: загрузка, поиск и проверка в государственном реестре.

Методы: 11→
{ }

Склад

Склады, проходы, стеллажи, полки, ячейки и связи со складами маркетплейсов.

Методы: 41→
{ }

Тестирование гипотез

Создание и изменение гипотез для проверки изменений в работе с товарами.

Методы: 5→
{ }

Товары

Поиск и изменение товаров, изображений и связей с маркетплейсами.

Методы: 53→
{ }

Упаковка

Короба, упаковка товаров и размещение заказов по коробам.

Методы: 14→
{ }

Финансы

Платежи, счета, статьи расходов и расписания платежей.

Методы: 26→
{ }

ФинДир

Финансовые отчёты и рекомендации сервиса «ФинДир».

Методы: 5→
{ }

Фотосессии

Фотосессии товаров и загрузка полученных фотографий.

Методы: 12→
{ }

Цены

Цены товаров, типы цен, импорт и история изменений.

Методы: 18→
{ }

Экспорт

Выгрузка товаров, остатков, заказов и документов в файлы.

Методы: 40→

Руководства

Решения типовых задач

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

→

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

Как получить токен, выполнить первый запрос, загрузить список по страницам и обработать ошибки API.

Разделы: 4
→

Каталог и карточки товаров

Поиск товаров, получение полной карточки, создание и редактирование модели, работа с брендами, категориями и параметрами.

Разделы: 4
→

Обмен заказами

Создание заказа интернет-магазина, защита от дубликатов, постраничная выгрузка и получение изменившихся заказов.

Разделы: 4
→

Остатки и склады

Как устроен учёт остатков в SelSup, как получить остатки склада и изменить их по SKU, артикулу или штрихкоду.

Разделы: 5
→

Как получать уведомления через вебхуки

Как подписаться на изменения в SelSup, принять уведомление на своём сервере и проверить его подпись.

Разделы: 6
→

Как разработать модуль для SelSup

Пошаговое руководство по созданию своей панели в SelSup — от HTML-страницы и настройки доступа до получения данных и вызова методов через JavaScript.

Разделы: 15

Как пользоваться документацией

  • Начните с руководства по своей задаче — в нём объяснён порядок действий.
  • В справочнике метода проверьте обязательные параметры и формат ответа.
  • Скопируйте пример запроса на удобном языке и подставьте свои тестовые данные.
  • Кнопка «Попробовать» отправляет настоящий запрос с вашим токеном. Проверьте данные перед выполнением.