Товары: API (1.0)

Download OpenAPI specification:Download

Support Team: admin@selsup.ru License: Apache 2.0

Общая информация

Введение

SelSup API — программный интерфейс для работы с сервисом SelSup. Он даёт возможность обмениваться информацией между системой продавца и SelSup.

Методы API позволяют использовать весь функционал сервиса SelSup для работы с маркетплейсами Ozon, Wildberries, Aliexpress, Яндекс.Маркет, СберМегаМаркет, Леруа Мерлен, кассами Эвотор и Авито. Работать со службами доставки.

SelSup позволяет создавать карточки на всех маркетплейсах, заполнять параметры, вести учет остатков товаров, принимать заказы по FBS с маркетплейсов и интернет-магазина, обновлять остатки на позиции, по которым пришел заказ. Вести аналитику продаж и учет финансов.

С помощью API вы можете подключить любые источники заказов к SelSup и вести быстрый учет остатков с маркетплейсов и сайта.

По умолчанию GET запросы используются для получения данных, все запросы на изменение данных отправляются методоми POST, DELETE, PUT, PATCH

Авторизация

Как передавать токен авторизации в запросах

curl "https://api.selsup.ru/api/product/findProduct" \
  -H "Authorization: token"

Проверьте, что у вас указан токен API вместо <token>. Он указан на странице добавления нового токена

Перейдите на страницу настройки API: https://selsup.ru/application/integration/api

Введите название нового токена в поле и нажмите кнопку Добавить токен. Название должно быть уникальным в рамках вашего аккаунта. Рекомендуется для разных сервисов использовать свои токены, чтобы в любой момент можно было отозвать токен.

Токен необходимо передавать в заголовке Authorization: токен

Webhooks

SelSup может отправлять запросы на внешние сервисы и так же получать информацию от внешних сервисов, в случае каких-то событий. Такими событиями могут быть:

  • получение заказа с маркетплейса или от покупателя, в этом случае передается полная информация о заказе
  • изменение остатка на товары, передается информация о товаре и новый остаток
  • изменение цены на товар

Вы можете настроить Webhook, который будет отправлять HTTP/HTTPS запрос на адрес, который будет указан в кабинете. Возможна отправка POST или GET запроса в нужном формате с необходимыми заголовками.

Так вы сможете настроить интеграцию с любой собственной системой или сайтом.

Примеры решений

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

Для поиска товаров используйте метод /api/product/find Он позволяет найти товары по фильтрам и поисковому запросу, либо просто получить все товары по порядку.

Для выбора всех товаров лучше передавать sortBy=ID, чтобы новые товары не изменяли порядок сортировки и отдавались в конце. Параметр count=true, позволяет отдать в ответе значение поля total - общего количества данных по запросу. Значение true необходимо передавать только в первом запросе или вообще не передавать, просто последовательно выбирать данные по страницам, пока количество товаров в ответе не будет меньше размера limit.

Метод не отдает полную информацию о товаре, только основные поля, которые отображаются на списке товаров. Чтобы получить полную информацию о карточке, необходимо запросить ее по ID модели из ответа rows[0].view.model.id и использовать метод /api/model/{modelId} для получения полной информации о карточке. Если вы хотите изменить товар, получив данные из ответа метода, можно использовать метод PATCH, который объединит данные с уже сохраненными, чтобы не затереть какие-то параметры.

Информация о карточке

Получает полную информацию о карточке модели со всеми полями. У модели есть список цветов colors и у каждого цвета есть список размеров: sizes.

В поиске product/find поиск производится только по наличию конечного размера, поэтому если вы добавите цвета или модель, но не укажите размеры, в поиске они находиться не будут.

Чтобы получить дополнительные параметры, передавайте параметр params=true и в ответе values будет отдаваться список значений для цвета, модели или товара.

Полный список полей

Позволяет получить всю информацию о карточке товара, включая все заполненные параметры для последующего изменения информации о товаре через метод POST/PUT model. В списке services передаются маркетплейсы или сервисы, в которые необходимо отправить карточку после сохранения.

Создание модели

Метод позволяет создать новый товар

Позволяет создавать карточку товара. Карточка состоит из нескольких цветов, у каждого цвета может быть несколько размеров. Если в вашей категории товаров нет разделения по цветам и размерам - то просто создается карточка с одним цветом и одним размером. Цвет указывать не обязательно, как и значения поля размера. Обязательно указывать только артикул у модели.

Штрих-коды если не указаны, будут автоматически сгенерированы SelSup, либо нужно указывать явно штрих-коды в карточке товара.

Редактирование модели

Полный список полей

Позволяет изменить информацию у существующей модели, добавить цвета или размеры. Так же при редактировании модели можно выставлять свойство hasChanges=false, чтобы не изменять некоторые цвета или размеры.

Работа с параметрами карточки

У каждой структуры ProductModel, ProductView и Product, есть список значений параметров. У каждого параметра есть идентификатор, который зачастую уникален в рамках всех категорий маркетплейса. Один параметр может повторяться в разных категориях. Мы всегда пытаемся максимально сохранять идентификатор параметра при любых изменения на маркетплейсе.

Значения можно определять на разных уровнях, при этом Product имеет самый высший приоритет, потом идут по порядку значения со следующим приоритетом: ProductView, ProductModel, Category

В некоторых случаях, на маркетплейс не могут быть переданы значения, записанные у размера, например на Wildberries, тк карточка Wildberries соответствует ProductView. Уровень параметра, указанный в Param.level служит лишь для определения уровня по умолчанию, на котором должно быть определено значение параметра.

Если у параметра проставлено multiValueAllowed, то может быть несколько ParamValue с одинаковым paramId для передачи параметров, у которых может быть несколько значений

В зависимости от типа параметра Param.valueType, должны проставляться соответствующие поля в значении ParamValue.

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

https://params.selsup.ru/knowledge/getParams?ozonCategoryId=91025609&wildberriesTypeId=105&avitoCategoryId=103

Поиск значений параметра

Список значений может отдаваться для параметров с Param.valueType: "ENUM" или "TEXT" В этом случае у них обязательно будет проставлен Param.displayType: "SUGGEST", который говорит о том, что список значений нужно получать из ответа метода:

https://options.selsup.ru/option/fetchOption?aliexpressCategoryId=201236503&paramId=60019&useCategoryOption=true&query=123&limit=10

Полученные значения необходимо подставлять в качестве option у ParamValue в карточке товара. У значения всегда есть name, а вот идентификатор может вообще отсутствовать или может соответствовать идентификаторам значений на маркетплейсах

Поиск категорий

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

Поиск бренда

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

Создание заказа с сайта

Вы можете передавать новые заказы в SelSup по API, например с вашего интернет-магазина. В запросе необходимо передавать информацию о заказе и список товаров в заказе. В качестве уникального ключа, для того, чтобы не создавать дубликаты заказов используйте externalOrderId - номер заказа на сайте интернет-магазина.

Поле organizationId нужно обязательно передавать, если у вас в аккаунте несколько организаций.

Для передачи товаров необходимо предварительно связать товары сайта, с товарами в SelSup, чтобы потом передавать productId - идентификатор товара в SelSup. Сделать это можно, импортировав все товары методом findProduct

В позиции заказа в товаре quantity обязательно нужно передавать, как и цену товара price.

Создание отгрузки на маркетплейс

Вы можете передавать новые заказы в SelSup по API, например с вашего интернет-магазина. В запросе необходимо передавать информацию о заказе и список товаров в заказе. В качестве уникального ключа, для того, чтобы не создавать дубликаты используется externalOrderId

Возможные ошибки

В результате отдается JSON заказа, с проставленным значение id

{
  "message": "error_empty_warehouse"
}

В случае ошибки отдается код ответа 400, а в теле отдается message - с кодом ошибки и messageParams - дополнительные параметры сообщения об ошибке. Любые коды, отличные от 200 - ошибка запроса

Сообщение Причина
error_empty_warehouse Не указан параметр warehouseId для заказа на маркетплейс type=FBM
error_no_organization Не указано поле organizationId, если в аккаунте несколько организаций
error_no_marketplace Не указан service, для type=FBS или type=FBM заказов
error_no_quantity_for_order_product Не указано количество товара у позиции заказа products[index].quantity
error_no_price_for_order_product Не указана цена у позиции заказа products[index].price

Получение списка заказов

С помощью запроса вы можете получить список заказов:

Параметр count отвечает за подсчет общего количества заказов по указанному запросу. Лучше передавать значение false, если вам не нужно знать общее количество заказов, тк подсчет количества может занимать продолжительное время, особенно если по запросу выбирается большое количество заказов. Лучше запрашивать постоянно изменяя параметр page, чтобы выбрать все данные, пока количество равно лимиту, который вы передаете в запросе.

Получение изменений заказов

Вы можете выбирать заказы, которые изменились с последней даты получения заказов. При этом мог изменится состав заказа, параметры заказа или статус. В заказе отдается поле modifiedDate по которому вы можете выбирать заказы. В фильтрах есть поле modifiedDate в котором указывается дата и отдаются заказы которые изменились начиная с указанной даты

curl "https://api.selsup.ru/api/order/find?type=FBS&modifiedDate=2024-06-20T15:00:00Z" \
  -H "Authorization: <token>"

Остатки в SelSup

Остатки товаров в SelSup привязываются к SKU - единице хранения на складе. Каждому товару присваивается свой номер SKU и в дальнейшем можно указать одинаковый SKU для нескольких разных товаров в SelSup.

Вы можете использовать две схемы хранения остатков в SelSup: 1)Когда на каждую штуку товара клеится отдельный уникальный код, по которому можно отслеживать всю историю товара и вы всегда можете отделить каждую единицу товара друг от друга. Данный уникальный стикер позволяет вам клеить его в удобное для быстрого поиска место товара, что существенно ускоряет сборку товаров на складе и их идентификацию - особенно если вы работаете с кодами маркировки честного знака 2)Когда остаток хранится просто к привязки к ячейке по штрих-коду. В этом случае в остатке записывается количество - сколько лежит определенного товара в данной ячейке.

Изменение остатков

Полный список полей

curl -X POST "https://api.selsup.ru/api/wms/changeStock?skuId=123&stock=5&warehouseId=123" \
  -H "Authorization: <token>"

В результате отдается 200 код ответа или 400 в случае ошибки

Позволяет для SKU изменить остатки товаров на складе. Работает для всех схем хранения, как с уникальными кодами, так и без них

Добавление функций в магазин приложений

Вы можете разрабатывать расширения SelSup, которые добавляют различные возможности в SelSup. Существует несколько возможных вариантов встраивания функций в SelSup

React-расширения

Вы можете разрабатывать расширения для SelSup реализуя функциональные React компоненты, которые встраиваются в различные места кабинета SelSup и взаимодействуют с API SelSup или API внешних сервисов. Внешнему сервису необходимо разрешить принимать запросы с домена selsup.ru. При этом вы можете использовать все стандартные компоненты SelSup и добавлять свои собственные

Клонируйте репозиторий демо-компонента SelSup и начните разрабатывать React-расширение.

https://github.com/SelSup/component

Backend интеграции

Вы можете реализовать на Java один из вариантов интеграции: маркетплейс (интеграция по остаткам, заказам, товарам, ценам) или служба доставки, реализовав соответствующий интерфейс SelSup. Код компонента попадет в основную ветку SelSup и будет доступен для использования вашим платным или бесплатным расширением. Вы сможете обновлять функции вашего расширения и изменения будут регулярно попадать в новые релизы SelSup.

Товары

Методы для работы с товарами и их параметрами. В SelSup используется понятия карточки или модели - ProductModel, верхнего уровня иерархии товаров. На маркетплейсах тоже часто используются карточки товаров. У карточки может быть несколько цветов ProductView для быстрого добавления новых цветов, без заполнения параметров модели. У цвета в свою очередь может быть несколько уже конечных товаров - размеров. У любого уровня могут быть параметры. Часть данных заполняется на уровне модели - категория, бренд и тп, часть у цвета - например картинки.

Изменить товар

Изменяет информацию о товаре

path Parameters
productId
required
integer <int64>
query Parameters
merge
string

Объединять данные с существующим товаром

onlyProduct
string

Изменить информацию только о товаре и не обновлять модель и цвет

Request Body schema: application/json
required
id
integer <int64>

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

productType
string
Enum: "PRODUCT" "SET" "SERVICE" "DIGITAL"

Тип товара

name
required
string <= 240 characters

Наименование товара внутренее

printName
string <= 240 characters

Название товара для внешних сервисов. Если не задано, проставляется равным наименованию товара

realSize
string <= 255 characters

Российский размер товара для одежды или характеристики для других категорий

vendorSize
string <= 200 characters

Размер производителя или характеристики производителя. Не обязательно заполнять

size
string <= 200 characters

Размер для одежды или характеристики для внешних сервисов. Должен быть уникальным в рамках цвета

simalandId
integer <int64>

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

ozonArticle
string <= 255 characters

Уникальный артикул товара для озон. Offer ID в озон

externalArticle
string <= 255 characters

Уникальный артикул товара для стороннего сервиса

removeFbsStock
boolean

Не выгружать остатки товара на маркетплейсы

purchaseCurrency
string
Enum: "RUB" "USD" "EUR" "AUD" "AZN" "GBP" "AMD" "BYN" "BGN" "BRL" "HUF" "VND" "HKD" "GEL" "DKK" "AED" "EGP" "INR" "IDR" "KZT" "CAD" "QAR" "KGS" "CNY" "MDL" "NZD" "NOK" "PLN" "RON" "XDR" "SGD" "TJS" "THB" "TRY" "TMT" "UZS" "UAH" "CZK" "SEK" "CHF" "RSD" "ZAR" "KRW" "JPY"

Валюта закупочной цены товара

purchasePriceInCurrency
number <double>

Цена закупки в валюте

deliveryCostInCurrency
number <double>

Цена на доставку в валюте

versionId
integer <int64>

Поле нужно передавать при изменении,для предотвращения одновременной перезаписи

sourceIncomeItemId
integer <int64>

Идентификатор товара из заказа поставщика по данным которого был создан товар

sourceProductId
integer <int64>

Идентификатор товара, который копировали

sellerSku
string

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

organizationId
required
integer <int64>

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

suzId
string

GTIN товара

cisType
string
Enum: "UNIT" "BUNDLE" "GROUP" "SET" "ATK"

Тип в национальном каталоге

object (Sku)

Stock Keeping Unit - Единица хранения товара на складе. Может быть связана с несколькими карточками товаров Product.id. При первом создании товара SKU создается автоматически, далее можно привязать несколько товаров - имеющих разный бренд/организацию на маркетплейсах к одному SKU.

Array of objects (ProductBarcode)

Штрих-коды товара

params
string

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

Array of objects (ParamValue)

Значения параметров карточки. Отдаются при запросе модели, если передать params=true

hasChanges
boolean

Признак наличия изменений в товаре и ее нужно обновить при сохранении

ignoreDuplicate
boolean

Признак игнорирования дубликатов при создании

yandexMarketShopSku
string

SKU товара на Yandex.Market

sberArticle
string

Артикул товара на СберМегаМаркет

siteArticle
string

артикул товара на сайте

siteId
string

айди товара на сайте

leroyMerlinArticle
string

Артикул товара на Леруа Мерлен

ebayArticle
string

Артикул товара на Ebay

lamodaProductId
string

Id товара на Lamoda

leroyMerlinId
string

Номер карточки на Леруа Мерлен

aliexpressSku
string

SKU на Aliexpress

oneCId
string

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

removeFbsStockOzon
boolean

Не передавать остатки товара по FBS на озон

removeFbsStockWb
boolean

Не передавать остатки товара по FBS на Wildberries

removeFbsStockAli
boolean

Не передавать остатки товара по FBS на Aliepress

removeFbsStockYm
boolean

Не передавать остатки товара по FBS на Яндекс.Маркет

removeFbsStockSber
boolean

Не передавать остатки товара по FBS на СберМегаМаркет

incomeQuantity
integer <int32>

Количество товара в закупке без разделения по маркетплейсам

price
number <double>

Розничная цена товара

updatedPrice
number <double>

Новая общая цена товара со скидкой. Только для методов обновления цены

priceWithoutDiscount
number <double>

Розничная цена товара без учета скидки

updatedPriceWithoutDiscount
number <double>

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

updatedDeliveryCost
number <double>

Измененные прочие расходы товара Принимается только в методах обновления цены

updatedPurchasePrice
number <double>

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

purchasePrice
number <double>

Закупочная цена товара в руб.

isPurchasePriceUpdated
boolean

Признак, была ли изменена закупочная цена

isDeliveryCostUpdated
boolean

Признак, изменения прочих расходов на товар.

wholesalePrice
number <double>

Оптовая цена товара

deliveryCost
number <double>

Дополнительные расходы на доставку товара в руб. Добавляются к закупочной цене

wildberriesUpdatedPrice
number <double>

Новая цена товара на Вайлдбериз со скидкиой.Только для методов изменения цены

wildberriesUpdatedPriceWithoutDiscount
number <double>

Новая цена товара на Вайлдбериз без скидки.Только для методов изменения цены

aliexpressPriceWithoutDiscount
number <double>

Текущая цена на Aliexpress без скидки.

aliexpressUpdatedPrice
number <double>

Новая цена со скидкой на Aliexpress. Только для методов обновления цены

aliexpressUpdatedPriceWithoutDiscount
number <double>

Новая цена без скидки на Aliexpress. Только для методов обновления цены

minPrice
number <double>

Минимальная цена товара. Ниже этой цены нельзя выставлять цену на товар.Используется для Ozon при участии товара в акциях

ozonUpdatedPrice
number <double>

Новая цена товара на Озон со скидкой.Только для методов изменения цены

ozonUpdatedPriceWithoutDiscount
number <double>

Новая цена Озон без скидки.Только для методов изменения цены

leroyMerlinPrice
number <double>

Текущая цена товара на LeroyMerlin

leroyMerlinUpdatedPrice
number <double>

Новая цена товара на LeroyMerlin.Только для методов изменения цены

avitoPrice
number <double>

Текущая цена товара на Avito

avitoUpdatedPrice
number <double>

Новая цена товара на Avito.Только для методов изменения цены

sberMegaMarketUpdatedPrice
number <double>

Новая цена со скидкой на СберМегаМаркет. Только для методов изменения цены

yandexMarketUpdatedPrice
number <double>

Новая цена со скидкой на Яндекс.Маркет. Только для методов изменения цены

yandexMarketUpdatedPriceWithoutDiscount
number <double>

Новая цена без скидки на Яндекс.Маркет. Только для методов изменения цены

oneCArticle
string <= 255 characters

Уникальный артикул товара для 1c

salesExpensesOnMpPercent
number <double>

Расходы по продажам на маркетплейсе, %

taxeRate
number <double>

Установленый процент налога на товар, %

desiredMarginalityPercent
number <double>

Желаемый % маржинальности

desiredProfitRub
number <double>

Желаемая прибыль, руб.

additionalCost
number <double>

Доп. расходы на товар без записи в Финансовую аналитику, руб.

sberMegaMarketId
integer <int64>

Карточка СберМегаМаркет

packWidth
integer <int32>

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

packHeight
integer <int32>

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

packDepth
integer <int32>

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

packWeight
integer <int32>

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

numOfPiecesInBox
integer <int32>

Количество штук в коробе

lastWildberriesSaleDate
string <date-time>

Дата последней продажи на Wildberries

lastWildberriesOrderDate
string <date-time>

Дата последнего заказа на Wildberries

lastOzonSaleDate
string <date-time>

Дата последней продажи на OZON

lastOzonOrderDate
string <date-time>

Дата последнего заказа на OZON

ignoreFbsWarehouses
string

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

fbsWarehouses
string

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

minFbsStock
integer <int32>

Минимальный остаток - если меньше, то ставим 0

maxFbsStock
integer <int32>

Максимальный остаток - если больше, то ставим его

wildberriesSaleLogistic
number <double>

Логистика WB, руб.

wildberriesReturnLogistic
number <double>

Обратная логистика WB, руб.

wildberriesWarehouseRatio
number <double>

Коэффициент склада WB в %

wildberriesComission
number <double>

Коммиссия WB, %

ozonSaleLogistic
number <double>

Логистика Ozon, руб.

ozonReturnLogistic
number <double>

Обратная логистика Ozon, руб.

ozonCommission
number <double>

Коммиссия Ozon, %

ozonLastMile
number <double>

Последняя миля Ozon, %

ozonPurchasePercent
number <double>

Процент выкупа Ozon, %

wildberriesPurchasePercent
number <double>

Процент выкупа WB, %

minMarginality
number <double>

Настройки репрайсера Min % маржинальности

maxMarginality
number <double>

Настройки репрайсера Max % маржинальности

minProfit
number <double>

Настройки репрайсера Min прибыль, руб.

maxProfit
number <double>

Настройки репрайсера Max прибыль, руб.

minPriceWithDiscount
number <double>

Настройки репрайсера Min цена со скидкой, руб.

maxPriceWithDiscount
number <double>

Настройки репрайсера Max цена со скидкой, руб.

oldWildberriesPriceWithDiscount
number <double>

При установки через репрайсер скидку, заполняется, после удаление скидки, возвращает как основная цена и значение затирается

oldWildberriesSale
integer <int32>

Скидка товара на Вайлдбериз до установки новой по репрайсеру, при возврате нужно проставлять null

wildberriesPromoProfit
number <double>

Расчетный профит по акциям WB нужен для определения какая акция выгодная

wildberriesMarginality
number <double>

Расчетная маржинальность по WB

wildberriesPromoId
integer <int64>

Идентификатор акции на ВБ

oldWildberriesPromoSalePercent
number <double>

Расчетная маржинальность по WB

oldWildberriesPromoPriceWithDiscount
number <double>

Расчетная маржинальность по WB

endWildberriesPriceWithSppConfig
number <double>

Цена для пользователя конечная с СПП.

ozonFbsCommission
number <double>

Комиссия ОЗОН ФБС

ozonFboCommission
number <double>

Комиссия ОЗОН ФБО

wbTotalSalesCount
integer <int64>

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по ВБ

ozonTotalSalesCount
integer <int64>

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по OZON

sberTotalSalesCount
integer <int64>

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по SBER

yandexTotalSalesCount
integer <int64>

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по YANDEX

fboStockCount
integer <int64>

Остаток ФБО по выбранным складам/регионам

fbsStockCount
integer <int64>

Остаток ФБC для планирования поставок)

fboSales
integer <int64>

Кол-во продаж FBO по складам/регионам для планирования поставок

fbsSales
integer <int64>

Кол-во продаж FBS по складам/регионам для планирования поставок

fboOrders
integer <int64>

Кол-во заказов FBO по складам/регионам для планирования поставок

fbsOrders
integer <int64>

Кол-во заказов FBS по складам/регионам для планирования поставок

recommendPlan
number <double>

Кол-во товара для добавления к заказу

orderBefore
integer <int32>

До какого времени должен быть сделан заказ от 1 до 24

cellId
integer <int32>
percentForParticipationPromoOrAdvertising
integer <int32>

Закладываемый % для участия в акциях или рекламе

emptyBarcodes
boolean
anyArticle
string
site
string
anyLink
string

Responses

Request samples

Content type
application/json
{
  • "id": 0,
  • "productType": "PRODUCT",
  • "name": "string",
  • "printName": "string",
  • "realSize": "string",
  • "vendorSize": "string",
  • "size": "string",
  • "simalandId": 0,
  • "ozonArticle": "string",
  • "externalArticle": "string",
  • "removeFbsStock": true,
  • "purchaseCurrency": "RUB",
  • "purchasePriceInCurrency": 0.1,
  • "deliveryCostInCurrency": 0.1,
  • "versionId": 0,
  • "sourceIncomeItemId": 0,
  • "sourceProductId": 0,
  • "sellerSku": "string",
  • "organizationId": 0,
  • "suzId": "string",
  • "cisType": "UNIT",
  • "sku": {
    },
  • "barcodes": [
    ],
  • "params": "string",
  • "values": [
    ],
  • "hasChanges": true,
  • "ignoreDuplicate": true,
  • "yandexMarketShopSku": "string",
  • "sberArticle": "string",
  • "siteArticle": "string",
  • "siteId": "string",
  • "leroyMerlinArticle": "string",
  • "ebayArticle": "string",
  • "lamodaProductId": "string",
  • "leroyMerlinId": "string",
  • "aliexpressSku": "string",
  • "oneCId": "string",
  • "removeFbsStockOzon": true,
  • "removeFbsStockWb": true,
  • "removeFbsStockAli": true,
  • "removeFbsStockYm": true,
  • "removeFbsStockSber": true,
  • "incomeQuantity": 0,
  • "price": 0.1,
  • "updatedPrice": 0.1,
  • "priceWithoutDiscount": 0.1,
  • "updatedPriceWithoutDiscount": 0.1,
  • "updatedDeliveryCost": 0.1,
  • "updatedPurchasePrice": 0.1,
  • "purchasePrice": 0.1,
  • "isPurchasePriceUpdated": true,
  • "isDeliveryCostUpdated": true,
  • "wholesalePrice": 0.1,
  • "deliveryCost": 0.1,
  • "wildberriesUpdatedPrice": 0.1,
  • "wildberriesUpdatedPriceWithoutDiscount": 0.1,
  • "aliexpressPriceWithoutDiscount": 0.1,
  • "aliexpressUpdatedPrice": 0.1,
  • "aliexpressUpdatedPriceWithoutDiscount": 0.1,
  • "minPrice": 0.1,
  • "ozonUpdatedPrice": 0.1,
  • "ozonUpdatedPriceWithoutDiscount": 0.1,
  • "leroyMerlinPrice": 0.1,
  • "leroyMerlinUpdatedPrice": 0.1,
  • "avitoPrice": 0.1,
  • "avitoUpdatedPrice": 0.1,
  • "sberMegaMarketUpdatedPrice": 0.1,
  • "yandexMarketUpdatedPrice": 0.1,
  • "yandexMarketUpdatedPriceWithoutDiscount": 0.1,
  • "oneCArticle": "string",
  • "salesExpensesOnMpPercent": 0.1,
  • "taxeRate": 0.1,
  • "desiredMarginalityPercent": 0.1,
  • "desiredProfitRub": 0.1,
  • "additionalCost": 0.1,
  • "sberMegaMarketId": 0,
  • "packWidth": 0,
  • "packHeight": 0,
  • "packDepth": 0,
  • "packWeight": 0,
  • "numOfPiecesInBox": 0,
  • "lastWildberriesSaleDate": "2019-08-24T14:15:22Z",
  • "lastWildberriesOrderDate": "2019-08-24T14:15:22Z",
  • "lastOzonSaleDate": "2019-08-24T14:15:22Z",
  • "lastOzonOrderDate": "2019-08-24T14:15:22Z",
  • "ignoreFbsWarehouses": "string",
  • "fbsWarehouses": "string",
  • "minFbsStock": 0,
  • "maxFbsStock": 0,
  • "wildberriesSaleLogistic": 0.1,
  • "wildberriesReturnLogistic": 0.1,
  • "wildberriesWarehouseRatio": 0.1,
  • "wildberriesComission": 0.1,
  • "ozonSaleLogistic": 0.1,
  • "ozonReturnLogistic": 0.1,
  • "ozonCommission": 0.1,
  • "ozonLastMile": 0.1,
  • "ozonPurchasePercent": 0.1,
  • "wildberriesPurchasePercent": 0.1,
  • "minMarginality": 0.1,
  • "maxMarginality": 0.1,
  • "minProfit": 0.1,
  • "maxProfit": 0.1,
  • "minPriceWithDiscount": 0.1,
  • "maxPriceWithDiscount": 0.1,
  • "oldWildberriesPriceWithDiscount": 0.1,
  • "oldWildberriesSale": 0,
  • "wildberriesPromoProfit": 0.1,
  • "wildberriesMarginality": 0.1,
  • "wildberriesPromoId": 0,
  • "oldWildberriesPromoSalePercent": 0.1,
  • "oldWildberriesPromoPriceWithDiscount": 0.1,
  • "endWildberriesPriceWithSppConfig": 0.1,
  • "ozonFbsCommission": 0.1,
  • "ozonFboCommission": 0.1,
  • "wbTotalSalesCount": 0,
  • "ozonTotalSalesCount": 0,
  • "sberTotalSalesCount": 0,
  • "yandexTotalSalesCount": 0,
  • "fboStockCount": 0,
  • "fbsStockCount": 0,
  • "fboSales": 0,
  • "fbsSales": 0,
  • "fboOrders": 0,
  • "fbsOrders": 0,
  • "recommendPlan": 0.1,
  • "orderBefore": 0,
  • "cellId": 0,
  • "percentForParticipationPromoOrAdvertising": 0,
  • "emptyBarcodes": true,
  • "anyArticle": "string",
  • "site": "string",
  • "anyLink": "string"
}

Полное удаление товара

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

path Parameters
productId
required
integer <int64>

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

Responses

Обновить товар

Изменяет только переданную информацию о товаре

path Parameters
productId
required
integer <int64>
query Parameters
onlyProduct
string

Изменить информацию только о товаре и не обновлять модель и цвет

Request Body schema: application/json
required
id
integer <int64>

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

productType
string
Enum: "PRODUCT" "SET" "SERVICE" "DIGITAL"

Тип товара

name
required
string <= 240 characters

Наименование товара внутренее

printName
string <= 240 characters

Название товара для внешних сервисов. Если не задано, проставляется равным наименованию товара

realSize
string <= 255 characters

Российский размер товара для одежды или характеристики для других категорий

vendorSize
string <= 200 characters

Размер производителя или характеристики производителя. Не обязательно заполнять

size
string <= 200 characters

Размер для одежды или характеристики для внешних сервисов. Должен быть уникальным в рамках цвета

simalandId
integer <int64>

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

ozonArticle
string <= 255 characters

Уникальный артикул товара для озон. Offer ID в озон

externalArticle
string <= 255 characters

Уникальный артикул товара для стороннего сервиса

removeFbsStock
boolean

Не выгружать остатки товара на маркетплейсы

purchaseCurrency
string
Enum: "RUB" "USD" "EUR" "AUD" "AZN" "GBP" "AMD" "BYN" "BGN" "BRL" "HUF" "VND" "HKD" "GEL" "DKK" "AED" "EGP" "INR" "IDR" "KZT" "CAD" "QAR" "KGS" "CNY" "MDL" "NZD" "NOK" "PLN" "RON" "XDR" "SGD" "TJS" "THB" "TRY" "TMT" "UZS" "UAH" "CZK" "SEK" "CHF" "RSD" "ZAR" "KRW" "JPY"

Валюта закупочной цены товара

purchasePriceInCurrency
number <double>

Цена закупки в валюте

deliveryCostInCurrency
number <double>

Цена на доставку в валюте

versionId
integer <int64>

Поле нужно передавать при изменении,для предотвращения одновременной перезаписи

sourceIncomeItemId
integer <int64>

Идентификатор товара из заказа поставщика по данным которого был создан товар

sourceProductId
integer <int64>

Идентификатор товара, который копировали

sellerSku
string

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

organizationId
required
integer <int64>

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

suzId
string

GTIN товара

cisType
string
Enum: "UNIT" "BUNDLE" "GROUP" "SET" "ATK"

Тип в национальном каталоге

object (Sku)

Stock Keeping Unit - Единица хранения товара на складе. Может быть связана с несколькими карточками товаров Product.id. При первом создании товара SKU создается автоматически, далее можно привязать несколько товаров - имеющих разный бренд/организацию на маркетплейсах к одному SKU.

Array of objects (ProductBarcode)

Штрих-коды товара

params
string

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

Array of objects (ParamValue)

Значения параметров карточки. Отдаются при запросе модели, если передать params=true

hasChanges
boolean

Признак наличия изменений в товаре и ее нужно обновить при сохранении

ignoreDuplicate
boolean

Признак игнорирования дубликатов при создании

yandexMarketShopSku
string

SKU товара на Yandex.Market

sberArticle
string

Артикул товара на СберМегаМаркет

siteArticle
string

артикул товара на сайте

siteId
string

айди товара на сайте

leroyMerlinArticle
string

Артикул товара на Леруа Мерлен

ebayArticle
string

Артикул товара на Ebay

lamodaProductId
string

Id товара на Lamoda

leroyMerlinId
string

Номер карточки на Леруа Мерлен

aliexpressSku
string

SKU на Aliexpress

oneCId
string

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

removeFbsStockOzon
boolean

Не передавать остатки товара по FBS на озон

removeFbsStockWb
boolean

Не передавать остатки товара по FBS на Wildberries

removeFbsStockAli
boolean

Не передавать остатки товара по FBS на Aliepress

removeFbsStockYm
boolean

Не передавать остатки товара по FBS на Яндекс.Маркет

removeFbsStockSber
boolean

Не передавать остатки товара по FBS на СберМегаМаркет

incomeQuantity
integer <int32>

Количество товара в закупке без разделения по маркетплейсам

price
number <double>

Розничная цена товара

updatedPrice
number <double>

Новая общая цена товара со скидкой. Только для методов обновления цены

priceWithoutDiscount
number <double>

Розничная цена товара без учета скидки

updatedPriceWithoutDiscount
number <double>

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

updatedDeliveryCost
number <double>

Измененные прочие расходы товара Принимается только в методах обновления цены

updatedPurchasePrice
number <double>

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

purchasePrice
number <double>

Закупочная цена товара в руб.

isPurchasePriceUpdated
boolean

Признак, была ли изменена закупочная цена

isDeliveryCostUpdated
boolean

Признак, изменения прочих расходов на товар.

wholesalePrice
number <double>

Оптовая цена товара

deliveryCost
number <double>

Дополнительные расходы на доставку товара в руб. Добавляются к закупочной цене

wildberriesUpdatedPrice
number <double>

Новая цена товара на Вайлдбериз со скидкиой.Только для методов изменения цены

wildberriesUpdatedPriceWithoutDiscount
number <double>

Новая цена товара на Вайлдбериз без скидки.Только для методов изменения цены

aliexpressPriceWithoutDiscount
number <double>

Текущая цена на Aliexpress без скидки.

aliexpressUpdatedPrice
number <double>

Новая цена со скидкой на Aliexpress. Только для методов обновления цены

aliexpressUpdatedPriceWithoutDiscount
number <double>

Новая цена без скидки на Aliexpress. Только для методов обновления цены

minPrice
number <double>

Минимальная цена товара. Ниже этой цены нельзя выставлять цену на товар.Используется для Ozon при участии товара в акциях

ozonUpdatedPrice
number <double>

Новая цена товара на Озон со скидкой.Только для методов изменения цены

ozonUpdatedPriceWithoutDiscount
number <double>

Новая цена Озон без скидки.Только для методов изменения цены

leroyMerlinPrice
number <double>

Текущая цена товара на LeroyMerlin

leroyMerlinUpdatedPrice
number <double>

Новая цена товара на LeroyMerlin.Только для методов изменения цены

avitoPrice
number <double>

Текущая цена товара на Avito

avitoUpdatedPrice
number <double>

Новая цена товара на Avito.Только для методов изменения цены

sberMegaMarketUpdatedPrice
number <double>

Новая цена со скидкой на СберМегаМаркет. Только для методов изменения цены

yandexMarketUpdatedPrice
number <double>

Новая цена со скидкой на Яндекс.Маркет. Только для методов изменения цены

yandexMarketUpdatedPriceWithoutDiscount
number <double>

Новая цена без скидки на Яндекс.Маркет. Только для методов изменения цены

oneCArticle
string <= 255 characters

Уникальный артикул товара для 1c

salesExpensesOnMpPercent
number <double>

Расходы по продажам на маркетплейсе, %

taxeRate
number <double>

Установленый процент налога на товар, %

desiredMarginalityPercent
number <double>

Желаемый % маржинальности

desiredProfitRub
number <double>

Желаемая прибыль, руб.

additionalCost
number <double>

Доп. расходы на товар без записи в Финансовую аналитику, руб.

sberMegaMarketId
integer <int64>

Карточка СберМегаМаркет

packWidth
integer <int32>

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

packHeight
integer <int32>

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

packDepth
integer <int32>

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

packWeight
integer <int32>

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

numOfPiecesInBox
integer <int32>

Количество штук в коробе

lastWildberriesSaleDate
string <date-time>

Дата последней продажи на Wildberries

lastWildberriesOrderDate
string <date-time>

Дата последнего заказа на Wildberries

lastOzonSaleDate
string <date-time>

Дата последней продажи на OZON

lastOzonOrderDate
string <date-time>

Дата последнего заказа на OZON

ignoreFbsWarehouses
string

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

fbsWarehouses
string

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

minFbsStock
integer <int32>

Минимальный остаток - если меньше, то ставим 0

maxFbsStock
integer <int32>

Максимальный остаток - если больше, то ставим его

wildberriesSaleLogistic
number <double>

Логистика WB, руб.

wildberriesReturnLogistic
number <double>

Обратная логистика WB, руб.

wildberriesWarehouseRatio
number <double>

Коэффициент склада WB в %

wildberriesComission
number <double>

Коммиссия WB, %

ozonSaleLogistic
number <double>

Логистика Ozon, руб.

ozonReturnLogistic
number <double>

Обратная логистика Ozon, руб.

ozonCommission
number <double>

Коммиссия Ozon, %

ozonLastMile
number <double>

Последняя миля Ozon, %

ozonPurchasePercent
number <double>

Процент выкупа Ozon, %

wildberriesPurchasePercent
number <double>

Процент выкупа WB, %

minMarginality
number <double>

Настройки репрайсера Min % маржинальности

maxMarginality
number <double>

Настройки репрайсера Max % маржинальности

minProfit
number <double>

Настройки репрайсера Min прибыль, руб.

maxProfit
number <double>

Настройки репрайсера Max прибыль, руб.

minPriceWithDiscount
number <double>

Настройки репрайсера Min цена со скидкой, руб.

maxPriceWithDiscount
number <double>

Настройки репрайсера Max цена со скидкой, руб.

oldWildberriesPriceWithDiscount
number <double>

При установки через репрайсер скидку, заполняется, после удаление скидки, возвращает как основная цена и значение затирается

oldWildberriesSale
integer <int32>

Скидка товара на Вайлдбериз до установки новой по репрайсеру, при возврате нужно проставлять null

wildberriesPromoProfit
number <double>

Расчетный профит по акциям WB нужен для определения какая акция выгодная

wildberriesMarginality
number <double>

Расчетная маржинальность по WB

wildberriesPromoId
integer <int64>

Идентификатор акции на ВБ

oldWildberriesPromoSalePercent
number <double>

Расчетная маржинальность по WB

oldWildberriesPromoPriceWithDiscount
number <double>

Расчетная маржинальность по WB

endWildberriesPriceWithSppConfig
number <double>

Цена для пользователя конечная с СПП.

ozonFbsCommission
number <double>

Комиссия ОЗОН ФБС

ozonFboCommission
number <double>

Комиссия ОЗОН ФБО

wbTotalSalesCount
integer <int64>

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по ВБ

ozonTotalSalesCount
integer <int64>

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по OZON

sberTotalSalesCount
integer <int64>

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по SBER

yandexTotalSalesCount
integer <int64>

Общее кол-во продажи - возвраты, начиная с подсчета процента выкупа по YANDEX

fboStockCount
integer <int64>

Остаток ФБО по выбранным складам/регионам

fbsStockCount
integer <int64>

Остаток ФБC для планирования поставок)

fboSales
integer <int64>

Кол-во продаж FBO по складам/регионам для планирования поставок

fbsSales
integer <int64>

Кол-во продаж FBS по складам/регионам для планирования поставок

fboOrders
integer <int64>

Кол-во заказов FBO по складам/регионам для планирования поставок

fbsOrders
integer <int64>

Кол-во заказов FBS по складам/регионам для планирования поставок

recommendPlan
number <double>

Кол-во товара для добавления к заказу

orderBefore
integer <int32>

До какого времени должен быть сделан заказ от 1 до 24

cellId
integer <int32>
percentForParticipationPromoOrAdvertising
integer <int32>

Закладываемый % для участия в акциях или рекламе

emptyBarcodes
boolean
anyArticle
string
site
string
anyLink
string

Responses

Request samples

Content type
application/json
{
  • "id": 0,
  • "productType": "PRODUCT",
  • "name": "string",
  • "printName": "string",
  • "realSize": "string",
  • "vendorSize": "string",
  • "size": "string",
  • "simalandId": 0,
  • "ozonArticle": "string",
  • "externalArticle": "string",
  • "removeFbsStock": true,
  • "purchaseCurrency": "RUB",
  • "purchasePriceInCurrency": 0.1,
  • "deliveryCostInCurrency": 0.1,
  • "versionId": 0,
  • "sourceIncomeItemId": 0,
  • "sourceProductId": 0,
  • "sellerSku": "string",
  • "organizationId": 0,
  • "suzId": "string",
  • "cisType": "UNIT",
  • "sku": {
    },
  • "barcodes": [
    ],
  • "params": "string",
  • "values": [
    ],
  • "hasChanges": true,
  • "ignoreDuplicate": true,
  • "yandexMarketShopSku": "string",
  • "sberArticle": "string",
  • "siteArticle": "string",
  • "siteId": "string",
  • "leroyMerlinArticle": "string",
  • "ebayArticle": "string",
  • "lamodaProductId": "string",
  • "leroyMerlinId": "string",
  • "aliexpressSku": "string",
  • "oneCId": "string",
  • "removeFbsStockOzon": true,
  • "removeFbsStockWb": true,
  • "removeFbsStockAli": true,
  • "removeFbsStockYm": true,
  • "removeFbsStockSber": true,
  • "incomeQuantity": 0,
  • "price": 0.1,
  • "updatedPrice": 0.1,
  • "priceWithoutDiscount": 0.1,
  • "updatedPriceWithoutDiscount": 0.1,
  • "updatedDeliveryCost": 0.1,
  • "updatedPurchasePrice": 0.1,
  • "purchasePrice": 0.1,
  • "isPurchasePriceUpdated": true,
  • "isDeliveryCostUpdated": true,
  • "wholesalePrice": 0.1,
  • "deliveryCost": 0.1,
  • "wildberriesUpdatedPrice": 0.1,
  • "wildberriesUpdatedPriceWithoutDiscount": 0.1,
  • "aliexpressPriceWithoutDiscount": 0.1,
  • "aliexpressUpdatedPrice": 0.1,
  • "aliexpressUpdatedPriceWithoutDiscount": 0.1,
  • "minPrice": 0.1,
  • "ozonUpdatedPrice": 0.1,
  • "ozonUpdatedPriceWithoutDiscount": 0.1,
  • "leroyMerlinPrice": 0.1,
  • "leroyMerlinUpdatedPrice": 0.1,
  • "avitoPrice": 0.1,
  • "avitoUpdatedPrice": 0.1,
  • "sberMegaMarketUpdatedPrice": 0.1,
  • "yandexMarketUpdatedPrice": 0.1,
  • "yandexMarketUpdatedPriceWithoutDiscount": 0.1,
  • "oneCArticle": "string",
  • "salesExpensesOnMpPercent": 0.1,
  • "taxeRate": 0.1,
  • "desiredMarginalityPercent": 0.1,
  • "desiredProfitRub": 0.1,
  • "additionalCost": 0.1,
  • "sberMegaMarketId": 0,
  • "packWidth": 0,
  • "packHeight": 0,
  • "packDepth": 0,
  • "packWeight": 0,
  • "numOfPiecesInBox": 0,
  • "lastWildberriesSaleDate": "2019-08-24T14:15:22Z",
  • "lastWildberriesOrderDate": "2019-08-24T14:15:22Z",
  • "lastOzonSaleDate": "2019-08-24T14:15:22Z",
  • "lastOzonOrderDate": "2019-08-24T14:15:22Z",
  • "ignoreFbsWarehouses": "string",
  • "fbsWarehouses": "string",
  • "minFbsStock": 0,
  • "maxFbsStock": 0,
  • "wildberriesSaleLogistic": 0.1,
  • "wildberriesReturnLogistic": 0.1,
  • "wildberriesWarehouseRatio": 0.1,
  • "wildberriesComission": 0.1,
  • "ozonSaleLogistic": 0.1,
  • "ozonReturnLogistic": 0.1,
  • "ozonCommission": 0.1,
  • "ozonLastMile": 0.1,
  • "ozonPurchasePercent": 0.1,
  • "wildberriesPurchasePercent": 0.1,
  • "minMarginality": 0.1,
  • "maxMarginality": 0.1,
  • "minProfit": 0.1,
  • "maxProfit": 0.1,
  • "minPriceWithDiscount": 0.1,
  • "maxPriceWithDiscount": 0.1,
  • "oldWildberriesPriceWithDiscount": 0.1,
  • "oldWildberriesSale": 0,
  • "wildberriesPromoProfit": 0.1,
  • "wildberriesMarginality": 0.1,
  • "wildberriesPromoId": 0,
  • "oldWildberriesPromoSalePercent": 0.1,
  • "oldWildberriesPromoPriceWithDiscount": 0.1,
  • "endWildberriesPriceWithSppConfig": 0.1,
  • "ozonFbsCommission": 0.1,
  • "ozonFboCommission": 0.1,
  • "wbTotalSalesCount": 0,
  • "ozonTotalSalesCount": 0,
  • "sberTotalSalesCount": 0,
  • "yandexTotalSalesCount": 0,
  • "fboStockCount": 0,
  • "fbsStockCount": 0,
  • "fboSales": 0,
  • "fbsSales": 0,
  • "fboOrders": 0,
  • "fbsOrders": 0,
  • "recommendPlan": 0.1,
  • "orderBefore": 0,
  • "cellId": 0,
  • "percentForParticipationPromoOrAdvertising": 0,
  • "emptyBarcodes": true,
  • "anyArticle": "string",
  • "site": "string",
  • "anyLink": "string"
}

Объединить товары

Позволяет объединить дублирующиеся товары, которые импортированы с разных маркетплейсов

path Parameters
productId
required
integer <int64>

Идентификатор товара на который перенести данные

removedProductId
required
integer <int64>

Идентификатор дубликата товара, которыйбудет удален

Responses

Перенести цвет на другую модель

Перемещает цвет на другую модель

path Parameters
viewId
required
integer <int64>

Идентификатор цвета, который перенести

query Parameters
article
required
string

Артикул модели, куда перенести цвет

Responses

Загрузка изображения товара (multipart)

Загружает изображение и прикрепляет его к товару. Файл передается в поле file в формате multipart/form-data. Поддерживаются изображения форматов JPEG (скроме CMYK), PNG, PNG24,TIFF, WEBP.

path Parameters
viewId
required
integer <int64>
Request Body schema: multipart/form-data
file
required
string <binary>

Responses

Загрузка изображения товара

Загружает изображение и прикрепляет его к товару. В теле сразу передается файл. Поддерживаются изображения форматов JPEG (скроме CMYK), PNG, PNG24, TIFF, WEBP.

path Parameters
viewId
required
integer <int64>

Responses

Изменить статус актуальности цвета

Изменяет статус актуальности цвету у товара

query Parameters
viewId
required
integer <int64>
status
required
boolean

Responses

Cохраняет комплекты

Изменяет состав комплектов товаров. Передается productId -> список комплектующих

Request Body schema: application/json
required
additional property
Array of objects (ProductSet)

Responses

Request samples

Content type
application/json
{
  • "property1": [
    ],
  • "property2": [
    ]
}

Генерирует описание

Генерирует описание товара с помощью нейросети

Request Body schema: application/json
required
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Пометить товар избранным

Помечает товар избранным и с помощью фильтра на списке товаров их легко можно выбирать

path Parameters
modelId
required
integer <int64>

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

query Parameters
favourite
required
boolean

Избранный товар или нет

Responses

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

Возвращает список товаров по фильтру

query Parameters
query
string

Поисковый запрос. Может содержать штрих-код, часть названия товара, внешние идентификаторы товаров Wildberries или Ozon

article
string

Поиск по названию артикула товара

color
string

Поиск по названию цвета товара

viewId
string

Поиск по идентификатору цвета

skuViewId
string

Поиск по SKU идентификатору цвета

modelId
string

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

unprofitable
string

Товары с отрицательной маржинальностью

needToBuy
string

Товары, которые нужно показать в списке для заказа

planDays
string

Количество дней на которые планировать закупки. По умолчанию 30

organizations
string

Ограничивает список организаций

needUpdatePrice
string

Фильтр по необходимости обновить цену на Wildberries

testCard
string

Тестовая карточки для создания

hasImages
string

Наличие или отсутствие картинок у товара

isDuplicate
string

Карточка является дубликатом

hasWildberriesId
string

Наличие карточки товара в Wildberries

hasSupplyingQuantity
string

Наличие поставляемого количества по модели FBM

noWbImages
string

Наличие фото на Wildberries

noOzonImages
string

Наличие фото на Ozon

noYMImages
string

Наличие фото на Яндекс.Маркет

deleted
string

Показать помеченные удаленными товары

modelDeleted
string

Показать помеченные удаленными модели

viewDeleted
string

Показать помеченные удаленными цвета

inStock
string

Наличие остатков товаров на маркетплейсе или складе

noStock
string

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

inFbsStock
string

Наличие остатков на складах в SelSup

noFbsStock
string

Отсутствие остатков на складах в SelSup

inFboStock
string

Наличие остатков на складах FBO

noFboStock
string

Отсутствие остатков на складах FBO

hasStockInWarehouse
string

Склад на котором есть остатки в SelSup

noStockInWarehouse
string

Склад на котором нет остатков в SelSup

grouped
string

Группировать товары по цветам

uniqView
string

Отдавать только товары с уникальными цвета

uniqViewSku
string

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

uniqModel
string

Отдавать только товары с уникальными моделями

uniqSku
string

Отдавать только товары с уникальными SKU

contractors
string

Фильтр по поставщикам товара

categories
string

Фильтр категориям товара

brands
string

Фильтр по брендам товара

stockRefreshDate
string <date-time>
wildberriesRating
string

Фильтр товаров по рейтингу отзывов Вайлдбериз

wildberriesCardDoesNotOpen
string

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

productId
integer <int64>
productIds
Array of integers <int64> unique [ items <int64 > ]
sourceOrganizationIds
string

Фильтр товаров, которые были импортрованы в другие организации

needImportWildberriesCard
string

Фильтр товаров для которых нужно обновить карточку в Вайлдбериз

needImportOzonCard
string

Фильтр товаров для которых нужно обновить карточку в Ozon

needImportAliexpressCard
string

Фильтр товаров для которых нужно обновить карточку в Aliexpress

needUpdateFromSimaland
string

Фильтр товаров для которых нужно обновить стоки и цены в Simaland

favourite
string

Фильтр по избранным товарам, которые клиент пометил избранными

status
string

Фильтр по статусу для WmsItem

actual
string

Фильтр по показателю актуальности

skuId
string

Фильтр по skuId

skuIds
string

Фильтр по skuIds

lastInventoryId
string

Фильтр по инвентаризации для WmsItem

cellId
string

Фильтр по ячейке для WmsItem

itemId
string

Фильтр уникальному коду для WmsItem

warehouseId
string

Фильтр складу для WmsItem

avitoCategoryId
string

Категория Авито

hasAvitoCategory
boolean
services
string

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

createdIn
string

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

duplicate
string

Является ли карточка дубликатом

orderService
string

Позволяет отфильтровать по маркетплейсу заказа, в закупках из заказов

productType
string

Фильтр по типу товара

withCategoryAndBrand
string

Признак, что грузим категорию и бренд

allServices
string

Признак, что грузить данные по всем сервисам

inWarehouseRegions
string

Подгружать ФБО остатки/продажи со складов входящих в список регионов

inWarehouses
string

Подгружать ФБО остатки/продажи со складов входящих в список

incomeOrderId
string

Фильтр товаров по ид заказа

incomeId
string

Фильтр товаров по ид заказа поставщика

itemIncomeOrderId
string

Фильтр остатков из приемки

dateFrom
string

Дата начала

dateTo
string

Дата окончания

timeZone
string

Часовой пояс клиента по UTC

ids
string

Идентификаторы конкретных товаров

skipDayWithoutStocks
string

Пропускать дни без остатков

countByOrdersOrSales
string

Делать расчет по продажам или заказам

requierPlan
string

Фильтр по Рекомендации к поставке

forPrices
string

Отдавать в ответе данные для таблицы цен

deliveryDate
string

Фильтр по дате доставки заказа

onlyEmptyParchasePrice
string

Выгружать товары только с пустыми закупочными ценами

onlyEmptyDeliveryCostPrice
string

Выгружать товары только с пустыми дополнительными расходами

forFboSupplyPlan
string

Показывает для чего идет расчет планирования для фбо или поставок

ignoreParams
string

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

modelArticle
string
ozonArticle
string
yandexMarketShopSku
string
sberArticle
string
wbArticle
string
limit
string

Ограничение на количество записей. Максимальное значение - 500

page
string

Номер страницы начиная с 1

count
string

Возвратить в ответе общее количество записей

sortBy
string

Поле сортировки записей. Работает только при получении списка.

ascending
string

Порядок сортировки - по возрастанию?. Работает только при получении списка.

Responses

Удалить цвета без размеров, моделей и цветов

Удаляет цвета без размеров и пустые модели

Responses

Поиск товара по штрих-коду

Ищет товар по штрих-коду товара

path Parameters
barcode
required
string

Штрих-код товара

query Parameters
organizationId
integer <int64>

Организация, в которой ищем товар

Responses

Поиск ошибок импорта товаров

Возвращает ошибки импорта товаров по фильтру. Ошибки пишутся когда запускается импорт товаров и не удается создать товар в SelSup

query Parameters
query
string

Запрос для поиска не импортировавшихся товаров

organizationId
string

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

service
string

Маркетплейс

limit
string

Ограничение на количество записей. Максимальное значение - 500

page
string

Номер страницы начиная с 1

count
string

Возвратить в ответе общее количество записей

sortBy
string

Поле сортировки записей. Работает только при получении списка.

ascending
string

Порядок сортировки - по возрастанию?. Работает только при получении списка.

Responses

Полностью удалить цвет

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

path Parameters
viewId
required
integer <int64>

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

Responses

Удалить или восстановить товары

Помечает товавы удаленными или восстанавливает помеченые ранее удаленными товарыПараметры ответа: true - полное удаление всех товаров, false - остальные случаи

query Parameters
deleted
required
boolean

Пометить товары удаленным или восстановить товары

Request Body schema: application/json
required
Array
integer <int64>

Responses

Request samples

Content type
application/json
[
  • 0
]

Массовое удаление фотографий

Позволяет удалить фотографии, загруженные в SelSup

path Parameters
organizationId
required
integer <int64>

Организация

query Parameters
withUrls
boolean

Удалить только фото, у которых есть загруженные фотографии

Responses

Массовое замена фотографий

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

path Parameters
organizationId
required
integer <int64>

Организация

service
required
string
Enum: "NONE" "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"

Сервис откуда будут браться ссылки фотографий

Responses

Удалить изображение товара

Удаляет изображение товара

path Parameters
imageId
required
integer <int64>

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

query Parameters
productViewId
required
integer <int64>

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

Responses

Удалить или восстановить товар

Помечает товар удаленным или восстанавливает помеченый ранее удаленным товарsigned_as_removed - помечен удалённым, restored - восстановлен

path Parameters
productId
required
integer <int64>

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

query Parameters
deleted
required
boolean

Пометить товар удаленным или восстановить товар

Responses

Удалить или восстановить цвет

Помечает цвет и все его размеры удаленными или восстанавливает

path Parameters
viewId
required
integer <int64>

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

query Parameters
deleted
boolean
Default: true

Удалить или восстановить цвет и все его размеры

Responses

Полное удаление товаров

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

Request Body schema: application/json
required
Array
integer <int64>

Responses

Request samples

Content type
application/json
[
  • 0
]

Модели

Категории

Бренды

Производители

Фотосессии

Знания

Ключевые слова

Параметры

Цены

Акции

Реклама

Заказы

Заказы со своего склада (FBS)

Поставки

Возвраты

Сервис Мой склад

Доставка

Покупатели

Закупки

Поставщики

Остатки

Склады

Аналитика

Гипотезы

Маркировка Честный знак

Документы

Экспорт

Импорт

Задачи

Настройки

Клиент

Билинг