SelSup Developers

Halk API · API İpucu

Hesaplama

Hesaplayıcı için son noktalar, tam yollar, parametreler, talep organları ve genişletilebilir cevap şemeleri dahil.

2 Son noktaları/api/calculatorDayanıklıMakine okuyabilir açıklama ↗
{ }

Bu sayfa düzenlenebilir bir bağımsız sözleşme ile desteklenir.

/api/calculator

Kullanılabilir iş akışları

Kullanılabilir iş akışları

01

Hesaplamacı kullanmaya başlayın

Özel bir API token kullanın ve önce test verileri ile okuma işlemlerini doğrulayın.

  1. Token sunucu tarafında tut ve Authorization başlığı gönder.
  2. Gerekli parametreleri kontrol edin ve istek veya yanıt şeması genişletin.
  3. Uygulama hatalarında HTTP durumunu ve sabit error alanını ele alın.

Verim modeli

Veriler yapısı

Modeller burada bir kez listelenmiştir ve bunları kullanan uç noktalardan doğrudan genişletilebilir.

UnitCalculator31 alanlar
purchasePricenumber · double

Satın alma fiyatı.

purchasePercentnumber · double

Satın alma yüzdesi.

widthinteger · int32

Genişlik.

heightinteger · int32

- Yükseklik.

depthinteger · int32

Derinlik.

categoryIdinteger · int64

Kategori İd.

servicestring

Hizmet.

salePricenumber · double

Satış fiyatı.

commissionnumber · double

Komisyon.

wildberriesFbsBaseCommissionnumber · double

Wildberries FBI Üssü Komisyonu.

wildberriesFbsPlannedTransferHoursnumber · double

Wildberries FBS'in planlı transfer saatleri.

wildberriesFbsTransferNormHoursnumber · double

Wildberries FBI Normal Saatleri Değiştirir.

wildberriesFbsSpeedCoefficientnumber · double

Wildberries Fbs Hız Koefisiyonu.

wildberriesFbsEffectiveCommissionnumber · double

Wildberries FBS Etkili Komisyonu.

wildberriesFbsTransferHoursSourcestring

Wildberries FBS Transfer Saatleri Kaynağı.

wildberriesFbsSpeedCoefficientValidFromstring · date

Wildberries Fbs Hız Koefisiyonu geçerli.

wildberriesFbsSpeedCoefficientSourcestring

Wildberries Fbs Hız Koefisien Kaynağı.

logisticnumber · double

- Logistik.

warehouseRationumber · double

Depo oranı.

logisticRationumber · double

- Logistik oran.

ktrnumber · double

- Ktr.

expensesnumber · double

- Harcamalar.

newPriceByRubnumber · double

Yeni Fiyatı Çek.

newPriceByMarginalitynumber · double

Yeni Fiyat Marjinallik

desiredMarginPercentnumber · double

İsteyen Marjin Yüzde.

desiredProfitRubnumber · double

İsteyen Kârı Çırpmak.

profitnumber · double

- Kâr.

markUpnumber · double

- Marke yap.

marginalitynumber · double

Çevrecilik.

organizationIdinteger · int64

Teşkilat Kimliği.

taxRatenumber · double

Vergi oranı.

Hata sözleşmesi

Uygulama hataları nasıl iade edilir

error kodu her yerde aynıdır, kullanıcıya yönelik mesaj ise sunucu tarafından tercüme edilir. error etrafında uygulama mantığı oluşturun ve localMessage'i yalnızca görüntülemek için kullanın.

error

Entegre mantığı için sabit makine okunur kod.

localMessage

API token kullanıcısının dilinde görüntülemeye hazır mesaj.

params

Sunucu tarafından yerel mesaj şablonuna girilen değerler.

localMessage, API tokenine sahip olan kullanıcının lang alanını kullanır. Belgeleme dili ve Accept-Language başlığı değiştirmez; kullanıcıya dil yapılandırılmadığında Rusça kullanılır.

RUKullanıcı yerel ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
TRTürkçe (tr)
{
  "error": "error_brand_already_exists",
  "localMessage": "Base markası zaten mevcut",
  "params": {
    "name": "Base"
  }
}

Son noktaları

Son noktaları

GET

Kâr

/api/calculator/profit
Okuma erişimi olan işaret

GET /api/calculator/profit. ile kar

Sorgulama parametreleri

AlanTürZorunluAçıklama
purchasePrice number · double Hayır Satın alma fiyatı.
purchasePercent number · double Hayır Satın alma yüzdesi.
width integer · int32 Hayır Genişlik.
height integer · int32 Hayır - Yükseklik.
depth integer · int32 Hayır Derinlik.
categoryId integer · int64 Hayır Kategori İd.
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 Hayır Hizmet.
salePrice number · double Hayır Satış fiyatı.
commission number · double Hayır Komisyon.
wildberriesFbsBaseCommission number · double Hayır Wildberries FBI Üssü Komisyonu.
wildberriesFbsPlannedTransferHours number · double Hayır Wildberries FBS'in planlı transfer saatleri.
wildberriesFbsTransferNormHours number · double Hayır Wildberries FBI Normal Saatleri Değiştirir.
wildberriesFbsSpeedCoefficient number · double Hayır Wildberries Fbs Hız Koefisiyonu.
wildberriesFbsEffectiveCommission number · double Hayır Wildberries FBS Etkili Komisyonu.
wildberriesFbsTransferHoursSource string Hayır Wildberries FBS Transfer Saatleri Kaynağı.
wildberriesFbsSpeedCoefficientValidFrom string · date Hayır Wildberries Fbs Hız Koefisiyonu geçerli.
wildberriesFbsSpeedCoefficientSource string Hayır Wildberries Fbs Hız Koefisien Kaynağı.
logistic number · double Hayır - Logistik.
warehouseRatio number · double Hayır Depo oranı.
logisticRatio number · double Hayır - Logistik oran.
ktr number · double Hayır - Ktr.
expenses number · double Hayır - Harcamalar.
newPriceByRub number · double Hayır Yeni Fiyatı Çek.
newPriceByMarginality number · double Hayır Yeni Fiyat Marjinallik
desiredMarginPercent number · double Hayır İsteyen Marjin Yüzde.
desiredProfitRub number · double Hayır İsteyen Kârı Çırpmak.
profit number · double Hayır - Kâr.
markUp number · double Hayır - Marke yap.
marginality number · double Hayır Çevrecilik.
organizationId integer · int64 Hayır Teşkilat Kimliği.
taxRate number · double Hayır Vergi oranı.
curl --request GET 'https://api.selsup.ru/api/calculator/profit' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Nesne alanları UnitCalculator
AlanTürZorunluAçıklama
purchasePrice number · double Hayır Satın alma fiyatı.
purchasePercent number · double Hayır Satın alma yüzdesi.
width integer · int32 Hayır Genişlik.
height integer · int32 Hayır - Yükseklik.
depth integer · int32 Hayır Derinlik.
categoryId integer · int64 Hayır Kategori İd.
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 Hayır Hizmet.
salePrice number · double Hayır Satış fiyatı.
commission number · double Hayır Komisyon.
wildberriesFbsBaseCommission number · double Hayır Wildberries FBI Üssü Komisyonu.
wildberriesFbsPlannedTransferHours number · double Hayır Wildberries FBS'in planlı transfer saatleri.
wildberriesFbsTransferNormHours number · double Hayır Wildberries FBI Normal Saatleri Değiştirir.
wildberriesFbsSpeedCoefficient number · double Hayır Wildberries Fbs Hız Koefisiyonu.
wildberriesFbsEffectiveCommission number · double Hayır Wildberries FBS Etkili Komisyonu.
wildberriesFbsTransferHoursSource string Hayır Wildberries FBS Transfer Saatleri Kaynağı.
wildberriesFbsSpeedCoefficientValidFrom string · date Hayır Wildberries Fbs Hız Koefisiyonu geçerli.
wildberriesFbsSpeedCoefficientSource string Hayır Wildberries Fbs Hız Koefisien Kaynağı.
logistic number · double Hayır - Logistik.
warehouseRatio number · double Hayır Depo oranı.
logisticRatio number · double Hayır - Logistik oran.
ktr number · double Hayır - Ktr.
expenses number · double Hayır - Harcamalar.
newPriceByRub number · double Hayır Yeni Fiyatı Çek.
newPriceByMarginality number · double Hayır Yeni Fiyat Marjinallik
desiredMarginPercent number · double Hayır İsteyen Marjin Yüzde.
desiredProfitRub number · double Hayır İsteyen Kârı Çırpmak.
profit number · double Hayır - Kâr.
markUp number · double Hayır - Marke yap.
marginality number · double Hayır Çevrecilik.
organizationId integer · int64 Hayır Teşkilat Kimliği.
taxRate number · double Hayır Vergi oranı.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Hatalar12

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_category_not_found
Kategori bulunamadı

Uygulama mantığında sabit error_category_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_depth_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_height_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_organization_not_found
Kuruluş bulunamadı

Uygulama mantığında sabit error_organization_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_purchase_percent_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_sale_price_not_found
Satış fiyatı belirtilmemiş

Uygulama mantığında sabit error_sale_price_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_service_not_found
Pazaryeri seçilmemiş

Uygulama mantığında sabit error_service_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_width_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

GET

Fiyat

/api/calculator/price
Okuma erişimi olan işaret

GET /api/calculator/price. kullanan fiyat

Sorgulama parametreleri

AlanTürZorunluAçıklama
purchasePrice number · double Hayır Satın alma fiyatı.
purchasePercent number · double Hayır Satın alma yüzdesi.
width integer · int32 Hayır Genişlik.
height integer · int32 Hayır - Yükseklik.
depth integer · int32 Hayır Derinlik.
categoryId integer · int64 Hayır Kategori İd.
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 Hayır Hizmet.
salePrice number · double Hayır Satış fiyatı.
commission number · double Hayır Komisyon.
wildberriesFbsBaseCommission number · double Hayır Wildberries FBI Üssü Komisyonu.
wildberriesFbsPlannedTransferHours number · double Hayır Wildberries FBS'in planlı transfer saatleri.
wildberriesFbsTransferNormHours number · double Hayır Wildberries FBI Normal Saatleri Değiştirir.
wildberriesFbsSpeedCoefficient number · double Hayır Wildberries Fbs Hız Koefisiyonu.
wildberriesFbsEffectiveCommission number · double Hayır Wildberries FBS Etkili Komisyonu.
wildberriesFbsTransferHoursSource string Hayır Wildberries FBS Transfer Saatleri Kaynağı.
wildberriesFbsSpeedCoefficientValidFrom string · date Hayır Wildberries Fbs Hız Koefisiyonu geçerli.
wildberriesFbsSpeedCoefficientSource string Hayır Wildberries Fbs Hız Koefisien Kaynağı.
logistic number · double Hayır - Logistik.
warehouseRatio number · double Hayır Depo oranı.
logisticRatio number · double Hayır - Logistik oran.
ktr number · double Hayır - Ktr.
expenses number · double Hayır - Harcamalar.
newPriceByRub number · double Hayır Yeni Fiyatı Çek.
newPriceByMarginality number · double Hayır Yeni Fiyat Marjinallik
desiredMarginPercent number · double Hayır İsteyen Marjin Yüzde.
desiredProfitRub number · double Hayır İsteyen Kârı Çırpmak.
profit number · double Hayır - Kâr.
markUp number · double Hayır - Marke yap.
marginality number · double Hayır Çevrecilik.
organizationId integer · int64 Hayır Teşkilat Kimliği.
taxRate number · double Hayır Vergi oranı.
curl --request GET 'https://api.selsup.ru/api/calculator/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Başarılı tepki

200
Nesne alanları UnitCalculator
AlanTürZorunluAçıklama
purchasePrice number · double Hayır Satın alma fiyatı.
purchasePercent number · double Hayır Satın alma yüzdesi.
width integer · int32 Hayır Genişlik.
height integer · int32 Hayır - Yükseklik.
depth integer · int32 Hayır Derinlik.
categoryId integer · int64 Hayır Kategori İd.
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 Hayır Hizmet.
salePrice number · double Hayır Satış fiyatı.
commission number · double Hayır Komisyon.
wildberriesFbsBaseCommission number · double Hayır Wildberries FBI Üssü Komisyonu.
wildberriesFbsPlannedTransferHours number · double Hayır Wildberries FBS'in planlı transfer saatleri.
wildberriesFbsTransferNormHours number · double Hayır Wildberries FBI Normal Saatleri Değiştirir.
wildberriesFbsSpeedCoefficient number · double Hayır Wildberries Fbs Hız Koefisiyonu.
wildberriesFbsEffectiveCommission number · double Hayır Wildberries FBS Etkili Komisyonu.
wildberriesFbsTransferHoursSource string Hayır Wildberries FBS Transfer Saatleri Kaynağı.
wildberriesFbsSpeedCoefficientValidFrom string · date Hayır Wildberries Fbs Hız Koefisiyonu geçerli.
wildberriesFbsSpeedCoefficientSource string Hayır Wildberries Fbs Hız Koefisien Kaynağı.
logistic number · double Hayır - Logistik.
warehouseRatio number · double Hayır Depo oranı.
logisticRatio number · double Hayır - Logistik oran.
ktr number · double Hayır - Ktr.
expenses number · double Hayır - Harcamalar.
newPriceByRub number · double Hayır Yeni Fiyatı Çek.
newPriceByMarginality number · double Hayır Yeni Fiyat Marjinallik
desiredMarginPercent number · double Hayır İsteyen Marjin Yüzde.
desiredProfitRub number · double Hayır İsteyen Kârı Çırpmak.
profit number · double Hayır - Kâr.
markUp number · double Hayır - Marke yap.
marginality number · double Hayır Çevrecilik.
organizationId integer · int64 Hayır Teşkilat Kimliği.
taxRate number · double Hayır Vergi oranı.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Hatalar12

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required
Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied
Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown
Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

400error_category_not_found
Kategori bulunamadı

Uygulama mantığında sabit error_category_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_depth_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_fill_purchase_price kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_height_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_no_client
Müşteri bulunamadı veya silinmiş. Destek birimine yazın

Uygulama mantığında sabit error_no_client kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_organization_not_found
Kuruluş bulunamadı

Uygulama mantığında sabit error_organization_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_purchase_percent_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

400error_service_not_found
Pazaryeri seçilmemiş

Uygulama mantığında sabit error_service_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

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

Uygulama mantığında sabit error_width_not_found kodu kullanın; localMessage yukarıda gösterilen çevirileri içerir.

Authorization

Test istekleri için işaret

Token bu tarayıcı lokalStorage'da kalır ve sadece api.selsup.ru adresine Authorization başlığındaki isteklerde gönderilir.

Dene

Gerçek talep parametreleri

Canlı API tepkisi

SelSup cevabını görmek için bir istek gönderin.