SelSup Developers

API · API Đề xuất

Chiến dịch quảng cáo

Điểm cuối cho các chiến dịch quảng cáo, bao gồm các tuyến đường chính xác, các tham số, các cơ quan yêu cầu và các kế hoạch phản hồi có thể mở rộng.

10 điểm cuối/api/campaignThườ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/campaign

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 chiến dịch quảng cáo

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.

CampaignFilter17 trường
limitinteger · int32

Giới hạn.

pageinteger · int32

Page.

countboolean

- Anh đếm.

sortBystring

Đặt hàng.

ascendingboolean

Tăng lên.

statusstring

Status.

campaignStatusstring

Tình trạng chiến dịch.

typeinteger · int32

Type.

offsetinteger · int32

- Thôi được.

servicestring

Dịch vụ.

dateTostring · date-time

Ngày đến.

dateFromstring · date-time

Ngày từ.

isStatCampaignboolean

Là Chiến dịch Stat.

dateStartstring · date-time

Ngày bắt đầu.

querystring

- Tôi hỏi.

productExternalIdinteger · int64

ID bên ngoài sản phẩm

organizationIdsinteger[]

Đồ nhận tổ chức.

CampaignStatExportRequest4 trường
servicestring

Dịch vụ.

organizationIdinteger · int64

Đơn vị tổ chức.

organizationIdsinteger[]

Đồ nhận tổ chức.

filterCampaignFilter

Trình lọc.

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.

Campaign22 trường
idinteger · int64

Id.

externalIdinteger · int64

Thẻ cá nhân bên ngoài.

namestring

Tên.

campaignNamestring

Tên chiến dịch.

typestring

Type.

statusTypestring

Tiểu tình.

productIdinteger · int64

Đơn vị sản phẩm

externalProductIdinteger · int64

ID sản phẩm bên ngoài

createDatestring · date-time

Tạo ngày.

endDatestring · date-time

Ngày kết thúc.

startDatestring · date-time

Ngày bắt đầu.

suminteger · int64

Đánh giá.

writeOffTypestring

Bác loại đi.

onPauseboolean

- Tạm dừng.

clientIdinteger · int64

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

servicestring

Dịch vụ.

categoryIdinteger · int64

Phân loại ID.

categoryNamestring

Tên hạng mục.

campaignTypestring

Tiểu chiến.

dateStatImportstring · date-time

Ngày nhập khẩu Stat.

nmsstring

Nms.

paymentTypestring

Loại thanh toán.

WildberriesType32 trường
idinteger · int64

Id.

namestring

Tên.

publishedboolean

Được xuất bản.

hasSizeboolean

Có kích thước.

monoBoxMinQuantityinteger · int32

Mono Box Min lượng.

monoTypestring

Mô-nô.

monoMinPriceinteger · int32

Giá đơn Min.

hasParentboolean

Có cha mẹ.

parentIdinteger · int64

Đồ nhận cha mẹ.

wildberriesIdinteger · int64

- Thẻ của Wildberries.

lastSyncDatestring · date-time

Ngày đồng bộ cuối cùng.

notChangedDaysinteger · int32

Không thay đổi ngày.

commissionnumber · double

Ủy ban.

fbsCommissionnumber · double

Ủy ban FBI.

fbwCommissionnumber · double

Ủy ban FBI.

dbsCommissionnumber · double

Ủy ban DBS.

edbsCommissionnumber · double

Ủy ban Edbs.

cAndCCommissionnumber · double

C và C.

bookingCommissionnumber · double

Ủy ban đặt phòng.

logisticPriceinteger · int32

Giá logistics.

storagePricenumber · double

Giá lưu trữ.

acceptancePricenumber · double

Giá chấp nhận.

needDimensionsboolean

- Cần Dimension.

purchasePercentAvgnumber · double

Mua phần trăm Avg.

purchasePercentMinnumber · double

Mua phần trăm Min.

photoAvginteger · int32

Ảnh Avg.

photoMininteger · int32

Ảnh Min.

drrAvgnumber · double

Tiến sĩ Avg.

drrMinnumber · double

Tiến sĩ Min.

marginAvgnumber · double

- Tỷ lệ nhị phân Avg.

marginMinnumber · double

Margin Min.

candCCommissionnumber · double

CND.

CampaignStat4 trường
campaignstring

Chiến dịch.

valuenumber · double

Giá trị.

organizationIdinteger · int64

Đơn vị tổ chức.

organizationNamestring

Tên tổ chức.

CampaignTotalStats4 trường
clicksCampaignStat[]

Nhấp vào.

viewsCampaignStat[]

Những quan điểm.

expensesCampaignStat[]

Chi phí.

averageCostCampaignStat[]

Chi phí trung bình.

FindResponseStatCampaign1 trường
rowsStatCampaign[]

Đường.

StatCampaign46 trường
limitinteger · int32

Giới hạn.

pageinteger · int32

Page.

countboolean

- Anh đếm.

sortBystring

Đặt hàng.

ascendingboolean

Tăng lên.

statCampaignIdinteger · int64

Hình danh chiến dịch của tiểu bang.

viewsinteger · int32

Những quan điểm.

clicksinteger · int32

Nhấp vào.

ratioClicksViewsnumber · double

Tỷ lệ click xem.

averageCostnumber · double

Chi phí trung bình.

expensesnumber · double

Chi phí.

quantityAddCartinteger · int32

Số lượng Thêm Thùng

quantityOrdersinteger · int32

Số lượng đặt hàng.

ratioOrdersOfVisitsnumber · double

Tỷ lệ lượt truy cập

quantityProductOrdersinteger · int32

Số lượng đơn đặt hàng sản phẩm.

ordersAmountnumber · double

Số lượng đơn đặt hàng.

campaignIdinteger · int64

Thẻ chiến dịch.

campaignNamestring

Tên chiến dịch.

createDatestring · date-time

Tạo ngày.

servicestring

Dịch vụ.

campaignTypestring

Tiểu chiến.

categoryNamestring

Tên hạng mục.

externalIdinteger · int64

Thẻ cá nhân bên ngoài.

productIdinteger · int64

Đơn vị sản phẩm

productViewIdinteger · int64

ID xem sản phẩm

datestring · date-time

Rồi hẹn hò.

startDatestring · date-time

Ngày bắt đầu.

endDatestring · date-time

Ngày kết thúc.

importDatestring · date-time

Ngày nhập khẩu.

uniqueIdstring

Thẻ cá nhân duy nhất.

clientIdinteger · int64

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

organizationIdinteger · int64

Đơn vị tổ chức.

organizationNamestring

Tên tổ chức.

rowTypestring

Nhóm hàng.

quantityBuyoutsnumber · double

Quá số lượng mua lại.

revenuenumber · double

Thu nhập.

profitFactnumber · double

Thực tế lợi nhuận.

marginFactnumber · double

Sự thật về lợi nhuận.

drrnumber · double

Tiến sĩ.

cpsnumber · double

CPS.

quantityBuyoutsForecastnumber · double

Dự báo số lượng mua lại.

profitForecastnumber · double

Dự báo lợi nhuận.

marginForecastnumber · double

Dự báo lợi nhuận.

allowableExpensesnumber · double

Chi phí được chấp nhận.

currencystring

Tiền tệ.

unavailableReasonsobject

Những lý do không có sẵn.

FindResponseCampaign1 trường
rowsCampaign[]

Đường.

WbBalance3 trường
balanceinteger · int32

Sự cân bằng.

netinteger · int32

Đường lưới.

bonusinteger · int32

- Chỗ thưở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

POST

Tải đổi chiến dịch trạng thái

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

Cập nhật chiến dịch trạng thái sử dụng POST /api/campaign/updateStatusCampaign.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
campaignId integer · int64 Thẻ chiến dịch.
status stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Status.
organizationId integer · int64 Đơn vị tổ chức.
curl --request POST 'https://api.selsup.ru/api/campaign/updateStatusCampaign?campaignId=1001&status=DELETED&organizationId=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ẫn9

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_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_prepared_integration_not_found
không tìm thấy tích hợp đã chuẩn bị

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

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổ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_api
{message}

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

POST

Tỷ lệ vận động xuất khẩu

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

Các số liệu thống kê chiến dịch xuất khẩu sử dụng POST /api/campaign/stats/xlsx.

Cơ quan yêu cầu

application/json
Các trường đối tượngCampaignStatExportRequest
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 Không Dịch vụ.
organizationId integer · int64 Không Đơn vị tổ chức.
organizationIds integer[] Không Đồ nhận tổ chức.
filter CampaignFilter Không Trình lọc.
Các trường đối tượng CampaignFilter
TrườngLoạiBắt buộcMô tả
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Không Đặt hàng.
ascending boolean Không Tăng lên.
status string Không Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Không Tình trạng chiến dịch.
type integer · int32 Không Type.
offset integer · int32 Không - Thôi đượ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ụ.
dateTo string · date-time Không Ngày đến.
dateFrom string · date-time Không Ngày từ.
isStatCampaign boolean Không Là Chiến dịch Stat.
dateStart string · date-time Không Ngày bắt đầu.
query string Không - Tôi hỏi.
productExternalId integer · int64 Không ID bên ngoài sản phẩm
organizationIds integer[] Không Đồ nhận tổ chức.
curl --request POST 'https://api.selsup.ru/api/campaign/stats/xlsx' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "service": "NONE",
  "organizationId": 1001,
  "organizationIds": "string",
  "filter": "string"
}'

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ẫn9

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_analytics_access_denied
Dữ liệu phân tích là bí mật đối với vai trò SUPPORT

error cụ thể cho điểm cuối. Sử dụng mã error_analytics_access_denied ổ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_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổ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_user_does_not_have_this_organization
Người dùng không có quyền truy cập vào tổ chức này

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

POST

Tạo chiến dịch

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

Tạo chiến dịch bằng POST /api/campaign/createCampaign.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Đơn vị tổ chức.

Cơ quan yêu cầu

application/json
Các trường đối tượngCampaign
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
externalId integer · int64 Không Thẻ cá nhân bên ngoài.
name string Không Tên.
campaignName string Không Tên chiến dịch.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Không Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Không Tiểu tình.
productId integer · int64 Không Đơn vị sản phẩm
externalProductId integer · int64 Không ID sản phẩm bên ngoài
createDate string · date-time Không Tạo ngày.
endDate string · date-time Không Ngày kết thúc.
startDate string · date-time Không Ngày bắt đầu.
sum integer · int64 Không Đánh giá.
writeOffType stringBALANCE, NET, BONUS Không Bác loại đi.
onPause boolean Không - Tạm dừng.
clientId integer · int64 Không - Đồ nhận khách hàng.
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ụ.
categoryId integer · int64 Không Phân loại ID.
categoryName string Không Tên hạng mục.
campaignType string Không Tiểu chiến.
dateStatImport string · date-time Không Ngày nhập khẩu Stat.
nms string Không Nms.
paymentType string Không Loại thanh toán.
curl --request POST 'https://api.selsup.ru/api/campaign/createCampaign?organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}'

Phản ứng thành công

200
Các trường đối tượng Campaign
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
externalId integer · int64 Không Thẻ cá nhân bên ngoài.
name string Không Tên.
campaignName string Không Tên chiến dịch.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Không Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Không Tiểu tình.
productId integer · int64 Không Đơn vị sản phẩm
externalProductId integer · int64 Không ID sản phẩm bên ngoài
createDate string · date-time Không Tạo ngày.
endDate string · date-time Không Ngày kết thúc.
startDate string · date-time Không Ngày bắt đầu.
sum integer · int64 Không Đánh giá.
writeOffType stringBALANCE, NET, BONUS Không Bác loại đi.
onPause boolean Không - Tạm dừng.
clientId integer · int64 Không - Đồ nhận khách hàng.
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ụ.
categoryId integer · int64 Không Phân loại ID.
categoryName string Không Tên hạng mục.
campaignType string Không Tiểu chiến.
dateStatImport string · date-time Không Ngày nhập khẩu Stat.
nms string Không Nms.
paymentType string Không Loại thanh toán.
{
  "id": 1001,
  "externalId": 1001,
  "name": "Example",
  "campaignName": "Example",
  "type": "IN_CATALOG",
  "statusType": "DELETED"
}
Hầm lẫn10

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_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_prepared_integration_not_found
không tìm thấy tích hợp đã chuẩn bị

error cụ thể cho điểm cuối. Sử dụng mã error_prepared_integration_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_supported
Сервис не поддерживается

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

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổ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_api
{message}

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

GET

Chiến dịch nhập khẩu

/api/campaign/updateCampaigns
Tấm mã với truy cập đọc

Các chiến dịch nhập khẩu sử dụng GET /api/campaign/updateCampaigns.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Đơn vị tổ 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 Dịch vụ.
curl --request GET 'https://api.selsup.ru/api/campaign/updateCampaigns?organizationId=1001&service=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ẫ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_analytics_access_denied
Dữ liệu phân tích là bí mật đối với vai trò SUPPORT

error cụ thể cho điểm cuối. Sử dụng mã error_analytics_access_denied ổ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.

GET

Tải lại số liệu chiến dịch

/api/campaign/reloadCampaignStats
Tấm mã với truy cập đọc

Reload Campaign Statistics sử dụng GET /api/campaign/reloadCampaignStats.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
dateFrom string · date Ngày từ.
dateTo string · date Ngày đến.
organizationId integer · int64 Đơn vị tổ chức.
isExpensesOnly boolean Không Chỉ chi phí thôi.
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ụ.
curl --request GET 'https://api.selsup.ru/api/campaign/reloadCampaignStats?dateFrom=2026-01-15&dateTo=2026-01-15&organizationId=1001&service=NONE' \
  --header 'Authorization: YOUR_API_TOKEN'

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.

GET

Tìm những người được hỏi

/api/campaign/getWildberriesSubjects
Tấm mã với truy cập đọc

Nhận Wildberries Subjects bằng cách sử dụng GET /api/campaign/getWildberriesSubjects.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
query string - Tôi hỏi.
limit integer · int32 Giới hạn.
organizationId integer · int64 Đơn vị tổ chức.
curl --request GET 'https://api.selsup.ru/api/campaign/getWildberriesSubjects?query=string&limit=50&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Cấu trúc của mục array WildberriesType[]
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
name string Không Tên.
published boolean Không Được xuất bản.
hasSize boolean Không Có kích thước.
monoBoxMinQuantity integer · int32 Không Mono Box Min lượng.
monoType stringALWAYS, NEVER, MONO_IF_MIN_PRICE Không Mô-nô.
monoMinPrice integer · int32 Không Giá đơn Min.
hasParent boolean Không Có cha mẹ.
parentId integer · int64 Không Đồ nhận cha mẹ.
wildberriesId integer · int64 Không - Thẻ của Wildberries.
lastSyncDate string · date-time Không Ngày đồng bộ cuối cùng.
notChangedDays integer · int32 Không Không thay đổi ngày.
commission number · double Không Ủy ban.
fbsCommission number · double Không Ủy ban FBI.
fbwCommission number · double Không Ủy ban FBI.
dbsCommission number · double Không Ủy ban DBS.
edbsCommission number · double Không Ủy ban Edbs.
cAndCCommission number · double Không C và C.
bookingCommission number · double Không Ủy ban đặt phòng.
logisticPrice integer · int32 Không Giá logistics.
storagePrice number · double Không Giá lưu trữ.
acceptancePrice number · double Không Giá chấp nhận.
needDimensions boolean Không - Cần Dimension.
purchasePercentAvg number · double Không Mua phần trăm Avg.
purchasePercentMin number · double Không Mua phần trăm Min.
photoAvg integer · int32 Không Ảnh Avg.
photoMin integer · int32 Không Ảnh Min.
drrAvg number · double Không Tiến sĩ Avg.
drrMin number · double Không Tiến sĩ Min.
marginAvg number · double Không - Tỷ lệ nhị phân Avg.
marginMin number · double Không Margin Min.
candCCommission number · double Không CND.
[
  "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_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_prepared_integration_not_found
không tìm thấy tích hợp đã chuẩn bị

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

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổ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.

GET

Nhận được tổng số chiến dịch

/api/campaign/getTotalStatCampaigns
Tấm mã với truy cập đọc

Nhận tổng số chiến dịch Stat sử dụng GET /api/campaign/getTotalStatCampaigns.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Không Đơn vị tổ 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 Dịch vụ.
status string Không Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Không Tình trạng chiến dịch.
type integer · int32 Không Type.
offset integer · int32 Không - Thôi được.
dateTo string · date-time Không Ngày đến.
dateFrom string · date-time Không Ngày từ.
isStatCampaign boolean Không Là Chiến dịch Stat.
dateStart string · date-time Không Ngày bắt đầu.
query string Không - Tôi hỏi.
productExternalId integer · int64 Không ID bên ngoài sản phẩm
organizationIds integer[] Không Đồ nhận tổ chức.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Không Đặt hàng.
ascending boolean Không Tăng lên.
topN integer · int32 N trên.
curl --request GET 'https://api.selsup.ru/api/campaign/getTotalStatCampaigns?service=NONE&limit=50&page=1&topN=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng CampaignTotalStats
TrườngLoạiBắt buộcMô tả
clicks CampaignStat[] Không Nhấp vào.
Cấu trúc của mục array CampaignStat
TrườngLoạiBắt buộcMô tả
campaign string Không Chiến dịch.
value number · double Không Giá trị.
organizationId integer · int64 Không Đơn vị tổ chức.
organizationName string Không Tên tổ chức.
views CampaignStat[] Không Những quan điểm.
Cấu trúc của mục array CampaignStat
TrườngLoạiBắt buộcMô tả
campaign string Không Chiến dịch.
value number · double Không Giá trị.
organizationId integer · int64 Không Đơn vị tổ chức.
organizationName string Không Tên tổ chức.
expenses CampaignStat[] Không Chi phí.
Cấu trúc của mục array CampaignStat
TrườngLoạiBắt buộcMô tả
campaign string Không Chiến dịch.
value number · double Không Giá trị.
organizationId integer · int64 Không Đơn vị tổ chức.
organizationName string Không Tên tổ chức.
averageCost CampaignStat[] Không Chi phí trung bình.
Cấu trúc của mục array CampaignStat
TrườngLoạiBắt buộcMô tả
campaign string Không Chiến dịch.
value number · double Không Giá trị.
organizationId integer · int64 Không Đơn vị tổ chức.
organizationName string Không Tên tổ chức.
{
  "clicks": "string",
  "views": "string",
  "expenses": "string",
  "averageCost": "string"
}
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.

GET

Nhận các chiến dịch Stat

/api/campaign/getStatCampaigns
Tấm mã với truy cập đọc

Nhận được các chiến dịch Stat sử dụng GET /api/campaign/getStatCampaigns.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Không Đơn vị tổ 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 Dịch vụ.
status string Không Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Không Tình trạng chiến dịch.
type integer · int32 Không Type.
offset integer · int32 Không - Thôi được.
dateTo string · date-time Không Ngày đến.
dateFrom string · date-time Không Ngày từ.
isStatCampaign boolean Không Là Chiến dịch Stat.
dateStart string · date-time Không Ngày bắt đầu.
query string Không - Tôi hỏi.
productExternalId integer · int64 Không ID bên ngoài sản phẩm
organizationIds integer[] Không Đồ nhận tổ chức.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/campaign/getStatCampaigns?service=NONE&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng FindResponseStatCampaign
TrườngLoạiBắt buộcMô tả
rows StatCampaign[] Không Đường.
Cấu trúc của mục array StatCampaign
TrườngLoạiBắt buộcMô tả
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy string Không Đặt hàng.
ascending boolean Không Tăng lên.
statCampaignId integer · int64 Không Hình danh chiến dịch của tiểu bang.
views integer · int32 Không Những quan điểm.
clicks integer · int32 Không Nhấp vào.
ratioClicksViews number · double Không Tỷ lệ click xem.
averageCost number · double Không Chi phí trung bình.
expenses number · double Không Chi phí.
quantityAddCart integer · int32 Không Số lượng Thêm Thùng
quantityOrders integer · int32 Không Số lượng đặt hàng.
ratioOrdersOfVisits number · double Không Tỷ lệ lượt truy cập
quantityProductOrders integer · int32 Không Số lượng đơn đặt hàng sản phẩm.
ordersAmount number · double Không Số lượng đơn đặt hàng.
campaignId integer · int64 Không Thẻ chiến dịch.
campaignName string Không Tên chiến dịch.
createDate string · date-time Không Tạo ngày.
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ụ.
campaignType stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Không Tiểu chiến.
categoryName string Không Tên hạng mục.
externalId integer · int64 Không Thẻ cá nhân bên ngoài.
productId integer · int64 Không Đơn vị sản phẩm
productViewId integer · int64 Không ID xem sản phẩm
date string · date-time Không Rồi hẹn hò.
startDate string · date-time Không Ngày bắt đầu.
endDate string · date-time Không Ngày kết thúc.
importDate string · date-time Không Ngày nhập khẩu.
uniqueId string Không Thẻ cá nhân duy nhất.
clientId integer · int64 Không - Đồ nhận khách hàng.
organizationId integer · int64 Không Đơn vị tổ chức.
organizationName string Không Tên tổ chức.
rowType stringCAMPAIGN, UNALLOCATED Không Nhóm hàng.
quantityBuyouts number · double Không Quá số lượng mua lại.
revenue number · double Không Thu nhập.
profitFact number · double Không Thực tế lợi nhuận.
marginFact number · double Không Sự thật về lợi nhuận.
drr number · double Không Tiến sĩ.
cps number · double Không CPS.
quantityBuyoutsForecast number · double Không Dự báo số lượng mua lại.
profitForecast number · double Không Dự báo lợi nhuận.
marginForecast number · double Không Dự báo lợi nhuận.
allowableExpenses number · double Không Chi phí được chấp nhận.
currency string Không Tiền tệ.
unavailableReasons object Không Những lý do không có sẵn.
{
  "rows": "string"
}
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.

GET

Nhận các chiến dịch

/api/campaign/getCampaigns
Tấm mã với truy cập đọc

Nhận chiến dịch sử dụng GET /api/campaign/getCampaigns.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
organizationId integer · int64 Đơn vị tổ chức.
status string Không Status.
campaignStatus stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Không Tình trạng chiến dịch.
type integer · int32 Không Type.
offset integer · int32 Không - Thôi đượ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ụ.
dateTo string · date-time Không Ngày đến.
dateFrom string · date-time Không Ngày từ.
isStatCampaign boolean Không Là Chiến dịch Stat.
dateStart string · date-time Không Ngày bắt đầu.
query string Không - Tôi hỏi.
productExternalId integer · int64 Không ID bên ngoài sản phẩm
organizationIds integer[] Không Đồ nhận tổ chức.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringEXTERNALID, SERVICE, CAMPAIGNNAME, CAMPAIGNTYPE, CATEGORYNAME, VIEWS, CLICKS, RATIOCLICKSVIEWS, AVERAGECOST, EXPENSES, QUANTITYADDCART, QUANTITYORDERS, RATIOORDERSOFVISITS, QUANTITYPRODUCTORDERS, ORDERSAMOUNT, CREATEDATE, STATUS Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaigns?organizationId=1001&limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng FindResponseCampaign
TrườngLoạiBắt buộcMô tả
rows Campaign[] Không Đường.
Cấu trúc của mục array Campaign
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
externalId integer · int64 Không Thẻ cá nhân bên ngoài.
name string Không Tên.
campaignName string Không Tên chiến dịch.
type stringIN_CATALOG, IN_CARD, IN_SEARCH, IN_MAIN, AUTO, IN_SEARCH_AND_CATALOG, BRAND_SHELF, UNKNOWN Không Type.
statusType stringDELETED, READY, FINISHED, CANCELLED, ACTIVE, PAUSED, UNKNOWN, ARCHIVED Không Tiểu tình.
productId integer · int64 Không Đơn vị sản phẩm
externalProductId integer · int64 Không ID sản phẩm bên ngoài
createDate string · date-time Không Tạo ngày.
endDate string · date-time Không Ngày kết thúc.
startDate string · date-time Không Ngày bắt đầu.
sum integer · int64 Không Đánh giá.
writeOffType stringBALANCE, NET, BONUS Không Bác loại đi.
onPause boolean Không - Tạm dừng.
clientId integer · int64 Không - Đồ nhận khách hàng.
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ụ.
categoryId integer · int64 Không Phân loại ID.
categoryName string Không Tên hạng mục.
campaignType string Không Tiểu chiến.
dateStatImport string · date-time Không Ngày nhập khẩu Stat.
nms string Không Nms.
paymentType string Không Loại thanh toá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

Hãy cân bằng chiến dịch

/api/campaign/getCampaignBalance
Tấm mã với truy cập đọc

Nhận cân bằng chiến dịch bằng cách sử dụng GET /api/campaign/getCampaignBalance.

Các tham số truy vấn

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ụ.
organizationId integer · int64 Đơn vị tổ chức.
curl --request GET 'https://api.selsup.ru/api/campaign/getCampaignBalance?service=NONE&organizationId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

Phản ứng thành công

200
Các trường đối tượng WbBalance
TrườngLoạiBắt buộcMô tả
balance integer · int32 Không Sự cân bằng.
net integer · int32 Không Đường lưới.
bonus integer · int32 Không - Chỗ thưởng.
{
  "balance": 1,
  "net": 1,
  "bonus": 1
}
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_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_service_not_supported
Сервис не поддерживается

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

400error_subscription_expired
Đăng ký của bạn đã hết hạn. Thanh toán cước phí để tiếp tục sử dụng dịch vụ.

error cụ thể cho điểm cuối. Sử dụng mã error_subscription_expired ổ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.

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.