SelSup Developers

Грамадскае API · API Падпісанне

Калькулятар

Канчатковыя пункты для калькулятара, уключаючы дакладныя маршруты, параметры, органы запыту і схемы пашырэння адказу.

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

Wildberries ФББ базавая камісія.

wildberriesFbsPlannedTransferHoursnumber · double

Wildberries ФБС Плануецца гадзіны перадачы.

wildberriesFbsTransferNormHoursnumber · double

Wildberries ФБ перадаюць Нормальныя гадзіны.

wildberriesFbsSpeedCoefficientnumber · double

Wildberries Fbs хуткасць каэфіцыент.

wildberriesFbsEffectiveCommissionnumber · double

Wildberries Fbs Эфектыўная камісія.

wildberriesFbsTransferHoursSourcestring

Wildberries ФБС перадаваць гадзіны крыніца.

wildberriesFbsSpeedCoefficientValidFromstring · date

Wildberries Fbs хуткасць коэфэктыў ад.

wildberriesFbsSpeedCoefficientSourcestring

Wildberries Fbs хуткасць каэфіцыент крыніца.

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

Падатковая стаўка.

Памылка дагавор

Як вяртаюць памылкі прыкладання

Код error аднолькавы ў кожным лакелі, у той час як паведамленне, якое з'яўляецца карыстальнікам, перакладаецца серверам.

error

Стабільны машыначытай код для інтэграцыйнай логікі.

localMessage

Паведамленне гатовае да адлюстравання на мове карыстальніка токены API.

params

Значэнні, якія інтэрполююцца серверам у лакалізаваным шаблоне паведамленняў.

localMessage выкарыстоўвае поле lang карыстальніка, які валодае токеном API. Мова дакументацыі і загаловак Accept-Language не змяняюць яго; руская выкарыстоўваецца, калі карыстацкая мова не канфігуруецца.

RUМясцовасць карыстальніка ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
BEБеларуская (be)
{
  "error": "error_brand_already_exists",
  "localMessage": "Брэнд Base ужо існуе",
  "params": {
    "name": "Base"
  }
}

Канчатковыя пункты

Канчатковыя пункты

GET

Збытак

/api/calculator/profit
Значок з чытальным доступам

Збытак з выкарыстаннем 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 Не Wildberries ФББ базавая камісія.
wildberriesFbsPlannedTransferHours number · double Не Wildberries ФБС Плануецца гадзіны перадачы.
wildberriesFbsTransferNormHours number · double Не Wildberries ФБ перадаюць Нормальныя гадзіны.
wildberriesFbsSpeedCoefficient number · double Не Wildberries Fbs хуткасць каэфіцыент.
wildberriesFbsEffectiveCommission number · double Не Wildberries Fbs Эфектыўная камісія.
wildberriesFbsTransferHoursSource string Не Wildberries ФБС перадаваць гадзіны крыніца.
wildberriesFbsSpeedCoefficientValidFrom string · date Не Wildberries Fbs хуткасць коэфэктыў ад.
wildberriesFbsSpeedCoefficientSource string Не Wildberries Fbs хуткасць каэфіцыент крыніца.
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 Не Wildberries ФББ базавая камісія.
wildberriesFbsPlannedTransferHours number · double Не Wildberries ФБС Плануецца гадзіны перадачы.
wildberriesFbsTransferNormHours number · double Не Wildberries ФБ перадаюць Нормальныя гадзіны.
wildberriesFbsSpeedCoefficient number · double Не Wildberries Fbs хуткасць каэфіцыент.
wildberriesFbsEffectiveCommission number · double Не Wildberries Fbs Эфектыўная камісія.
wildberriesFbsTransferHoursSource string Не Wildberries ФБС перадаваць гадзіны крыніца.
wildberriesFbsSpeedCoefficientValidFrom string · date Не Wildberries Fbs хуткасць коэфэктыў ад.
wildberriesFbsSpeedCoefficientSource string Не Wildberries Fbs хуткасць каэфіцыент крыніца.
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. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_category_not_found
Не знойдзена катэгорыя

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_category_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_depth_not_found
Не пазначана глыбіня

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_depth_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_height_not_found
Не пазначана вышыня

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_height_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_purchase_percent_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_sale_price_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_service_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_width_not_found
Не пазначана шырыня

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_width_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

GET

Кошт

/api/calculator/price
Значок з чытальным доступам

Кошт з выкарыстаннем 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 Не Wildberries ФББ базавая камісія.
wildberriesFbsPlannedTransferHours number · double Не Wildberries ФБС Плануецца гадзіны перадачы.
wildberriesFbsTransferNormHours number · double Не Wildberries ФБ перадаюць Нормальныя гадзіны.
wildberriesFbsSpeedCoefficient number · double Не Wildberries Fbs хуткасць каэфіцыент.
wildberriesFbsEffectiveCommission number · double Не Wildberries Fbs Эфектыўная камісія.
wildberriesFbsTransferHoursSource string Не Wildberries ФБС перадаваць гадзіны крыніца.
wildberriesFbsSpeedCoefficientValidFrom string · date Не Wildberries Fbs хуткасць коэфэктыў ад.
wildberriesFbsSpeedCoefficientSource string Не Wildberries Fbs хуткасць каэфіцыент крыніца.
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 Не Wildberries ФББ базавая камісія.
wildberriesFbsPlannedTransferHours number · double Не Wildberries ФБС Плануецца гадзіны перадачы.
wildberriesFbsTransferNormHours number · double Не Wildberries ФБ перадаюць Нормальныя гадзіны.
wildberriesFbsSpeedCoefficient number · double Не Wildberries Fbs хуткасць каэфіцыент.
wildberriesFbsEffectiveCommission number · double Не Wildberries Fbs Эфектыўная камісія.
wildberriesFbsTransferHoursSource string Не Wildberries ФБС перадаваць гадзіны крыніца.
wildberriesFbsSpeedCoefficientValidFrom string · date Не Wildberries Fbs хуткасць коэфэктыў ад.
wildberriesFbsSpeedCoefficientSource string Не Wildberries Fbs хуткасць каэфіцыент крыніца.
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. Як вяртаюць памылкі прыкладання ↑

401auth_required
Патрабаваная аўтэнтыфікацыя

Authorization не хапае, пусты, або ўтрымлівае недаступны токен.

400error_access_denied
Доступ забаронены

Токен існуе, але яго роля не можа выканаць гэтую аперацыю.

500error_unknown
Адбылася невядомая памылка. Калі праблема паўторыцца, напішыце ў службу падтрымкі

Унутраная няўдачы. Зэканоміць час запыту і кантактную падтрымку; не прабуйце зноў сляпыя мутацыі.

400error_category_not_found
Не знойдзена катэгорыя

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_category_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_depth_not_found
Не пазначана глыбіня

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_depth_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_fill_purchase_price
Няма закупачнай цаны

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_fill_purchase_price ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_height_not_found
Не пазначана вышыня

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_height_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_no_client
Кліент не знойдзены або быў выдалены. Напішыце ў падтрымку

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_no_client ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_organization_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_purchase_percent_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

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

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_service_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

400error_width_not_found
Не пазначана шырыня

Спецыфічны для канчатковага пункту error. Выкарыстоўвайце стабільны код error_width_not_found ў лагіцы прыкладання; localMessage змяшчае пераклад, паказаны вышэй.

Authorization

Знак для запытаў на выпрабаванне

Токен застаецца ў лакальным сховішчы гэтага браўзэра і адпраўляецца толькі ў заголоўцы Authorization запытаў на api.selsup.ru.

Паспрабаваць

Рэальныя параметры запыту

Жывы адказ API

Пашляце запыт, каб убачыць адказ SelSup.