SelSup Developers

API · API Đề xuất

Tăng chức

Các điểm cuối của các chương trình khuyến mãi, bao gồm các tuyến đường chính xác, các tham số, cơ quan yêu cầu và các chương hoạch phản ứng có thể mở rộng.

11 điểm cuối/api/promotionThường ổn địnhMô tả có thể đọc được bằng máy ↗
{ }

Trang này được hỗ trợ bởi một hợp đồng độc lập có thể chỉnh sửa. Thiết lập các hoạt động viết bằng dữ liệu thử nghiệm trước khi sử dụng sản xuất.

/api/promotion

Các dòng công việc sẵn sàng sử dụng

Các dòng công việc sẵn sàng sử dụng

01

Bắt đầu sử dụng Promotions

Sử dụng mã thông báo API chuyên dụng và xác nhận các hoạt động đọc bằng dữ liệu thử nghiệm trước.

  1. Giữ token bên máy chủ và gửi nó trong tiêu đề Authorization.
  2. Kiểm tra các tham số cần thiết và mở rộng quy trình yêu cầu hoặc phản hồi.
  3. xử lý trạng thái HTTP và trường error ổn định trong lỗi ứng dụng.

Mô hình dữ liệu

Các cấu trúc dữ liệu

Các mô hình được liệt kê một lần ở đây và cũng có thể được mở rộng trực tiếp từ các điểm cuối sử dụng chúng.

Promotion21 trường
promotionIdinteger · int64

Thẻ nhận được thăng chức.

idinteger · int64

Id.

totalCountinteger · int64

Tổng số.

namestring

Tên.

dateStartstring · date-time

Ngày bắt đầu.

dateEndstring · date-time

Kết thúc ngày.

changeCommissionboolean

Thay đổi Ủy ban.

changeCommissionAmountnumber · double

Thay đổi số tiền ủy ban.

createdDatestring · date-time

Ngày được tạo ra.

servicestring

Dịch vụ.

isDeletedboolean

Được xóa.

descriptionstring

Mô tả.

promotionIdOnMpstring

Đăng ký danh sách trên Mp.

clientIdinteger · int64

- Đồ nhận khách hàng.

organizationIdinteger · int64

Đơn vị tổ chức.

candidateCountinteger · int64

- Tham mưu.

inPromotionCountinteger · int64

Trong số lượng thăng chức.

autoboolean

- Ô tô.

hotsaleboolean

Hotsale.

candidateCountOnMpinteger · int64

Ứng viên đếm vào MP.

inPromotionCountOnMpinteger · int64

Trong chương trình khuyến mãi Count On Mp.

TmsTask25 trường
idinteger · int64

Id.

read-only
statusstring

Status.

read-only
typestring

Type.

read-only
namestring

Tên.

clientIdinteger · int64

- Đồ nhận khách hàng.

entityIdinteger · int64

Đơn vị nhận dạng.

progressinteger · int32

- Tiến bộ.

processedQuantityinteger · int32

Số lượng xử lý.

organizationIdinteger · int64

Đơn vị tổ chức.

priorityinteger · int32

Tự ưu tiên.

propertiesstring

Các tài sản.

messagestring

Thông điệp.

messageParamsstring

Tin nhắn Params.

createdDatestring · date-time

Ngày được tạo ra.

startDatestring · date-time

Ngày bắt đầu.

finishDatestring · date-time

Ngày kết thúc.

urlstring

Url.

inputFileUrlstring

Đăng file URL.

retryNumberinteger · int32

Lần thử lại.

userIdinteger · int32

ID người dùng.

retryDatestring · date-time

Ngày thử lại.

debugboolean

Tháo gỡ.

forcedStartboolean

Bắt đầu bắt buộc.

servicestring

Dịch vụ.

langstring

Lang.

ProductPromotion91 trường
categoryNamestring

Tên hạng mục.

brandNamestring

Tên thương hiệu.

subjectstring

- Đối tượng.

purchasePricenumber · double

Giá mua.

deliveryCostnumber · double

Chi phí giao hàng.

additionalCostnumber · double

Chi phí bổ sung.

barcodestring

Mã vạch.

instockQuantityinteger · int64

Số lượng dự trữ.

wildberriesStockCountinteger · int64

Số lượng cổ phiếu của Wildberries.

yandexMarketStockCountinteger · int64

Yandex Market Stock Count.

createdDatestring · date-time

Ngày được tạo ra.

minPricenumber · double

Min Price.

isDuplicateboolean

- Có thể là Duplicate.

ozonArticlestring

Điều Ozon.

ozonStockCountinteger · int64

Hình dung Ozon Stock.

salesExpensesOnMpPercentnumber · double

Chi phí bán hàng trên MP phần trăm.

taxeRatenumber · double

Tỷ lệ thuế.

widthinteger · int32

Lớn.

heightinteger · int32

Tốc độ.

depthinteger · int32

Đâu sâu.

ozonPurchasePercentnumber · double

Phụ phần trăm mua ôzô.

warehouseRationumber · double

Tỷ lệ kho.

wildberriesCommissionnumber · double

Ủy ban Wildberries.

wildberriesFbwCommissionnumber · double

Ủy ban Fbw Wildberries.

wildberriesFbsCommissionnumber · double

Ủy ban FBI Wildberries.

wildberriesDbsCommissionnumber · double

Ủy ban DBS Wildberries.

wildberriesEdbsCommissionnumber · double

Ủy ban Wildberries Edbs.

wildberriesCAndCCommissionnumber · double

Wildberries C và C.

wildberriesBookingCommissionnumber · double

Ủy ban đặt phòng Wildberries.

wildberriesAdditionalExpensesnumber · double

Chi phí bổ sung của Wildberries.

ozonAdditionalExpensesnumber · double

Chi phí bổ sung về Ozon.

ozonCommissionnumber · double

Ủy ban Ozon.

wildberriesIdinteger · int64

- Thẻ của Wildberries.

productIdinteger · int64

Đơn vị sản phẩm

promotionIdinteger · int64

Thẻ nhận được thăng chức.

ozonFbsCommissionnumber · double

Ủy ban Ozon Fbs.

ozonFboCommissionnumber · double

Ủy ban Ozon FBO.

servicestring

Dịch vụ.

acquiringPercentnumber · double

Thu thập phần trăm.

currentPricenumber · double

Giá hiện tại.

currentPriceWithoutDiscountnumber · double

Giá hiện tại mà không giảm giá.

plannedPricenumber · double

Giá dự định.

totalStockCountinteger · int64

Tổng số lượng cổ phiếu.

commissionReductionnumber · double

Thuế giảm.

profitDifferencenumber · double

Sự khác biệt lợi nhuận.

marginDifferencenumber · double

Sự khác biệt về lợi nhuận.

markupDifferencenumber · double

Sự khác biệt đánh dấu.

plannedAndMinPriceDiffnumber · double

Sự khác biệt giá cả được lên kế hoạch và giảm thiểu.

incomeDifferencenumber · double

Sự khác biệt về thu nhập.

currentDiscountnumber · double

Giảm giá hiện tại.

productCreatedDatestring · date-time

Ngày sản phẩm được tạo ra.

mainImageUrlstring

Hình ảnh chính Url.

isProfitablyboolean

Có lợi nhuận.

taskIdinteger · int64

Đơn vị nhiệm vụ.

serviceArticlestring

Điều dịch vụ.

articlestring

Bài viết.

daysCountOnServiceinteger · int32

Ngày được tính vào dịch vụ.

turnoverinteger · int32

Lượng chuyển nhượng.

fboStockinteger · int32

Fbo Stock.

fbsStockinteger · int32

- FBS Stock.

newDiscountForPromotionnumber · double

Giá giảm mới cho chương trình khuyến mãi.

saleLogisticsnumber · double

Thuốc bán hàng.

returnLogisticsnumber · double

Trả lại Logistics.

purchasePercentnumber · double

% mua hàng.

totalLogisticsnumber · double

Tổng logistics.

commissionsnumber · double

Thuộc thầu.

currentProfitnumber · double

Lợi nhuận hiện tại.

promotionProfitnumber · double

Lợi nhuận thăng chức.

currentMarginalitynumber · double

Sự bớt lợi nhuận hiện tại.

promotionMarginalitynumber · double

Tăng chức.

currentMarkUpnumber · double

Đánh dấu hiện tại.

promotionMarkUpnumber · double

Tăng chức, đánh dấu lên.

additionalDiscountForPromotionRubnumber · double

Thêm giảm giá cho việc thăng chức.

additionalDiscountForPromotionPercentnumber · double

Thêm giảm giá cho phần trăm khuyến mãi.

isDeletedboolean

Được xóa.

organizationIdinteger · int64

Đơn vị tổ chức.

clientIdinteger · int64

- Đồ nhận khách hàng.

addModestring

Thêm Mode.

ozonAverageExpensesnumber · double

Chi phí trung bình Ozon.

isActiveboolean

- Nó hoạt động.

changeNamestring

Thay đổi tên.

changeDatestring · date-time

Thay đổi ngày.

productNamestring

Tên sản phẩm

idinteger · int64

Id.

totalCountinteger · int64

Tổng số.

serviceCardstring

Thẻ phục vụ.

isNotFoundboolean

Không tìm thấy.

isArchivedboolean

Được lưu trữ.

productCommissionsstring

Ủy ban sản phẩm.

currentGrossProfitnumber · double

Lợi nhuận tổng hiện tại.

plannedGrossProfitnumber · double

Lợi nhuận tổng dự kiến.

OzonProduct4 trường
product_idinteger · int64

Đơn vị sản phẩm.

action_pricenumber · double

Giá hành động.

stockinteger · int32

- Đồ đạc.

reasonstring

Lý do.

FindResponseProductPromotion1 trường
rowsProductPromotion[]

Đường.

FindResponsePromotion1 trường
rowsPromotion[]

Đường.

Hợp đồng lỗi

Cách trả lại lỗi ứng dụng

Mã error giống nhau ở mọi địa điểm, trong khi thông điệp đối diện người dùng được dịch bởi máy chủ. Xây dựng logic ứng dụng xung quanh error và sử dụng localMessage chỉ cho hiển thị.

error

Mã máy tính có thể đọc ổn định cho logic tích hợp.

localMessage

Thông điệp sẵn sàng hiển thị trong ngôn ngữ của người dùng mã thông báo API.

params

Các giá trị được máy chủ liên kết vào mẫu tin nhắn địa phương.

localMessage sử dụng trường lang của người dùng sở hữu mã thông báo API. Ngôn ngữ tài liệu và tiêu đề Accept-Language không thay đổi nó; tiếng Nga được sử dụng khi người dùng không có ngôn ngữ được cấu hình.

RUUser locale là ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
VNTiếng Việt (vn)
{
  "error": "error_brand_already_exists",
  "localMessage": "Thương hiệu Base đã tồn tại",
  "params": {
    "name": "Base"
  }
}

Điểm cuối

Điểm cuối

PUT

Đưa lên sự thăng tiến

/api/promotion/{promotionId}
Tấm mã với quyền truy cập viết

Đặt Tăng Ưu điểm sử dụng PUT /api/promotion/{promotionId}.

Cơ quan yêu cầu

application/json
Các trường đối tượngPromotion
TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Không Thẻ nhận được thăng chức.
id integer · int64 Không Id.
totalCount integer · int64 Không Tổng số.
name string Không Tên.
dateStart string · date-time Không Ngày bắt đầu.
dateEnd string · date-time Không Kết thúc ngày.
changeCommission boolean Không Thay đổi Ủy ban.
changeCommissionAmount number · double Không Thay đổi số tiền ủy ban.
createdDate string · date-time Không Ngày được tạo ra.
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 Không Dịch vụ.
isDeleted boolean Không Được xóa.
description string Không Mô tả.
promotionIdOnMp string Không Đăng ký danh sách trên Mp.
clientId integer · int64 Không - Đồ nhận khách hàng.
organizationId integer · int64 Không Đơn vị tổ chức.
candidateCount integer · int64 Không - Tham mưu.
inPromotionCount integer · int64 Không Trong số lượng thăng chức.
auto boolean Không - Ô tô.
hotsale boolean Không Hotsale.
candidateCountOnMp integer · int64 Không Ứng viên đếm vào MP.
inPromotionCountOnMp integer · int64 Không Trong chương trình khuyến mãi 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"
}'

Phản ứng thành công

200
Các trường đối tượng Promotion
TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Không Thẻ nhận được thăng chức.
id integer · int64 Không Id.
totalCount integer · int64 Không Tổng số.
name string Không Tên.
dateStart string · date-time Không Ngày bắt đầu.
dateEnd string · date-time Không Kết thúc ngày.
changeCommission boolean Không Thay đổi Ủy ban.
changeCommissionAmount number · double Không Thay đổi số tiền ủy ban.
createdDate string · date-time Không Ngày được tạo ra.
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 Không Dịch vụ.
isDeleted boolean Không Được xóa.
description string Không Mô tả.
promotionIdOnMp string Không Đăng ký danh sách trên Mp.
clientId integer · int64 Không - Đồ nhận khách hàng.
organizationId integer · int64 Không Đơn vị tổ chức.
candidateCount integer · int64 Không - Tham mưu.
inPromotionCount integer · int64 Không Trong số lượng thăng chức.
auto boolean Không - Ô tô.
hotsale boolean Không Hotsale.
candidateCountOnMp integer · int64 Không Ứng viên đếm vào MP.
inPromotionCountOnMp integer · int64 Không Trong chương trình khuyến mãi Count On Mp.
{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}
Hầm lẫn4

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

PATCH

Khôi phục lại sự thăng tiến bằng ID

/api/promotion/{promotionId}
Tấm mã với quyền truy cập viết

Khôi phục quảng cáo bằng ID bằng cách sử dụng PATCH /api/promotion/{promotionId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Thẻ nhận được thăng chức.
curl --request PATCH 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

DELETE

Xóa quảng cáo bằng ID

/api/promotion/{promotionId}
Tấm mã với quyền truy cập viết

Xóa quảng cáo bằng ID bằng cách sử dụng DELETE /api/promotion/{promotionId}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Thẻ nhận được thăng chức.
curl --request DELETE 'https://api.selsup.ru/api/promotion/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200

Phản ứng không có cơ thể.

Hầm lẫn3

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

POST

Cập nhật

/api/promotion/update/{service}
Tấm mã với quyền truy cập viết

Cập nhật sử dụng POST /api/promotion/update/{service}.

Các tham số đường

TrườngLoạiBắt buộcMô tả
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 Dịch vụ.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Không Đơn vị tổ chức.
curl --request POST 'https://api.selsup.ru/api/promotion/update/NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng TmsTask
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Không 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 Không Type.
name string Không Tên.
clientId integer · int64 Không - Đồ nhận khách hàng.
entityId integer · int64 Không Đơn vị nhận dạng.
progress integer · int32 Không - Tiến bộ.
processedQuantity integer · int32 Không Số lượng xử lý.
organizationId integer · int64 Không Đơn vị tổ chức.
priority integer · int32 Không Tự ưu tiên.
properties string Không Các tài sản.
message string Không Thông điệp.
messageParams string Không Tin nhắn Params.
createdDate string · date-time Không Ngày được tạo ra.
startDate string · date-time Không Ngày bắt đầu.
finishDate string · date-time Không Ngày kết thúc.
url string Không Url.
inputFileUrl string Không Đăng file URL.
retryNumber integer · int32 Không Lần thử lại.
userId integer · int32 Không ID người dùng.
retryDate string · date-time Không Ngày thử lại.
debug boolean Không Tháo gỡ.
forcedStart boolean Không Bắt đầu bắt buộc.
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 Không Dịch vụ.
lang string Không Lang.
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Hầm lẫn36

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_cannot_deleted_order_product
Không thể xóa một sản phẩm mà hàng hóa trong kho hoặc nhãn chưa ngừng hoạt động được liên kết

error cụ thể cho điểm cuối. Sử dụng mã error_cannot_deleted_order_product ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_competitor_id_required
Yêu cầu id đối thủ

error cụ thể cho điểm cuối. Sử dụng mã error_competitor_id_required ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_competitor_required
Phải có đối thủ

error cụ thể cho điểm cuối. Sử dụng mã error_competitor_required ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_competitor_service_required
Phải có dịch vụ đối thủ

error cụ thể cho điểm cuối. Sử dụng mã error_competitor_service_required ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_competitor_url_required
Phải có URL đối thủ

error cụ thể cho điểm cuối. Sử dụng mã error_competitor_url_required ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_customer_not_found
Không tìm thấy khách hàng

error cụ thể cho điểm cuối. Sử dụng mã error_customer_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_duplicate_order_product
Hai mặt hàng giống hệt nhau {productId}đã được thêm vào đơn đặt hàng

error cụ thể cho điểm cuối. Sử dụng mã error_duplicate_order_product ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_warehouse
Kho hàng không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_empty_warehouse ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_group_already_exist
Nhóm đã tồn tại

error cụ thể cho điểm cuối. Sử dụng mã error_group_already_exist ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_incorrect_order_data
Không thể tạo đơn hàng do tổ chức, kho hoặc người dùng đã bị xóa: {id}

error cụ thể cho điểm cuối. Sử dụng mã error_incorrect_order_data ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_invalid_url
Địa chỉ trang web không chính xác, phải bắt đầu bằng http:// hoặc https://, không được thêm từ selsup, localhost vào địa chỉ

error cụ thể cho điểm cuối. Sử dụng mã error_invalid_url ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_moy_sklad_organization
không tìm thấy tổ chức trong MoiSklad

error cụ thể cho điểm cuối. Sử dụng mã error_moy_sklad_organization ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_ms_error
Lỗi API Kho hàng của tôi: {message}

error cụ thể cho điểm cuối. Sử dụng mã error_ms_error ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_ms_no_warehouse
Kết nối của kho SelSup với kho dịch vụ kho của tôi không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_ms_no_warehouse ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_ms_update_order_state
Không thể cập nhật trạng thái đơn hàng trong MoiSklad

error cụ thể cho điểm cuối. Sử dụng mã error_ms_update_order_state ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_marketplace
Thị trường không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_no_marketplace ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_organization
Tổ chức không được chỉ định

error cụ thể cho điểm cuối. Sử dụng mã error_no_organization ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_price_for_order_product
Giá không được chỉ định cho sản phẩm: {name}

error cụ thể cho điểm cuối. Sử dụng mã error_no_price_for_order_product ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_products_in_order
Không tìm thấy sản phẩm nào trong đơn hàng này

error cụ thể cho điểm cuối. Sử dụng mã error_no_products_in_order ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_quantity_for_order_product
Số lượng sản phẩm không được chỉ định: {name}

error cụ thể cho điểm cuối. Sử dụng mã error_no_quantity_for_order_product ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_not_reserved
Đặt chỗ chỉ có thể được rút từ hàng hóa đặt trước

error cụ thể cho điểm cuối. Sử dụng mã error_not_reserved ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_not_uniq_external_id
Số bên ngoài {id} đã được sử dụng cho một đơn đặt hàng khác

error cụ thể cho điểm cuối. Sử dụng mã error_not_uniq_external_id ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_order_not_found
Không tìm thấy đơn đặt hàng

error cụ thể cho điểm cuối. Sử dụng mã error_order_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_order_product_stock
Không thể xóa sản phẩm sau khi đã nhập kho tồn

error cụ thể cho điểm cuối. Sử dụng mã error_order_product_stock ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_product_not_found_by_id
Không tìm thấy sản phẩm nào theo ID. Có thể bạn đã xóa sản phẩm trong quá trình nhập

error cụ thể cho điểm cuối. Sử dụng mã error_product_not_found_by_id ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_source_cell_change_not_allowed_for_inter_warehouse_movement
Không được phép thay đổi ô nguồn cho việc di chuyển giữa các kho

error cụ thể cho điểm cuối. Sử dụng mã error_source_cell_change_not_allowed_for_inter_warehouse_movement ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_stock_update_busy
Hiện tại đang tiến hành cập nhật tồn kho, vui lòng thử lại sau

error cụ thể cho điểm cuối. Sử dụng mã error_stock_update_busy ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_token_expired_or_revoked
Mã thông báo API bị thu hồi hoặc nhập không chính xác

error cụ thể cho điểm cuối. Sử dụng mã error_token_expired_or_revoked ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_unsupported_service
Thị trường không được hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_unsupported_service ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_warehouse_not_found
Kho không tìm thấy

error cụ thể cho điểm cuối. Sử dụng mã error_warehouse_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_wms_item_not_found
Không tìm thấy mã mặt hàng duy nhất

error cụ thể cho điểm cuối. Sử dụng mã error_wms_item_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

POST

Xóa sản phẩm trong quảng cáo

/api/promotion/deleteProductsInPromotion
Tấm mã với quyền truy cập viết

Xóa sản phẩm trong quảng cáo bằng cách sử dụng POST /api/promotion/deleteProductsInPromotion.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Thẻ nhận được thăng chức.
clientOrganizationId integer · int64 Đơn vị tổ chức khách hàng.

Cơ quan yêu cầu

application/json
Cấu trúc của mục arrayProductPromotion[]
TrườngLoạiBắt buộcMô tả
categoryName string Không Tên hạng mục.
brandName string Không Tên thương hiệu.
subject string Không - Đối tượng.
purchasePrice number · double Không Giá mua.
deliveryCost number · double Không Chi phí giao hàng.
additionalCost number · double Không Chi phí bổ sung.
barcode string Không Mã vạch.
instockQuantity integer · int64 Không Số lượng dự trữ.
wildberriesStockCount integer · int64 Không Số lượng cổ phiếu của Wildberries.
yandexMarketStockCount integer · int64 Không Yandex Market Stock Count.
createdDate string · date-time Không Ngày được tạo ra.
minPrice number · double Không Min Price.
isDuplicate boolean Không - Có thể là Duplicate.
ozonArticle string Không Điều Ozon.
ozonStockCount integer · int64 Không Hình dung Ozon Stock.
salesExpensesOnMpPercent number · double Không Chi phí bán hàng trên MP phần trăm.
taxeRate number · double Không Tỷ lệ thuế.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
ozonPurchasePercent number · double Không Phụ phần trăm mua ôzô.
warehouseRatio number · double Không Tỷ lệ kho.
wildberriesCommission number · double Không Ủy ban Wildberries.
wildberriesFbwCommission number · double Không Ủy ban Fbw Wildberries.
wildberriesFbsCommission number · double Không Ủy ban FBI Wildberries.
wildberriesDbsCommission number · double Không Ủy ban DBS Wildberries.
wildberriesEdbsCommission number · double Không Ủy ban Wildberries Edbs.
wildberriesCAndCCommission number · double Không Wildberries C và C.
wildberriesBookingCommission number · double Không Ủy ban đặt phòng Wildberries.
wildberriesAdditionalExpenses number · double Không Chi phí bổ sung của Wildberries.
ozonAdditionalExpenses number · double Không Chi phí bổ sung về Ozon.
ozonCommission number · double Không Ủy ban Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
productId integer · int64 Không Đơn vị sản phẩm
promotionId integer · int64 Không Thẻ nhận được thăng chức.
ozonFbsCommission number · double Không Ủy ban Ozon Fbs.
ozonFboCommission number · double Không Ủy ban Ozon FBO.
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 Không Dịch vụ.
acquiringPercent number · double Không Thu thập phần trăm.
currentPrice number · double Không Giá hiện tại.
currentPriceWithoutDiscount number · double Không Giá hiện tại mà không giảm giá.
plannedPrice number · double Không Giá dự định.
totalStockCount integer · int64 Không Tổng số lượng cổ phiếu.
commissionReduction number · double Không Thuế giảm.
profitDifference number · double Không Sự khác biệt lợi nhuận.
marginDifference number · double Không Sự khác biệt về lợi nhuận.
markupDifference number · double Không Sự khác biệt đánh dấu.
plannedAndMinPriceDiff number · double Không Sự khác biệt giá cả được lên kế hoạch và giảm thiểu.
incomeDifference number · double Không Sự khác biệt về thu nhập.
currentDiscount number · double Không Giảm giá hiện tại.
productCreatedDate string · date-time Không Ngày sản phẩm được tạo ra.
mainImageUrl string Không Hình ảnh chính Url.
isProfitably boolean Không Có lợi nhuận.
taskId integer · int64 Không Đơn vị nhiệm vụ.
serviceArticle string Không Điều dịch vụ.
article string Không Bài viết.
daysCountOnService integer · int32 Không Ngày được tính vào dịch vụ.
turnover integer · int32 Không Lượng chuyển nhượng.
fboStock integer · int32 Không Fbo Stock.
fbsStock integer · int32 Không - FBS Stock.
newDiscountForPromotion number · double Không Giá giảm mới cho chương trình khuyến mãi.
saleLogistics number · double Không Thuốc bán hàng.
returnLogistics number · double Không Trả lại Logistics.
purchasePercent number · double Không % mua hàng.
totalLogistics number · double Không Tổng logistics.
commissions number · double Không Thuộc thầu.
currentProfit number · double Không Lợi nhuận hiện tại.
promotionProfit number · double Không Lợi nhuận thăng chức.
currentMarginality number · double Không Sự bớt lợi nhuận hiện tại.
promotionMarginality number · double Không Tăng chức.
currentMarkUp number · double Không Đánh dấu hiện tại.
promotionMarkUp number · double Không Tăng chức, đánh dấu lên.
additionalDiscountForPromotionRub number · double Không Thêm giảm giá cho việc thăng chức.
additionalDiscountForPromotionPercent number · double Không Thêm giảm giá cho phần trăm khuyến mãi.
isDeleted boolean Không Được xóa.
organizationId integer · int64 Không Đơn vị tổ chức.
clientId integer · int64 Không - Đồ nhận khách hàng.
addMode string Không Thêm Mode.
ozonAverageExpenses number · double Không Chi phí trung bình Ozon.
isActive boolean Không - Nó hoạt động.
changeName string Không Thay đổi tên.
changeDate string · date-time Không Thay đổi ngày.
productName string Không Tên sản phẩm
id integer · int64 Không Id.
totalCount integer · int64 Không Tổng số.
serviceCard string Không Thẻ phục vụ.
isNotFound boolean Không Không tìm thấy.
isArchived boolean Không Được lưu trữ.
productCommissions string Không Ủy ban sản phẩm.
currentGrossProfit number · double Không Lợi nhuận tổng hiện tại.
plannedGrossProfit number · double Không Lợi nhuận tổng dự kiến.
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"
]'

Phản ứng thành công

200
Cấu trúc của mục array OzonProduct[]
TrườngLoạiBắt buộcMô tả
product_id integer · int64 Không Đơn vị sản phẩm.
action_price number · double Không Giá hành động.
stock integer · int32 Không - Đồ đạc.
reason string Không Lý do.
[
  "string"
]
Hầm lẫn11

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_auto_promotion_not_supported
Không thể thêm sản phẩm vào chương trình khuyến mãi tự động

error cụ thể cho điểm cuối. Sử dụng mã error_auto_promotion_not_supported ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_ozon_id
ID Ozon trống

error cụ thể cho điểm cuối. Sử dụng mã error_empty_ozon_id ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_promotion_exists
Yêu cầu thêm hàng hóa vào chương trình khuyến mãi đã được gửi trước đó. Không thể gửi lại

error cụ thể cho điểm cuối. Sử dụng mã error_promotion_exists ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_remote
Đã xảy ra lỗi khi yêu cầu dịch vụ bên ngoài

error cụ thể cho điểm cuối. Sử dụng mã error_remote ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_token_expired_or_revoked
Mã thông báo API bị thu hồi hoặc nhập không chính xác

error cụ thể cho điểm cuối. Sử dụng mã error_token_expired_or_revoked ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_wildberries_import_error
Hiện đang có bảo trì kỹ thuật từ phía WB. Vui lòng thử lại sau. Để biết thêm chi tiết, vui lòng liên hệ bộ phận hỗ trợ kỹ thuật của WB. (API: {message})

error cụ thể cho điểm cuối. Sử dụng mã error_wildberries_import_error ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

POST

Thêm sản phẩm trong quảng cáo

/api/promotion/addProductsInPromotion
Tấm mã với quyền truy cập viết

Thêm các sản phẩm trong quảng cáo bằng cách sử dụng POST /api/promotion/addProductsInPromotion.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Thẻ nhận được thăng chức.
clientOrganizationId integer · int64 Đơn vị tổ chức khách hàng.

Cơ quan yêu cầu

application/json
Cấu trúc của mục arrayProductPromotion[]
TrườngLoạiBắt buộcMô tả
categoryName string Không Tên hạng mục.
brandName string Không Tên thương hiệu.
subject string Không - Đối tượng.
purchasePrice number · double Không Giá mua.
deliveryCost number · double Không Chi phí giao hàng.
additionalCost number · double Không Chi phí bổ sung.
barcode string Không Mã vạch.
instockQuantity integer · int64 Không Số lượng dự trữ.
wildberriesStockCount integer · int64 Không Số lượng cổ phiếu của Wildberries.
yandexMarketStockCount integer · int64 Không Yandex Market Stock Count.
createdDate string · date-time Không Ngày được tạo ra.
minPrice number · double Không Min Price.
isDuplicate boolean Không - Có thể là Duplicate.
ozonArticle string Không Điều Ozon.
ozonStockCount integer · int64 Không Hình dung Ozon Stock.
salesExpensesOnMpPercent number · double Không Chi phí bán hàng trên MP phần trăm.
taxeRate number · double Không Tỷ lệ thuế.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
ozonPurchasePercent number · double Không Phụ phần trăm mua ôzô.
warehouseRatio number · double Không Tỷ lệ kho.
wildberriesCommission number · double Không Ủy ban Wildberries.
wildberriesFbwCommission number · double Không Ủy ban Fbw Wildberries.
wildberriesFbsCommission number · double Không Ủy ban FBI Wildberries.
wildberriesDbsCommission number · double Không Ủy ban DBS Wildberries.
wildberriesEdbsCommission number · double Không Ủy ban Wildberries Edbs.
wildberriesCAndCCommission number · double Không Wildberries C và C.
wildberriesBookingCommission number · double Không Ủy ban đặt phòng Wildberries.
wildberriesAdditionalExpenses number · double Không Chi phí bổ sung của Wildberries.
ozonAdditionalExpenses number · double Không Chi phí bổ sung về Ozon.
ozonCommission number · double Không Ủy ban Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
productId integer · int64 Không Đơn vị sản phẩm
promotionId integer · int64 Không Thẻ nhận được thăng chức.
ozonFbsCommission number · double Không Ủy ban Ozon Fbs.
ozonFboCommission number · double Không Ủy ban Ozon FBO.
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 Không Dịch vụ.
acquiringPercent number · double Không Thu thập phần trăm.
currentPrice number · double Không Giá hiện tại.
currentPriceWithoutDiscount number · double Không Giá hiện tại mà không giảm giá.
plannedPrice number · double Không Giá dự định.
totalStockCount integer · int64 Không Tổng số lượng cổ phiếu.
commissionReduction number · double Không Thuế giảm.
profitDifference number · double Không Sự khác biệt lợi nhuận.
marginDifference number · double Không Sự khác biệt về lợi nhuận.
markupDifference number · double Không Sự khác biệt đánh dấu.
plannedAndMinPriceDiff number · double Không Sự khác biệt giá cả được lên kế hoạch và giảm thiểu.
incomeDifference number · double Không Sự khác biệt về thu nhập.
currentDiscount number · double Không Giảm giá hiện tại.
productCreatedDate string · date-time Không Ngày sản phẩm được tạo ra.
mainImageUrl string Không Hình ảnh chính Url.
isProfitably boolean Không Có lợi nhuận.
taskId integer · int64 Không Đơn vị nhiệm vụ.
serviceArticle string Không Điều dịch vụ.
article string Không Bài viết.
daysCountOnService integer · int32 Không Ngày được tính vào dịch vụ.
turnover integer · int32 Không Lượng chuyển nhượng.
fboStock integer · int32 Không Fbo Stock.
fbsStock integer · int32 Không - FBS Stock.
newDiscountForPromotion number · double Không Giá giảm mới cho chương trình khuyến mãi.
saleLogistics number · double Không Thuốc bán hàng.
returnLogistics number · double Không Trả lại Logistics.
purchasePercent number · double Không % mua hàng.
totalLogistics number · double Không Tổng logistics.
commissions number · double Không Thuộc thầu.
currentProfit number · double Không Lợi nhuận hiện tại.
promotionProfit number · double Không Lợi nhuận thăng chức.
currentMarginality number · double Không Sự bớt lợi nhuận hiện tại.
promotionMarginality number · double Không Tăng chức.
currentMarkUp number · double Không Đánh dấu hiện tại.
promotionMarkUp number · double Không Tăng chức, đánh dấu lên.
additionalDiscountForPromotionRub number · double Không Thêm giảm giá cho việc thăng chức.
additionalDiscountForPromotionPercent number · double Không Thêm giảm giá cho phần trăm khuyến mãi.
isDeleted boolean Không Được xóa.
organizationId integer · int64 Không Đơn vị tổ chức.
clientId integer · int64 Không - Đồ nhận khách hàng.
addMode string Không Thêm Mode.
ozonAverageExpenses number · double Không Chi phí trung bình Ozon.
isActive boolean Không - Nó hoạt động.
changeName string Không Thay đổi tên.
changeDate string · date-time Không Thay đổi ngày.
productName string Không Tên sản phẩm
id integer · int64 Không Id.
totalCount integer · int64 Không Tổng số.
serviceCard string Không Thẻ phục vụ.
isNotFound boolean Không Không tìm thấy.
isArchived boolean Không Được lưu trữ.
productCommissions string Không Ủy ban sản phẩm.
currentGrossProfit number · double Không Lợi nhuận tổng hiện tại.
plannedGrossProfit number · double Không Lợi nhuận tổng dự kiến.
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"
]'

Phản ứng thành công

200
Cấu trúc của mục array OzonProduct[]
TrườngLoạiBắt buộcMô tả
product_id integer · int64 Không Đơn vị sản phẩm.
action_price number · double Không Giá hành động.
stock integer · int32 Không - Đồ đạc.
reason string Không Lý do.
[
  "string"
]
Hầm lẫn11

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_auto_promotion_not_supported
Không thể thêm sản phẩm vào chương trình khuyến mãi tự động

error cụ thể cho điểm cuối. Sử dụng mã error_auto_promotion_not_supported ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_empty_ozon_id
ID Ozon trống

error cụ thể cho điểm cuối. Sử dụng mã error_empty_ozon_id ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_organization_not_found
Không tìm thấy tổ chức

error cụ thể cho điểm cuối. Sử dụng mã error_organization_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_promotion_exists
Yêu cầu thêm hàng hóa vào chương trình khuyến mãi đã được gửi trước đó. Không thể gửi lại

error cụ thể cho điểm cuối. Sử dụng mã error_promotion_exists ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_remote
Đã xảy ra lỗi khi yêu cầu dịch vụ bên ngoài

error cụ thể cho điểm cuối. Sử dụng mã error_remote ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_token_expired_or_revoked
Mã thông báo API bị thu hồi hoặc nhập không chính xác

error cụ thể cho điểm cuối. Sử dụng mã error_token_expired_or_revoked ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_wildberries_import_error
Hiện đang có bảo trì kỹ thuật từ phía WB. Vui lòng thử lại sau. Để biết thêm chi tiết, vui lòng liên hệ bộ phận hỗ trợ kỹ thuật của WB. (API: {message})

error cụ thể cho điểm cuối. Sử dụng mã error_wildberries_import_error ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

POST

Tiếp tục thăng tiến

/api/promotion/
Tấm mã với quyền truy cập viết

Tiếp tục quảng bá bằng POST /api/promotion/.

Cơ quan yêu cầu

application/json
Các trường đối tượngPromotion
TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Không Thẻ nhận được thăng chức.
id integer · int64 Không Id.
totalCount integer · int64 Không Tổng số.
name string Không Tên.
dateStart string · date-time Không Ngày bắt đầu.
dateEnd string · date-time Không Kết thúc ngày.
changeCommission boolean Không Thay đổi Ủy ban.
changeCommissionAmount number · double Không Thay đổi số tiền ủy ban.
createdDate string · date-time Không Ngày được tạo ra.
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 Không Dịch vụ.
isDeleted boolean Không Được xóa.
description string Không Mô tả.
promotionIdOnMp string Không Đăng ký danh sách trên Mp.
clientId integer · int64 Không - Đồ nhận khách hàng.
organizationId integer · int64 Không Đơn vị tổ chức.
candidateCount integer · int64 Không - Tham mưu.
inPromotionCount integer · int64 Không Trong số lượng thăng chức.
auto boolean Không - Ô tô.
hotsale boolean Không Hotsale.
candidateCountOnMp integer · int64 Không Ứng viên đếm vào MP.
inPromotionCountOnMp integer · int64 Không Trong chương trình khuyến mãi 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"
}'

Phản ứng thành công

200
Các trường đối tượng Promotion
TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Không Thẻ nhận được thăng chức.
id integer · int64 Không Id.
totalCount integer · int64 Không Tổng số.
name string Không Tên.
dateStart string · date-time Không Ngày bắt đầu.
dateEnd string · date-time Không Kết thúc ngày.
changeCommission boolean Không Thay đổi Ủy ban.
changeCommissionAmount number · double Không Thay đổi số tiền ủy ban.
createdDate string · date-time Không Ngày được tạo ra.
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 Không Dịch vụ.
isDeleted boolean Không Được xóa.
description string Không Mô tả.
promotionIdOnMp string Không Đăng ký danh sách trên Mp.
clientId integer · int64 Không - Đồ nhận khách hàng.
organizationId integer · int64 Không Đơn vị tổ chức.
candidateCount integer · int64 Không - Tham mưu.
inPromotionCount integer · int64 Không Trong số lượng thăng chức.
auto boolean Không - Ô tô.
hotsale boolean Không Hotsale.
candidateCountOnMp integer · int64 Không Ứng viên đếm vào MP.
inPromotionCountOnMp integer · int64 Không Trong chương trình khuyến mãi Count On Mp.
{
  "promotionId": 1001,
  "id": 1001,
  "totalCount": 1,
  "name": "Example",
  "dateStart": "2026-01-15T12:00:00Z",
  "dateEnd": "2026-01-15T12:00:00Z"
}
Hầm lẫn4

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Sản phẩm xuất khẩu

/api/promotion/{promotionId}/product/export
Tấm mã với truy cập đọc

Xuất khẩu sản phẩm sử dụng GET /api/promotion/{promotionId}/product/export.

Các tham số đường

TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Thẻ nhận được thăng chức.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
dateFrom string · date-time Không Ngày từ.
dateTo string · date-time Không Ngày đến.
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 Không Dịch vụ.
reDownload boolean Không Tải lại.
clientOrganizationId integer · int64 Không Đơn vị tổ chức khách hàng.
minMargin number · double Không Min Margin.
minMarginPercent number · double Không Min Margin Percent.
isActive boolean Không - Nó hoạt động.
isDeleted boolean Không Được xóa.
query string Không - Tôi hỏi.
promotionIdOnMp integer · int64 Không Đăng ký danh sách trên Mp.
categoryId integer · int64 Không Phân loại ID.
categoryIds integer[] Không Đồ nhận dạng hạng mục.
clientId integer · int64 Không - Đồ nhận khách hàng.
inStock boolean Không Ở Stock.
isNotFound boolean Không Không tìm thấy.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/promotion/1001/product/export?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
"string"
Hầm lẫn7

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_cant_download_file
Không thể tạo tệp. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_cant_download_file ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_promotion_not_found
khuyến mãi không tìm thấy

error cụ thể cho điểm cuối. Sử dụng mã error_promotion_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_service_not_found
Marketplace không được chọn

error cụ thể cho điểm cuối. Sử dụng mã error_service_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Tìm ra

/api/promotion/product/find
Tấm mã với truy cập đọc

Tìm bằng cách sử dụng GET /api/promotion/product/find.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
dateFrom string · date-time Không Ngày từ.
dateTo string · date-time Không Ngày đến.
promotionId integer · int64 Không Thẻ nhận được thăng chức.
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 Không Dịch vụ.
reDownload boolean Không Tải lại.
clientOrganizationId integer · int64 Không Đơn vị tổ chức khách hàng.
minMargin number · double Không Min Margin.
minMarginPercent number · double Không Min Margin Percent.
isActive boolean Không - Nó hoạt động.
isDeleted boolean Không Được xóa.
query string Không - Tôi hỏi.
promotionIdOnMp integer · int64 Không Đăng ký danh sách trên Mp.
categoryId integer · int64 Không Phân loại ID.
categoryIds integer[] Không Đồ nhận dạng hạng mục.
clientId integer · int64 Không - Đồ nhận khách hàng.
inStock boolean Không Ở Stock.
isNotFound boolean Không Không tìm thấy.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/promotion/product/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng FindResponseProductPromotion
TrườngLoạiBắt buộcMô tả
rows ProductPromotion[] Không Đường.
Cấu trúc của mục array ProductPromotion
TrườngLoạiBắt buộcMô tả
categoryName string Không Tên hạng mục.
brandName string Không Tên thương hiệu.
subject string Không - Đối tượng.
purchasePrice number · double Không Giá mua.
deliveryCost number · double Không Chi phí giao hàng.
additionalCost number · double Không Chi phí bổ sung.
barcode string Không Mã vạch.
instockQuantity integer · int64 Không Số lượng dự trữ.
wildberriesStockCount integer · int64 Không Số lượng cổ phiếu của Wildberries.
yandexMarketStockCount integer · int64 Không Yandex Market Stock Count.
createdDate string · date-time Không Ngày được tạo ra.
minPrice number · double Không Min Price.
isDuplicate boolean Không - Có thể là Duplicate.
ozonArticle string Không Điều Ozon.
ozonStockCount integer · int64 Không Hình dung Ozon Stock.
salesExpensesOnMpPercent number · double Không Chi phí bán hàng trên MP phần trăm.
taxeRate number · double Không Tỷ lệ thuế.
width integer · int32 Không Lớn.
height integer · int32 Không Tốc độ.
depth integer · int32 Không Đâu sâu.
ozonPurchasePercent number · double Không Phụ phần trăm mua ôzô.
warehouseRatio number · double Không Tỷ lệ kho.
wildberriesCommission number · double Không Ủy ban Wildberries.
wildberriesFbwCommission number · double Không Ủy ban Fbw Wildberries.
wildberriesFbsCommission number · double Không Ủy ban FBI Wildberries.
wildberriesDbsCommission number · double Không Ủy ban DBS Wildberries.
wildberriesEdbsCommission number · double Không Ủy ban Wildberries Edbs.
wildberriesCAndCCommission number · double Không Wildberries C và C.
wildberriesBookingCommission number · double Không Ủy ban đặt phòng Wildberries.
wildberriesAdditionalExpenses number · double Không Chi phí bổ sung của Wildberries.
ozonAdditionalExpenses number · double Không Chi phí bổ sung về Ozon.
ozonCommission number · double Không Ủy ban Ozon.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
productId integer · int64 Không Đơn vị sản phẩm
promotionId integer · int64 Không Thẻ nhận được thăng chức.
ozonFbsCommission number · double Không Ủy ban Ozon Fbs.
ozonFboCommission number · double Không Ủy ban Ozon FBO.
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 Không Dịch vụ.
acquiringPercent number · double Không Thu thập phần trăm.
currentPrice number · double Không Giá hiện tại.
currentPriceWithoutDiscount number · double Không Giá hiện tại mà không giảm giá.
plannedPrice number · double Không Giá dự định.
totalStockCount integer · int64 Không Tổng số lượng cổ phiếu.
commissionReduction number · double Không Thuế giảm.
profitDifference number · double Không Sự khác biệt lợi nhuận.
marginDifference number · double Không Sự khác biệt về lợi nhuận.
markupDifference number · double Không Sự khác biệt đánh dấu.
plannedAndMinPriceDiff number · double Không Sự khác biệt giá cả được lên kế hoạch và giảm thiểu.
incomeDifference number · double Không Sự khác biệt về thu nhập.
currentDiscount number · double Không Giảm giá hiện tại.
productCreatedDate string · date-time Không Ngày sản phẩm được tạo ra.
mainImageUrl string Không Hình ảnh chính Url.
isProfitably boolean Không Có lợi nhuận.
taskId integer · int64 Không Đơn vị nhiệm vụ.
serviceArticle string Không Điều dịch vụ.
article string Không Bài viết.
daysCountOnService integer · int32 Không Ngày được tính vào dịch vụ.
turnover integer · int32 Không Lượng chuyển nhượng.
fboStock integer · int32 Không Fbo Stock.
fbsStock integer · int32 Không - FBS Stock.
newDiscountForPromotion number · double Không Giá giảm mới cho chương trình khuyến mãi.
saleLogistics number · double Không Thuốc bán hàng.
returnLogistics number · double Không Trả lại Logistics.
purchasePercent number · double Không % mua hàng.
totalLogistics number · double Không Tổng logistics.
commissions number · double Không Thuộc thầu.
currentProfit number · double Không Lợi nhuận hiện tại.
promotionProfit number · double Không Lợi nhuận thăng chức.
currentMarginality number · double Không Sự bớt lợi nhuận hiện tại.
promotionMarginality number · double Không Tăng chức.
currentMarkUp number · double Không Đánh dấu hiện tại.
promotionMarkUp number · double Không Tăng chức, đánh dấu lên.
additionalDiscountForPromotionRub number · double Không Thêm giảm giá cho việc thăng chức.
additionalDiscountForPromotionPercent number · double Không Thêm giảm giá cho phần trăm khuyến mãi.
isDeleted boolean Không Được xóa.
organizationId integer · int64 Không Đơn vị tổ chức.
clientId integer · int64 Không - Đồ nhận khách hàng.
addMode string Không Thêm Mode.
ozonAverageExpenses number · double Không Chi phí trung bình Ozon.
isActive boolean Không - Nó hoạt động.
changeName string Không Thay đổi tên.
changeDate string · date-time Không Thay đổi ngày.
productName string Không Tên sản phẩm
id integer · int64 Không Id.
totalCount integer · int64 Không Tổng số.
serviceCard string Không Thẻ phục vụ.
isNotFound boolean Không Không tìm thấy.
isArchived boolean Không Được lưu trữ.
productCommissions string Không Ủy ban sản phẩm.
currentGrossProfit number · double Không Lợi nhuận tổng hiện tại.
plannedGrossProfit number · double Không Lợi nhuận tổng dự kiến.
{
  "rows": "string"
}
Hầm lẫn4

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Tất cả

/api/promotion/find
Tấm mã với truy cập đọc

Tất cả sử dụng GET /api/promotion/find.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
dateFrom string · date-time Không Ngày từ.
dateTo string · date-time Không Ngày đến.
promotionId integer · int64 Không Thẻ nhận được thăng chức.
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 Không Dịch vụ.
reDownload boolean Không Tải lại.
clientOrganizationId integer · int64 Không Đơn vị tổ chức khách hàng.
minMargin number · double Không Min Margin.
minMarginPercent number · double Không Min Margin Percent.
isActive boolean Không - Nó hoạt động.
isDeleted boolean Không Được xóa.
query string Không - Tôi hỏi.
promotionIdOnMp integer · int64 Không Đăng ký danh sách trên Mp.
categoryId integer · int64 Không Phân loại ID.
categoryIds integer[] Không Đồ nhận dạng hạng mục.
clientId integer · int64 Không - Đồ nhận khách hàng.
inStock boolean Không Ở Stock.
isNotFound boolean Không Không tìm thấy.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/promotion/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng FindResponsePromotion
TrườngLoạiBắt buộcMô tả
rows Promotion[] Không Đường.
Cấu trúc của mục array Promotion
TrườngLoạiBắt buộcMô tả
promotionId integer · int64 Không Thẻ nhận được thăng chức.
id integer · int64 Không Id.
totalCount integer · int64 Không Tổng số.
name string Không Tên.
dateStart string · date-time Không Ngày bắt đầu.
dateEnd string · date-time Không Kết thúc ngày.
changeCommission boolean Không Thay đổi Ủy ban.
changeCommissionAmount number · double Không Thay đổi số tiền ủy ban.
createdDate string · date-time Không Ngày được tạo ra.
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 Không Dịch vụ.
isDeleted boolean Không Được xóa.
description string Không Mô tả.
promotionIdOnMp string Không Đăng ký danh sách trên Mp.
clientId integer · int64 Không - Đồ nhận khách hàng.
organizationId integer · int64 Không Đơn vị tổ chức.
candidateCount integer · int64 Không - Tham mưu.
inPromotionCount integer · int64 Không Trong số lượng thăng chức.
auto boolean Không - Ô tô.
hotsale boolean Không Hotsale.
candidateCountOnMp integer · int64 Không Ứng viên đếm vào MP.
inPromotionCountOnMp integer · int64 Không Trong chương trình khuyến mãi Count On Mp.
{
  "rows": "string"
}
Hầm lẫn5

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_service_not_found
Marketplace không được chọn

error cụ thể cho điểm cuối. Sử dụng mã error_service_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

GET

Xuất khẩu

/api/promotion/export
Tấm mã với truy cập đọc

Xuất khẩu sử dụng GET /api/promotion/export.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
dateFrom string · date-time Không Ngày từ.
dateTo string · date-time Không Ngày đến.
promotionId integer · int64 Không Thẻ nhận được thăng chức.
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 Không Dịch vụ.
reDownload boolean Không Tải lại.
clientOrganizationId integer · int64 Không Đơn vị tổ chức khách hàng.
minMargin number · double Không Min Margin.
minMarginPercent number · double Không Min Margin Percent.
isActive boolean Không - Nó hoạt động.
isDeleted boolean Không Được xóa.
query string Không - Tôi hỏi.
promotionIdOnMp integer · int64 Không Đăng ký danh sách trên Mp.
categoryId integer · int64 Không Phân loại ID.
categoryIds integer[] Không Đồ nhận dạng hạng mục.
clientId integer · int64 Không - Đồ nhận khách hàng.
inStock boolean Không Ở Stock.
isNotFound boolean Không Không tìm thấy.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringCATEGORYNAME, BRANDNAME, PRODUCTNAME, ARTICLE, BARCODE, SERVICEARTICLE, CURRENTPRICEWITHOUTDISCOUNT, CURRENTPRICE, PLANNEDPRICE, CURRENTDISCOUNT, NEWDISCOUNTFORPROMOTION, CURRENTPROFIT, PROMOTIONPROFIT, CURRENTMARGINALITY, PROMOTIONMARGINALITY, CURRENTMARKUP, PLANNEDMARKUPRATIO, OZONPRODUCTIDONMP, WILDBERRIESPRODUCTIDONMP, PURCHASEPERCENT, FBOSTOCK, FBSSTOCK, TURNOVER Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/promotion/export?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
"string"
Hầm lẫn6

Các lỗi ứng dụng thường được trả về như JSON với error, localMessage và params. Nhánh trên error; văn bản địa phương có thể thay đổi. Cách trả lại lỗi ứng dụng ↑

401auth_required
Định nghĩa xác thực cần thiết

Authorization bị mất tích, trống rỗng hoặc chứa một token không hợp lệ.

400error_access_denied
Truy cập bị từ chối

Các token tồn tại, nhưng vai trò của nó không thể thực hiện hoạt động này.

500error_unknown
Một lỗi không rõ đã xảy ra. Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ

Thất bại nội bộ: tiết kiệm thời gian yêu cầu và hỗ trợ liên lạc; đừng mù quáng thử lại đột biến.

400error_cant_download_file
Không thể tạo tệp. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_cant_download_file ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_no_client
Khách hàng không được tìm thấy hoặc đã bị xóa. Viết để hỗ trợ

error cụ thể cho điểm cuối. Sử dụng mã error_no_client ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

400error_service_not_found
Marketplace không được chọn

error cụ thể cho điểm cuối. Sử dụng mã error_service_not_found ổn định trong logic ứng dụng; localMessage chứa phiên bản được hiển thị ở trên.

Authorization

Tỷ hiệu cho các yêu cầu thử nghiệm

Các token vẫn ở trong localStorage của trình duyệt này và chỉ được gửi trong tiêu đề Authorization của các yêu cầu đến api.selsup.ru.

Thử

Các tham số yêu cầu thực

Đáp lại API trực tiếp

Gửi yêu cầu để xem phản ứng SelSup.