SelSup Developers

Қоғамдық API · API Анықтама

Өнерлеу

Акциялар үшін нақты бағыттар, параметрлер, сұрау салу органдары және кеңейтілетін жауап схемалары қоса алғанда, соңғы нүктелер.

11 аяқтық нүктелер/api/promotionТұрақтыМашинамен оқитын сипаттама ↗
{ }

Бұл бетте өңдеуге жарамды жеке келісімшарт бар. Өнімді пайдаланудан бұрын сынақ деректерімен жазу операцияларын растаңыз.

/api/promotion

Қолдануға дайын жұмыс барысы

Қолдануға дайын жұмыс барысы

01

Акциялар қолданыла бастаңыз

API токенін пайдаланып, оқу операцияларын бірінші кезекте тест деректерімен растаңыз.

  1. Сервер жағында белгі сақтап, Authorization бағаншасына жіберіңіз.
  2. Керек параметрлерді тексеріп, сұрау немесе жауап схемасын кеңейтіңіз.
  3. HTTP күйін және error тұрақты өрісін қолданба қателерінде өңдеу.

Деректер моделі

Деректер құрылымы

Модельдер бір рет осы жерде тізімделеді және оларды пайдаланатын соңғы нүктелерден тікелей кеңейтілуі мүмкін.

Promotion21 өрістер
promotionIdinteger · int64

Өнерлеу ID.

idinteger · int64

Id.

totalCountinteger · int64

Тоталь шоты.

namestring

Есім.

dateStartstring · date-time

Күні басталады.

dateEndstring · date-time

Күні аяқталды.

changeCommissionboolean

Комиссияны өзгерту.

changeCommissionAmountnumber · double

Комиссияның мөлшерін өзгерту.

createdDatestring · date-time

Жасау күні.

servicestring

Қызмет.

isDeletedboolean

Өшірілді.

descriptionstring

Тасуирлау.

promotionIdOnMpstring

Өнеркәсіптік ID Mp.

clientIdinteger · int64

Клиент танымдығы.

organizationIdinteger · int64

Ұйымның жеке куәлігі.

candidateCountinteger · int64

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

inPromotionCountinteger · int64

Өнерлеуге қол жеткізу.

autoboolean

Автомобиль.

hotsaleboolean

- Айтпақшы.

candidateCountOnMpinteger · int64

Кандидаттар депутатты есептейтін.

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

Паспорттық парам.

createdDatestring · date-time

Жасау күні.

startDatestring · date-time

Басталу күні.

finishDatestring · date-time

Аяқтау күні.

urlstring

URL.

inputFileUrlstring

Кіріс файл URL.

retryNumberinteger · int32

Қайталап көріңіз.

userIdinteger · int32

Пайдаланушы ID.

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 FBS комиссиясы.

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 ID.

productIdinteger · int64

Өнімнің идентификаторы.

promotionIdinteger · int64

Өнерлеу ID.

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

Тапсырма ID.

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-ді көрсету үшін ғана пайдалану.

error

Интеграциялық логика үшін тұрақты машина оқуға болатын код.

localMessage

API белгі пайдаланушы тілінде көрсетілуге дайын хабарлама.

params

Сервердің жергілікті хабарлама үлгісіне интерполациялаған мәндері.

localMessage API белгісін иеленуші пайдаланушының lang өрісін пайдаланады. Құжаттама тілі мен Accept-Language баған оны өзгертпейді; орыс тілі пайдаланушының тілі конфигурацияланбаған кезде қолданылады.

RUПайдаланушы жері ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
KKҚазақша (kk)
{
  "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.
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 Жоқ Өнеркәсіптік ID Mp.
clientId integer · int64 Жоқ Клиент танымдығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
candidateCount integer · int64 Жоқ Кандидат граф.
inPromotionCount integer · int64 Жоқ Өнерлеуге қол жеткізу.
auto boolean Жоқ Автомобиль.
hotsale boolean Жоқ - Айтпақшы.
candidateCountOnMp integer · int64 Жоқ Кандидаттар депутатты есептейтін.
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.
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 Жоқ Өнеркәсіптік ID Mp.
clientId integer · int64 Жоқ Клиент танымдығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
candidateCount integer · int64 Жоқ Кандидат граф.
inPromotionCount integer · int64 Жоқ Өнерлеуге қол жеткізу.
auto boolean Жоқ Автомобиль.
hotsale boolean Жоқ - Айтпақшы.
candidateCountOnMp integer · int64 Жоқ Кандидаттар депутатты есептейтін.
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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

401auth_required
Құжатты куәландыру қажет

Authorization жоқ, бос немесе жарамсыз белгісі бар.

400error_access_denied
Қолжетімділікке тыйым салынған

Токен бар, бірақ оның рөлі бұл операцияны орындай алмайды.

500error_unknown
Белгісіз қате орын алды. Егер мәселе қайталанса, қолдау қызметіне жазыңыз

Ішкі қате. Сұраныс уақытын және байланыс қолдауын үнемдеу; көзге көрінбейтін түрде қайта сынап көріңіз.

400error_no_client
Клиент табылмады немесе жойылды. Қолдау қызметіне жазыңыз

Аяқ нүктесі error. Қолданба логикада error_no_client тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

PATCH

ID арқылы көтермелеуді қалпына келтіру

/api/promotion/{promotionId}
Жазуға қол жеткізуге мүмкіндік беретін белгі

PATCH /api/promotion/{promotionId}. арқылы ID арқылы үгіт- акцияны қалпына келтіру

Жол параметрлері

ӨрісТүріМіндеттіСипаттама
promotionId integer · int64 Иә Өнерлеу ID.
curl --request PATCH 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Жеңіспен жауап

200

Жауаптың денесі жоқ.

Қателер3

Қолданба қателері JSON, error және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

401auth_required
Құжатты куәландыру қажет

Authorization жоқ, бос немесе жарамсыз белгісі бар.

400error_access_denied
Қолжетімділікке тыйым салынған

Токен бар, бірақ оның рөлі бұл операцияны орындай алмайды.

500error_unknown
Белгісіз қате орын алды. Егер мәселе қайталанса, қолдау қызметіне жазыңыз

Ішкі қате. Сұраныс уақытын және байланыс қолдауын үнемдеу; көзге көрінбейтін түрде қайта сынап көріңіз.

DELETE

Өнеркәсіпті ID арқылы өшіру

/api/promotion/{promotionId}
Жазуға қол жеткізуге мүмкіндік беретін белгі

DELETE /api/promotion/{promotionId}. арқылы ID арқылы жарнаманы өшіру

Жол параметрлері

ӨрісТүріМіндеттіСипаттама
promotionId integer · int64 Иә Өнерлеу ID.
curl --request DELETE 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Жеңіспен жауап

200

Жауаптың денесі жоқ.

Қателер3

Қолданба қателері JSON, error және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 Жоқ Паспорттық парам.
createdDate string · date-time Жоқ Жасау күні.
startDate string · date-time Жоқ Басталу күні.
finishDate string · date-time Жоқ Аяқтау күні.
url string Жоқ URL.
inputFileUrl string Жоқ Кіріс файл URL.
retryNumber integer · int32 Жоқ Қайталап көріңіз.
userId integer · int32 Жоқ Пайдаланушы ID.
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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 Иә Өнерлеу ID.
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 FBS комиссиясы.
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 ID.
productId integer · int64 Жоқ Өнімнің идентификаторы.
promotionId integer · int64 Жоқ Өнерлеу ID.
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 Жоқ Тапсырма ID.
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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

401auth_required
Құжатты куәландыру қажет

Authorization жоқ, бос немесе жарамсыз белгісі бар.

400error_access_denied
Қолжетімділікке тыйым салынған

Токен бар, бірақ оның рөлі бұл операцияны орындай алмайды.

500error_unknown
Белгісіз қате орын алды. Егер мәселе қайталанса, қолдау қызметіне жазыңыз

Ішкі қате. Сұраныс уақытын және байланыс қолдауын үнемдеу; көзге көрінбейтін түрде қайта сынап көріңіз.

400error_auto_promotion_not_supported
Тауарды автоматты акцияға қосу мүмкін емес

Аяқ нүктесі error. Қолданба логикада error_auto_promotion_not_supported тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_empty_ozon_id
бос Ozon ID

Аяқ нүктесі 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 Иә Өнерлеу ID.
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 FBS комиссиясы.
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 ID.
productId integer · int64 Жоқ Өнімнің идентификаторы.
promotionId integer · int64 Жоқ Өнерлеу ID.
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 Жоқ Тапсырма ID.
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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

401auth_required
Құжатты куәландыру қажет

Authorization жоқ, бос немесе жарамсыз белгісі бар.

400error_access_denied
Қолжетімділікке тыйым салынған

Токен бар, бірақ оның рөлі бұл операцияны орындай алмайды.

500error_unknown
Белгісіз қате орын алды. Егер мәселе қайталанса, қолдау қызметіне жазыңыз

Ішкі қате. Сұраныс уақытын және байланыс қолдауын үнемдеу; көзге көрінбейтін түрде қайта сынап көріңіз.

400error_auto_promotion_not_supported
Тауарды автоматты акцияға қосу мүмкін емес

Аяқ нүктесі error. Қолданба логикада error_auto_promotion_not_supported тұрақты кодын қолданыңыз; localMessage жоғарыда көрсетілген аударманы қамтиды.

400error_empty_ozon_id
бос Ozon ID

Аяқ нүктесі 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.
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 Жоқ Өнеркәсіптік ID Mp.
clientId integer · int64 Жоқ Клиент танымдығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
candidateCount integer · int64 Жоқ Кандидат граф.
inPromotionCount integer · int64 Жоқ Өнерлеуге қол жеткізу.
auto boolean Жоқ Автомобиль.
hotsale boolean Жоқ - Айтпақшы.
candidateCountOnMp integer · int64 Жоқ Кандидаттар депутатты есептейтін.
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.
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 Жоқ Өнеркәсіптік ID Mp.
clientId integer · int64 Жоқ Клиент танымдығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
candidateCount integer · int64 Жоқ Кандидат граф.
inPromotionCount integer · int64 Жоқ Өнерлеуге қол жеткізу.
auto boolean Жоқ Автомобиль.
hotsale boolean Жоқ - Айтпақшы.
candidateCountOnMp integer · int64 Жоқ Кандидаттар депутатты есептейтін.
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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 Иә Өнерлеу ID.

Сұраныс параметрлері

ӨрісТүріМіндеттіСипаттама
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 Жоқ Өнеркәсіптік ID Mp.
categoryId integer · int64 Жоқ Категория ID.
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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 Жоқ Өнерлеу ID.
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 Жоқ Өнеркәсіптік ID Mp.
categoryId integer · int64 Жоқ Категория ID.
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 FBS комиссиясы.
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 ID.
productId integer · int64 Жоқ Өнімнің идентификаторы.
promotionId integer · int64 Жоқ Өнерлеу ID.
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 Жоқ Тапсырма ID.
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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 Жоқ Өнерлеу ID.
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 Жоқ Өнеркәсіптік ID Mp.
categoryId integer · int64 Жоқ Категория ID.
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.
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 Жоқ Өнеркәсіптік ID Mp.
clientId integer · int64 Жоқ Клиент танымдығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
candidateCount integer · int64 Жоқ Кандидат граф.
inPromotionCount integer · int64 Жоқ Өнерлеуге қол жеткізу.
auto boolean Жоқ Автомобиль.
hotsale boolean Жоқ - Айтпақшы.
candidateCountOnMp integer · int64 Жоқ Кандидаттар депутатты есептейтін.
inPromotionCountOnMp integer · int64 Жоқ Өнеркәсіптік қызмет көрсетуде MP.
{
  "rows": "string"
}
Қателер5

Қолданба қателері JSON, error және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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 Жоқ Өнерлеу ID.
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 Жоқ Өнеркәсіптік ID Mp.
categoryId integer · int64 Жоқ Категория ID.
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 және params-пен JSON ретінде қайтарылады. error-ке тармақ; жергілікті мәтін өзгеруі мүмкін. Қолданба қателерін қайтару ↑

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

Сынақ өтiнiштерiне арналған белгі

Токен осы браузердің локальдық сақтауында қалады және api.selsup.ru-ға Authorization сұраныс басында ғана жіберіледі.

Байқап көру

Шын сұраныс параметрлері

Тікелей API жауап

SelSup жауапын көру үшін сұрау жіберу.