Получите токен
Откройте настройки API, введите название подключения и нажмите «Добавить токен». Скопируйте полученный токен.
API для интеграторов
Подключайте внешние системы через API, получайте уведомления об изменениях и добавляйте собственные панели в кабинет SelSup. Здесь вы найдёте инструкции, параметры методов и примеры запросов.
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
}
Быстрый старт
Получите токен в кабинете SelSup и выполните запрос на чтение данных, например запрос списка брендов.
Откройте настройки API, введите название подключения и нажмите «Добавить токен». Скопируйте полученный токен.
Укажите токен в заголовке Authorization без префикса Bearer.
Поле error содержит код ошибки, по которому программа может выбрать действие. В localMessage приходит сообщение для пользователя.
Authorization
Отправляйте запросы на https://api.selsup.ru и передавайте токен в заголовке Authorization. Для запросов с JSON указывайте Content-Type: application/json.
curl 'https://api.selsup.ru/api/brand/all' \
--header 'Authorization: YOUR_API_TOKEN'
Справочник API
Выберите раздел, чтобы посмотреть доступные методы, параметры запросов, поля ответа и возможные ошибки.
Акции маркетплейсов, товары в акциях и обновление их данных.
Получение отчётов, настройка планов продаж и загрузка данных для аналитики.
Операции биллинга за выбранный период.
Создавайте и находите бренды, связывайте их с Ozon и 1С, управляйте логотипами и безопасно объединяйте дубликаты.
Создание, просмотр и удаление подписок на уведомления об изменениях в SelSup.
Получение возвратов товаров, поиск и выгрузка в Excel.
Создание, изменение и объединение групповых карточек.
Документы для маркировки товаров, работы с Честным знаком и ЭДО.
Тарифы и пункты доставки, создание заказов в службах доставки и получение накладных.
Поиск фоновых задач и получение результатов их выполнения.
Создание и поиск заказов, изменение их состава и статусов.
Сборка заказов FBS, грузоместа, поставки и отгрузочные документы.
Закупки: товары, статусы, импорт и связанные документы.
Справочники для работы с товарами, штрихкодами и этикетками.
Загрузка товаров, изображений и других данных из файлов и внешних сервисов.
Настройки кабинета, организаций, сотрудников и подключённых сервисов.
Расчёт прибыли по цене товара и цены по заданным параметрам.
Создание кассовых чеков для заказов и проверка их статуса.
Категории SelSup, их параметры и связи с категориями маркетплейсов.
Ключевые слова, группы слов и их связи с товарами.
Связи товаров с карточками конкурентов и история их цен.
Контрагенты, поставщики товаров и их внешние идентификаторы.
Коды маркировки: получение, проверка и складские операции.
Загрузка видео сборки заказа.
Создание и поиск меток, привязка меток к товарам и моделям.
Получение, создание и редактирование карточки с цветами, размерами и параметрами.
Получение и изменение настроек SelSup.
Получение и изменение остатков, размещение товаров по ячейкам и работа с резервами.
Поиск параметров и создание собственных параметров товаров.
Поиск и создание позиций товаров.
Покупатели и управление чёрным списком.
Поставки: состав, статусы, документы и планирование.
Приёмки на склад: товары, грузоместа, статусы и расхождения.
Создание, поиск и изменение производителей товаров.
Справочник работ, логистические точки и импорт каталога работ.
Рекламные кампании: товары, ставки, статусы и статистика.
Стратегии репрайсера, настройки товаров и обмен ценами.
Обмен заказами, перемещениями и другими документами с МойСклад.
Сертификаты качества: загрузка, поиск и проверка в государственном реестре.
Склады, проходы, стеллажи, полки, ячейки и связи со складами маркетплейсов.
Создание и изменение гипотез для проверки изменений в работе с товарами.
Поиск и изменение товаров, изображений и связей с маркетплейсами.
Короба, упаковка товаров и размещение заказов по коробам.
Платежи, счета, статьи расходов и расписания платежей.
Финансовые отчёты и рекомендации сервиса «ФинДир».
Фотосессии товаров и загрузка полученных фотографий.
Цены товаров, типы цен, импорт и история изменений.
Выгрузка товаров, остатков, заказов и документов в файлы.
Руководства
Пошаговые инструкции: как загрузить товары, обмениваться заказами и остатками, принимать вебхуки и разработать свой модуль.
Как получить токен, выполнить первый запрос, загрузить список по страницам и обработать ошибки API.
Поиск товаров, получение полной карточки, создание и редактирование модели, работа с брендами, категориями и параметрами.
Создание заказа интернет-магазина, защита от дубликатов, постраничная выгрузка и получение изменившихся заказов.
Как устроен учёт остатков в SelSup, как получить остатки склада и изменить их по SKU, артикулу или штрихкоду.
Как подписаться на изменения в SelSup, принять уведомление на своём сервере и проверить его подпись.
Пошаговое руководство по созданию своей панели в SelSup — от HTML-страницы и настройки доступа до получения данных и вызова методов через JavaScript.