SelSup Developers

Public API · API Referencja

Kalkulator

Punkty końcowe dla kalkulatora, w tym dokładne trasy, parametry, organy żądania i rozszerzalne schematy odpowiedzi.

2 punkty końcowe/api/calculatorStabilnyOpis czytelny maszynowo ↗
{ }

Strona ta jest wspierana przez edytowalny samodzielny kontrakt.

/api/calculator

Gotowe do użytkowania przepływy robocze

Gotowe do użytkowania przepływy robocze

01

Zacznij używać kalkulatora

Użyj dedykowanego tokena API i najpierw sprawdź operacje odczytu z danymi testowymi.

  1. Trzymaj token z serwera i wysłać go w nagłówku Authorization.
  2. Sprawdź wymagane parametry i poszerz schemat żądania lub odpowiedzi.
  3. Zrób z statusem HTTP i stabilnym pole error w przypadku błędów aplikacyjnych.

Model danych

Struktura danych

Modele są wymienione tutaj raz i mogą być również rozszerzane bezpośrednio z punktów końcowych, które je wykorzystują.

UnitCalculator31 pola
purchasePricenumber · double

Cena zakupu.

purchasePercentnumber · double

Procent zakupu.

widthinteger · int32

Szerokość.

heightinteger · int32

Wysokość.

depthinteger · int32

Głębokość.

categoryIdinteger · int64

Kategoria ID.

servicestring

- W służbie.

salePricenumber · double

Cena sprzedaży.

commissionnumber · double

Komisja.

wildberriesFbsBaseCommissionnumber · double

Wildberries FBI Base Commission.

wildberriesFbsPlannedTransferHoursnumber · double

Wildberries FBS planował godziny transferu.

wildberriesFbsTransferNormHoursnumber · double

Wildberries Fbs przenosi godzinę normalną.

wildberriesFbsSpeedCoefficientnumber · double

Wildberries Fbs współczynnik prędkości.

wildberriesFbsEffectiveCommissionnumber · double

Wildberries Fbs - Skuteczna Komisja.

wildberriesFbsTransferHoursSourcestring

Wildberries Fbs przenosi godziny.

wildberriesFbsSpeedCoefficientValidFromstring · date

Wydatny współczynnik prędkości FBS z Wildberries.

wildberriesFbsSpeedCoefficientSourcestring

Wydział współczynnika prędkości FBS Wildberries.

logisticnumber · double

Logistyczne.

warehouseRationumber · double

Wpływ magazynu.

logisticRationumber · double

Logistyczne stosunki.

ktrnumber · double

- W porządku.

expensesnumber · double

- Wydaje się.

newPriceByRubnumber · double

Nowa cena za szczotkę.

newPriceByMarginalitynumber · double

Nowa cena według marginalizacji.

desiredMarginPercentnumber · double

Życzęci procent marży.

desiredProfitRubnumber · double

Życzę zysku.

profitnumber · double

Zyski.

markUpnumber · double

- Zrób to.

marginalitynumber · double

Marginalizm.

organizationIdinteger · int64

Id organizacyjny.

taxRatenumber · double

Stawka podatkowa.

Umowa o błędzie

W jaki sposób można zwrócić błędy w aplikacji

Kod error jest identyczny w każdym miejscu, podczas gdy wiadomość skierowana do użytkownika jest tłumaczona przez serwer.

error

Stabilny kod czytelny maszynowo do logiki integracyjnej.

localMessage

Przesłanie gotowe do wyświetlania w języku użytkownika tokenu API.

params

Wartości interpołowane przez serwer w szablonie lokalizowanej wiadomości.

localMessage wykorzystuje pole lang użytkownika, który posiada token API. Język dokumentacji i nagłówek Accept-Language nie zmieniają go; rosyjski jest używany, gdy użytkujący nie ma konfigurowanego języka.

RULokalizacja użytkownika jest ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
PLPolski (pl)
{
  "error": "error_brand_already_exists",
  "localMessage": "Marka Base już istnieje",
  "params": {
    "name": "Base"
  }
}

Punkty końcowe

Punkty końcowe

GET

Zysk

/api/calculator/profit
Token z dostępem do odczytu

Zysk z wykorzystaniem GET /api/calculator/profit.

Parametry zapytania

PoleTypWymaganeOpis
purchasePrice number · double Nie Cena zakupu.
purchasePercent number · double Nie Procent zakupu.
width integer · int32 Nie Szerokość.
height integer · int32 Nie Wysokość.
depth integer · int32 Nie Głębokość.
categoryId integer · int64 Nie Kategoria ID.
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 Nie - W służbie.
salePrice number · double Nie Cena sprzedaży.
commission number · double Nie Komisja.
wildberriesFbsBaseCommission number · double Nie Wildberries FBI Base Commission.
wildberriesFbsPlannedTransferHours number · double Nie Wildberries FBS planował godziny transferu.
wildberriesFbsTransferNormHours number · double Nie Wildberries Fbs przenosi godzinę normalną.
wildberriesFbsSpeedCoefficient number · double Nie Wildberries Fbs współczynnik prędkości.
wildberriesFbsEffectiveCommission number · double Nie Wildberries Fbs - Skuteczna Komisja.
wildberriesFbsTransferHoursSource string Nie Wildberries Fbs przenosi godziny.
wildberriesFbsSpeedCoefficientValidFrom string · date Nie Wydatny współczynnik prędkości FBS z Wildberries.
wildberriesFbsSpeedCoefficientSource string Nie Wydział współczynnika prędkości FBS Wildberries.
logistic number · double Nie Logistyczne.
warehouseRatio number · double Nie Wpływ magazynu.
logisticRatio number · double Nie Logistyczne stosunki.
ktr number · double Nie - W porządku.
expenses number · double Nie - Wydaje się.
newPriceByRub number · double Nie Nowa cena za szczotkę.
newPriceByMarginality number · double Nie Nowa cena według marginalizacji.
desiredMarginPercent number · double Nie Życzęci procent marży.
desiredProfitRub number · double Nie Życzę zysku.
profit number · double Nie Zyski.
markUp number · double Nie - Zrób to.
marginality number · double Nie Marginalizm.
organizationId integer · int64 Nie Id organizacyjny.
taxRate number · double Nie Stawka podatkowa.
curl --request GET 'https://api.selsup.ru/api/calculator/profit' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu UnitCalculator
PoleTypWymaganeOpis
purchasePrice number · double Nie Cena zakupu.
purchasePercent number · double Nie Procent zakupu.
width integer · int32 Nie Szerokość.
height integer · int32 Nie Wysokość.
depth integer · int32 Nie Głębokość.
categoryId integer · int64 Nie Kategoria ID.
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 Nie - W służbie.
salePrice number · double Nie Cena sprzedaży.
commission number · double Nie Komisja.
wildberriesFbsBaseCommission number · double Nie Wildberries FBI Base Commission.
wildberriesFbsPlannedTransferHours number · double Nie Wildberries FBS planował godziny transferu.
wildberriesFbsTransferNormHours number · double Nie Wildberries Fbs przenosi godzinę normalną.
wildberriesFbsSpeedCoefficient number · double Nie Wildberries Fbs współczynnik prędkości.
wildberriesFbsEffectiveCommission number · double Nie Wildberries Fbs - Skuteczna Komisja.
wildberriesFbsTransferHoursSource string Nie Wildberries Fbs przenosi godziny.
wildberriesFbsSpeedCoefficientValidFrom string · date Nie Wydatny współczynnik prędkości FBS z Wildberries.
wildberriesFbsSpeedCoefficientSource string Nie Wydział współczynnika prędkości FBS Wildberries.
logistic number · double Nie Logistyczne.
warehouseRatio number · double Nie Wpływ magazynu.
logisticRatio number · double Nie Logistyczne stosunki.
ktr number · double Nie - W porządku.
expenses number · double Nie - Wydaje się.
newPriceByRub number · double Nie Nowa cena za szczotkę.
newPriceByMarginality number · double Nie Nowa cena według marginalizacji.
desiredMarginPercent number · double Nie Życzęci procent marży.
desiredProfitRub number · double Nie Życzę zysku.
profit number · double Nie Zyski.
markUp number · double Nie - Zrób to.
marginality number · double Nie Marginalizm.
organizationId integer · int64 Nie Id organizacyjny.
taxRate number · double Nie Stawka podatkowa.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Władze12

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_category_not_found
Nie znaleziono kategorii

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_category_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_depth_not_found
Nie podano głębokości

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_depth_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_height_not_found
Nie podano wysokości

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_height_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_client
Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_organization_not_found
Nie znaleziono organizacji

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_organization_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_purchase_percent_not_found
Nie podano procentu wykupu

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_purchase_percent_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_sale_price_not_found
Nie podano ceny sprzedaży

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_sale_price_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_service_not_found
Nie wybrano marketplace'u

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_service_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_width_not_found
Nie podano szerokości

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_width_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

GET

Cena

/api/calculator/price
Token z dostępem do odczytu

Cena przy użyciu GET /api/calculator/price.

Parametry zapytania

PoleTypWymaganeOpis
purchasePrice number · double Nie Cena zakupu.
purchasePercent number · double Nie Procent zakupu.
width integer · int32 Nie Szerokość.
height integer · int32 Nie Wysokość.
depth integer · int32 Nie Głębokość.
categoryId integer · int64 Nie Kategoria ID.
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 Nie - W służbie.
salePrice number · double Nie Cena sprzedaży.
commission number · double Nie Komisja.
wildberriesFbsBaseCommission number · double Nie Wildberries FBI Base Commission.
wildberriesFbsPlannedTransferHours number · double Nie Wildberries FBS planował godziny transferu.
wildberriesFbsTransferNormHours number · double Nie Wildberries Fbs przenosi godzinę normalną.
wildberriesFbsSpeedCoefficient number · double Nie Wildberries Fbs współczynnik prędkości.
wildberriesFbsEffectiveCommission number · double Nie Wildberries Fbs - Skuteczna Komisja.
wildberriesFbsTransferHoursSource string Nie Wildberries Fbs przenosi godziny.
wildberriesFbsSpeedCoefficientValidFrom string · date Nie Wydatny współczynnik prędkości FBS z Wildberries.
wildberriesFbsSpeedCoefficientSource string Nie Wydział współczynnika prędkości FBS Wildberries.
logistic number · double Nie Logistyczne.
warehouseRatio number · double Nie Wpływ magazynu.
logisticRatio number · double Nie Logistyczne stosunki.
ktr number · double Nie - W porządku.
expenses number · double Nie - Wydaje się.
newPriceByRub number · double Nie Nowa cena za szczotkę.
newPriceByMarginality number · double Nie Nowa cena według marginalizacji.
desiredMarginPercent number · double Nie Życzęci procent marży.
desiredProfitRub number · double Nie Życzę zysku.
profit number · double Nie Zyski.
markUp number · double Nie - Zrób to.
marginality number · double Nie Marginalizm.
organizationId integer · int64 Nie Id organizacyjny.
taxRate number · double Nie Stawka podatkowa.
curl --request GET 'https://api.selsup.ru/api/calculator/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Odpowiedź udana

200
Połączenia obiektu UnitCalculator
PoleTypWymaganeOpis
purchasePrice number · double Nie Cena zakupu.
purchasePercent number · double Nie Procent zakupu.
width integer · int32 Nie Szerokość.
height integer · int32 Nie Wysokość.
depth integer · int32 Nie Głębokość.
categoryId integer · int64 Nie Kategoria ID.
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 Nie - W służbie.
salePrice number · double Nie Cena sprzedaży.
commission number · double Nie Komisja.
wildberriesFbsBaseCommission number · double Nie Wildberries FBI Base Commission.
wildberriesFbsPlannedTransferHours number · double Nie Wildberries FBS planował godziny transferu.
wildberriesFbsTransferNormHours number · double Nie Wildberries Fbs przenosi godzinę normalną.
wildberriesFbsSpeedCoefficient number · double Nie Wildberries Fbs współczynnik prędkości.
wildberriesFbsEffectiveCommission number · double Nie Wildberries Fbs - Skuteczna Komisja.
wildberriesFbsTransferHoursSource string Nie Wildberries Fbs przenosi godziny.
wildberriesFbsSpeedCoefficientValidFrom string · date Nie Wydatny współczynnik prędkości FBS z Wildberries.
wildberriesFbsSpeedCoefficientSource string Nie Wydział współczynnika prędkości FBS Wildberries.
logistic number · double Nie Logistyczne.
warehouseRatio number · double Nie Wpływ magazynu.
logisticRatio number · double Nie Logistyczne stosunki.
ktr number · double Nie - W porządku.
expenses number · double Nie - Wydaje się.
newPriceByRub number · double Nie Nowa cena za szczotkę.
newPriceByMarginality number · double Nie Nowa cena według marginalizacji.
desiredMarginPercent number · double Nie Życzęci procent marży.
desiredProfitRub number · double Nie Życzę zysku.
profit number · double Nie Zyski.
markUp number · double Nie - Zrób to.
marginality number · double Nie Marginalizm.
organizationId integer · int64 Nie Id organizacyjny.
taxRate number · double Nie Stawka podatkowa.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Władze12

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required
Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied
Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown
Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

400error_category_not_found
Nie znaleziono kategorii

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_category_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_depth_not_found
Nie podano głębokości

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_depth_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_fill_purchase_price
Brak ceny zakupu

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_fill_purchase_price; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_height_not_found
Nie podano wysokości

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_height_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_no_client
Klient nie znaleziony lub został usunięty. Napisz do wsparcia

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_no_client; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_organization_not_found
Nie znaleziono organizacji

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_organization_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_purchase_percent_not_found
Nie podano procentu wykupu

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_purchase_percent_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_service_not_found
Nie wybrano marketplace'u

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_service_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

400error_width_not_found
Nie podano szerokości

error specyficzny dla punktu końcowego. W logice aplikacji użyj stabilnego kodu error_width_not_found; XPRO TECTED2X zawiera tłumaczenie przedstawione powyżej.

Authorization

Token do wniosków o badania

Token pozostaje w lokalnym magazynie przeglądarki i jest wysyłany tylko w nagłówku Authorization z wniosków na api.selsup.ru.

Wypróbuj

Prawdziwe parametry żądania

Odpowiedź API

Wyślij wniosek o zapoznanie się z odpowiedzią SelSup.