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[]

Уюмдун ID-чөнтөкчөлөрү.

CampaignStatExportRequest4 аймактар
servicestring

Кызмат.

organizationIdinteger · int64

Уюмдун идентификатору.

organizationIdsinteger[]

Уюмдун ID-чөнтөкчөлөрү.

filterCampaignFilter

Фильтр.

TmsTask25 аймактар
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

Аты.

clientIdinteger · int64

Кардар ID.

entityIdinteger · int64

Уюмдун ID.

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

Тышкы идентификация.

namestring

Аты.

campaignNamestring

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

typestring

Type.

statusTypestring

Мамлекеттик абал.

productIdinteger · int64

Продукт ID.

externalProductIdinteger · int64

Тышкы продукт ID.

createDatestring · date-time

Тагдыр түзүү.

endDatestring · date-time

Акыркы дата.

startDatestring · date-time

Баштоо күнү.

suminteger · int64

Топтоп.

writeOffTypestring

Жазылбай кой.

onPauseboolean

Тынчтык боюнча.

clientIdinteger · int64

Кардар ID.

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

C жана CКомиссия.

bookingCommissionnumber · double

Токтоолор комиссиясы.

logisticPriceinteger · int32

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

storagePricenumber · double

Сатып алуу баасы.

acceptancePricenumber · double

Кабыл алуу баасы.

needDimensionsboolean

Өлчөмдөр керек.

purchasePercentAvgnumber · double

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

purchasePercentMinnumber · double

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

photoAvginteger · int32

Сүрөт Avg.

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

Мамлекеттик өнөктүк ID.

viewsinteger · int32

Көрсөтүүлөр.

clicksinteger · int32

Клик.

ratioClicksViewsnumber · double

Кликтеринин көрсөткүчтөрү.

averageCostnumber · double

Орточо баа.

expensesnumber · double

Чыгымдар.

quantityAddCartinteger · int32

Кошумча сандар.

quantityOrdersinteger · int32

Сапат берүү.

ratioOrdersOfVisitsnumber · double

Саналуулардын тартиби.

quantityProductOrdersinteger · int32

Продукциянын көлөмү

ordersAmountnumber · double

Буйруктардын саны.

campaignIdinteger · int64

Өнөктөштүк ID.

campaignNamestring

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

createDatestring · date-time

Тагдыр түзүү.

servicestring

Кызмат.

campaignTypestring

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

categoryNamestring

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

externalIdinteger · int64

Тышкы идентификация.

productIdinteger · int64

Продукт ID.

productViewIdinteger · int64

Продукциянын ID көрүңүз.

datestring · date-time

Келишим.

startDatestring · date-time

Баштоо күнү.

endDatestring · date-time

Акыркы дата.

importDatestring · date-time

Импорттоо күнү.

uniqueIdstring

Өзгөчө идентификация.

clientIdinteger · int64

Кардар ID.

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"
  }
}
KYКыргызча (ky)
{
  "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
Клиент не найден или был удален. Напишите в поддержку

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_client кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_organization_not_found
Уюм табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_organization_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_prepared_integration_not_found
даярдалган интеграция табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_prepared_integration_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Endpoint-specific error. Колдонмо логикасында туруктуу error_subscription_expired кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

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

Endpoint-specific error. Колдонмо логикасында туруктуу error_token_expired_or_revoked кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_wildberries_api
{message}

Endpoint-specific 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[] Жок Уюмдун ID-чөнтөкчөлөрү.
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[] Жок Уюмдун ID-чөнтөкчөлөрү.
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 Жок Кардар ID.
entityId integer · int64 Жок Уюмдун ID.
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 ролу үчүн купуя

Endpoint-specific error. Колдонмо логикасында туруктуу error_analytics_access_denied кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_no_marketplace
Маркетплейс көрсөтүлгөн жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_marketplace кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_no_organization
Уюм көрсөтүлгөн эмес

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_organization кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Endpoint-specific error. Колдонмо логикасында туруктуу error_subscription_expired кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_unsupported_service
Кызмат колдоого алынбайт

Endpoint-specific error. Колдонмо логикасында туруктуу error_unsupported_service кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_user_does_not_have_this_organization
Колдонуучунун уюмга кирүү укугу жок

Endpoint-specific 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 Жок Тышкы идентификация.
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 Жок Продукт ID.
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 Жок Кардар 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 Жок Кызмат.
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 Жок Тышкы идентификация.
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 Жок Продукт ID.
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 Жок Кардар 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 Жок Кызмат.
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
Клиент не найден или был удален. Напишите в поддержку

Endpoint-specific error. Колдонмо логикасында туруктуу error_no_client кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_organization_not_found
Уюм табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_organization_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_prepared_integration_not_found
даярдалган интеграция табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_prepared_integration_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_service_not_supported
Сервис колдонулбайт

Endpoint-specific error. Колдонмо логикасында туруктуу error_service_not_supported кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Endpoint-specific error. Колдонмо логикасында туруктуу error_subscription_expired кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

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

Endpoint-specific error. Колдонмо логикасында туруктуу error_token_expired_or_revoked кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_wildberries_api
{message}

Endpoint-specific 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 Жок Кардар ID.
entityId integer · int64 Жок Уюмдун ID.
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 ролу үчүн купуя

Endpoint-specific error. Колдонмо логикасында туруктуу error_analytics_access_denied кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_unsupported_service
Кызмат колдоого алынбайт

Endpoint-specific 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 Жок C жана CКомиссия.
bookingCommission number · double Жок Токтоолор комиссиясы.
logisticPrice integer · int32 Жок Логистикалык баа.
storagePrice number · double Жок Сатып алуу баасы.
acceptancePrice number · double Жок Кабыл алуу баасы.
needDimensions boolean Жок Өлчөмдөр керек.
purchasePercentAvg number · double Жок Сатып алуу пайызын Avg.
purchasePercentMin number · double Жок Сатып алуу пайыздары минус.
photoAvg integer · int32 Жок Сүрөт Avg.
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
Уюм табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_organization_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_prepared_integration_not_found
даярдалган интеграция табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_prepared_integration_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Endpoint-specific error. Колдонмо логикасында туруктуу error_subscription_expired кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

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

Endpoint-specific 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[] Жок Уюмдун ID-чөнтөкчөлөрү.
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[] Жок Уюмдун ID-чөнтөкчөлөрү.
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 Жок Мамлекеттик өнөктүк ID.
views integer · int32 Жок Көрсөтүүлөр.
clicks integer · int32 Жок Клик.
ratioClicksViews number · double Жок Кликтеринин көрсөткүчтөрү.
averageCost number · double Жок Орточо баа.
expenses number · double Жок Чыгымдар.
quantityAddCart integer · int32 Жок Кошумча сандар.
quantityOrders integer · int32 Жок Сапат берүү.
ratioOrdersOfVisits number · double Жок Саналуулардын тартиби.
quantityProductOrders integer · int32 Жок Продукциянын көлөмү
ordersAmount number · double Жок Буйруктардын саны.
campaignId integer · int64 Жок Өнөктөштүк ID.
campaignName string Жок Кампаниянын аты.
createDate string · date-time Жок Тагдыр түзүү.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Жок Кызмат.
campaignType stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Жок Кампаниянын түрү.
categoryName string Жок Категориянын аты.
externalId integer · int64 Жок Тышкы идентификация.
productId integer · int64 Жок Продукт ID.
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 Жок Кардар ID.
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[] Жок Уюмдун ID-чөнтөкчөлөрү.
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 Жок Тышкы идентификация.
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 Жок Продукт ID.
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 Жок Кардар 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 Жок Кызмат.
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
Клиент не найден или был удален. Напишите в поддержку

Endpoint-specific 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
Уюм табылган жок

Endpoint-specific error. Колдонмо логикасында туруктуу error_organization_not_found кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_service_not_supported
Сервис колдонулбайт

Endpoint-specific error. Колдонмо логикасында туруктуу error_service_not_supported кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

400error_subscription_expired
Тарифиңиздин мөөнөтү бүттү. Кызматты колдонууну улантуу үчүн тарифти төлөңүз.

Endpoint-specific error. Колдонмо логикасында туруктуу error_subscription_expired кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

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

Endpoint-specific error. Колдонмо логикасында туруктуу error_token_expired_or_revoked кодун колдонуңуз; localMessage жогоруда көрсөтүлгөн котормону камтыйт.

Authorization

Сынак өтүнүчтөрү үчүн белги

Токен бул браузердин локалдык сактагычында калат жана API.selsup.ru сайтына Authorization өтүнүч башкычасында гана жөнөтүлөт.

Байкап көрүү

Чыныгы өтүнүч параметрлери

API түздөн-түз жооп

SelSup жоопту көрүү үчүн өтүнүч жөнөтүү.