SelSup Developers

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

Жарнамалық кампаниялар

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

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

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

/api/campaign

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

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

01

Жарнамалық кампанияларды қолдануды бастаңыз

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

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

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

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

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

CampaignFilter17 өрістер
limitinteger · int32

Шектеу.

pageinteger · int32

Бет.

countboolean

Санаңыз.

sortBystring

Жарайды.

ascendingboolean

Көтерілу.

statusstring

Status.

campaignStatusstring

Кампанияның жағдайы.

typeinteger · int32

Type.

offsetinteger · int32

Өтемақы.

servicestring

Қызмет.

dateTostring · date-time

Күні бүгін.

dateFromstring · date-time

Күні бойы.

isStatCampaignboolean

- Бұл "Стат" кампаниясы.

dateStartstring · date-time

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

querystring

Сұрақтар.

productExternalIdinteger · int64

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

organizationIdsinteger[]

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

CampaignStatExportRequest4 өрістер
servicestring

Қызмет.

organizationIdinteger · int64

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

organizationIdsinteger[]

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

filterCampaignFilter

Сүзгі.

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.

Campaign22 өрістер
idinteger · int64

Id.

externalIdinteger · int64

Сыртқы ID.

namestring

Есім.

campaignNamestring

Кампания атауы.

typestring

Type.

statusTypestring

Статустық түрі.

productIdinteger · int64

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

externalProductIdinteger · int64

Сыртқы өнім ID.

createDatestring · date-time

Күні құрылсын.

endDatestring · date-time

Соңғы күн.

startDatestring · date-time

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

suminteger · int64

- Сосын.

writeOffTypestring

Жазушыны түрінен тастаңыз.

onPauseboolean

Тындыққа.

clientIdinteger · int64

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

servicestring

Қызмет.

categoryIdinteger · int64

Категория ID.

categoryNamestring

Категория атауы.

campaignTypestring

Кампания түрі.

dateStatImportstring · date-time

Статистикалық импорттың күні.

nmsstring

НМС.

paymentTypestring

Төлем түрі.

WildberriesType32 өрістер
idinteger · int64

Id.

namestring

Есім.

publishedboolean

Жарияланған.

hasSizeboolean

Үлкен.

monoBoxMinQuantityinteger · int32

Моно-бокс Минус мөлшері.

monoTypestring

Моно типті.

monoMinPriceinteger · int32

Моно-мин бағасы.

hasParentboolean

Ата-анасы бар.

parentIdinteger · int64

Ата-ананың жеке куәлігі.

wildberriesIdinteger · int64

Wildberries ID.

lastSyncDatestring · date-time

Соңғы синхрондық дата.

notChangedDaysinteger · int32

Күндері өзгерген жоқ.

commissionnumber · double

Комиссия.

fbsCommissionnumber · double

ФБР комиссиясы.

fbwCommissionnumber · double

ФБР комиссиясы.

dbsCommissionnumber · double

ДБС комиссиясы.

edbsCommissionnumber · double

Эдбс комиссиясы.

cAndCCommissionnumber · double

С және С Комиссия.

bookingCommissionnumber · double

Жазу комиссиясы.

logisticPriceinteger · int32

Логистикалық баға.

storagePricenumber · double

Сақталу бағасы.

acceptancePricenumber · double

Қабылдау бағасы.

needDimensionsboolean

Өлшемі керек.

purchasePercentAvgnumber · double

Сатып алу пайызы Avg.

purchasePercentMinnumber · double

Сатып алу пайызы минутта.

photoAvginteger · int32

Фото АВГ.

photoMininteger · int32

Фото: Ми.

drrAvgnumber · double

Доктор АВГ.

drrMinnumber · double

Доктор Мин.

marginAvgnumber · double

АВГ-ның шегі.

marginMinnumber · double

Маргин Мин.

candCCommissionnumber · double

Комиссия.

CampaignStat4 өрістер
campaignstring

Кампания.

valuenumber · double

Құндылығы.

organizationIdinteger · int64

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

organizationNamestring

Ұйым атауы.

CampaignTotalStats4 өрістер
clicksCampaignStat[]

Кликтер.

viewsCampaignStat[]

Көріністер.

expensesCampaignStat[]

Шығындар.

averageCostCampaignStat[]

Орташа құны.

FindResponseStatCampaign1 өрістер
rowsStatCampaign[]

Сызықтар.

StatCampaign46 өрістер
limitinteger · int32

Шектеу.

pageinteger · int32

Бет.

countboolean

Санаңыз.

sortBystring

Жарайды.

ascendingboolean

Көтерілу.

statCampaignIdinteger · int64

Мемлекеттік сайлау туралы куәлік.

viewsinteger · int32

Көріністер.

clicksinteger · int32

Кликтер.

ratioClicksViewsnumber · double

Кликтер аралығы көріністер.

averageCostnumber · double

Орташа құны.

expensesnumber · double

Шығындар.

quantityAddCartinteger · int32

Қымбатты қосқан кәріз.

quantityOrdersinteger · int32

Кіліктілік тапсырыстар.

ratioOrdersOfVisitsnumber · double

Сапарлар санының көрсеткіші.

quantityProductOrdersinteger · int32

Өнімді тапсырыс көлемі.

ordersAmountnumber · double

Тапсырмалар саны.

campaignIdinteger · int64

Кампания ID.

campaignNamestring

Кампания атауы.

createDatestring · date-time

Күні құрылсын.

servicestring

Қызмет.

campaignTypestring

Кампания түрі.

categoryNamestring

Категория атауы.

externalIdinteger · int64

Сыртқы ID.

productIdinteger · int64

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

productViewIdinteger · int64

Өнімнің көрінісі ID.

datestring · date-time

Кездесу.

startDatestring · date-time

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

endDatestring · date-time

Соңғы күн.

importDatestring · date-time

Импорт күні.

uniqueIdstring

Бірыңғай жеке куәлік.

clientIdinteger · int64

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

organizationIdinteger · int64

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

organizationNamestring

Ұйым атауы.

rowTypestring

Қатарлық тип.

quantityBuyoutsnumber · double

Сандық сатып алу.

revenuenumber · double

Кіріс.

profitFactnumber · double

Пайдалы іс-әрекет.

marginFactnumber · double

Маржинальдық факт.

drrnumber · double

Доктор.

cpsnumber · double

Сп.

quantityBuyoutsForecastnumber · double

Сатып алудың көлемі болжамы.

profitForecastnumber · double

Пайда болжамы.

marginForecastnumber · double

Маржиналды болжау.

allowableExpensesnumber · double

Қолданбалы шығындар.

currencystring

Ақша.

unavailableReasonsobject

Қолда жоқ себептер.

FindResponseCampaign1 өрістер
rowsCampaign[]

Сызықтар.

WbBalance3 өрістер
balanceinteger · int32

Баланс.

netinteger · int32

Желі.

bonusinteger · int32

Бонус.

Қате туралы келісімшарт

Қолданба қателерін қайтару

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"
  }
}

Аяқ нүктелері

Аяқ нүктелері

POST

Жаңырту жағдайы кампаниясы

/api/campaign/updateStatusCampaign
Жазуға қол жеткізуге мүмкіндік беретін белгі

POST /api/campaign/updateStatusCampaign. арқылы Жаңырту жағдайы кампаниясы

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

ӨрісТүріМіндеттіСипаттама
campaignId integer · int64 Иә Кампания ID.
status stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Иә Status.
organizationId integer · int64 Иә Ұйымның жеке куәлігі.
curl --request POST 'https://api.selsup.ru/api/campaign/updateStatusCampaign?campaignId=1001&status=DELETED&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Қателер9

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

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

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

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

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

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

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

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

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

400error_organization_not_found
Ұйым табылмады

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

400error_prepared_integration_not_found
дайындалған интеграция табылмады

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

400error_subscription_expired
Тарифтің қолданылу мерзімі аяқталды. Қызметті пайдалануды жалғастыру үшін тарифті төлеңіз.

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

400error_token_expired_or_revoked
API токені кері қайтарылды немесе дұрыс енгізілмеді. API кілтінің толық функционалы бар екенін тексеріңіз. Жаңа кілт жасап, оны SELSUP-те ауыстырыңыз, себебі кілттердің жарамдылық мерзімі бар.

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

400error_wildberries_api
{message}

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

POST

Экспорттық науқанның статистикасы

/api/campaign/stats/xlsx
Жазуға қол жеткізуге мүмкіндік беретін белгі

POST /api/campaign/stats/xlsx.-ды пайдалана отырып экспорттық кампания статистикасы

Өтініш органы

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

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

200
Нысан өрістері TmsTask
ӨрісТүріМіндеттіСипаттама
id integer · int64 Жоқ 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
}
Қателер9

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

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

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

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

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

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

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

400error_analytics_access_denied
Аналитика деректері SUPPORT рөлі үшін құпия

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

400error_no_marketplace
Маркетплейс көрсетілмеген

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

400error_no_organization
Ұйым көрсетілмеген

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

400error_subscription_expired
Тарифтің қолданылу мерзімі аяқталды. Қызметті пайдалануды жалғастыру үшін тарифті төлеңіз.

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

400error_unsupported_service
Қызмет қолдау көрсетілмейді

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

400error_user_does_not_have_this_organization
Пайдаланушының осы ұйымға қолжетімділігі жоқ

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

POST

Кампания құру

/api/campaign/createCampaign
Жазуға қол жеткізуге мүмкіндік беретін белгі

POST /api/campaign/createCampaign. арқылы Кампания құру

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

ӨрісТүріМіндеттіСипаттама
organizationId integer · int64 Иә Ұйымның жеке куәлігі.

Өтініш органы

application/json
Нысан өрістеріCampaign
ӨрісТүріМіндеттіСипаттама
id integer · int64 Жоқ Id.
externalId integer · int64 Жоқ Сыртқы ID.
name string Жоқ Есім.
campaignName string Жоқ Кампания атауы.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Жоқ Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Жоқ Статустық түрі.
productId integer · int64 Жоқ Өнімнің идентификаторы.
externalProductId integer · int64 Жоқ Сыртқы өнім ID.
createDate string · date-time Жоқ Күні құрылсын.
endDate string · date-time Жоқ Соңғы күн.
startDate string · date-time Жоқ Басталу күні.
sum integer · int64 Жоқ - Сосын.
writeOffType stringBALANCE, NET, BONUS Жоқ Жазушыны түрінен тастаңыз.
onPause boolean Жоқ Тындыққа.
clientId 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 Жоқ Қызмет.
categoryId integer · int64 Жоқ Категория ID.
categoryName string Жоқ Категория атауы.
campaignType string Жоқ Кампания түрі.
dateStatImport string · date-time Жоқ Статистикалық импорттың күні.
nms string Жоқ НМС.
paymentType string Жоқ Төлем түрі.
curl --request POST 'https://api.selsup.ru/api/campaign/createCampaign?organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}'

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

200
Нысан өрістері Campaign
ӨрісТүріМіндеттіСипаттама
id integer · int64 Жоқ Id.
externalId integer · int64 Жоқ Сыртқы ID.
name string Жоқ Есім.
campaignName string Жоқ Кампания атауы.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Жоқ Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Жоқ Статустық түрі.
productId integer · int64 Жоқ Өнімнің идентификаторы.
externalProductId integer · int64 Жоқ Сыртқы өнім ID.
createDate string · date-time Жоқ Күні құрылсын.
endDate string · date-time Жоқ Соңғы күн.
startDate string · date-time Жоқ Басталу күні.
sum integer · int64 Жоқ - Сосын.
writeOffType stringBALANCE, NET, BONUS Жоқ Жазушыны түрінен тастаңыз.
onPause boolean Жоқ Тындыққа.
clientId 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 Жоқ Қызмет.
categoryId integer · int64 Жоқ Категория ID.
categoryName string Жоқ Категория атауы.
campaignType string Жоқ Кампания түрі.
dateStatImport string · date-time Жоқ Статистикалық импорттың күні.
nms string Жоқ НМС.
paymentType string Жоқ Төлем түрі.
{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}
Қателер10

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

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

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

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

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

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

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

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

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

400error_organization_not_found
Ұйым табылмады

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

400error_prepared_integration_not_found
дайындалған интеграция табылмады

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

400error_service_not_supported
Қызмет қолдау көрсетпейді

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

400error_subscription_expired
Тарифтің қолданылу мерзімі аяқталды. Қызметті пайдалануды жалғастыру үшін тарифті төлеңіз.

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

400error_token_expired_or_revoked
API токені кері қайтарылды немесе дұрыс енгізілмеді. API кілтінің толық функционалы бар екенін тексеріңіз. Жаңа кілт жасап, оны SELSUP-те ауыстырыңыз, себебі кілттердің жарамдылық мерзімі бар.

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

400error_wildberries_api
{message}

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

GET

Импорттық науқандар

/api/campaign/updateCampaigns
Оқуға қол жеткізуге мүмкіндік беретін белгі

GET /api/campaign/updateCampaigns.-ды пайдалана отырып импорттық кампаниялар

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

ӨрісТүріМіндеттіСипаттама
organizationId 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 Иә Қызмет.
curl --request GET 'https://api.selsup.ru/api/campaign/updateCampaigns?organizationId=1001&service=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
}
Қателер5

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

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

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

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

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

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

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

400error_analytics_access_denied
Аналитика деректері SUPPORT рөлі үшін құпия

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

400error_unsupported_service
Қызмет қолдау көрсетілмейді

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

GET

Жаңа жүктеу кампаниясы статистикасы

/api/campaign/reloadCampaignStats
Оқуға қол жеткізуге мүмкіндік беретін белгі

GET /api/campaign/reloadCampaignStats. арқылы кампания статистикасын қайта жүктеу

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

ӨрісТүріМіндеттіСипаттама
dateFrom string · date Иә Күні бойы.
dateTo string · date Иә Күні бүгін.
organizationId integer · int64 Иә Ұйымның жеке куәлігі.
isExpensesOnly 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 Иә Қызмет.
curl --request GET 'https://api.selsup.ru/api/campaign/reloadCampaignStats?dateFrom=2026-01-15&dateTo=2026-01-15&organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

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

Қателер3

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

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

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

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

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

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

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

GET

"Жайлы жеміс" тақырыбын алыңыз

/api/campaign/getWildberriesSubjects
Оқуға қол жеткізуге мүмкіндік беретін белгі

GET /api/campaign/getWildberriesSubjects. арқылы Wildberries Subjects алуға болады

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

ӨрісТүріМіндеттіСипаттама
query string Иә Сұрақтар.
limit integer · int32 Иә Шектеу.
organizationId integer · int64 Иә Ұйымның жеке куәлігі.
curl --request GET 'https://api.selsup.ru/api/campaign/getWildberriesSubjects?query=string&limit=50&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Сызық элементтерінің құрылымы WildberriesType[]
ӨрісТүріМіндеттіСипаттама
id integer · int64 Жоқ Id.
name string Жоқ Есім.
published boolean Жоқ Жарияланған.
hasSize boolean Жоқ Үлкен.
monoBoxMinQuantity integer · int32 Жоқ Моно-бокс Минус мөлшері.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Жоқ Моно типті.
monoMinPrice integer · int32 Жоқ Моно-мин бағасы.
hasParent boolean Жоқ Ата-анасы бар.
parentId integer · int64 Жоқ Ата-ананың жеке куәлігі.
wildberriesId integer · int64 Жоқ Wildberries ID.
lastSyncDate string · date-time Жоқ Соңғы синхрондық дата.
notChangedDays integer · int32 Жоқ Күндері өзгерген жоқ.
commission number · double Жоқ Комиссия.
fbsCommission number · double Жоқ ФБР комиссиясы.
fbwCommission number · double Жоқ ФБР комиссиясы.
dbsCommission number · double Жоқ ДБС комиссиясы.
edbsCommission number · double Жоқ Эдбс комиссиясы.
cAndCCommission number · double Жоқ С және С Комиссия.
bookingCommission number · double Жоқ Жазу комиссиясы.
logisticPrice integer · int32 Жоқ Логистикалық баға.
storagePrice number · double Жоқ Сақталу бағасы.
acceptancePrice number · double Жоқ Қабылдау бағасы.
needDimensions boolean Жоқ Өлшемі керек.
purchasePercentAvg number · double Жоқ Сатып алу пайызы Avg.
purchasePercentMin number · double Жоқ Сатып алу пайызы минутта.
photoAvg integer · int32 Жоқ Фото АВГ.
photoMin integer · int32 Жоқ Фото: Ми.
drrAvg number · double Жоқ Доктор АВГ.
drrMin number · double Жоқ Доктор Мин.
marginAvg number · double Жоқ АВГ-ның шегі.
marginMin number · double Жоқ Маргин Мин.
candCCommission number · double Жоқ Комиссия.
[
  "string"
]
Қателер7

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

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

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

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

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

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

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

400error_organization_not_found
Ұйым табылмады

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

400error_prepared_integration_not_found
дайындалған интеграция табылмады

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

400error_subscription_expired
Тарифтің қолданылу мерзімі аяқталды. Қызметті пайдалануды жалғастыру үшін тарифті төлеңіз.

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

400error_token_expired_or_revoked
API токені кері қайтарылды немесе дұрыс енгізілмеді. API кілтінің толық функционалы бар екенін тексеріңіз. Жаңа кілт жасап, оны SELSUP-те ауыстырыңыз, себебі кілттердің жарамдылық мерзімі бар.

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

GET

Тоталь Статистикалық Кампанияларды алу

/api/campaign/getTotalStatCampaigns
Оқуға қол жеткізуге мүмкіндік беретін белгі

GET /api/campaign/getTotalStatCampaigns. арқылы жалпы статистиканы алу

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

ӨрісТүріМіндеттіСипаттама
organizationId 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 Иә Қызмет.
status string Жоқ Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Жоқ Кампанияның жағдайы.
type integer · int32 Жоқ Type.
offset integer · int32 Жоқ Өтемақы.
dateTo string · date-time Жоқ Күні бүгін.
dateFrom string · date-time Жоқ Күні бойы.
isStatCampaign boolean Жоқ - Бұл "Стат" кампаниясы.
dateStart string · date-time Жоқ Күні басталады.
query string Жоқ Сұрақтар.
productExternalId integer · int64 Жоқ Өнімнің сыртқы идентификаторы.
organizationIds integer[] Жоқ Ұйымның жеке куәліктері.
limit integer · int32 Жоқ Шектеу.
page integer · int32 Жоқ Бет.
count boolean Жоқ Санаңыз.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Жоқ Жарайды.
ascending boolean Жоқ Көтерілу.
topN integer · int32 Иә Жоғарғы N.
curl --request GET 'https://api.selsup.ru/api/campaign/getTotalStatCampaigns?service=NONE&limit=50&page=1&topN=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Нысан өрістері CampaignTotalStats
ӨрісТүріМіндеттіСипаттама
clicks CampaignStat[] Жоқ Кликтер.
Сызық элементтерінің құрылымы CampaignStat
ӨрісТүріМіндеттіСипаттама
campaign string Жоқ Кампания.
value number · double Жоқ Құндылығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
organizationName string Жоқ Ұйым атауы.
views CampaignStat[] Жоқ Көріністер.
Сызық элементтерінің құрылымы CampaignStat
ӨрісТүріМіндеттіСипаттама
campaign string Жоқ Кампания.
value number · double Жоқ Құндылығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
organizationName string Жоқ Ұйым атауы.
expenses CampaignStat[] Жоқ Шығындар.
Сызық элементтерінің құрылымы CampaignStat
ӨрісТүріМіндеттіСипаттама
campaign string Жоқ Кампания.
value number · double Жоқ Құндылығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
organizationName string Жоқ Ұйым атауы.
averageCost CampaignStat[] Жоқ Орташа құны.
Сызық элементтерінің құрылымы CampaignStat
ӨрісТүріМіндеттіСипаттама
campaign string Жоқ Кампания.
value number · double Жоқ Құндылығы.
organizationId integer · int64 Жоқ Ұйымның жеке куәлігі.
organizationName string Жоқ Ұйым атауы.
{
  "clicks": "string",
  "views": "string",
  "expenses": "string",
  "averageCost": "string"
}
Қателер3

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

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

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

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

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

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

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

GET

Статистикалық кампанияларды алыңыз

/api/campaign/getStatCampaigns
Оқуға қол жеткізуге мүмкіндік беретін белгі

GET /api/campaign/getStatCampaigns. арқылы Stat кампанияларын алу

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

ӨрісТүріМіндеттіСипаттама
organizationId 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 Иә Қызмет.
status string Жоқ Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Жоқ Кампанияның жағдайы.
type integer · int32 Жоқ Type.
offset integer · int32 Жоқ Өтемақы.
dateTo string · date-time Жоқ Күні бүгін.
dateFrom string · date-time Жоқ Күні бойы.
isStatCampaign boolean Жоқ - Бұл "Стат" кампаниясы.
dateStart string · date-time Жоқ Күні басталады.
query string Жоқ Сұрақтар.
productExternalId integer · int64 Жоқ Өнімнің сыртқы идентификаторы.
organizationIds integer[] Жоқ Ұйымның жеке куәліктері.
limit integer · int32 Жоқ Шектеу.
page integer · int32 Жоқ Бет.
count boolean Жоқ Санаңыз.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Жоқ Жарайды.
ascending boolean Жоқ Көтерілу.
curl --request GET 'https://api.selsup.ru/api/campaign/getStatCampaigns?service=NONE&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

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

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

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

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

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

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

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

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

GET

Акциялар жасаңыз

/api/campaign/getCampaigns
Оқуға қол жеткізуге мүмкіндік беретін белгі

GET /api/campaign/getCampaigns. арқылы кампанияларды алу

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

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

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

200
Нысан өрістері FindResponseCampaign
ӨрісТүріМіндеттіСипаттама
rows Campaign[] Жоқ Сызықтар.
Сызық элементтерінің құрылымы Campaign
ӨрісТүріМіндеттіСипаттама
id integer · int64 Жоқ Id.
externalId integer · int64 Жоқ Сыртқы ID.
name string Жоқ Есім.
campaignName string Жоқ Кампания атауы.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Жоқ Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Жоқ Статустық түрі.
productId integer · int64 Жоқ Өнімнің идентификаторы.
externalProductId integer · int64 Жоқ Сыртқы өнім ID.
createDate string · date-time Жоқ Күні құрылсын.
endDate string · date-time Жоқ Соңғы күн.
startDate string · date-time Жоқ Басталу күні.
sum integer · int64 Жоқ - Сосын.
writeOffType stringBALANCE, NET, BONUS Жоқ Жазушыны түрінен тастаңыз.
onPause boolean Жоқ Тындыққа.
clientId 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 Жоқ Қызмет.
categoryId integer · int64 Жоқ Категория ID.
categoryName string Жоқ Категория атауы.
campaignType string Жоқ Кампания түрі.
dateStatImport string · date-time Жоқ Статистикалық импорттың күні.
nms string Жоқ НМС.
paymentType string Жоқ Төлем түрі.
{
  "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/campaign/getCampaignBalance
Оқуға қол жеткізуге мүмкіндік беретін белгі

GET /api/campaign/getCampaignBalance. арқылы кампаниялық балансты алу

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

ӨрісТүріМіндеттіСипаттама
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Иә Қызмет.
organizationId integer · int64 Иә Ұйымның жеке куәлігі.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaignBalance?service=NONE&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Нысан өрістері WbBalance
ӨрісТүріМіндеттіСипаттама
balance integer · int32 Жоқ Баланс.
net integer · int32 Жоқ Желі.
bonus integer · int32 Жоқ Бонус.
{
  "balance": 1,
  "net": 1,
  "bonus": 1
}
Қателер7

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

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

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

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

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

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

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

400error_organization_not_found
Ұйым табылмады

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

400error_service_not_supported
Қызмет қолдау көрсетпейді

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

400error_subscription_expired
Тарифтің қолданылу мерзімі аяқталды. Қызметті пайдалануды жалғастыру үшін тарифті төлеңіз.

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

400error_token_expired_or_revoked
API токені кері қайтарылды немесе дұрыс енгізілмеді. API кілтінің толық функционалы бар екенін тексеріңіз. Жаңа кілт жасап, оны SELSUP-те ауыстырыңыз, себебі кілттердің жарамдылық мерзімі бар.

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

Authorization

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

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

Байқап көру

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

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

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