SelSup Developers

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

Калькулятор

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

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

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

/api/calculator

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

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

01

Начать работу с разделом «Калькулятор»

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

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

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

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

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

UnitCalculator31 полей
purchasePricenumber · double

Закупочная цена вместе с остальными расходами(общая себестоимость товара)

purchasePercentnumber · double

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

widthinteger · int32

Ширина в мм

heightinteger · int32

Высота в мм

depthinteger · int32

Глубина в мм

categoryIdinteger · int64

Категория

servicestring

Сервис

salePricenumber · double

Цена продажи

commissionnumber · double

Комиссия

wildberriesFbsBaseCommissionnumber · double

Базовая комиссия WB FBS без коэффициента скорости передачи заказа, %

wildberriesFbsPlannedTransferHoursnumber · double

Плановое время передачи заказа WB FBS, ч

wildberriesFbsTransferNormHoursnumber · double

Норматив времени передачи заказа WB FBS, ч

wildberriesFbsSpeedCoefficientnumber · double

Коэффициент скорости передачи заказа WB FBS, п.п.

wildberriesFbsEffectiveCommissionnumber · double

Эффективная комиссия WB FBS с коэффициентом скорости, %

wildberriesFbsTransferHoursSourcestring

Источник планового времени передачи заказа

wildberriesFbsSpeedCoefficientValidFromstring · date

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

wildberriesFbsSpeedCoefficientSourcestring

Источник правил коэффициента скорости

logisticnumber · double

Логистика

warehouseRationumber · double

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

logisticRationumber · double

Коэффициент логистики

ktrnumber · double

Региональный показатель ВБ для логистики

expensesnumber · double

Итого расходы

newPriceByRubnumber · double

Расчетная цена по желаемой прибыли в рублях

newPriceByMarginalitynumber · double

Расчетная цена по желаемой прибыли в марже

desiredMarginPercentnumber · double

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

desiredProfitRubnumber · double

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

profitnumber · double

Прибыль

markUpnumber · double

Наценка

marginalitynumber · double

Маржа

organizationIdinteger · int64

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

taxRatenumber · double

Налог, только у УСН

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

Как 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"
  }
}

Методы

Методы

GET

Расчет прибыли по цене

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

Метод ведет расчет прибыли по цене товара

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

ПолеТипОбязательноОписание
purchasePrice number · double Нет Закупочная цена вместе с остальными расходами(общая себестоимость товара)
purchasePercent number · double Нет Процент выкупа
width integer · int32 Нет Ширина в мм
height integer · int32 Нет Высота в мм
depth integer · int32 Нет Глубина в мм
categoryId integer · int64 Нет Категория
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 Нет Сервис
salePrice number · double Нет Цена продажи
commission number · double Нет Комиссия
wildberriesFbsBaseCommission number · double Нет Базовая комиссия WB FBS без коэффициента скорости передачи заказа, %
wildberriesFbsPlannedTransferHours number · double Нет Плановое время передачи заказа WB FBS, ч
wildberriesFbsTransferNormHours number · double Нет Норматив времени передачи заказа WB FBS, ч
wildberriesFbsSpeedCoefficient number · double Нет Коэффициент скорости передачи заказа WB FBS, п.п.
wildberriesFbsEffectiveCommission number · double Нет Эффективная комиссия WB FBS с коэффициентом скорости, %
wildberriesFbsTransferHoursSource string Нет Источник планового времени передачи заказа
wildberriesFbsSpeedCoefficientValidFrom string · date Нет Дата начала действия правил коэффициента скорости
wildberriesFbsSpeedCoefficientSource string Нет Источник правил коэффициента скорости
logistic number · double Нет Логистика
warehouseRatio number · double Нет Коэффициент склада в %
logisticRatio number · double Нет Коэффициент логистики
ktr number · double Нет Региональный показатель ВБ для логистики
expenses number · double Нет Итого расходы
newPriceByRub number · double Нет Расчетная цена по желаемой прибыли в рублях
newPriceByMarginality number · double Нет Расчетная цена по желаемой прибыли в марже
desiredMarginPercent number · double Нет Желаемый % маржинальности
desiredProfitRub number · double Нет Желаемая прибыль, руб.
profit number · double Нет Прибыль
markUp number · double Нет Наценка
marginality number · double Нет Маржа
organizationId integer · int64 Нет Идентификатор организации
taxRate number · double Нет Налог, только у УСН
curl --request GET 'https://api.selsup.ru/api/calculator/profit' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта UnitCalculator
ПолеТипОбязательноОписание
purchasePrice number · double Нет Закупочная цена вместе с остальными расходами(общая себестоимость товара)
purchasePercent number · double Нет Процент выкупа
width integer · int32 Нет Ширина в мм
height integer · int32 Нет Высота в мм
depth integer · int32 Нет Глубина в мм
categoryId integer · int64 Нет Категория
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 Нет Сервис
salePrice number · double Нет Цена продажи
commission number · double Нет Комиссия
wildberriesFbsBaseCommission number · double Нет Базовая комиссия WB FBS без коэффициента скорости передачи заказа, %
wildberriesFbsPlannedTransferHours number · double Нет Плановое время передачи заказа WB FBS, ч
wildberriesFbsTransferNormHours number · double Нет Норматив времени передачи заказа WB FBS, ч
wildberriesFbsSpeedCoefficient number · double Нет Коэффициент скорости передачи заказа WB FBS, п.п.
wildberriesFbsEffectiveCommission number · double Нет Эффективная комиссия WB FBS с коэффициентом скорости, %
wildberriesFbsTransferHoursSource string Нет Источник планового времени передачи заказа
wildberriesFbsSpeedCoefficientValidFrom string · date Нет Дата начала действия правил коэффициента скорости
wildberriesFbsSpeedCoefficientSource string Нет Источник правил коэффициента скорости
logistic number · double Нет Логистика
warehouseRatio number · double Нет Коэффициент склада в %
logisticRatio number · double Нет Коэффициент логистики
ktr number · double Нет Региональный показатель ВБ для логистики
expenses number · double Нет Итого расходы
newPriceByRub number · double Нет Расчетная цена по желаемой прибыли в рублях
newPriceByMarginality number · double Нет Расчетная цена по желаемой прибыли в марже
desiredMarginPercent number · double Нет Желаемый % маржинальности
desiredProfitRub number · double Нет Желаемая прибыль, руб.
profit number · double Нет Прибыль
markUp number · double Нет Наценка
marginality number · double Нет Маржа
organizationId integer · int64 Нет Идентификатор организации
taxRate number · double Нет Налог, только у УСН
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Ошибки12

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

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

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

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

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

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

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

400error_category_not_found
Не найдена категория

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

400error_depth_not_found
Не указана глубина

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

400error_height_not_found
Не указана высота

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

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

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

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

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

400error_purchase_percent_not_found
Не указан процент выкупа

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

400error_sale_price_not_found
Не указана цена продажи

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

400error_service_not_found
Не выбран маркетплейс

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

400error_width_not_found
Не указана ширина

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

GET

Расчет цены по произвольному товару

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

Метод ведет расчет цены по произвольному товару

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

ПолеТипОбязательноОписание
purchasePrice number · double Нет Закупочная цена вместе с остальными расходами(общая себестоимость товара)
purchasePercent number · double Нет Процент выкупа
width integer · int32 Нет Ширина в мм
height integer · int32 Нет Высота в мм
depth integer · int32 Нет Глубина в мм
categoryId integer · int64 Нет Категория
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 Нет Сервис
salePrice number · double Нет Цена продажи
commission number · double Нет Комиссия
wildberriesFbsBaseCommission number · double Нет Базовая комиссия WB FBS без коэффициента скорости передачи заказа, %
wildberriesFbsPlannedTransferHours number · double Нет Плановое время передачи заказа WB FBS, ч
wildberriesFbsTransferNormHours number · double Нет Норматив времени передачи заказа WB FBS, ч
wildberriesFbsSpeedCoefficient number · double Нет Коэффициент скорости передачи заказа WB FBS, п.п.
wildberriesFbsEffectiveCommission number · double Нет Эффективная комиссия WB FBS с коэффициентом скорости, %
wildberriesFbsTransferHoursSource string Нет Источник планового времени передачи заказа
wildberriesFbsSpeedCoefficientValidFrom string · date Нет Дата начала действия правил коэффициента скорости
wildberriesFbsSpeedCoefficientSource string Нет Источник правил коэффициента скорости
logistic number · double Нет Логистика
warehouseRatio number · double Нет Коэффициент склада в %
logisticRatio number · double Нет Коэффициент логистики
ktr number · double Нет Региональный показатель ВБ для логистики
expenses number · double Нет Итого расходы
newPriceByRub number · double Нет Расчетная цена по желаемой прибыли в рублях
newPriceByMarginality number · double Нет Расчетная цена по желаемой прибыли в марже
desiredMarginPercent number · double Нет Желаемый % маржинальности
desiredProfitRub number · double Нет Желаемая прибыль, руб.
profit number · double Нет Прибыль
markUp number · double Нет Наценка
marginality number · double Нет Маржа
organizationId integer · int64 Нет Идентификатор организации
taxRate number · double Нет Налог, только у УСН
curl --request GET 'https://api.selsup.ru/api/calculator/price' \
  --header 'Authorization: YOUR_API_TOKEN'

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

200
Поля объекта UnitCalculator
ПолеТипОбязательноОписание
purchasePrice number · double Нет Закупочная цена вместе с остальными расходами(общая себестоимость товара)
purchasePercent number · double Нет Процент выкупа
width integer · int32 Нет Ширина в мм
height integer · int32 Нет Высота в мм
depth integer · int32 Нет Глубина в мм
categoryId integer · int64 Нет Категория
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 Нет Сервис
salePrice number · double Нет Цена продажи
commission number · double Нет Комиссия
wildberriesFbsBaseCommission number · double Нет Базовая комиссия WB FBS без коэффициента скорости передачи заказа, %
wildberriesFbsPlannedTransferHours number · double Нет Плановое время передачи заказа WB FBS, ч
wildberriesFbsTransferNormHours number · double Нет Норматив времени передачи заказа WB FBS, ч
wildberriesFbsSpeedCoefficient number · double Нет Коэффициент скорости передачи заказа WB FBS, п.п.
wildberriesFbsEffectiveCommission number · double Нет Эффективная комиссия WB FBS с коэффициентом скорости, %
wildberriesFbsTransferHoursSource string Нет Источник планового времени передачи заказа
wildberriesFbsSpeedCoefficientValidFrom string · date Нет Дата начала действия правил коэффициента скорости
wildberriesFbsSpeedCoefficientSource string Нет Источник правил коэффициента скорости
logistic number · double Нет Логистика
warehouseRatio number · double Нет Коэффициент склада в %
logisticRatio number · double Нет Коэффициент логистики
ktr number · double Нет Региональный показатель ВБ для логистики
expenses number · double Нет Итого расходы
newPriceByRub number · double Нет Расчетная цена по желаемой прибыли в рублях
newPriceByMarginality number · double Нет Расчетная цена по желаемой прибыли в марже
desiredMarginPercent number · double Нет Желаемый % маржинальности
desiredProfitRub number · double Нет Желаемая прибыль, руб.
profit number · double Нет Прибыль
markUp number · double Нет Наценка
marginality number · double Нет Маржа
organizationId integer · int64 Нет Идентификатор организации
taxRate number · double Нет Налог, только у УСН
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Ошибки12

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

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

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

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

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

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

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

400error_category_not_found
Не найдена категория

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

400error_depth_not_found
Не указана глубина

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

400error_fill_purchase_price
Нет закупочной цены

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

400error_height_not_found
Не указана высота

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

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

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

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

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

400error_purchase_percent_not_found
Не указан процент выкупа

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

400error_service_not_found
Не выбран маркетплейс

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

400error_width_not_found
Не указана ширина

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

Authorization

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

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

Попробовать

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

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

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