SelSup Developers

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

ФинДир

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

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

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

/api/findir

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

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

01

Начать работу с разделом «ФинДир»

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

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

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

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

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

ComprehensiveFinanceAnalytics12 полей
salesExpensesOnMarketplacesFindResponseRowStructureForFinanceTable

Поле salesExpensesOnMarketplaces.

costStructureGetFinanceStructureResult

Поле costStructure.

profitStructureGetFinanceStructureResult

Поле profitStructure.

penaltyStructureRowStructureForFinanceTable[]

Поле penaltyStructure.

serviceStructureRowStructureForFinanceTable[]

Поле serviceStructure.

financesReportByPeriodFindResponseFinanceReport

Финансовый отчёт по периодам, одна строка = один период (dateKey). Если выбрано несколько организаций, значения агрегируются по dateKey В конце может присутствовать итоговая строка по всему интервалу без dateKey

previousFinancesReportByPeriodFindResponseFinanceReport

Поле previousFinancesReportByPeriod.

purchasePercentnumber · double

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

financesReportByPeriodByOrgFinanceReport[]

Разбивка финансового отчёта по организациям и периодам, одна строка = одна организация в одном периоде (dateKey + organizationId). Заполняется только когда выбрано несколько организаций. Итоговые строки здесь не добавляются

previousFinancesReportByPeriodByOrgFinanceReport[]

Поле previousFinancesReportByPeriodByOrg.

financesReportTotalByOrgFinanceReport[]

Итоги финансового отчёта по организациям за весь интервал. Одна строка = итог по одной организации за весь выбранный интервал. Заполняется только когда выбрано несколько организаций

commonFixedOutlaynumber · double

Поле commonFixedOutlay.

FinanceReport122 полей
shortNamestring

Сокращенное название организации.

categoryNamestring

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

brandNamestring

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

namestring

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

modelNamestring

Название модели

viewWildberriesIdinteger · int64

Карточка Wildberries

articlestring

Артикул

serviceArticlestring

Артикул на маркетплейсе

colorstring

Цвет товара.

sizestring

Размер товара.

barcodestring

Шк товара.

purchasePricenumber · double

Закупочная цена.

createdDatestring · date-time

Дата создания карточки.

isDuplicateboolean

Признак дубликата карточки.

dateKeystring

Ключ по дате.

salesCountinteger · int64

Продажи в шт.

salesCountConventionalnumber · double

Продажи в у.е.

returnsCountinteger · int64

Возвраты в шт.

returnsCountConventionalnumber · double

Возвраты в у.е.

totalSalesCountinteger · int64

Разница между продажами и возвратами в шт. salesCount - returnsCount

totalSalesCountConventionalnumber · double

Разница между продажами и возвратами в у.е.

salesAmountnumber · double

Продажи в руб.

returnsAmountnumber · double

Возвраты в руб.

averageReturnsAmountnumber · double

Возвраты в руб. за 1 ед

totalSalesAmountnumber · double

Разница между продажами и возвратами в руб. salesAmount - returnsAmount

orderAmountnumber · double

Заказы в руб.

orderAmountWithoutCancelnumber · double

Заказы в руб. без отмен

logisticsnumber · double

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

averageLogisticsnumber · double

Средняя логистика в руб.

logisticsSharenumber · double

Доля логистики в структуре выручки, %

commissionsnumber · double

Комиссия в руб.

acquiringnumber · double

Эквайринг в руб.

averageCommissionsnumber · double

Средняя комиссия в руб.

penaltynumber · double

Штрафы в руб.

additionalnumber · double

Доплаты в руб.

refundsAndCancellationsnumber · double

Возвраты и отмены в руб.

compensationAmountnumber · double

Компенсации в руб.

additionalAndDeductionnumber · double

Доплаты и удержания в руб. в файле финансах ячейка Доплаты

servicesnumber · double

Услуги в руб.

drrnumber · double

ДРР по выкупам, %: расходы на рекламу / чистая выручка * 100

drrByOrdersnumber · double

ДРР Wildberries по рекламным заказам, %: расходы на рекламу / сумма рекламных заказов * 100

advertisingOrdersAmountnumber · double

Сумма рекламных заказов Wildberries, руб.

totalToBePaidnumber · double

Итого к оплате с учётом выручки, расходов, доплат и удержаний

averageToBePaidnumber · double

Итого к оплате за 1 товар.

productCountinteger · int64

Товарный остаток FBS + FBO на текущий момент.

salesAmountInPurchasePricenumber · double

Проданный товар в закупочных ценах, руб.

productAmountnumber · double

Сумма по товарному остатку purchasePrice * productCount

averageSellingPricenumber · double

Средняя фактическая цена продажи

markUpnumber · double

Фактическая наценка totalToBePaid / (purchasePrice * totalSalesCount)

marginnumber · double

Маржинальность

grossProfitnumber · double

Валовая прибыль totalToBePaid - totalSalesCount * purchasePrice - selPayAmount

averageGrossProfitnumber · double

Валовая прибыль за 1 ед.

ratioInIncomenumber · double

Доля в выручке

rationInGrossProfitnumber · double

Доля в валовой прибыли в % grossProfit / SUM(grossProfit)

ratioInProductCountnumber · double

Доля в товарном остатке в % productAmount / SUM(productAmount)

efficiencyForIncomenumber · double

Эффективность по выручке ratioInIncome / ratioInProductCount

grossProfitEfficiencynumber · double

Эффективность по валовой прибыли rationInGrossProfit / ratioInProductCount

averageExpensesnumber · double

Средний расходов по продаже на МП на 1 ед товара, руб. все расходы в руб / продажи - возвраты в шт

otherAmountnumber · double

Прочие начисления, руб.

percentRedemptionnumber · double

Процент выкупа. Продажи/(Продажи+Возвраты)*100 только для ВБ

orderCountinteger · int64

Кол-во заказов в шт.

orderCountWithoutCancelinteger · int64

Кол-во заказов в шт. без отмен

nonPurchasePriceCountinteger · int64

Кол-во profitRepot где не указана закупочная цена, шт.

selfPayCountinteger · int64

Кол-во самовыкупов, шт.

selfPayAmountnumber · double

Сумма самовыкупов, руб.

costStoragenumber · double

Сумма за хранения товара на МП, получаем только по ВБ через импорт файла.

campaignCostnumber · double

Стоимость рекламы ВБ

externalCampaignCostnumber · double

Стоимость внешней рекламы

wbSppnumber · double

СПП: скидка постоянного покупателя на ВБ + баллы Ozon

salesAmountBeforeSppnumber · double

Выручка до применения СПП с учетом возвратов, руб. Только ВБ. Рассчитывается как выручка + СПП

wbTotalSalesByPriceWithDiscnumber · double

Сумма продажи ВБ, по цене со скидкой продажи - возвраты

otherDeductionsnumber · double

Прочие удержания WB

averageExpensesOnMPnumber · double

Средний расход по продаже на МП на 1 ед товара(берутся все расходы на МП по товару)

compensationForLostItemOnWbnumber · double

Компенсация за утерянный товар от WB

productAmountSumnumber · double

Поле productAmountSum.

totalSalesAmountPositiveSumnumber · double

Поле totalSalesAmountPositiveSum.

grossProfitPositiveSumnumber · double

Поле grossProfitPositiveSum.

acceptancenumber · double

Платная приёмка

cancelsCountinteger · int64

Количество отмен

ymBonusnumber · double

Баллы YM

idinteger · int64

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

orgNamestring

Название организации

organizationIdinteger · int64

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

organizationIdsstring

ID организаций через запятую (заполняется при агрегации нескольких организаций)

orgNamesstring

Названия организаций через запятую (заполняется при агрегации нескольких организаций)

reportNumberstring

Номер отчета

dateStartstring · date-time

Дата начала отчета по реализации

dateEndstring · date-time

Дата конца отчета по реализации

logisticToClientAmountnumber · double

Стоимость логистики к клиенту в руб.

logisticFromClientAmountnumber · double

Стоимость логистики от клиента в руб.

salesCommissionnumber · double

Комиссия от продажи в руб.

returnsCommissionnumber · double

Возврат комиссии в руб.

intersettlementsnumber · double

Взаиморасчёты с маркетплейсом в руб.

profitnumber · double

Чистая прибыль в руб. grossProfit - fixedOutlay - taxes + income

profitClearnumber · double

Чистая прибыль без учета постоянных расходов и доп. доходов в руб. grossProfit - taxes

bankPaymentnumber · double

Оплата по банку в руб.

costPricenumber · double

Себестоимость товара в руб. purchasePrice * salesCount

fixedOutlaynumber · double

Постоянные расходы в руб.(Расходы за весь интервал / кол-во дней в месяце)*на выбранный интервал, если период захватывает больше одного месяца, будет вычисляться для каждого месяца, а после складываться, в случае нескольких отчетах для организации, то будет по каждому отчету браться по коэфициенту продаж

taxesnumber · double

Налоги в руб.

taxableRevenuenumber · double

Налоговая база в руб., использованная для расчета налогов

sellingCostsnumber · double

Затраты по продаже на МП. getLogistics() + getCommissions() + getIntersettlements() + getPenalty() + getServices() - getAdditionalAndDeduction() - getOtherAmount() + getCostStorage()

rentabilitynumber · double

Рентабельность. (profit / totalSalesAmount) * 100

taxRatenumber · double

Процентная ставка налога

taxTypestring

Тип налогообложения

totalCampaignCostnumber · double

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

ozonCampaignCostnumber · double

Реклама Озон

ozonBonusnumber · double

Баллы Ozon

basicExpensesnumber · double

Сумма основных расходов: комиссия + логистика + себестоимость

otherExpensesnumber · double

Сумма прочих расходов: платная приемка + прочие удержания + прочие начисления + хранения + доплаты

additionalExpensesnumber · double

Сумма дополнительных расходов: реклама + услуги + штрафы + сумма прочих расходов

ozonDeliveryReturnnumber · double

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

emptyPurchaseAmountinteger · int64

Сумма продаж, для которых не указана закупочная цена

inputVatnumber · double

Входящий НДС, руб.

outputVatnumber · double

Исходящий НДС, руб.

finalVatnumber · double

Итоговый НДС (исходящий - входящий), руб.

incomeTaxnumber · double

Налог на прибыль, руб.

totalTaxnumber · double

Общий налог (НДС + налог на прибыль), руб.

incomenumber · double

Прочие доходы

servicestring

Маркетплейс (OZON, WILDBERRIES, YANDEX_MARKET и т.д.)

serviceIdinteger · int32

Поле serviceId.

orderTypestring

Тип заказа строки: розница, опт или пусто для маркетплейсов

orderTypeIdinteger · int32

Идентификатор типа заказа из profit_report.order_type_id

FindResponseFinanceReport1 полей
rowsFinanceReport[]

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

FindResponseRowStructureForFinanceTable1 полей
rowsRowStructureForFinanceTable[]

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

GetFinanceStructureResult5 полей
rowsRowStructureForFinanceTable[]

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

totalinteger · int32

Общее количество найденных записей. Возвращается только, когда count = true

pageinteger · int32

Номер запрошенной страницы

hasMorePagesboolean

Есть ли страницы после запрошенной

fixedOutlaynumber · double

Поле fixedOutlay.

RowStructureForFinanceTable9 полей
idinteger · int32

Поле id.

namestring

Поле name.

costnumber · double

Поле cost.

totalSalesnumber · double

Поле totalSales.

percentnumber · double

Поле percent.

absPercentnumber · double

Поле absPercent.

costWithoutSppnumber · double

Поле costWithoutSpp.

totalSalesWithoutSppnumber · double

Поле totalSalesWithoutSpp.

percentWithoutSppnumber · double

Поле percentWithoutSpp.

Tip4 полей
typestring

Поле type.

titlestring

Поле title.

descriptionstring

Поле description.

valuenumber · double

Поле value.

Address15 полей
idinteger · int32

Поле id.

postCodestring

Поле postCode.

countryCountry

Поле country.

regionRegion

Поле region.

regionIdinteger · int32

Поле regionId.

streetstring

Поле street.

housestring

Поле house.

districtstring

Поле district.

citystring

Поле city.

localitystring

Поле locality.

buildingstring

Поле building.

flatstring

Поле flat.

shortstring

Поле short.

addressIdAddress

Поле addressId.

fullstring

Поле full.

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

Cell16 полей
idinteger · int32

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

read-only
warehouseIdinteger · int64

Склад к которому относится ячейка

passageIdinteger · int32

Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр

shelfIdinteger · int32

Полка стеллажа, к которой относится ячейка

rackIdinteger · int32

Стеллаж, к которому относится ячейка

namestring

Название ячейки. По умолчанию формируется автоматически

fullNamestring

Полное название ячейки из названий прохода, стелажа, полки и ячейки

sortNamestring

Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки

barcodestring

Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки

deletedboolean

Признак того, что ячейка удалена

widthinteger · int32

Ширина ячейки для определения товаров, которые можно положить в нее

heightinteger · int32

Высота ячейки для определения товаров, которые можно положить в нее

depthinteger · int32

Глубина ячейки для определения товаров, которые можно положить в нее

clientIdinteger · int64

Клиент которому принадлежит ячейка. Проставляется автоматически

read-only
lastInventoryIdinteger · int32

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

read-only
typestring

Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов

Contractor14 полей
idinteger · int64

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

namestring

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

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

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

clientIdinteger · int64

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

read-only
createdUserstring

Логин пользователя, который создал контрагента

read-only
lastIncomeDatestring · date-time

Дата последнего поступления для этого контрагента для сортировки

read-only
deletedboolean

Признак удаления контрагента

read-only
organizationIdinteger · int64

Организация для реквизитов контрагента

phoneNumberstring

Номер телефона

emailstring

Адрес электронной почты

contactNamestring

Имя контакта

moySkladIdstring

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

urlstring

Ссылка на сайт

organizationOrganization

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

read-only
Country6 полей
countryIdinteger · int32

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

namestring

Название страны

code2string

Двухбуквенный код страны

code3string

Трехбуквенный код страны

namesobject

Поле names.

printNamestring

Поле printName.

FindirData22 полей
idinteger · int64

Поле id.

productIdinteger · int64

Поле productId.

netProfitRubnumber · double

Поле netProfitRub.

quantityinteger · int32

Поле quantity.

purchasePricenumber · double

Поле purchasePrice.

purchasePercentnumber · double

Поле purchasePercent.

clientIdinteger · int64

Поле clientId.

servicestring

Сервис

organizationIdinteger · int64

Поле organizationId.

tipTypestring

Поле tipType.

jsonValuesstring

Поле jsonValues.

statusstring

Поле status.

profitGrowthAmountnumber · double

Поле profitGrowthAmount.

confidenceLevelinteger · int32

Поле confidenceLevel.

actionsToDoIdinteger · int32

Поле actionsToDoId.

currValuenumber · double

Поле currValue.

triggerValuenumber · double

Поле triggerValue.

normValuenumber · double

Поле normValue.

createdDatestring · date-time

Поле createdDate.

updatedDatestring · date-time

Поле updatedDate.

productProduct

Поле product.

serviceIdinteger · int32

Поле serviceId.

LamodaCategory8 полей
idinteger · int64

Поле id.

namestring

Название

shortNamestring

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

publishedboolean

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

isLeafboolean

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

parentIdinteger · int64

Поле parentId.

lastSyncDatestring · date-time

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

notChangedDaysinteger · int32

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

Manufacturer11 полей
manufacturerIdinteger · int32

Идентификатор производителя. Генерируется автоматически

titlestring

Название производителя внешнее для печати

namestring

Название производителя внутреннее

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

Адрес производителя производителя внутреннее

organizationIdinteger · int64

Связь производителя с организацией - контрагентом

clientIdinteger · int64

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

read-only
countryIdinteger · int32

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

countryNamestring

Название страны

read-only
innstring

ИНН производителя, используется в основном для Честного знака

deletedboolean

Если true - производитель удален

oneCIdstring

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

MarketplaceCommissionCalculation8 полей
baseCommissionnumber · double

Поле baseCommission.

adjustmentPercentPointsnumber · double

Поле adjustmentPercentPoints.

effectiveCommissionnumber · double

Поле effectiveCommission.

plannedProcessingHoursnumber · double

Поле plannedProcessingHours.

processingHoursNormnumber · double

Поле processingHoursNorm.

processingHoursSourcestring

Поле processingHoursSource.

ruleValidFromstring · date

Поле ruleValidFrom.

ruleSourcestring

Поле ruleSource.

Option12 полей
idinteger · int64

Идентификатор значения, может отсутствовать

namestring

Название значения, лучше всегда передавать

paramIdinteger · int64

Идентификатор значения параметра Param.id

ozonIdinteger · int64

Идентификатор значения параметра на Ozon

wildberriesIdinteger · int64

Признак того, что значение параметра WB

ymIdinteger · int64

Признак того, что значение параметра YM

aliexpressIdinteger · int64

Идентификатор значения параметра на Aliexpress

clientIdinteger · int64

Поле clientId.

deletedboolean

Поле deleted.

oneCIdstring

Идентификатор значения параметра в 1С

dictionaryboolean

Поле dictionary.

optionIdOption

Поле optionId.

Organization33 полей
idinteger · int64

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

read-only
namestring

Полное наименование организации

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

Поле shortName.

taxTypestring

Система налогооблажения

taxRateinteger · int32

Ставка налога, если она отличается от стандартной

taxNdsinteger · int32

Ставка налога, если она отличается от стандартной

inputTaxNdsinteger · int32

Ставка входящего НДС

outputTaxNdsinteger · int32

Ставка исходящего НДС

enableNewTaxCalculationboolean

Включить расчет налогов по новым правилам

useNdsCostPriceboolean

Учитывать входящий НДС в себестоимости

innstring

ИНН

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

КПП. Проставляется только для ООО

bankstring

Название банка

bikstring

БИК счета организации

corrBillstring

Номер корреспондентского счета

billNumberstring

Номер счета организации

stampPathstring

Ссылка на изображение печати организации

read-only
stampUrlstring

Ссылка на изображение печати организации

read-only
stampSizeinteger · int32

Размер в байтах изображения печати организации

read-only
stampWidthinteger · int32

Ширина изображения печати организации

read-only
stampHeightinteger · int32

Высота изображения печати организации

read-only
signaturePathstring

Фото подписи директора организации

read-only
signatureUrlstring

Фото подписи директора организации

read-only
signatureSizeinteger · int32

Размер файла в байтах подписи директора организации

read-only
signatureWidthinteger · int32

Ширина изображения подписи директора

read-only
signatureHeightinteger · int32

Высота изображения подписи директора

read-only
ipPersonPerson

Руководитель организации или ИП

formstring

Организационно правовая форма

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

Поле ip.

clientIdinteger · int64

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

read-only
addressAddress

Адресс организации

phoneNumberstring

Номер телефона

addressFullstring

Полный адрес

read-only
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 Финдире

ParamValue14 полей
paramIdinteger · int64

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

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

Название параметра, для тех, у кого нет ID

optionOption

Значение перечислимого параметра

doubleValuenumber · double

Числовое значение параметра

longValueinteger · int64

Целочисленное значение параметра

booleanValueboolean

Булево значение параметра

stringValuestring

Строковое значение параметра

dateValuestring · date-time

Значение параметра даты

servicestring

Привязка к сервису параметра

unitUnit

Единица измерения для параметра

autoboolean

Автоматически проставленное значение параметра

createdinteger · int64

Дата заполнения параметра

userstring

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

lockedboolean

Значение зафиксировано и не должно изменяться при импорте карточек с маркетплейса

Person14 полей
personIdinteger · int64

Поле personId.

read-only
firstNamestring

Имя сотрудника

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

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

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

Отчество сотрудника

clientIdinteger · int64

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

read-only
positionPersonPosition

Должность сотрудника

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

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

read-only
createdUserstring

Проставляется автоматически. Пользователь создавший сотрудника

read-only
createdDatestring · date-time

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

read-only
deletedboolean

Признак удаления сотрудника

read-only
userIdinteger · int32

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

read-only
hasChangesboolean

Поле hasChanges.

fullNamestring

Полные ФИО

read-only
shortNamestring

Фамилия и инициалы

read-only
PersonPosition7 полей
idinteger · int64

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

read-only
namestring

Название должности

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

Признак удаления должности

read-only
clientIdinteger · int64

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

read-only
defaultJobIdinteger · int64

Работа по умолчанию для должности

createdUserstring

Пользователь, который создал должность

read-only
createdDatestring · date-time

Дата создания должности

read-only
PriceType7 полей
idinteger · int64

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

codestring

Код типа цены

namestring

Название типа цены

langCodestring

Код языка

currencystring

Валюта

servicestring

Сервис

clientIdinteger · int64

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

Product328 полей
idinteger · int64

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

productTypestring

Тип товара

namestring

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

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

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

read-only
printNamestring

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

realSizestring

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

vendorSizestring

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

sizestring

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

wildberriesStockCountinteger · int32

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

read-only
ozonRealFbsboolean

Признак использования RealFbs для товара

read-only
ozonStockCountinteger · int32

Остаток товара на складах Озон

read-only
ozonStockBetweenWarehousesinteger · int32

Остаток товара в Озон, которые перемещаются между складами

read-only
removeFbsStockboolean

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

noStockSyncboolean

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

purchaseCurrencystring

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

purchasePriceInCurrencynumber · double

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

deliveryCostInCurrencynumber · double

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

versionIdinteger · int64

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

createdDatestring · date-time

Дата создания товара на МП

read-only
createdstring · date-time

Дата создания товара в SelSup

read-only
createdUserstring

Пользователь, который создал товар

read-only
sourceIncomeItemIdinteger · int64

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

sourceProductIdinteger · int64

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

ozonRequiredStockinteger · int32

Расчитанное количество товара, для поставки на склад Озон

read-only
wildberriesRequiredStockinteger · int32

Расчитанное количество товара, для поставки на склад Wildberries

read-only
wildberriesProfitnumber · double

Профит с продажи товара на Вайлдбериз по FBM

read-only
wildberriesProfitFbsnumber · double

Профит с продажи товара на Вайлдбериз по FBS

read-only
wildberriesOrderQuantityinteger · int32

Количество заказов по FBO товара на Вайлдбериз за 2 недели

read-only
wildberriesSupplyingQuantityinteger · int32

Поставляемое количество товара на Вайлдбериз по FBM заказам

read-only
wildberriesQuantityInWayToClientinteger · int32

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

read-only
wildberriesQuantityInWayFromClientinteger · int32

Поставляемое количество товара на Вайлдбериз по FBM заказам от клиента

read-only
wildberriesSaleQuantityinteger · int32

Продажи товара на Вайлдбериз по FBM за 2 недели

read-only
wildberriesQuantityInWayinteger · int32

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

read-only
wildberriesNoSaleboolean

Признак неликвидного товара на Вайлдбериз

read-only
lastStockChangestring · date-time

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

read-only
ozonOrderQuantityinteger · int32

Количество заказов товара по FBO на Озон по FBM и FBS за 2 недели

read-only
ozonSupplyingQuantityinteger · int32

Поставляемое количество товара на Озон по FBM

read-only
ozonProfitinteger · int32

Чистая маржа продажи товара на Озон по FBM

read-only
instockQuantityinteger · int32

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

read-only
instockQuantityValuenumber · double

Остатки товара на складах клиента в пользовательской единице измерения

read-only
stockUnitstring

Единица измерения остатка товара для интерфейса и внешних интеграций

calculatedInStockQuantityinteger · int32

Рассчитанный остаток

read-only
calculatedInStockQuantityValuenumber · double

Рассчитанный остаток в пользовательской единице измерения

read-only
clientIdinteger · int64

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

read-only
organizationIdinteger · int64

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

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

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

read-only
viewProductView

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

read-only
suzIdstring

GTIN товара

cisTypestring

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

notChangedStockinteger · int32

Количество дней, в течении которых не менялся остаток товара

read-only
cardExchangesProductCardExchange[]

Последние статусы обмена карточки с маркетплейсами

read-only
wildberriesStatusstring

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

read-only
wildberriesMessagestring

Ошибка создания карточки товара в Вайлдбериз

read-only
wildberriesMessageParamsstring

JSON параметров ошибки создания карточки товара в Вайлдбериз

read-only
nationalCatalogStatusstring

Статус создания карточки товара в Национальном каталоге

read-only
nationalCatalogMessagestring

Ошибка создания карточки товара в Национальном каталоге

read-only
nationalCatalogMessageParamsstring

Параметры ошибки создания карточки товара в Национальном каталоге

read-only
ozonStatusstring

Статус создания карточки товара в Озон

read-only
ozonMessagestring

Ошибка создания карточки товара в Озон

read-only
ozonMessageParamsstring

JSON параметры ошибки создания карточки товара в Озон

read-only
ozonTaskIdinteger · int64

Идентификатор задания по обновления или созданию карточки в Озон

read-only
wildberriesFbsOrdersQuantityinteger · int32

Кол-во заказанных товаров на данной карточке WB по FBS за 2 недели

read-only
ozonFbsOrdersQuantityinteger · int32

Кол-во заказанных товаров на данной карточке на Ozon по FBS за 2 недели

read-only
ymarketFbsOrdersQuantityinteger · int32

Кол-во заказанных товаров на данной карточке на Яндекс Маркете по FBS за 2 недели

read-only
totalSupplyingQuantityinteger · int32

Кол-во заказанных товаров на данной карточке за 2 недели

read-only
skuIdinteger · int64

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

read-only
skuSku

Поле sku.

barcodesProductBarcode[]

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

serviceProductsServiceProduct[]

Cвязи с товарами маркетплейсов

siteArticlestring

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

siteIdstring

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

paramsstring

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

valuesParamValue[]

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

groupobject

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

read-only
duplicatesProduct[]

Дубликаты карточки по остаткам. Отдаются только на списке товаров, если включена галочка Объединять дубликаты

read-only
hasChangesboolean

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

ignoreDuplicateboolean

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

yandexMarketStockCountinteger · int64

Остаток товара на складах Yandex.Market

read-only
groupIdinteger · int64

ID групповой карточки

yandexMarketStatusstring

Статус создания карточки товара на яндекс маркет

read-only
yandexMarketMessagestring

Сообщение при ошибке создания карточки товара на яндекс маркет

read-only
yandexMarketMessageParamsstring

Параметры сообщения при создании товара в Яндекс.Маркет

read-only
duplicateboolean

Признак, что карточка является дубликатом. Отдается не для всех методов

read-only
ozonHasPhotoboolean

Признак наличия фото на Ozon

read-only
aliexpressStatusstring

Статус создания товара на Aliexpress

read-only
aliexpressMessagestring

Сообщение при создании товара на Aliexpress

read-only
aliexpressMessageParamsstring

Параметры сообщения при создании товара на Aliexpress

read-only
moySkladTypestring

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

read-only
moySkladStatusstring

Статус создания карточки товара в МойСклад

read-only
avitoStatusstring

Статус обьявления на Авито

read-only
moySkladMessagestring

Ошибка создания карточки товара в МойСклад

read-only
moySkladMessageParamsstring

Параметры ошибки создания карточки товара в МойСклад

read-only
removeFbsStockOzonboolean

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

removeFbsStockWbboolean

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

removeFbsStockAliboolean

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

removeFbsStockYmboolean

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

removeFbsStockSberboolean

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

quantityinteger · int32

Количество товара в заказах. Возвращается только в методах income/getProductsFromOrders или wms/findStock

read-only
incomeQuantityinteger · int32

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

orderMinDatestring · date-time

Минимальная дата заказа. Возвращается только в методах income/getProductsFromOrders

read-only
expiredDatestring · date-time

Cрок годности товара - возвращается только в методах, wms/findStock

read-only
productionDatestring · date-time

Дата производства

read-only
stockinteger · int32

Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock

read-only
stockValuenumber · double

Остаток на складе в пользовательской единице измерения

read-only
stocksobject

Остатки товара на складах - возвращается только в методах, wms/fetchStock

read-only
cellCell

Ячейка хранения товара на определенном складе - возвращается только в методах, wms/fetchStock

read-only
reservedinteger · int32

Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock

read-only
reservedValuenumber · double

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

read-only
calculatedStockinteger · int32

Остаток наборов на определенном складе - возвращается только в методах, wms/fetchStock, product/findProduct, supply/findProductForOrder

read-only
calculatedStockValuenumber · double

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

read-only
pricenumber · double

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

updatedPricenumber · double

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

priceWithoutDiscountnumber · double

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

updatedPriceWithoutDiscountnumber · double

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

updatedDeliveryCostnumber · double

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

updatedPurchasePricenumber · double

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

purchasePricenumber · double

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

isPurchasePriceUpdatedboolean

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

isDeliveryCostUpdatedboolean

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

wholesalePricenumber · double

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

deliveryCostnumber · double

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

strategyIdinteger · int64

Идентификатор стратегии ценообразования

ozonAverageExpensesnumber · double

Расходы по продаже товара на Ozon

read-only
wildberriesAverageExpensesnumber · double

Расходы по продаже товара на Wildberries

read-only
yandexMarketAverageExpensesnumber · double

Расходы по продаже товара на ЯМ

read-only
wildberriesSaleinteger · int32

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

read-only
minPricenumber · double

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

ozonPromotionPricenumber · double

Текущая акционная цена товара на Озон

read-only
ozonAcquiringPercentnumber · double

Максимальная комиссия за эквайринг OZON

read-only
ozonComissonnumber · double

Комиссия товара на Озон FBM

read-only
sberMegaMarketSupplyingQuantityinteger · int32

Поставляемое количество товара на СберМегаМаркет по FBM заказам

read-only
yandexMarketSupplyingQuantityinteger · int32

Поставляемое количество товара на Яндекс.Маркет по FBM заказам

read-only
salesExpensesOnMpPercentnumber · double

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

salesCountCoefficientnumber · double

Коэффициент пересчета продаж и возвратов в товарной аналитике

measureUnitIdinteger · int32

Единица измерения товара (ID единицы измерения)

taxeRatenumber · double

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

desiredMarginalityPercentnumber · double

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

desiredProfitRubnumber · double

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

additionalCostnumber · double

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

packWidthinteger · int32

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

packHeightinteger · int32

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

packDepthinteger · int32

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

packWeightinteger · int32

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

numOfPiecesInBoxinteger · int32

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

lastWildberriesSaleDatestring · date-time

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

lastWildberriesOrderDatestring · date-time

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

lastOzonSaleDatestring · date-time

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

lastOzonOrderDatestring · date-time

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

totalOrdersCountinteger · int32

Кол-во заказанных товаров на данной карточке по МП OZON + WB

read-only
totalFbsOrdersCountinteger · int32

Кол-во заказанных товаров на данной карточке по FBS за 2 недели

read-only
wildberriesTotalOrdersCountinteger · int32

Кол-во заказанных товаров на данной карточке по МП WB

read-only
ignoreFbsWarehousesstring

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

fbsWarehousesstring

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

minFbsStockinteger · int32

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

maxFbsStockinteger · int32

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

wildberriesSaleLogisticnumber · double

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

wildberriesReturnLogisticnumber · double

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

wildberriesTotalLogisticsnumber · double

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

wildberriesWarehouseRationumber · double

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

wildberriesComissionnumber · double

Комиссия WB, %

ozonSaleLogisticnumber · double

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

ozonReturnLogisticnumber · double

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

ozonCommissionnumber · double

Комиссия Ozon, %

maxDeliveryToPickupPointnumber · double

Максимальная стоимость доставки до места выдачи, руб.

ozonPurchasePercentnumber · double

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

wildberriesPurchasePercentnumber · double

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

minMarginalitynumber · double

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

maxMarginalitynumber · double

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

minProfitnumber · double

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

maxProfitnumber · double

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

minPriceWithDiscountnumber · double

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

maxPriceWithDiscountnumber · double

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

oldWildberriesPriceWithDiscountnumber · double

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

oldWildberriesSaleinteger · int32

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

wildberriesPromoProfitnumber · double

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

wildberriesMarginalitynumber · double

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

wildberriesPromoIdinteger · int64

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

oldWildberriesPromoSalePercentnumber · double

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

oldWildberriesPromoPriceWithDiscountnumber · double

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

endWildberriesPriceWithSppConfignumber · double

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

ozonFbsCommissionnumber · double

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

ozonFboCommissionnumber · double

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

wbTotalSalesCountinteger · int64

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

ozonTotalSalesCountinteger · int64

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

sberTotalSalesCountinteger · int64

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

yandexTotalSalesCountinteger · int64

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

ozonRaitingnumber · double

Рейтинг товара на Ozon

read-only
ozonFeedbackCountinteger · int32

Количество отзывов на товар на Ozon

read-only
ozonPriceWithSppnumber · double

Цена товара на Ozon с учетом СПП, руб.

read-only
fboStockCountinteger · int64

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

fbsStockCountinteger · int64

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

stockCoverageDaysinteger · int64

На сколько дней хватит текущего остатка ФБО на складе

fboSupplyQuantityinteger · int64

Количество поставляемого товара по выбранным складам/регионам

fboSalesinteger · int64

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

fbsSalesinteger · int64

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

fboOrdersinteger · int64

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

fbsOrdersinteger · int64

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

recommendPlannumber · double

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

baseDeficitinteger · int64

Базовый дефицит склада до распределения остатков без склада назначения

allocatedWithoutWarehouseinteger · int64

Часть общих остатков без склада назначения, распределенная на склад

skipDaysCountinteger · int32

Кол-во пропущенных дней в учёте планирования поставок

organizationShortNamestring

Поле organizationShortName.

contractorNamestring

Поле contractorName.

supplyPlanBarcodestring

Поле supplyPlanBarcode.

planCorrectionFactornumber · double

Коэффициент коррекции для планирования поставок. На это значение умножается рассчитанное количество товара для поставки

orderBeforeinteger · int32

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

daysBeforeSupplyinteger · int32

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

supplyPlanDaysinteger · int32

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

warehouseIdForSupplyReportinteger · int64

Id склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок

read-only
warehouseNameForSupplyReportstring

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

read-only
wbCanBoxboolean

Можно ли отгружать товар на склад WB в коробах

read-only
wbCanMonopalletboolean

Можно ли отгружать товар на склад WB в монопаллете

read-only
wbCanSupersafeboolean

Можно ли отгружать товар на склад WB в Supersafe

read-only
wbCanBoxOnPalletboolean

Можно ли отгружать товар на склад WB в коробах на паллете

read-only
managerstring

Поле менеджера

cellIdinteger · int32

Поле cellId.

drrPercentinteger · int32

ДРР% - доля рекламных расходов

percentForParticipationPromoOrAdvertisinginteger · int32

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

selsupLinkstring

Поле selsupLink.

tempIdinteger · int64

Временный id используется для быстрого импорта

categoryCategory

Поле category.

findirTipsobject

Советы задачника (тип задачи - текст совета)

commissionsstring

JSON с комиссиями из разных маркетплейсов

commissionCalculationsobject

Расчёт итоговой комиссии по маркетплейсам

lowStockAlertsstring

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

inputVatnumber · double

Входящий НДС, руб.

outputVatnumber · double

Исходящий НДС, руб.

finalVatnumber · double

Итоговый НДС (исходящий - входящий), руб.

incomeTaxnumber · double

Налог на прибыль, руб.

totalTaxnumber · double

Общий налог (НДС + налог на прибыль), руб.

netProfitnumber · double

Чистая прибыль, руб.

marginnumber · double

Чистая маржинальность, %

woocomStatusstring

Статус создания карточки товара в WooCommerce

read-only
dateStartSeason1string · date

Дата начала сезона 1

dateEndSeason1string · date

Дата окончания сезона 1

dateStartSeason2string · date

Дата начала сезона 2

dateEndSeason2string · date

Дата окончания сезона 2

dateStartSeason3string · date

Дата начала сезона 3

dateEndSeason3string · date

Дата окончания сезона 3

dateStartSeason4string · date

Дата начала сезона 4

dateEndSeason4string · date

Дата окончания сезона 4

currentGrossProfitobject

Текущая валовая прибыль. Для таблицы цены

plannedGrossProfitobject

Новая валовая прибыль. Для таблицы цены

positioninteger · int32

позиция продукта

emptyBarcodesboolean

Поле emptyBarcodes.

uzumStatusstring

Статус создания карточки товара в Uzum

read-only
makroStatusstring

Статус создания карточки товара в Makro

read-only
kaspiStatusstring

Статус создания карточки товара в Kaspi

read-only
anyLinkstring

Поле anyLink.

anyArticlestring

Поле anyArticle.

sitestring

Поле site.

shopifyStatusstring

Статус создания карточки товара в Shopify

read-only
takealotStatusstring

Статус создания карточки товара в Takealot

read-only
yandexKitStatusstring

Статус создания карточки товара в Яндекс.Кит

read-only
bobShopStatusstring

Статус создания карточки товара в Bob Shop

read-only
minPriceForAllMarketplacenumber · double

Поле minPriceForAllMarketplace.

calculatedInstockQuantityinteger · int32

Поле calculatedInstockQuantity.

lamodaParentSkustring

Родительский SKU товара на Lamoda

uzumProductIdinteger · int64

Идентификатор товара (productId) на Uzum

read-only
woocomParentIdinteger · int64

ID родительского товара в WooCommerce (для вариаций)

woocomPermalinkstring

Ссылка на товар в WooCommerce

wildberriesSizeIdinteger · int64

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

read-only
yandexMarketShopSkustring

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

aliexpressSkustring

SKU на Aliexpress

wildberriesImtIdinteger · int64

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

read-only
externalArticlestring

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

mvideoArticlestring

Артикул товара на M.Video

ozonProductIdinteger · int64

Идентификатор товара Озон в кабинете API

read-only
leroyMerlinIdstring

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

leroyMerlinArticlestring

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

magnitArticlestring

Артикль товара на Magnit

lamodaArticlestring

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

yandexMarketSkuinteger · int64

Идентификатор карточки товара на Yandex.Market

read-only
sberMegaMarketIdinteger · int64

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

detmirArticlestring

Артикул товара на Детском мире (productCode / SAP)

moySkladLinkIdstring

ID для ссылки на Мой Склад

read-only
ebayArticlestring

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

uzumSkuIdinteger · int64

Идентификатор SKU (skuId) на Uzum

read-only
sellerSkustring

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

takealotSkustring

SKU товара на Takealot

walmartSkustring

SKU товара на Walmart

walmartIdstring

Id товара на Walmart (WPID)

woocomSkustring

SKU товара на WooCommerce

woocomIdinteger · int64

Id товара на WooCommerce

opencartSkustring

SKU товара в OpenCart

opencartIdinteger · int64

Id товара в OpenCart

magnitIdstring

Id товара на Magnit

sberArticlestring

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

ozonArticlestring

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

oneCArticlestring

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

uzumArticlestring

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

simalandIdinteger · int64

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

lamodaSkustring

SKU товара на Lamoda

ozonFbsSkuinteger · int64

Идентификатор товара в Озон по FBS

read-only
ozonFboSkuinteger · int64

Идентификатор товара в Озон по FBO

read-only
avitoIdinteger · int64

ID товара в сервисе Avito

read-only
detmirIdstring

Id товара на сайте Детского мира (для ссылки на карточку)

magnitSkustring

SKU товара на Magnit

ozonIdinteger · int64

Идентификатор товара Озон на сайте. SKU в озон

read-only
oneCIdstring

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

moySkladIdstring

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

read-only
nationalCatalogFeedIdinteger · int64

Идентификатор создания карточки в национальном каталоге

read-only
yandexMarketProductIdinteger · int64

Идентификатор карточки товара на Yandex.Market

read-only
nationalCatalogGoodIdinteger · int64

Идентификатор товара в национальном каталоге

read-only
wildberriesPricenumber · double

Текущая цена товара на Вайлдбериз со скидкой

read-only
wildberriesUpdatedPricenumber · double

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

wildberriesPriceWithoutDiscountnumber · double

Текущая цена товара на Вайлдбериз без скидки

read-only
wildberriesUpdatedPriceWithoutDiscountnumber · double

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

aliexpressPricenumber · double

Текущая цена на Aliexpress со скидкой

read-only
aliexpressPriceWithoutDiscountnumber · double

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

aliexpressUpdatedPricenumber · double

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

aliexpressUpdatedPriceWithoutDiscountnumber · double

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

ozonPricenumber · double

Текущая цена товара на Озон со скидкой

read-only
ozonUpdatedPricenumber · double

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

ozonPriceWithoutDiscountnumber · double

Текущая цена товара на Озон без скидки.

read-only
ozonUpdatedPriceWithoutDiscountnumber · double

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

leroyMerlinPricenumber · double

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

leroyMerlinUpdatedPricenumber · double

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

avitoPricenumber · double

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

avitoUpdatedPricenumber · double

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

sberMegaMarketPricenumber · double

Текущая цена на СберМегаМаркет со скидкой

read-only
sberMegaMarketUpdatedPricenumber · double

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

yandexMarketPricenumber · double

Текущая цена на Яндекс.Маркет со скидкой

read-only
yandexMarketPriceWithoutDiscountnumber · double

Текущая цена на Яндекс.Маркет без скидки

read-only
yandexMarketUpdatedPricenumber · double

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

yandexMarketUpdatedPriceWithoutDiscountnumber · double

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

productPricesProductPrice[]

Поле productPrices.

stockRulesProductStockRules

Правила отправки остатков на маркетплейсы

ProductBarcode12 полей
idinteger · int64

Поле id.

barcodestring

Поле barcode.

organizationIdinteger · int64

Организация, если client.barcodeUniqForOrg = false, то проставляется 0. Поле включено в уникальный ключ

clientIdinteger · int64

Поле clientId.

productIdinteger · int64

Поле productId.

useInWildberriesboolean

Применим ли данный штрих-код для Вайлдбериз

useInOzonboolean

Применим ли данный штрих-код для Озон

useInYandexMarketboolean

Применим ли данный штрих-код для Yandex.Market

useInAliexpressboolean

Применим ли данный штрих-код для Aliexpress

useInSberMegamarketboolean

Применим ли данный штрих-код для Sber.MegaMarket

useInWoocomboolean

Применим ли данный штрих-код для WooCommerce

formatstring

Поле format.

ProductCardExchange6 полей
servicestring

Сервис

statusstring

Поле status.

lastAttemptAtstring · date-time

Поле lastAttemptAt.

errorSourcestring

Поле errorSource.

messagestring

Поле message.

messageParamsstring

Поле messageParams.

ProductImage8 полей
idinteger · int64

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

read-only
urlstring

Ссылка на файл изображения

read-only
positioninteger · int32

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

productViewIdinteger · int64

Связь с цветом

read-only
wildberriesImgUUIDstring

Связь с идентификатором изображения WB. Сейчас не используется

read-only
servicesstring[]

Поле services.

clientIdinteger · int64

Поле clientId.

angleNamestring

Название ракурса для фотографии

ProductModel67 полей
articlestring

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

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

Организация для товара

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

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

read-only
categoryIdinteger · int32

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

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

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

read-only
manufacturerIdinteger · int32

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

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

Торговая марка

read-only
brandIdinteger · int32

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

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

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

namestring

Название модели внутренее

promoNamestring

Название модели для продвижения товара. Используется в качестве названия на Wildberries

titlestring

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

wildberriesImtIdinteger · int64

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

read-only
descriptionstring

Описание товара

genderstring

Пол для товара

packWidthinteger · int32

Ширина упаковки товара в мм

packHeightinteger · int32

Высота упаковки товара в мм

packDepthinteger · int32

Глубина упаковки товара в мм

packWeightinteger · int32

Вес упаковки товара в гр

seasonstring

Сезон товара. Используется для фильтрации товара в заказах поставщикам

materialsstring

Состав товара, нужен для одежды и обуви

laundrystring

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

versionIdinteger · int64

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

clientIdinteger · int64

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

read-only
deletedboolean

Признак удаления модели

read-only
vatstring

НДС

createdDatestring · date-time

Дата создания модели

read-only
createdUserstring

Пользователь, создавший модель

read-only
countryIdinteger · int32

Страна производства товара. По умолчанию проставляется из производителя

countryNamestring

Название страны производства

read-only
keywordsstring

Ключевые слова для поиска

favouriteboolean

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

paramsstring

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

valuesParamValue[]

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

sourceModelIdinteger · int64

Модель из которой была создана данная модель как дубликат карточки

additionalInfostring

Дополнительная информация о товаре

createIndexinteger · int32

Индекс создания карточки - для ограничения бесплатного тарифа

read-only
bulkboolean

Признак сборки товара по штрих-кодам, безуникальных кодов

oneCIdstring

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

sitestring

Адрес сайта

shelfLifeinteger · int32

Срок годности в единице измерения

shelfLifeUnitstring

Срок годности в единице измерения

shelfLifeCommentstring

Комментарий срока годности

lifeTimeinteger · int32

Срок службы в единице измерения

lifeTimeUnitstring

Срок службы в единице измерения

lifeTimeCommentstring

Комментарий срока службы

modelGuaranteeinteger · int32

Гарантийный срок в единице измерения

modelGuaranteeUnitstring

Единица гарантийного срока

modelGuaranteeCommentstring

Комментарий гарантийного срока

hasChangesboolean

Признак изменения информации о модели и необходимости его обновить

pricenumber · double

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

deliveryCostnumber · double

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

wholesalePricenumber · double

Потовая цена товара. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

purchasePricenumber · double

Закупочная цена товара. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

purchaseCurrencystring

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

deliveryCostInCurrencynumber · double

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

purchasePriceInCurrencynumber · double

Закупочная цена товара в валюье. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

priceWithoutDiscountnumber · double

Цена без скидки. Используется только при создании модели из заказа поставщика, в самой моделе не хранится

viewsProductView[]

Список цветов модели

Обязательно
servicesstring[]

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

contractorsContractor[]

Список поставщиков товара

sourceIncomeItemIdinteger · int64

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

costPricenumber · double

Себестоимость считается автоматически по формуле: закупочная цена + дополнительные расходы на товар, поэтому Вам нужно заполнить эти параметры или просто закупочную цену

aliexpressGroupIdstring

Идентификатор группы по которому можно посмотерть статус создания/обновления

read-only
aliexpressIdstring

Карточка aliexpress

read-only
simpleImportboolean

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

selectedProductsinteger[]

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

ProductPrice17 полей
idinteger · int64

Идентификатор записи цены

productIdinteger · int64

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

productobject

Товар

priceTypeIdinteger · int64

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

priceTypePriceType

Тип цены

servicestring

Сервис

clientIdinteger · int64

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

pricenumber · double

Цена

updatedPricenumber · double

Обновленная цена

priceWithoutDiscountnumber · double

Цена без скидки

updatedPriceWithoutDiscountnumber · double

Обновленная цена без скидки

minPricenumber · double

Минимальная цена

updatedMinPricenumber · double

Обновленная минимальная цена

percentForParticipationPromoOrAdvertisinginteger · int32

Процент расходов на участие в акциях или рекламе

isActiveboolean

Активна ли цена

articlestring

Уникальный идентификатор товара на маркетплейсе

pendingOperationIdstring

Идентификатор асинхронной операции обновления цены (Детский мир)

ProductStock8 полей
stockinteger · int32

Поле stock.

stockValuenumber · double

Поле stockValue.

cellCell

Поле cell.

reservedinteger · int32

Поле reserved.

reservedValuenumber · double

Поле reservedValue.

calculatedStockinteger · int32

Поле calculatedStock.

calculatedStockValuenumber · double

Поле calculatedStockValue.

expiredDatestring · date-time

Поле expiredDate.

ProductStockRules3 полей
minFbsStockinteger · int32

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

maxFbsStockinteger · int32

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

subtractFromStockinteger · int32

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

ProductVideo7 полей
idinteger · int64

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

read-only
urlstring

Ссылка на файл

read-only
positioninteger · int32

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

productViewIdinteger · int64

Связь с цветом

read-only
productIdinteger · int64

Связь с размером

read-only
videoUrlsstring

Ссылка на видео

read-only
servicesstring[]

Поле services.

ProductView38 полей
colorstring

Артикул цвета

wbArticlestring

Артикул карточки Wildberries

needKizboolean

Требуется ли обязательная маркировка по данным Wildberries

idinteger · int64

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

imagesProductImage[]

Список изображений товара

videosProductVideo[]

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

productModelIdinteger · int64

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

read-only
modelProductModel

Модель, к которой относится цвет

read-only
actualboolean

Актуальность цвета - нужно ли его показывать в заказах поставщикам

mainImageProductImage

Основное изображение товара

read-only
mainImageIdinteger · int64

Поле mainImageId.

mainImageUrlstring

Ссылка на основное изображение на маркетплейсе

read-only
imageUrlsstring

Ссылка на изображения

read-only
imagesUpdatedAtstring · date-time

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

read-only
image360Urlsstring

Ссылка на изображения 360

read-only
wildberriesIdinteger · int64

Числовой идентификатор номенклатуры Wildberries, nmId

createdDatestring · date-time

Дата создания цвета

read-only
createdUserstring

Пользователь, создавший цвет

read-only
versionIdinteger · int64

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

clientIdinteger · int64

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

read-only
deletedboolean

Признак удаления цвета

read-only
keywordsstring

Ключевые слова - сейчас не используется, перенесены в модель

wildberriesRatingnumber · double

Рейтинг карточки на Вайлдбериз

read-only
wildberriesFeedbacksinteger · int32

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

read-only
wbRaitingnumber · double

Рейтинг карточки на Вайлдбериз

read-only
wbFeedbackCountinteger · int32

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

read-only
wbPriceWithSppnumber · double

Цена карточки на Вайлдбериз с учетом СПП, руб.

read-only
wildberriesCardDoesNotOpenboolean

Признак, что карточка не открывается на Вайлдбериз

read-only
wildberriesHasPhotoboolean

Признак наличия фото на Wildberries

read-only
organizationIdinteger · int64

Организация карточки

read-only
paramsstring

JSON со значениями параметров цвета

additionalInfostring

Дополнительная информация для цвета

valuesParamValue[]

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

viewSourceIdinteger · int64

Оригинал цвета по SKU

read-only
sizesProduct[]

Список размеров для цвета

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

Признак изменения информации о цвете и необходимости его обновить

viewWbArticleProductView

Поле viewWbArticle.

viewVersionIdinteger · int64

Поле viewVersionId.

Region4 полей
regionIdinteger · int32

Поле regionId.

countryIdinteger · int32

Поле countryId.

namestring

Поле name.

regionSynonymsRegionSynonym[]

Поле regionSynonyms.

RegionSynonym4 полей
idinteger · int64

Поле id.

regionIdinteger · int64

Поле regionId.

synonymstring

Поле synonym.

servicestring

Поле service.

ServiceCategoryMapping3 полей
servicestring

Сервис

externalIdstring

Поле externalId.

namestring

Поле name.

ServiceProduct19 полей
serviceProductIdinteger · int64

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

productIdinteger · int64

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

serviceIdinteger · int32

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

serviceListingIdinteger · int64

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

serviceCardIdinteger · int64

Поле serviceCardId.

fboStockinteger · int32

Остаток на ФБО складах

lastRepricerPriceStatusstring

Последний статус обновления цены через репрайсер

errorMessagestring

Ошибка при установки цены через репрайсер

serviceCardstring

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

serviceCardProductstring

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

serviceCardUrlstring

Ссылка на карточку на сервисе (если несколько товаров отображаются)

serviceProductUrlstring

Ссылка на товар селлера на сервисе

serviceBarcodestring

Штрих код на сервисе

fboCommissionsnumber · double

Комиссия ФБО

fbsCommissionsnumber · double

Комиссия ФБС

purchasePercentnumber · double

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

serviceArticlestring

Артикул на сервисе

clientIdinteger · int64

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

organizationIdinteger · int64

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

Sku3 полей
idinteger · int64

Поле id.

productobject

Первый товар из которого был создан SKU

productIdinteger · int64

Поле productId.

Tnved14 полей
idinteger · int64

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

namestring

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

deletedboolean

Поле deleted.

typestring

Тип

categoryClassstring

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

parentIdinteger · int64

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

keywordsstring

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

descriptionstring

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

paramsTnvedIdinteger · int64

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

isInParamboolean

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

certificationstring

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

parentCodestring

Поле parentCode.

codestring

Поле code.

certificationRequiredboolean

Поле certificationRequired.

Unit3 полей
namestring

Название единицы измерения

measureIdinteger · int32

Мера параметра

idinteger · int32

Поле id.

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

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

FindResponseFindirData1 полей
rowsFindirData[]

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

FindResponseProduct1 полей
rowsProduct[]

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

FileExportColumn5 полей
idinteger · int64

ID записи

fileExportIdinteger · int64

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

columnNamestring

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

columnOrderinteger · int32

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

isEnabledboolean

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

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

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

Метод для возврата данных для отображения в блоке умного анализа финансов, сгенерированные с помощью AI. В теле запроса передается объект полученный из GET fullFinanceReport, чтобы не пересчитывать

Тело запроса

application/json
Поля объектаComprehensiveFinanceAnalytics
ПолеТипОбязательноОписание
salesExpensesOnMarketplaces FindResponseRowStructureForFinanceTable Нет Поле salesExpensesOnMarketplaces.
Поля объекта FindResponseRowStructureForFinanceTable
ПолеТипОбязательноОписание
rows RowStructureForFinanceTable[] Нет Строки с результатом поиска
Структура элемента массива RowStructureForFinanceTable
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
costStructure GetFinanceStructureResult Нет Поле costStructure.
Поля объекта GetFinanceStructureResult
ПолеТипОбязательноОписание
rows RowStructureForFinanceTable[] Нет Строки с результатом поиска
Структура элемента массива RowStructureForFinanceTable
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
total integer · int32 Нет Общее количество найденных записей. Возвращается только, когда count = true
page integer · int32 Нет Номер запрошенной страницы
hasMorePages boolean Нет Есть ли страницы после запрошенной
fixedOutlay number · double Нет Поле fixedOutlay.
profitStructure GetFinanceStructureResult Нет Поле profitStructure.
Поля объекта GetFinanceStructureResult
ПолеТипОбязательноОписание
rows RowStructureForFinanceTable[] Нет Строки с результатом поиска
Структура элемента массива RowStructureForFinanceTable
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
total integer · int32 Нет Общее количество найденных записей. Возвращается только, когда count = true
page integer · int32 Нет Номер запрошенной страницы
hasMorePages boolean Нет Есть ли страницы после запрошенной
fixedOutlay number · double Нет Поле fixedOutlay.
penaltyStructure RowStructureForFinanceTable[] Нет Поле penaltyStructure.
Структура элемента массива RowStructureForFinanceTable
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
serviceStructure RowStructureForFinanceTable[] Нет Поле serviceStructure.
Структура элемента массива RowStructureForFinanceTable
ПолеТипОбязательноОписание
id integer · int32 Нет Поле id.
name string Нет Поле name.
cost number · double Нет Поле cost.
totalSales number · double Нет Поле totalSales.
percent number · double Нет Поле percent.
absPercent number · double Нет Поле absPercent.
costWithoutSpp number · double Нет Поле costWithoutSpp.
totalSalesWithoutSpp number · double Нет Поле totalSalesWithoutSpp.
percentWithoutSpp number · double Нет Поле percentWithoutSpp.
financesReportByPeriod FindResponseFinanceReport Нет Финансовый отчёт по периодам, одна строка = один период (dateKey). Если выбрано несколько организаций, значения агрегируются по dateKey В конце может присутствовать итоговая строка по всему интервалу без dateKey
Поля объекта FindResponseFinanceReport
ПолеТипОбязательноОписание
rows FinanceReport[] Нет Строки с результатом поиска
Структура элемента массива FinanceReport
ПолеТипОбязательноОписание
shortName string Нет Сокращенное название организации.
categoryName string Нет Название категории.
brandName string Нет Название бренда.
name string Нет Название товара
modelName string Нет Название модели
viewWildberriesId integer · int64 Нет Карточка Wildberries
article string Нет Артикул
serviceArticle string Нет Артикул на маркетплейсе
color string Нет Цвет товара.
size string Нет Размер товара.
barcode string Нет Шк товара.
purchasePrice number · double Нет Закупочная цена.
createdDate string · date-time Нет Дата создания карточки.
isDuplicate boolean Нет Признак дубликата карточки.
dateKey string Нет Ключ по дате.
salesCount integer · int64 Нет Продажи в шт.
salesCountConventional number · double Нет Продажи в у.е.
returnsCount integer · int64 Нет Возвраты в шт.
returnsCountConventional number · double Нет Возвраты в у.е.
totalSalesCount integer · int64 Нет Разница между продажами и возвратами в шт. salesCount - returnsCount
totalSalesCountConventional number · double Нет Разница между продажами и возвратами в у.е.
salesAmount number · double Нет Продажи в руб.
returnsAmount number · double Нет Возвраты в руб.
averageReturnsAmount number · double Нет Возвраты в руб. за 1 ед
totalSalesAmount number · double Нет Разница между продажами и возвратами в руб. salesAmount - returnsAmount
orderAmount number · double Нет Заказы в руб.
orderAmountWithoutCancel number · double Нет Заказы в руб. без отмен
logistics number · double Нет Логистика в руб.
averageLogistics number · double Нет Средняя логистика в руб.
logisticsShare number · double Нет Доля логистики в структуре выручки, %
commissions number · double Нет Комиссия в руб.
acquiring number · double Нет Эквайринг в руб.
averageCommissions number · double Нет Средняя комиссия в руб.
penalty number · double Нет Штрафы в руб.
additional number · double Нет Доплаты в руб.
refundsAndCancellations number · double Нет Возвраты и отмены в руб.
compensationAmount number · double Нет Компенсации в руб.
additionalAndDeduction number · double Нет Доплаты и удержания в руб. в файле финансах ячейка Доплаты
services number · double Нет Услуги в руб.
drr number · double Нет ДРР по выкупам, %: расходы на рекламу / чистая выручка * 100
drrByOrders number · double Нет ДРР Wildberries по рекламным заказам, %: расходы на рекламу / сумма рекламных заказов * 100
advertisingOrdersAmount number · double Нет Сумма рекламных заказов Wildberries, руб.
totalToBePaid number · double Нет Итого к оплате с учётом выручки, расходов, доплат и удержаний
averageToBePaid number · double Нет Итого к оплате за 1 товар.
productCount integer · int64 Нет Товарный остаток FBS + FBO на текущий момент.
salesAmountInPurchasePrice number · double Нет Проданный товар в закупочных ценах, руб.
productAmount number · double Нет Сумма по товарному остатку purchasePrice * productCount
averageSellingPrice number · double Нет Средняя фактическая цена продажи
markUp number · double Нет Фактическая наценка totalToBePaid / (purchasePrice * totalSalesCount)
margin number · double Нет Маржинальность
grossProfit number · double Нет Валовая прибыль totalToBePaid - totalSalesCount * purchasePrice - selPayAmount
averageGrossProfit number · double Нет Валовая прибыль за 1 ед.
ratioInIncome number · double Нет Доля в выручке
rationInGrossProfit number · double Нет Доля в валовой прибыли в % grossProfit / SUM(grossProfit)
ratioInProductCount number · double Нет Доля в товарном остатке в % productAmount / SUM(productAmount)
efficiencyForIncome number · double Нет Эффективность по выручке ratioInIncome / ratioInProductCount
grossProfitEfficiency number · double Нет Эффективность по валовой прибыли rationInGrossProfit / ratioInProductCount
averageExpenses number · double Нет Средний расходов по продаже на МП на 1 ед товара, руб. все расходы в руб / продажи - возвраты в шт
otherAmount number · double Нет Прочие начисления, руб.
percentRedemption number · double Нет Процент выкупа. Продажи/(Продажи+Возвраты)*100 только для ВБ
orderCount integer · int64 Нет Кол-во заказов в шт.
orderCountWithoutCancel integer · int64 Нет Кол-во заказов в шт. без отмен
nonPurchasePriceCount integer · int64 Нет Кол-во profitRepot где не указана закупочная цена, шт.
selfPayCount integer · int64 Нет Кол-во самовыкупов, шт.
selfPayAmount number · double Нет Сумма самовыкупов, руб.
costStorage number · double Нет Сумма за хранения товара на МП, получаем только по ВБ через импорт файла.
campaignCost number · double Нет Стоимость рекламы ВБ
externalCampaignCost number · double Нет Стоимость внешней рекламы
wbSpp number · double Нет СПП: скидка постоянного покупателя на ВБ + баллы Ozon
salesAmountBeforeSpp number · double Нет Выручка до применения СПП с учетом возвратов, руб. Только ВБ. Рассчитывается как выручка + СПП
wbTotalSalesByPriceWithDisc number · double Нет Сумма продажи ВБ, по цене со скидкой продажи - возвраты
otherDeductions number · double Нет Прочие удержания WB
averageExpensesOnMP number · double Нет Средний расход по продаже на МП на 1 ед товара(берутся все расходы на МП по товару)
compensationForLostItemOnWb number · double Нет Компенсация за утерянный товар от WB
productAmountSum number · double Нет Поле productAmountSum.
totalSalesAmountPositiveSum number · double Нет Поле totalSalesAmountPositiveSum.
grossProfitPositiveSum number · double Нет Поле grossProfitPositiveSum.
acceptance number · double Нет Платная приёмка
cancelsCount integer · int64 Нет Количество отмен
ymBonus number · double Нет Баллы YM
id integer · int64 Нет Идентификатор
orgName string Нет Название организации
organizationId integer · int64 Нет Идентификатор организации
organizationIds string Нет ID организаций через запятую (заполняется при агрегации нескольких организаций)
orgNames string Нет Названия организаций через запятую (заполняется при агрегации нескольких организаций)
reportNumber string Нет Номер отчета
dateStart string · date-time Нет Дата начала отчета по реализации
dateEnd string · date-time Нет Дата конца отчета по реализации
logisticToClientAmount number · double Нет Стоимость логистики к клиенту в руб.
logisticFromClientAmount number · double Нет Стоимость логистики от клиента в руб.
salesCommission number · double Нет Комиссия от продажи в руб.
returnsCommission number · double Нет Возврат комиссии в руб.
intersettlements number · double Нет Взаиморасчёты с маркетплейсом в руб.
profit number · double Нет Чистая прибыль в руб. grossProfit - fixedOutlay - taxes + income
profitClear number · double Нет Чистая прибыль без учета постоянных расходов и доп. доходов в руб. grossProfit - taxes
bankPayment number · double Нет Оплата по банку в руб.
costPrice number · double Нет Себестоимость товара в руб. purchasePrice * salesCount
fixedOutlay number · double Нет Постоянные расходы в руб.(Расходы за весь интервал / кол-во дней в месяце)*на выбранный интервал, если период захватывает больше одного месяца, будет вычисляться для каждого месяца, а после складываться, в случае нескольких отчетах для организации, то будет по каждому отчету браться по коэфициенту продаж
taxes number · double Нет Налоги в руб.
taxableRevenue number · double Нет Налоговая база в руб., использованная для расчета налогов
sellingCosts number · double Нет Затраты по продаже на МП. getLogistics() + getCommissions() + getIntersettlements() + getPenalty() + getServices() - getAdditionalAndDeduction() - getOtherAmount() + getCostStorage()
rentability number · double Нет Рентабельность. (profit / totalSalesAmount) * 100
taxRate number · double Нет Процентная ставка налога
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Тип налогообложения
totalCampaignCost number · double Нет Стоимость рекламы сумма
ozonCampaignCost number · double Нет Реклама Озон
ozonBonus number · double Нет Баллы Ozon
basicExpenses number · double Нет Сумма основных расходов: комиссия + логистика + себестоимость
otherExpenses number · double Нет Сумма прочих расходов: платная приемка + прочие удержания + прочие начисления + хранения + доплаты
additionalExpenses number · double Нет Сумма дополнительных расходов: реклама + услуги + штрафы + сумма прочих расходов
ozonDeliveryReturn number · double Нет Перечисление за доставку от покупателя, должно идти в прибыль
emptyPurchaseAmount integer · int64 Нет Сумма продаж, для которых не указана закупочная цена
inputVat number · double Нет Входящий НДС, руб.
outputVat number · double Нет Исходящий НДС, руб.
finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.
incomeTax number · double Нет Налог на прибыль, руб.
totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.
income number · double Нет Прочие доходы
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 Нет Маркетплейс (OZON, WILDBERRIES, YANDEX_MARKET и т.д.)
serviceId integer · int32 Нет Поле serviceId.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа строки: розница, опт или пусто для маркетплейсов
orderTypeId integer · int32 Нет Идентификатор типа заказа из profit_report.order_type_id
previousFinancesReportByPeriod FindResponseFinanceReport Нет Поле previousFinancesReportByPeriod.
Поля объекта FindResponseFinanceReport
ПолеТипОбязательноОписание
rows FinanceReport[] Нет Строки с результатом поиска
Структура элемента массива FinanceReport
ПолеТипОбязательноОписание
shortName string Нет Сокращенное название организации.
categoryName string Нет Название категории.
brandName string Нет Название бренда.
name string Нет Название товара
modelName string Нет Название модели
viewWildberriesId integer · int64 Нет Карточка Wildberries
article string Нет Артикул
serviceArticle string Нет Артикул на маркетплейсе
color string Нет Цвет товара.
size string Нет Размер товара.
barcode string Нет Шк товара.
purchasePrice number · double Нет Закупочная цена.
createdDate string · date-time Нет Дата создания карточки.
isDuplicate boolean Нет Признак дубликата карточки.
dateKey string Нет Ключ по дате.
salesCount integer · int64 Нет Продажи в шт.
salesCountConventional number · double Нет Продажи в у.е.
returnsCount integer · int64 Нет Возвраты в шт.
returnsCountConventional number · double Нет Возвраты в у.е.
totalSalesCount integer · int64 Нет Разница между продажами и возвратами в шт. salesCount - returnsCount
totalSalesCountConventional number · double Нет Разница между продажами и возвратами в у.е.
salesAmount number · double Нет Продажи в руб.
returnsAmount number · double Нет Возвраты в руб.
averageReturnsAmount number · double Нет Возвраты в руб. за 1 ед
totalSalesAmount number · double Нет Разница между продажами и возвратами в руб. salesAmount - returnsAmount
orderAmount number · double Нет Заказы в руб.
orderAmountWithoutCancel number · double Нет Заказы в руб. без отмен
logistics number · double Нет Логистика в руб.
averageLogistics number · double Нет Средняя логистика в руб.
logisticsShare number · double Нет Доля логистики в структуре выручки, %
commissions number · double Нет Комиссия в руб.
acquiring number · double Нет Эквайринг в руб.
averageCommissions number · double Нет Средняя комиссия в руб.
penalty number · double Нет Штрафы в руб.
additional number · double Нет Доплаты в руб.
refundsAndCancellations number · double Нет Возвраты и отмены в руб.
compensationAmount number · double Нет Компенсации в руб.
additionalAndDeduction number · double Нет Доплаты и удержания в руб. в файле финансах ячейка Доплаты
services number · double Нет Услуги в руб.
drr number · double Нет ДРР по выкупам, %: расходы на рекламу / чистая выручка * 100
drrByOrders number · double Нет ДРР Wildberries по рекламным заказам, %: расходы на рекламу / сумма рекламных заказов * 100
advertisingOrdersAmount number · double Нет Сумма рекламных заказов Wildberries, руб.
totalToBePaid number · double Нет Итого к оплате с учётом выручки, расходов, доплат и удержаний
averageToBePaid number · double Нет Итого к оплате за 1 товар.
productCount integer · int64 Нет Товарный остаток FBS + FBO на текущий момент.
salesAmountInPurchasePrice number · double Нет Проданный товар в закупочных ценах, руб.
productAmount number · double Нет Сумма по товарному остатку purchasePrice * productCount
averageSellingPrice number · double Нет Средняя фактическая цена продажи
markUp number · double Нет Фактическая наценка totalToBePaid / (purchasePrice * totalSalesCount)
margin number · double Нет Маржинальность
grossProfit number · double Нет Валовая прибыль totalToBePaid - totalSalesCount * purchasePrice - selPayAmount
averageGrossProfit number · double Нет Валовая прибыль за 1 ед.
ratioInIncome number · double Нет Доля в выручке
rationInGrossProfit number · double Нет Доля в валовой прибыли в % grossProfit / SUM(grossProfit)
ratioInProductCount number · double Нет Доля в товарном остатке в % productAmount / SUM(productAmount)
efficiencyForIncome number · double Нет Эффективность по выручке ratioInIncome / ratioInProductCount
grossProfitEfficiency number · double Нет Эффективность по валовой прибыли rationInGrossProfit / ratioInProductCount
averageExpenses number · double Нет Средний расходов по продаже на МП на 1 ед товара, руб. все расходы в руб / продажи - возвраты в шт
otherAmount number · double Нет Прочие начисления, руб.
percentRedemption number · double Нет Процент выкупа. Продажи/(Продажи+Возвраты)*100 только для ВБ
orderCount integer · int64 Нет Кол-во заказов в шт.
orderCountWithoutCancel integer · int64 Нет Кол-во заказов в шт. без отмен
nonPurchasePriceCount integer · int64 Нет Кол-во profitRepot где не указана закупочная цена, шт.
selfPayCount integer · int64 Нет Кол-во самовыкупов, шт.
selfPayAmount number · double Нет Сумма самовыкупов, руб.
costStorage number · double Нет Сумма за хранения товара на МП, получаем только по ВБ через импорт файла.
campaignCost number · double Нет Стоимость рекламы ВБ
externalCampaignCost number · double Нет Стоимость внешней рекламы
wbSpp number · double Нет СПП: скидка постоянного покупателя на ВБ + баллы Ozon
salesAmountBeforeSpp number · double Нет Выручка до применения СПП с учетом возвратов, руб. Только ВБ. Рассчитывается как выручка + СПП
wbTotalSalesByPriceWithDisc number · double Нет Сумма продажи ВБ, по цене со скидкой продажи - возвраты
otherDeductions number · double Нет Прочие удержания WB
averageExpensesOnMP number · double Нет Средний расход по продаже на МП на 1 ед товара(берутся все расходы на МП по товару)
compensationForLostItemOnWb number · double Нет Компенсация за утерянный товар от WB
productAmountSum number · double Нет Поле productAmountSum.
totalSalesAmountPositiveSum number · double Нет Поле totalSalesAmountPositiveSum.
grossProfitPositiveSum number · double Нет Поле grossProfitPositiveSum.
acceptance number · double Нет Платная приёмка
cancelsCount integer · int64 Нет Количество отмен
ymBonus number · double Нет Баллы YM
id integer · int64 Нет Идентификатор
orgName string Нет Название организации
organizationId integer · int64 Нет Идентификатор организации
organizationIds string Нет ID организаций через запятую (заполняется при агрегации нескольких организаций)
orgNames string Нет Названия организаций через запятую (заполняется при агрегации нескольких организаций)
reportNumber string Нет Номер отчета
dateStart string · date-time Нет Дата начала отчета по реализации
dateEnd string · date-time Нет Дата конца отчета по реализации
logisticToClientAmount number · double Нет Стоимость логистики к клиенту в руб.
logisticFromClientAmount number · double Нет Стоимость логистики от клиента в руб.
salesCommission number · double Нет Комиссия от продажи в руб.
returnsCommission number · double Нет Возврат комиссии в руб.
intersettlements number · double Нет Взаиморасчёты с маркетплейсом в руб.
profit number · double Нет Чистая прибыль в руб. grossProfit - fixedOutlay - taxes + income
profitClear number · double Нет Чистая прибыль без учета постоянных расходов и доп. доходов в руб. grossProfit - taxes
bankPayment number · double Нет Оплата по банку в руб.
costPrice number · double Нет Себестоимость товара в руб. purchasePrice * salesCount
fixedOutlay number · double Нет Постоянные расходы в руб.(Расходы за весь интервал / кол-во дней в месяце)*на выбранный интервал, если период захватывает больше одного месяца, будет вычисляться для каждого месяца, а после складываться, в случае нескольких отчетах для организации, то будет по каждому отчету браться по коэфициенту продаж
taxes number · double Нет Налоги в руб.
taxableRevenue number · double Нет Налоговая база в руб., использованная для расчета налогов
sellingCosts number · double Нет Затраты по продаже на МП. getLogistics() + getCommissions() + getIntersettlements() + getPenalty() + getServices() - getAdditionalAndDeduction() - getOtherAmount() + getCostStorage()
rentability number · double Нет Рентабельность. (profit / totalSalesAmount) * 100
taxRate number · double Нет Процентная ставка налога
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Тип налогообложения
totalCampaignCost number · double Нет Стоимость рекламы сумма
ozonCampaignCost number · double Нет Реклама Озон
ozonBonus number · double Нет Баллы Ozon
basicExpenses number · double Нет Сумма основных расходов: комиссия + логистика + себестоимость
otherExpenses number · double Нет Сумма прочих расходов: платная приемка + прочие удержания + прочие начисления + хранения + доплаты
additionalExpenses number · double Нет Сумма дополнительных расходов: реклама + услуги + штрафы + сумма прочих расходов
ozonDeliveryReturn number · double Нет Перечисление за доставку от покупателя, должно идти в прибыль
emptyPurchaseAmount integer · int64 Нет Сумма продаж, для которых не указана закупочная цена
inputVat number · double Нет Входящий НДС, руб.
outputVat number · double Нет Исходящий НДС, руб.
finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.
incomeTax number · double Нет Налог на прибыль, руб.
totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.
income number · double Нет Прочие доходы
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 Нет Маркетплейс (OZON, WILDBERRIES, YANDEX_MARKET и т.д.)
serviceId integer · int32 Нет Поле serviceId.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа строки: розница, опт или пусто для маркетплейсов
orderTypeId integer · int32 Нет Идентификатор типа заказа из profit_report.order_type_id
purchasePercent number · double Нет Процент выкупа за выбранный период с учетом фильтров отчета
financesReportByPeriodByOrg FinanceReport[] Нет Разбивка финансового отчёта по организациям и периодам, одна строка = одна организация в одном периоде (dateKey + organizationId). Заполняется только когда выбрано несколько организаций. Итоговые строки здесь не добавляются
Структура элемента массива FinanceReport
ПолеТипОбязательноОписание
shortName string Нет Сокращенное название организации.
categoryName string Нет Название категории.
brandName string Нет Название бренда.
name string Нет Название товара
modelName string Нет Название модели
viewWildberriesId integer · int64 Нет Карточка Wildberries
article string Нет Артикул
serviceArticle string Нет Артикул на маркетплейсе
color string Нет Цвет товара.
size string Нет Размер товара.
barcode string Нет Шк товара.
purchasePrice number · double Нет Закупочная цена.
createdDate string · date-time Нет Дата создания карточки.
isDuplicate boolean Нет Признак дубликата карточки.
dateKey string Нет Ключ по дате.
salesCount integer · int64 Нет Продажи в шт.
salesCountConventional number · double Нет Продажи в у.е.
returnsCount integer · int64 Нет Возвраты в шт.
returnsCountConventional number · double Нет Возвраты в у.е.
totalSalesCount integer · int64 Нет Разница между продажами и возвратами в шт. salesCount - returnsCount
totalSalesCountConventional number · double Нет Разница между продажами и возвратами в у.е.
salesAmount number · double Нет Продажи в руб.
returnsAmount number · double Нет Возвраты в руб.
averageReturnsAmount number · double Нет Возвраты в руб. за 1 ед
totalSalesAmount number · double Нет Разница между продажами и возвратами в руб. salesAmount - returnsAmount
orderAmount number · double Нет Заказы в руб.
orderAmountWithoutCancel number · double Нет Заказы в руб. без отмен
logistics number · double Нет Логистика в руб.
averageLogistics number · double Нет Средняя логистика в руб.
logisticsShare number · double Нет Доля логистики в структуре выручки, %
commissions number · double Нет Комиссия в руб.
acquiring number · double Нет Эквайринг в руб.
averageCommissions number · double Нет Средняя комиссия в руб.
penalty number · double Нет Штрафы в руб.
additional number · double Нет Доплаты в руб.
refundsAndCancellations number · double Нет Возвраты и отмены в руб.
compensationAmount number · double Нет Компенсации в руб.
additionalAndDeduction number · double Нет Доплаты и удержания в руб. в файле финансах ячейка Доплаты
services number · double Нет Услуги в руб.
drr number · double Нет ДРР по выкупам, %: расходы на рекламу / чистая выручка * 100
drrByOrders number · double Нет ДРР Wildberries по рекламным заказам, %: расходы на рекламу / сумма рекламных заказов * 100
advertisingOrdersAmount number · double Нет Сумма рекламных заказов Wildberries, руб.
totalToBePaid number · double Нет Итого к оплате с учётом выручки, расходов, доплат и удержаний
averageToBePaid number · double Нет Итого к оплате за 1 товар.
productCount integer · int64 Нет Товарный остаток FBS + FBO на текущий момент.
salesAmountInPurchasePrice number · double Нет Проданный товар в закупочных ценах, руб.
productAmount number · double Нет Сумма по товарному остатку purchasePrice * productCount
averageSellingPrice number · double Нет Средняя фактическая цена продажи
markUp number · double Нет Фактическая наценка totalToBePaid / (purchasePrice * totalSalesCount)
margin number · double Нет Маржинальность
grossProfit number · double Нет Валовая прибыль totalToBePaid - totalSalesCount * purchasePrice - selPayAmount
averageGrossProfit number · double Нет Валовая прибыль за 1 ед.
ratioInIncome number · double Нет Доля в выручке
rationInGrossProfit number · double Нет Доля в валовой прибыли в % grossProfit / SUM(grossProfit)
ratioInProductCount number · double Нет Доля в товарном остатке в % productAmount / SUM(productAmount)
efficiencyForIncome number · double Нет Эффективность по выручке ratioInIncome / ratioInProductCount
grossProfitEfficiency number · double Нет Эффективность по валовой прибыли rationInGrossProfit / ratioInProductCount
averageExpenses number · double Нет Средний расходов по продаже на МП на 1 ед товара, руб. все расходы в руб / продажи - возвраты в шт
otherAmount number · double Нет Прочие начисления, руб.
percentRedemption number · double Нет Процент выкупа. Продажи/(Продажи+Возвраты)*100 только для ВБ
orderCount integer · int64 Нет Кол-во заказов в шт.
orderCountWithoutCancel integer · int64 Нет Кол-во заказов в шт. без отмен
nonPurchasePriceCount integer · int64 Нет Кол-во profitRepot где не указана закупочная цена, шт.
selfPayCount integer · int64 Нет Кол-во самовыкупов, шт.
selfPayAmount number · double Нет Сумма самовыкупов, руб.
costStorage number · double Нет Сумма за хранения товара на МП, получаем только по ВБ через импорт файла.
campaignCost number · double Нет Стоимость рекламы ВБ
externalCampaignCost number · double Нет Стоимость внешней рекламы
wbSpp number · double Нет СПП: скидка постоянного покупателя на ВБ + баллы Ozon
salesAmountBeforeSpp number · double Нет Выручка до применения СПП с учетом возвратов, руб. Только ВБ. Рассчитывается как выручка + СПП
wbTotalSalesByPriceWithDisc number · double Нет Сумма продажи ВБ, по цене со скидкой продажи - возвраты
otherDeductions number · double Нет Прочие удержания WB
averageExpensesOnMP number · double Нет Средний расход по продаже на МП на 1 ед товара(берутся все расходы на МП по товару)
compensationForLostItemOnWb number · double Нет Компенсация за утерянный товар от WB
productAmountSum number · double Нет Поле productAmountSum.
totalSalesAmountPositiveSum number · double Нет Поле totalSalesAmountPositiveSum.
grossProfitPositiveSum number · double Нет Поле grossProfitPositiveSum.
acceptance number · double Нет Платная приёмка
cancelsCount integer · int64 Нет Количество отмен
ymBonus number · double Нет Баллы YM
id integer · int64 Нет Идентификатор
orgName string Нет Название организации
organizationId integer · int64 Нет Идентификатор организации
organizationIds string Нет ID организаций через запятую (заполняется при агрегации нескольких организаций)
orgNames string Нет Названия организаций через запятую (заполняется при агрегации нескольких организаций)
reportNumber string Нет Номер отчета
dateStart string · date-time Нет Дата начала отчета по реализации
dateEnd string · date-time Нет Дата конца отчета по реализации
logisticToClientAmount number · double Нет Стоимость логистики к клиенту в руб.
logisticFromClientAmount number · double Нет Стоимость логистики от клиента в руб.
salesCommission number · double Нет Комиссия от продажи в руб.
returnsCommission number · double Нет Возврат комиссии в руб.
intersettlements number · double Нет Взаиморасчёты с маркетплейсом в руб.
profit number · double Нет Чистая прибыль в руб. grossProfit - fixedOutlay - taxes + income
profitClear number · double Нет Чистая прибыль без учета постоянных расходов и доп. доходов в руб. grossProfit - taxes
bankPayment number · double Нет Оплата по банку в руб.
costPrice number · double Нет Себестоимость товара в руб. purchasePrice * salesCount
fixedOutlay number · double Нет Постоянные расходы в руб.(Расходы за весь интервал / кол-во дней в месяце)*на выбранный интервал, если период захватывает больше одного месяца, будет вычисляться для каждого месяца, а после складываться, в случае нескольких отчетах для организации, то будет по каждому отчету браться по коэфициенту продаж
taxes number · double Нет Налоги в руб.
taxableRevenue number · double Нет Налоговая база в руб., использованная для расчета налогов
sellingCosts number · double Нет Затраты по продаже на МП. getLogistics() + getCommissions() + getIntersettlements() + getPenalty() + getServices() - getAdditionalAndDeduction() - getOtherAmount() + getCostStorage()
rentability number · double Нет Рентабельность. (profit / totalSalesAmount) * 100
taxRate number · double Нет Процентная ставка налога
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Тип налогообложения
totalCampaignCost number · double Нет Стоимость рекламы сумма
ozonCampaignCost number · double Нет Реклама Озон
ozonBonus number · double Нет Баллы Ozon
basicExpenses number · double Нет Сумма основных расходов: комиссия + логистика + себестоимость
otherExpenses number · double Нет Сумма прочих расходов: платная приемка + прочие удержания + прочие начисления + хранения + доплаты
additionalExpenses number · double Нет Сумма дополнительных расходов: реклама + услуги + штрафы + сумма прочих расходов
ozonDeliveryReturn number · double Нет Перечисление за доставку от покупателя, должно идти в прибыль
emptyPurchaseAmount integer · int64 Нет Сумма продаж, для которых не указана закупочная цена
inputVat number · double Нет Входящий НДС, руб.
outputVat number · double Нет Исходящий НДС, руб.
finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.
incomeTax number · double Нет Налог на прибыль, руб.
totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.
income number · double Нет Прочие доходы
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 Нет Маркетплейс (OZON, WILDBERRIES, YANDEX_MARKET и т.д.)
serviceId integer · int32 Нет Поле serviceId.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа строки: розница, опт или пусто для маркетплейсов
orderTypeId integer · int32 Нет Идентификатор типа заказа из profit_report.order_type_id
previousFinancesReportByPeriodByOrg FinanceReport[] Нет Поле previousFinancesReportByPeriodByOrg.
Структура элемента массива FinanceReport
ПолеТипОбязательноОписание
shortName string Нет Сокращенное название организации.
categoryName string Нет Название категории.
brandName string Нет Название бренда.
name string Нет Название товара
modelName string Нет Название модели
viewWildberriesId integer · int64 Нет Карточка Wildberries
article string Нет Артикул
serviceArticle string Нет Артикул на маркетплейсе
color string Нет Цвет товара.
size string Нет Размер товара.
barcode string Нет Шк товара.
purchasePrice number · double Нет Закупочная цена.
createdDate string · date-time Нет Дата создания карточки.
isDuplicate boolean Нет Признак дубликата карточки.
dateKey string Нет Ключ по дате.
salesCount integer · int64 Нет Продажи в шт.
salesCountConventional number · double Нет Продажи в у.е.
returnsCount integer · int64 Нет Возвраты в шт.
returnsCountConventional number · double Нет Возвраты в у.е.
totalSalesCount integer · int64 Нет Разница между продажами и возвратами в шт. salesCount - returnsCount
totalSalesCountConventional number · double Нет Разница между продажами и возвратами в у.е.
salesAmount number · double Нет Продажи в руб.
returnsAmount number · double Нет Возвраты в руб.
averageReturnsAmount number · double Нет Возвраты в руб. за 1 ед
totalSalesAmount number · double Нет Разница между продажами и возвратами в руб. salesAmount - returnsAmount
orderAmount number · double Нет Заказы в руб.
orderAmountWithoutCancel number · double Нет Заказы в руб. без отмен
logistics number · double Нет Логистика в руб.
averageLogistics number · double Нет Средняя логистика в руб.
logisticsShare number · double Нет Доля логистики в структуре выручки, %
commissions number · double Нет Комиссия в руб.
acquiring number · double Нет Эквайринг в руб.
averageCommissions number · double Нет Средняя комиссия в руб.
penalty number · double Нет Штрафы в руб.
additional number · double Нет Доплаты в руб.
refundsAndCancellations number · double Нет Возвраты и отмены в руб.
compensationAmount number · double Нет Компенсации в руб.
additionalAndDeduction number · double Нет Доплаты и удержания в руб. в файле финансах ячейка Доплаты
services number · double Нет Услуги в руб.
drr number · double Нет ДРР по выкупам, %: расходы на рекламу / чистая выручка * 100
drrByOrders number · double Нет ДРР Wildberries по рекламным заказам, %: расходы на рекламу / сумма рекламных заказов * 100
advertisingOrdersAmount number · double Нет Сумма рекламных заказов Wildberries, руб.
totalToBePaid number · double Нет Итого к оплате с учётом выручки, расходов, доплат и удержаний
averageToBePaid number · double Нет Итого к оплате за 1 товар.
productCount integer · int64 Нет Товарный остаток FBS + FBO на текущий момент.
salesAmountInPurchasePrice number · double Нет Проданный товар в закупочных ценах, руб.
productAmount number · double Нет Сумма по товарному остатку purchasePrice * productCount
averageSellingPrice number · double Нет Средняя фактическая цена продажи
markUp number · double Нет Фактическая наценка totalToBePaid / (purchasePrice * totalSalesCount)
margin number · double Нет Маржинальность
grossProfit number · double Нет Валовая прибыль totalToBePaid - totalSalesCount * purchasePrice - selPayAmount
averageGrossProfit number · double Нет Валовая прибыль за 1 ед.
ratioInIncome number · double Нет Доля в выручке
rationInGrossProfit number · double Нет Доля в валовой прибыли в % grossProfit / SUM(grossProfit)
ratioInProductCount number · double Нет Доля в товарном остатке в % productAmount / SUM(productAmount)
efficiencyForIncome number · double Нет Эффективность по выручке ratioInIncome / ratioInProductCount
grossProfitEfficiency number · double Нет Эффективность по валовой прибыли rationInGrossProfit / ratioInProductCount
averageExpenses number · double Нет Средний расходов по продаже на МП на 1 ед товара, руб. все расходы в руб / продажи - возвраты в шт
otherAmount number · double Нет Прочие начисления, руб.
percentRedemption number · double Нет Процент выкупа. Продажи/(Продажи+Возвраты)*100 только для ВБ
orderCount integer · int64 Нет Кол-во заказов в шт.
orderCountWithoutCancel integer · int64 Нет Кол-во заказов в шт. без отмен
nonPurchasePriceCount integer · int64 Нет Кол-во profitRepot где не указана закупочная цена, шт.
selfPayCount integer · int64 Нет Кол-во самовыкупов, шт.
selfPayAmount number · double Нет Сумма самовыкупов, руб.
costStorage number · double Нет Сумма за хранения товара на МП, получаем только по ВБ через импорт файла.
campaignCost number · double Нет Стоимость рекламы ВБ
externalCampaignCost number · double Нет Стоимость внешней рекламы
wbSpp number · double Нет СПП: скидка постоянного покупателя на ВБ + баллы Ozon
salesAmountBeforeSpp number · double Нет Выручка до применения СПП с учетом возвратов, руб. Только ВБ. Рассчитывается как выручка + СПП
wbTotalSalesByPriceWithDisc number · double Нет Сумма продажи ВБ, по цене со скидкой продажи - возвраты
otherDeductions number · double Нет Прочие удержания WB
averageExpensesOnMP number · double Нет Средний расход по продаже на МП на 1 ед товара(берутся все расходы на МП по товару)
compensationForLostItemOnWb number · double Нет Компенсация за утерянный товар от WB
productAmountSum number · double Нет Поле productAmountSum.
totalSalesAmountPositiveSum number · double Нет Поле totalSalesAmountPositiveSum.
grossProfitPositiveSum number · double Нет Поле grossProfitPositiveSum.
acceptance number · double Нет Платная приёмка
cancelsCount integer · int64 Нет Количество отмен
ymBonus number · double Нет Баллы YM
id integer · int64 Нет Идентификатор
orgName string Нет Название организации
organizationId integer · int64 Нет Идентификатор организации
organizationIds string Нет ID организаций через запятую (заполняется при агрегации нескольких организаций)
orgNames string Нет Названия организаций через запятую (заполняется при агрегации нескольких организаций)
reportNumber string Нет Номер отчета
dateStart string · date-time Нет Дата начала отчета по реализации
dateEnd string · date-time Нет Дата конца отчета по реализации
logisticToClientAmount number · double Нет Стоимость логистики к клиенту в руб.
logisticFromClientAmount number · double Нет Стоимость логистики от клиента в руб.
salesCommission number · double Нет Комиссия от продажи в руб.
returnsCommission number · double Нет Возврат комиссии в руб.
intersettlements number · double Нет Взаиморасчёты с маркетплейсом в руб.
profit number · double Нет Чистая прибыль в руб. grossProfit - fixedOutlay - taxes + income
profitClear number · double Нет Чистая прибыль без учета постоянных расходов и доп. доходов в руб. grossProfit - taxes
bankPayment number · double Нет Оплата по банку в руб.
costPrice number · double Нет Себестоимость товара в руб. purchasePrice * salesCount
fixedOutlay number · double Нет Постоянные расходы в руб.(Расходы за весь интервал / кол-во дней в месяце)*на выбранный интервал, если период захватывает больше одного месяца, будет вычисляться для каждого месяца, а после складываться, в случае нескольких отчетах для организации, то будет по каждому отчету браться по коэфициенту продаж
taxes number · double Нет Налоги в руб.
taxableRevenue number · double Нет Налоговая база в руб., использованная для расчета налогов
sellingCosts number · double Нет Затраты по продаже на МП. getLogistics() + getCommissions() + getIntersettlements() + getPenalty() + getServices() - getAdditionalAndDeduction() - getOtherAmount() + getCostStorage()
rentability number · double Нет Рентабельность. (profit / totalSalesAmount) * 100
taxRate number · double Нет Процентная ставка налога
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Тип налогообложения
totalCampaignCost number · double Нет Стоимость рекламы сумма
ozonCampaignCost number · double Нет Реклама Озон
ozonBonus number · double Нет Баллы Ozon
basicExpenses number · double Нет Сумма основных расходов: комиссия + логистика + себестоимость
otherExpenses number · double Нет Сумма прочих расходов: платная приемка + прочие удержания + прочие начисления + хранения + доплаты
additionalExpenses number · double Нет Сумма дополнительных расходов: реклама + услуги + штрафы + сумма прочих расходов
ozonDeliveryReturn number · double Нет Перечисление за доставку от покупателя, должно идти в прибыль
emptyPurchaseAmount integer · int64 Нет Сумма продаж, для которых не указана закупочная цена
inputVat number · double Нет Входящий НДС, руб.
outputVat number · double Нет Исходящий НДС, руб.
finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.
incomeTax number · double Нет Налог на прибыль, руб.
totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.
income number · double Нет Прочие доходы
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 Нет Маркетплейс (OZON, WILDBERRIES, YANDEX_MARKET и т.д.)
serviceId integer · int32 Нет Поле serviceId.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа строки: розница, опт или пусто для маркетплейсов
orderTypeId integer · int32 Нет Идентификатор типа заказа из profit_report.order_type_id
financesReportTotalByOrg FinanceReport[] Нет Итоги финансового отчёта по организациям за весь интервал. Одна строка = итог по одной организации за весь выбранный интервал. Заполняется только когда выбрано несколько организаций
Структура элемента массива FinanceReport
ПолеТипОбязательноОписание
shortName string Нет Сокращенное название организации.
categoryName string Нет Название категории.
brandName string Нет Название бренда.
name string Нет Название товара
modelName string Нет Название модели
viewWildberriesId integer · int64 Нет Карточка Wildberries
article string Нет Артикул
serviceArticle string Нет Артикул на маркетплейсе
color string Нет Цвет товара.
size string Нет Размер товара.
barcode string Нет Шк товара.
purchasePrice number · double Нет Закупочная цена.
createdDate string · date-time Нет Дата создания карточки.
isDuplicate boolean Нет Признак дубликата карточки.
dateKey string Нет Ключ по дате.
salesCount integer · int64 Нет Продажи в шт.
salesCountConventional number · double Нет Продажи в у.е.
returnsCount integer · int64 Нет Возвраты в шт.
returnsCountConventional number · double Нет Возвраты в у.е.
totalSalesCount integer · int64 Нет Разница между продажами и возвратами в шт. salesCount - returnsCount
totalSalesCountConventional number · double Нет Разница между продажами и возвратами в у.е.
salesAmount number · double Нет Продажи в руб.
returnsAmount number · double Нет Возвраты в руб.
averageReturnsAmount number · double Нет Возвраты в руб. за 1 ед
totalSalesAmount number · double Нет Разница между продажами и возвратами в руб. salesAmount - returnsAmount
orderAmount number · double Нет Заказы в руб.
orderAmountWithoutCancel number · double Нет Заказы в руб. без отмен
logistics number · double Нет Логистика в руб.
averageLogistics number · double Нет Средняя логистика в руб.
logisticsShare number · double Нет Доля логистики в структуре выручки, %
commissions number · double Нет Комиссия в руб.
acquiring number · double Нет Эквайринг в руб.
averageCommissions number · double Нет Средняя комиссия в руб.
penalty number · double Нет Штрафы в руб.
additional number · double Нет Доплаты в руб.
refundsAndCancellations number · double Нет Возвраты и отмены в руб.
compensationAmount number · double Нет Компенсации в руб.
additionalAndDeduction number · double Нет Доплаты и удержания в руб. в файле финансах ячейка Доплаты
services number · double Нет Услуги в руб.
drr number · double Нет ДРР по выкупам, %: расходы на рекламу / чистая выручка * 100
drrByOrders number · double Нет ДРР Wildberries по рекламным заказам, %: расходы на рекламу / сумма рекламных заказов * 100
advertisingOrdersAmount number · double Нет Сумма рекламных заказов Wildberries, руб.
totalToBePaid number · double Нет Итого к оплате с учётом выручки, расходов, доплат и удержаний
averageToBePaid number · double Нет Итого к оплате за 1 товар.
productCount integer · int64 Нет Товарный остаток FBS + FBO на текущий момент.
salesAmountInPurchasePrice number · double Нет Проданный товар в закупочных ценах, руб.
productAmount number · double Нет Сумма по товарному остатку purchasePrice * productCount
averageSellingPrice number · double Нет Средняя фактическая цена продажи
markUp number · double Нет Фактическая наценка totalToBePaid / (purchasePrice * totalSalesCount)
margin number · double Нет Маржинальность
grossProfit number · double Нет Валовая прибыль totalToBePaid - totalSalesCount * purchasePrice - selPayAmount
averageGrossProfit number · double Нет Валовая прибыль за 1 ед.
ratioInIncome number · double Нет Доля в выручке
rationInGrossProfit number · double Нет Доля в валовой прибыли в % grossProfit / SUM(grossProfit)
ratioInProductCount number · double Нет Доля в товарном остатке в % productAmount / SUM(productAmount)
efficiencyForIncome number · double Нет Эффективность по выручке ratioInIncome / ratioInProductCount
grossProfitEfficiency number · double Нет Эффективность по валовой прибыли rationInGrossProfit / ratioInProductCount
averageExpenses number · double Нет Средний расходов по продаже на МП на 1 ед товара, руб. все расходы в руб / продажи - возвраты в шт
otherAmount number · double Нет Прочие начисления, руб.
percentRedemption number · double Нет Процент выкупа. Продажи/(Продажи+Возвраты)*100 только для ВБ
orderCount integer · int64 Нет Кол-во заказов в шт.
orderCountWithoutCancel integer · int64 Нет Кол-во заказов в шт. без отмен
nonPurchasePriceCount integer · int64 Нет Кол-во profitRepot где не указана закупочная цена, шт.
selfPayCount integer · int64 Нет Кол-во самовыкупов, шт.
selfPayAmount number · double Нет Сумма самовыкупов, руб.
costStorage number · double Нет Сумма за хранения товара на МП, получаем только по ВБ через импорт файла.
campaignCost number · double Нет Стоимость рекламы ВБ
externalCampaignCost number · double Нет Стоимость внешней рекламы
wbSpp number · double Нет СПП: скидка постоянного покупателя на ВБ + баллы Ozon
salesAmountBeforeSpp number · double Нет Выручка до применения СПП с учетом возвратов, руб. Только ВБ. Рассчитывается как выручка + СПП
wbTotalSalesByPriceWithDisc number · double Нет Сумма продажи ВБ, по цене со скидкой продажи - возвраты
otherDeductions number · double Нет Прочие удержания WB
averageExpensesOnMP number · double Нет Средний расход по продаже на МП на 1 ед товара(берутся все расходы на МП по товару)
compensationForLostItemOnWb number · double Нет Компенсация за утерянный товар от WB
productAmountSum number · double Нет Поле productAmountSum.
totalSalesAmountPositiveSum number · double Нет Поле totalSalesAmountPositiveSum.
grossProfitPositiveSum number · double Нет Поле grossProfitPositiveSum.
acceptance number · double Нет Платная приёмка
cancelsCount integer · int64 Нет Количество отмен
ymBonus number · double Нет Баллы YM
id integer · int64 Нет Идентификатор
orgName string Нет Название организации
organizationId integer · int64 Нет Идентификатор организации
organizationIds string Нет ID организаций через запятую (заполняется при агрегации нескольких организаций)
orgNames string Нет Названия организаций через запятую (заполняется при агрегации нескольких организаций)
reportNumber string Нет Номер отчета
dateStart string · date-time Нет Дата начала отчета по реализации
dateEnd string · date-time Нет Дата конца отчета по реализации
logisticToClientAmount number · double Нет Стоимость логистики к клиенту в руб.
logisticFromClientAmount number · double Нет Стоимость логистики от клиента в руб.
salesCommission number · double Нет Комиссия от продажи в руб.
returnsCommission number · double Нет Возврат комиссии в руб.
intersettlements number · double Нет Взаиморасчёты с маркетплейсом в руб.
profit number · double Нет Чистая прибыль в руб. grossProfit - fixedOutlay - taxes + income
profitClear number · double Нет Чистая прибыль без учета постоянных расходов и доп. доходов в руб. grossProfit - taxes
bankPayment number · double Нет Оплата по банку в руб.
costPrice number · double Нет Себестоимость товара в руб. purchasePrice * salesCount
fixedOutlay number · double Нет Постоянные расходы в руб.(Расходы за весь интервал / кол-во дней в месяце)*на выбранный интервал, если период захватывает больше одного месяца, будет вычисляться для каждого месяца, а после складываться, в случае нескольких отчетах для организации, то будет по каждому отчету браться по коэфициенту продаж
taxes number · double Нет Налоги в руб.
taxableRevenue number · double Нет Налоговая база в руб., использованная для расчета налогов
sellingCosts number · double Нет Затраты по продаже на МП. getLogistics() + getCommissions() + getIntersettlements() + getPenalty() + getServices() - getAdditionalAndDeduction() - getOtherAmount() + getCostStorage()
rentability number · double Нет Рентабельность. (profit / totalSalesAmount) * 100
taxRate number · double Нет Процентная ставка налога
taxType stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED Нет Тип налогообложения
totalCampaignCost number · double Нет Стоимость рекламы сумма
ozonCampaignCost number · double Нет Реклама Озон
ozonBonus number · double Нет Баллы Ozon
basicExpenses number · double Нет Сумма основных расходов: комиссия + логистика + себестоимость
otherExpenses number · double Нет Сумма прочих расходов: платная приемка + прочие удержания + прочие начисления + хранения + доплаты
additionalExpenses number · double Нет Сумма дополнительных расходов: реклама + услуги + штрафы + сумма прочих расходов
ozonDeliveryReturn number · double Нет Перечисление за доставку от покупателя, должно идти в прибыль
emptyPurchaseAmount integer · int64 Нет Сумма продаж, для которых не указана закупочная цена
inputVat number · double Нет Входящий НДС, руб.
outputVat number · double Нет Исходящий НДС, руб.
finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.
incomeTax number · double Нет Налог на прибыль, руб.
totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.
income number · double Нет Прочие доходы
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 Нет Маркетплейс (OZON, WILDBERRIES, YANDEX_MARKET и т.д.)
serviceId integer · int32 Нет Поле serviceId.
orderType stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа строки: розница, опт или пусто для маркетплейсов
orderTypeId integer · int32 Нет Идентификатор типа заказа из profit_report.order_type_id
commonFixedOutlay number · double Нет Поле commonFixedOutlay.
curl --request POST 'https://api.selsup.ru/api/findir/ai/tips' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "salesExpensesOnMarketplaces": "string",
  "costStructure": "string",
  "profitStructure": "string",
  "penaltyStructure": "string",
  "serviceStructure": "string",
  "financesReportByPeriod": "string"
}'

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

200
Структура элемента массива Tip[]
ПолеТипОбязательноОписание
type stringWARN, INFO, ACHIEVEMENTS, REVENUE, PROFIT, LOGISTICS, PENALTY, PROBLEMATIC, LOW_PURCHASE_PERCENT, UNPROFITABLE_PRODUCTS, LOW_MARGIN, NEGATIVE_MARGIN, FBO_LOW_STOCK, LOW_PHOTO_COUNT, CLOTHING_WITHOUT_MODEL, PHOTO_RECOMMENDATIONS, PRODUCT_PHOTO_ANALYZED, HIGH_DRR, LOW_CTR, EMPTY_VIDEO, CONVERSION_TO_ORDER_OR_CART_DECREASED, LOW_RATING, HIGH_STORAGE_COSTS Нет Поле type.
title string Нет Поле title.
description string Нет Поле description.
value number · double Нет Поле value.
[
  "string"
]
Ошибки11

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

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

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

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

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

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

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

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

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

400error_deepseek_dont_answer
DeepSeek не отвечает на запрос. Возможно у них временные проблемы, попробуйте повторить запрос позже

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

400error_findir_data_not_found
Запись о проблеме Финдир не найдена

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

400error_findir_tips_generation_failed
Ошибка при генерации рекомендаций через DeepSeek. Возможно у них временные проблемы, попробуйте повторить запрос позже

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

400error_hash_calculation_failed
Не удалось вычислить хэш

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

400error_max_page
Номер страницы не может быть больше 100 000

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

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

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

400error_subscription_expired
У вас закончился срок действия тарифа. Оплатите тариф для продолжения использования сервиса.

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

PATCH

Смена статуса проблемы

/api/findir/tip/{id}/status
Токен с правами записи

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

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

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

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

ПолеТипОбязательноОписание
tipStatus stringNEW, PROCESSING, CLOSED Да Поле tipStatus.
curl --request PATCH 'https://api.selsup.ru/api/findir/tip/1001/status?tipStatus=NEW' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта FindirData
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
productId integer · int64 Нет Поле productId.
netProfitRub number · double Нет Поле netProfitRub.
quantity integer · int32 Нет Поле quantity.
purchasePrice number · double Нет Поле purchasePrice.
purchasePercent number · double Нет Поле purchasePercent.
clientId integer · int64 Нет Поле clientId.
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 Нет Сервис
organizationId integer · int64 Нет Поле organizationId.
tipType stringWARN, INFO, ACHIEVEMENTS, REVENUE, PROFIT, LOGISTICS, PENALTY, PROBLEMATIC, LOW_PURCHASE_PERCENT, UNPROFITABLE_PRODUCTS, LOW_MARGIN, NEGATIVE_MARGIN, FBO_LOW_STOCK, LOW_PHOTO_COUNT, CLOTHING_WITHOUT_MODEL, PHOTO_RECOMMENDATIONS, PRODUCT_PHOTO_ANALYZED, HIGH_DRR, LOW_CTR, EMPTY_VIDEO, CONVERSION_TO_ORDER_OR_CART_DECREASED, LOW_RATING, HIGH_STORAGE_COSTS Нет Поле tipType.
jsonValues string Нет Поле jsonValues.
status stringNEW, PROCESSING, CLOSED Нет Поле status.
profitGrowthAmount number · double Нет Поле profitGrowthAmount.
confidenceLevel integer · int32 Нет Поле confidenceLevel.
actionsToDoId integer · int32 Нет Поле actionsToDoId.
currValue number · double Нет Поле currValue.
triggerValue number · double Нет Поле triggerValue.
normValue number · double Нет Поле normValue.
createdDate string · date-time Нет Поле createdDate.
updatedDate string · date-time Нет Поле updatedDate.
product Product Нет Поле product.
Поля объекта Product
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор товара. Проставляется автоматически
productType stringPRODUCT, SET, SERVICE, DIGITAL Нет Тип товара
name string Да Наименование товара внутреннее
deleted boolean Нет Признак удаления товара
printName string Нет Название товара для внешних сервисов. Если не задано, проставляется равным наименованию товара
realSize string Нет Российский размер товара для одежды или характеристики для других категорий
vendorSize string Нет Размер производителя или характеристики производителя. Не обязательно заполнять
size string Нет Размер для одежды или характеристики для внешних сервисов. Должен быть уникальным в рамках цвета
wildberriesStockCount integer · int32 Нет Остатки товара на Вайлдбериз
ozonRealFbs boolean Нет Признак использования RealFbs для товара
ozonStockCount integer · int32 Нет Остаток товара на складах Озон
ozonStockBetweenWarehouses integer · int32 Нет Остаток товара в Озон, которые перемещаются между складами
removeFbsStock boolean Нет Не выгружать остатки товара на маркетплейсы
noStockSync boolean Нет Не синхронизировать остатки: товар полностью исключается из передачи остатков на все маркетплейсы, текущий остаток на МП не изменяется
purchaseCurrency stringRUB, 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 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdDate string · date-time Нет Дата создания товара на МП
created string · date-time Нет Дата создания товара в SelSup
createdUser string Нет Пользователь, который создал товар
sourceIncomeItemId integer · int64 Нет Идентификатор товара из заказа поставщика по данным которого был создан товар
sourceProductId integer · int64 Нет Идентификатор товара, который копировали
ozonRequiredStock integer · int32 Нет Расчитанное количество товара, для поставки на склад Озон
wildberriesRequiredStock integer · int32 Нет Расчитанное количество товара, для поставки на склад Wildberries
wildberriesProfit number · double Нет Профит с продажи товара на Вайлдбериз по FBM
wildberriesProfitFbs number · double Нет Профит с продажи товара на Вайлдбериз по FBS
wildberriesOrderQuantity integer · int32 Нет Количество заказов по FBO товара на Вайлдбериз за 2 недели
wildberriesSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам
wildberriesQuantityInWayToClient integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам к клиенту
wildberriesQuantityInWayFromClient integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам от клиента
wildberriesSaleQuantity integer · int32 Нет Продажи товара на Вайлдбериз по FBM за 2 недели
wildberriesQuantityInWay integer · int32 Нет Количество товаров на Вайлдбериз в пути
wildberriesNoSale boolean Нет Признак неликвидного товара на Вайлдбериз
lastStockChange string · date-time Нет Дата последнего изменения стока на Вайлдбериз по FBM
ozonOrderQuantity integer · int32 Нет Количество заказов товара по FBO на Озон по FBM и FBS за 2 недели
ozonSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Озон по FBM
ozonProfit integer · int32 Нет Чистая маржа продажи товара на Озон по FBM
instockQuantity integer · int32 Нет Остатки товара на складах клиента
instockQuantityValue number · double Нет Остатки товара на складах клиента в пользовательской единице измерения
stockUnit stringPCS, G, KG, ML, L Нет Единица измерения остатка товара для интерфейса и внешних интеграций
calculatedInStockQuantity integer · int32 Нет Рассчитанный остаток
calculatedInStockQuantityValue number · double Нет Рассчитанный остаток в пользовательской единице измерения
clientId integer · int64 Нет Идентификатор клиента
organizationId integer · int64 Да Идентификатор организации
productViewId integer · int64 Нет Идентификатор цвета
view ProductView Нет Информация о цвете товара
Поля объекта ProductView
ПолеТипОбязательноОписание
color string Нет Артикул цвета
wbArticle string Нет Артикул карточки Wildberries
needKiz boolean Нет Требуется ли обязательная маркировка по данным Wildberries
id integer · int64 Нет Идентификатор цвета. Проставляется автоматически
images ProductImage[] Нет Список изображений товара
videos ProductVideo[] Нет Список видео товара
productModelId integer · int64 Нет Идентификатор модели
model ProductModel Нет Модель, к которой относится цвет
actual boolean Нет Актуальность цвета - нужно ли его показывать в заказах поставщикам
mainImage ProductImage Нет Основное изображение товара
mainImageId integer · int64 Нет Поле mainImageId.
mainImageUrl string Нет Ссылка на основное изображение на маркетплейсе
imageUrls string Нет Ссылка на изображения
imagesUpdatedAt string · date-time Нет Дата/время последнего изменения фотографий
image360Urls string Нет Ссылка на изображения 360
wildberriesId integer · int64 Нет Числовой идентификатор номенклатуры Wildberries, nmId
createdDate string · date-time Нет Дата создания цвета
createdUser string Нет Пользователь, создавший цвет
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
deleted boolean Нет Признак удаления цвета
keywords string Нет Ключевые слова - сейчас не используется, перенесены в модель
wildberriesRating number · double Нет Рейтинг карточки на Вайлдбериз
wildberriesFeedbacks integer · int32 Нет Количество отзывов на карточке на Вайлдбериз
wbRaiting number · double Нет Рейтинг карточки на Вайлдбериз
wbFeedbackCount integer · int32 Нет Количество отзывов на карточке на Вайлдбериз
wbPriceWithSpp number · double Нет Цена карточки на Вайлдбериз с учетом СПП, руб.
wildberriesCardDoesNotOpen boolean Нет Признак, что карточка не открывается на Вайлдбериз
wildberriesHasPhoto boolean Нет Признак наличия фото на Wildberries
organizationId integer · int64 Нет Организация карточки
params string Нет JSON со значениями параметров цвета
additionalInfo string Нет Дополнительная информация для цвета
values ParamValue[] Нет Значения параметров карточки. Отдаются при запросе модели, если передать params=true
viewSourceId integer · int64 Нет Оригинал цвета по SKU
sizes Product[] Да Список размеров для цвета
hasChanges boolean Нет Признак изменения информации о цвете и необходимости его обновить
viewWbArticle ProductView Нет Поле viewWbArticle.
viewVersionId integer · int64 Нет Поле viewVersionId.
suzId string Нет GTIN товара
cisType stringUNIT, BUNDLE, GROUP, SET, ATK Нет Тип в национальном каталоге
notChangedStock integer · int32 Нет Количество дней, в течении которых не менялся остаток товара
cardExchanges ProductCardExchange[] Нет Последние статусы обмена карточки с маркетплейсами
Структура элемента массива ProductCardExchange
ПолеТипОбязательноОписание
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 Нет Сервис
status stringWAITING_TO_SEND, SENT, ACCEPTED, ERROR Нет Поле status.
lastAttemptAt string · date-time Нет Поле lastAttemptAt.
errorSource stringSELSUP, MARKETPLACE Нет Поле errorSource.
message string Нет Поле message.
messageParams string Нет Поле messageParams.
wildberriesStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Вайлдбериз
wildberriesMessage string Нет Ошибка создания карточки товара в Вайлдбериз
wildberriesMessageParams string Нет JSON параметров ошибки создания карточки товара в Вайлдбериз
nationalCatalogStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Национальном каталоге
nationalCatalogMessage string Нет Ошибка создания карточки товара в Национальном каталоге
nationalCatalogMessageParams string Нет Параметры ошибки создания карточки товара в Национальном каталоге
ozonStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Озон
ozonMessage string Нет Ошибка создания карточки товара в Озон
ozonMessageParams string Нет JSON параметры ошибки создания карточки товара в Озон
ozonTaskId integer · int64 Нет Идентификатор задания по обновления или созданию карточки в Озон
wildberriesFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке WB по FBS за 2 недели
ozonFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке на Ozon по FBS за 2 недели
ymarketFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке на Яндекс Маркете по FBS за 2 недели
totalSupplyingQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке за 2 недели
skuId integer · int64 Нет Идентификатор единицы хранения товара на складе. Проставляется автоматически
sku Sku Нет Поле sku.
Поля объекта Sku
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
product object Нет Первый товар из которого был создан SKU
productId integer · int64 Нет Поле productId.
barcodes ProductBarcode[] Нет Штрих-коды товара
Структура элемента массива ProductBarcode
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
barcode string Нет Поле barcode.
organizationId integer · int64 Нет Организация, если client.barcodeUniqForOrg = false, то проставляется 0. Поле включено в уникальный ключ
clientId integer · int64 Нет Поле clientId.
productId integer · int64 Нет Поле productId.
useInWildberries boolean Нет Применим ли данный штрих-код для Вайлдбериз
useInOzon boolean Нет Применим ли данный штрих-код для Озон
useInYandexMarket boolean Нет Применим ли данный штрих-код для Yandex.Market
useInAliexpress boolean Нет Применим ли данный штрих-код для Aliexpress
useInSberMegamarket boolean Нет Применим ли данный штрих-код для Sber.MegaMarket
useInWoocom boolean Нет Применим ли данный штрих-код для WooCommerce
format string Нет Поле format.
serviceProducts ServiceProduct[] Нет Cвязи с товарами маркетплейсов
Структура элемента массива ServiceProduct
ПолеТипОбязательноОписание
serviceProductId integer · int64 Нет Идентификатор продукта сервиса
productId integer · int64 Нет Идентификатор продукта
serviceId integer · int32 Нет Идентификатор сервиса
serviceListingId integer · int64 Нет Идентификатор листинга на сервисе
serviceCardId integer · int64 Нет Поле serviceCardId.
fboStock integer · int32 Нет Остаток на ФБО складах
lastRepricerPriceStatus stringNONE, SUCCESS, ERROR Нет Последний статус обновления цены через репрайсер
errorMessage string Нет Ошибка при установки цены через репрайсер
serviceCard string Нет Идентификатор карточки на сервисе
serviceCardProduct string Нет Идентификатор товара на сервисе
serviceCardUrl string Нет Ссылка на карточку на сервисе (если несколько товаров отображаются)
serviceProductUrl string Нет Ссылка на товар селлера на сервисе
serviceBarcode string Нет Штрих код на сервисе
fboCommissions number · double Нет Комиссия ФБО
fbsCommissions number · double Нет Комиссия ФБС
purchasePercent number · double Нет Процент выкупа
serviceArticle string Нет Артикул на сервисе
clientId integer · int64 Нет Идентификатор клиента
organizationId integer · int64 Нет Идентификатор организации
siteArticle string Нет артикул товара на сайте
siteId string Нет айди товара на сайте
params string Нет JSON значений параметров для данного размера/характеристик
values ParamValue[] Нет Значения параметров карточки. Отдаются при запросе модели, если передать params=true
Структура элемента массива ParamValue
ПолеТипОбязательноОписание
paramId integer · int64 Да Идентификатор параметра
paramName string Нет Название параметра, для тех, у кого нет ID
option Option Нет Значение перечислимого параметра
doubleValue number · double Нет Числовое значение параметра
longValue integer · int64 Нет Целочисленное значение параметра
booleanValue boolean Нет Булево значение параметра
stringValue string Нет Строковое значение параметра
dateValue string · date-time Нет Значение параметра даты
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 Нет Привязка к сервису параметра
unit Unit Нет Единица измерения для параметра
auto boolean Нет Автоматически проставленное значение параметра
created integer · int64 Нет Дата заполнения параметра
user string Нет Пользователь, который заполнил параметр
locked boolean Нет Значение зафиксировано и не должно изменяться при импорте карточек с маркетплейса
group object Нет Группа карточек. Используется на списке товаров, чтобы объединить разные размеры в одну строку
duplicates Product[] Нет Дубликаты карточки по остаткам. Отдаются только на списке товаров, если включена галочка Объединять дубликаты
hasChanges boolean Нет Признак наличия изменений в товаре и ее нужно обновить при сохранении
ignoreDuplicate boolean Нет Признак игнорирования дубликатов при создании
yandexMarketStockCount integer · int64 Нет Остаток товара на складах Yandex.Market
groupId integer · int64 Нет ID групповой карточки
yandexMarketStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара на яндекс маркет
yandexMarketMessage string Нет Сообщение при ошибке создания карточки товара на яндекс маркет
yandexMarketMessageParams string Нет Параметры сообщения при создании товара в Яндекс.Маркет
duplicate boolean Нет Признак, что карточка является дубликатом. Отдается не для всех методов
ozonHasPhoto boolean Нет Признак наличия фото на Ozon
aliexpressStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания товара на Aliexpress
aliexpressMessage string Нет Сообщение при создании товара на Aliexpress
aliexpressMessageParams string Нет Параметры сообщения при создании товара на Aliexpress
moySkladType string Нет Тип товара в сервисе Мой Склад
moySkladStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в МойСклад
avitoStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус обьявления на Авито
moySkladMessage string Нет Ошибка создания карточки товара в МойСклад
moySkladMessageParams string Нет Параметры ошибки создания карточки товара в МойСклад
removeFbsStockOzon boolean Нет Не передавать остатки товара по FBS на озон
removeFbsStockWb boolean Нет Не передавать остатки товара по FBS на Wildberries
removeFbsStockAli boolean Нет Не передавать остатки товара по FBS на Aliepress
removeFbsStockYm boolean Нет Не передавать остатки товара по FBS на Яндекс.Маркет
removeFbsStockSber boolean Нет Не передавать остатки товара по FBS на СберМегаМаркет
quantity integer · int32 Нет Количество товара в заказах. Возвращается только в методах income/getProductsFromOrders или wms/findStock
incomeQuantity integer · int32 Нет Количество товара в закупке без разделения по маркетплейсам
orderMinDate string · date-time Нет Минимальная дата заказа. Возвращается только в методах income/getProductsFromOrders
expiredDate string · date-time Нет Cрок годности товара - возвращается только в методах, wms/findStock
productionDate string · date-time Нет Дата производства
stock integer · int32 Нет Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock
stockValue number · double Нет Остаток на складе в пользовательской единице измерения
stocks object Нет Остатки товара на складах - возвращается только в методах, wms/fetchStock
cell Cell Нет Ячейка хранения товара на определенном складе - возвращается только в методах, wms/fetchStock
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
reserved integer · int32 Нет Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock
reservedValue number · double Нет Резерв в пользовательской единице измерения
calculatedStock integer · int32 Нет Остаток наборов на определенном складе - возвращается только в методах, wms/fetchStock, product/findProduct, supply/findProductForOrder
calculatedStockValue number · double Нет Рассчитанный остаток набора в пользовательской единице измерения
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 Нет Дополнительные расходы на доставку товара в руб. Добавляются к закупочной цене
strategyId integer · int64 Нет Идентификатор стратегии ценообразования
ozonAverageExpenses number · double Нет Расходы по продаже товара на Ozon
wildberriesAverageExpenses number · double Нет Расходы по продаже товара на Wildberries
yandexMarketAverageExpenses number · double Нет Расходы по продаже товара на ЯМ
wildberriesSale integer · int32 Нет Скидка товара на Вайлдбериз
minPrice number · double Нет Минимальная цена товара. Ниже этой цены нельзя выставлять цену на товар.Используется для Ozon при участии товара в акциях
ozonPromotionPrice number · double Нет Текущая акционная цена товара на Озон
ozonAcquiringPercent number · double Нет Максимальная комиссия за эквайринг OZON
ozonComisson number · double Нет Комиссия товара на Озон FBM
sberMegaMarketSupplyingQuantity integer · int32 Нет Поставляемое количество товара на СберМегаМаркет по FBM заказам
yandexMarketSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Яндекс.Маркет по FBM заказам
salesExpensesOnMpPercent number · double Нет Расходы по продажам на маркетплейсе, %
salesCountCoefficient number · double Нет Коэффициент пересчета продаж и возвратов в товарной аналитике
measureUnitId integer · int32 Нет Единица измерения товара (ID единицы измерения)
taxeRate number · double Нет Установленый процент налога на товар, %
desiredMarginalityPercent number · double Нет Желаемый % маржинальности
desiredProfitRub number · double Нет Желаемая прибыль, руб.
additionalCost number · double Нет Доп. расходы на товар без записи в Финансовую аналитику, руб.
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
totalOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по МП OZON + WB
totalFbsOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по FBS за 2 недели
wildberriesTotalOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по МП WB
ignoreFbsWarehouses string Нет Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS
fbsWarehouses string Нет Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS
minFbsStock integer · int32 Нет Минимальный остаток - если меньше, то ставим 0
maxFbsStock integer · int32 Нет Максимальный остаток - если больше, то ставим его
wildberriesSaleLogistic number · double Нет Логистика WB, руб.
wildberriesReturnLogistic number · double Нет Обратная логистика WB, руб.
wildberriesTotalLogistics number · double Нет Логистика WB итого, руб.
wildberriesWarehouseRatio number · double Нет Коэффициент склада WB в %
wildberriesComission number · double Нет Комиссия WB, %
ozonSaleLogistic number · double Нет Логистика Ozon, руб.
ozonReturnLogistic number · double Нет Обратная логистика Ozon, руб.
ozonCommission number · double Нет Комиссия Ozon, %
maxDeliveryToPickupPoint number · double Нет Максимальная стоимость доставки до места выдачи, руб.
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
ozonRaiting number · double Нет Рейтинг товара на Ozon
ozonFeedbackCount integer · int32 Нет Количество отзывов на товар на Ozon
ozonPriceWithSpp number · double Нет Цена товара на Ozon с учетом СПП, руб.
fboStockCount integer · int64 Нет Остаток ФБО по выбранным складам/регионам
fbsStockCount integer · int64 Нет Остаток ФБC для планирования поставок)
stockCoverageDays integer · int64 Нет На сколько дней хватит текущего остатка ФБО на складе
fboSupplyQuantity integer · int64 Нет Количество поставляемого товара по выбранным складам/регионам
fboSales integer · int64 Нет Кол-во продаж FBO по складам/регионам для планирования поставок
fbsSales integer · int64 Нет Кол-во продаж FBS по складам/регионам для планирования поставок
fboOrders integer · int64 Нет Кол-во заказов FBO по складам/регионам для планирования поставок
fbsOrders integer · int64 Нет Кол-во заказов FBS по складам/регионам для планирования поставок
recommendPlan number · double Нет Кол-во товара для добавления к заказу
baseDeficit integer · int64 Нет Базовый дефицит склада до распределения остатков без склада назначения
allocatedWithoutWarehouse integer · int64 Нет Часть общих остатков без склада назначения, распределенная на склад
skipDaysCount integer · int32 Нет Кол-во пропущенных дней в учёте планирования поставок
organizationShortName string Нет Поле organizationShortName.
contractorName string Нет Поле contractorName.
supplyPlanBarcode string Нет Поле supplyPlanBarcode.
planCorrectionFactor number · double Нет Коэффициент коррекции для планирования поставок. На это значение умножается рассчитанное количество товара для поставки
orderBefore integer · int32 Нет До какого времени должен быть сделан заказ от 1 до 24
daysBeforeSupply integer · int32 Нет Кол-во дней до поставки. Через сколько дней с момента заказа ориентировочно будет поставка товаров
supplyPlanDays integer · int32 Нет На сколько дней планировать остаток
warehouseIdForSupplyReport integer · int64 Нет Id склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок
warehouseNameForSupplyReport string Нет Название склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок
wbCanBox boolean Нет Можно ли отгружать товар на склад WB в коробах
wbCanMonopallet boolean Нет Можно ли отгружать товар на склад WB в монопаллете
wbCanSupersafe boolean Нет Можно ли отгружать товар на склад WB в Supersafe
wbCanBoxOnPallet boolean Нет Можно ли отгружать товар на склад WB в коробах на паллете
manager string Нет Поле менеджера
cellId integer · int32 Нет Поле cellId.
drrPercent integer · int32 Нет ДРР% - доля рекламных расходов
percentForParticipationPromoOrAdvertising integer · int32 Нет Закладываемый % для участия в акциях или рекламе
selsupLink string Нет Поле selsupLink.
tempId integer · int64 Нет Временный id используется для быстрого импорта
category 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
findirTips object Нет Советы задачника (тип задачи - текст совета)
commissions string Нет JSON с комиссиями из разных маркетплейсов
commissionCalculations object Нет Расчёт итоговой комиссии по маркетплейсам
lowStockAlerts string Нет JSON для уведомлений о заканчивающихся остатках по маркетплейсов
inputVat number · double Нет Входящий НДС, руб.
outputVat number · double Нет Исходящий НДС, руб.
finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.
incomeTax number · double Нет Налог на прибыль, руб.
totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.
netProfit number · double Нет Чистая прибыль, руб.
margin number · double Нет Чистая маржинальность, %
woocomStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в WooCommerce
dateStartSeason1 string · date Нет Дата начала сезона 1
dateEndSeason1 string · date Нет Дата окончания сезона 1
dateStartSeason2 string · date Нет Дата начала сезона 2
dateEndSeason2 string · date Нет Дата окончания сезона 2
dateStartSeason3 string · date Нет Дата начала сезона 3
dateEndSeason3 string · date Нет Дата окончания сезона 3
dateStartSeason4 string · date Нет Дата начала сезона 4
dateEndSeason4 string · date Нет Дата окончания сезона 4
currentGrossProfit object Нет Текущая валовая прибыль. Для таблицы цены
plannedGrossProfit object Нет Новая валовая прибыль. Для таблицы цены
position integer · int32 Нет позиция продукта
emptyBarcodes boolean Нет Поле emptyBarcodes.
uzumStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Uzum
makroStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Makro
kaspiStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Kaspi
anyLink string Нет Поле anyLink.
anyArticle string Нет Поле anyArticle.
site string Нет Поле site.
shopifyStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Shopify
takealotStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Takealot
yandexKitStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Яндекс.Кит
bobShopStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Bob Shop
minPriceForAllMarketplace number · double Нет Поле minPriceForAllMarketplace.
calculatedInstockQuantity integer · int32 Нет Поле calculatedInstockQuantity.
lamodaParentSku string Нет Родительский SKU товара на Lamoda
uzumProductId integer · int64 Нет Идентификатор товара (productId) на Uzum
woocomParentId integer · int64 Нет ID родительского товара в WooCommerce (для вариаций)
woocomPermalink string Нет Ссылка на товар в WooCommerce
wildberriesSizeId integer · int64 Нет Идентификатор размера на Вайлдбериз
yandexMarketShopSku string Нет SKU товара на Yandex.Market
aliexpressSku string Нет SKU на Aliexpress
wildberriesImtId integer · int64 Нет Используется для категорий, у которых не предусмотрен размер
externalArticle string Нет Уникальный артикул товара для стороннего сервиса
mvideoArticle string Нет Артикул товара на M.Video
ozonProductId integer · int64 Нет Идентификатор товара Озон в кабинете API
leroyMerlinId string Нет Номер карточки на Леруа Мерлен
leroyMerlinArticle string Нет Артикул товара на Леруа Мерлен
magnitArticle string Нет Артикль товара на Magnit
lamodaArticle string Нет Артикул товара на Lamoda
yandexMarketSku integer · int64 Нет Идентификатор карточки товара на Yandex.Market
sberMegaMarketId integer · int64 Нет Карточка СберМегаМаркет
detmirArticle string Нет Артикул товара на Детском мире (productCode / SAP)
moySkladLinkId string Нет ID для ссылки на Мой Склад
ebayArticle string Нет Артикул товара на Ebay
uzumSkuId integer · int64 Нет Идентификатор SKU (skuId) на Uzum
sellerSku string Нет Идентификатор товара на Amazon
takealotSku string Нет SKU товара на Takealot
walmartSku string Нет SKU товара на Walmart
walmartId string Нет Id товара на Walmart (WPID)
woocomSku string Нет SKU товара на WooCommerce
woocomId integer · int64 Нет Id товара на WooCommerce
opencartSku string Нет SKU товара в OpenCart
opencartId integer · int64 Нет Id товара в OpenCart
magnitId string Нет Id товара на Magnit
sberArticle string Нет Артикул товара на СберМегаМаркет
ozonArticle string Нет Уникальный артикул товара для озон. Offer ID в озон
oneCArticle string Нет Уникальный артикул товара для 1c
uzumArticle string Нет Уникальный артикул товара для Uzum
simalandId integer · int64 Нет Уникальный идентификатор товара для Simaland
lamodaSku string Нет SKU товара на Lamoda
ozonFbsSku integer · int64 Нет Идентификатор товара в Озон по FBS
ozonFboSku integer · int64 Нет Идентификатор товара в Озон по FBO
avitoId integer · int64 Нет ID товара в сервисе Avito
detmirId string Нет Id товара на сайте Детского мира (для ссылки на карточку)
magnitSku string Нет SKU товара на Magnit
ozonId integer · int64 Нет Идентификатор товара Озон на сайте. SKU в озон
oneCId string Нет Идентификатор товара в 1С
moySkladId string Нет ID товара в сервисе Мой Склад
nationalCatalogFeedId integer · int64 Нет Идентификатор создания карточки в национальном каталоге
yandexMarketProductId integer · int64 Нет Идентификатор карточки товара на Yandex.Market
nationalCatalogGoodId integer · int64 Нет Идентификатор товара в национальном каталоге
wildberriesPrice number · double Нет Текущая цена товара на Вайлдбериз со скидкой
wildberriesUpdatedPrice number · double Нет Новая цена товара на Вайлдбериз со скидкой.Только для методов изменения цены
wildberriesPriceWithoutDiscount number · double Нет Текущая цена товара на Вайлдбериз без скидки
wildberriesUpdatedPriceWithoutDiscount number · double Нет Новая цена товара на Вайлдбериз без скидки.Только для методов изменения цены
aliexpressPrice number · double Нет Текущая цена на Aliexpress со скидкой
aliexpressPriceWithoutDiscount number · double Нет Текущая цена на Aliexpress без скидки.
aliexpressUpdatedPrice number · double Нет Новая цена со скидкой на Aliexpress. Только для методов обновления цены
aliexpressUpdatedPriceWithoutDiscount number · double Нет Новая цена без скидки на Aliexpress. Только для методов обновления цены
ozonPrice number · double Нет Текущая цена товара на Озон со скидкой
ozonUpdatedPrice number · double Нет Новая цена товара на Озон со скидкой.Только для методов изменения цены
ozonPriceWithoutDiscount number · double Нет Текущая цена товара на Озон без скидки.
ozonUpdatedPriceWithoutDiscount number · double Нет Новая цена Озон без скидки.Только для методов изменения цены
leroyMerlinPrice number · double Нет Текущая цена товара на LeroyMerlin
leroyMerlinUpdatedPrice number · double Нет Новая цена товара на LeroyMerlin.Только для методов изменения цены
avitoPrice number · double Нет Текущая цена товара на Avito
avitoUpdatedPrice number · double Нет Новая цена товара на Avito.Только для методов изменения цены
sberMegaMarketPrice number · double Нет Текущая цена на СберМегаМаркет со скидкой
sberMegaMarketUpdatedPrice number · double Нет Новая цена со скидкой на СберМегаМаркет. Только для методов изменения цены
yandexMarketPrice number · double Нет Текущая цена на Яндекс.Маркет со скидкой
yandexMarketPriceWithoutDiscount number · double Нет Текущая цена на Яндекс.Маркет без скидки
yandexMarketUpdatedPrice number · double Нет Новая цена со скидкой на Яндекс.Маркет. Только для методов изменения цены
yandexMarketUpdatedPriceWithoutDiscount number · double Нет Новая цена без скидки на Яндекс.Маркет. Только для методов изменения цены
productPrices ProductPrice[] Нет Поле productPrices.
Структура элемента массива ProductPrice
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор записи цены
productId integer · int64 Нет Идентификатор товара
product object Нет Товар
priceTypeId integer · int64 Нет Идентификатор типа цены
priceType PriceType Нет Тип цены
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 Нет Сервис
clientId integer · int64 Нет Идентификатор клиента
price number · double Нет Цена
updatedPrice number · double Нет Обновленная цена
priceWithoutDiscount number · double Нет Цена без скидки
updatedPriceWithoutDiscount number · double Нет Обновленная цена без скидки
minPrice number · double Нет Минимальная цена
updatedMinPrice number · double Нет Обновленная минимальная цена
percentForParticipationPromoOrAdvertising integer · int32 Нет Процент расходов на участие в акциях или рекламе
isActive boolean Нет Активна ли цена
article string Нет Уникальный идентификатор товара на маркетплейсе
pendingOperationId string Нет Идентификатор асинхронной операции обновления цены (Детский мир)
stockRules ProductStockRules Нет Правила отправки остатков на маркетплейсы
Поля объекта ProductStockRules
ПолеТипОбязательноОписание
minFbsStock integer · int32 Нет Минимальный остаток - если меньше, то ставим 0
maxFbsStock integer · int32 Нет Максимальный остаток - если больше, то ставим его
subtractFromStock integer · int32 Нет Вычитаемое значение из остатка перед отправкой на маркетплейс
serviceId integer · int32 Нет Поле serviceId.
{
  "id": 1001,
  "productId": 1001,
  "netProfitRub": 1,
  "quantity": 1,
  "purchasePrice": 1,
  "purchasePercent": 1
}
Ошибки3

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

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

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

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

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

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

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

GET

Умный анализ финансов

/api/findir/strategy/tips
Токен с правами чтения

Возвращает список обнаруженных проблем для AI Стратегии

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

ПолеТипОбязательноОписание
findirTipTypes string[] Нет Фильтр по типам findir рекомендаций
tipStatus stringNEW, PROCESSING, CLOSED Нет Фильтр по статусу findir рекомендаций
services string[] Нет Список сервисов в которых не создана карточка. Например, services=WILDBERRIES&services=OZON
organizations integer[] Нет Фильтр по ID организаций. Передается несколько значений organizations=1.organizations=2
query string Нет Поле query.
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy string Нет Поле сортировки записей. Работает только при получении списка.
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/findir/strategy/tips?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта FindResponseFindirData
ПолеТипОбязательноОписание
rows FindirData[] Нет Строки с результатом поиска
Структура элемента массива FindirData
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
productId integer · int64 Нет Поле productId.
netProfitRub number · double Нет Поле netProfitRub.
quantity integer · int32 Нет Поле quantity.
purchasePrice number · double Нет Поле purchasePrice.
purchasePercent number · double Нет Поле purchasePercent.
clientId integer · int64 Нет Поле clientId.
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 Нет Сервис
organizationId integer · int64 Нет Поле organizationId.
tipType stringWARN, INFO, ACHIEVEMENTS, REVENUE, PROFIT, LOGISTICS, PENALTY, PROBLEMATIC, LOW_PURCHASE_PERCENT, UNPROFITABLE_PRODUCTS, LOW_MARGIN, NEGATIVE_MARGIN, FBO_LOW_STOCK, LOW_PHOTO_COUNT, CLOTHING_WITHOUT_MODEL, PHOTO_RECOMMENDATIONS, PRODUCT_PHOTO_ANALYZED, HIGH_DRR, LOW_CTR, EMPTY_VIDEO, CONVERSION_TO_ORDER_OR_CART_DECREASED, LOW_RATING, HIGH_STORAGE_COSTS Нет Поле tipType.
jsonValues string Нет Поле jsonValues.
status stringNEW, PROCESSING, CLOSED Нет Поле status.
profitGrowthAmount number · double Нет Поле profitGrowthAmount.
confidenceLevel integer · int32 Нет Поле confidenceLevel.
actionsToDoId integer · int32 Нет Поле actionsToDoId.
currValue number · double Нет Поле currValue.
triggerValue number · double Нет Поле triggerValue.
normValue number · double Нет Поле normValue.
createdDate string · date-time Нет Поле createdDate.
updatedDate string · date-time Нет Поле updatedDate.
product Product Нет Поле product.
Поля объекта Product
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор товара. Проставляется автоматически
productType stringPRODUCT, SET, SERVICE, DIGITAL Нет Тип товара
name string Да Наименование товара внутреннее
deleted boolean Нет Признак удаления товара
printName string Нет Название товара для внешних сервисов. Если не задано, проставляется равным наименованию товара
realSize string Нет Российский размер товара для одежды или характеристики для других категорий
vendorSize string Нет Размер производителя или характеристики производителя. Не обязательно заполнять
size string Нет Размер для одежды или характеристики для внешних сервисов. Должен быть уникальным в рамках цвета
wildberriesStockCount integer · int32 Нет Остатки товара на Вайлдбериз
ozonRealFbs boolean Нет Признак использования RealFbs для товара
ozonStockCount integer · int32 Нет Остаток товара на складах Озон
ozonStockBetweenWarehouses integer · int32 Нет Остаток товара в Озон, которые перемещаются между складами
removeFbsStock boolean Нет Не выгружать остатки товара на маркетплейсы
noStockSync boolean Нет Не синхронизировать остатки: товар полностью исключается из передачи остатков на все маркетплейсы, текущий остаток на МП не изменяется
purchaseCurrency stringRUB, 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 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdDate string · date-time Нет Дата создания товара на МП
created string · date-time Нет Дата создания товара в SelSup
createdUser string Нет Пользователь, который создал товар
sourceIncomeItemId integer · int64 Нет Идентификатор товара из заказа поставщика по данным которого был создан товар
sourceProductId integer · int64 Нет Идентификатор товара, который копировали
ozonRequiredStock integer · int32 Нет Расчитанное количество товара, для поставки на склад Озон
wildberriesRequiredStock integer · int32 Нет Расчитанное количество товара, для поставки на склад Wildberries
wildberriesProfit number · double Нет Профит с продажи товара на Вайлдбериз по FBM
wildberriesProfitFbs number · double Нет Профит с продажи товара на Вайлдбериз по FBS
wildberriesOrderQuantity integer · int32 Нет Количество заказов по FBO товара на Вайлдбериз за 2 недели
wildberriesSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам
wildberriesQuantityInWayToClient integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам к клиенту
wildberriesQuantityInWayFromClient integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам от клиента
wildberriesSaleQuantity integer · int32 Нет Продажи товара на Вайлдбериз по FBM за 2 недели
wildberriesQuantityInWay integer · int32 Нет Количество товаров на Вайлдбериз в пути
wildberriesNoSale boolean Нет Признак неликвидного товара на Вайлдбериз
lastStockChange string · date-time Нет Дата последнего изменения стока на Вайлдбериз по FBM
ozonOrderQuantity integer · int32 Нет Количество заказов товара по FBO на Озон по FBM и FBS за 2 недели
ozonSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Озон по FBM
ozonProfit integer · int32 Нет Чистая маржа продажи товара на Озон по FBM
instockQuantity integer · int32 Нет Остатки товара на складах клиента
instockQuantityValue number · double Нет Остатки товара на складах клиента в пользовательской единице измерения
stockUnit stringPCS, G, KG, ML, L Нет Единица измерения остатка товара для интерфейса и внешних интеграций
calculatedInStockQuantity integer · int32 Нет Рассчитанный остаток
calculatedInStockQuantityValue number · double Нет Рассчитанный остаток в пользовательской единице измерения
clientId integer · int64 Нет Идентификатор клиента
organizationId integer · int64 Да Идентификатор организации
productViewId integer · int64 Нет Идентификатор цвета
view ProductView Нет Информация о цвете товара
suzId string Нет GTIN товара
cisType stringUNIT, BUNDLE, GROUP, SET, ATK Нет Тип в национальном каталоге
notChangedStock integer · int32 Нет Количество дней, в течении которых не менялся остаток товара
cardExchanges ProductCardExchange[] Нет Последние статусы обмена карточки с маркетплейсами
wildberriesStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Вайлдбериз
wildberriesMessage string Нет Ошибка создания карточки товара в Вайлдбериз
wildberriesMessageParams string Нет JSON параметров ошибки создания карточки товара в Вайлдбериз
nationalCatalogStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Национальном каталоге
nationalCatalogMessage string Нет Ошибка создания карточки товара в Национальном каталоге
nationalCatalogMessageParams string Нет Параметры ошибки создания карточки товара в Национальном каталоге
ozonStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Озон
ozonMessage string Нет Ошибка создания карточки товара в Озон
ozonMessageParams string Нет JSON параметры ошибки создания карточки товара в Озон
ozonTaskId integer · int64 Нет Идентификатор задания по обновления или созданию карточки в Озон
wildberriesFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке WB по FBS за 2 недели
ozonFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке на Ozon по FBS за 2 недели
ymarketFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке на Яндекс Маркете по FBS за 2 недели
totalSupplyingQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке за 2 недели
skuId integer · int64 Нет Идентификатор единицы хранения товара на складе. Проставляется автоматически
sku Sku Нет Поле sku.
barcodes ProductBarcode[] Нет Штрих-коды товара
serviceProducts ServiceProduct[] Нет Cвязи с товарами маркетплейсов
siteArticle string Нет артикул товара на сайте
siteId string Нет айди товара на сайте
params string Нет JSON значений параметров для данного размера/характеристик
values ParamValue[] Нет Значения параметров карточки. Отдаются при запросе модели, если передать params=true
group object Нет Группа карточек. Используется на списке товаров, чтобы объединить разные размеры в одну строку
duplicates Product[] Нет Дубликаты карточки по остаткам. Отдаются только на списке товаров, если включена галочка Объединять дубликаты
hasChanges boolean Нет Признак наличия изменений в товаре и ее нужно обновить при сохранении
ignoreDuplicate boolean Нет Признак игнорирования дубликатов при создании
yandexMarketStockCount integer · int64 Нет Остаток товара на складах Yandex.Market
groupId integer · int64 Нет ID групповой карточки
yandexMarketStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара на яндекс маркет
yandexMarketMessage string Нет Сообщение при ошибке создания карточки товара на яндекс маркет
yandexMarketMessageParams string Нет Параметры сообщения при создании товара в Яндекс.Маркет
duplicate boolean Нет Признак, что карточка является дубликатом. Отдается не для всех методов
ozonHasPhoto boolean Нет Признак наличия фото на Ozon
aliexpressStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания товара на Aliexpress
aliexpressMessage string Нет Сообщение при создании товара на Aliexpress
aliexpressMessageParams string Нет Параметры сообщения при создании товара на Aliexpress
moySkladType string Нет Тип товара в сервисе Мой Склад
moySkladStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в МойСклад
avitoStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус обьявления на Авито
moySkladMessage string Нет Ошибка создания карточки товара в МойСклад
moySkladMessageParams string Нет Параметры ошибки создания карточки товара в МойСклад
removeFbsStockOzon boolean Нет Не передавать остатки товара по FBS на озон
removeFbsStockWb boolean Нет Не передавать остатки товара по FBS на Wildberries
removeFbsStockAli boolean Нет Не передавать остатки товара по FBS на Aliepress
removeFbsStockYm boolean Нет Не передавать остатки товара по FBS на Яндекс.Маркет
removeFbsStockSber boolean Нет Не передавать остатки товара по FBS на СберМегаМаркет
quantity integer · int32 Нет Количество товара в заказах. Возвращается только в методах income/getProductsFromOrders или wms/findStock
incomeQuantity integer · int32 Нет Количество товара в закупке без разделения по маркетплейсам
orderMinDate string · date-time Нет Минимальная дата заказа. Возвращается только в методах income/getProductsFromOrders
expiredDate string · date-time Нет Cрок годности товара - возвращается только в методах, wms/findStock
productionDate string · date-time Нет Дата производства
stock integer · int32 Нет Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock
stockValue number · double Нет Остаток на складе в пользовательской единице измерения
stocks object Нет Остатки товара на складах - возвращается только в методах, wms/fetchStock
cell Cell Нет Ячейка хранения товара на определенном складе - возвращается только в методах, wms/fetchStock
reserved integer · int32 Нет Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock
reservedValue number · double Нет Резерв в пользовательской единице измерения
calculatedStock integer · int32 Нет Остаток наборов на определенном складе - возвращается только в методах, wms/fetchStock, product/findProduct, supply/findProductForOrder
calculatedStockValue number · double Нет Рассчитанный остаток набора в пользовательской единице измерения
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 Нет Дополнительные расходы на доставку товара в руб. Добавляются к закупочной цене
strategyId integer · int64 Нет Идентификатор стратегии ценообразования
ozonAverageExpenses number · double Нет Расходы по продаже товара на Ozon
wildberriesAverageExpenses number · double Нет Расходы по продаже товара на Wildberries
yandexMarketAverageExpenses number · double Нет Расходы по продаже товара на ЯМ
wildberriesSale integer · int32 Нет Скидка товара на Вайлдбериз
minPrice number · double Нет Минимальная цена товара. Ниже этой цены нельзя выставлять цену на товар.Используется для Ozon при участии товара в акциях
ozonPromotionPrice number · double Нет Текущая акционная цена товара на Озон
ozonAcquiringPercent number · double Нет Максимальная комиссия за эквайринг OZON
ozonComisson number · double Нет Комиссия товара на Озон FBM
sberMegaMarketSupplyingQuantity integer · int32 Нет Поставляемое количество товара на СберМегаМаркет по FBM заказам
yandexMarketSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Яндекс.Маркет по FBM заказам
salesExpensesOnMpPercent number · double Нет Расходы по продажам на маркетплейсе, %
salesCountCoefficient number · double Нет Коэффициент пересчета продаж и возвратов в товарной аналитике
measureUnitId integer · int32 Нет Единица измерения товара (ID единицы измерения)
taxeRate number · double Нет Установленый процент налога на товар, %
desiredMarginalityPercent number · double Нет Желаемый % маржинальности
desiredProfitRub number · double Нет Желаемая прибыль, руб.
additionalCost number · double Нет Доп. расходы на товар без записи в Финансовую аналитику, руб.
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
totalOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по МП OZON + WB
totalFbsOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по FBS за 2 недели
wildberriesTotalOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по МП WB
ignoreFbsWarehouses string Нет Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS
fbsWarehouses string Нет Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS
minFbsStock integer · int32 Нет Минимальный остаток - если меньше, то ставим 0
maxFbsStock integer · int32 Нет Максимальный остаток - если больше, то ставим его
wildberriesSaleLogistic number · double Нет Логистика WB, руб.
wildberriesReturnLogistic number · double Нет Обратная логистика WB, руб.
wildberriesTotalLogistics number · double Нет Логистика WB итого, руб.
wildberriesWarehouseRatio number · double Нет Коэффициент склада WB в %
wildberriesComission number · double Нет Комиссия WB, %
ozonSaleLogistic number · double Нет Логистика Ozon, руб.
ozonReturnLogistic number · double Нет Обратная логистика Ozon, руб.
ozonCommission number · double Нет Комиссия Ozon, %
maxDeliveryToPickupPoint number · double Нет Максимальная стоимость доставки до места выдачи, руб.
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
ozonRaiting number · double Нет Рейтинг товара на Ozon
ozonFeedbackCount integer · int32 Нет Количество отзывов на товар на Ozon
ozonPriceWithSpp number · double Нет Цена товара на Ozon с учетом СПП, руб.
fboStockCount integer · int64 Нет Остаток ФБО по выбранным складам/регионам
fbsStockCount integer · int64 Нет Остаток ФБC для планирования поставок)
stockCoverageDays integer · int64 Нет На сколько дней хватит текущего остатка ФБО на складе
fboSupplyQuantity integer · int64 Нет Количество поставляемого товара по выбранным складам/регионам
fboSales integer · int64 Нет Кол-во продаж FBO по складам/регионам для планирования поставок
fbsSales integer · int64 Нет Кол-во продаж FBS по складам/регионам для планирования поставок
fboOrders integer · int64 Нет Кол-во заказов FBO по складам/регионам для планирования поставок
fbsOrders integer · int64 Нет Кол-во заказов FBS по складам/регионам для планирования поставок
recommendPlan number · double Нет Кол-во товара для добавления к заказу
baseDeficit integer · int64 Нет Базовый дефицит склада до распределения остатков без склада назначения
allocatedWithoutWarehouse integer · int64 Нет Часть общих остатков без склада назначения, распределенная на склад
skipDaysCount integer · int32 Нет Кол-во пропущенных дней в учёте планирования поставок
organizationShortName string Нет Поле organizationShortName.
contractorName string Нет Поле contractorName.
supplyPlanBarcode string Нет Поле supplyPlanBarcode.
planCorrectionFactor number · double Нет Коэффициент коррекции для планирования поставок. На это значение умножается рассчитанное количество товара для поставки
orderBefore integer · int32 Нет До какого времени должен быть сделан заказ от 1 до 24
daysBeforeSupply integer · int32 Нет Кол-во дней до поставки. Через сколько дней с момента заказа ориентировочно будет поставка товаров
supplyPlanDays integer · int32 Нет На сколько дней планировать остаток
warehouseIdForSupplyReport integer · int64 Нет Id склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок
warehouseNameForSupplyReport string Нет Название склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок
wbCanBox boolean Нет Можно ли отгружать товар на склад WB в коробах
wbCanMonopallet boolean Нет Можно ли отгружать товар на склад WB в монопаллете
wbCanSupersafe boolean Нет Можно ли отгружать товар на склад WB в Supersafe
wbCanBoxOnPallet boolean Нет Можно ли отгружать товар на склад WB в коробах на паллете
manager string Нет Поле менеджера
cellId integer · int32 Нет Поле cellId.
drrPercent integer · int32 Нет ДРР% - доля рекламных расходов
percentForParticipationPromoOrAdvertising integer · int32 Нет Закладываемый % для участия в акциях или рекламе
selsupLink string Нет Поле selsupLink.
tempId integer · int64 Нет Временный id используется для быстрого импорта
category Category Нет Поле category.
findirTips object Нет Советы задачника (тип задачи - текст совета)
commissions string Нет JSON с комиссиями из разных маркетплейсов
commissionCalculations object Нет Расчёт итоговой комиссии по маркетплейсам
lowStockAlerts string Нет JSON для уведомлений о заканчивающихся остатках по маркетплейсов
inputVat number · double Нет Входящий НДС, руб.
outputVat number · double Нет Исходящий НДС, руб.
finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.
incomeTax number · double Нет Налог на прибыль, руб.
totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.
netProfit number · double Нет Чистая прибыль, руб.
margin number · double Нет Чистая маржинальность, %
woocomStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в WooCommerce
dateStartSeason1 string · date Нет Дата начала сезона 1
dateEndSeason1 string · date Нет Дата окончания сезона 1
dateStartSeason2 string · date Нет Дата начала сезона 2
dateEndSeason2 string · date Нет Дата окончания сезона 2
dateStartSeason3 string · date Нет Дата начала сезона 3
dateEndSeason3 string · date Нет Дата окончания сезона 3
dateStartSeason4 string · date Нет Дата начала сезона 4
dateEndSeason4 string · date Нет Дата окончания сезона 4
currentGrossProfit object Нет Текущая валовая прибыль. Для таблицы цены
plannedGrossProfit object Нет Новая валовая прибыль. Для таблицы цены
position integer · int32 Нет позиция продукта
emptyBarcodes boolean Нет Поле emptyBarcodes.
uzumStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Uzum
makroStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Makro
kaspiStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Kaspi
anyLink string Нет Поле anyLink.
anyArticle string Нет Поле anyArticle.
site string Нет Поле site.
shopifyStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Shopify
takealotStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Takealot
yandexKitStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Яндекс.Кит
bobShopStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Bob Shop
minPriceForAllMarketplace number · double Нет Поле minPriceForAllMarketplace.
calculatedInstockQuantity integer · int32 Нет Поле calculatedInstockQuantity.
lamodaParentSku string Нет Родительский SKU товара на Lamoda
uzumProductId integer · int64 Нет Идентификатор товара (productId) на Uzum
woocomParentId integer · int64 Нет ID родительского товара в WooCommerce (для вариаций)
woocomPermalink string Нет Ссылка на товар в WooCommerce
wildberriesSizeId integer · int64 Нет Идентификатор размера на Вайлдбериз
yandexMarketShopSku string Нет SKU товара на Yandex.Market
aliexpressSku string Нет SKU на Aliexpress
wildberriesImtId integer · int64 Нет Используется для категорий, у которых не предусмотрен размер
externalArticle string Нет Уникальный артикул товара для стороннего сервиса
mvideoArticle string Нет Артикул товара на M.Video
ozonProductId integer · int64 Нет Идентификатор товара Озон в кабинете API
leroyMerlinId string Нет Номер карточки на Леруа Мерлен
leroyMerlinArticle string Нет Артикул товара на Леруа Мерлен
magnitArticle string Нет Артикль товара на Magnit
lamodaArticle string Нет Артикул товара на Lamoda
yandexMarketSku integer · int64 Нет Идентификатор карточки товара на Yandex.Market
sberMegaMarketId integer · int64 Нет Карточка СберМегаМаркет
detmirArticle string Нет Артикул товара на Детском мире (productCode / SAP)
moySkladLinkId string Нет ID для ссылки на Мой Склад
ebayArticle string Нет Артикул товара на Ebay
uzumSkuId integer · int64 Нет Идентификатор SKU (skuId) на Uzum
sellerSku string Нет Идентификатор товара на Amazon
takealotSku string Нет SKU товара на Takealot
walmartSku string Нет SKU товара на Walmart
walmartId string Нет Id товара на Walmart (WPID)
woocomSku string Нет SKU товара на WooCommerce
woocomId integer · int64 Нет Id товара на WooCommerce
opencartSku string Нет SKU товара в OpenCart
opencartId integer · int64 Нет Id товара в OpenCart
magnitId string Нет Id товара на Magnit
sberArticle string Нет Артикул товара на СберМегаМаркет
ozonArticle string Нет Уникальный артикул товара для озон. Offer ID в озон
oneCArticle string Нет Уникальный артикул товара для 1c
uzumArticle string Нет Уникальный артикул товара для Uzum
simalandId integer · int64 Нет Уникальный идентификатор товара для Simaland
lamodaSku string Нет SKU товара на Lamoda
ozonFbsSku integer · int64 Нет Идентификатор товара в Озон по FBS
ozonFboSku integer · int64 Нет Идентификатор товара в Озон по FBO
avitoId integer · int64 Нет ID товара в сервисе Avito
detmirId string Нет Id товара на сайте Детского мира (для ссылки на карточку)
magnitSku string Нет SKU товара на Magnit
ozonId integer · int64 Нет Идентификатор товара Озон на сайте. SKU в озон
oneCId string Нет Идентификатор товара в 1С
moySkladId string Нет ID товара в сервисе Мой Склад
nationalCatalogFeedId integer · int64 Нет Идентификатор создания карточки в национальном каталоге
yandexMarketProductId integer · int64 Нет Идентификатор карточки товара на Yandex.Market
nationalCatalogGoodId integer · int64 Нет Идентификатор товара в национальном каталоге
wildberriesPrice number · double Нет Текущая цена товара на Вайлдбериз со скидкой
wildberriesUpdatedPrice number · double Нет Новая цена товара на Вайлдбериз со скидкой.Только для методов изменения цены
wildberriesPriceWithoutDiscount number · double Нет Текущая цена товара на Вайлдбериз без скидки
wildberriesUpdatedPriceWithoutDiscount number · double Нет Новая цена товара на Вайлдбериз без скидки.Только для методов изменения цены
aliexpressPrice number · double Нет Текущая цена на Aliexpress со скидкой
aliexpressPriceWithoutDiscount number · double Нет Текущая цена на Aliexpress без скидки.
aliexpressUpdatedPrice number · double Нет Новая цена со скидкой на Aliexpress. Только для методов обновления цены
aliexpressUpdatedPriceWithoutDiscount number · double Нет Новая цена без скидки на Aliexpress. Только для методов обновления цены
ozonPrice number · double Нет Текущая цена товара на Озон со скидкой
ozonUpdatedPrice number · double Нет Новая цена товара на Озон со скидкой.Только для методов изменения цены
ozonPriceWithoutDiscount number · double Нет Текущая цена товара на Озон без скидки.
ozonUpdatedPriceWithoutDiscount number · double Нет Новая цена Озон без скидки.Только для методов изменения цены
leroyMerlinPrice number · double Нет Текущая цена товара на LeroyMerlin
leroyMerlinUpdatedPrice number · double Нет Новая цена товара на LeroyMerlin.Только для методов изменения цены
avitoPrice number · double Нет Текущая цена товара на Avito
avitoUpdatedPrice number · double Нет Новая цена товара на Avito.Только для методов изменения цены
sberMegaMarketPrice number · double Нет Текущая цена на СберМегаМаркет со скидкой
sberMegaMarketUpdatedPrice number · double Нет Новая цена со скидкой на СберМегаМаркет. Только для методов изменения цены
yandexMarketPrice number · double Нет Текущая цена на Яндекс.Маркет со скидкой
yandexMarketPriceWithoutDiscount number · double Нет Текущая цена на Яндекс.Маркет без скидки
yandexMarketUpdatedPrice number · double Нет Новая цена со скидкой на Яндекс.Маркет. Только для методов изменения цены
yandexMarketUpdatedPriceWithoutDiscount number · double Нет Новая цена без скидки на Яндекс.Маркет. Только для методов изменения цены
productPrices ProductPrice[] Нет Поле productPrices.
stockRules ProductStockRules Нет Правила отправки остатков на маркетплейсы
serviceId integer · int32 Нет Поле serviceId.
{
  "rows": "string"
}
Ошибки3

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

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

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

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

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

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

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

GET

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

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

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

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

ПолеТипОбязательноОписание
query string Нет Поисковый запрос. Может содержать штрих-код, часть названия товара, внешние идентификаторы товаров Wildberries или Ozon
article string Нет Поиск по названию артикула товара
color string Нет Поиск по названию цвета товара
viewId integer · int64 Нет Поиск по идентификатору цвета
skuViewId integer · int64 Нет Поиск по SKU идентификатору цвета
modelId integer · int64 Нет Поиск по идентификатору модели
groupId integer · int64 Нет Фильтр по ID групповой карточки
groupIds integer[] Нет Фильтр по ID групповых карточек. groupIds=1&groupIds=2
needToBuy boolean Нет Товары, которые нужно показать в списке для заказа?
planDays integer · int32 Нет Количество дней на которые планировать закупки. По умолчанию 30
daysToSupply integer · int32 Нет Через сколько дней ожидается поставка. По умолчанию 0
organizations integer[] Нет Фильтр по ID организаций. Передается несколько значений organizations=1.organizations=2
needUpdatePrice boolean Нет Фильтр по необходимости обновить цену на Wildberries?
testCard boolean Нет Тестовая карточки для создания?
hasImages boolean Нет Наличие или отсутствие картинок у товара?
isDuplicate boolean Нет Карточка является дубликатом?
hasWildberriesId boolean Нет Наличие карточки товара в Wildberries?
hasSupplyingQuantity boolean Нет Наличие поставляемого количества по модели FBM?
noWbImages boolean Нет Наличие фото на Wildberries?
noOzonImages boolean Нет Наличие фото на Ozon?
noYMImages boolean Нет Наличие фото на Яндекс.Маркет?
deleted boolean Нет Показать помеченные удаленными товары?
hasGroup boolean Нет Наличие групповой карточки у товара?
modelDeleted boolean Нет Показать помеченные удаленными модели?
viewDeleted boolean Нет Показать помеченные удаленными цвета?
inStock boolean Нет Наличие остатков товаров на маркетплейсе или складе?
noStock boolean Нет Отсутствие остатков товаров на маркетплейсе и складе?
inFbsStock boolean Нет Наличие остатков на складах в SelSup?
noFbsStock boolean Нет Отсутствие остатков на складах в SelSup?
inFboStock boolean Нет Наличие остатков на складах FBO?
noFboStock boolean Нет Отсутствие остатков на складах FBO?
hasStockInWarehouse integer · int64 Нет ID склада на котором есть остатки в SelSup
hasQuantity boolean Нет Поле hasQuantity.
noStockInWarehouse integer · int64 Нет ID склада на котором нет остатков в SelSup
grouped boolean Нет Группировать товары по цветам?
uniqView boolean Нет Отдавать только товары с уникальными цвета?
uniqViewSku boolean Нет Отдавать только товары с уникальными цвета без дубликатов по остаткам?
uniqModel boolean Нет Отдавать только товары с уникальными моделями?
uniqSku boolean Нет Отдавать только товары с уникальными SKU?
contractors integer[] Нет Фильтр по ID поставщикам товара. Передается несколько параметров contractors=1&contractors=2
categories integer[] Нет Фильтр по ID категориям товара.Передается несколько параметров categories=1&categories=2
brands integer[] Нет Фильтр по ID брендам товара
stockRefreshDate string · date-time Нет Поле stockRefreshDate.
wildberriesRating integer[] Нет Фильтр товаров по рейтингу отзывов Вайлдбериз
wildberriesCardDoesNotOpen boolean Нет Фильтр товаров для не открывается карточка в Вайлдбериз: значит не создана карточка, либо не загружены картинки и пр?
productId integer · int64 Нет Поле productId.
productIds integer[] Нет Фильтр по ID товаров. Можно передавать несколько значений productIds=1&productIds=2
sourceOrganizationIds integer[] Нет Фильтр товаров, которые были импортрованы в другие организации
needImportWildberriesCard boolean Нет Фильтр товаров для которых нужно обновить карточку в Вайлдбериз?
needImportOzonCard boolean Нет Фильтр товаров для которых нужно обновить карточку в Ozon?
needImportAliexpressCard boolean Нет Фильтр товаров для которых нужно обновить карточку в Aliexpress?
needUpdateFromSimaland boolean Нет Фильтр товаров для которых нужно обновить стоки и цены в Simaland?
favourite boolean Нет Фильтр по избранным товарам, которые клиент пометил избранными?
status stringCREATED, IN_STOCK, LOST, RESERVED, SUPPLIED, REMOVED, SALE, REFUND, INCOME_MARKETPLACE Нет Статус единицы хранения товара на складе
modifiedAfter string · date-time Нет Фильтр по дате модификации для WmsItem
actual boolean Нет Фильтр по показателю актуальности?
skuId integer · int64 Нет Фильтр по skuId - идентификатору остатка
skuIds integer[] Нет Фильтр по skuIds
lastInventoryId integer · int32 Нет Фильтр по ID инвентаризации для WmsItem
strategyId integer · int64 Нет Фильтр по стратегии ценообразования
strategyIds integer[] Нет Множественный фильтр по стратегии ценообразования
cellId integer · int32 Нет Фильтр по ID ячейке для WmsItem
itemId integer · int64 Нет Фильтр по ID остатка для WmsItem
warehouseId integer · int64 Нет Фильтр ID склада для WmsItem
avitoCategoryId integer · int64 Нет ID категории Авито
hasAvitoCategory boolean Нет Поле hasAvitoCategory.
services string[] Нет Список сервисов в которых не создана карточка. Например, services=WILDBERRIES&services=OZON
createdIn string[] Нет Список сервисов в которых создана карточка. Например, createdIn=WILDBERRIES&createdIn=OZON
duplicate boolean Нет Является ли карточка дубликатом?
orderService 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 Нет Сервис
productType stringPRODUCT, SET, SERVICE, DIGITAL Нет Фильтр по типу товара, type=PRODUCT или type=SET
withCategoryAndBrand boolean Нет Признак, что грузим категорию и бренд?
allServices boolean Нет Признак, что грузить данные по всем сервисам?
inWarehouseRegions string[] Нет Подгружать ФБО остатки/продажи со складов входящих в список регионов
inWarehouses integer[] Нет Подгружать ФБО остатки/продажи со складов входящих в список
excludeStockWarehouses integer[] Нет ID складов SelSup, остатки которых не учитывать при планировании закупок
incomeOrderId integer · int64 Нет Фильтр товаров по ID заказа
incomeId integer · int64 Нет Фильтр товаров по ID заказа поставщика
itemIncomeOrderId integer · int64 Нет Фильтр остатков из приемки
dateFrom string · date-time Нет Дата начала
dateTo string · date-time Нет Дата окончания
plannedSupplyDate string · date-time Нет Планируемая дата поставки
timeZone integer · int32 Нет Часовой пояс клиента по UTC
ids integer[] Нет Фильтр по ID товаров. Можно передавать несколько значений ids=1&ids=2
skipDayWithoutStocks boolean Нет Пропускать дни без остатков?
countByOrders boolean Нет Делать расчет по заказам, если true, и по продажам, если false?
requierPlan number · double Нет Фильтр по Рекомендации к поставке
forPrices boolean Нет Отдавать в ответе данные для таблицы цен?
deliveryDate string Нет Фильтр по дате доставки заказа
onlyEmptyParchasePrice boolean Нет Выгружать товары только с пустыми закупочными ценами?
onlyEmptyDeliveryCostPrice boolean Нет Выгружать товары только с пустыми дополнительными расходами?
forFboSupplyPlan boolean Нет Показывает для чего идет расчет планирования для фбо или поставок?
ignoreParams boolean Нет Признак для выгрузки карточек без параметров?
ungroupWarehouses boolean Нет Если true - не группировать по складам, то есть вывести список продуктов отдельный для каждого склада. Используется в планировании поставок
replaceSetsByComponents boolean Нет Признак раскрывать ли комплекты?
distributeFbsByWarehouse boolean Нет Распределять FBS по складам пропорционально FBO
distributeFbsStock boolean Нет Распределять остатки FBS между маркетплейсами/складами
ignoreDumping boolean Нет Игнорировать слив товара (продажи по заниженной цене)
distributeAllRecommendations boolean Нет Распределять все рекомендации из не попавших в поиск складов
limitByFbsStocks boolean Нет Ограничивать суммарный план поставки текущим остатком FBS
useSalesPlan boolean Нет Считать дефицит по плану продаж из отчета План/Факт продаж, а не по фактическим продажам/заказам
packagingType stringBox, Monopallet, Supersafe, BoxOnPallet Нет Тип упаковки для фильтрации доступных складов WB
notGroupComponents boolean Нет Признак не группировать компоненты?
modelArticle string Нет Фильтр по артикулу модели
serviceArticle string Нет Фильтр по артикулу товара на внешнем сервисе
serviceArticleService 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 Нет Сервис
ozonArticle string Нет Фильтр по артикулу Ozon
yandexMarketShopSku string Нет Фильтр по артикулу Яндекс.Маркет
sberArticle string Нет Поле sberArticle.
wbArticle string Нет Поле wbArticle.
barcode string Нет Фильтр по штрих-коду
name string Нет Фильтр по названию товара
reportSheets stringBARCODE, COLOR, ARTICLE Нет Поле reportSheets.
forSupplyPlan boolean Нет Поле forSupplyPlan.
tagIds integer[] Нет Фильтр по ID тегов. Только товары, привязанные к этим тегам
findirTipTypes string[] Нет Фильтр по типу рекомендаций AI Финдир
removeFbsStock boolean Нет Флаг отключения передачи FBS остатков для организаций и сервисов
limit integer · int32 Нет Ограничение на количество записей. Максимальное значение - 500
page integer · int32 Нет Номер страницы начиная с 1
count boolean Нет Возвратить в ответе общее количество записей
sortBy stringACTUAL, ID, PRODUCTID, NAME, BARCODE, FAVOURITE, INSTOCKQUANTITY, FBSQUANTITY, CALCULATEDINSTOCKQUANTITY, STOCK, OZONSTOCKCOUNT, OZONSUPPLYINGQUANTITY, OZONORDERQUANTITY, OZONFBSORDERSQUANTITY, OZONSTOCKBETWEENWAREHOUSES, OZONUPDATEDPRICE, LASTWILDBERRIESORDERDATE, WILDBERRIESSTOCKCOUNT, WILDBERRIESSUPPLYINGQUANTITY, WILDBERRIESFBSORDERSQUANTITY, WILDBERRIESORDERQUANTITY, WILDBERRIESPROFIT, WILDBERRIESPRICE, WILDBERRIESUPDATEDPRICE, PRICE, PRICEWITHOUTDISCOUNT, PURCHASEPRICE, PURCHASECURRENCY, MANUFACTURER, REALSIZE, CATEGORY, VENDORSIZE, DELIVERYCOST, WILDBERRIESSALEQUANTITY, WILDBERRIESQUANTITYINWAY, OZONPRICE, OZONPROFIT, LASTOZONORDERDATE, ARTICLE, COLOR, SIZE, CREATEDUSER, ORGANIZATIONID, BRAND, CREATEDDATE, LASTSTOCKCHANGE, STATUS, CELL, ITEMID, ORDERID, PUTUSERID, PUTDATE, TAKEUSERID, TAKEDATE, INCOMEORDER, NUMBER, TOTALQUANTITY, SUPPLYORDERPRODUCTID, TOTALORDERS, UPDATEDPRICE, QUANTITY, ALIEXPRESSPRICE, YANDEXMARKETPRICE, SKU, SERVICEARTICLE, OZONARTICLE, WBARTICLE, YANDEXMARKETSHOPSKU, YANDEXMARKETSTOCKCOUNT, ALIEXPRESSSKU, SBERARTICLE, ONECARTICLE, ADD, ORDERMINDATE, INCOMEQUANTITY, SBERMEGAMARKETSUPPLYINGQUANTITY, YANDEXMARKETSUPPLYINGQUANTITY, TOTALSUPPLYINGQUANTITY, TOTALFBSORDERSCOUNT, STOCKCOUNTUNITED, FBOSTOCKCOUNT, RECOMENDSALESPLAN, WBTOTALSALESCOUNT, OZONTOTALSALESCOUNT, SBERTOTALSALESCOUNT, YANDEXTOTALSALESCOUNT, EXTERNALARTICLE, FBOSALES, IMAGESUPDATEDAT Нет Поле для сортировки
ascending boolean Нет Порядок сортировки - по возрастанию?. Работает только при получении списка.
curl --request GET 'https://api.selsup.ru/api/findir/product/find?limit=50&page=1' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта FindResponseProduct
ПолеТипОбязательноОписание
rows Product[] Нет Строки с результатом поиска
Структура элемента массива Product
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор товара. Проставляется автоматически
productType stringPRODUCT, SET, SERVICE, DIGITAL Нет Тип товара
name string Да Наименование товара внутреннее
deleted boolean Нет Признак удаления товара
printName string Нет Название товара для внешних сервисов. Если не задано, проставляется равным наименованию товара
realSize string Нет Российский размер товара для одежды или характеристики для других категорий
vendorSize string Нет Размер производителя или характеристики производителя. Не обязательно заполнять
size string Нет Размер для одежды или характеристики для внешних сервисов. Должен быть уникальным в рамках цвета
wildberriesStockCount integer · int32 Нет Остатки товара на Вайлдбериз
ozonRealFbs boolean Нет Признак использования RealFbs для товара
ozonStockCount integer · int32 Нет Остаток товара на складах Озон
ozonStockBetweenWarehouses integer · int32 Нет Остаток товара в Озон, которые перемещаются между складами
removeFbsStock boolean Нет Не выгружать остатки товара на маркетплейсы
noStockSync boolean Нет Не синхронизировать остатки: товар полностью исключается из передачи остатков на все маркетплейсы, текущий остаток на МП не изменяется
purchaseCurrency stringRUB, 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 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
createdDate string · date-time Нет Дата создания товара на МП
created string · date-time Нет Дата создания товара в SelSup
createdUser string Нет Пользователь, который создал товар
sourceIncomeItemId integer · int64 Нет Идентификатор товара из заказа поставщика по данным которого был создан товар
sourceProductId integer · int64 Нет Идентификатор товара, который копировали
ozonRequiredStock integer · int32 Нет Расчитанное количество товара, для поставки на склад Озон
wildberriesRequiredStock integer · int32 Нет Расчитанное количество товара, для поставки на склад Wildberries
wildberriesProfit number · double Нет Профит с продажи товара на Вайлдбериз по FBM
wildberriesProfitFbs number · double Нет Профит с продажи товара на Вайлдбериз по FBS
wildberriesOrderQuantity integer · int32 Нет Количество заказов по FBO товара на Вайлдбериз за 2 недели
wildberriesSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам
wildberriesQuantityInWayToClient integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам к клиенту
wildberriesQuantityInWayFromClient integer · int32 Нет Поставляемое количество товара на Вайлдбериз по FBM заказам от клиента
wildberriesSaleQuantity integer · int32 Нет Продажи товара на Вайлдбериз по FBM за 2 недели
wildberriesQuantityInWay integer · int32 Нет Количество товаров на Вайлдбериз в пути
wildberriesNoSale boolean Нет Признак неликвидного товара на Вайлдбериз
lastStockChange string · date-time Нет Дата последнего изменения стока на Вайлдбериз по FBM
ozonOrderQuantity integer · int32 Нет Количество заказов товара по FBO на Озон по FBM и FBS за 2 недели
ozonSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Озон по FBM
ozonProfit integer · int32 Нет Чистая маржа продажи товара на Озон по FBM
instockQuantity integer · int32 Нет Остатки товара на складах клиента
instockQuantityValue number · double Нет Остатки товара на складах клиента в пользовательской единице измерения
stockUnit stringPCS, G, KG, ML, L Нет Единица измерения остатка товара для интерфейса и внешних интеграций
calculatedInStockQuantity integer · int32 Нет Рассчитанный остаток
calculatedInStockQuantityValue number · double Нет Рассчитанный остаток в пользовательской единице измерения
clientId integer · int64 Нет Идентификатор клиента
organizationId integer · int64 Да Идентификатор организации
productViewId integer · int64 Нет Идентификатор цвета
view ProductView Нет Информация о цвете товара
Поля объекта ProductView
ПолеТипОбязательноОписание
color string Нет Артикул цвета
wbArticle string Нет Артикул карточки Wildberries
needKiz boolean Нет Требуется ли обязательная маркировка по данным Wildberries
id integer · int64 Нет Идентификатор цвета. Проставляется автоматически
images ProductImage[] Нет Список изображений товара
videos ProductVideo[] Нет Список видео товара
productModelId integer · int64 Нет Идентификатор модели
model ProductModel Нет Модель, к которой относится цвет
actual boolean Нет Актуальность цвета - нужно ли его показывать в заказах поставщикам
mainImage ProductImage Нет Основное изображение товара
mainImageId integer · int64 Нет Поле mainImageId.
mainImageUrl string Нет Ссылка на основное изображение на маркетплейсе
imageUrls string Нет Ссылка на изображения
imagesUpdatedAt string · date-time Нет Дата/время последнего изменения фотографий
image360Urls string Нет Ссылка на изображения 360
wildberriesId integer · int64 Нет Числовой идентификатор номенклатуры Wildberries, nmId
createdDate string · date-time Нет Дата создания цвета
createdUser string Нет Пользователь, создавший цвет
versionId integer · int64 Нет Поле нужно передавать при изменении,для предотвращения одновременной перезаписи
clientId integer · int64 Нет Идентификатор клиента
deleted boolean Нет Признак удаления цвета
keywords string Нет Ключевые слова - сейчас не используется, перенесены в модель
wildberriesRating number · double Нет Рейтинг карточки на Вайлдбериз
wildberriesFeedbacks integer · int32 Нет Количество отзывов на карточке на Вайлдбериз
wbRaiting number · double Нет Рейтинг карточки на Вайлдбериз
wbFeedbackCount integer · int32 Нет Количество отзывов на карточке на Вайлдбериз
wbPriceWithSpp number · double Нет Цена карточки на Вайлдбериз с учетом СПП, руб.
wildberriesCardDoesNotOpen boolean Нет Признак, что карточка не открывается на Вайлдбериз
wildberriesHasPhoto boolean Нет Признак наличия фото на Wildberries
organizationId integer · int64 Нет Организация карточки
params string Нет JSON со значениями параметров цвета
additionalInfo string Нет Дополнительная информация для цвета
values ParamValue[] Нет Значения параметров карточки. Отдаются при запросе модели, если передать params=true
viewSourceId integer · int64 Нет Оригинал цвета по SKU
sizes Product[] Да Список размеров для цвета
hasChanges boolean Нет Признак изменения информации о цвете и необходимости его обновить
viewWbArticle ProductView Нет Поле viewWbArticle.
viewVersionId integer · int64 Нет Поле viewVersionId.
suzId string Нет GTIN товара
cisType stringUNIT, BUNDLE, GROUP, SET, ATK Нет Тип в национальном каталоге
notChangedStock integer · int32 Нет Количество дней, в течении которых не менялся остаток товара
cardExchanges ProductCardExchange[] Нет Последние статусы обмена карточки с маркетплейсами
Структура элемента массива ProductCardExchange
ПолеТипОбязательноОписание
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 Нет Сервис
status stringWAITING_TO_SEND, SENT, ACCEPTED, ERROR Нет Поле status.
lastAttemptAt string · date-time Нет Поле lastAttemptAt.
errorSource stringSELSUP, MARKETPLACE Нет Поле errorSource.
message string Нет Поле message.
messageParams string Нет Поле messageParams.
wildberriesStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Вайлдбериз
wildberriesMessage string Нет Ошибка создания карточки товара в Вайлдбериз
wildberriesMessageParams string Нет JSON параметров ошибки создания карточки товара в Вайлдбериз
nationalCatalogStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Национальном каталоге
nationalCatalogMessage string Нет Ошибка создания карточки товара в Национальном каталоге
nationalCatalogMessageParams string Нет Параметры ошибки создания карточки товара в Национальном каталоге
ozonStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Озон
ozonMessage string Нет Ошибка создания карточки товара в Озон
ozonMessageParams string Нет JSON параметры ошибки создания карточки товара в Озон
ozonTaskId integer · int64 Нет Идентификатор задания по обновления или созданию карточки в Озон
wildberriesFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке WB по FBS за 2 недели
ozonFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке на Ozon по FBS за 2 недели
ymarketFbsOrdersQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке на Яндекс Маркете по FBS за 2 недели
totalSupplyingQuantity integer · int32 Нет Кол-во заказанных товаров на данной карточке за 2 недели
skuId integer · int64 Нет Идентификатор единицы хранения товара на складе. Проставляется автоматически
sku Sku Нет Поле sku.
Поля объекта Sku
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
product object Нет Первый товар из которого был создан SKU
productId integer · int64 Нет Поле productId.
barcodes ProductBarcode[] Нет Штрих-коды товара
Структура элемента массива ProductBarcode
ПолеТипОбязательноОписание
id integer · int64 Нет Поле id.
barcode string Нет Поле barcode.
organizationId integer · int64 Нет Организация, если client.barcodeUniqForOrg = false, то проставляется 0. Поле включено в уникальный ключ
clientId integer · int64 Нет Поле clientId.
productId integer · int64 Нет Поле productId.
useInWildberries boolean Нет Применим ли данный штрих-код для Вайлдбериз
useInOzon boolean Нет Применим ли данный штрих-код для Озон
useInYandexMarket boolean Нет Применим ли данный штрих-код для Yandex.Market
useInAliexpress boolean Нет Применим ли данный штрих-код для Aliexpress
useInSberMegamarket boolean Нет Применим ли данный штрих-код для Sber.MegaMarket
useInWoocom boolean Нет Применим ли данный штрих-код для WooCommerce
format string Нет Поле format.
serviceProducts ServiceProduct[] Нет Cвязи с товарами маркетплейсов
Структура элемента массива ServiceProduct
ПолеТипОбязательноОписание
serviceProductId integer · int64 Нет Идентификатор продукта сервиса
productId integer · int64 Нет Идентификатор продукта
serviceId integer · int32 Нет Идентификатор сервиса
serviceListingId integer · int64 Нет Идентификатор листинга на сервисе
serviceCardId integer · int64 Нет Поле serviceCardId.
fboStock integer · int32 Нет Остаток на ФБО складах
lastRepricerPriceStatus stringNONE, SUCCESS, ERROR Нет Последний статус обновления цены через репрайсер
errorMessage string Нет Ошибка при установки цены через репрайсер
serviceCard string Нет Идентификатор карточки на сервисе
serviceCardProduct string Нет Идентификатор товара на сервисе
serviceCardUrl string Нет Ссылка на карточку на сервисе (если несколько товаров отображаются)
serviceProductUrl string Нет Ссылка на товар селлера на сервисе
serviceBarcode string Нет Штрих код на сервисе
fboCommissions number · double Нет Комиссия ФБО
fbsCommissions number · double Нет Комиссия ФБС
purchasePercent number · double Нет Процент выкупа
serviceArticle string Нет Артикул на сервисе
clientId integer · int64 Нет Идентификатор клиента
organizationId integer · int64 Нет Идентификатор организации
siteArticle string Нет артикул товара на сайте
siteId string Нет айди товара на сайте
params string Нет JSON значений параметров для данного размера/характеристик
values ParamValue[] Нет Значения параметров карточки. Отдаются при запросе модели, если передать params=true
Структура элемента массива ParamValue
ПолеТипОбязательноОписание
paramId integer · int64 Да Идентификатор параметра
paramName string Нет Название параметра, для тех, у кого нет ID
option Option Нет Значение перечислимого параметра
doubleValue number · double Нет Числовое значение параметра
longValue integer · int64 Нет Целочисленное значение параметра
booleanValue boolean Нет Булево значение параметра
stringValue string Нет Строковое значение параметра
dateValue string · date-time Нет Значение параметра даты
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 Нет Привязка к сервису параметра
unit Unit Нет Единица измерения для параметра
auto boolean Нет Автоматически проставленное значение параметра
created integer · int64 Нет Дата заполнения параметра
user string Нет Пользователь, который заполнил параметр
locked boolean Нет Значение зафиксировано и не должно изменяться при импорте карточек с маркетплейса
group object Нет Группа карточек. Используется на списке товаров, чтобы объединить разные размеры в одну строку
duplicates Product[] Нет Дубликаты карточки по остаткам. Отдаются только на списке товаров, если включена галочка Объединять дубликаты
hasChanges boolean Нет Признак наличия изменений в товаре и ее нужно обновить при сохранении
ignoreDuplicate boolean Нет Признак игнорирования дубликатов при создании
yandexMarketStockCount integer · int64 Нет Остаток товара на складах Yandex.Market
groupId integer · int64 Нет ID групповой карточки
yandexMarketStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара на яндекс маркет
yandexMarketMessage string Нет Сообщение при ошибке создания карточки товара на яндекс маркет
yandexMarketMessageParams string Нет Параметры сообщения при создании товара в Яндекс.Маркет
duplicate boolean Нет Признак, что карточка является дубликатом. Отдается не для всех методов
ozonHasPhoto boolean Нет Признак наличия фото на Ozon
aliexpressStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания товара на Aliexpress
aliexpressMessage string Нет Сообщение при создании товара на Aliexpress
aliexpressMessageParams string Нет Параметры сообщения при создании товара на Aliexpress
moySkladType string Нет Тип товара в сервисе Мой Склад
moySkladStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в МойСклад
avitoStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус обьявления на Авито
moySkladMessage string Нет Ошибка создания карточки товара в МойСклад
moySkladMessageParams string Нет Параметры ошибки создания карточки товара в МойСклад
removeFbsStockOzon boolean Нет Не передавать остатки товара по FBS на озон
removeFbsStockWb boolean Нет Не передавать остатки товара по FBS на Wildberries
removeFbsStockAli boolean Нет Не передавать остатки товара по FBS на Aliepress
removeFbsStockYm boolean Нет Не передавать остатки товара по FBS на Яндекс.Маркет
removeFbsStockSber boolean Нет Не передавать остатки товара по FBS на СберМегаМаркет
quantity integer · int32 Нет Количество товара в заказах. Возвращается только в методах income/getProductsFromOrders или wms/findStock
incomeQuantity integer · int32 Нет Количество товара в закупке без разделения по маркетплейсам
orderMinDate string · date-time Нет Минимальная дата заказа. Возвращается только в методах income/getProductsFromOrders
expiredDate string · date-time Нет Cрок годности товара - возвращается только в методах, wms/findStock
productionDate string · date-time Нет Дата производства
stock integer · int32 Нет Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock
stockValue number · double Нет Остаток на складе в пользовательской единице измерения
stocks object Нет Остатки товара на складах - возвращается только в методах, wms/fetchStock
cell Cell Нет Ячейка хранения товара на определенном складе - возвращается только в методах, wms/fetchStock
Поля объекта Cell
ПолеТипОбязательноОписание
id integer · int32 Нет Идентификатор ячейки
warehouseId integer · int64 Нет Склад к которому относится ячейка
passageId integer · int32 Нет Проход на складе, к которому относится ячейка. Может соджержать название этажа и пр
shelfId integer · int32 Нет Полка стеллажа, к которой относится ячейка
rackId integer · int32 Нет Стеллаж, к которому относится ячейка
name string Нет Название ячейки. По умолчанию формируется автоматически
fullName string Нет Полное название ячейки из названий прохода, стелажа, полки и ячейки
sortName string Нет Название для сортировки ячейки из названий прохода, стелажа, полки и ячейки
barcode string Нет Уникальный в рамках клиента штрих-код ячейки для идентификации ячейки с помощью сканера штрих-кода. Присваивается автоматически при создании ячейки
deleted boolean Нет Признак того, что ячейка удалена
width integer · int32 Нет Ширина ячейки для определения товаров, которые можно положить в нее
height integer · int32 Нет Высота ячейки для определения товаров, которые можно положить в нее
depth integer · int32 Нет Глубина ячейки для определения товаров, которые можно положить в нее
clientId integer · int64 Нет Клиент которому принадлежит ячейка. Проставляется автоматически
lastInventoryId integer · int32 Нет Идентификатор последней инвентаризации
type stringNORMAL, NO_PLACE, REFUND Нет Тип ячейки: NORMAL, NO_PLACE - не разложенные, REFUND - для возвратов
reserved integer · int32 Нет Остаток товара на определенном складе - возвращается только в методах, wms/fetchStock
reservedValue number · double Нет Резерв в пользовательской единице измерения
calculatedStock integer · int32 Нет Остаток наборов на определенном складе - возвращается только в методах, wms/fetchStock, product/findProduct, supply/findProductForOrder
calculatedStockValue number · double Нет Рассчитанный остаток набора в пользовательской единице измерения
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 Нет Дополнительные расходы на доставку товара в руб. Добавляются к закупочной цене
strategyId integer · int64 Нет Идентификатор стратегии ценообразования
ozonAverageExpenses number · double Нет Расходы по продаже товара на Ozon
wildberriesAverageExpenses number · double Нет Расходы по продаже товара на Wildberries
yandexMarketAverageExpenses number · double Нет Расходы по продаже товара на ЯМ
wildberriesSale integer · int32 Нет Скидка товара на Вайлдбериз
minPrice number · double Нет Минимальная цена товара. Ниже этой цены нельзя выставлять цену на товар.Используется для Ozon при участии товара в акциях
ozonPromotionPrice number · double Нет Текущая акционная цена товара на Озон
ozonAcquiringPercent number · double Нет Максимальная комиссия за эквайринг OZON
ozonComisson number · double Нет Комиссия товара на Озон FBM
sberMegaMarketSupplyingQuantity integer · int32 Нет Поставляемое количество товара на СберМегаМаркет по FBM заказам
yandexMarketSupplyingQuantity integer · int32 Нет Поставляемое количество товара на Яндекс.Маркет по FBM заказам
salesExpensesOnMpPercent number · double Нет Расходы по продажам на маркетплейсе, %
salesCountCoefficient number · double Нет Коэффициент пересчета продаж и возвратов в товарной аналитике
measureUnitId integer · int32 Нет Единица измерения товара (ID единицы измерения)
taxeRate number · double Нет Установленый процент налога на товар, %
desiredMarginalityPercent number · double Нет Желаемый % маржинальности
desiredProfitRub number · double Нет Желаемая прибыль, руб.
additionalCost number · double Нет Доп. расходы на товар без записи в Финансовую аналитику, руб.
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
totalOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по МП OZON + WB
totalFbsOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по FBS за 2 недели
wildberriesTotalOrdersCount integer · int32 Нет Кол-во заказанных товаров на данной карточке по МП WB
ignoreFbsWarehouses string Нет Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS
fbsWarehouses string Нет Список идентификаторов складов маркетплейсов через запятую - на которые не отправлять остатки по FBS
minFbsStock integer · int32 Нет Минимальный остаток - если меньше, то ставим 0
maxFbsStock integer · int32 Нет Максимальный остаток - если больше, то ставим его
wildberriesSaleLogistic number · double Нет Логистика WB, руб.
wildberriesReturnLogistic number · double Нет Обратная логистика WB, руб.
wildberriesTotalLogistics number · double Нет Логистика WB итого, руб.
wildberriesWarehouseRatio number · double Нет Коэффициент склада WB в %
wildberriesComission number · double Нет Комиссия WB, %
ozonSaleLogistic number · double Нет Логистика Ozon, руб.
ozonReturnLogistic number · double Нет Обратная логистика Ozon, руб.
ozonCommission number · double Нет Комиссия Ozon, %
maxDeliveryToPickupPoint number · double Нет Максимальная стоимость доставки до места выдачи, руб.
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
ozonRaiting number · double Нет Рейтинг товара на Ozon
ozonFeedbackCount integer · int32 Нет Количество отзывов на товар на Ozon
ozonPriceWithSpp number · double Нет Цена товара на Ozon с учетом СПП, руб.
fboStockCount integer · int64 Нет Остаток ФБО по выбранным складам/регионам
fbsStockCount integer · int64 Нет Остаток ФБC для планирования поставок)
stockCoverageDays integer · int64 Нет На сколько дней хватит текущего остатка ФБО на складе
fboSupplyQuantity integer · int64 Нет Количество поставляемого товара по выбранным складам/регионам
fboSales integer · int64 Нет Кол-во продаж FBO по складам/регионам для планирования поставок
fbsSales integer · int64 Нет Кол-во продаж FBS по складам/регионам для планирования поставок
fboOrders integer · int64 Нет Кол-во заказов FBO по складам/регионам для планирования поставок
fbsOrders integer · int64 Нет Кол-во заказов FBS по складам/регионам для планирования поставок
recommendPlan number · double Нет Кол-во товара для добавления к заказу
baseDeficit integer · int64 Нет Базовый дефицит склада до распределения остатков без склада назначения
allocatedWithoutWarehouse integer · int64 Нет Часть общих остатков без склада назначения, распределенная на склад
skipDaysCount integer · int32 Нет Кол-во пропущенных дней в учёте планирования поставок
organizationShortName string Нет Поле organizationShortName.
contractorName string Нет Поле contractorName.
supplyPlanBarcode string Нет Поле supplyPlanBarcode.
planCorrectionFactor number · double Нет Коэффициент коррекции для планирования поставок. На это значение умножается рассчитанное количество товара для поставки
orderBefore integer · int32 Нет До какого времени должен быть сделан заказ от 1 до 24
daysBeforeSupply integer · int32 Нет Кол-во дней до поставки. Через сколько дней с момента заказа ориентировочно будет поставка товаров
supplyPlanDays integer · int32 Нет На сколько дней планировать остаток
warehouseIdForSupplyReport integer · int64 Нет Id склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок
warehouseNameForSupplyReport string Нет Название склада на который нужно поставить рассчитанные товары. Используется только в планировании поставок
wbCanBox boolean Нет Можно ли отгружать товар на склад WB в коробах
wbCanMonopallet boolean Нет Можно ли отгружать товар на склад WB в монопаллете
wbCanSupersafe boolean Нет Можно ли отгружать товар на склад WB в Supersafe
wbCanBoxOnPallet boolean Нет Можно ли отгружать товар на склад WB в коробах на паллете
manager string Нет Поле менеджера
cellId integer · int32 Нет Поле cellId.
drrPercent integer · int32 Нет ДРР% - доля рекламных расходов
percentForParticipationPromoOrAdvertising integer · int32 Нет Закладываемый % для участия в акциях или рекламе
selsupLink string Нет Поле selsupLink.
tempId integer · int64 Нет Временный id используется для быстрого импорта
category 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
findirTips object Нет Советы задачника (тип задачи - текст совета)
commissions string Нет JSON с комиссиями из разных маркетплейсов
commissionCalculations object Нет Расчёт итоговой комиссии по маркетплейсам
lowStockAlerts string Нет JSON для уведомлений о заканчивающихся остатках по маркетплейсов
inputVat number · double Нет Входящий НДС, руб.
outputVat number · double Нет Исходящий НДС, руб.
finalVat number · double Нет Итоговый НДС (исходящий - входящий), руб.
incomeTax number · double Нет Налог на прибыль, руб.
totalTax number · double Нет Общий налог (НДС + налог на прибыль), руб.
netProfit number · double Нет Чистая прибыль, руб.
margin number · double Нет Чистая маржинальность, %
woocomStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в WooCommerce
dateStartSeason1 string · date Нет Дата начала сезона 1
dateEndSeason1 string · date Нет Дата окончания сезона 1
dateStartSeason2 string · date Нет Дата начала сезона 2
dateEndSeason2 string · date Нет Дата окончания сезона 2
dateStartSeason3 string · date Нет Дата начала сезона 3
dateEndSeason3 string · date Нет Дата окончания сезона 3
dateStartSeason4 string · date Нет Дата начала сезона 4
dateEndSeason4 string · date Нет Дата окончания сезона 4
currentGrossProfit object Нет Текущая валовая прибыль. Для таблицы цены
plannedGrossProfit object Нет Новая валовая прибыль. Для таблицы цены
position integer · int32 Нет позиция продукта
emptyBarcodes boolean Нет Поле emptyBarcodes.
uzumStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Uzum
makroStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Makro
kaspiStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Kaspi
anyLink string Нет Поле anyLink.
anyArticle string Нет Поле anyArticle.
site string Нет Поле site.
shopifyStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Shopify
takealotStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Takealot
yandexKitStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Яндекс.Кит
bobShopStatus stringUNKNOWN, CREATING, CREATED, SUCCESS, ERROR, UPDATING, EXCEPTION, SIGN, MODERATION Нет Статус создания карточки товара в Bob Shop
minPriceForAllMarketplace number · double Нет Поле minPriceForAllMarketplace.
calculatedInstockQuantity integer · int32 Нет Поле calculatedInstockQuantity.
lamodaParentSku string Нет Родительский SKU товара на Lamoda
uzumProductId integer · int64 Нет Идентификатор товара (productId) на Uzum
woocomParentId integer · int64 Нет ID родительского товара в WooCommerce (для вариаций)
woocomPermalink string Нет Ссылка на товар в WooCommerce
wildberriesSizeId integer · int64 Нет Идентификатор размера на Вайлдбериз
yandexMarketShopSku string Нет SKU товара на Yandex.Market
aliexpressSku string Нет SKU на Aliexpress
wildberriesImtId integer · int64 Нет Используется для категорий, у которых не предусмотрен размер
externalArticle string Нет Уникальный артикул товара для стороннего сервиса
mvideoArticle string Нет Артикул товара на M.Video
ozonProductId integer · int64 Нет Идентификатор товара Озон в кабинете API
leroyMerlinId string Нет Номер карточки на Леруа Мерлен
leroyMerlinArticle string Нет Артикул товара на Леруа Мерлен
magnitArticle string Нет Артикль товара на Magnit
lamodaArticle string Нет Артикул товара на Lamoda
yandexMarketSku integer · int64 Нет Идентификатор карточки товара на Yandex.Market
sberMegaMarketId integer · int64 Нет Карточка СберМегаМаркет
detmirArticle string Нет Артикул товара на Детском мире (productCode / SAP)
moySkladLinkId string Нет ID для ссылки на Мой Склад
ebayArticle string Нет Артикул товара на Ebay
uzumSkuId integer · int64 Нет Идентификатор SKU (skuId) на Uzum
sellerSku string Нет Идентификатор товара на Amazon
takealotSku string Нет SKU товара на Takealot
walmartSku string Нет SKU товара на Walmart
walmartId string Нет Id товара на Walmart (WPID)
woocomSku string Нет SKU товара на WooCommerce
woocomId integer · int64 Нет Id товара на WooCommerce
opencartSku string Нет SKU товара в OpenCart
opencartId integer · int64 Нет Id товара в OpenCart
magnitId string Нет Id товара на Magnit
sberArticle string Нет Артикул товара на СберМегаМаркет
ozonArticle string Нет Уникальный артикул товара для озон. Offer ID в озон
oneCArticle string Нет Уникальный артикул товара для 1c
uzumArticle string Нет Уникальный артикул товара для Uzum
simalandId integer · int64 Нет Уникальный идентификатор товара для Simaland
lamodaSku string Нет SKU товара на Lamoda
ozonFbsSku integer · int64 Нет Идентификатор товара в Озон по FBS
ozonFboSku integer · int64 Нет Идентификатор товара в Озон по FBO
avitoId integer · int64 Нет ID товара в сервисе Avito
detmirId string Нет Id товара на сайте Детского мира (для ссылки на карточку)
magnitSku string Нет SKU товара на Magnit
ozonId integer · int64 Нет Идентификатор товара Озон на сайте. SKU в озон
oneCId string Нет Идентификатор товара в 1С
moySkladId string Нет ID товара в сервисе Мой Склад
nationalCatalogFeedId integer · int64 Нет Идентификатор создания карточки в национальном каталоге
yandexMarketProductId integer · int64 Нет Идентификатор карточки товара на Yandex.Market
nationalCatalogGoodId integer · int64 Нет Идентификатор товара в национальном каталоге
wildberriesPrice number · double Нет Текущая цена товара на Вайлдбериз со скидкой
wildberriesUpdatedPrice number · double Нет Новая цена товара на Вайлдбериз со скидкой.Только для методов изменения цены
wildberriesPriceWithoutDiscount number · double Нет Текущая цена товара на Вайлдбериз без скидки
wildberriesUpdatedPriceWithoutDiscount number · double Нет Новая цена товара на Вайлдбериз без скидки.Только для методов изменения цены
aliexpressPrice number · double Нет Текущая цена на Aliexpress со скидкой
aliexpressPriceWithoutDiscount number · double Нет Текущая цена на Aliexpress без скидки.
aliexpressUpdatedPrice number · double Нет Новая цена со скидкой на Aliexpress. Только для методов обновления цены
aliexpressUpdatedPriceWithoutDiscount number · double Нет Новая цена без скидки на Aliexpress. Только для методов обновления цены
ozonPrice number · double Нет Текущая цена товара на Озон со скидкой
ozonUpdatedPrice number · double Нет Новая цена товара на Озон со скидкой.Только для методов изменения цены
ozonPriceWithoutDiscount number · double Нет Текущая цена товара на Озон без скидки.
ozonUpdatedPriceWithoutDiscount number · double Нет Новая цена Озон без скидки.Только для методов изменения цены
leroyMerlinPrice number · double Нет Текущая цена товара на LeroyMerlin
leroyMerlinUpdatedPrice number · double Нет Новая цена товара на LeroyMerlin.Только для методов изменения цены
avitoPrice number · double Нет Текущая цена товара на Avito
avitoUpdatedPrice number · double Нет Новая цена товара на Avito.Только для методов изменения цены
sberMegaMarketPrice number · double Нет Текущая цена на СберМегаМаркет со скидкой
sberMegaMarketUpdatedPrice number · double Нет Новая цена со скидкой на СберМегаМаркет. Только для методов изменения цены
yandexMarketPrice number · double Нет Текущая цена на Яндекс.Маркет со скидкой
yandexMarketPriceWithoutDiscount number · double Нет Текущая цена на Яндекс.Маркет без скидки
yandexMarketUpdatedPrice number · double Нет Новая цена со скидкой на Яндекс.Маркет. Только для методов изменения цены
yandexMarketUpdatedPriceWithoutDiscount number · double Нет Новая цена без скидки на Яндекс.Маркет. Только для методов изменения цены
productPrices ProductPrice[] Нет Поле productPrices.
Структура элемента массива ProductPrice
ПолеТипОбязательноОписание
id integer · int64 Нет Идентификатор записи цены
productId integer · int64 Нет Идентификатор товара
product object Нет Товар
priceTypeId integer · int64 Нет Идентификатор типа цены
priceType PriceType Нет Тип цены
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 Нет Сервис
clientId integer · int64 Нет Идентификатор клиента
price number · double Нет Цена
updatedPrice number · double Нет Обновленная цена
priceWithoutDiscount number · double Нет Цена без скидки
updatedPriceWithoutDiscount number · double Нет Обновленная цена без скидки
minPrice number · double Нет Минимальная цена
updatedMinPrice number · double Нет Обновленная минимальная цена
percentForParticipationPromoOrAdvertising integer · int32 Нет Процент расходов на участие в акциях или рекламе
isActive boolean Нет Активна ли цена
article string Нет Уникальный идентификатор товара на маркетплейсе
pendingOperationId string Нет Идентификатор асинхронной операции обновления цены (Детский мир)
stockRules ProductStockRules Нет Правила отправки остатков на маркетплейсы
Поля объекта ProductStockRules
ПолеТипОбязательноОписание
minFbsStock integer · int32 Нет Минимальный остаток - если меньше, то ставим 0
maxFbsStock integer · int32 Нет Максимальный остаток - если больше, то ставим его
subtractFromStock integer · int32 Нет Вычитаемое значение из остатка перед отправкой на маркетплейс
{
  "rows": "string"
}
Ошибки5

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

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

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

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

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

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

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

400error_max_page
Номер страницы не может быть больше 100 000

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

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

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

GET

Умный анализ финансов

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

Умный анализ финансов.

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

ПолеТипОбязательноОписание
productAnalyticField stringBARCODE, COLOR, ARTICLE, BRAND, CATEGORY Да Агрегировать данные по сущности
query string Нет Поисковый запрос для фильтрации аналитики
withDuplicate boolean Нет Отдавать аналитику по дубликатам товаров
withBonus boolean Нет Вычитать бонусы Ozon и Яндекс Маркета, а также СПП Wildberries из выручки и расходов
byOrgAndService boolean Нет Для Excel финансового отчёта: true — колонки по паре организация + маркетплейс, false/null — агрегировать по организации как раньше
byOrderType boolean Нет Разбивать финансовый отчёт по типу заказа: отдельные строки для маркетплейсов, розницы и опта
limit integer · int32 Нет Количество записей в ответе
page integer · int32 Нет Страница для навигации по страницам, начиная с 1
sortBy string Нет Поле сортировки
ascending boolean Нет Сортировать по возрастанию по полю sortBy
id integer · int64 Нет Поле id.
isMarketPlaceStructure boolean Нет Идентификатор, получать данные только по маркетплейсу или по всем.
isDashboard boolean Нет Идентификатор, запрос с дашборда или нет.
analyticsField stringPRODUCT, MODEL, GROUP, ORGANIZATION, CLIENT, CATEGORY, PRODUCT_VIEW, BRAND, REGION, WAREHOUSE Нет Агрегировать данные по model/product/view
planDayCount integer · int32 Нет Кол-во дней для отчетов
daysToSupply integer · int32 Нет Через сколько дней ожидается поставка
plannedSupplyDate string · date-time Нет Планируемая дата поставки
groupByView boolean Нет Сгруппировать по цвету
warehouses integer[] Нет Список идентификаторов складов
salesModels string[] Нет Модели продаж для отчёта экономики складов
aggregation stringWAREHOUSE, WAREHOUSE_PRODUCT Нет Уровень агрегации отчёта экономики складов
columns FileExportColumn[] Нет Настроенные пользователем колонки Excel
Структура элемента массива FileExportColumn
ПолеТипОбязательноОписание
id integer · int64 Нет ID записи
fileExportId integer · int64 Нет ID конфигурации экспорта
columnName string Нет Название столбца
columnOrder integer · int32 Нет Порядок столбца в файле
isEnabled boolean Нет Включен ли столбец для экспорта
regions string[] Нет Список регионов
group boolean Нет Сгруппировать данные
calculationByOrders boolean Нет Делать расчет по заказанному количеству
sourceReport stringDEFAULT, ORDER, SALES, PROFIT, OZON, YANDEX_MARKET, WB_REALIZATION_FILE, WB_DETAILED_REPORT_FILE, OZON_REALIZATION_FILE, OZON_REALIZATION_FILE_NEW, OZON_COMPENSATIONS_FILE, OZON_SERVICES_FILE, OZON_CASH_FLOW_STATEMENT, WB_CAMPAIGN, SBER_MEGA_MARKET_FILES, YANDEX_MARKET_FILE_DETAILS, WB_RETURNS_REPORT, OWN_DELIVERY, OZON_CAMPAIGN_SKU_REPORT, WB_PAID_STORAGE, YANDEX_MARKET_NETTING, OZON_CPO_SKU_REPORT, UZUM, UZUM_EXPENSES, DEFECT_WRITE_OFF, LOCAL_ORDER, EXTERNAL_CAMPAIGN Нет Операция по которой выводить данные
skipDayWithoutStocks boolean Нет Пропускать дни без остатков
replaceSetsByComponents boolean Нет Раскрывать комплекты по компонентам
distributeFbsByWarehouse boolean Нет Распределять FBS по складам пропорционально FBO
distributeFbsStock boolean Нет Распределять остатки FBS между маркетплейсами/складами
ignoreDumping boolean Нет Игнорировать слив товара (продажи по заниженной цене)
isSaleStructure boolean Нет Идентификатор, что нужно получить структуру по продажам
isAveragePerOneUnit boolean Нет Идентификатор, получить среднее за 1 единицу
updateDate boolean Нет Обновлять даты
useWeightedGroup boolean Нет Использовать группы по весу
isFindirRequest boolean Нет Является ли запрос - запросом для Задачника
brandIds integer[] Нет Фильтр по идентификаторам брендов (список)
categoryIds integer[] Нет Фильтр по идентификаторам категорий (список)
articles string[] Нет Фильтр по артикулу (список)
colors string[] Нет Фильтр по цвету (список)
sizes string[] Нет Фильтр по размеру (список)
barcodes string[] Нет Фильтр по штрих-коду (список)
tagIds integer[] Нет Фильтр по идентификаторам тегов товаров (список)
penaltyFrom number · double Нет Фильтр по штрафам (от)
penaltyTo number · double Нет Фильтр по штрафам (до)
logisticsFrom number · double Нет Фильтр по логистике (от)
logisticsTo number · double Нет Фильтр по логистике (до)
marginFrom number · double Нет Фильтр по маржинальности (от)
marginTo number · double Нет Фильтр по маржинальности (до)
salesAmountFrom number · double Нет Фильтр по сумме продаж (от)
salesAmountTo number · double Нет Фильтр по сумме продаж (до)
totalSalesAmountFrom number · double Нет Фильтр по выручке (от)
totalSalesAmountTo number · double Нет Фильтр по выручке (до)
grossProfitFrom number · double Нет Фильтр по валовой прибыли (от)
grossProfitTo number · double Нет Фильтр по валовой прибыли (до)
taxNds integer · int32 Нет Налог ндс
useOsno boolean Нет Тип налогообложения осно
period stringDAY, WEEK, MONTH, QUARTER, YEAR, MONTH_3, MONTH_6, END_OF_TARIFF, MONTH_7, MONTH_14, YEAR_2 Нет Период агрегации
dateFrom string · date-time Да Дата начала отчета
dateTo string · date-time Да Дата окончания отчета
services string[] Нет Список маркетплейсов для которых отдать данные
categories integer[] Нет Фильтр категорий для которых отдать данные
brands integer[] Нет Фильтр брендов для которых отдать данные
clientOrganizationId integer · int64 Нет Идентификатор организации, для которой отдать данные
organizations integer[] Нет Идентификаторы организаций клиента
ids integer[] Нет Список идентификаторов
type stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION Нет Тип заказа
types string[] Нет Типы заказа
status stringCREATED, REVOKING, REVOKED, ORDER_CREATED, CARDS_CREATED, BOX_BARCODES, IMAGES_UPLOADED, INVOICE_UPLOADED, READY_TO_SUPPLY, SUPPLIED, FINISHED, COLLECTED, SEND, DELIVERY, REFUND, COLLECTING, PACKING, PAYMENT_REQUIRED, CANCELED, CONTROVERSIAL, OVERDUE, READY_FOR_PICKUP, WAITING_SUPPLY, PICK_UP_REFUND, REFUND_RECEIVED, DELETED, RESTORE, PRODUCTION_CONFIRMED Нет Статус заказа
timeZone integer · int32 Нет Часовой пояс клиента по UTC
previousDateFrom string · date-time Нет Дата начала периода для сравнения
clientOrganizationIds integer[] Нет Идентификаторы организаций, для которых отдать данные
ignoreCredit boolean Нет Не учитывать кредит в прочих удержаниях
curl --request GET 'https://api.selsup.ru/api/findir/findir/tips?productAnalyticField=BARCODE&limit=50&page=1&dateFrom=2026-01-15T12%3A00%3A00Z&dateTo=2026-01-15T12%3A00%3A00Z' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Структура элемента массива Tip[]
ПолеТипОбязательноОписание
type stringWARN, INFO, ACHIEVEMENTS, REVENUE, PROFIT, LOGISTICS, PENALTY, PROBLEMATIC, LOW_PURCHASE_PERCENT, UNPROFITABLE_PRODUCTS, LOW_MARGIN, NEGATIVE_MARGIN, FBO_LOW_STOCK, LOW_PHOTO_COUNT, CLOTHING_WITHOUT_MODEL, PHOTO_RECOMMENDATIONS, PRODUCT_PHOTO_ANALYZED, HIGH_DRR, LOW_CTR, EMPTY_VIDEO, CONVERSION_TO_ORDER_OR_CART_DECREASED, LOW_RATING, HIGH_STORAGE_COSTS Нет Поле type.
title string Нет Поле title.
description string Нет Поле description.
value number · double Нет Поле value.
[
  "string"
]
Ошибки3

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

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

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

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

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

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

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

Authorization

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

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

Попробовать

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

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

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