SelSup Developers

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

Сертификаты качества

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

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

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

/api/qualityDocument

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

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

01

Начать работу с разделом «Сертификаты качества»

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

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

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

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

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

QualityDocumentImage5 полей
idinteger · int64

Поле id.

urlstring

Поле url.

positioninteger · int32

Поле position.

documentIdinteger · int64

Поле documentId.

clientIdinteger · int64

Поле clientId.

AliexpressCategory8 полей
idinteger · int64

Поле id.

namestring

Поле name.

publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

aliexpressIdinteger · int64

Поле aliexpressId.

lastSyncDatestring · date-time

Дата последней синхронизации категории

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

isLeafboolean

Категория является листовой. Карточки можно добавлять только в листовые

AvitoCategory9 полей
idinteger · int64

Идентификатор категории на Авито.Совпадает с идентификатором Авито

Обязательно
namestring

Полное название категории (включает в себя названия родительских категорий)

Обязательно
shortNamestring

Краткое название категории

publishedboolean

Опубликована категория

parentIdinteger · int64

id родительской категории Авито. Используется при импорте обьявлений с Авито

lastSyncDatestring · date-time

Дата последней синхронизации категории

isLeafboolean

Категория является листовой. Карточки можно добавлять только в листовые

goodsTypestring

Тег GoodsType в фиде

categorystring

Тег Category в фиде

Brand11 полей
brandIdinteger · int32

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

read-only
namestring

Название бренда

Обязательно
clientIdinteger · int64

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

read-only
logoUrlstring

Ссылка логотипа бренда

read-only
logoSizeinteger · int32

Размер логотипа в байтах

read-only
logoWidthinteger · int32

Ширина логотипа в пикселях

read-only
logoHeightinteger · int32

Высота логотипа в пикселях

read-only
deletedboolean

Бренд удален?

ozonNamestring

Название бренда на Ozon

ozonIdinteger · int64

ID бренда на Ozon

oneCIdstring

Идентификатор 1С

Category47 полей
categoryIdinteger · int32

Идентификатор категории. Проставляется автоматически

read-only
namestring

Наименование категории

Обязательно
deletedboolean

Признак удаленных категорий

read-only
parentIdinteger · int32

Идентификатор родительской категории

clientIdinteger · int64

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

read-only
markedboolean

Маркируется ли категория

categoryClassstring

Тип категории для Честного знака. По умолчанию ставится OTHER

wildberriesTypeWildberriesType

Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор

wildberriesCategoryIdinteger · int64

Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries

wildberriesFbmCommissionnumber · double

Комиссия по тарифу FBM

read-only
wildberriesFbwCommissionnumber · double

Комиссия по тарифу FBW

read-only
wildberriesFbsCommissionnumber · double

Комиссия по тарифу FBS

read-only
wildberriesDbsCommissionnumber · double

Комиссия по тарифу DBS

read-only
wildberriesEdbsCommissionnumber · double

Комиссия по тарифу EDBS

read-only
wildberriesCAndCCommissionnumber · double

Комиссия по тарифу C&C

read-only
wildberriesBookingCommissionnumber · double

Комиссия за бронирование

read-only
ozonDescriptionCategoryIdinteger · int64

Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon

yandexMarketCategoryIdinteger · int64

Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет

yandexMarketCategoryYandexMarketCategory

Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор

ozonDescriptionCategoryOzonDescriptionCategory

Категория Озон

ozonCommissionnumber · double

Комиссия озона.

read-only
tnvedTnved

ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД

tnvedIdinteger · int64

Идентификатор ТНВЭД

laundrystring

Правила ухода за вещами. Разделяются запятыми

paramsstring

JSON значений параметров для категории

namePatternstring

Шаблон названий категории

aliexpressCategoryAliexpressCategory

Категория Aliexpress

aliexpressCategoryIdinteger · int64

Идентификатор категории на самом Aliexpress

avitoCategoryAvitoCategory

Категория Avito

lamodaCategoryLamodaCategory

Категория Lamoda

lamodaCategoryIdinteger · int64

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

avitoCategoryIdinteger · int64

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

packDepthinteger · int32

Глубина упаковки в мм. Проставляется всем товарам в категории

packWidthinteger · int32

Ширина упаковки в мм. Проставляется всем товарам в категории

packHeightinteger · int32

Высота упаковки в мм. Проставляется всем товарам в категории

packWeightinteger · int32

Вес упаковки в граммах. Проставляется всем товарам в категории

hasSizeboolean

Признак разделения товаров в категории по размеру. Меняет вид редактора карточки

hasColorboolean

Признак разделения товаров в категории по цвету. Меняет вид редактора карточки

autoNameboolean

Автоматически формировать названия товаров в категории

removeFbsStockboolean

Не передавать остатки товаров по FBS для товаров из этой категории

oneCIdstring

Идентификатор категории в 1С

externalIdstring

Идентификатор категории на сайте

moySkladIdstring

Идентификатор категории в сервисе МойСклад

useClientParamsboolean

Показывать пользовательские параметры в категории

requiredExpirationDateboolean

Является ли срок годности обязательным параметром

serviceCategoryMappingsobject

Универсальные привязки категории к категориям внешних сервисов

productCountinteger · int32

Количество товаров в категории. Отдается только при withProductCount=true

LamodaCategory8 полей
idinteger · int64

Поле id.

namestring

Название

shortNamestring

Краткое название категории

publishedboolean

Опубликованность категории

isLeafboolean

Листовая категория

parentIdinteger · int64

Поле parentId.

lastSyncDatestring · date-time

Дата последней синхронизации

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

OzonDescriptionCategory21 полей
idinteger · int64

Идентификатор категории на Ozon. Состоит из двух идентификаторов Категории + ID типа на самом Ozon

namestring

Название категории

Обязательно
publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

isLeafboolean

Признак листовой категории, в которой могут находиться товары

lastSyncDatestring · date-time

Дата последней синхронизации категории с Озон

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

isErrorboolean

Поле isError.

errorDatestring · date

Поле errorDate.

typesstring

Поле types.

typeIdinteger · int64

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

purchasePercentAvgnumber · double

Среднее значение процента выкупа. Используется в AI Финдире

purchasePercentMinnumber · double

Минимально допустимое значение процента выкупа. Используется в AI Финдире

photoAvginteger · int32

Среднее кол-во фотографий. Используется в AI Финдире

photoMininteger · int32

Минимально допустимое кол-во фотографий. Используется в AI Финдире

drrAvgnumber · double

Среднее значение ДРР. Используется в AI Финдире

drrMinnumber · double

Минимально допустимое значение ДРР. Используется в AI Финдире

marginAvgnumber · double

Среднее значение маржинальности. Используется в AI Финдире

marginMinnumber · double

Минимально допустимое значение маржинальности. Используется в AI Финдире

promotionCtrAvgnumber · double

Среднее значение CTR рекламной кампании. Используется в AI Финдире

promotionCtrMinnumber · double

Минимально допустимое значение CTR рекламной кампании. Используется в AI Финдире

QualityDocument12 полей
idinteger · int64

Поле id.

namestring

Поле name.

typestring

Тип документа

numberstring

Номер сертификата

numberNormalizedstring

Нормализованный номер сертификата, используется для поиска дублей

clientIdinteger · int64

Поле clientId.

versionIdinteger · int64

Поле versionId.

createdUserstring

Поле createdUser.

startDatestring · date

Дата начала действия сертификата

expireDatestring · date

Дата окончания срока действия сертификата

dataQualityDocumentData[]

Связи сертификата с брендом и категорией

imagesQualityDocumentImage[]

Изображения сертификата

QualityDocumentData8 полей
idinteger · int64

Поле id.

documentIdinteger · int64

Сертификат

productModelIdinteger · int64

Связь сертификата с продуктом

brandBrand

Связь сертификата с брендом

brandIdinteger · int32

Поле brandId.

categoryCategory

Связь категории с сертификатом

categoryIdinteger · int32

Поле categoryId.

clientIdinteger · int64

Поле clientId.

ServiceCategoryMapping3 полей
servicestring

Сервис

externalIdstring

Поле externalId.

namestring

Поле name.

Tnved14 полей
idinteger · int64

Идентификатор кода ТНВЭД без нулей в начале

namestring

Название кода ТНВЭД

deletedboolean

Поле deleted.

typestring

Тип

categoryClassstring

Информационное поле, чтобы автоматически заполнять значение в категории,при выборе ТНВЭД, но никогда не используется в документах

parentIdinteger · int64

Родительский ТНВЭД

keywordsstring

Ключевые слова для кода ТНВЭД

descriptionstring

Описание кода ТНВЭД

paramsTnvedIdinteger · int64

Идентификатор категории национального каталога (cat_id)

isInParamboolean

Означает что ТНВЭД есть в параметре Вайлдбериз - их нужно выбирать в приоритете

certificationstring

Необходимость сертификации товаров с этим ТНВЭД

parentCodestring

Поле parentCode.

codestring

Поле code.

certificationRequiredboolean

Поле certificationRequired.

WildberriesType32 полей
idinteger · int64

Поле id.

namestring

Название

publishedboolean

Опубликованность предмета Вайлдбериз

hasSizeboolean

Атрибут, указывающий наличие размера

monoBoxMinQuantityinteger · int32

Поле monoBoxMinQuantity.

monoTypestring

Поле monoType.

monoMinPriceinteger · int32

Поле monoMinPrice.

hasParentboolean

Поле hasParent.

parentIdinteger · int64

Поле parentId.

wildberriesIdinteger · int64

Идентификатор предмета на Вайлдбериз

lastSyncDatestring · date-time

Дата последней синхронизации предмета с Вайлдбериз

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

commissionnumber · double

Комиссия для товаров данного предмета в Вайлдбериз по FBM

fbsCommissionnumber · double

Комиссия для товаров данного предмета в Вайлдбериз по FBS

fbwCommissionnumber · double

Комиссия по тарифу FBW

dbsCommissionnumber · double

Комиссия по тарифу DBS

edbsCommissionnumber · double

Комиссия по тарифу EDBS

cAndCCommissionnumber · double

Комиссия по тарифу C&C

bookingCommissionnumber · double

Комиссия за бронирование

logisticPriceinteger · int32

Стоимость доставки товара к клиенту на Вайлдбериз

storagePricenumber · double

Стоимость хранения товара на складе Вайлдбериз за штуку в день

acceptancePricenumber · double

Стоимость приемки товара на складе Вайлдбериз за штуку

needDimensionsboolean

Атрибут обязательности габаритов товара, тк стоимость хранения рассчитывается на основе габаритов

purchasePercentAvgnumber · double

Среднее значение процента выкупа. Используется в AI Финдире

purchasePercentMinnumber · double

Минимально допустимое значение процента выкупа. Используется в AI Финдире

photoAvginteger · int32

Среднее кол-во фотографий. Используется в AI Финдире

photoMininteger · int32

Минимально допустимое кол-во фотографий. Используется в AI Финдире

drrAvgnumber · double

Среднее значение ДРР. Используется в AI Финдире

drrMinnumber · double

Минимально допустимое значение ДПП. Используется в AI Финдире

marginAvgnumber · double

Среднее значение маржинальности. Используется в AI Финдире

marginMinnumber · double

Минимально допустимое значение маржинальности. Используется в AI Финдире

candCCommissionnumber · double

Поле candCCommission.

YandexMarketCategory7 полей
idinteger · int64

Поле id.

namestring

Название категории

Обязательно
publishedboolean

Поле published.

parentIdinteger · int64

Поле parentId.

isLeafboolean

Признак листовой категории, в которой могут находиться товары

lastSyncDatestring · date-time

Дата последней синхронизации категории с Озон

notChangedDaysinteger · int32

Количество дней, в течение которых данные категории не менялась. Используется для того, чтобы сократить обновление категорий, которые не меняются

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

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

FindResponseQualityDocument1 полей
rowsQualityDocument[]

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

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

Как 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/qualityDocument/uploadQualityDocumentImage
Токен с правами записи

Позволяет загрузить изображение и связать его с сертификатом

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

ПолеТипОбязательноОписание
documentId integer · int64 Да Поле documentId.

Тело запроса

multipart/form-data
ПолеТипОбязательноОписание
file string · binary Да Поле file.
curl --request POST 'https://api.selsup.ru/api/qualityDocument/uploadQualityDocumentImage?documentId=1001' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./file.bin'

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

200
Поля объекта QualityDocumentImage
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
url string Нет Поле url.
position integer · int32 Нет Поле position.
documentId integer · int64 Нет Поле documentId.
clientId integer · int64 Нет Поле clientId.
{
  "id": 1001,
  "url": "https://example.com",
  "position": 1,
  "documentId": 1001,
  "clientId": 1001
}
Ошибки8

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

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

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

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

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

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

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

400error_max_upload_size_exceeded
Допустимый размер файла превышен

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

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

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

400error_quality_document_not_found
Сертификат не найден

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

400error_storage_size_exceeded
Вы превысили лимит на размер хранилища файлов: {limit} Мб

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

400error_wrong_image_format
Некорректный формат изображения для файла: {name}

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

POST

Обновить сертификат качества

/api/qualityDocument/updateQualityDocument
Токен с правами записи

Обновляет данные сертификата качества

Тело запроса

application/json
Поля объектаQualityDocument
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
type stringDECLARATION, CERTIFICATE, REFUSAL, REGISTRATION Нет Тип документа
number string Нет Номер сертификата
numberNormalized string Нет Нормализованный номер сертификата, используется для поиска дублей
clientId integer · int64 Нет Поле clientId.
versionId integer · int64 Нет Поле versionId.
createdUser string Нет Поле createdUser.
startDate string · date Нет Дата начала действия сертификата
expireDate string · date Нет Дата окончания срока действия сертификата
data QualityDocumentData[] Нет Связи сертификата с брендом и категорией
Структура элемента массива QualityDocumentData
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
documentId integer · int64 Нет Сертификат
productModelId integer · int64 Нет Связь сертификата с продуктом
brand Brand Нет Связь сертификата с брендом
Поля объекта Brand
ПолеТипОбязательноОписание
brandId integer · int32 Нет Идентификатор бренда
name string Да Название бренда
clientId integer · int64 Нет Идентификатор клиента
logoUrl string Нет Ссылка логотипа бренда
logoSize integer · int32 Нет Размер логотипа в байтах
logoWidth integer · int32 Нет Ширина логотипа в пикселях
logoHeight integer · int32 Нет Высота логотипа в пикселях
deleted boolean Нет Бренд удален?
ozonName string Нет Название бренда на Ozon
ozonId integer · int64 Нет ID бренда на Ozon
oneCId string Нет Идентификатор 1С
brandId integer · int32 Нет Поле brandId.
category Category Нет Связь категории с сертификатом
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
lamodaCategory LamodaCategory Нет Категория Lamoda
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryId integer · int32 Нет Поле categoryId.
clientId integer · int64 Нет Поле clientId.
images QualityDocumentImage[] Нет Изображения сертификата
Структура элемента массива QualityDocumentImage
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
url string Нет Поле url.
position integer · int32 Нет Поле position.
documentId integer · int64 Нет Поле documentId.
clientId integer · int64 Нет Поле clientId.
curl --request POST 'https://api.selsup.ru/api/qualityDocument/updateQualityDocument' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "type": "DECLARATION",
  "number": "string",
  "numberNormalized": "string",
  "clientId": 1001
}'

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

200
Поля объекта QualityDocument
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
type stringDECLARATION, CERTIFICATE, REFUSAL, REGISTRATION Нет Тип документа
number string Нет Номер сертификата
numberNormalized string Нет Нормализованный номер сертификата, используется для поиска дублей
clientId integer · int64 Нет Поле clientId.
versionId integer · int64 Нет Поле versionId.
createdUser string Нет Поле createdUser.
startDate string · date Нет Дата начала действия сертификата
expireDate string · date Нет Дата окончания срока действия сертификата
data QualityDocumentData[] Нет Связи сертификата с брендом и категорией
Структура элемента массива QualityDocumentData
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
documentId integer · int64 Нет Сертификат
productModelId integer · int64 Нет Связь сертификата с продуктом
brand Brand Нет Связь сертификата с брендом
Поля объекта Brand
ПолеТипОбязательноОписание
brandId integer · int32 Нет Идентификатор бренда
name string Да Название бренда
clientId integer · int64 Нет Идентификатор клиента
logoUrl string Нет Ссылка логотипа бренда
logoSize integer · int32 Нет Размер логотипа в байтах
logoWidth integer · int32 Нет Ширина логотипа в пикселях
logoHeight integer · int32 Нет Высота логотипа в пикселях
deleted boolean Нет Бренд удален?
ozonName string Нет Название бренда на Ozon
ozonId integer · int64 Нет ID бренда на Ozon
oneCId string Нет Идентификатор 1С
brandId integer · int32 Нет Поле brandId.
category Category Нет Связь категории с сертификатом
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
lamodaCategory LamodaCategory Нет Категория Lamoda
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryId integer · int32 Нет Поле categoryId.
clientId integer · int64 Нет Поле clientId.
images QualityDocumentImage[] Нет Изображения сертификата
Структура элемента массива QualityDocumentImage
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
url string Нет Поле url.
position integer · int32 Нет Поле position.
documentId integer · int64 Нет Поле documentId.
clientId integer · int64 Нет Поле clientId.
{
  "id": 1001,
  "name": "Example",
  "type": "DECLARATION",
  "number": "string",
  "numberNormalized": "string",
  "clientId": 1001
}
Ошибки6

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

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

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

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

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

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

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

400error_document_already_exist
Документ с таким именем уже существует

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

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

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

400error_quality_document_version_conflict
Документ был изменён другим пользователем. Обновите страницу и попробуйте снова

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

POST

Удалить сертификат качества

/api/qualityDocument/removeQualityDocument
Токен с правами записи

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

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

ПолеТипОбязательноОписание
documentId integer · int64 Да Поле documentId.
curl --request POST 'https://api.selsup.ru/api/qualityDocument/removeQualityDocument?documentId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

Тело ответа пустое.

Ошибки4

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

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

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

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

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

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

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

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

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

POST

Массовый импорт сертификатов из Excel

/api/qualityDocument/importCertificates
Токен с правами записи

Создаёт задачу импорта сертификатов и связей с товарами из Excel-файла. Строки с одинаковым типом и номером документа объединяются в один сертификат

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

ПолеТипОбязательноОписание
replaceConnects boolean Нет Поле replaceConnects.

Тело запроса

multipart/form-data
ПолеТипОбязательноОписание
file string · binary Да Excel-файл с сертификатами
curl --request POST 'https://api.selsup.ru/api/qualityDocument/importCertificates' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --form 'file=@./file.bin'

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

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
}
Ошибки4

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

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

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

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

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

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

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

400error_max_upload_size_exceeded
Допустимый размер файла превышен

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

POST

Шаблон файла импорта сертификатов

/api/qualityDocument/exportCertificateTemplate
Токен с правами записи

Создаёт задачу формирования Excel-шаблона для массового импорта сертификатов

curl --request POST 'https://api.selsup.ru/api/qualityDocument/exportCertificateTemplate' \
  --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
Непредвиденная ошибка

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

POST

Удалить изображение сертификата

/api/qualityDocument/deleteQualityDocumentImage
Токен с правами записи

Удаляет изображение сертификата качества

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

ПолеТипОбязательноОписание
imageId integer · int64 Да Поле imageId.
curl --request POST 'https://api.selsup.ru/api/qualityDocument/deleteQualityDocumentImage?imageId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

Тело ответа пустое.

Ошибки4

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

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

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

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

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

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

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

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

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

POST

Добавить сертификат качества

/api/qualityDocument/createQualityDocument
Токен с правами записи

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

Тело запроса

application/json
Поля объектаQualityDocument
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
type stringDECLARATION, CERTIFICATE, REFUSAL, REGISTRATION Нет Тип документа
number string Нет Номер сертификата
numberNormalized string Нет Нормализованный номер сертификата, используется для поиска дублей
clientId integer · int64 Нет Поле clientId.
versionId integer · int64 Нет Поле versionId.
createdUser string Нет Поле createdUser.
startDate string · date Нет Дата начала действия сертификата
expireDate string · date Нет Дата окончания срока действия сертификата
data QualityDocumentData[] Нет Связи сертификата с брендом и категорией
Структура элемента массива QualityDocumentData
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
documentId integer · int64 Нет Сертификат
productModelId integer · int64 Нет Связь сертификата с продуктом
brand Brand Нет Связь сертификата с брендом
Поля объекта Brand
ПолеТипОбязательноОписание
brandId integer · int32 Нет Идентификатор бренда
name string Да Название бренда
clientId integer · int64 Нет Идентификатор клиента
logoUrl string Нет Ссылка логотипа бренда
logoSize integer · int32 Нет Размер логотипа в байтах
logoWidth integer · int32 Нет Ширина логотипа в пикселях
logoHeight integer · int32 Нет Высота логотипа в пикселях
deleted boolean Нет Бренд удален?
ozonName string Нет Название бренда на Ozon
ozonId integer · int64 Нет ID бренда на Ozon
oneCId string Нет Идентификатор 1С
brandId integer · int32 Нет Поле brandId.
category Category Нет Связь категории с сертификатом
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
lamodaCategory LamodaCategory Нет Категория Lamoda
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryId integer · int32 Нет Поле categoryId.
clientId integer · int64 Нет Поле clientId.
images QualityDocumentImage[] Нет Изображения сертификата
Структура элемента массива QualityDocumentImage
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
url string Нет Поле url.
position integer · int32 Нет Поле position.
documentId integer · int64 Нет Поле documentId.
clientId integer · int64 Нет Поле clientId.
curl --request POST 'https://api.selsup.ru/api/qualityDocument/createQualityDocument' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 1001,
  "name": "Example",
  "type": "DECLARATION",
  "number": "string",
  "numberNormalized": "string",
  "clientId": 1001
}'

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

200
Поля объекта QualityDocument
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
type stringDECLARATION, CERTIFICATE, REFUSAL, REGISTRATION Нет Тип документа
number string Нет Номер сертификата
numberNormalized string Нет Нормализованный номер сертификата, используется для поиска дублей
clientId integer · int64 Нет Поле clientId.
versionId integer · int64 Нет Поле versionId.
createdUser string Нет Поле createdUser.
startDate string · date Нет Дата начала действия сертификата
expireDate string · date Нет Дата окончания срока действия сертификата
data QualityDocumentData[] Нет Связи сертификата с брендом и категорией
Структура элемента массива QualityDocumentData
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
documentId integer · int64 Нет Сертификат
productModelId integer · int64 Нет Связь сертификата с продуктом
brand Brand Нет Связь сертификата с брендом
Поля объекта Brand
ПолеТипОбязательноОписание
brandId integer · int32 Нет Идентификатор бренда
name string Да Название бренда
clientId integer · int64 Нет Идентификатор клиента
logoUrl string Нет Ссылка логотипа бренда
logoSize integer · int32 Нет Размер логотипа в байтах
logoWidth integer · int32 Нет Ширина логотипа в пикселях
logoHeight integer · int32 Нет Высота логотипа в пикселях
deleted boolean Нет Бренд удален?
ozonName string Нет Название бренда на Ozon
ozonId integer · int64 Нет ID бренда на Ozon
oneCId string Нет Идентификатор 1С
brandId integer · int32 Нет Поле brandId.
category Category Нет Связь категории с сертификатом
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
lamodaCategory LamodaCategory Нет Категория Lamoda
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryId integer · int32 Нет Поле categoryId.
clientId integer · int64 Нет Поле clientId.
images QualityDocumentImage[] Нет Изображения сертификата
Структура элемента массива QualityDocumentImage
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
url string Нет Поле url.
position integer · int32 Нет Поле position.
documentId integer · int64 Нет Поле documentId.
clientId integer · int64 Нет Поле clientId.
{
  "id": 1001,
  "name": "Example",
  "type": "DECLARATION",
  "number": "string",
  "numberNormalized": "string",
  "clientId": 1001
}
Ошибки6

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

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

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

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

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

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

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

400error_create_quality_document
Не удалось создать документ качества

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

400error_document_already_exist
Документ с таким именем уже существует

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

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

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

GET

Список сертификатов продукта

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

Позволяет получить сертификаты качества продукта

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

ПолеТипОбязательноОписание
modelId integer · int64 Да Поле modelId.
curl --request GET 'https://api.selsup.ru/api/qualityDocument/getQualityDocumentByModel?modelId=1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива QualityDocument[]
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
type stringDECLARATION, CERTIFICATE, REFUSAL, REGISTRATION Нет Тип документа
number string Нет Номер сертификата
numberNormalized string Нет Нормализованный номер сертификата, используется для поиска дублей
clientId integer · int64 Нет Поле clientId.
versionId integer · int64 Нет Поле versionId.
createdUser string Нет Поле createdUser.
startDate string · date Нет Дата начала действия сертификата
expireDate string · date Нет Дата окончания срока действия сертификата
data QualityDocumentData[] Нет Связи сертификата с брендом и категорией
Структура элемента массива QualityDocumentData
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
documentId integer · int64 Нет Сертификат
productModelId integer · int64 Нет Связь сертификата с продуктом
brand Brand Нет Связь сертификата с брендом
Поля объекта Brand
ПолеТипОбязательноОписание
brandId integer · int32 Нет Идентификатор бренда
name string Да Название бренда
clientId integer · int64 Нет Идентификатор клиента
logoUrl string Нет Ссылка логотипа бренда
logoSize integer · int32 Нет Размер логотипа в байтах
logoWidth integer · int32 Нет Ширина логотипа в пикселях
logoHeight integer · int32 Нет Высота логотипа в пикселях
deleted boolean Нет Бренд удален?
ozonName string Нет Название бренда на Ozon
ozonId integer · int64 Нет ID бренда на Ozon
oneCId string Нет Идентификатор 1С
brandId integer · int32 Нет Поле brandId.
category Category Нет Связь категории с сертификатом
Поля объекта Category
ПолеТипОбязательноОписание
categoryId integer · int32 Нет Идентификатор категории. Проставляется автоматически
name string Да Наименование категории
deleted boolean Нет Признак удаленных категорий
parentId integer · int32 Нет Идентификатор родительской категории
clientId integer · int64 Нет Идентификатор клиента
marked boolean Нет Маркируется ли категория
categoryClass stringSHOES, LIGHT, DRUGS, CAMERA, TYRES, MILK, WATER, TOBACCO, FURS, BEER, BICYCLES, PERFUMES, ELECTRONIC, OTHER, NONE, FOOD, WHEELCHAIRS, OTP, NCP, BIO, ANTISEPTIC, NABEER, SOFTDRINKS, PETFOOD, SEAFOOD, MEAT, TOYS, TITAN, RADIO, OPTIC_FIBER, VEGETABLE_OIL, CONSERVE, VETPHARMA, CHEMISTRY, AUTOFLUIDS, GROCERY, BOOKS, CONSTRUCTION, FIRE, HEATER, CABLERAW, POLYMER, SWEETS, CARPARTS, NATURAL_FUR, NICOTINDEV, GADGETS, FROZEN, FERTILIZERS, HOMEWARE, VETBIO, INDUSTRIAL, PYROTECHNICS Нет Тип категории для Честного знака. По умолчанию ставится OTHER
wildberriesType WildberriesType Нет Предмет Вайлдбериз. Можно устанавливать либо объект,либо только идентификатор
wildberriesCategoryId integer · int64 Нет Идентификатор категории Wildberries, совпадает с ID категории на самом Wildberries
wildberriesFbmCommission number · double Нет Комиссия по тарифу FBM
wildberriesFbwCommission number · double Нет Комиссия по тарифу FBW
wildberriesFbsCommission number · double Нет Комиссия по тарифу FBS
wildberriesDbsCommission number · double Нет Комиссия по тарифу DBS
wildberriesEdbsCommission number · double Нет Комиссия по тарифу EDBS
wildberriesCAndCCommission number · double Нет Комиссия по тарифу C&C
wildberriesBookingCommission number · double Нет Комиссия за бронирование
ozonDescriptionCategoryId integer · int64 Нет Идентификатор категории на Ozon. Строится из ID категории + ID типа на Ozon
yandexMarketCategoryId integer · int64 Нет Идентификатор категории в Яндекс.Маркет. Совпадает с идентификатором категории на самом Яндекс.Маркет
yandexMarketCategory YandexMarketCategory Нет Категория Яндекс.Маркета. Можно проставлять либо объект, либо только идентификатор
ozonDescriptionCategory OzonDescriptionCategory Нет Категория Озон
ozonCommission number · double Нет Комиссия озона.
tnved Tnved Нет ТНВЭД. Можно проставлять либо объект, либо идентификатор ТНВЭД
tnvedId integer · int64 Нет Идентификатор ТНВЭД
laundry string Нет Правила ухода за вещами. Разделяются запятыми
params string Нет JSON значений параметров для категории
namePattern string Нет Шаблон названий категории
aliexpressCategory AliexpressCategory Нет Категория Aliexpress
aliexpressCategoryId integer · int64 Нет Идентификатор категории на самом Aliexpress
avitoCategory AvitoCategory Нет Категория Avito
lamodaCategory LamodaCategory Нет Категория Lamoda
lamodaCategoryId integer · int64 Нет Идентификатор категории на Lamoda
avitoCategoryId integer · int64 Нет Идентификатор категории на Avito
packDepth integer · int32 Нет Глубина упаковки в мм. Проставляется всем товарам в категории
packWidth integer · int32 Нет Ширина упаковки в мм. Проставляется всем товарам в категории
packHeight integer · int32 Нет Высота упаковки в мм. Проставляется всем товарам в категории
packWeight integer · int32 Нет Вес упаковки в граммах. Проставляется всем товарам в категории
hasSize boolean Нет Признак разделения товаров в категории по размеру. Меняет вид редактора карточки
hasColor boolean Нет Признак разделения товаров в категории по цвету. Меняет вид редактора карточки
autoName boolean Нет Автоматически формировать названия товаров в категории
removeFbsStock boolean Нет Не передавать остатки товаров по FBS для товаров из этой категории
oneCId string Нет Идентификатор категории в 1С
externalId string Нет Идентификатор категории на сайте
moySkladId string Нет Идентификатор категории в сервисе МойСклад
useClientParams boolean Нет Показывать пользовательские параметры в категории
requiredExpirationDate boolean Нет Является ли срок годности обязательным параметром
serviceCategoryMappings object Нет Универсальные привязки категории к категориям внешних сервисов
productCount integer · int32 Нет Количество товаров в категории. Отдается только при withProductCount=true
categoryId integer · int32 Нет Поле categoryId.
clientId integer · int64 Нет Поле clientId.
images QualityDocumentImage[] Нет Изображения сертификата
Структура элемента массива QualityDocumentImage
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
url string Нет Поле url.
position integer · int32 Нет Поле position.
documentId integer · int64 Нет Поле documentId.
clientId integer · int64 Нет Поле clientId.
[
  "string"
]
Ошибки4

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

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

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

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

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

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

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

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

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

GET

Получить список сертификатов по фильтру

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

Позволяет получить сертификаты по фильтрам: бренд, категория и запрос, который может содержать часть названия или номера

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

ПолеТипОбязательноОписание
brandId integer · int32 Нет Поиск по id бренда
categoryId integer · int32 Нет Поиск по id категории
query string Нет Поисковый запрос, может содержать часть названия или номера сертификата
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy stringDOCUMENT_ID, NAME, TYPE, NUMBER, START_DATE, EXPIRE_DATE Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/qualityDocument/findQualityDocument?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта FindResponseQualityDocument
ПолеТипОбязательноОписание
rows QualityDocument[] Нет Строки с результатом поиска
Структура элемента массива QualityDocument
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
name string Нет Поле name.
type stringDECLARATION, CERTIFICATE, REFUSAL, REGISTRATION Нет Тип документа
number string Нет Номер сертификата
numberNormalized string Нет Нормализованный номер сертификата, используется для поиска дублей
clientId integer · int64 Нет Поле clientId.
versionId integer · int64 Нет Поле versionId.
createdUser string Нет Поле createdUser.
startDate string · date Нет Дата начала действия сертификата
expireDate string · date Нет Дата окончания срока действия сертификата
data QualityDocumentData[] Нет Связи сертификата с брендом и категорией
Структура элемента массива QualityDocumentData
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
documentId integer · int64 Нет Сертификат
productModelId integer · int64 Нет Связь сертификата с продуктом
brand Brand Нет Связь сертификата с брендом
brandId integer · int32 Нет Поле brandId.
category Category Нет Связь категории с сертификатом
categoryId integer · int32 Нет Поле categoryId.
clientId integer · int64 Нет Поле clientId.
images QualityDocumentImage[] Нет Изображения сертификата
Структура элемента массива QualityDocumentImage
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
url string Нет Поле url.
position integer · int32 Нет Поле position.
documentId integer · int64 Нет Поле documentId.
clientId integer · int64 Нет Поле clientId.
{
  "rows": "string"
}
Ошибки4

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

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

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

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

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

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

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

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

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

GET

Получить сертификат качества

/api/quality/document/{documentId}
Токен с правами чтения

Возвращает сертификат качества по идентификатору

Параметры пути

ПолеТипОбязательноОписание
documentId integer · int64 Да Поле documentId.
curl --request GET 'https://api.selsup.ru/api/quality/document/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200

Тело ответа пустое.

Ошибки3

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

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

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

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

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

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

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

Authorization

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

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

Попробовать

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

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

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