SelSup Developers

Грамадскае API · API Падпісанне

Павышэнне

Канчатковыя пункты для прамоў, уключаючы дакладныя маршруты, параметры, органы запыту і схемы рэакцыі, якія могуць быць пашыраны.

11 канчатковыя пункты/api/promotionСтабільныМашыначытна чытае апісанне ↗
{ }

Гэты старонка падтрымліваецца рэдагаваць самастойны кантракт.

/api/promotion

Готовыя да выкарыстання працоўныя патокі

Готовыя да выкарыстання працоўныя патокі

01

Пачніце выкарыстоўваць прамовы

Выкарыстоўвайце адмысловы токен API і пацвердзіце аперацыі чытання з дадзенымі тэсту спачатку.

  1. Захоўвайце знак з боку сервера і адправіце яго ў заголоўку Authorization.
  2. Праверце патрабаваныя параметры і пашырыць схему запыту або адказу.
  3. Выкарыстоўвайце стан HTTP і стабільнае поле error ў памылках прыкладання.

Мадэль дадзеных

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

Мадэлі пералічаныя тут адзін раз і могуць быць пашыраныя непасрэдна з канчатковых пунктаў, якія іх выкарыстоўваюць.

Promotion21 палёў
promotionIdinteger · int64

Падвышаная пазнака.

idinteger · int64

Id.

totalCountinteger · int64

Тотальны лічба.

namestring

Назва.

dateStartstring · date-time

Пачатак дата.

dateEndstring · date-time

Дата скончыцца.

changeCommissionboolean

Змяніце камісію.

changeCommissionAmountnumber · double

Змяніць суму камісіі.

createdDatestring · date-time

Стварыўся Дата.

servicestring

Паслуга.

isDeletedboolean

Знік.

descriptionstring

Апісанне.

promotionIdOnMpstring

Папулярнае значэнне на MP.

clientIdinteger · int64

Ідэнтыфікатар кліента.

organizationIdinteger · int64

Ід арганізацыі.

candidateCountinteger · int64

Кандыдат граф.

inPromotionCountinteger · int64

У падвышаным ліку.

autoboolean

Аўтамабіль.

hotsaleboolean

Готсале.

candidateCountOnMpinteger · int64

Кандыдат разлічвае на MP.

inPromotionCountOnMpinteger · int64

У прасоўванні лічыць на Mp.

TmsTask25 палёў
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

Назва.

clientIdinteger · int64

Ідэнтыфікатар кліента.

entityIdinteger · int64

Ід суб'екта.

progressinteger · int32

Прагрэс.

processedQuantityinteger · int32

Працаванае колькасць.

organizationIdinteger · int64

Ід арганізацыі.

priorityinteger · int32

Пераважнасць.

propertiesstring

Маёмасці.

messagestring

Паведамленне.

messageParamsstring

Паведамленне Params.

createdDatestring · date-time

Стварыўся Дата.

startDatestring · date-time

Пачатак дата.

finishDatestring · date-time

Дата заканчэння.

urlstring

Ураль.

inputFileUrlstring

Уклад файла URL.

retryNumberinteger · int32

Перапрабаваць нумар.

userIdinteger · int32

Пазнак карыстальніка.

retryDatestring · date-time

Перапрабаваць дату.

debugboolean

Адладкаванне.

forcedStartboolean

Насілле пачатак.

servicestring

Паслуга.

langstring

Lang.

ProductPromotion91 палёў
categoryNamestring

Назва катэгорыі.

brandNamestring

Назва брэнда.

subjectstring

Суб'ект.

purchasePricenumber · double

Купля Прэміі.

deliveryCostnumber · double

Кошт дастаўкі.

additionalCostnumber · double

Дадатковыя кошт.

barcodestring

Бар-код.

instockQuantityinteger · int64

У запасах колькасць.

wildberriesStockCountinteger · int64

Wildberries запасаў падлічыць.

yandexMarketStockCountinteger · int64

Яндэкс Рынок Акцыі падліку.

createdDatestring · date-time

Стварыўся Дата.

minPricenumber · double

Мін Прайс.

isDuplicateboolean

Гэта Дублікат.

ozonArticlestring

Азоны артыкул.

ozonStockCountinteger · int64

Азоны акцыі лічыць.

salesExpensesOnMpPercentnumber · double

Расходы на продажу на Mp працэнт.

taxeRatenumber · double

Падатковыя стаўкі.

widthinteger · int32

Шырыня.

heightinteger · int32

Вышыня.

depthinteger · int32

Глыбіня.

ozonPurchasePercentnumber · double

Азоны працэнт набыцця.

warehouseRationumber · double

Пагадненне склада.

wildberriesCommissionnumber · double

Камісія Wildberries.

wildberriesFbwCommissionnumber · double

Wildberries Fbw камісія.

wildberriesFbsCommissionnumber · double

Wildberries ФБС камісія.

wildberriesDbsCommissionnumber · double

У Wildberries Dbs камісія.

wildberriesEdbsCommissionnumber · double

Камісія Wildberries Edbs.

wildberriesCAndCCommissionnumber · double

Wildberries C і C камісія.

wildberriesBookingCommissionnumber · double

Камісія за рэзерваванне Wildberries.

wildberriesAdditionalExpensesnumber · double

Дадатковыя выдаткі Wildberries.

ozonAdditionalExpensesnumber · double

Дадатковыя выдаткі на азон.

ozonCommissionnumber · double

Камісія па азёне.

wildberriesIdinteger · int64

Ід Wildberries.

productIdinteger · int64

Ід прадукту.

promotionIdinteger · int64

Падвышаная пазнака.

ozonFbsCommissionnumber · double

Камісія па абароне назірання за озонам.

ozonFboCommissionnumber · double

Камісія па абароне озона.

servicestring

Паслуга.

acquiringPercentnumber · double

Атрыманне працэнтаў.

currentPricenumber · double

Цяперашні кошт.

currentPriceWithoutDiscountnumber · double

Цяперашняя цана без зніжка.

plannedPricenumber · double

Плануецца Прэс.

totalStockCountinteger · int64

Агульны паліклік запасаў.

commissionReductionnumber · double

Змены камісіі.

profitDifferencenumber · double

Розніца ў прыбытку.

marginDifferencenumber · double

Марж розніца.

markupDifferencenumber · double

Адметная адрозненне.

plannedAndMinPriceDiffnumber · double

Плануецца і мінімальная розніца ў цане.

incomeDifferencenumber · double

Розніца ў даходах.

currentDiscountnumber · double

Цяперашні зніжка.

productCreatedDatestring · date-time

Дата стварэння прадукту.

mainImageUrlstring

Галоўны URL малюнка.

isProfitablyboolean

Гэта выгадна.

taskIdinteger · int64

Ід задання.

serviceArticlestring

Службы артыкул.

articlestring

Артыкул.

daysCountOnServiceinteger · int32

Дні лічаць на службе.

turnoverinteger · int32

Зровень абароту.

fboStockinteger · int32

ФБО Сток.

fbsStockinteger · int32

ФБС Сток.

newDiscountForPromotionnumber · double

Новая зніжка на прасоўванне.

saleLogisticsnumber · double

Прадавецкая лагістыка.

returnLogisticsnumber · double

Верніце лагістыку.

purchasePercentnumber · double

Перакупа працэнт.

totalLogisticsnumber · double

Тотальная лагістыка.

commissionsnumber · double

Камісіі.

currentProfitnumber · double

Цяперашні прыбытак.

promotionProfitnumber · double

Выгады павышэння.

currentMarginalitynumber · double

Цяперашні маргінальнасць.

promotionMarginalitynumber · double

Павышэнне маргінальнасці.

currentMarkUpnumber · double

У цяперашні час адзначыць.

promotionMarkUpnumber · double

Павышэнне адзначыць.

additionalDiscountForPromotionRubnumber · double

Дадатковая зніжка на прасоўванне.

additionalDiscountForPromotionPercentnumber · double

Дадатковая зніжка на прасоўванне.

isDeletedboolean

Знік.

organizationIdinteger · int64

Ід арганізацыі.

clientIdinteger · int64

Ідэнтыфікатар кліента.

addModestring

Дадаць рэжым.

ozonAverageExpensesnumber · double

Сярэднія выдаткаў на азон.

isActiveboolean

Ён актыўны.

changeNamestring

Змяніце імя.

changeDatestring · date-time

Змяніць дату.

productNamestring

Назва прадукту.

idinteger · int64

Id.

totalCountinteger · int64

Тотальны лічба.

serviceCardstring

Карта службы.

isNotFoundboolean

Не знайшлі.

isArchivedboolean

Зархіраваны.

productCommissionsstring

Прадукты камісіі.

currentGrossProfitnumber · double

Цяперашнія валовыя прыбыткі.

plannedGrossProfitnumber · double

Плануецца валодная прыбытак.

OzonProduct4 палёў
product_idinteger · int64

Ідэнтыфікатар прадукту.

action_pricenumber · double

Кошт акцыі.

stockinteger · int32

Сток.

reasonstring

Прычына.

FindResponseProductPromotion1 палёў
rowsProductPromotion[]

Рыжкі.

FindResponsePromotion1 палёў
rowsPromotion[]

Рыжкі.

Памылка дагавор

Як вяртаюць памылкі прыкладання

Код error аднолькавы ў кожным лакелі, у той час як паведамленне, якое з'яўляецца карыстальнікам, перакладаецца серверам.

error

Стабільны машыначытай код для інтэграцыйнай логікі.

localMessage

Паведамленне гатовае да адлюстравання на мове карыстальніка токены API.

params

Значэнні, якія інтэрполююцца серверам у лакалізаваным шаблоне паведамленняў.

localMessage выкарыстоўвае поле lang карыстальніка, які валодае токеном API. Мова дакументацыі і загаловак Accept-Language не змяняюць яго; руская выкарыстоўваецца, калі карыстацкая мова не канфігуруецца.

RUМясцовасць карыстальніка ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
BEБеларуская (be)
{
  "error": "error_brand_already_exists",
  "localMessage": "Брэнд Base ужо існуе",
  "params": {
    "name": "Base"
  }
}

Канчатковыя пункты

Канчатковыя пункты

PUT

Падвышаць

/api/promotion/{promotionId}
Знак з пісьмовым доступам

Падключыць прасоўванне з дапамогай PUT /api/promotion/{promotionId}.

Запытвальны орган

application/json
Палі аб'ектаўPromotion
ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Не Падвышаная пазнака.
id integer · int64 Не Id.
totalCount integer · int64 Не Тотальны лічба.
name string Не Назва.
dateStart string · date-time Не Пачатак дата.
dateEnd string · date-time Не Дата скончыцца.
changeCommission boolean Не Змяніце камісію.
changeCommissionAmount number · double Не Змяніць суму камісіі.
createdDate 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 Не Паслуга.
isDeleted boolean Не Знік.
description string Не Апісанне.
promotionIdOnMp string Не Папулярнае значэнне на MP.
clientId integer · int64 Не Ідэнтыфікатар кліента.
organizationId integer · int64 Не Ід арганізацыі.
candidateCount integer · int64 Не Кандыдат граф.
inPromotionCount integer · int64 Не У падвышаным ліку.
auto boolean Не Аўтамабіль.
hotsale boolean Не Готсале.
candidateCountOnMp integer · int64 Не Кандыдат разлічвае на MP.
inPromotionCountOnMp integer · int64 Не У прасоўванні лічыць на Mp.
curl --request PUT 'https://api.selsup.ru/api/promotion/%7BpromotionId%7D' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}'

Удалы адказ

200
Палі аб'ектаў Promotion
ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Не Падвышаная пазнака.
id integer · int64 Не Id.
totalCount integer · int64 Не Тотальны лічба.
name string Не Назва.
dateStart string · date-time Не Пачатак дата.
dateEnd string · date-time Не Дата скончыцца.
changeCommission boolean Не Змяніце камісію.
changeCommissionAmount number · double Не Змяніць суму камісіі.
createdDate 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 Не Паслуга.
isDeleted boolean Не Знік.
description string Не Апісанне.
promotionIdOnMp string Не Папулярнае значэнне на MP.
clientId integer · int64 Не Ідэнтыфікатар кліента.
organizationId integer · int64 Не Ід арганізацыі.
candidateCount integer · int64 Не Кандыдат граф.
inPromotionCount integer · int64 Не У падвышаным ліку.
auto boolean Не Аўтамабіль.
hotsale boolean Не Готсале.
candidateCountOnMp integer · int64 Не Кандыдат разлічвае на MP.
inPromotionCountOnMp integer · int64 Не У прасоўванні лічыць на Mp.
{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}
Памылкі4

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

PATCH

Вярнуць прасоўванне па ID

/api/promotion/{promotionId}
Знак з пісьмовым доступам

Вярнуць прасоўванне па ID з дапамогай PATCH /api/promotion/{promotionId}.

Параметры шляху

ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Так Падвышаная пазнака.
curl --request PATCH 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200

Адказ не мае цела.

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

DELETE

Знімайце прасоўванне па ID

/api/promotion/{promotionId}
Знак з пісьмовым доступам

Знішчыць прасоўванне па ID з дапамогай DELETE /api/promotion/{promotionId}.

Параметры шляху

ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Так Падвышаная пазнака.
curl --request DELETE 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200

Адказ не мае цела.

Памылкі3

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

POST

Абноўленне

/api/promotion/update/{service}
Знак з пісьмовым доступам

Абноўленне з дапамогай POST /api/promotion/update/{service}.

Параметры шляху

ПолеТыпАбавязковаАпісанне
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 Не Ід арганізацыі.
curl --request POST 'https://api.selsup.ru/api/promotion/update/NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Палі аб'ектаў TmsTask
ПолеТыпАбавязковаАпісанне
id integer · int64 Не Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Не Status.
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 Не Type.
name string Не Назва.
clientId integer · int64 Не Ідэнтыфікатар кліента.
entityId integer · int64 Не Ід суб'екта.
progress integer · int32 Не Прагрэс.
processedQuantity integer · int32 Не Працаванае колькасць.
organizationId integer · int64 Не Ід арганізацыі.
priority integer · int32 Не Пераважнасць.
properties string Не Маёмасці.
message string Не Паведамленне.
messageParams string Не Паведамленне Params.
createdDate string · date-time Не Стварыўся Дата.
startDate string · date-time Не Пачатак дата.
finishDate string · date-time Не Дата заканчэння.
url string Не Ураль.
inputFileUrl string Не Уклад файла URL.
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 Не Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Памылкі36

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_cannot_deleted_order_product
Немагчыма выдаліць тавар, да якога прывязаны тавары размешчаныя на складзе або не спісаная маркіроўка

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_cannot_deleted_order_product ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_competitor_id_required
Патрабуецца id канкурэнта

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_competitor_id_required ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_competitor_required
Канкурэнт абавязковы

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_competitor_required ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_competitor_service_required
Сэрвіс канкурэнта абавязковы

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_competitor_service_required ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_competitor_url_required
Спасылка канкурэнта абавязковая

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_competitor_url_required ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_customer_not_found
Пакупнік не знойдзены

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_customer_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_duplicate_order_product
У заказ дададзены два аднолькавыя тавары {productId}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_duplicate_order_product ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_warehouse
Не пазначаны склад

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_warehouse ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_group_already_exist
Група ўжо існуе

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_group_already_exist ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_incorrect_order_data
Немагчыма стварыць замову з-за таго, што арганізацыя, склад або карыстальнік ужо выдалены: {id}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_incorrect_order_data ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_invalid_url
Некарэктны адрас сайта, ён павінен пачынацца з http:// або https://, у адрасе забаронена паказваць слова selsup, localhost

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_invalid_url ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_moy_sklad_organization
Арганізацыя ў МойСклад не знойдзена

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_moy_sklad_organization ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_ms_error
Памылка API МойСклад: {message}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_ms_error ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_ms_no_warehouse
Не пазначана сувязь склада SelSup са складам сэрвісу МойСклад

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_ms_no_warehouse ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_ms_update_order_state
Не атрымалася абнавіць статус замовы ў МойСклад

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_ms_update_order_state ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_marketplace ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_organization
Не пазначана арганізацыя

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_organization ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_price_for_order_product
Не пазначана цана для тавару: {name}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_price_for_order_product ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_products_in_order
У дадзеным заказе не знойдзена ніводнага прадукту

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_products_in_order ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_quantity_for_order_product
Не пазначана колькасць тавару: {name}

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_quantity_for_order_product ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_not_reserved
Здымаць рэзерв можна толькі з зарэзерваваных тавараў

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_not_reserved ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_not_uniq_external_id
Знешні нумар {id} ужо выкарыстоўваецца для іншага заказа

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_not_uniq_external_id ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_order_not_found
Заказ не знойдзены

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_order_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_order_product_stock
Тавар нельга выдаліць пасля априходавання рэшткаў

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_order_product_stock ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_product_not_found_by_id
Не знойдзены тавары па ідэнтыфікатары. Магчыма, Вы выдалілі тавар падчас імпарту

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_product_not_found_by_id ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_source_cell_change_not_allowed_for_inter_warehouse_movement
Змяненне ячэйкі крыніцы не дазволена для перамяшчэння паміж складамі

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_source_cell_change_not_allowed_for_inter_warehouse_movement ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_stock_update_busy
У дадзены момант праводзіцца абнаўленне рэшткаў, паспрабуйце пазней

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_stock_update_busy ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_token_expired_or_revoked
Токен API адкліканы або ўведзены некарэктна. Праверце, што ключ API мае поўны функцыянал. Згенеруйце новы ключ і заменіце ў SELSUP, бо ключы маюць тэрмін жыцця.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_token_expired_or_revoked ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_unsupported_service
Сэрвіс не падтрымліваецца

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_unsupported_service ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_warehouse_not_found
Не найден склад

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_warehouse_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_wms_item_not_found
Не знойдзены унікальны код тавара

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_wms_item_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

POST

Знімайце прадукты ў прапаганды

/api/promotion/deleteProductsInPromotion
Знак з пісьмовым доступам

Знішчыць прадукты ў прапанове з дапамогай POST /api/promotion/deleteProductsInPromotion.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Так Падвышаная пазнака.
clientOrganizationId integer · int64 Так Ід арганізацыі кліента.

Запытвальны орган

application/json
Структура элементаў масіваProductPromotion[]
ПолеТыпАбавязковаАпісанне
categoryName string Не Назва катэгорыі.
brandName string Не Назва брэнда.
subject string Не Суб'ект.
purchasePrice number · double Не Купля Прэміі.
deliveryCost number · double Не Кошт дастаўкі.
additionalCost number · double Не Дадатковыя кошт.
barcode string Не Бар-код.
instockQuantity integer · int64 Не У запасах колькасць.
wildberriesStockCount integer · int64 Не Wildberries запасаў падлічыць.
yandexMarketStockCount integer · int64 Не Яндэкс Рынок Акцыі падліку.
createdDate string · date-time Не Стварыўся Дата.
minPrice number · double Не Мін Прайс.
isDuplicate boolean Не Гэта Дублікат.
ozonArticle string Не Азоны артыкул.
ozonStockCount integer · int64 Не Азоны акцыі лічыць.
salesExpensesOnMpPercent number · double Не Расходы на продажу на Mp працэнт.
taxeRate number · double Не Падатковыя стаўкі.
width integer · int32 Не Шырыня.
height integer · int32 Не Вышыня.
depth integer · int32 Не Глыбіня.
ozonPurchasePercent number · double Не Азоны працэнт набыцця.
warehouseRatio number · double Не Пагадненне склада.
wildberriesCommission number · double Не Камісія Wildberries.
wildberriesFbwCommission number · double Не Wildberries Fbw камісія.
wildberriesFbsCommission number · double Не Wildberries ФБС камісія.
wildberriesDbsCommission number · double Не У Wildberries Dbs камісія.
wildberriesEdbsCommission number · double Не Камісія Wildberries Edbs.
wildberriesCAndCCommission number · double Не Wildberries C і C камісія.
wildberriesBookingCommission number · double Не Камісія за рэзерваванне Wildberries.
wildberriesAdditionalExpenses number · double Не Дадатковыя выдаткі Wildberries.
ozonAdditionalExpenses number · double Не Дадатковыя выдаткі на азон.
ozonCommission number · double Не Камісія па азёне.
wildberriesId integer · int64 Не Ід Wildberries.
productId integer · int64 Не Ід прадукту.
promotionId integer · int64 Не Падвышаная пазнака.
ozonFbsCommission number · double Не Камісія па абароне назірання за озонам.
ozonFboCommission number · double Не Камісія па абароне озона.
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 Не Паслуга.
acquiringPercent number · double Не Атрыманне працэнтаў.
currentPrice number · double Не Цяперашні кошт.
currentPriceWithoutDiscount number · double Не Цяперашняя цана без зніжка.
plannedPrice number · double Не Плануецца Прэс.
totalStockCount integer · int64 Не Агульны паліклік запасаў.
commissionReduction number · double Не Змены камісіі.
profitDifference number · double Не Розніца ў прыбытку.
marginDifference number · double Не Марж розніца.
markupDifference number · double Не Адметная адрозненне.
plannedAndMinPriceDiff number · double Не Плануецца і мінімальная розніца ў цане.
incomeDifference number · double Не Розніца ў даходах.
currentDiscount number · double Не Цяперашні зніжка.
productCreatedDate string · date-time Не Дата стварэння прадукту.
mainImageUrl string Не Галоўны URL малюнка.
isProfitably boolean Не Гэта выгадна.
taskId integer · int64 Не Ід задання.
serviceArticle string Не Службы артыкул.
article string Не Артыкул.
daysCountOnService integer · int32 Не Дні лічаць на службе.
turnover integer · int32 Не Зровень абароту.
fboStock integer · int32 Не ФБО Сток.
fbsStock integer · int32 Не ФБС Сток.
newDiscountForPromotion number · double Не Новая зніжка на прасоўванне.
saleLogistics number · double Не Прадавецкая лагістыка.
returnLogistics number · double Не Верніце лагістыку.
purchasePercent number · double Не Перакупа працэнт.
totalLogistics number · double Не Тотальная лагістыка.
commissions number · double Не Камісіі.
currentProfit number · double Не Цяперашні прыбытак.
promotionProfit number · double Не Выгады павышэння.
currentMarginality number · double Не Цяперашні маргінальнасць.
promotionMarginality number · double Не Павышэнне маргінальнасці.
currentMarkUp number · double Не У цяперашні час адзначыць.
promotionMarkUp number · double Не Павышэнне адзначыць.
additionalDiscountForPromotionRub number · double Не Дадатковая зніжка на прасоўванне.
additionalDiscountForPromotionPercent number · double Не Дадатковая зніжка на прасоўванне.
isDeleted boolean Не Знік.
organizationId integer · int64 Не Ід арганізацыі.
clientId integer · int64 Не Ідэнтыфікатар кліента.
addMode string Не Дадаць рэжым.
ozonAverageExpenses number · double Не Сярэднія выдаткаў на азон.
isActive boolean Не Ён актыўны.
changeName string Не Змяніце імя.
changeDate string · date-time Не Змяніць дату.
productName string Не Назва прадукту.
id integer · int64 Не Id.
totalCount integer · int64 Не Тотальны лічба.
serviceCard string Не Карта службы.
isNotFound boolean Не Не знайшлі.
isArchived boolean Не Зархіраваны.
productCommissions string Не Прадукты камісіі.
currentGrossProfit number · double Не Цяперашнія валовыя прыбыткі.
plannedGrossProfit number · double Не Плануецца валодная прыбытак.
curl --request POST 'https://api.selsup.ru/api/promotion/deleteProductsInPromotion?promotionId=1001&clientOrganizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Удалы адказ

200
Структура элементаў масіва OzonProduct[]
ПолеТыпАбавязковаАпісанне
product_id integer · int64 Не Ідэнтыфікатар прадукту.
action_price number · double Не Кошт акцыі.
stock integer · int32 Не Сток.
reason string Не Прычына.
[
  "string"
]
Памылкі11

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_auto_promotion_not_supported
Нельга дадаваць тавар у аўтаматычную акцыю

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_auto_promotion_not_supported ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_ozon_id
пусты ID Ozon

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_ozon_id ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_promotion_exists
Запыт на даданне тавараў у акцыю ўжо адпраўляўся раней. Паўторная адпраўка немагчымая

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_promotion_exists ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_remote
Адбылася памылка пры запыце знешняга сэрвісу

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_remote ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_token_expired_or_revoked
Токен API адкліканы або ўведзены некарэктна. Праверце, што ключ API мае поўны функцыянал. Згенеруйце новы ключ і заменіце ў SELSUP, бо ключы маюць тэрмін жыцця.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_token_expired_or_revoked ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_wildberries_import_error
На баку WB праводзяцца тэхнічныя работы, паўтарыце спробу пазней, падрабязнасці можна даведацца ў тэхпадтрымцы (API: {message})

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_wildberries_import_error ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

POST

Дадаць прадукты ў прасоўванне

/api/promotion/addProductsInPromotion
Знак з пісьмовым доступам

Дадаць прадукты ў прапанову з дапамогай POST /api/promotion/addProductsInPromotion.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Так Падвышаная пазнака.
clientOrganizationId integer · int64 Так Ід арганізацыі кліента.

Запытвальны орган

application/json
Структура элементаў масіваProductPromotion[]
ПолеТыпАбавязковаАпісанне
categoryName string Не Назва катэгорыі.
brandName string Не Назва брэнда.
subject string Не Суб'ект.
purchasePrice number · double Не Купля Прэміі.
deliveryCost number · double Не Кошт дастаўкі.
additionalCost number · double Не Дадатковыя кошт.
barcode string Не Бар-код.
instockQuantity integer · int64 Не У запасах колькасць.
wildberriesStockCount integer · int64 Не Wildberries запасаў падлічыць.
yandexMarketStockCount integer · int64 Не Яндэкс Рынок Акцыі падліку.
createdDate string · date-time Не Стварыўся Дата.
minPrice number · double Не Мін Прайс.
isDuplicate boolean Не Гэта Дублікат.
ozonArticle string Не Азоны артыкул.
ozonStockCount integer · int64 Не Азоны акцыі лічыць.
salesExpensesOnMpPercent number · double Не Расходы на продажу на Mp працэнт.
taxeRate number · double Не Падатковыя стаўкі.
width integer · int32 Не Шырыня.
height integer · int32 Не Вышыня.
depth integer · int32 Не Глыбіня.
ozonPurchasePercent number · double Не Азоны працэнт набыцця.
warehouseRatio number · double Не Пагадненне склада.
wildberriesCommission number · double Не Камісія Wildberries.
wildberriesFbwCommission number · double Не Wildberries Fbw камісія.
wildberriesFbsCommission number · double Не Wildberries ФБС камісія.
wildberriesDbsCommission number · double Не У Wildberries Dbs камісія.
wildberriesEdbsCommission number · double Не Камісія Wildberries Edbs.
wildberriesCAndCCommission number · double Не Wildberries C і C камісія.
wildberriesBookingCommission number · double Не Камісія за рэзерваванне Wildberries.
wildberriesAdditionalExpenses number · double Не Дадатковыя выдаткі Wildberries.
ozonAdditionalExpenses number · double Не Дадатковыя выдаткі на азон.
ozonCommission number · double Не Камісія па азёне.
wildberriesId integer · int64 Не Ід Wildberries.
productId integer · int64 Не Ід прадукту.
promotionId integer · int64 Не Падвышаная пазнака.
ozonFbsCommission number · double Не Камісія па абароне назірання за озонам.
ozonFboCommission number · double Не Камісія па абароне озона.
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 Не Паслуга.
acquiringPercent number · double Не Атрыманне працэнтаў.
currentPrice number · double Не Цяперашні кошт.
currentPriceWithoutDiscount number · double Не Цяперашняя цана без зніжка.
plannedPrice number · double Не Плануецца Прэс.
totalStockCount integer · int64 Не Агульны паліклік запасаў.
commissionReduction number · double Не Змены камісіі.
profitDifference number · double Не Розніца ў прыбытку.
marginDifference number · double Не Марж розніца.
markupDifference number · double Не Адметная адрозненне.
plannedAndMinPriceDiff number · double Не Плануецца і мінімальная розніца ў цане.
incomeDifference number · double Не Розніца ў даходах.
currentDiscount number · double Не Цяперашні зніжка.
productCreatedDate string · date-time Не Дата стварэння прадукту.
mainImageUrl string Не Галоўны URL малюнка.
isProfitably boolean Не Гэта выгадна.
taskId integer · int64 Не Ід задання.
serviceArticle string Не Службы артыкул.
article string Не Артыкул.
daysCountOnService integer · int32 Не Дні лічаць на службе.
turnover integer · int32 Не Зровень абароту.
fboStock integer · int32 Не ФБО Сток.
fbsStock integer · int32 Не ФБС Сток.
newDiscountForPromotion number · double Не Новая зніжка на прасоўванне.
saleLogistics number · double Не Прадавецкая лагістыка.
returnLogistics number · double Не Верніце лагістыку.
purchasePercent number · double Не Перакупа працэнт.
totalLogistics number · double Не Тотальная лагістыка.
commissions number · double Не Камісіі.
currentProfit number · double Не Цяперашні прыбытак.
promotionProfit number · double Не Выгады павышэння.
currentMarginality number · double Не Цяперашні маргінальнасць.
promotionMarginality number · double Не Павышэнне маргінальнасці.
currentMarkUp number · double Не У цяперашні час адзначыць.
promotionMarkUp number · double Не Павышэнне адзначыць.
additionalDiscountForPromotionRub number · double Не Дадатковая зніжка на прасоўванне.
additionalDiscountForPromotionPercent number · double Не Дадатковая зніжка на прасоўванне.
isDeleted boolean Не Знік.
organizationId integer · int64 Не Ід арганізацыі.
clientId integer · int64 Не Ідэнтыфікатар кліента.
addMode string Не Дадаць рэжым.
ozonAverageExpenses number · double Не Сярэднія выдаткаў на азон.
isActive boolean Не Ён актыўны.
changeName string Не Змяніце імя.
changeDate string · date-time Не Змяніць дату.
productName string Не Назва прадукту.
id integer · int64 Не Id.
totalCount integer · int64 Не Тотальны лічба.
serviceCard string Не Карта службы.
isNotFound boolean Не Не знайшлі.
isArchived boolean Не Зархіраваны.
productCommissions string Не Прадукты камісіі.
currentGrossProfit number · double Не Цяперашнія валовыя прыбыткі.
plannedGrossProfit number · double Не Плануецца валодная прыбытак.
curl --request POST 'https://api.selsup.ru/api/promotion/addProductsInPromotion?promotionId=1001&clientOrganizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Удалы адказ

200
Структура элементаў масіва OzonProduct[]
ПолеТыпАбавязковаАпісанне
product_id integer · int64 Не Ідэнтыфікатар прадукту.
action_price number · double Не Кошт акцыі.
stock integer · int32 Не Сток.
reason string Не Прычына.
[
  "string"
]
Памылкі11

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_auto_promotion_not_supported
Нельга дадаваць тавар у аўтаматычную акцыю

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_auto_promotion_not_supported ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_empty_ozon_id
пусты ID Ozon

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_empty_ozon_id ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_promotion_exists
Запыт на даданне тавараў у акцыю ўжо адпраўляўся раней. Паўторная адпраўка немагчымая

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_promotion_exists ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_remote
Адбылася памылка пры запыце знешняга сэрвісу

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_remote ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_token_expired_or_revoked
Токен API адкліканы або ўведзены некарэктна. Праверце, што ключ API мае поўны функцыянал. Згенеруйце новы ключ і заменіце ў SELSUP, бо ключы маюць тэрмін жыцця.

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_token_expired_or_revoked ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_wildberries_import_error
На баку WB праводзяцца тэхнічныя работы, паўтарыце спробу пазней, падрабязнасці можна даведацца ў тэхпадтрымцы (API: {message})

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_wildberries_import_error ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

POST

Пасля прасоўвання

/api/promotion/
Знак з пісьмовым доступам

Пасля прасоўвання з дапамогай POST /api/promotion/.

Запытвальны орган

application/json
Палі аб'ектаўPromotion
ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Не Падвышаная пазнака.
id integer · int64 Не Id.
totalCount integer · int64 Не Тотальны лічба.
name string Не Назва.
dateStart string · date-time Не Пачатак дата.
dateEnd string · date-time Не Дата скончыцца.
changeCommission boolean Не Змяніце камісію.
changeCommissionAmount number · double Не Змяніць суму камісіі.
createdDate 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 Не Паслуга.
isDeleted boolean Не Знік.
description string Не Апісанне.
promotionIdOnMp string Не Папулярнае значэнне на MP.
clientId integer · int64 Не Ідэнтыфікатар кліента.
organizationId integer · int64 Не Ід арганізацыі.
candidateCount integer · int64 Не Кандыдат граф.
inPromotionCount integer · int64 Не У падвышаным ліку.
auto boolean Не Аўтамабіль.
hotsale boolean Не Готсале.
candidateCountOnMp integer · int64 Не Кандыдат разлічвае на MP.
inPromotionCountOnMp integer · int64 Не У прасоўванні лічыць на Mp.
curl --request POST 'https://api.selsup.ru/api/promotion/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}'

Удалы адказ

200
Палі аб'ектаў Promotion
ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Не Падвышаная пазнака.
id integer · int64 Не Id.
totalCount integer · int64 Не Тотальны лічба.
name string Не Назва.
dateStart string · date-time Не Пачатак дата.
dateEnd string · date-time Не Дата скончыцца.
changeCommission boolean Не Змяніце камісію.
changeCommissionAmount number · double Не Змяніць суму камісіі.
createdDate 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 Не Паслуга.
isDeleted boolean Не Знік.
description string Не Апісанне.
promotionIdOnMp string Не Папулярнае значэнне на MP.
clientId integer · int64 Не Ідэнтыфікатар кліента.
organizationId integer · int64 Не Ід арганізацыі.
candidateCount integer · int64 Не Кандыдат граф.
inPromotionCount integer · int64 Не У падвышаным ліку.
auto boolean Не Аўтамабіль.
hotsale boolean Не Готсале.
candidateCountOnMp integer · int64 Не Кандыдат разлічвае на MP.
inPromotionCountOnMp integer · int64 Не У прасоўванні лічыць на Mp.
{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}
Памылкі4

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

GET

Вывоза прадукцыі

/api/promotion/{promotionId}/product/export
Значок з чытальным доступам

Вывоз прадуктаў з выкарыстаннем GET /api/promotion/{promotionId}/product/export.

Параметры шляху

ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Так Падвышаная пазнака.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
dateFrom string · date-time Не Дата ад.
dateTo 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 Не Паслуга.
reDownload boolean Не Перазагрузка.
clientOrganizationId integer · int64 Не Ід арганізацыі кліента.
minMargin number · double Не Мін Маржына.
minMarginPercent number · double Не Мін-марж працэнт.
isActive boolean Не Ён актыўны.
isDeleted boolean Не Знік.
query string Не Запытваючы.
promotionIdOnMp integer · int64 Не Папулярнае значэнне на MP.
categoryId integer · int64 Не Ід катэгорыі.
categoryIds integer[] Не Пазнакі катэгорыі.
clientId integer · int64 Не Ідэнтыфікатар кліента.
inStock boolean Не У Стаку.
isNotFound boolean Не Не знайшлі.
limit integer · int32 Не Межа.
page integer · int32 Не Праз старонку.
count boolean Не Граф.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER Не Пасля.
ascending boolean Не Падыходзіць.
curl --request GET 'https://api.selsup.ru/api/promotion/1001/product/export?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
"string"
Памылкі7

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_cant_download_file
Не атрымоўваецца сфармаваць файл. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_cant_download_file ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_promotion_not_found
прамаакцыя не знойдзена

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_promotion_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_service_not_found
Не выбраны маркетплейс

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_service_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

GET

Знайсці

/api/promotion/product/find
Значок з чытальным доступам

Знайсці з дапамогай GET /api/promotion/product/find.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
dateFrom string · date-time Не Дата ад.
dateTo string · date-time Не Дата да.
promotionId integer · int64 Не Падвышаная пазнака.
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 Не Паслуга.
reDownload boolean Не Перазагрузка.
clientOrganizationId integer · int64 Не Ід арганізацыі кліента.
minMargin number · double Не Мін Маржына.
minMarginPercent number · double Не Мін-марж працэнт.
isActive boolean Не Ён актыўны.
isDeleted boolean Не Знік.
query string Не Запытваючы.
promotionIdOnMp integer · int64 Не Папулярнае значэнне на MP.
categoryId integer · int64 Не Ід катэгорыі.
categoryIds integer[] Не Пазнакі катэгорыі.
clientId integer · int64 Не Ідэнтыфікатар кліента.
inStock boolean Не У Стаку.
isNotFound boolean Не Не знайшлі.
limit integer · int32 Не Межа.
page integer · int32 Не Праз старонку.
count boolean Не Граф.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER Не Пасля.
ascending boolean Не Падыходзіць.
curl --request GET 'https://api.selsup.ru/api/promotion/product/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Палі аб'ектаў FindResponseProductPromotion
ПолеТыпАбавязковаАпісанне
rows ProductPromotion[] Не Рыжкі.
Структура элементаў масіва ProductPromotion
ПолеТыпАбавязковаАпісанне
categoryName string Не Назва катэгорыі.
brandName string Не Назва брэнда.
subject string Не Суб'ект.
purchasePrice number · double Не Купля Прэміі.
deliveryCost number · double Не Кошт дастаўкі.
additionalCost number · double Не Дадатковыя кошт.
barcode string Не Бар-код.
instockQuantity integer · int64 Не У запасах колькасць.
wildberriesStockCount integer · int64 Не Wildberries запасаў падлічыць.
yandexMarketStockCount integer · int64 Не Яндэкс Рынок Акцыі падліку.
createdDate string · date-time Не Стварыўся Дата.
minPrice number · double Не Мін Прайс.
isDuplicate boolean Не Гэта Дублікат.
ozonArticle string Не Азоны артыкул.
ozonStockCount integer · int64 Не Азоны акцыі лічыць.
salesExpensesOnMpPercent number · double Не Расходы на продажу на Mp працэнт.
taxeRate number · double Не Падатковыя стаўкі.
width integer · int32 Не Шырыня.
height integer · int32 Не Вышыня.
depth integer · int32 Не Глыбіня.
ozonPurchasePercent number · double Не Азоны працэнт набыцця.
warehouseRatio number · double Не Пагадненне склада.
wildberriesCommission number · double Не Камісія Wildberries.
wildberriesFbwCommission number · double Не Wildberries Fbw камісія.
wildberriesFbsCommission number · double Не Wildberries ФБС камісія.
wildberriesDbsCommission number · double Не У Wildberries Dbs камісія.
wildberriesEdbsCommission number · double Не Камісія Wildberries Edbs.
wildberriesCAndCCommission number · double Не Wildberries C і C камісія.
wildberriesBookingCommission number · double Не Камісія за рэзерваванне Wildberries.
wildberriesAdditionalExpenses number · double Не Дадатковыя выдаткі Wildberries.
ozonAdditionalExpenses number · double Не Дадатковыя выдаткі на азон.
ozonCommission number · double Не Камісія па азёне.
wildberriesId integer · int64 Не Ід Wildberries.
productId integer · int64 Не Ід прадукту.
promotionId integer · int64 Не Падвышаная пазнака.
ozonFbsCommission number · double Не Камісія па абароне назірання за озонам.
ozonFboCommission number · double Не Камісія па абароне озона.
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 Не Паслуга.
acquiringPercent number · double Не Атрыманне працэнтаў.
currentPrice number · double Не Цяперашні кошт.
currentPriceWithoutDiscount number · double Не Цяперашняя цана без зніжка.
plannedPrice number · double Не Плануецца Прэс.
totalStockCount integer · int64 Не Агульны паліклік запасаў.
commissionReduction number · double Не Змены камісіі.
profitDifference number · double Не Розніца ў прыбытку.
marginDifference number · double Не Марж розніца.
markupDifference number · double Не Адметная адрозненне.
plannedAndMinPriceDiff number · double Не Плануецца і мінімальная розніца ў цане.
incomeDifference number · double Не Розніца ў даходах.
currentDiscount number · double Не Цяперашні зніжка.
productCreatedDate string · date-time Не Дата стварэння прадукту.
mainImageUrl string Не Галоўны URL малюнка.
isProfitably boolean Не Гэта выгадна.
taskId integer · int64 Не Ід задання.
serviceArticle string Не Службы артыкул.
article string Не Артыкул.
daysCountOnService integer · int32 Не Дні лічаць на службе.
turnover integer · int32 Не Зровень абароту.
fboStock integer · int32 Не ФБО Сток.
fbsStock integer · int32 Не ФБС Сток.
newDiscountForPromotion number · double Не Новая зніжка на прасоўванне.
saleLogistics number · double Не Прадавецкая лагістыка.
returnLogistics number · double Не Верніце лагістыку.
purchasePercent number · double Не Перакупа працэнт.
totalLogistics number · double Не Тотальная лагістыка.
commissions number · double Не Камісіі.
currentProfit number · double Не Цяперашні прыбытак.
promotionProfit number · double Не Выгады павышэння.
currentMarginality number · double Не Цяперашні маргінальнасць.
promotionMarginality number · double Не Павышэнне маргінальнасці.
currentMarkUp number · double Не У цяперашні час адзначыць.
promotionMarkUp number · double Не Павышэнне адзначыць.
additionalDiscountForPromotionRub number · double Не Дадатковая зніжка на прасоўванне.
additionalDiscountForPromotionPercent number · double Не Дадатковая зніжка на прасоўванне.
isDeleted boolean Не Знік.
organizationId integer · int64 Не Ід арганізацыі.
clientId integer · int64 Не Ідэнтыфікатар кліента.
addMode string Не Дадаць рэжым.
ozonAverageExpenses number · double Не Сярэднія выдаткаў на азон.
isActive boolean Не Ён актыўны.
changeName string Не Змяніце імя.
changeDate string · date-time Не Змяніць дату.
productName string Не Назва прадукту.
id integer · int64 Не Id.
totalCount integer · int64 Не Тотальны лічба.
serviceCard string Не Карта службы.
isNotFound boolean Не Не знайшлі.
isArchived boolean Не Зархіраваны.
productCommissions string Не Прадукты камісіі.
currentGrossProfit number · double Не Цяперашнія валовыя прыбыткі.
plannedGrossProfit number · double Не Плануецца валодная прыбытак.
{
  "rows": "string"
}
Памылкі4

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

GET

Усе

/api/promotion/find
Значок з чытальным доступам

Усе выкарыстоўваюць GET /api/promotion/find.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
dateFrom string · date-time Не Дата ад.
dateTo string · date-time Не Дата да.
promotionId integer · int64 Не Падвышаная пазнака.
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 Не Паслуга.
reDownload boolean Не Перазагрузка.
clientOrganizationId integer · int64 Не Ід арганізацыі кліента.
minMargin number · double Не Мін Маржына.
minMarginPercent number · double Не Мін-марж працэнт.
isActive boolean Не Ён актыўны.
isDeleted boolean Не Знік.
query string Не Запытваючы.
promotionIdOnMp integer · int64 Не Папулярнае значэнне на MP.
categoryId integer · int64 Не Ід катэгорыі.
categoryIds integer[] Не Пазнакі катэгорыі.
clientId integer · int64 Не Ідэнтыфікатар кліента.
inStock boolean Не У Стаку.
isNotFound boolean Не Не знайшлі.
limit integer · int32 Не Межа.
page integer · int32 Не Праз старонку.
count boolean Не Граф.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER Не Пасля.
ascending boolean Не Падыходзіць.
curl --request GET 'https://api.selsup.ru/api/promotion/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
Палі аб'ектаў FindResponsePromotion
ПолеТыпАбавязковаАпісанне
rows Promotion[] Не Рыжкі.
Структура элементаў масіва Promotion
ПолеТыпАбавязковаАпісанне
promotionId integer · int64 Не Падвышаная пазнака.
id integer · int64 Не Id.
totalCount integer · int64 Не Тотальны лічба.
name string Не Назва.
dateStart string · date-time Не Пачатак дата.
dateEnd string · date-time Не Дата скончыцца.
changeCommission boolean Не Змяніце камісію.
changeCommissionAmount number · double Не Змяніць суму камісіі.
createdDate 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 Не Паслуга.
isDeleted boolean Не Знік.
description string Не Апісанне.
promotionIdOnMp string Не Папулярнае значэнне на MP.
clientId integer · int64 Не Ідэнтыфікатар кліента.
organizationId integer · int64 Не Ід арганізацыі.
candidateCount integer · int64 Не Кандыдат граф.
inPromotionCount integer · int64 Не У падвышаным ліку.
auto boolean Не Аўтамабіль.
hotsale boolean Не Готсале.
candidateCountOnMp integer · int64 Не Кандыдат разлічвае на MP.
inPromotionCountOnMp integer · int64 Не У прасоўванні лічыць на Mp.
{
  "rows": "string"
}
Памылкі5

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_service_not_found
Не выбраны маркетплейс

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_service_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

GET

Экспорт

/api/promotion/export
Значок з чытальным доступам

Экспорт з дапамогай GET /api/promotion/export.

Параметры запытаў

ПолеТыпАбавязковаАпісанне
dateFrom string · date-time Не Дата ад.
dateTo string · date-time Не Дата да.
promotionId integer · int64 Не Падвышаная пазнака.
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 Не Паслуга.
reDownload boolean Не Перазагрузка.
clientOrganizationId integer · int64 Не Ід арганізацыі кліента.
minMargin number · double Не Мін Маржына.
minMarginPercent number · double Не Мін-марж працэнт.
isActive boolean Не Ён актыўны.
isDeleted boolean Не Знік.
query string Не Запытваючы.
promotionIdOnMp integer · int64 Не Папулярнае значэнне на MP.
categoryId integer · int64 Не Ід катэгорыі.
categoryIds integer[] Не Пазнакі катэгорыі.
clientId integer · int64 Не Ідэнтыфікатар кліента.
inStock boolean Не У Стаку.
isNotFound boolean Не Не знайшлі.
limit integer · int32 Не Межа.
page integer · int32 Не Праз старонку.
count boolean Не Граф.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER Не Пасля.
ascending boolean Не Падыходзіць.
curl --request GET 'https://api.selsup.ru/api/promotion/export?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Удалы адказ

200
"string"
Памылкі6

Памылкі прыкладання звычайна вяртаюцца ў выглядзе JSON з error, localMessage і params. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_cant_download_file
Не атрымоўваецца сфармаваць файл. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_cant_download_file ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_service_not_found
Не выбраны маркетплейс

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_service_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

Authorization

Знак для запытаў на выпрабаванне

Токен застаецца ў лакальным сховішчы гэтага браўзэра і адпраўляецца толькі ў заголоўцы Authorization запытаў на api.selsup.ru.

Паспрабаваць

Рэальныя параметры запыту

Жывы адказ API

Пашляце запыт, каб убачыць адказ SelSup.