SelSup Developers

API · API Đề xuất

Lợi nhuận

Các điểm cuối cho các khoản trả về, 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 chương trình đáp ứng có thể mở rộng.

3 điểm cuối/api/returnThườ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/return

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 Returns

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.

FileExportColumn5 trường
idinteger · int64

Id.

fileExportIdinteger · int64

File Export ID.

columnNamestring

Tên cột.

columnOrderinteger · int32

Lệnh Cột.

isEnabledboolean

Được bật.

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.

FindResponseReturnReport1 trường
rowsReturnReport[]

Đường.

ReturnReport28 trường
idinteger · int64

Id.

orderTypestring

Tiểu lệnh.

orderBarcodestring

Đặt mã vạch.

barcodestring

Mã vạch.

productBarcodestring

Mã vạch sản phẩm.

articlestring

Bài viết.

externalOrderIdstring

- Đơn vị nhận dạng của lệnh bên ngoài.

returnOrderIdstring

Đưa lại danh tính lệnh.

externalProductIdinteger · int64

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

quantityinteger · int32

Số lượng.

officeIdinteger · int64

Thẻ văn phòng.

officeAddressstring

Địa chỉ văn phòng.

orderIdinteger · int64

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

pricenumber · double

Giá cả.

currencyCodestring

Mã tiền tệ.

orderProductIdinteger · int64

Đơn đặt hàng ID sản phẩm.

returnDatestring · date-time

Ngày quay lại.

returnReasonNamestring

Đưa lại tên lý do.

statusstring

Status.

modifyDatestring · date-time

Thay đổi ngày.

createdDatestring · date-time

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

uniqueIdstring

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

servicestring

Dịch vụ.

productIdinteger · int64

Đơn vị sản phẩm

productViewIdinteger · int64

ID xem sản phẩm

productModelIdinteger · int64

Nữ hiệu mô hình sản phẩm

clientIdinteger · int64

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

organizationIdinteger · int64

Đơn vị tổ chức.

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 xuống

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

Tải xuống sử dụng POST /api/return/download.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
productAnalyticField stringBARCODE, COLOR, ARTICLE, BRAND, CATEGORY Phân tích sản phẩm.
query string Không - Tôi hỏi.
withDuplicate boolean Không Với Duplicate.
withBonus boolean Không Với Bonus.
byOrgAndService boolean Không - Nhóm tổ chức và dịch vụ.
byOrderType boolean Không Theo loại thứ tự.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
sortBy string Không Đặt hàng.
ascending boolean Không Tăng lên.
id integer · int64 Không Id.
isMarketPlaceStructure boolean Không Đó là Market Place Structure.
isDashboard boolean Không Đó là bảng điều khiển.
analyticsField stringPRODUCT, MODEL, GROUP, ORGANIZATION, CLIENT, CATEGORY, PRODUCT_VIEW, BRAND, REGION, WAREHOUSE Không Vùng phân tích.
planDayCount integer · int32 Không Đếm ngày kế hoạch.
daysToSupply integer · int32 Không Ngày để cung cấp.
plannedSupplyDate string · date-time Không Ngày dự kiến cung cấp.
groupByView boolean Không Nhóm theo quan điểm.
warehouses integer[] Không Kho hàng.
salesModels string[] Không Mô hình bán hàng.
aggregation stringWAREHOUSE, WAREHOUSE_PRODUCT Không - Thêm vào.
columns FileExportColumn[] Không Cột.
Cấu trúc của mục array FileExportColumn
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
fileExportId integer · int64 Không File Export ID.
columnName string Không Tên cột.
columnOrder integer · int32 Không Lệnh Cột.
isEnabled boolean Không Được bật.
regions string[] Không Các vùng.
group boolean Không Nhóm.
calculationByOrders boolean Không Lượng tính theo lệnh.
sourceReport stringDEFAULT, ORDER, SALES, PROFIT, OZON, YANDEX_MARKET, WB_REALIZATION_FILE, WB_DETAILED_REPORT_FILE, OZON_REALIZATION_FILE, OZON_REALIZATION_FILE_NEW, OZON_COMPENSATIONS_FILE, OZON_SERVICES_FILE, OZON_CASH_FLOW_STATEMENT, WB_CAMPAIGN, SBER_MEGA_MARKET_FILES, YANDEX_MARKET_FILE_DETAILS, WB_RETURNS_REPORT, OWN_DELIVERY, OZON_CAMPAIGN_SKU_REPORT, WB_PAID_STORAGE, YANDEX_MARKET_NETTING, OZON_CPO_SKU_REPORT, UZUM, UZUM_EXPENSES, DEFECT_WRITE_OFF, LOCAL_ORDER, EXTERNAL_CAMPAIGN Không Báo cáo nguồn.
skipDayWithoutStocks boolean Không Tránh ngày không có cổ phiếu.
replaceSetsByComponents boolean Không Thay thế bộ bằng các thành phần.
distributeFbsByWarehouse boolean Không Chuyển phân phối FBI theo kho.
distributeFbsStock boolean Không Chuyển thị cổ phiếu của FBI.
ignoreDumping boolean Không Tránh bỏ việc Dumping.
isSaleStructure boolean Không Đó là cấu trúc bán hàng.
isAveragePerOneUnit boolean Không là trung bình cho mỗi đơn vị.
updateDate boolean Không Ngày cập nhật.
useWeightedGroup boolean Không Sử dụng nhóm cân nặng.
isFindirRequest boolean Không Là yêu cầu của Findir.
brandIds integer[] Không Đồ nhận thương hiệu.
categoryIds integer[] Không Đồ nhận dạng hạng mục.
articles string[] Không Những bài viết.
colors string[] Không Màu sắc.
sizes string[] Không - Cỡ.
barcodes string[] Không Mã vạch.
tagIds integer[] Không Đánh dấu danh tính.
penaltyFrom number · double Không Từ hình phạt.
penaltyTo number · double Không Chị phạt.
logisticsFrom number · double Không Từ Logistics.
logisticsTo number · double Không Logistics To.
marginFrom number · double Không - Tự ở bên ngoài.
marginTo number · double Không - Tăng đến.
salesAmountFrom number · double Không Số lượng bán hàng từ.
salesAmountTo number · double Không Số lượng bán hàng đến
totalSalesAmountFrom number · double Không Tổng số bán hàng từ.
totalSalesAmountTo number · double Không Tổng số bán hàng To.
grossProfitFrom number · double Không Lợi nhuận tổng từ.
grossProfitTo number · double Không Lợi nhuận tổng cộng.
taxNds integer · int32 Không Thuế.
useOsno boolean Không Sử dụng Osno.
period stringDAY, WEEK, MONTH, QUARTER, YEAR, MONTH_3, MONTH_6, END_OF_TARIFF, MONTH_7, MONTH_14, YEAR_2 Không Thời gian.
dateFrom string · date-time Ngày từ.
dateTo string · date-time Ngày đến.
services string[] Không Dịch vụ.
categories integer[] Không Các loại.
brands integer[] Không Các thương hiệu.
clientOrganizationId integer · int64 Không Đơn vị tổ chức khách hàng.
organizations integer[] Không Các tổ chức.
ids integer[] Không Đồ nhận dạng.
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Không Type.
types string[] Không Những loại.
status stringCREATED, REVOKING, REVOKED, ORDER_CREATED, CARDS_CREATED, BOX_BARCODES, IMAGES_UPLOADED, INVOICE_UPLOADED, READY_TO_SUPPLY, SUPPLIED, FINISHED, COLLECTED, SEND, DELIVERY, REFUND, COLLECTING, PACKING, PAYMENT_REQUIRED, CANCELED, CONTROVERSIAL, OVERDUE, READY_FOR_PICKUP, WAITING_SUPPLY, PICK_UP_REFUND, REFUND_RECEIVED, DELETED, RESTORE, PRODUCTION_CONFIRMED Không Status.
timeZone integer · int32 Không Khu vực thời gian.
previousDateFrom string · date-time Không Ngày trước.
clientOrganizationIds integer[] Không Đồ nhận dạng tổ chức khách hàng.
ignoreCredit boolean Không Tránh Credit đi.
curl --request POST 'https://api.selsup.ru/api/return/download?productAnalyticField=BARCODE&limit=50&page=1&dateFrom=2026-01-15T12%3A00%3A00Z&dateTo=2026-01-15T12%3A00%3A00Z' \
  --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_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.

GET

Tìm ra

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

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

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
organizationId integer · int64 Không Đơn vị tổ chức.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Không Tiểu lệnh.
orderBarcode string Không Đặt mã vạch.
services string[] Không Dịch vụ.
barcode string Không Mã vạch.
productBarcode string Không Mã vạch sản phẩm.
article string Không Bài viết.
externalOrderId string Không - Đơn vị nhận dạng của lệnh bên ngoài.
returnOrderId string Không Đưa lại danh tính lệnh.
externalProductId integer · int64 Không ID sản phẩm bên ngoài
officeId integer · int64 Không Thẻ văn phòng.
officeAddress string Không Địa chỉ văn phòng.
orderId integer · int64 Không Đơn vị nhận dạng.
orderProductId integer · int64 Không Đơn đặt hàng ID sản phẩm.
returnReasonName string Không Đưa lại tên lý do.
status string Không Status.
timeZone integer · int32 Không Khu vực thời gian.
modifyDate string · date-time Không Thay đổi ngày.
dateFrom string · date-time Không Ngày từ.
dateTo string · date-time Không Ngày đến.
modifiedDateFrom string · date-time Không Ngày sửa đổi từ.
modifiedDateTo string · date-time Không Ngày sửa đổi đến.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringID, ORDER_TYPE, ORDER_BARCODE, BARCODE, PRODUCT_BARCODE, ARTICLE, EXTERNAL_ORDER_ID, RETURN_ORDER_ID, EXTERNAL_PRODUCT_ID, QUANTITY, OFFICE_ID, OFFICE_ADDRESS, ORDER_ID, PRICE, CURRENCY_CODE, SERVICE_ID, ORGANIZATION_ID, CREATED_DATE, RETURN_DATE, RETURN_REASON_NAME, STATUS, MODIFY_DATE Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/return/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 FindResponseReturnReport
TrườngLoạiBắt buộcMô tả
rows ReturnReport[] Không Đường.
Cấu trúc của mục array ReturnReport
TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
orderType string Không Tiểu lệnh.
orderBarcode string Không Đặt mã vạch.
barcode string Không Mã vạch.
productBarcode string Không Mã vạch sản phẩm.
article string Không Bài viết.
externalOrderId string Không - Đơn vị nhận dạng của lệnh bên ngoài.
returnOrderId string Không Đưa lại danh tính lệnh.
externalProductId integer · int64 Không ID sản phẩm bên ngoài
quantity integer · int32 Không Số lượng.
officeId integer · int64 Không Thẻ văn phòng.
officeAddress string Không Địa chỉ văn phòng.
orderId integer · int64 Không Đơn vị nhận dạng.
price number · double Không Giá cả.
currencyCode string Không Mã tiền tệ.
orderProductId integer · int64 Không Đơn đặt hàng ID sản phẩm.
returnDate string · date-time Không Ngày quay lại.
returnReasonName string Không Đưa lại tên lý do.
status string Không Status.
modifyDate string · date-time Không Thay đổi ngày.
createdDate string · date-time Không Ngày được tạo ra.
uniqueId string Không Thẻ cá nhân duy nhấ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ụ.
productId integer · int64 Không Đơn vị sản phẩm
productViewId integer · int64 Không ID xem sản phẩm
productModelId integer · int64 Không Nữ hiệu mô hình sản phẩm
clientId integer · int64 Không - Đồ nhận khách hàng.
organizationId integer · int64 Không Đơn vị tổ chức.
{
  "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_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_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ái lại File

/api/return/file
Tấm mã với truy cập đọc

Khôi phục tệp bằng cách sử dụng GET /api/return/file.

Các tham số truy vấn

TrườngLoạiBắt buộcMô tả
id integer · int64 Không Id.
organizationId integer · int64 Không Đơn vị tổ chức.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Không Tiểu lệnh.
orderBarcode string Không Đặt mã vạch.
services string[] Không Dịch vụ.
barcode string Không Mã vạch.
productBarcode string Không Mã vạch sản phẩm.
article string Không Bài viết.
externalOrderId string Không - Đơn vị nhận dạng của lệnh bên ngoài.
returnOrderId string Không Đưa lại danh tính lệnh.
externalProductId integer · int64 Không ID sản phẩm bên ngoài
officeId integer · int64 Không Thẻ văn phòng.
officeAddress string Không Địa chỉ văn phòng.
orderId integer · int64 Không Đơn vị nhận dạng.
orderProductId integer · int64 Không Đơn đặt hàng ID sản phẩm.
returnReasonName string Không Đưa lại tên lý do.
status string Không Status.
timeZone integer · int32 Không Khu vực thời gian.
modifyDate string · date-time Không Thay đổi ngày.
dateFrom string · date-time Không Ngày từ.
dateTo string · date-time Không Ngày đến.
modifiedDateFrom string · date-time Không Ngày sửa đổi từ.
modifiedDateTo string · date-time Không Ngày sửa đổi đến.
limit integer · int32 Không Giới hạn.
page integer · int32 Không Page.
count boolean Không - Anh đếm.
sortBy stringID, ORDER_TYPE, ORDER_BARCODE, BARCODE, PRODUCT_BARCODE, ARTICLE, EXTERNAL_ORDER_ID, RETURN_ORDER_ID, EXTERNAL_PRODUCT_ID, QUANTITY, OFFICE_ID, OFFICE_ADDRESS, ORDER_ID, PRICE, CURRENCY_CODE, SERVICE_ID, ORGANIZATION_ID, CREATED_DATE, RETURN_DATE, RETURN_REASON_NAME, STATUS, MODIFY_DATE Không Đặt hàng.
ascending boolean Không Tăng lên.
curl --request GET 'https://api.selsup.ru/api/return/file?limit=50&page=1' \
  --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ẫ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.

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.