SelSup Developers

Public API · API Reference

Promotions

Endpoints for Promotions, including exact routes, parameters, request bodies, and expandable response schemas.

11 endpoints/api/promotionStableMachine-readable description ↗
{ }

This page is backed by an editable standalone contract. Validate write operations with test data before production use.

/api/promotion

Ready-to-use workflows

Ready-to-use workflows

01

Start using Promotions

Use a dedicated API token and validate read operations with test data first.

  1. Keep the token server-side and send it in the Authorization header.
  2. Check required parameters and expand the request or response schema.
  3. Handle the HTTP status and the stable error field in application errors.

Data model

Data structures

Models are listed once here and can also be expanded directly from the endpoints that use them.

Promotion21 fields
promotionIdinteger · int64

Promotion Id.

idinteger · int64

Id.

totalCountinteger · int64

Total Count.

namestring

Name.

dateStartstring · date-time

Date Start.

dateEndstring · date-time

Date End.

changeCommissionboolean

Change Commission.

changeCommissionAmountnumber · double

Change Commission Amount.

createdDatestring · date-time

Created Date.

servicestring

Service.

isDeletedboolean

Is Deleted.

descriptionstring

Description.

promotionIdOnMpstring

Promotion Id On Mp.

clientIdinteger · int64

Client Id.

organizationIdinteger · int64

Organization Id.

candidateCountinteger · int64

Candidate Count.

inPromotionCountinteger · int64

In Promotion Count.

autoboolean

Auto.

hotsaleboolean

Hotsale.

candidateCountOnMpinteger · int64

Candidate Count On Mp.

inPromotionCountOnMpinteger · int64

In Promotion Count On Mp.

TmsTask25 fields
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

Name.

clientIdinteger · int64

Client Id.

entityIdinteger · int64

Entity Id.

progressinteger · int32

Progress.

processedQuantityinteger · int32

Processed Quantity.

organizationIdinteger · int64

Organization Id.

priorityinteger · int32

Priority.

propertiesstring

Properties.

messagestring

Message.

messageParamsstring

Message Params.

createdDatestring · date-time

Created Date.

startDatestring · date-time

Start Date.

finishDatestring · date-time

Finish Date.

urlstring

Url.

inputFileUrlstring

Input File Url.

retryNumberinteger · int32

Retry Number.

userIdinteger · int32

User Id.

retryDatestring · date-time

Retry Date.

debugboolean

Debug.

forcedStartboolean

Forced Start.

servicestring

Service.

langstring

Lang.

ProductPromotion91 fields
categoryNamestring

Category Name.

brandNamestring

Brand Name.

subjectstring

Subject.

purchasePricenumber · double

Purchase Price.

deliveryCostnumber · double

Delivery Cost.

additionalCostnumber · double

Additional Cost.

barcodestring

Barcode.

instockQuantityinteger · int64

Instock Quantity.

wildberriesStockCountinteger · int64

Wildberries Stock Count.

yandexMarketStockCountinteger · int64

Yandex Market Stock Count.

createdDatestring · date-time

Created Date.

minPricenumber · double

Min Price.

isDuplicateboolean

Is Duplicate.

ozonArticlestring

Ozon Article.

ozonStockCountinteger · int64

Ozon Stock Count.

salesExpensesOnMpPercentnumber · double

Sales Expenses On Mp Percent.

taxeRatenumber · double

Taxe Rate.

widthinteger · int32

Width.

heightinteger · int32

Height.

depthinteger · int32

Depth.

ozonPurchasePercentnumber · double

Ozon Purchase Percent.

warehouseRationumber · double

Warehouse Ratio.

wildberriesCommissionnumber · double

Wildberries Commission.

wildberriesFbwCommissionnumber · double

Wildberries Fbw Commission.

wildberriesFbsCommissionnumber · double

Wildberries Fbs Commission.

wildberriesDbsCommissionnumber · double

Wildberries Dbs Commission.

wildberriesEdbsCommissionnumber · double

Wildberries Edbs Commission.

wildberriesCAndCCommissionnumber · double

Wildberries CAnd CCommission.

wildberriesBookingCommissionnumber · double

Wildberries Booking Commission.

wildberriesAdditionalExpensesnumber · double

Wildberries Additional Expenses.

ozonAdditionalExpensesnumber · double

Ozon Additional Expenses.

ozonCommissionnumber · double

Ozon Commission.

wildberriesIdinteger · int64

Wildberries Id.

productIdinteger · int64

Product Id.

promotionIdinteger · int64

Promotion Id.

ozonFbsCommissionnumber · double

Ozon Fbs Commission.

ozonFboCommissionnumber · double

Ozon Fbo Commission.

servicestring

Service.

acquiringPercentnumber · double

Acquiring Percent.

currentPricenumber · double

Current Price.

currentPriceWithoutDiscountnumber · double

Current Price Without Discount.

plannedPricenumber · double

Planned Price.

totalStockCountinteger · int64

Total Stock Count.

commissionReductionnumber · double

Commission Reduction.

profitDifferencenumber · double

Profit Difference.

marginDifferencenumber · double

Margin Difference.

markupDifferencenumber · double

Markup Difference.

plannedAndMinPriceDiffnumber · double

Planned And Min Price Diff.

incomeDifferencenumber · double

Income Difference.

currentDiscountnumber · double

Current Discount.

productCreatedDatestring · date-time

Product Created Date.

mainImageUrlstring

Main Image Url.

isProfitablyboolean

Is Profitably.

taskIdinteger · int64

Task Id.

serviceArticlestring

Service Article.

articlestring

Article.

daysCountOnServiceinteger · int32

Days Count On Service.

turnoverinteger · int32

Turnover.

fboStockinteger · int32

Fbo Stock.

fbsStockinteger · int32

Fbs Stock.

newDiscountForPromotionnumber · double

New Discount For Promotion.

saleLogisticsnumber · double

Sale Logistics.

returnLogisticsnumber · double

Return Logistics.

purchasePercentnumber · double

Purchase Percent.

totalLogisticsnumber · double

Total Logistics.

commissionsnumber · double

Commissions.

currentProfitnumber · double

Current Profit.

promotionProfitnumber · double

Promotion Profit.

currentMarginalitynumber · double

Current Marginality.

promotionMarginalitynumber · double

Promotion Marginality.

currentMarkUpnumber · double

Current Mark Up.

promotionMarkUpnumber · double

Promotion Mark Up.

additionalDiscountForPromotionRubnumber · double

Additional Discount For Promotion Rub.

additionalDiscountForPromotionPercentnumber · double

Additional Discount For Promotion Percent.

isDeletedboolean

Is Deleted.

organizationIdinteger · int64

Organization Id.

clientIdinteger · int64

Client Id.

addModestring

Add Mode.

ozonAverageExpensesnumber · double

Ozon Average Expenses.

isActiveboolean

Is Active.

changeNamestring

Change Name.

changeDatestring · date-time

Change Date.

productNamestring

Product Name.

idinteger · int64

Id.

totalCountinteger · int64

Total Count.

serviceCardstring

Service Card.

isNotFoundboolean

Is Not Found.

isArchivedboolean

Is Archived.

productCommissionsstring

Product Commissions.

currentGrossProfitnumber · double

Current Gross Profit.

plannedGrossProfitnumber · double

Planned Gross Profit.

OzonProduct4 fields
product_idinteger · int64

Product id.

action_pricenumber · double

Action price.

stockinteger · int32

Stock.

reasonstring

Reason.

FindResponseProductPromotion1 fields
rowsProductPromotion[]

Rows.

FindResponsePromotion1 fields
rowsPromotion[]

Rows.

Error contract

How application errors are returned

The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.

error

Stable machine-readable code for integration logic.

localMessage

Display-ready message in the API token user's language.

params

Values interpolated by the server into the localized message template.

localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.

RUUser locale is ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENUser locale is en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Endpoints

Endpoints

PUT

Put Promotion

/api/promotion/{promotionId}
Token with write access

Put Promotion using PUT /api/promotion/{promotionId}.

Request body

application/json
Object fieldsPromotion
FieldTypeRequiredDescription
promotionId integer · int64 No Promotion Id.
id integer · int64 No Id.
totalCount integer · int64 No Total Count.
name string No Name.
dateStart string · date-time No Date Start.
dateEnd string · date-time No Date End.
changeCommission boolean No Change Commission.
changeCommissionAmount number · double No Change Commission Amount.
createdDate string · date-time No Created Date.
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 No Service.
isDeleted boolean No Is Deleted.
description string No Description.
promotionIdOnMp string No Promotion Id On Mp.
clientId integer · int64 No Client Id.
organizationId integer · int64 No Organization Id.
candidateCount integer · int64 No Candidate Count.
inPromotionCount integer · int64 No In Promotion Count.
auto boolean No Auto.
hotsale boolean No Hotsale.
candidateCountOnMp integer · int64 No Candidate Count On Mp.
inPromotionCountOnMp integer · int64 No In Promotion Count On Mp.
curl --request PUT 'https://api.selsup.ru/api/promotion/%7BpromotionId%7D' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}'

Success response

200
Object fields Promotion
FieldTypeRequiredDescription
promotionId integer · int64 No Promotion Id.
id integer · int64 No Id.
totalCount integer · int64 No Total Count.
name string No Name.
dateStart string · date-time No Date Start.
dateEnd string · date-time No Date End.
changeCommission boolean No Change Commission.
changeCommissionAmount number · double No Change Commission Amount.
createdDate string · date-time No Created Date.
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 No Service.
isDeleted boolean No Is Deleted.
description string No Description.
promotionIdOnMp string No Promotion Id On Mp.
clientId integer · int64 No Client Id.
organizationId integer · int64 No Organization Id.
candidateCount integer · int64 No Candidate Count.
inPromotionCount integer · int64 No In Promotion Count.
auto boolean No Auto.
hotsale boolean No Hotsale.
candidateCountOnMp integer · int64 No Candidate Count On Mp.
inPromotionCountOnMp integer · int64 No In Promotion Count On Mp.
{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}
Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

PATCH

Restore Promotion By Id

/api/promotion/{promotionId}
Token with write access

Restore Promotion By Id using PATCH /api/promotion/{promotionId}.

Path parameters

FieldTypeRequiredDescription
promotionId integer · int64 Yes Promotion Id.
curl --request PATCH 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

DELETE

Delete Promotion By Id

/api/promotion/{promotionId}
Token with write access

Delete Promotion By Id using DELETE /api/promotion/{promotionId}.

Path parameters

FieldTypeRequiredDescription
promotionId integer · int64 Yes Promotion Id.
curl --request DELETE 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200

The response has no body.

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Update

/api/promotion/update/{service}
Token with write access

Update using POST /api/promotion/update/{service}.

Path parameters

FieldTypeRequiredDescription
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 Yes Service.

Query parameters

FieldTypeRequiredDescription
organizationId integer · int64 No Organization Id.
curl --request POST 'https://api.selsup.ru/api/promotion/update/NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields TmsTask
FieldTypeRequiredDescription
id integer · int64 No Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION No 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 No Type.
name string No Name.
clientId integer · int64 No Client Id.
entityId integer · int64 No Entity Id.
progress integer · int32 No Progress.
processedQuantity integer · int32 No Processed Quantity.
organizationId integer · int64 No Organization Id.
priority integer · int32 No Priority.
properties string No Properties.
message string No Message.
messageParams string No Message Params.
createdDate string · date-time No Created Date.
startDate string · date-time No Start Date.
finishDate string · date-time No Finish Date.
url string No Url.
inputFileUrl string No Input File Url.
retryNumber integer · int32 No Retry Number.
userId integer · int32 No User Id.
retryDate string · date-time No Retry Date.
debug boolean No Debug.
forcedStart boolean No Forced Start.
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 No Service.
lang string No Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Errors36

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_cannot_deleted_order_product
It is impossible to delete a product to which products placed in the warehouse or labels that have not been decommissioned are linked

Endpoint-specific error. Use the stable error_cannot_deleted_order_product code in application logic; localMessage contains the translation shown above.

400error_competitor_id_required
Competitor id is required

Endpoint-specific error. Use the stable error_competitor_id_required code in application logic; localMessage contains the translation shown above.

400error_competitor_required
Competitor is required

Endpoint-specific error. Use the stable error_competitor_required code in application logic; localMessage contains the translation shown above.

400error_competitor_service_required
Competitor service is required

Endpoint-specific error. Use the stable error_competitor_service_required code in application logic; localMessage contains the translation shown above.

400error_competitor_url_required
Competitor URL is required

Endpoint-specific error. Use the stable error_competitor_url_required code in application logic; localMessage contains the translation shown above.

400error_customer_not_found
Customer not found

Endpoint-specific error. Use the stable error_customer_not_found code in application logic; localMessage contains the translation shown above.

400error_duplicate_order_product
Two identical items {productId}were added to the order

Endpoint-specific error. Use the stable error_duplicate_order_product code in application logic; localMessage contains the translation shown above.

400error_empty_warehouse
Warehouse not specified

Endpoint-specific error. Use the stable error_empty_warehouse code in application logic; localMessage contains the translation shown above.

400error_group_already_exist
Group already exists

Endpoint-specific error. Use the stable error_group_already_exist code in application logic; localMessage contains the translation shown above.

400error_incorrect_order_data
Unable to create order because the organization, warehouse, or user has already been deleted: {id}

Endpoint-specific error. Use the stable error_incorrect_order_data code in application logic; localMessage contains the translation shown above.

400error_invalid_url
Incorrect site address, it must start with http:// or https://, it is forbidden to include the word selsup, localhost in the address

Endpoint-specific error. Use the stable error_invalid_url code in application logic; localMessage contains the translation shown above.

400error_moy_sklad_organization
organization in MoySklad not found

Endpoint-specific error. Use the stable error_moy_sklad_organization code in application logic; localMessage contains the translation shown above.

400error_ms_error
MoySklad API error: {message}

Endpoint-specific error. Use the stable error_ms_error code in application logic; localMessage contains the translation shown above.

400error_ms_no_warehouse
The connection of the SelSup warehouse with MoySklad warehouse is not specified

Endpoint-specific error. Use the stable error_ms_no_warehouse code in application logic; localMessage contains the translation shown above.

400error_ms_update_order_state
Failed to update order status in MoySklad

Endpoint-specific error. Use the stable error_ms_update_order_state code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_no_marketplace
Marketplace not specified

Endpoint-specific error. Use the stable error_no_marketplace code in application logic; localMessage contains the translation shown above.

400error_no_organization
Organization not specified

Endpoint-specific error. Use the stable error_no_organization code in application logic; localMessage contains the translation shown above.

400error_no_price_for_order_product
Price not specified for product: {name}

Endpoint-specific error. Use the stable error_no_price_for_order_product code in application logic; localMessage contains the translation shown above.

400error_no_products_in_order
No products found in this order

Endpoint-specific error. Use the stable error_no_products_in_order code in application logic; localMessage contains the translation shown above.

400error_no_quantity_for_order_product
Product quantity not specified: {name}

Endpoint-specific error. Use the stable error_no_quantity_for_order_product code in application logic; localMessage contains the translation shown above.

400error_not_reserved
Reservation can only be withdrawn from reserved products

Endpoint-specific error. Use the stable error_not_reserved code in application logic; localMessage contains the translation shown above.

400error_not_uniq_external_id
External number {id} is already in use for another order

Endpoint-specific error. Use the stable error_not_uniq_external_id code in application logic; localMessage contains the translation shown above.

400error_order_not_found
Order not found

Endpoint-specific error. Use the stable error_order_not_found code in application logic; localMessage contains the translation shown above.

400error_order_product_stock
Product cannot be deleted after stock posting

Endpoint-specific error. Use the stable error_order_product_stock code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_product_not_found_by_id
No products found by ID. You may have deleted the product during import

Endpoint-specific error. Use the stable error_product_not_found_by_id code in application logic; localMessage contains the translation shown above.

400error_source_cell_change_not_allowed_for_inter_warehouse_movement
Source cell change is not allowed for inter-warehouse movement

Endpoint-specific error. Use the stable error_source_cell_change_not_allowed_for_inter_warehouse_movement code in application logic; localMessage contains the translation shown above.

400error_stock_update_busy
Stock update is currently in progress, please try again later

Endpoint-specific error. Use the stable error_stock_update_busy code in application logic; localMessage contains the translation shown above.

400error_token_expired_or_revoked
API token revoked or entered incorrectly

Endpoint-specific error. Use the stable error_token_expired_or_revoked code in application logic; localMessage contains the translation shown above.

400error_unsupported_service
Marketplace not supported

Endpoint-specific error. Use the stable error_unsupported_service code in application logic; localMessage contains the translation shown above.

400error_warehouse_not_found
Warehouse not found

Endpoint-specific error. Use the stable error_warehouse_not_found code in application logic; localMessage contains the translation shown above.

400error_wms_item_not_found
Unique item code not found

Endpoint-specific error. Use the stable error_wms_item_not_found code in application logic; localMessage contains the translation shown above.

POST

Delete Products In Promotion

/api/promotion/deleteProductsInPromotion
Token with write access

Delete Products In Promotion using POST /api/promotion/deleteProductsInPromotion.

Query parameters

FieldTypeRequiredDescription
promotionId integer · int64 Yes Promotion Id.
clientOrganizationId integer · int64 Yes Client Organization Id.

Request body

application/json
Array item structureProductPromotion[]
FieldTypeRequiredDescription
categoryName string No Category Name.
brandName string No Brand Name.
subject string No Subject.
purchasePrice number · double No Purchase Price.
deliveryCost number · double No Delivery Cost.
additionalCost number · double No Additional Cost.
barcode string No Barcode.
instockQuantity integer · int64 No Instock Quantity.
wildberriesStockCount integer · int64 No Wildberries Stock Count.
yandexMarketStockCount integer · int64 No Yandex Market Stock Count.
createdDate string · date-time No Created Date.
minPrice number · double No Min Price.
isDuplicate boolean No Is Duplicate.
ozonArticle string No Ozon Article.
ozonStockCount integer · int64 No Ozon Stock Count.
salesExpensesOnMpPercent number · double No Sales Expenses On Mp Percent.
taxeRate number · double No Taxe Rate.
width integer · int32 No Width.
height integer · int32 No Height.
depth integer · int32 No Depth.
ozonPurchasePercent number · double No Ozon Purchase Percent.
warehouseRatio number · double No Warehouse Ratio.
wildberriesCommission number · double No Wildberries Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
wildberriesAdditionalExpenses number · double No Wildberries Additional Expenses.
ozonAdditionalExpenses number · double No Ozon Additional Expenses.
ozonCommission number · double No Ozon Commission.
wildberriesId integer · int64 No Wildberries Id.
productId integer · int64 No Product Id.
promotionId integer · int64 No Promotion Id.
ozonFbsCommission number · double No Ozon Fbs Commission.
ozonFboCommission number · double No Ozon Fbo Commission.
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 No Service.
acquiringPercent number · double No Acquiring Percent.
currentPrice number · double No Current Price.
currentPriceWithoutDiscount number · double No Current Price Without Discount.
plannedPrice number · double No Planned Price.
totalStockCount integer · int64 No Total Stock Count.
commissionReduction number · double No Commission Reduction.
profitDifference number · double No Profit Difference.
marginDifference number · double No Margin Difference.
markupDifference number · double No Markup Difference.
plannedAndMinPriceDiff number · double No Planned And Min Price Diff.
incomeDifference number · double No Income Difference.
currentDiscount number · double No Current Discount.
productCreatedDate string · date-time No Product Created Date.
mainImageUrl string No Main Image Url.
isProfitably boolean No Is Profitably.
taskId integer · int64 No Task Id.
serviceArticle string No Service Article.
article string No Article.
daysCountOnService integer · int32 No Days Count On Service.
turnover integer · int32 No Turnover.
fboStock integer · int32 No Fbo Stock.
fbsStock integer · int32 No Fbs Stock.
newDiscountForPromotion number · double No New Discount For Promotion.
saleLogistics number · double No Sale Logistics.
returnLogistics number · double No Return Logistics.
purchasePercent number · double No Purchase Percent.
totalLogistics number · double No Total Logistics.
commissions number · double No Commissions.
currentProfit number · double No Current Profit.
promotionProfit number · double No Promotion Profit.
currentMarginality number · double No Current Marginality.
promotionMarginality number · double No Promotion Marginality.
currentMarkUp number · double No Current Mark Up.
promotionMarkUp number · double No Promotion Mark Up.
additionalDiscountForPromotionRub number · double No Additional Discount For Promotion Rub.
additionalDiscountForPromotionPercent number · double No Additional Discount For Promotion Percent.
isDeleted boolean No Is Deleted.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
addMode string No Add Mode.
ozonAverageExpenses number · double No Ozon Average Expenses.
isActive boolean No Is Active.
changeName string No Change Name.
changeDate string · date-time No Change Date.
productName string No Product Name.
id integer · int64 No Id.
totalCount integer · int64 No Total Count.
serviceCard string No Service Card.
isNotFound boolean No Is Not Found.
isArchived boolean No Is Archived.
productCommissions string No Product Commissions.
currentGrossProfit number · double No Current Gross Profit.
plannedGrossProfit number · double No Planned Gross Profit.
curl --request POST 'https://api.selsup.ru/api/promotion/deleteProductsInPromotion?promotionId=1001&clientOrganizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Success response

200
Array item structure OzonProduct[]
FieldTypeRequiredDescription
product_id integer · int64 No Product id.
action_price number · double No Action price.
stock integer · int32 No Stock.
reason string No Reason.
[
  "string"
]
Errors11

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_auto_promotion_not_supported
Cannot add product to automatic promotion

Endpoint-specific error. Use the stable error_auto_promotion_not_supported code in application logic; localMessage contains the translation shown above.

400error_empty_ozon_id
empty Ozon ID

Endpoint-specific error. Use the stable error_empty_ozon_id code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_promotion_exists
Request to add products to promotion has already been sent previously. Resending is not possible

Endpoint-specific error. Use the stable error_promotion_exists code in application logic; localMessage contains the translation shown above.

400error_remote
An error occurred while requesting an external service

Endpoint-specific error. Use the stable error_remote code in application logic; localMessage contains the translation shown above.

400error_token_expired_or_revoked
API token revoked or entered incorrectly

Endpoint-specific error. Use the stable error_token_expired_or_revoked code in application logic; localMessage contains the translation shown above.

400error_wildberries_import_error
Technical work is underway on the WB side. Please try again later. For more details, contact WB technical support. (API: {message})

Endpoint-specific error. Use the stable error_wildberries_import_error code in application logic; localMessage contains the translation shown above.

POST

Add Products In Promotion

/api/promotion/addProductsInPromotion
Token with write access

Add Products In Promotion using POST /api/promotion/addProductsInPromotion.

Query parameters

FieldTypeRequiredDescription
promotionId integer · int64 Yes Promotion Id.
clientOrganizationId integer · int64 Yes Client Organization Id.

Request body

application/json
Array item structureProductPromotion[]
FieldTypeRequiredDescription
categoryName string No Category Name.
brandName string No Brand Name.
subject string No Subject.
purchasePrice number · double No Purchase Price.
deliveryCost number · double No Delivery Cost.
additionalCost number · double No Additional Cost.
barcode string No Barcode.
instockQuantity integer · int64 No Instock Quantity.
wildberriesStockCount integer · int64 No Wildberries Stock Count.
yandexMarketStockCount integer · int64 No Yandex Market Stock Count.
createdDate string · date-time No Created Date.
minPrice number · double No Min Price.
isDuplicate boolean No Is Duplicate.
ozonArticle string No Ozon Article.
ozonStockCount integer · int64 No Ozon Stock Count.
salesExpensesOnMpPercent number · double No Sales Expenses On Mp Percent.
taxeRate number · double No Taxe Rate.
width integer · int32 No Width.
height integer · int32 No Height.
depth integer · int32 No Depth.
ozonPurchasePercent number · double No Ozon Purchase Percent.
warehouseRatio number · double No Warehouse Ratio.
wildberriesCommission number · double No Wildberries Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
wildberriesAdditionalExpenses number · double No Wildberries Additional Expenses.
ozonAdditionalExpenses number · double No Ozon Additional Expenses.
ozonCommission number · double No Ozon Commission.
wildberriesId integer · int64 No Wildberries Id.
productId integer · int64 No Product Id.
promotionId integer · int64 No Promotion Id.
ozonFbsCommission number · double No Ozon Fbs Commission.
ozonFboCommission number · double No Ozon Fbo Commission.
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 No Service.
acquiringPercent number · double No Acquiring Percent.
currentPrice number · double No Current Price.
currentPriceWithoutDiscount number · double No Current Price Without Discount.
plannedPrice number · double No Planned Price.
totalStockCount integer · int64 No Total Stock Count.
commissionReduction number · double No Commission Reduction.
profitDifference number · double No Profit Difference.
marginDifference number · double No Margin Difference.
markupDifference number · double No Markup Difference.
plannedAndMinPriceDiff number · double No Planned And Min Price Diff.
incomeDifference number · double No Income Difference.
currentDiscount number · double No Current Discount.
productCreatedDate string · date-time No Product Created Date.
mainImageUrl string No Main Image Url.
isProfitably boolean No Is Profitably.
taskId integer · int64 No Task Id.
serviceArticle string No Service Article.
article string No Article.
daysCountOnService integer · int32 No Days Count On Service.
turnover integer · int32 No Turnover.
fboStock integer · int32 No Fbo Stock.
fbsStock integer · int32 No Fbs Stock.
newDiscountForPromotion number · double No New Discount For Promotion.
saleLogistics number · double No Sale Logistics.
returnLogistics number · double No Return Logistics.
purchasePercent number · double No Purchase Percent.
totalLogistics number · double No Total Logistics.
commissions number · double No Commissions.
currentProfit number · double No Current Profit.
promotionProfit number · double No Promotion Profit.
currentMarginality number · double No Current Marginality.
promotionMarginality number · double No Promotion Marginality.
currentMarkUp number · double No Current Mark Up.
promotionMarkUp number · double No Promotion Mark Up.
additionalDiscountForPromotionRub number · double No Additional Discount For Promotion Rub.
additionalDiscountForPromotionPercent number · double No Additional Discount For Promotion Percent.
isDeleted boolean No Is Deleted.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
addMode string No Add Mode.
ozonAverageExpenses number · double No Ozon Average Expenses.
isActive boolean No Is Active.
changeName string No Change Name.
changeDate string · date-time No Change Date.
productName string No Product Name.
id integer · int64 No Id.
totalCount integer · int64 No Total Count.
serviceCard string No Service Card.
isNotFound boolean No Is Not Found.
isArchived boolean No Is Archived.
productCommissions string No Product Commissions.
currentGrossProfit number · double No Current Gross Profit.
plannedGrossProfit number · double No Planned Gross Profit.
curl --request POST 'https://api.selsup.ru/api/promotion/addProductsInPromotion?promotionId=1001&clientOrganizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

Success response

200
Array item structure OzonProduct[]
FieldTypeRequiredDescription
product_id integer · int64 No Product id.
action_price number · double No Action price.
stock integer · int32 No Stock.
reason string No Reason.
[
  "string"
]
Errors11

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_auto_promotion_not_supported
Cannot add product to automatic promotion

Endpoint-specific error. Use the stable error_auto_promotion_not_supported code in application logic; localMessage contains the translation shown above.

400error_empty_ozon_id
empty Ozon ID

Endpoint-specific error. Use the stable error_empty_ozon_id code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_organization_not_found
Organization not found

Endpoint-specific error. Use the stable error_organization_not_found code in application logic; localMessage contains the translation shown above.

400error_promotion_exists
Request to add products to promotion has already been sent previously. Resending is not possible

Endpoint-specific error. Use the stable error_promotion_exists code in application logic; localMessage contains the translation shown above.

400error_remote
An error occurred while requesting an external service

Endpoint-specific error. Use the stable error_remote code in application logic; localMessage contains the translation shown above.

400error_token_expired_or_revoked
API token revoked or entered incorrectly

Endpoint-specific error. Use the stable error_token_expired_or_revoked code in application logic; localMessage contains the translation shown above.

400error_wildberries_import_error
Technical work is underway on the WB side. Please try again later. For more details, contact WB technical support. (API: {message})

Endpoint-specific error. Use the stable error_wildberries_import_error code in application logic; localMessage contains the translation shown above.

POST

Post Promotion

/api/promotion/
Token with write access

Post Promotion using POST /api/promotion/.

Request body

application/json
Object fieldsPromotion
FieldTypeRequiredDescription
promotionId integer · int64 No Promotion Id.
id integer · int64 No Id.
totalCount integer · int64 No Total Count.
name string No Name.
dateStart string · date-time No Date Start.
dateEnd string · date-time No Date End.
changeCommission boolean No Change Commission.
changeCommissionAmount number · double No Change Commission Amount.
createdDate string · date-time No Created Date.
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 No Service.
isDeleted boolean No Is Deleted.
description string No Description.
promotionIdOnMp string No Promotion Id On Mp.
clientId integer · int64 No Client Id.
organizationId integer · int64 No Organization Id.
candidateCount integer · int64 No Candidate Count.
inPromotionCount integer · int64 No In Promotion Count.
auto boolean No Auto.
hotsale boolean No Hotsale.
candidateCountOnMp integer · int64 No Candidate Count On Mp.
inPromotionCountOnMp integer · int64 No In Promotion Count On Mp.
curl --request POST 'https://api.selsup.ru/api/promotion/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}'

Success response

200
Object fields Promotion
FieldTypeRequiredDescription
promotionId integer · int64 No Promotion Id.
id integer · int64 No Id.
totalCount integer · int64 No Total Count.
name string No Name.
dateStart string · date-time No Date Start.
dateEnd string · date-time No Date End.
changeCommission boolean No Change Commission.
changeCommissionAmount number · double No Change Commission Amount.
createdDate string · date-time No Created Date.
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 No Service.
isDeleted boolean No Is Deleted.
description string No Description.
promotionIdOnMp string No Promotion Id On Mp.
clientId integer · int64 No Client Id.
organizationId integer · int64 No Organization Id.
candidateCount integer · int64 No Candidate Count.
inPromotionCount integer · int64 No In Promotion Count.
auto boolean No Auto.
hotsale boolean No Hotsale.
candidateCountOnMp integer · int64 No Candidate Count On Mp.
inPromotionCountOnMp integer · int64 No In Promotion Count On Mp.
{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}
Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

GET

Export Products

/api/promotion/{promotionId}/product/export
Token with read access

Export Products using GET /api/promotion/{promotionId}/product/export.

Path parameters

FieldTypeRequiredDescription
promotionId integer · int64 Yes Promotion Id.

Query parameters

FieldTypeRequiredDescription
dateFrom string · date-time No Date From.
dateTo string · date-time No Date To.
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 No Service.
reDownload boolean No Re Download.
clientOrganizationId integer · int64 No Client Organization Id.
minMargin number · double No Min Margin.
minMarginPercent number · double No Min Margin Percent.
isActive boolean No Is Active.
isDeleted boolean No Is Deleted.
query string No Query.
promotionIdOnMp integer · int64 No Promotion Id On Mp.
categoryId integer · int64 No Category Id.
categoryIds integer[] No Category Ids.
clientId integer · int64 No Client Id.
inStock boolean No In Stock.
isNotFound boolean No Is Not Found.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/promotion/1001/product/export?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
"string"
Errors7

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_cant_download_file
Unable to generate file. Write to support

Endpoint-specific error. Use the stable error_cant_download_file code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_promotion_not_found
promotion not found

Endpoint-specific error. Use the stable error_promotion_not_found code in application logic; localMessage contains the translation shown above.

400error_service_not_found
Marketplace not selected

Endpoint-specific error. Use the stable error_service_not_found code in application logic; localMessage contains the translation shown above.

GET

Find

/api/promotion/product/find
Token with read access

Find using GET /api/promotion/product/find.

Query parameters

FieldTypeRequiredDescription
dateFrom string · date-time No Date From.
dateTo string · date-time No Date To.
promotionId integer · int64 No Promotion 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 No Service.
reDownload boolean No Re Download.
clientOrganizationId integer · int64 No Client Organization Id.
minMargin number · double No Min Margin.
minMarginPercent number · double No Min Margin Percent.
isActive boolean No Is Active.
isDeleted boolean No Is Deleted.
query string No Query.
promotionIdOnMp integer · int64 No Promotion Id On Mp.
categoryId integer · int64 No Category Id.
categoryIds integer[] No Category Ids.
clientId integer · int64 No Client Id.
inStock boolean No In Stock.
isNotFound boolean No Is Not Found.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/promotion/product/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields FindResponseProductPromotion
FieldTypeRequiredDescription
rows ProductPromotion[] No Rows.
Array item structure ProductPromotion
FieldTypeRequiredDescription
categoryName string No Category Name.
brandName string No Brand Name.
subject string No Subject.
purchasePrice number · double No Purchase Price.
deliveryCost number · double No Delivery Cost.
additionalCost number · double No Additional Cost.
barcode string No Barcode.
instockQuantity integer · int64 No Instock Quantity.
wildberriesStockCount integer · int64 No Wildberries Stock Count.
yandexMarketStockCount integer · int64 No Yandex Market Stock Count.
createdDate string · date-time No Created Date.
minPrice number · double No Min Price.
isDuplicate boolean No Is Duplicate.
ozonArticle string No Ozon Article.
ozonStockCount integer · int64 No Ozon Stock Count.
salesExpensesOnMpPercent number · double No Sales Expenses On Mp Percent.
taxeRate number · double No Taxe Rate.
width integer · int32 No Width.
height integer · int32 No Height.
depth integer · int32 No Depth.
ozonPurchasePercent number · double No Ozon Purchase Percent.
warehouseRatio number · double No Warehouse Ratio.
wildberriesCommission number · double No Wildberries Commission.
wildberriesFbwCommission number · double No Wildberries Fbw Commission.
wildberriesFbsCommission number · double No Wildberries Fbs Commission.
wildberriesDbsCommission number · double No Wildberries Dbs Commission.
wildberriesEdbsCommission number · double No Wildberries Edbs Commission.
wildberriesCAndCCommission number · double No Wildberries CAnd CCommission.
wildberriesBookingCommission number · double No Wildberries Booking Commission.
wildberriesAdditionalExpenses number · double No Wildberries Additional Expenses.
ozonAdditionalExpenses number · double No Ozon Additional Expenses.
ozonCommission number · double No Ozon Commission.
wildberriesId integer · int64 No Wildberries Id.
productId integer · int64 No Product Id.
promotionId integer · int64 No Promotion Id.
ozonFbsCommission number · double No Ozon Fbs Commission.
ozonFboCommission number · double No Ozon Fbo Commission.
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 No Service.
acquiringPercent number · double No Acquiring Percent.
currentPrice number · double No Current Price.
currentPriceWithoutDiscount number · double No Current Price Without Discount.
plannedPrice number · double No Planned Price.
totalStockCount integer · int64 No Total Stock Count.
commissionReduction number · double No Commission Reduction.
profitDifference number · double No Profit Difference.
marginDifference number · double No Margin Difference.
markupDifference number · double No Markup Difference.
plannedAndMinPriceDiff number · double No Planned And Min Price Diff.
incomeDifference number · double No Income Difference.
currentDiscount number · double No Current Discount.
productCreatedDate string · date-time No Product Created Date.
mainImageUrl string No Main Image Url.
isProfitably boolean No Is Profitably.
taskId integer · int64 No Task Id.
serviceArticle string No Service Article.
article string No Article.
daysCountOnService integer · int32 No Days Count On Service.
turnover integer · int32 No Turnover.
fboStock integer · int32 No Fbo Stock.
fbsStock integer · int32 No Fbs Stock.
newDiscountForPromotion number · double No New Discount For Promotion.
saleLogistics number · double No Sale Logistics.
returnLogistics number · double No Return Logistics.
purchasePercent number · double No Purchase Percent.
totalLogistics number · double No Total Logistics.
commissions number · double No Commissions.
currentProfit number · double No Current Profit.
promotionProfit number · double No Promotion Profit.
currentMarginality number · double No Current Marginality.
promotionMarginality number · double No Promotion Marginality.
currentMarkUp number · double No Current Mark Up.
promotionMarkUp number · double No Promotion Mark Up.
additionalDiscountForPromotionRub number · double No Additional Discount For Promotion Rub.
additionalDiscountForPromotionPercent number · double No Additional Discount For Promotion Percent.
isDeleted boolean No Is Deleted.
organizationId integer · int64 No Organization Id.
clientId integer · int64 No Client Id.
addMode string No Add Mode.
ozonAverageExpenses number · double No Ozon Average Expenses.
isActive boolean No Is Active.
changeName string No Change Name.
changeDate string · date-time No Change Date.
productName string No Product Name.
id integer · int64 No Id.
totalCount integer · int64 No Total Count.
serviceCard string No Service Card.
isNotFound boolean No Is Not Found.
isArchived boolean No Is Archived.
productCommissions string No Product Commissions.
currentGrossProfit number · double No Current Gross Profit.
plannedGrossProfit number · double No Planned Gross Profit.
{
  "rows": "string"
}
Errors4

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

GET

All

/api/promotion/find
Token with read access

All using GET /api/promotion/find.

Query parameters

FieldTypeRequiredDescription
dateFrom string · date-time No Date From.
dateTo string · date-time No Date To.
promotionId integer · int64 No Promotion 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 No Service.
reDownload boolean No Re Download.
clientOrganizationId integer · int64 No Client Organization Id.
minMargin number · double No Min Margin.
minMarginPercent number · double No Min Margin Percent.
isActive boolean No Is Active.
isDeleted boolean No Is Deleted.
query string No Query.
promotionIdOnMp integer · int64 No Promotion Id On Mp.
categoryId integer · int64 No Category Id.
categoryIds integer[] No Category Ids.
clientId integer · int64 No Client Id.
inStock boolean No In Stock.
isNotFound boolean No Is Not Found.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/promotion/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
Object fields FindResponsePromotion
FieldTypeRequiredDescription
rows Promotion[] No Rows.
Array item structure Promotion
FieldTypeRequiredDescription
promotionId integer · int64 No Promotion Id.
id integer · int64 No Id.
totalCount integer · int64 No Total Count.
name string No Name.
dateStart string · date-time No Date Start.
dateEnd string · date-time No Date End.
changeCommission boolean No Change Commission.
changeCommissionAmount number · double No Change Commission Amount.
createdDate string · date-time No Created Date.
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 No Service.
isDeleted boolean No Is Deleted.
description string No Description.
promotionIdOnMp string No Promotion Id On Mp.
clientId integer · int64 No Client Id.
organizationId integer · int64 No Organization Id.
candidateCount integer · int64 No Candidate Count.
inPromotionCount integer · int64 No In Promotion Count.
auto boolean No Auto.
hotsale boolean No Hotsale.
candidateCountOnMp integer · int64 No Candidate Count On Mp.
inPromotionCountOnMp integer · int64 No In Promotion Count On Mp.
{
  "rows": "string"
}
Errors5

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_service_not_found
Marketplace not selected

Endpoint-specific error. Use the stable error_service_not_found code in application logic; localMessage contains the translation shown above.

GET

Export

/api/promotion/export
Token with read access

Export using GET /api/promotion/export.

Query parameters

FieldTypeRequiredDescription
dateFrom string · date-time No Date From.
dateTo string · date-time No Date To.
promotionId integer · int64 No Promotion 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 No Service.
reDownload boolean No Re Download.
clientOrganizationId integer · int64 No Client Organization Id.
minMargin number · double No Min Margin.
minMarginPercent number · double No Min Margin Percent.
isActive boolean No Is Active.
isDeleted boolean No Is Deleted.
query string No Query.
promotionIdOnMp integer · int64 No Promotion Id On Mp.
categoryId integer · int64 No Category Id.
categoryIds integer[] No Category Ids.
clientId integer · int64 No Client Id.
inStock boolean No In Stock.
isNotFound boolean No Is Not Found.
limit integer · int32 No Limit.
page integer · int32 No Page.
count boolean No Count.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER No Sort By.
ascending boolean No Ascending.
curl --request GET 'https://api.selsup.ru/api/promotion/export?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Success response

200
"string"
Errors6

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required
Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied
Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown
Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

400error_cant_download_file
Unable to generate file. Write to support

Endpoint-specific error. Use the stable error_cant_download_file code in application logic; localMessage contains the translation shown above.

400error_no_client
The client was not found or has been deleted. Write to support

Endpoint-specific error. Use the stable error_no_client code in application logic; localMessage contains the translation shown above.

400error_service_not_found
Marketplace not selected

Endpoint-specific error. Use the stable error_service_not_found code in application logic; localMessage contains the translation shown above.

Authorization

Token for test requests

The token stays in this browser's localStorage and is sent only in the Authorization header of requests to api.selsup.ru.

Try it

Real request parameters

Live API response

Send a request to see the SelSup response.