SelSup Developers

公共的 API · 参考 API

晋升

促销目的地,包括精确的路线,参数,请求机构和可扩展的响应方案.

11 终点/api/promotion稳定机器可读的描述 ↗
{ }

通过可编辑的独立合同来支持本页面. 在生产使用之前,验证使用测试数据的写作操作.

/api/promotion

准备使用的工作流程

准备使用的工作流程

数据模型

数据结构

模型在此列出一次,并且可以直接从使用它们的终端点扩展.

Promotion21 字段
promotionIdinteger · int64

提升身份证.

idinteger · int64

Id.

totalCountinteger · int64

总计.

namestring

姓名.

dateStartstring · date-time

开始日期.

dateEndstring · date-time

约会结束.

changeCommissionboolean

改变委员会.

changeCommissionAmountnumber · double

改变佣金金额

createdDatestring · date-time

创造日期.

servicestring

服务.

isDeletedboolean

已被删除.

descriptionstring

描述

promotionIdOnMpstring

优惠名单在MP上

clientIdinteger · int64

客户身份证.

organizationIdinteger · int64

组织身份证.

candidateCountinteger · int64

候选人伯爵.

inPromotionCountinteger · int64

在晋升计数.

autoboolean

车辆.

hotsaleboolean

鱼.

candidateCountOnMpinteger · int64

候选人数量在MP.

inPromotionCountOnMpinteger · int64

在促销部下

TmsTask25 字段
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

姓名.

clientIdinteger · int64

客户身份证.

entityIdinteger · int64

实体身份证

progressinteger · int32

进步.

processedQuantityinteger · int32

处理量

organizationIdinteger · int64

组织身份证.

priorityinteger · int32

优先考虑.

propertiesstring

房产.

messagestring

信息.

messageParamsstring

消息帕拉姆.

createdDatestring · date-time

创造日期.

startDatestring · date-time

开始日期.

finishDatestring · date-time

终结日期.

urlstring

查看一个URL.

inputFileUrlstring

输入文件URL.

retryNumberinteger · int32

复试号码.

userIdinteger · int32

用户身份证

retryDatestring · date-time

试一次.

debugboolean

调试.

forcedStartboolean

强迫开始.

servicestring

服务.

langstring

Lang.

ProductPromotion91 字段
categoryNamestring

类别名称

brandNamestring

品牌名字.

subjectstring

问题.

purchasePricenumber · double

买价.

deliveryCostnumber · double

交货成本

additionalCostnumber · double

额外的成本

barcodestring

条码.

instockQuantityinteger · int64

存量量

wildberriesStockCountinteger · int64

野生果股票数量.

yandexMarketStockCountinteger · int64

亚兰德克斯市场股票计数.

createdDatestring · date-time

创造日期.

minPricenumber · double

价格不到.

isDuplicateboolean

是复制.

ozonArticlestring

臭氧条款

ozonStockCountinteger · int64

子股票计数.

salesExpensesOnMpPercentnumber · double

销售费用在MP百分比上

taxeRatenumber · double

税率.

widthinteger · int32

宽度.

heightinteger · int32

高.

depthinteger · int32

深度.

ozonPurchasePercentnumber · double

气购买率

warehouseRationumber · double

仓库比例.

wildberriesCommissionnumber · double

野生果委员会.

wildberriesFbwCommissionnumber · double

野生果Fbw委员会.

wildberriesFbsCommissionnumber · double

野生果联邦调查委员会.

wildberriesDbsCommissionnumber · double

野生果食品委员会.

wildberriesEdbsCommissionnumber · double

野生果养殖委员会.

wildberriesCAndCCommissionnumber · double

果和果委员会.

wildberriesBookingCommissionnumber · double

野生果预订委员会.

wildberriesAdditionalExpensesnumber · double

其他费用

ozonAdditionalExpensesnumber · double

臭氧额外支出

ozonCommissionnumber · double

臭氧委员会

wildberriesIdinteger · int64

果的身份证.

productIdinteger · int64

产品身份证

promotionIdinteger · int64

提升身份证.

ozonFbsCommissionnumber · double

子联邦调查委员会.

ozonFboCommissionnumber · double

子贸易委员会

servicestring

服务.

acquiringPercentnumber · double

获得百分比.

currentPricenumber · double

现在的价格.

currentPriceWithoutDiscountnumber · double

现货价格没有折扣.

plannedPricenumber · double

计划的价格.

totalStockCountinteger · int64

总股票数量.

commissionReductionnumber · double

减少委员会.

profitDifferencenumber · double

利差异

marginDifferencenumber · double

边缘差异

markupDifferencenumber · double

标记差异.

plannedAndMinPriceDiffnumber · double

计划和最低价格差异

incomeDifferencenumber · double

收入差异

currentDiscountnumber · double

现在的折扣.

productCreatedDatestring · date-time

产品创建日期

mainImageUrlstring

标签: 标题:

isProfitablyboolean

利的.

taskIdinteger · int64

任务身份证.

serviceArticlestring

服务条款

articlestring

关于此的文章.

daysCountOnServiceinteger · int32

服务时间是数日的.

turnoverinteger · int32

转换时间.

fboStockinteger · int32

美国联邦调查局.

fbsStockinteger · int32

联邦调查局.

newDiscountForPromotionnumber · double

促销额度新折扣.

saleLogisticsnumber · double

销售物流.

returnLogisticsnumber · double

返回物流.

purchasePercentnumber · double

购买百分比.

totalLogisticsnumber · double

总物流.

commissionsnumber · double

佣金.

currentProfitnumber · double

现在的利.

promotionProfitnumber · double

提升利.

currentMarginalitynumber · double

现在的边缘化.

promotionMarginalitynumber · double

晋升边缘化.

currentMarkUpnumber · double

现在的标记.

promotionMarkUpnumber · double

提升,提升.

additionalDiscountForPromotionRubnumber · double

更多的优惠.

additionalDiscountForPromotionPercentnumber · double

促销额外折扣.

isDeletedboolean

已被删除.

organizationIdinteger · int64

组织身份证.

clientIdinteger · int64

客户身份证.

addModestring

加入模式.

ozonAverageExpensesnumber · double

臭氧平均支出

isActiveboolean

现在还在行动.

changeNamestring

改变名字.

changeDatestring · date-time

改变日期.

productNamestring

产品名称

idinteger · int64

Id.

totalCountinteger · int64

总计.

serviceCardstring

服务卡.

isNotFoundboolean

没有找到.

isArchivedboolean

已被存档.

productCommissionsstring

产品委员会

currentGrossProfitnumber · double

现货总利

plannedGrossProfitnumber · double

预计的总利.

OzonProduct4 字段
product_idinteger · int64

产品身份证

action_pricenumber · double

股价.

stockinteger · int32

股票.

reasonstring

原因.

FindResponseProductPromotion1 字段
rowsProductPromotion[]

排列.

FindResponsePromotion1 字段
rowsPromotion[]

排列.

错误合同

如何返回应用错误

编程的代码在每个地方都相同,而用户面向的消息由服务器翻译. 建立在error周围的应用逻辑,仅用于显示.

鱼类

稳定机器可读的代码用于集成逻辑.

鱼类

在API代币用户语言中显示准备的消息.

鱼类

服务器在本地化消息模板中插入的值.

localMessage使用了 API代币的用户的lang字段.文档语言和 Accept-Language标题不会改变它;当用户没有语言配置时,使用俄语.

RU用户位置是 ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
CN中文 (cn)
{
  "error": "error_brand_already_exists",
  "localMessage": "品牌 Base 已经存在",
  "params": {
    "name": "Base"
  }
}

终点

终点

PUT

提升自己的职位

/api/promotion/{promotionId}
具有写入的标志

通过PUTX/api/promotion/{promotionId}.进行促销

要求机构

application/json
对象场Promotion
字段类型必填描述
promotionId integer · int64 提升身份证.
id integer · int64 Id.
totalCount integer · int64 总计.
name string 姓名.
dateStart string · date-time 开始日期.
dateEnd string · date-time 约会结束.
changeCommission boolean 改变委员会.
changeCommissionAmount number · double 改变佣金金额
createdDate string · date-time 创造日期.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
isDeleted boolean 已被删除.
description string 描述
promotionIdOnMp string 优惠名单在MP上
clientId integer · int64 客户身份证.
organizationId integer · int64 组织身份证.
candidateCount integer · int64 候选人伯爵.
inPromotionCount integer · int64 在晋升计数.
auto boolean 车辆.
hotsale boolean 鱼.
candidateCountOnMp integer · int64 候选人数量在MP.
inPromotionCountOnMp integer · int64 在促销部下
curl --request PUT 'https://api.selsup.ru/api/promotion/%7BpromotionId%7D' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}'

成功的反应

200
对象场 Promotion
字段类型必填描述
promotionId integer · int64 提升身份证.
id integer · int64 Id.
totalCount integer · int64 总计.
name string 姓名.
dateStart string · date-time 开始日期.
dateEnd string · date-time 约会结束.
changeCommission boolean 改变委员会.
changeCommissionAmount number · double 改变佣金金额
createdDate string · date-time 创造日期.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
isDeleted boolean 已被删除.
description string 描述
promotionIdOnMp string 优惠名单在MP上
clientId integer · int64 客户身份证.
organizationId integer · int64 组织身份证.
candidateCount integer · int64 候选人伯爵.
inPromotionCount integer · int64 在晋升计数.
auto boolean 车辆.
hotsale boolean 鱼.
candidateCountOnMp integer · int64 候选人数量在MP.
inPromotionCountOnMp integer · int64 在促销部下
{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}
错误4

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

PATCH

通过ID恢复促销

/api/promotion/{promotionId}
具有写入的标志

使用 PATCH /api/promotion/{promotionId}.恢复促销按ID

路径参数

字段类型必填描述
promotionId integer · int64 提升身份证.
curl --request PATCH 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

成功的反应

200

答案没有身体.

错误3

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

DELETE

删除通过ID的促销

/api/promotion/{promotionId}
具有写入的标志

使用 DELETE /api/promotion/{promotionId}.删除促销

路径参数

字段类型必填描述
promotionId integer · int64 提升身份证.
curl --request DELETE 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

成功的反应

200

答案没有身体.

错误3

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

POST

更新

/api/promotion/update/{service}
具有写入的标志

使用 POST 更新

路径参数

字段类型必填描述
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.

查询参数

字段类型必填描述
organizationId integer · int64 组织身份证.
curl --request POST 'https://api.selsup.ru/api/promotion/update/NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

成功的反应

200
对象场 TmsTask
字段类型必填描述
id integer · int64 Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Status.
type stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT Type.
name string 姓名.
clientId integer · int64 客户身份证.
entityId integer · int64 实体身份证
progress integer · int32 进步.
processedQuantity integer · int32 处理量
organizationId integer · int64 组织身份证.
priority integer · int32 优先考虑.
properties string 房产.
message string 信息.
messageParams string 消息帕拉姆.
createdDate string · date-time 创造日期.
startDate string · date-time 开始日期.
finishDate string · date-time 终结日期.
url string 查看一个URL.
inputFileUrl string 输入文件URL.
retryNumber integer · int32 复试号码.
userId integer · int32 用户身份证
retryDate string · date-time 试一次.
debug boolean 调试.
forcedStart boolean 强迫开始.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
lang string Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
错误36

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_cannot_deleted_order_product
无法删除与库存物品或未注销标签相关联的项目

应用逻辑中使用稳定的error_cannot_deleted_order_product代码;localMessage包含上述翻译.

400error_competitor_id_required
需要竞争对手ID

应用逻辑中使用稳定的error_competitor_id_required代码;localMessage包含上述翻译.

400error_competitor_required
竞争对手是必需的

应用逻辑中使用稳定的error_competitor_required代码;localMessage包含上述翻译.

400error_competitor_service_required
竞争对手服务必填

应用逻辑中使用稳定的error_competitor_service_required代码;localMessage包含上述翻译.

400error_competitor_url_required
竞争对手链接必填

应用逻辑中使用稳定的error_competitor_url_required代码;localMessage包含上述翻译.

400error_customer_not_found
未找到客户

应用逻辑中使用稳定的error_customer_not_found代码;localMessage包含上述翻译.

400error_duplicate_order_product
两个相同的项目 {productId}添加到订单中

应用逻辑中使用稳定的error_duplicate_order_product代码;localMessage包含上述翻译.

400error_empty_warehouse
未指定仓库

应用逻辑中使用稳定的error_empty_warehouse代码;localMessage包含上述翻译.

400error_group_already_exist
群组已存在

应用逻辑中使用稳定的error_group_already_exist代码;localMessage包含上述翻译.

400error_incorrect_order_data
无法创建订单,因为组织、仓库或用户已被删除:{id}

应用逻辑中使用稳定的error_incorrect_order_data代码;localMessage包含上述翻译.

400error_invalid_url
网站地址不正确,应该以http:// 或 https:// 开始,地址中不允许有selsup、localhost。

应用逻辑中使用稳定的error_invalid_url代码;localMessage包含上述翻译.

400error_moy_sklad_organization
未找到MoySklad中的组织

应用逻辑中使用稳定的error_moy_sklad_organization代码;localMessage包含上述翻译.

400error_ms_error
我的商店API错误: {message}

应用逻辑中使用稳定的error_ms_error代码;localMessage包含上述翻译.

400error_ms_no_warehouse
SelSup仓库没有连接到我的存储服务上

应用逻辑中使用稳定的error_ms_no_warehouse代码;localMessage包含上述翻译.

400error_ms_update_order_state
无法更新MoySklad订单状态

应用逻辑中使用稳定的error_ms_update_order_state代码;localMessage包含上述翻译.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

400error_no_marketplace
未指定市场

应用逻辑中使用稳定的error_no_marketplace代码;localMessage包含上述翻译.

400error_no_organization
未指定组织

应用逻辑中使用稳定的error_no_organization代码;localMessage包含上述翻译.

400error_no_price_for_order_product
未指定价格的项目: {name}。

应用逻辑中使用稳定的error_no_price_for_order_product代码;localMessage包含上述翻译.

400error_no_products_in_order
此订单中未找到任何产品

应用逻辑中使用稳定的error_no_products_in_order代码;localMessage包含上述翻译.

400error_no_quantity_for_order_product
未指定项目数量: {name}。

应用逻辑中使用稳定的error_no_quantity_for_order_product代码;localMessage包含上述翻译.

400error_not_reserved
只有保留的项目可以被提取

应用逻辑中使用稳定的error_not_reserved代码;localMessage包含上述翻译.

400error_not_uniq_external_id
外部号码 {id} 已经被用于另一个订单

应用逻辑中使用稳定的error_not_uniq_external_id代码;localMessage包含上述翻译.

400error_order_not_found
未找到订单

应用逻辑中使用稳定的error_order_not_found代码;localMessage包含上述翻译.

400error_order_product_stock
商品入库后无法删除

应用逻辑中使用稳定的error_order_product_stock代码;localMessage包含上述翻译.

400error_organization_not_found
没有发现任何组织

应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.

400error_product_not_found_by_id
没有找到ID的货物。你可能在导入过程中删除了一个物品

应用逻辑中使用稳定的error_product_not_found_by_id代码;localMessage包含上述翻译.

400error_source_cell_change_not_allowed_for_inter_warehouse_movement
不允许更改源单元格用于仓库间移动

应用逻辑中使用稳定的error_source_cell_change_not_allowed_for_inter_warehouse_movement代码;localMessage包含上述翻译.

400error_stock_update_busy
当前正在进行库存更新,请稍后再试

应用逻辑中使用稳定的error_stock_update_busy代码;localMessage包含上述翻译.

400error_token_expired_or_revoked
API令牌被撤销或输入错误

应用逻辑中使用稳定的error_token_expired_or_revoked代码;localMessage包含上述翻译.

400error_unsupported_service
不支持该市场

应用逻辑中使用稳定的error_unsupported_service代码;localMessage包含上述翻译.

400error_warehouse_not_found
没有发现仓库

应用逻辑中使用稳定的error_warehouse_not_found代码;localMessage包含上述翻译.

400error_wms_item_not_found
没有发现独特的产品代码

应用逻辑中使用稳定的error_wms_item_not_found代码;localMessage包含上述翻译.

POST

删除促销产品

/api/promotion/deleteProductsInPromotion
具有写入的标志

使用 POST /api/promotion/deleteProductsInPromotion.删除促销中的产品

查询参数

字段类型必填描述
promotionId integer · int64 提升身份证.
clientOrganizationId integer · int64 客户组织身份证.

要求机构

application/json
阵列项结构ProductPromotion[]
字段类型必填描述
categoryName string 类别名称
brandName string 品牌名字.
subject string 问题.
purchasePrice number · double 买价.
deliveryCost number · double 交货成本
additionalCost number · double 额外的成本
barcode string 条码.
instockQuantity integer · int64 存量量
wildberriesStockCount integer · int64 野生果股票数量.
yandexMarketStockCount integer · int64 亚兰德克斯市场股票计数.
createdDate string · date-time 创造日期.
minPrice number · double 价格不到.
isDuplicate boolean 是复制.
ozonArticle string 臭氧条款
ozonStockCount integer · int64 子股票计数.
salesExpensesOnMpPercent number · double 销售费用在MP百分比上
taxeRate number · double 税率.
width integer · int32 宽度.
height integer · int32 高.
depth integer · int32 深度.
ozonPurchasePercent number · double 气购买率
warehouseRatio number · double 仓库比例.
wildberriesCommission number · double 野生果委员会.
wildberriesFbwCommission number · double 野生果Fbw委员会.
wildberriesFbsCommission number · double 野生果联邦调查委员会.
wildberriesDbsCommission number · double 野生果食品委员会.
wildberriesEdbsCommission number · double 野生果养殖委员会.
wildberriesCAndCCommission number · double 果和果委员会.
wildberriesBookingCommission number · double 野生果预订委员会.
wildberriesAdditionalExpenses number · double 其他费用
ozonAdditionalExpenses number · double 臭氧额外支出
ozonCommission number · double 臭氧委员会
wildberriesId integer · int64 果的身份证.
productId integer · int64 产品身份证
promotionId integer · int64 提升身份证.
ozonFbsCommission number · double 子联邦调查委员会.
ozonFboCommission number · double 子贸易委员会
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
acquiringPercent number · double 获得百分比.
currentPrice number · double 现在的价格.
currentPriceWithoutDiscount number · double 现货价格没有折扣.
plannedPrice number · double 计划的价格.
totalStockCount integer · int64 总股票数量.
commissionReduction number · double 减少委员会.
profitDifference number · double 利差异
marginDifference number · double 边缘差异
markupDifference number · double 标记差异.
plannedAndMinPriceDiff number · double 计划和最低价格差异
incomeDifference number · double 收入差异
currentDiscount number · double 现在的折扣.
productCreatedDate string · date-time 产品创建日期
mainImageUrl string 标签: 标题:
isProfitably boolean 利的.
taskId integer · int64 任务身份证.
serviceArticle string 服务条款
article string 关于此的文章.
daysCountOnService integer · int32 服务时间是数日的.
turnover integer · int32 转换时间.
fboStock integer · int32 美国联邦调查局.
fbsStock integer · int32 联邦调查局.
newDiscountForPromotion number · double 促销额度新折扣.
saleLogistics number · double 销售物流.
returnLogistics number · double 返回物流.
purchasePercent number · double 购买百分比.
totalLogistics number · double 总物流.
commissions number · double 佣金.
currentProfit number · double 现在的利.
promotionProfit number · double 提升利.
currentMarginality number · double 现在的边缘化.
promotionMarginality number · double 晋升边缘化.
currentMarkUp number · double 现在的标记.
promotionMarkUp number · double 提升,提升.
additionalDiscountForPromotionRub number · double 更多的优惠.
additionalDiscountForPromotionPercent number · double 促销额外折扣.
isDeleted boolean 已被删除.
organizationId integer · int64 组织身份证.
clientId integer · int64 客户身份证.
addMode string 加入模式.
ozonAverageExpenses number · double 臭氧平均支出
isActive boolean 现在还在行动.
changeName string 改变名字.
changeDate string · date-time 改变日期.
productName string 产品名称
id integer · int64 Id.
totalCount integer · int64 总计.
serviceCard string 服务卡.
isNotFound boolean 没有找到.
isArchived boolean 已被存档.
productCommissions string 产品委员会
currentGrossProfit number · double 现货总利
plannedGrossProfit number · double 预计的总利.
curl --request POST 'https://api.selsup.ru/api/promotion/deleteProductsInPromotion?promotionId=1001&clientOrganizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

成功的反应

200
阵列项结构 OzonProduct[]
字段类型必填描述
product_id integer · int64 产品身份证
action_price number · double 股价.
stock integer · int32 股票.
reason string 原因.
[
  "string"
]
错误11

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_auto_promotion_not_supported
无法将商品添加到自动促销活动中

应用逻辑中使用稳定的error_auto_promotion_not_supported代码;localMessage包含上述翻译.

400error_empty_ozon_id
Ozon ID为空

应用逻辑中使用稳定的error_empty_ozon_id代码;localMessage包含上述翻译.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

400error_organization_not_found
没有发现任何组织

应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.

400error_promotion_exists
添加商品到促销的请求之前已发送。无法重复发送

应用逻辑中使用稳定的error_promotion_exists代码;localMessage包含上述翻译.

400error_remote
请求外部服务时发生错误

应用逻辑中使用稳定的error_remote代码;localMessage包含上述翻译.

400error_token_expired_or_revoked
API令牌被撤销或输入错误

应用逻辑中使用稳定的error_token_expired_or_revoked代码;localMessage包含上述翻译.

400error_wildberries_import_error
WB 方面正在进行技术维护,请稍后再试。更多详情请联系 WB 技术支持。 (API: {message})

应用逻辑中使用稳定的error_wildberries_import_error代码;localMessage包含上述翻译.

POST

增加促销产品

/api/promotion/addProductsInPromotion
具有写入的标志

使用 POST /api/promotion/addProductsInPromotion. 添加促销产品

查询参数

字段类型必填描述
promotionId integer · int64 提升身份证.
clientOrganizationId integer · int64 客户组织身份证.

要求机构

application/json
阵列项结构ProductPromotion[]
字段类型必填描述
categoryName string 类别名称
brandName string 品牌名字.
subject string 问题.
purchasePrice number · double 买价.
deliveryCost number · double 交货成本
additionalCost number · double 额外的成本
barcode string 条码.
instockQuantity integer · int64 存量量
wildberriesStockCount integer · int64 野生果股票数量.
yandexMarketStockCount integer · int64 亚兰德克斯市场股票计数.
createdDate string · date-time 创造日期.
minPrice number · double 价格不到.
isDuplicate boolean 是复制.
ozonArticle string 臭氧条款
ozonStockCount integer · int64 子股票计数.
salesExpensesOnMpPercent number · double 销售费用在MP百分比上
taxeRate number · double 税率.
width integer · int32 宽度.
height integer · int32 高.
depth integer · int32 深度.
ozonPurchasePercent number · double 气购买率
warehouseRatio number · double 仓库比例.
wildberriesCommission number · double 野生果委员会.
wildberriesFbwCommission number · double 野生果Fbw委员会.
wildberriesFbsCommission number · double 野生果联邦调查委员会.
wildberriesDbsCommission number · double 野生果食品委员会.
wildberriesEdbsCommission number · double 野生果养殖委员会.
wildberriesCAndCCommission number · double 果和果委员会.
wildberriesBookingCommission number · double 野生果预订委员会.
wildberriesAdditionalExpenses number · double 其他费用
ozonAdditionalExpenses number · double 臭氧额外支出
ozonCommission number · double 臭氧委员会
wildberriesId integer · int64 果的身份证.
productId integer · int64 产品身份证
promotionId integer · int64 提升身份证.
ozonFbsCommission number · double 子联邦调查委员会.
ozonFboCommission number · double 子贸易委员会
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
acquiringPercent number · double 获得百分比.
currentPrice number · double 现在的价格.
currentPriceWithoutDiscount number · double 现货价格没有折扣.
plannedPrice number · double 计划的价格.
totalStockCount integer · int64 总股票数量.
commissionReduction number · double 减少委员会.
profitDifference number · double 利差异
marginDifference number · double 边缘差异
markupDifference number · double 标记差异.
plannedAndMinPriceDiff number · double 计划和最低价格差异
incomeDifference number · double 收入差异
currentDiscount number · double 现在的折扣.
productCreatedDate string · date-time 产品创建日期
mainImageUrl string 标签: 标题:
isProfitably boolean 利的.
taskId integer · int64 任务身份证.
serviceArticle string 服务条款
article string 关于此的文章.
daysCountOnService integer · int32 服务时间是数日的.
turnover integer · int32 转换时间.
fboStock integer · int32 美国联邦调查局.
fbsStock integer · int32 联邦调查局.
newDiscountForPromotion number · double 促销额度新折扣.
saleLogistics number · double 销售物流.
returnLogistics number · double 返回物流.
purchasePercent number · double 购买百分比.
totalLogistics number · double 总物流.
commissions number · double 佣金.
currentProfit number · double 现在的利.
promotionProfit number · double 提升利.
currentMarginality number · double 现在的边缘化.
promotionMarginality number · double 晋升边缘化.
currentMarkUp number · double 现在的标记.
promotionMarkUp number · double 提升,提升.
additionalDiscountForPromotionRub number · double 更多的优惠.
additionalDiscountForPromotionPercent number · double 促销额外折扣.
isDeleted boolean 已被删除.
organizationId integer · int64 组织身份证.
clientId integer · int64 客户身份证.
addMode string 加入模式.
ozonAverageExpenses number · double 臭氧平均支出
isActive boolean 现在还在行动.
changeName string 改变名字.
changeDate string · date-time 改变日期.
productName string 产品名称
id integer · int64 Id.
totalCount integer · int64 总计.
serviceCard string 服务卡.
isNotFound boolean 没有找到.
isArchived boolean 已被存档.
productCommissions string 产品委员会
currentGrossProfit number · double 现货总利
plannedGrossProfit number · double 预计的总利.
curl --request POST 'https://api.selsup.ru/api/promotion/addProductsInPromotion?promotionId=1001&clientOrganizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '[
  "string"
]'

成功的反应

200
阵列项结构 OzonProduct[]
字段类型必填描述
product_id integer · int64 产品身份证
action_price number · double 股价.
stock integer · int32 股票.
reason string 原因.
[
  "string"
]
错误11

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_auto_promotion_not_supported
无法将商品添加到自动促销活动中

应用逻辑中使用稳定的error_auto_promotion_not_supported代码;localMessage包含上述翻译.

400error_empty_ozon_id
Ozon ID为空

应用逻辑中使用稳定的error_empty_ozon_id代码;localMessage包含上述翻译.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

400error_organization_not_found
没有发现任何组织

应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.

400error_promotion_exists
添加商品到促销的请求之前已发送。无法重复发送

应用逻辑中使用稳定的error_promotion_exists代码;localMessage包含上述翻译.

400error_remote
请求外部服务时发生错误

应用逻辑中使用稳定的error_remote代码;localMessage包含上述翻译.

400error_token_expired_or_revoked
API令牌被撤销或输入错误

应用逻辑中使用稳定的error_token_expired_or_revoked代码;localMessage包含上述翻译.

400error_wildberries_import_error
WB 方面正在进行技术维护,请稍后再试。更多详情请联系 WB 技术支持。 (API: {message})

应用逻辑中使用稳定的error_wildberries_import_error代码;localMessage包含上述翻译.

POST

后晋升

/api/promotion/
具有写入的标志

使用 POST /api/promotion/. 的后期促销

要求机构

application/json
对象场Promotion
字段类型必填描述
promotionId integer · int64 提升身份证.
id integer · int64 Id.
totalCount integer · int64 总计.
name string 姓名.
dateStart string · date-time 开始日期.
dateEnd string · date-time 约会结束.
changeCommission boolean 改变委员会.
changeCommissionAmount number · double 改变佣金金额
createdDate string · date-time 创造日期.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
isDeleted boolean 已被删除.
description string 描述
promotionIdOnMp string 优惠名单在MP上
clientId integer · int64 客户身份证.
organizationId integer · int64 组织身份证.
candidateCount integer · int64 候选人伯爵.
inPromotionCount integer · int64 在晋升计数.
auto boolean 车辆.
hotsale boolean 鱼.
candidateCountOnMp integer · int64 候选人数量在MP.
inPromotionCountOnMp integer · int64 在促销部下
curl --request POST 'https://api.selsup.ru/api/promotion/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}'

成功的反应

200
对象场 Promotion
字段类型必填描述
promotionId integer · int64 提升身份证.
id integer · int64 Id.
totalCount integer · int64 总计.
name string 姓名.
dateStart string · date-time 开始日期.
dateEnd string · date-time 约会结束.
changeCommission boolean 改变委员会.
changeCommissionAmount number · double 改变佣金金额
createdDate string · date-time 创造日期.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
isDeleted boolean 已被删除.
description string 描述
promotionIdOnMp string 优惠名单在MP上
clientId integer · int64 客户身份证.
organizationId integer · int64 组织身份证.
candidateCount integer · int64 候选人伯爵.
inPromotionCount integer · int64 在晋升计数.
auto boolean 车辆.
hotsale boolean 鱼.
candidateCountOnMp integer · int64 候选人数量在MP.
inPromotionCountOnMp integer · int64 在促销部下
{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}
错误4

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

GET

产品出口

/api/promotion/{promotionId}/product/export
读取访问的标志

使用GET/api/promotion/{promotionId}/product/export.的产品出口

路径参数

字段类型必填描述
promotionId integer · int64 提升身份证.

查询参数

字段类型必填描述
dateFrom string · date-time 时间从.
dateTo string · date-time 约会到.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
reDownload boolean 接下来.
clientOrganizationId integer · int64 客户组织身份证.
minMargin number · double 没有任何限制.
minMarginPercent number · double 利率最低百分比.
isActive boolean 现在还在行动.
isDeleted boolean 已被删除.
query string 问问.
promotionIdOnMp integer · int64 优惠名单在MP上
categoryId integer · int64 类别的ID.
categoryIds integer[] 类别的身份证.
clientId integer · int64 客户身份证.
inStock boolean 在斯托克.
isNotFound boolean 没有找到.
limit integer · int32 限制.
page integer · int32 页面.
count boolean 伯爵.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER 排序了.
ascending boolean 升高.
curl --request GET 'https://api.selsup.ru/api/promotion/1001/product/export?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

成功的反应

200
"string"
错误7

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_cant_download_file
文件无法生成。写给支持

应用逻辑中使用稳定的error_cant_download_file代码;localMessage包含上述翻译.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

400error_promotion_not_found
促销活动未找到

应用逻辑中使用稳定的error_promotion_not_found代码;localMessage包含上述翻译.

400error_service_not_found
未选择市场

应用逻辑中使用稳定的error_service_not_found代码;localMessage包含上述翻译.

GET

找一个

/api/promotion/product/find
读取访问的标志

使用 GET 找到 /api/promotion/product/find.

查询参数

字段类型必填描述
dateFrom string · date-time 时间从.
dateTo string · date-time 约会到.
promotionId integer · int64 提升身份证.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
reDownload boolean 接下来.
clientOrganizationId integer · int64 客户组织身份证.
minMargin number · double 没有任何限制.
minMarginPercent number · double 利率最低百分比.
isActive boolean 现在还在行动.
isDeleted boolean 已被删除.
query string 问问.
promotionIdOnMp integer · int64 优惠名单在MP上
categoryId integer · int64 类别的ID.
categoryIds integer[] 类别的身份证.
clientId integer · int64 客户身份证.
inStock boolean 在斯托克.
isNotFound boolean 没有找到.
limit integer · int32 限制.
page integer · int32 页面.
count boolean 伯爵.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER 排序了.
ascending boolean 升高.
curl --request GET 'https://api.selsup.ru/api/promotion/product/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

成功的反应

200
对象场 FindResponseProductPromotion
字段类型必填描述
rows ProductPromotion[] 排列.
阵列项结构 ProductPromotion
字段类型必填描述
categoryName string 类别名称
brandName string 品牌名字.
subject string 问题.
purchasePrice number · double 买价.
deliveryCost number · double 交货成本
additionalCost number · double 额外的成本
barcode string 条码.
instockQuantity integer · int64 存量量
wildberriesStockCount integer · int64 野生果股票数量.
yandexMarketStockCount integer · int64 亚兰德克斯市场股票计数.
createdDate string · date-time 创造日期.
minPrice number · double 价格不到.
isDuplicate boolean 是复制.
ozonArticle string 臭氧条款
ozonStockCount integer · int64 子股票计数.
salesExpensesOnMpPercent number · double 销售费用在MP百分比上
taxeRate number · double 税率.
width integer · int32 宽度.
height integer · int32 高.
depth integer · int32 深度.
ozonPurchasePercent number · double 气购买率
warehouseRatio number · double 仓库比例.
wildberriesCommission number · double 野生果委员会.
wildberriesFbwCommission number · double 野生果Fbw委员会.
wildberriesFbsCommission number · double 野生果联邦调查委员会.
wildberriesDbsCommission number · double 野生果食品委员会.
wildberriesEdbsCommission number · double 野生果养殖委员会.
wildberriesCAndCCommission number · double 果和果委员会.
wildberriesBookingCommission number · double 野生果预订委员会.
wildberriesAdditionalExpenses number · double 其他费用
ozonAdditionalExpenses number · double 臭氧额外支出
ozonCommission number · double 臭氧委员会
wildberriesId integer · int64 果的身份证.
productId integer · int64 产品身份证
promotionId integer · int64 提升身份证.
ozonFbsCommission number · double 子联邦调查委员会.
ozonFboCommission number · double 子贸易委员会
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
acquiringPercent number · double 获得百分比.
currentPrice number · double 现在的价格.
currentPriceWithoutDiscount number · double 现货价格没有折扣.
plannedPrice number · double 计划的价格.
totalStockCount integer · int64 总股票数量.
commissionReduction number · double 减少委员会.
profitDifference number · double 利差异
marginDifference number · double 边缘差异
markupDifference number · double 标记差异.
plannedAndMinPriceDiff number · double 计划和最低价格差异
incomeDifference number · double 收入差异
currentDiscount number · double 现在的折扣.
productCreatedDate string · date-time 产品创建日期
mainImageUrl string 标签: 标题:
isProfitably boolean 利的.
taskId integer · int64 任务身份证.
serviceArticle string 服务条款
article string 关于此的文章.
daysCountOnService integer · int32 服务时间是数日的.
turnover integer · int32 转换时间.
fboStock integer · int32 美国联邦调查局.
fbsStock integer · int32 联邦调查局.
newDiscountForPromotion number · double 促销额度新折扣.
saleLogistics number · double 销售物流.
returnLogistics number · double 返回物流.
purchasePercent number · double 购买百分比.
totalLogistics number · double 总物流.
commissions number · double 佣金.
currentProfit number · double 现在的利.
promotionProfit number · double 提升利.
currentMarginality number · double 现在的边缘化.
promotionMarginality number · double 晋升边缘化.
currentMarkUp number · double 现在的标记.
promotionMarkUp number · double 提升,提升.
additionalDiscountForPromotionRub number · double 更多的优惠.
additionalDiscountForPromotionPercent number · double 促销额外折扣.
isDeleted boolean 已被删除.
organizationId integer · int64 组织身份证.
clientId integer · int64 客户身份证.
addMode string 加入模式.
ozonAverageExpenses number · double 臭氧平均支出
isActive boolean 现在还在行动.
changeName string 改变名字.
changeDate string · date-time 改变日期.
productName string 产品名称
id integer · int64 Id.
totalCount integer · int64 总计.
serviceCard string 服务卡.
isNotFound boolean 没有找到.
isArchived boolean 已被存档.
productCommissions string 产品委员会
currentGrossProfit number · double 现货总利
plannedGrossProfit number · double 预计的总利.
{
  "rows": "string"
}
错误4

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

GET

所有的

/api/promotion/find
读取访问的标志

所有使用 GET /api/promotion/find.

查询参数

字段类型必填描述
dateFrom string · date-time 时间从.
dateTo string · date-time 约会到.
promotionId integer · int64 提升身份证.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
reDownload boolean 接下来.
clientOrganizationId integer · int64 客户组织身份证.
minMargin number · double 没有任何限制.
minMarginPercent number · double 利率最低百分比.
isActive boolean 现在还在行动.
isDeleted boolean 已被删除.
query string 问问.
promotionIdOnMp integer · int64 优惠名单在MP上
categoryId integer · int64 类别的ID.
categoryIds integer[] 类别的身份证.
clientId integer · int64 客户身份证.
inStock boolean 在斯托克.
isNotFound boolean 没有找到.
limit integer · int32 限制.
page integer · int32 页面.
count boolean 伯爵.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER 排序了.
ascending boolean 升高.
curl --request GET 'https://api.selsup.ru/api/promotion/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

成功的反应

200
对象场 FindResponsePromotion
字段类型必填描述
rows Promotion[] 排列.
阵列项结构 Promotion
字段类型必填描述
promotionId integer · int64 提升身份证.
id integer · int64 Id.
totalCount integer · int64 总计.
name string 姓名.
dateStart string · date-time 开始日期.
dateEnd string · date-time 约会结束.
changeCommission boolean 改变委员会.
changeCommissionAmount number · double 改变佣金金额
createdDate string · date-time 创造日期.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
isDeleted boolean 已被删除.
description string 描述
promotionIdOnMp string 优惠名单在MP上
clientId integer · int64 客户身份证.
organizationId integer · int64 组织身份证.
candidateCount integer · int64 候选人伯爵.
inPromotionCount integer · int64 在晋升计数.
auto boolean 车辆.
hotsale boolean 鱼.
candidateCountOnMp integer · int64 候选人数量在MP.
inPromotionCountOnMp integer · int64 在促销部下
{
  "rows": "string"
}
错误5

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

400error_service_not_found
未选择市场

应用逻辑中使用稳定的error_service_not_found代码;localMessage包含上述翻译.

GET

进口

/api/promotion/export
读取访问的标志

使用GET/api/promotion/export.出口

查询参数

字段类型必填描述
dateFrom string · date-time 时间从.
dateTo string · date-time 约会到.
promotionId integer · int64 提升身份证.
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC 服务.
reDownload boolean 接下来.
clientOrganizationId integer · int64 客户组织身份证.
minMargin number · double 没有任何限制.
minMarginPercent number · double 利率最低百分比.
isActive boolean 现在还在行动.
isDeleted boolean 已被删除.
query string 问问.
promotionIdOnMp integer · int64 优惠名单在MP上
categoryId integer · int64 类别的ID.
categoryIds integer[] 类别的身份证.
clientId integer · int64 客户身份证.
inStock boolean 在斯托克.
isNotFound boolean 没有找到.
limit integer · int32 限制.
page integer · int32 页面.
count boolean 伯爵.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER 排序了.
ascending boolean 升高.
curl --request GET 'https://api.selsup.ru/api/promotion/export?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

成功的反应

200
"string"
错误6

应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑

401auth_required
需要进行认证

Authorization 缺失,空,或包含无效的代币.

400error_access_denied
拒绝访问

代币存在,但它的作用不能执行这个操作.

500error_unknown
发生了一个未知的错误。如果该问题再次发生,请联系支持

节省请求时间和联系支持;不要盲目重新尝试突变.

400error_cant_download_file
文件无法生成。写给支持

应用逻辑中使用稳定的error_cant_download_file代码;localMessage包含上述翻译.

400error_no_client
没有找到该客户或已被删除。写信给支持部门

应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.

400error_service_not_found
未选择市场

应用逻辑中使用稳定的error_service_not_found代码;localMessage包含上述翻译.

Authorization

测试请求的标志

代币存储在本浏览器的本地存储库中,只会在要求的Authorization头上发送到 api.selsup.ru.

试一试

实际请求参数

现场API响应

发送请求查看SelSup的响应.