SelSup Developers

Публичный API · API Reference

Возвраты

Методы раздела «Возвраты»: точные маршруты, параметры, тела запросов и раскрываемые структуры ответов.

3 методов/api/returnСтабильныйМашинное описание ↗
{ }

Страница собрана в отдельный редактируемый контракт. Перед операциями записи проверяйте примеры на тестовых данных.

/api/return

Готовые сценарии

Готовые сценарии

01

Начать работу с разделом «Возвраты»

Используйте отдельный API-токен и сначала проверяйте операции чтения на тестовых данных.

  1. Сохраните токен на серверной стороне и передавайте его в заголовке Authorization.
  2. Проверьте обязательные параметры и раскройте структуру запроса или ответа.
  3. Обрабатывайте HTTP-статус и стабильное поле error в прикладных ошибках.

Модель данных

Структуры данных раздела

Модели перечислены отдельно и раскрываются также непосредственно у методов, где они используются.

FileExportColumn5 полей
idinteger · int64

ID записи

fileExportIdinteger · int64

ID конфигурации экспорта

columnNamestring

Название столбца

columnOrderinteger · int32

Порядок столбца в файле

isEnabledboolean

Включен ли столбец для экспорта

TmsTask25 полей
idinteger · int64

Идентификатор задачи

read-only
statusstring

Текущий статус задачи

read-only
typestring

Тип задачи

read-only
namestring

Данные задачи в json - могут быть пустыми

clientIdinteger · int64

Поле clientId.

entityIdinteger · int64

Сущность, к которой относится задача

progressinteger · int32

Прогресс выполнения задачи в процентах

processedQuantityinteger · int32

Количество обработанных записей задачи

organizationIdinteger · int64

Организация задачи, может быть 0, если не зависит от организации

priorityinteger · int32

Приоритет задачи - чем выше тем быстрее задача запустится

propertiesstring

Параметры задачи

messagestring

Сообщение с результатом выполнения задачи

messageParamsstring

Параметры сообщения с результатом выполнения задачи

createdDatestring · date-time

Дата добавления задачи в очередь

startDatestring · date-time

Дата запуска задачи

finishDatestring · date-time

Дата завершения задачи

urlstring

Ссылка на скачивание файла с результатом задачи

inputFileUrlstring

Ссылка на загруженный файл

retryNumberinteger · int32

Счётчик перезапуска задачи.

userIdinteger · int32

Пользователь запустивший задачу

retryDatestring · date-time

Запланированная дата перезапуска

debugboolean

Запуск задачи в режиме отладки с большим логированием

forcedStartboolean

Ручной запуск задачи

servicestring

Сервис в рамках которого выполняется задача

langstring

Язык на котором сейчас запущена таска

FindResponseReturnReport1 полей
rowsReturnReport[]

Строки с результатом поиска

ReturnReport28 полей
idinteger · int64

Идентификатор возврата.

orderTypestring

Тип заказа FBO/FBS.

orderBarcodestring

Штрих-код изначального отправления (Ozon: clearing_id).

barcodestring

Штрих-код на возвратном отправлении (Ozon: return_barcode, WB: shkId).

productBarcodestring

Штрих-код на возвратном отправлении (WB: barcode).

articlestring

Артикул товара на момент создания возврата.

externalOrderIdstring

Номер отправления на маркетплейсе (Ozon: posting_number, WB: stickerId, ЯМ: orderId).

returnOrderIdstring

Номер возвратного отправления (Ozon: return_clearing_id, WB: srid, ЯМ:id).

externalProductIdinteger · int64

Идентификатор товара на маркетплейсе (Ozon: product_id, WB: nmId, YM: marketSku).

quantityinteger · int32

Количество товара для возврата, WB: 1 всегда.

officeIdinteger · int64

Идентификатор офиса/ПВЗ маркетплейса (Ozon: place_id, WB: dstOfficeId).

officeAddressstring

Адрес офиса/ПВЗ маркетплейса (WB: dstOfficeAddress).

orderIdinteger · int64

Идентификатор заказа SelSup.

pricenumber · double

Цена товара.

currencyCodestring

Валюта.

orderProductIdinteger · int64

Идентификатор позиции заказа SelSup.

returnDatestring · date-time

Дата возврата (Ozon: return_date, WB: orderDt).

returnReasonNamestring

Причина возврата (Ozon: return_reason_name).

statusstring

Статус возврата.

modifyDatestring · date-time

Дата последнего изменения статуса или полей возвратного отправления.

createdDatestring · date-time

Дата создания записи о возврате.

uniqueIdstring

Уникальный идентификатор

servicestring

Маркетплейс

productIdinteger · int64

Идентификатор продукта

productViewIdinteger · int64

Идентификатор представления продукта

productModelIdinteger · int64

Идентификатор модели продукта

clientIdinteger · int64

Идентификатор клиента

organizationIdinteger · int64

Идентификатор организации

Контракт ошибок

Как API возвращает прикладные ошибки

Код ошибки одинаков для всех локалей, а текст для пользователя переводится сервером. Поэтому бизнес-логику стройте по error, а localMessage используйте только для отображения.

error

Стабильный машинный код ошибки для логики интеграции.

localMessage

Готовое сообщение на языке пользователя API-токена.

params

Значения

Язык localMessage определяется полем lang пользователя, которому принадлежит API-токен. Язык страницы документации и заголовок Accept-Language его не переключают; если язык пользователя не указан, используется русский.

RUПользователь с локалью ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
ENПользователь с локалью en
{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Методы

Методы

POST

Обновление списка возвратов

/api/return/download
Токен с правами записи

Метод ставит в очередь задачу по загрузке перечня возвратов из маркетплейсов

Параметры запроса

ПолеТипОбязательноОписание
productAnalyticField stringBARCODE, COLOR, ARTICLE, BRAND, CATEGORY Да Агрегировать данные по сущности
query string Нет Поисковый запрос для фильтрации аналитики
withDuplicate boolean Нет Отдавать аналитику по дубликатам товаров
withBonus boolean Нет Вычитать бонусы Ozon и Яндекс Маркета, а также СПП Wildberries из выручки и расходов
byOrgAndService boolean Нет Для Excel финансового отчёта: true — колонки по паре организация + маркетплейс, false/null — агрегировать по организации как раньше
byOrderType boolean Нет Разбивать финансовый отчёт по типу заказа: отдельные строки для маркетплейсов, розницы и опта
limit integer · int32 Нет Количество записей в ответе
page integer · int32 Нет Страница для навигации по страницам, начиная с 1
sortBy string Нет Поле сортировки
ascending boolean Нет Сортировать по возрастанию по полю sortBy
id integer · int64 Нет Поле id.
isMarketPlaceStructure boolean Нет Идентификатор, получать данные только по маркетплейсу или по всем.
isDashboard boolean Нет Идентификатор, запрос с дашборда или нет.
analyticsField stringPRODUCT, MODEL, GROUP, ORGANIZATION, CLIENT, CATEGORY, PRODUCT_VIEW, BRAND, REGION, WAREHOUSE Нет Агрегировать данные по model/product/view
planDayCount integer · int32 Нет Кол-во дней для отчетов
daysToSupply integer · int32 Нет Через сколько дней ожидается поставка
plannedSupplyDate string · date-time Нет Планируемая дата поставки
groupByView boolean Нет Сгруппировать по цвету
warehouses integer[] Нет Список идентификаторов складов
salesModels string[] Нет Модели продаж для отчёта экономики складов
aggregation stringWAREHOUSE, WAREHOUSE_PRODUCT Нет Уровень агрегации отчёта экономики складов
columns FileExportColumn[] Нет Настроенные пользователем колонки Excel
Структура элемента массива FileExportColumn
ПолеТипОбязательноОписание
id integer · int64 Нет ID записи
fileExportId integer · int64 Нет ID конфигурации экспорта
columnName string Нет Название столбца
columnOrder integer · int32 Нет Порядок столбца в файле
isEnabled boolean Нет Включен ли столбец для экспорта
regions string[] Нет Список регионов
group boolean Нет Сгруппировать данные
calculationByOrders boolean Нет Делать расчет по заказанному количеству
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 Нет Операция по которой выводить данные
skipDayWithoutStocks boolean Нет Пропускать дни без остатков
replaceSetsByComponents boolean Нет Раскрывать комплекты по компонентам
distributeFbsByWarehouse boolean Нет Распределять FBS по складам пропорционально FBO
distributeFbsStock boolean Нет Распределять остатки FBS между маркетплейсами/складами
ignoreDumping boolean Нет Игнорировать слив товара (продажи по заниженной цене)
isSaleStructure boolean Нет Идентификатор, что нужно получить структуру по продажам
isAveragePerOneUnit boolean Нет Идентификатор, получить среднее за 1 единицу
updateDate boolean Нет Обновлять даты
useWeightedGroup boolean Нет Использовать группы по весу
isFindirRequest boolean Нет Является ли запрос - запросом для Задачника
brandIds integer[] Нет Фильтр по идентификаторам брендов (список)
categoryIds integer[] Нет Фильтр по идентификаторам категорий (список)
articles string[] Нет Фильтр по артикулу (список)
colors string[] Нет Фильтр по цвету (список)
sizes string[] Нет Фильтр по размеру (список)
barcodes string[] Нет Фильтр по штрих-коду (список)
tagIds integer[] Нет Фильтр по идентификаторам тегов товаров (список)
penaltyFrom number · double Нет Фильтр по штрафам (от)
penaltyTo number · double Нет Фильтр по штрафам (до)
logisticsFrom number · double Нет Фильтр по логистике (от)
logisticsTo number · double Нет Фильтр по логистике (до)
marginFrom number · double Нет Фильтр по маржинальности (от)
marginTo number · double Нет Фильтр по маржинальности (до)
salesAmountFrom number · double Нет Фильтр по сумме продаж (от)
salesAmountTo number · double Нет Фильтр по сумме продаж (до)
totalSalesAmountFrom number · double Нет Фильтр по выручке (от)
totalSalesAmountTo number · double Нет Фильтр по выручке (до)
grossProfitFrom number · double Нет Фильтр по валовой прибыли (от)
grossProfitTo number · double Нет Фильтр по валовой прибыли (до)
taxNds integer · int32 Нет Налог ндс
useOsno boolean Нет Тип налогообложения осно
period stringDAY, WEEK, MONTH, QUARTER, YEAR, MONTH_3, MONTH_6, END_OF_TARIFF, MONTH_7, MONTH_14, YEAR_2 Нет Период агрегации
dateFrom string · date-time Да Дата начала отчета
dateTo string · date-time Да Дата окончания отчета
services string[] Нет Список маркетплейсов для которых отдать данные
categories integer[] Нет Фильтр категорий для которых отдать данные
brands integer[] Нет Фильтр брендов для которых отдать данные
clientOrganizationId integer · int64 Нет Идентификатор организации, для которой отдать данные
organizations integer[] Нет Идентификаторы организаций клиента
ids integer[] Нет Список идентификаторов
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа
types string[] Нет Типы заказа
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 Нет Статус заказа
timeZone integer · int32 Нет Часовой пояс клиента по UTC
previousDateFrom string · date-time Нет Дата начала периода для сравнения
clientOrganizationIds integer[] Нет Идентификаторы организаций, для которых отдать данные
ignoreCredit boolean Нет Не учитывать кредит в прочих удержаниях
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'

Успешный ответ

200
Поля объекта TmsTask
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор задачи
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Нет Текущий статус задачи
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 Нет Тип задачи
name string Нет Данные задачи в json - могут быть пустыми
clientId integer · int64 Нет Поле clientId.
entityId integer · int64 Нет Сущность, к которой относится задача
progress integer · int32 Нет Прогресс выполнения задачи в процентах
processedQuantity integer · int32 Нет Количество обработанных записей задачи
organizationId integer · int64 Нет Организация задачи, может быть 0, если не зависит от организации
priority integer · int32 Нет Приоритет задачи - чем выше тем быстрее задача запустится
properties string Нет Параметры задачи
message string Нет Сообщение с результатом выполнения задачи
messageParams string Нет Параметры сообщения с результатом выполнения задачи
createdDate string · date-time Нет Дата добавления задачи в очередь
startDate string · date-time Нет Дата запуска задачи
finishDate string · date-time Нет Дата завершения задачи
url string Нет Ссылка на скачивание файла с результатом задачи
inputFileUrl string Нет Ссылка на загруженный файл
retryNumber integer · int32 Нет Счётчик перезапуска задачи.
userId integer · int32 Нет Пользователь запустивший задачу
retryDate string · date-time Нет Запланированная дата перезапуска
debug boolean Нет Запуск задачи в режиме отладки с большим логированием
forcedStart boolean Нет Ручной запуск задачи
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

400error_organization_not_found
Не найдена организация

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.

GET

Поиск возвратов

/api/return/find
Токен с правами чтения

Возвращает список возвратных отправлений, найденных по фильтру

Параметры запроса

ПолеТипОбязательноОписание
id integer · int64 Нет ID возврата
organizationId integer · int64 Нет Идентификатор организации.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа FBO/FBS.
orderBarcode string Нет Штрих-код изначального отправления (Ozon: clearing_id).
services string[] Нет Маркетплейсы по которым показать данные
barcode string Нет Штрих-код на возвратном отправлении (Ozon: return_barcode, WB: shkId).
productBarcode string Нет Штрих-код на возвратном отправлении (WB: barcode).
article string Нет Артикул товара на момент создания возврата.
externalOrderId string Нет Номер отправления на маркетплейсе (Ozon: posting_number, WB: stickerId, ЯМ: orderId).
returnOrderId string Нет Номер возвратного отправления (Ozon: return_clearing_id, WB: srid, ЯМ:id).
externalProductId integer · int64 Нет ID товара на маркетплейсе (Ozon: product_id, WB: nmId).
officeId integer · int64 Нет ID офиса/ПВЗ маркетплейса (Ozon: place_id, WB: dstOfficeId).
officeAddress string Нет Адрес офиса/ПВЗ маркетплейса (WB: dstOfficeAddress).
orderId integer · int64 Нет ID заказа SelSup
orderProductId integer · int64 Нет ID позиции заказа SelSup
returnReasonName string Нет Причина возврата (Ozon: return_reason_name)
status string Нет Статус возврата
timeZone integer · int32 Нет Временная зона пользователя
modifyDate string · date-time Нет Дата последнего изменения статуса или полей возвратного отправления.
dateFrom string · date-time Нет Дата с которой ищем возвраты.
dateTo string · date-time Нет Дата до которой ищем возвраты.
modifiedDateFrom string · date-time Нет Дата с которой ищем возвраты.
modifiedDateTo string · date-time Нет Дата до которой ищем возвраты.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
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 Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/return/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта FindResponseReturnReport
ПолеТипОбязательноОписание
rows ReturnReport[] Нет Строки с результатом поиска
Структура элемента массива ReturnReport
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор возврата.
orderType string Нет Тип заказа FBO/FBS.
orderBarcode string Нет Штрих-код изначального отправления (Ozon: clearing_id).
barcode string Нет Штрих-код на возвратном отправлении (Ozon: return_barcode, WB: shkId).
productBarcode string Нет Штрих-код на возвратном отправлении (WB: barcode).
article string Нет Артикул товара на момент создания возврата.
externalOrderId string Нет Номер отправления на маркетплейсе (Ozon: posting_number, WB: stickerId, ЯМ: orderId).
returnOrderId string Нет Номер возвратного отправления (Ozon: return_clearing_id, WB: srid, ЯМ:id).
externalProductId integer · int64 Нет Идентификатор товара на маркетплейсе (Ozon: product_id, WB: nmId, YM: marketSku).
quantity integer · int32 Нет Количество товара для возврата, WB: 1 всегда.
officeId integer · int64 Нет Идентификатор офиса/ПВЗ маркетплейса (Ozon: place_id, WB: dstOfficeId).
officeAddress string Нет Адрес офиса/ПВЗ маркетплейса (WB: dstOfficeAddress).
orderId integer · int64 Нет Идентификатор заказа SelSup.
price number · double Нет Цена товара.
currencyCode string Нет Валюта.
orderProductId integer · int64 Нет Идентификатор позиции заказа SelSup.
returnDate string · date-time Нет Дата возврата (Ozon: return_date, WB: orderDt).
returnReasonName string Нет Причина возврата (Ozon: return_reason_name).
status string Нет Статус возврата.
modifyDate string · date-time Нет Дата последнего изменения статуса или полей возвратного отправления.
createdDate string · date-time Нет Дата создания записи о возврате.
uniqueId string Нет Уникальный идентификатор
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 Нет Маркетплейс
productId integer · int64 Нет Идентификатор продукта
productViewId integer · int64 Нет Идентификатор представления продукта
productModelId integer · int64 Нет Идентификатор модели продукта
clientId integer · int64 Нет Идентификатор клиента
organizationId integer · int64 Нет Идентификатор организации
{
  "rows": "string"
}
Ошибки5

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

400error_analytics_access_denied
Данные аналитики конфиденциальны для роли SUPPORT

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_analytics_access_denied; localMessage содержит приведённый выше перевод.

400error_no_client
Клиент не найден или был удален. Напишите в поддержку

Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.

GET

Excel с возвратами товаров

/api/return/file
Токен с правами чтения

Возвращает файл с товарами, которые были возвращены

Параметры запроса

ПолеТипОбязательноОписание
id integer · int64 Нет ID возврата
organizationId integer · int64 Нет Идентификатор организации.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа FBO/FBS.
orderBarcode string Нет Штрих-код изначального отправления (Ozon: clearing_id).
services string[] Нет Маркетплейсы по которым показать данные
barcode string Нет Штрих-код на возвратном отправлении (Ozon: return_barcode, WB: shkId).
productBarcode string Нет Штрих-код на возвратном отправлении (WB: barcode).
article string Нет Артикул товара на момент создания возврата.
externalOrderId string Нет Номер отправления на маркетплейсе (Ozon: posting_number, WB: stickerId, ЯМ: orderId).
returnOrderId string Нет Номер возвратного отправления (Ozon: return_clearing_id, WB: srid, ЯМ:id).
externalProductId integer · int64 Нет ID товара на маркетплейсе (Ozon: product_id, WB: nmId).
officeId integer · int64 Нет ID офиса/ПВЗ маркетплейса (Ozon: place_id, WB: dstOfficeId).
officeAddress string Нет Адрес офиса/ПВЗ маркетплейса (WB: dstOfficeAddress).
orderId integer · int64 Нет ID заказа SelSup
orderProductId integer · int64 Нет ID позиции заказа SelSup
returnReasonName string Нет Причина возврата (Ozon: return_reason_name)
status string Нет Статус возврата
timeZone integer · int32 Нет Временная зона пользователя
modifyDate string · date-time Нет Дата последнего изменения статуса или полей возвратного отправления.
dateFrom string · date-time Нет Дата с которой ищем возвраты.
dateTo string · date-time Нет Дата до которой ищем возвраты.
modifiedDateFrom string · date-time Нет Дата с которой ищем возвраты.
modifiedDateTo string · date-time Нет Дата до которой ищем возвраты.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
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 Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/return/file?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

Успешный ответ

200
Поля объекта TmsTask
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор задачи
status stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION Нет Текущий статус задачи
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 Нет Тип задачи
name string Нет Данные задачи в json - могут быть пустыми
clientId integer · int64 Нет Поле clientId.
entityId integer · int64 Нет Сущность, к которой относится задача
progress integer · int32 Нет Прогресс выполнения задачи в процентах
processedQuantity integer · int32 Нет Количество обработанных записей задачи
organizationId integer · int64 Нет Организация задачи, может быть 0, если не зависит от организации
priority integer · int32 Нет Приоритет задачи - чем выше тем быстрее задача запустится
properties string Нет Параметры задачи
message string Нет Сообщение с результатом выполнения задачи
messageParams string Нет Параметры сообщения с результатом выполнения задачи
createdDate string · date-time Нет Дата добавления задачи в очередь
startDate string · date-time Нет Дата запуска задачи
finishDate string · date-time Нет Дата завершения задачи
url string Нет Ссылка на скачивание файла с результатом задачи
inputFileUrl string Нет Ссылка на загруженный файл
retryNumber integer · int32 Нет Счётчик перезапуска задачи.
userId integer · int32 Нет Пользователь запустивший задачу
retryDate string · date-time Нет Запланированная дата перезапуска
debug boolean Нет Запуск задачи в режиме отладки с большим логированием
forcedStart boolean Нет Ручной запуск задачи
service stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC Нет Сервис в рамках которого выполняется задача
lang string Нет Язык на котором сейчас запущена таска
{
  "id": 1001,
  "status": "CREATED",
  "type": "WILDBERRIES_CREATE_CARD",
  "name": "Example",
  "clientId": 1001,
  "entityId": 1001
}
Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required
Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied
Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown
Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

Authorization

Токен для тестовых запросов

Токен хранится только в localStorage этого браузера и отправляется исключительно в заголовке Authorization запросов к api.selsup.ru.

Попробовать

Параметры реального запроса

Реальный ответ API

Выполните запрос, чтобы увидеть ответ SelSup.