SelSup Developers

Публичный API · API Reference

Реклама

Методы раздела «Реклама»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

10 методов/api/campaignСтабильныйМашинное описание ↗
{ }

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

/api/campaign

Готовые сценарии

Готовые сценарии

01

Начать работу с разделом «Реклама»

Используйте отдельный API-токен и сначала проверяйте операции чтения на тестовых данных.

  1. Сохраните токен на серверной стороне и передавайте его в заголовке Authorization.
  2. Проверьте обязательные параметры и раскройте структуру запроса или ответа.
  3. Обрабатывайте HTTP-статус и стабильное поле error в прикладных ошибках.

Модель данных

Структуры данных раздела

Модели перечислены отдельно и раскрываются также непосредственно у методов, где они используются.

CampaignFilter17 полей
limitinteger · int32

Ограничение на количество записей. Максимальное значение - 500

pageinteger · int32

Номер страницы начиная с 1

countboolean

Возвратить в ответе общее количество записей

sortBystring

Поле для сортировки

ascendingboolean

Порядок сортировки - по возрастанию?. Работает только при получении списка.

statusstring

Поле status.

campaignStatusstring

Поле campaignStatus.

typeinteger · int32

Поле type.

offsetinteger · int32

Поле offset.

servicestring

Сервис

dateTostring · date-time

Поле dateTo.

dateFromstring · date-time

Поле dateFrom.

isStatCampaignboolean

Поле isStatCampaign.

dateStartstring · date-time

Поле dateStart.

querystring

Поисковый запрос. Может содержать external_id или часть названия медиакампании

productExternalIdinteger · int64

Внешний ID товара

organizationIdsinteger[]

Идентификаторы организаций для отчёта и выгрузки. Если список не пуст, он имеет приоритет над organizationId. Используется только для чтения статистики, но не для управления кампаниями

CampaignStatExportRequest4 полей
servicestring

Сервис

organizationIdinteger · int64

Поле organizationId.

organizationIdsinteger[]

Поле organizationIds.

filterCampaignFilter

Поле filter.

TmsTask25 полей
idinteger · int64

Идентификатор задачи

read-only
statusstring

Текущий статус задачи

read-only
typestring

Тип задачи

read-only
namestring

Данные задачи в json - могут быть пустыми

clientIdinteger · int64

Поле clientId.

entityIdinteger · int64

Сущность, к которой относится задача

progressinteger · int32

Прогресс выполнения задачи в процентах

processedQuantityinteger · int32

Количество обработанных записей задачи

organizationIdinteger · int64

Организация задачи, может быть 0, если не зависит от организации

priorityinteger · int32

Приоритет задачи - чем выше тем быстрее задача запустится

propertiesstring

Параметры задачи

messagestring

Сообщение с результатом выполнения задачи

messageParamsstring

Параметры сообщения с результатом выполнения задачи

createdDatestring · date-time

Дата добавления задачи в очередь

startDatestring · date-time

Дата запуска задачи

finishDatestring · date-time

Дата завершения задачи

urlstring

Ссылка на скачивание файла с результатом задачи

inputFileUrlstring

Ссылка на загруженный файл

retryNumberinteger · int32

Счётчик перезапуска задачи.

userIdinteger · int32

Пользователь запустивший задачу

retryDatestring · date-time

Запланированная дата перезапуска

debugboolean

Запуск задачи в режиме отладки с большим логированием

forcedStartboolean

Ручной запуск задачи

servicestring

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

langstring

Язык на котором сейчас запущена таска

Campaign22 полей
idinteger · int64

Поле id.

externalIdinteger · int64

Поле externalId.

namestring

Поле name.

campaignNamestring

Поле campaignName.

typestring

Поле type.

statusTypestring

Поле statusType.

productIdinteger · int64

Поле productId.

externalProductIdinteger · int64

Поле externalProductId.

createDatestring · date-time

Поле createDate.

endDatestring · date-time

Поле endDate.

startDatestring · date-time

Поле startDate.

suminteger · int64

Поле sum.

writeOffTypestring

Поле writeOffType.

onPauseboolean

Поле onPause.

clientIdinteger · int64

Поле clientId.

servicestring

Сервис

categoryIdinteger · int64

Поле categoryId.

categoryNamestring

Поле categoryName.

campaignTypestring

Поле campaignType.

dateStatImportstring · date-time

Поле dateStatImport.

nmsstring

Поле nms.

paymentTypestring

Поле paymentType.

WildberriesType32 полей
idinteger · int64

Поле id.

namestring

Название

publishedboolean

Опубликованность предмета Вайлдбериз

hasSizeboolean

Атрибут, указывающий наличие размера

monoBoxMinQuantityinteger · int32

Поле monoBoxMinQuantity.

monoTypestring

Поле monoType.

monoMinPriceinteger · int32

Поле monoMinPrice.

hasParentboolean

Поле hasParent.

parentIdinteger · int64

Поле parentId.

wildberriesIdinteger · int64

Идентификатор предмета на Вайлдбериз

lastSyncDatestring · date-time

Дата последней синхронизации предмета с Вайлдбериз

notChangedDaysinteger · int32

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

commissionnumber · double

Комиссия для товаров данного предмета в Вайлдбериз по FBM

fbsCommissionnumber · double

Комиссия для товаров данного предмета в Вайлдбериз по FBS

fbwCommissionnumber · double

Комиссия по тарифу FBW

dbsCommissionnumber · double

Комиссия по тарифу DBS

edbsCommissionnumber · double

Комиссия по тарифу EDBS

cAndCCommissionnumber · double

Комиссия по тарифу C&C

bookingCommissionnumber · double

Комиссия за бронирование

logisticPriceinteger · int32

Стоимость доставки товара к клиенту на Вайлдбериз

storagePricenumber · double

Стоимость хранения товара на складе Вайлдбериз за штуку в день

acceptancePricenumber · double

Стоимость приемки товара на складе Вайлдбериз за штуку

needDimensionsboolean

Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов

purchasePercentAvgnumber · double

Среднее значение процента выкупа. Используется в AI Финдире

purchasePercentMinnumber · double

Минимально допустимое значение процента выкупа. Используется в AI Финдире

photoAvginteger · int32

Среднее кол-во фотографий. Используется в AI Финдире

photoMininteger · int32

Минимально допустимое кол-во фотографий. Используется в AI Финдире

drrAvgnumber · double

Среднее значение ДРР. Используется в AI Финдире

drrMinnumber · double

Минимально допустимое значение ДПП. Используется в AI Финдире

marginAvgnumber · double

Среднее значение маржинальности. Используется в AI Финдире

marginMinnumber · double

Минимально допустимое значение маржинальности. Используется в AI Финдире

candCCommissionnumber · double

Поле candCCommission.

CampaignStat4 полей
campaignstring

Поле campaign.

valuenumber · double

Поле value.

organizationIdinteger · int64

Поле organizationId.

organizationNamestring

Поле organizationName.

CampaignTotalStats4 полей
clicksCampaignStat[]

Поле clicks.

viewsCampaignStat[]

Поле views.

expensesCampaignStat[]

Поле expenses.

averageCostCampaignStat[]

Поле averageCost.

FindResponseStatCampaign1 полей
rowsStatCampaign[]

Строки с результатом поиска

StatCampaign46 полей
limitinteger · int32

Ограничение на количество записей. Максимальное значение - 500

pageinteger · int32

Номер страницы начиная с 1

countboolean

Возвратить в ответе общее количество записей

sortBystring

Поле сортировки записей. Работает только при получении списка.

ascendingboolean

Порядок сортировки - по возрастанию?. Работает только при получении списка.

statCampaignIdinteger · int64

ID в базе

viewsinteger · int32

Количество просмотров.

clicksinteger · int32

Количество кликов

ratioClicksViewsnumber · double

Отношение числа кликов к количеству показов. Выражается в процентах

averageCostnumber · double

Средняя стоимость клика, ₽

expensesnumber · double

Затраты, ₽

quantityAddCartinteger · int32

Количество добавлений товаров в корзину

quantityOrdersinteger · int32

Количество заказов

ratioOrdersOfVisitsnumber · double

Отношение количества заказов к общему количеству посещений кампании

quantityProductOrdersinteger · int32

Количество заказанных товаров, шт.

ordersAmountnumber · double

Заказов на сумму, ₽

campaignIdinteger · int64

ID кампании

campaignNamestring

Название кампании к которой относится статистика

createDatestring · date-time

Дата создния рекламной кампании к которой относится статистика

servicestring

Сервис

campaignTypestring

Поле campaignType.

categoryNamestring

Поле categoryName.

externalIdinteger · int64

Поле externalId.

productIdinteger · int64

Идентификатор размера

productViewIdinteger · int64

Идентификатор цвета

datestring · date-time

Дата к которой относится статистика

startDatestring · date-time

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

endDatestring · date-time

Конец интервала к которому относится статистика. Проставляется при импорте если статистика по дням недоступна

importDatestring · date-time

Дата импорта

uniqueIdstring

Поле uniqueId.

clientIdinteger · int64

Поле clientId.

organizationIdinteger · int64

Идентификатор организации, которой принадлежит строка

organizationNamestring

Название организации, которой принадлежит строка

rowTypestring

Тип строки статистики

quantityBuyoutsnumber · double

Количество фактических выкупов, атрибутированных кампании

revenuenumber · double

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

profitFactnumber · double

Фактическая прибыль после рекламных расходов

marginFactnumber · double

Фактическая маржа, %

drrnumber · double

Доля рекламных расходов в фактической выручке, %

cpsnumber · double

Стоимость одного фактического выкупа

quantityBuyoutsForecastnumber · double

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

profitForecastnumber · double

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

marginForecastnumber · double

Прогнозная маржа, %

allowableExpensesnumber · double

Допустимый рекламный расход до точки безубыточности

currencystring

Валюта финансовых показателей

unavailableReasonsobject

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

FindResponseCampaign1 полей
rowsCampaign[]

Строки с результатом поиска

WbBalance3 полей
balanceinteger · int32

Поле balance.

netinteger · int32

Поле net.

bonusinteger · int32

Поле bonus.

Контракт ошибок

Как API возвращает прикладные ошибки

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

error

Стабильный машинный код ошибки для логики интеграции.

localMessage

Готовое сообщение на языке пользователя API-токена.

params

Значения

Язык localMessage определяется полем lang пользователя, которому принадлежит API-токен. Язык страницы документации и заголовок Accept-Language его не переключают; если язык пользователя не указан, используется русский.

RUПользователь с локалью ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENПользователь с локалью en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Методы

Методы

POST

Изменение статуса рекламной компании

/api/campaign/updateStatusCampaign
Токен с правами записи

Останавливает, запускает или ставит на паузу компанию по маркетплейсу

Параметры запроса

ПолеТипОбязательноОписание
campaignId integer · int64 Да Поле campaignId.
status stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Да Поле status.
organizationId integer · int64 Да Поле organizationId.
curl --request POST 'https://api.selsup.ru/api/campaign/updateStatusCampaign?campaignId=1001&status=DELETED&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200

Тело ответа пустое.

Ошибки9

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

400error_prepared_integration_not_found
подготовленная интеграция не найдена

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_prepared_integration_not_found; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

400error_token_expired_or_revoked
Токен API отозван или введен некорректно. Проверьте, что ключ API имеет полный функционал. Сгенерируйте новый ключ и замените в SELSUP, так как ключи имеют срок жизни.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_token_expired_or_revoked; localMessage содержит приведённый выше перевод.

400error_wildberries_api
{message}

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wildberries_api; localMessage содержит приведённый выше перевод.

POST

Выгрузка статистики рекламных кампаний в Excel

/api/campaign/stats/xlsx
Токен с правами записи

Запускает формирование Excel-файла по текущим фильтрам статистики

Тело запроса

application/json
Поля объектаCampaignStatExportRequest
ПолеТипОбязательноОписание
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис
organizationId integer · int64 Нет Поле organizationId.
organizationIds integer[] Нет Поле organizationIds.
filter CampaignFilter Нет Поле filter.
Поля объекта CampaignFilter
ПолеТипОбязательноОписание
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
status string Нет Поле status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Нет Поле campaignStatus.
type integer · int32 Нет Поле type.
offset integer · int32 Нет Поле offset.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис
dateTo string · date-time Нет Поле dateTo.
dateFrom string · date-time Нет Поле dateFrom.
isStatCampaign boolean Нет Поле isStatCampaign.
dateStart string · date-time Нет Поле dateStart.
query string Нет Поисковый запрос. Может содержать external_id или часть названия медиакампании
productExternalId integer · int64 Нет Внешний ID товара
organizationIds integer[] Нет Идентификаторы организаций для отчёта и выгрузки. Если список не пуст, он имеет приоритет над organizationId. Используется только для чтения статистики, но не для управления кампаниями
curl --request POST 'https://api.selsup.ru/api/campaign/stats/xlsx' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "organizationId": 1001,
  "organizationIds": "string",
  "filter": "string"
}'

Успешный ответ

200
Поля объекта TmsTask
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор задачи
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Нет Текущий статус задачи
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Нет Тип задачи
name string Нет Данные задачи в json - могут быть пустыми
clientId integer · int64 Нет Поле clientId.
entityId integer · int64 Нет Сущность, к которой относится задача
progress integer · int32 Нет Прогресс выполнения задачи в процентах
processedQuantity integer · int32 Нет Количество обработанных записей задачи
organizationId integer · int64 Нет Организация задачи, может быть 0, если не зависит от организации
priority integer · int32 Нет Приоритет задачи - чем выше тем быстрее задача запустится
properties string Нет Параметры задачи
message string Нет Сообщение с результатом выполнения задачи
messageParams string Нет Параметры сообщения с результатом выполнения задачи
createdDate string · date-time Нет Дата добавления задачи в очередь
startDate string · date-time Нет Дата запуска задачи
finishDate string · date-time Нет Дата завершения задачи
url string Нет Ссылка на скачивание файла с результатом задачи
inputFileUrl string Нет Ссылка на загруженный файл
retryNumber integer · int32 Нет Счётчик перезапуска задачи.
userId integer · int32 Нет Пользователь запустивший задачу
retryDate string · date-time Нет Запланированная дата перезапуска
debug boolean Нет Запуск задачи в режиме отладки с большим логированием
forcedStart boolean Нет Ручной запуск задачи
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки9

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

400error_no_marketplace
Не указан маркетплейс

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_marketplace; localMessage содержит приведённый выше перевод.

400error_no_organization
Не указана организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_organization; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

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

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_unsupported_service; localMessage содержит приведённый выше перевод.

400error_user_does_not_have_this_organization
У пользователя нет доступа к данной организации

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_user_does_not_have_this_organization; localMessage содержит приведённый выше перевод.

POST

Создание рекламной компании

/api/campaign/createCampaign
Токен с правами записи

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

Параметры запроса

ПолеТипОбязательноОписание
organizationId integer · int64 Да Поле organizationId.

Тело запроса

application/json
Поля объектаCampaign
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
externalId integer · int64 Нет Поле externalId.
name string Нет Поле name.
campaignName string Нет Поле campaignName.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Нет Поле type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Нет Поле statusType.
productId integer · int64 Нет Поле productId.
externalProductId integer · int64 Нет Поле externalProductId.
createDate string · date-time Нет Поле createDate.
endDate string · date-time Нет Поле endDate.
startDate string · date-time Нет Поле startDate.
sum integer · int64 Нет Поле sum.
writeOffType stringBALANCE, NET, BONUS Нет Поле writeOffType.
onPause boolean Нет Поле onPause.
clientId integer · int64 Нет Поле clientId.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис
categoryId integer · int64 Нет Поле categoryId.
categoryName string Нет Поле categoryName.
campaignType string Нет Поле campaignType.
dateStatImport string · date-time Нет Поле dateStatImport.
nms string Нет Поле nms.
paymentType string Нет Поле paymentType.
curl --request POST 'https://api.selsup.ru/api/campaign/createCampaign?organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}'

Успешный ответ

200
Поля объекта Campaign
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
externalId integer · int64 Нет Поле externalId.
name string Нет Поле name.
campaignName string Нет Поле campaignName.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Нет Поле type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Нет Поле statusType.
productId integer · int64 Нет Поле productId.
externalProductId integer · int64 Нет Поле externalProductId.
createDate string · date-time Нет Поле createDate.
endDate string · date-time Нет Поле endDate.
startDate string · date-time Нет Поле startDate.
sum integer · int64 Нет Поле sum.
writeOffType stringBALANCE, NET, BONUS Нет Поле writeOffType.
onPause boolean Нет Поле onPause.
clientId integer · int64 Нет Поле clientId.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис
categoryId integer · int64 Нет Поле categoryId.
categoryName string Нет Поле categoryName.
campaignType string Нет Поле campaignType.
dateStatImport string · date-time Нет Поле dateStatImport.
nms string Нет Поле nms.
paymentType string Нет Поле paymentType.
{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}
Ошибки10

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

400error_prepared_integration_not_found
подготовленная интеграция не найдена

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_prepared_integration_not_found; localMessage содержит приведённый выше перевод.

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

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_service_not_supported; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

400error_token_expired_or_revoked
Токен API отозван или введен некорректно. Проверьте, что ключ API имеет полный функционал. Сгенерируйте новый ключ и замените в SELSUP, так как ключи имеют срок жизни.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_token_expired_or_revoked; localMessage содержит приведённый выше перевод.

400error_wildberries_api
{message}

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_wildberries_api; localMessage содержит приведённый выше перевод.

GET

Запуск задачи по обновлению/прогрузки рекламных кампаний

/api/campaign/updateCampaigns
Токен с правами чтения

Возвращает задачу на старт

Параметры запроса

ПолеТипОбязательноОписание
organizationId integer · int64 Да Поле organizationId.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Да Сервис
curl --request GET 'https://api.selsup.ru/api/campaign/updateCampaigns?organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта TmsTask
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор задачи
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Нет Текущий статус задачи
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Нет Тип задачи
name string Нет Данные задачи в json - могут быть пустыми
clientId integer · int64 Нет Поле clientId.
entityId integer · int64 Нет Сущность, к которой относится задача
progress integer · int32 Нет Прогресс выполнения задачи в процентах
processedQuantity integer · int32 Нет Количество обработанных записей задачи
organizationId integer · int64 Нет Организация задачи, может быть 0, если не зависит от организации
priority integer · int32 Нет Приоритет задачи - чем выше тем быстрее задача запустится
properties string Нет Параметры задачи
message string Нет Сообщение с результатом выполнения задачи
messageParams string Нет Параметры сообщения с результатом выполнения задачи
createdDate string · date-time Нет Дата добавления задачи в очередь
startDate string · date-time Нет Дата запуска задачи
finishDate string · date-time Нет Дата завершения задачи
url string Нет Ссылка на скачивание файла с результатом задачи
inputFileUrl string Нет Ссылка на загруженный файл
retryNumber integer · int32 Нет Счётчик перезапуска задачи.
userId integer · int32 Нет Пользователь запустивший задачу
retryDate string · date-time Нет Запланированная дата перезапуска
debug boolean Нет Запуск задачи в режиме отладки с большим логированием
forcedStart boolean Нет Ручной запуск задачи
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

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

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_unsupported_service; localMessage содержит приведённый выше перевод.

GET

Перезапуск обновления статистики рекламных кампаний

/api/campaign/reloadCampaignStats
Токен с правами чтения

Запускает обновление статистики для выбранной организации

Параметры запроса

ПолеТипОбязательноОписание
dateFrom string · date Да Поле dateFrom.
dateTo string · date Да Поле dateTo.
organizationId integer · int64 Да Поле organizationId.
isExpensesOnly boolean Нет Поле isExpensesOnly.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Да Сервис
curl --request GET 'https://api.selsup.ru/api/campaign/reloadCampaignStats?dateFrom=2026-01-15&dateTo=2026-01-15&organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200

Тело ответа пустое.

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

GET

Получение информации о кампании с API маркетплейса

/api/campaign/getWildberriesSubjects
Токен с правами чтения

Возвращает кампанию по внешнему идентификатору

Параметры запроса

ПолеТипОбязательноОписание
query string Да Поле query.
limit integer · int32 Да Поле limit.
organizationId integer · int64 Да Поле organizationId.
curl --request GET 'https://api.selsup.ru/api/campaign/getWildberriesSubjects?query=string&limit=50&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Структура элемента массива WildberriesType[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Название
published boolean Нет Опубликованность предмета Вайлдбериз
hasSize boolean Нет Атрибут, указывающий наличие размера
monoBoxMinQuantity integer · int32 Нет Поле monoBoxMinQuantity.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Нет Поле monoType.
monoMinPrice integer · int32 Нет Поле monoMinPrice.
hasParent boolean Нет Поле hasParent.
parentId integer · int64 Нет Поле parentId.
wildberriesId integer · int64 Нет Идентификатор предмета на Вайлдбериз
lastSyncDate string · date-time Нет Дата последней синхронизации предмета с Вайлдбериз
notChangedDays integer · int32 Нет Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются
commission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBM
fbsCommission number · double Нет Комиссия для товаров данного предмета в Вайлдбериз по FBS
fbwCommission number · double Нет Комиссия по тарифу FBW
dbsCommission number · double Нет Комиссия по тарифу DBS
edbsCommission number · double Нет Комиссия по тарифу EDBS
cAndCCommission number · double Нет Комиссия по тарифу C&C
bookingCommission number · double Нет Комиссия за бронирование
logisticPrice integer · int32 Нет Стоимость доставки товара к клиенту на Вайлдбериз
storagePrice number · double Нет Стоимость хранения товара на складе Вайлдбериз за штуку в день
acceptancePrice number · double Нет Стоимость приемки товара на складе Вайлдбериз за штуку
needDimensions boolean Нет Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов
purchasePercentAvg number · double Нет Среднее значение процента выкупа. Используется в AI Финдире
purchasePercentMin number · double Нет Минимально допустимое значение процента выкупа. Используется в AI Финдире
photoAvg integer · int32 Нет Среднее кол-во фотографий. Используется в AI Финдире
photoMin integer · int32 Нет Минимально допустимое кол-во фотографий. Используется в AI Финдире
drrAvg number · double Нет Среднее значение ДРР. Используется в AI Финдире
drrMin number · double Нет Минимально допустимое значение ДПП. Используется в AI Финдире
marginAvg number · double Нет Среднее значение маржинальности. Используется в AI Финдире
marginMin number · double Нет Минимально допустимое значение маржинальности. Используется в AI Финдире
candCCommission number · double Нет Поле candCCommission.
[
  "string"
]
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

400error_prepared_integration_not_found
подготовленная интеграция не найдена

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_prepared_integration_not_found; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

400error_token_expired_or_revoked
Токен API отозван или введен некорректно. Проверьте, что ключ API имеет полный функционал. Сгенерируйте новый ключ и замените в SELSUP, так как ключи имеют срок жизни.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_token_expired_or_revoked; localMessage содержит приведённый выше перевод.

GET

Суммарная статистику по рекламным кампаниям

/api/campaign/getTotalStatCampaigns
Токен с правами чтения

Возвращает суммарную статистику по маркетплейсам

Параметры запроса

ПолеТипОбязательноОписание
organizationId integer · int64 Нет Поле organizationId.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Да Сервис
status string Нет Поле status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Нет Поле campaignStatus.
type integer · int32 Нет Поле type.
offset integer · int32 Нет Поле offset.
dateTo string · date-time Нет Поле dateTo.
dateFrom string · date-time Нет Поле dateFrom.
isStatCampaign boolean Нет Поле isStatCampaign.
dateStart string · date-time Нет Поле dateStart.
query string Нет Поисковый запрос. Может содержать external_id или часть названия медиакампании
productExternalId integer · int64 Нет Внешний ID товара
organizationIds integer[] Нет Идентификаторы организаций для отчёта и выгрузки. Если список не пуст, он имеет приоритет над organizationId. Используется только для чтения статистики, но не для управления кампаниями
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
topN integer · int32 Да Поле topN.
curl --request GET 'https://api.selsup.ru/api/campaign/getTotalStatCampaigns?service=NONE&limit=50&page=1&topN=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта CampaignTotalStats
ПолеТипОбязательноОписание
clicks CampaignStat[] Нет Поле clicks.
Структура элемента массива CampaignStat
ПолеТипОбязательноОписание
campaign string Нет Поле campaign.
value number · double Нет Поле value.
organizationId integer · int64 Нет Поле organizationId.
organizationName string Нет Поле organizationName.
views CampaignStat[] Нет Поле views.
Структура элемента массива CampaignStat
ПолеТипОбязательноОписание
campaign string Нет Поле campaign.
value number · double Нет Поле value.
organizationId integer · int64 Нет Поле organizationId.
organizationName string Нет Поле organizationName.
expenses CampaignStat[] Нет Поле expenses.
Структура элемента массива CampaignStat
ПолеТипОбязательноОписание
campaign string Нет Поле campaign.
value number · double Нет Поле value.
organizationId integer · int64 Нет Поле organizationId.
organizationName string Нет Поле organizationName.
averageCost CampaignStat[] Нет Поле averageCost.
Структура элемента массива CampaignStat
ПолеТипОбязательноОписание
campaign string Нет Поле campaign.
value number · double Нет Поле value.
organizationId integer · int64 Нет Поле organizationId.
organizationName string Нет Поле organizationName.
{
  "clicks": "string",
  "views": "string",
  "expenses": "string",
  "averageCost": "string"
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

GET

Статистику по рекламным кампаниям

/api/campaign/getStatCampaigns
Токен с правами чтения

Возвращает статистику по маркетплейсам

Параметры запроса

ПолеТипОбязательноОписание
organizationId integer · int64 Нет Поле organizationId.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Да Сервис
status string Нет Поле status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Нет Поле campaignStatus.
type integer · int32 Нет Поле type.
offset integer · int32 Нет Поле offset.
dateTo string · date-time Нет Поле dateTo.
dateFrom string · date-time Нет Поле dateFrom.
isStatCampaign boolean Нет Поле isStatCampaign.
dateStart string · date-time Нет Поле dateStart.
query string Нет Поисковый запрос. Может содержать external_id или часть названия медиакампании
productExternalId integer · int64 Нет Внешний ID товара
organizationIds integer[] Нет Идентификаторы организаций для отчёта и выгрузки. Если список не пуст, он имеет приоритет над organizationId. Используется только для чтения статистики, но не для управления кампаниями
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/campaign/getStatCampaigns?service=NONE&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта FindResponseStatCampaign
ПолеТипОбязательноОписание
rows StatCampaign[] Нет Строки с результатом поиска
Структура элемента массива StatCampaign
ПолеТипОбязательноОписание
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
statCampaignId integer · int64 Нет ID в базе
views integer · int32 Нет Количество просмотров.
clicks integer · int32 Нет Количество кликов
ratioClicksViews number · double Нет Отношение числа кликов к количеству показов. Выражается в процентах
averageCost number · double Нет Средняя стоимость клика, ₽
expenses number · double Нет Затраты, ₽
quantityAddCart integer · int32 Нет Количество добавлений товаров в корзину
quantityOrders integer · int32 Нет Количество заказов
ratioOrdersOfVisits number · double Нет Отношение количества заказов к общему количеству посещений кампании
quantityProductOrders integer · int32 Нет Количество заказанных товаров, шт.
ordersAmount number · double Нет Заказов на сумму, ₽
campaignId integer · int64 Нет ID кампании
campaignName string Нет Название кампании к которой относится статистика
createDate string · date-time Нет Дата создния рекламной кампании к которой относится статистика
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис
campaignType stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Нет Поле campaignType.
categoryName string Нет Поле categoryName.
externalId integer · int64 Нет Поле externalId.
productId integer · int64 Нет Идентификатор размера
productViewId integer · int64 Нет Идентификатор цвета
date string · date-time Нет Дата к которой относится статистика
startDate string · date-time Нет Начало интервала к которому относится статистика Проставляется при импорте если статистика по дням недоступна
endDate string · date-time Нет Конец интервала к которому относится статистика. Проставляется при импорте если статистика по дням недоступна
importDate string · date-time Нет Дата импорта
uniqueId string Нет Поле uniqueId.
clientId integer · int64 Нет Поле clientId.
organizationId integer · int64 Нет Идентификатор организации, которой принадлежит строка
organizationName string Нет Название организации, которой принадлежит строка
rowType stringCAMPAIGN, UNALLOCATED Нет Тип строки статистики
quantityBuyouts number · double Нет Количество фактических выкупов, атрибутированных кампании
revenue number · double Нет Фактическая выручка выкупленных заказов
profitFact number · double Нет Фактическая прибыль после рекламных расходов
marginFact number · double Нет Фактическая маржа, %
drr number · double Нет Доля рекламных расходов в фактической выручке, %
cps number · double Нет Стоимость одного фактического выкупа
quantityBuyoutsForecast number · double Нет Прогноз количества выкупов
profitForecast number · double Нет Прогноз прибыли после рекламных расходов
marginForecast number · double Нет Прогнозная маржа, %
allowableExpenses number · double Нет Допустимый рекламный расход до точки безубыточности
currency string Нет Валюта финансовых показателей
unavailableReasons object Нет Причины отсутствия финансовых показателей
{
  "rows": "string"
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

GET

Получение информации о заказе

/api/campaign/getCampaigns
Токен с правами чтения

Возвращает заказ по идентификатору

Параметры запроса

ПолеТипОбязательноОписание
organizationId integer · int64 Да Поле organizationId.
status string Нет Поле status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Нет Поле campaignStatus.
type integer · int32 Нет Поле type.
offset integer · int32 Нет Поле offset.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис
dateTo string · date-time Нет Поле dateTo.
dateFrom string · date-time Нет Поле dateFrom.
isStatCampaign boolean Нет Поле isStatCampaign.
dateStart string · date-time Нет Поле dateStart.
query string Нет Поисковый запрос. Может содержать external_id или часть названия медиакампании
productExternalId integer · int64 Нет Внешний ID товара
organizationIds integer[] Нет Идентификаторы организаций для отчёта и выгрузки. Если список не пуст, он имеет приоритет над organizationId. Используется только для чтения статистики, но не для управления кампаниями
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaigns?organizationId=1001&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта FindResponseCampaign
ПолеТипОбязательноОписание
rows Campaign[] Нет Строки с результатом поиска
Структура элемента массива Campaign
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
externalId integer · int64 Нет Поле externalId.
name string Нет Поле name.
campaignName string Нет Поле campaignName.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Нет Поле type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Нет Поле statusType.
productId integer · int64 Нет Поле productId.
externalProductId integer · int64 Нет Поле externalProductId.
createDate string · date-time Нет Поле createDate.
endDate string · date-time Нет Поле endDate.
startDate string · date-time Нет Поле startDate.
sum integer · int64 Нет Поле sum.
writeOffType stringBALANCE, NET, BONUS Нет Поле writeOffType.
onPause boolean Нет Поле onPause.
clientId integer · int64 Нет Поле clientId.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис
categoryId integer · int64 Нет Поле categoryId.
categoryName string Нет Поле categoryName.
campaignType string Нет Поле campaignType.
dateStatImport string · date-time Нет Поле dateStatImport.
nms string Нет Поле nms.
paymentType string Нет Поле paymentType.
{
  "rows": "string"
}
Ошибки4

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Получение баланса по маркетплейсу

/api/campaign/getCampaignBalance
Токен с правами чтения

Отдает баланс на аккаунте для рекламных кампаний

Параметры запроса

ПолеТипОбязательноОписание
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Да Сервис
organizationId integer · int64 Да Поле organizationId.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaignBalance?service=NONE&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта WbBalance
ПолеТипОбязательноОписание
balance integer · int32 Нет Поле balance.
net integer · int32 Нет Поле net.
bonus integer · int32 Нет Поле bonus.
{
  "balance": 1,
  "net": 1,
  "bonus": 1
}
Ошибки7

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

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

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

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

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_service_not_supported; localMessage содержит приведённый выше перевод.

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_subscription_expired; localMessage содержит приведённый выше перевод.

400error_token_expired_or_revoked
Токен API отозван или введен некорректно. Проверьте, что ключ API имеет полный функционал. Сгенерируйте новый ключ и замените в SELSUP, так как ключи имеют срок жизни.

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_token_expired_or_revoked; localMessage содержит приведённый выше перевод.

Authorization

Токен для тестовых запросов

Токен хранится только в localStorage этого браузера и отправляется исключительно в заголовке Authorization запросов к api.selsup.ru.

Попробовать

Параметры реального запроса

Реальный ответ API

Выполните запрос, чтобы увидеть ответ SelSup.