SelSup Developers

Le public API · API Référence

Calculateur

Les points de fin pour le calculateur, y compris les itinéraires exacts, les paramètres, les corps de requête et les schémas de réponse extensibles.

2 points de fin/api/calculatorStableDéclaration lisible par machine ↗
{ }

Cette page est soutenue par un contrat indépendant éditable. Valider les opérations de rédaction avec des données de test avant utilisation de production.

/api/calculator

Flux de travail prêts à l'emploi

Flux de travail prêts à l'emploi

01

Commencez à utiliser Calculateur

Utilisez un jeton API dédié et validez d'abord les opérations de lecture avec les données de test.

  1. Gardez le jeton côté serveur et envoyez-le dans l'en-tête Authorization.
  2. Vérifiez les paramètres requis et élargissez le schéma de demande ou de réponse.
  3. Traiter l'état HTTP et le champ stable error dans les erreurs d'application.

Modèle de données

Structures de données

Les modèles sont énumérés une fois ici et peuvent également être étendus directement depuis les terminaux qui les utilisent.

UnitCalculator31 champs
purchasePricenumber · double

Le prix d'achat.

purchasePercentnumber · double

Pourcentage d'achat.

widthinteger · int32

La largeur.

heightinteger · int32

La hauteur.

depthinteger · int32

La profondeur.

categoryIdinteger · int64

Identification de catégorie

servicestring

Le service.

salePricenumber · double

Le prix de vente.

commissionnumber · double

La Commission.

wildberriesFbsBaseCommissionnumber · double

La Commission de base de la FBS Wildberries.

wildberriesFbsPlannedTransferHoursnumber · double

Les heures de transfert prévues par le FBI.

wildberriesFbsTransferNormHoursnumber · double

Les Wildberries font le transfert des heures normales.

wildberriesFbsSpeedCoefficientnumber · double

Coefficient de vitesse de la télévision.

wildberriesFbsEffectiveCommissionnumber · double

Commission effective de la FBS.

wildberriesFbsTransferHoursSourcestring

Les heures de transfert de la FBS.

wildberriesFbsSpeedCoefficientValidFromstring · date

Le coefficient de vitesse de Wildberries Fbs est valide.

wildberriesFbsSpeedCoefficientSourcestring

Source du coefficient de vitesse de la FBS.

logisticnumber · double

- Il est logistique.

warehouseRationumber · double

Ratio de stockage.

logisticRationumber · double

Le rapport logistique.

ktrnumber · double

Je suis là.

expensesnumber · double

Des dépenses.

newPriceByRubnumber · double

Nouveau prix par friction.

newPriceByMarginalitynumber · double

Nouveau prix par marginalité.

desiredMarginPercentnumber · double

Pourcentage de marge souhaité.

desiredProfitRubnumber · double

Le profit désiré.

profitnumber · double

Les bénéfices.

markUpnumber · double

Je vous en prie.

marginalitynumber · double

La marginalité.

organizationIdinteger · int64

Identification de l'organisation.

taxRatenumber · double

Taxe d'imposition.

Contrats d'erreur

Comment les erreurs d'application sont retournées

Le code error est identique dans chaque locale, tandis que le message d'utilisateur est traduit par le serveur.

Le projet de loi

Code stable lisible par machine pour la logique d'intégration.

Le projet de loi

Message prêt à être affiché dans la langue de l'utilisateur de jeton API.

Le projet de loi

Les valeurs interpolées par le serveur dans le modèle de message localisé.

localMessage utilise le champ lang de l'utilisateur qui possède le jeton API. Le langage de documentation et l'en-tête Accept-Language ne le modifient pas; le russe est utilisé lorsque l'usager n'a pas de langue configurée.

RULocalisation de l'utilisateur est ru
{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}
FRFrançais (fr)
{
  "error": "error_brand_already_exists",
  "localMessage": "La marque Base existe déjà",
  "params": {
    "name": "Base"
  }
}

Les points de fin

Les points de fin

GET

Les bénéfices

/api/calculator/profit
Token avec accès à la lecture

Les bénéfices obtenus grâce à GET /api/calculator/profit.

Paramètres de requête

ChampTypeObligatoireDescription
purchasePrice number · double Non Le prix d'achat.
purchasePercent number · double Non Pourcentage d'achat.
width integer · int32 Non La largeur.
height integer · int32 Non La hauteur.
depth integer · int32 Non La profondeur.
categoryId integer · int64 Non Identification de catégorie
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 Non Le service.
salePrice number · double Non Le prix de vente.
commission number · double Non La Commission.
wildberriesFbsBaseCommission number · double Non La Commission de base de la FBS Wildberries.
wildberriesFbsPlannedTransferHours number · double Non Les heures de transfert prévues par le FBI.
wildberriesFbsTransferNormHours number · double Non Les Wildberries font le transfert des heures normales.
wildberriesFbsSpeedCoefficient number · double Non Coefficient de vitesse de la télévision.
wildberriesFbsEffectiveCommission number · double Non Commission effective de la FBS.
wildberriesFbsTransferHoursSource string Non Les heures de transfert de la FBS.
wildberriesFbsSpeedCoefficientValidFrom string · date Non Le coefficient de vitesse de Wildberries Fbs est valide.
wildberriesFbsSpeedCoefficientSource string Non Source du coefficient de vitesse de la FBS.
logistic number · double Non - Il est logistique.
warehouseRatio number · double Non Ratio de stockage.
logisticRatio number · double Non Le rapport logistique.
ktr number · double Non Je suis là.
expenses number · double Non Des dépenses.
newPriceByRub number · double Non Nouveau prix par friction.
newPriceByMarginality number · double Non Nouveau prix par marginalité.
desiredMarginPercent number · double Non Pourcentage de marge souhaité.
desiredProfitRub number · double Non Le profit désiré.
profit number · double Non Les bénéfices.
markUp number · double Non Je vous en prie.
marginality number · double Non La marginalité.
organizationId integer · int64 Non Identification de l'organisation.
taxRate number · double Non Taxe d'imposition.
curl --request GET 'https://api.selsup.ru/api/calculator/profit' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
champs d'objet UnitCalculator
ChampTypeObligatoireDescription
purchasePrice number · double Non Le prix d'achat.
purchasePercent number · double Non Pourcentage d'achat.
width integer · int32 Non La largeur.
height integer · int32 Non La hauteur.
depth integer · int32 Non La profondeur.
categoryId integer · int64 Non Identification de catégorie
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 Non Le service.
salePrice number · double Non Le prix de vente.
commission number · double Non La Commission.
wildberriesFbsBaseCommission number · double Non La Commission de base de la FBS Wildberries.
wildberriesFbsPlannedTransferHours number · double Non Les heures de transfert prévues par le FBI.
wildberriesFbsTransferNormHours number · double Non Les Wildberries font le transfert des heures normales.
wildberriesFbsSpeedCoefficient number · double Non Coefficient de vitesse de la télévision.
wildberriesFbsEffectiveCommission number · double Non Commission effective de la FBS.
wildberriesFbsTransferHoursSource string Non Les heures de transfert de la FBS.
wildberriesFbsSpeedCoefficientValidFrom string · date Non Le coefficient de vitesse de Wildberries Fbs est valide.
wildberriesFbsSpeedCoefficientSource string Non Source du coefficient de vitesse de la FBS.
logistic number · double Non - Il est logistique.
warehouseRatio number · double Non Ratio de stockage.
logisticRatio number · double Non Le rapport logistique.
ktr number · double Non Je suis là.
expenses number · double Non Des dépenses.
newPriceByRub number · double Non Nouveau prix par friction.
newPriceByMarginality number · double Non Nouveau prix par marginalité.
desiredMarginPercent number · double Non Pourcentage de marge souhaité.
desiredProfitRub number · double Non Le profit désiré.
profit number · double Non Les bénéfices.
markUp number · double Non Je vous en prie.
marginality number · double Non La marginalité.
organizationId integer · int64 Non Identification de l'organisation.
taxRate number · double Non Taxe d'imposition.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Les erreurs12

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required
Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied
Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

400error_category_not_found
Catégorie non trouvée

error spécifique au point final. Utilisez le code error_category_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_depth_not_found
Profondeur non spécifiée

error spécifique au point final. Utilisez le code error_depth_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_height_not_found
Hauteur non spécifiée

error spécifique au point final. Utilisez le code error_height_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_no_client
Client introuvable ou supprimé. Écrivez au support

error spécifique au point final. Utilisez le code error_no_client stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_organization_not_found
Organisation non trouvée

error spécifique au point final. Utilisez le code error_organization_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_purchase_percent_not_found
Pourcentage de rachat non spécifié

error spécifique au point final. Utilisez le code error_purchase_percent_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_sale_price_not_found
Prix de vente non spécifié

error spécifique au point final. Utilisez le code error_sale_price_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_service_not_found
Marketplace non sélectionné

error spécifique au point final. Utilisez le code error_service_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_width_not_found
Largeur non spécifiée

error spécifique au point final. Utilisez le code error_width_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

GET

Prix

/api/calculator/price
Token avec accès à la lecture

Prix à l'aide de GET /api/calculator/price.

Paramètres de requête

ChampTypeObligatoireDescription
purchasePrice number · double Non Le prix d'achat.
purchasePercent number · double Non Pourcentage d'achat.
width integer · int32 Non La largeur.
height integer · int32 Non La hauteur.
depth integer · int32 Non La profondeur.
categoryId integer · int64 Non Identification de catégorie
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 Non Le service.
salePrice number · double Non Le prix de vente.
commission number · double Non La Commission.
wildberriesFbsBaseCommission number · double Non La Commission de base de la FBS Wildberries.
wildberriesFbsPlannedTransferHours number · double Non Les heures de transfert prévues par le FBI.
wildberriesFbsTransferNormHours number · double Non Les Wildberries font le transfert des heures normales.
wildberriesFbsSpeedCoefficient number · double Non Coefficient de vitesse de la télévision.
wildberriesFbsEffectiveCommission number · double Non Commission effective de la FBS.
wildberriesFbsTransferHoursSource string Non Les heures de transfert de la FBS.
wildberriesFbsSpeedCoefficientValidFrom string · date Non Le coefficient de vitesse de Wildberries Fbs est valide.
wildberriesFbsSpeedCoefficientSource string Non Source du coefficient de vitesse de la FBS.
logistic number · double Non - Il est logistique.
warehouseRatio number · double Non Ratio de stockage.
logisticRatio number · double Non Le rapport logistique.
ktr number · double Non Je suis là.
expenses number · double Non Des dépenses.
newPriceByRub number · double Non Nouveau prix par friction.
newPriceByMarginality number · double Non Nouveau prix par marginalité.
desiredMarginPercent number · double Non Pourcentage de marge souhaité.
desiredProfitRub number · double Non Le profit désiré.
profit number · double Non Les bénéfices.
markUp number · double Non Je vous en prie.
marginality number · double Non La marginalité.
organizationId integer · int64 Non Identification de l'organisation.
taxRate number · double Non Taxe d'imposition.
curl --request GET 'https://api.selsup.ru/api/calculator/price' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
champs d'objet UnitCalculator
ChampTypeObligatoireDescription
purchasePrice number · double Non Le prix d'achat.
purchasePercent number · double Non Pourcentage d'achat.
width integer · int32 Non La largeur.
height integer · int32 Non La hauteur.
depth integer · int32 Non La profondeur.
categoryId integer · int64 Non Identification de catégorie
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 Non Le service.
salePrice number · double Non Le prix de vente.
commission number · double Non La Commission.
wildberriesFbsBaseCommission number · double Non La Commission de base de la FBS Wildberries.
wildberriesFbsPlannedTransferHours number · double Non Les heures de transfert prévues par le FBI.
wildberriesFbsTransferNormHours number · double Non Les Wildberries font le transfert des heures normales.
wildberriesFbsSpeedCoefficient number · double Non Coefficient de vitesse de la télévision.
wildberriesFbsEffectiveCommission number · double Non Commission effective de la FBS.
wildberriesFbsTransferHoursSource string Non Les heures de transfert de la FBS.
wildberriesFbsSpeedCoefficientValidFrom string · date Non Le coefficient de vitesse de Wildberries Fbs est valide.
wildberriesFbsSpeedCoefficientSource string Non Source du coefficient de vitesse de la FBS.
logistic number · double Non - Il est logistique.
warehouseRatio number · double Non Ratio de stockage.
logisticRatio number · double Non Le rapport logistique.
ktr number · double Non Je suis là.
expenses number · double Non Des dépenses.
newPriceByRub number · double Non Nouveau prix par friction.
newPriceByMarginality number · double Non Nouveau prix par marginalité.
desiredMarginPercent number · double Non Pourcentage de marge souhaité.
desiredProfitRub number · double Non Le profit désiré.
profit number · double Non Les bénéfices.
markUp number · double Non Je vous en prie.
marginality number · double Non La marginalité.
organizationId integer · int64 Non Identification de l'organisation.
taxRate number · double Non Taxe d'imposition.
{
  "purchasePrice": 1,
  "purchasePercent": 1,
  "width": 1,
  "height": 1,
  "depth": 1,
  "categoryId": 1001
}
Les erreurs12

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required
Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied
Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown
Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

400error_category_not_found
Catégorie non trouvée

error spécifique au point final. Utilisez le code error_category_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_depth_not_found
Profondeur non spécifiée

error spécifique au point final. Utilisez le code error_depth_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_fill_purchase_price
Pas de prix d'achat

error spécifique au point final. Utilisez le code error_fill_purchase_price stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_height_not_found
Hauteur non spécifiée

error spécifique au point final. Utilisez le code error_height_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_no_client
Client introuvable ou supprimé. Écrivez au support

error spécifique au point final. Utilisez le code error_no_client stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_organization_not_found
Organisation non trouvée

error spécifique au point final. Utilisez le code error_organization_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_purchase_percent_not_found
Pourcentage de rachat non spécifié

error spécifique au point final. Utilisez le code error_purchase_percent_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_service_not_found
Marketplace non sélectionné

error spécifique au point final. Utilisez le code error_service_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

400error_width_not_found
Largeur non spécifiée

error spécifique au point final. Utilisez le code error_width_not_found stable dans la logique de l'application; localMessage contient la traduction indiquée ci-dessus.

Authorization

Marque pour les demandes d'essai

Le jeton reste dans le localStorage de ce navigateur et est envoyé uniquement dans l'en-tête Authorization des demandes à api.selsup.ru.

Essayer

Parametres réels de la demande

Réponse en direct API

Envoyez une demande pour voir la réponse SelSup.