SelSup Developers

Le public API · API Référence

Paramètres

Les points d'expiration des paramètres, y compris les routes exactes, les paramèters, les corps de requête et les schémas de réponse extensibles.

Les points de fin: 3/api/propertyStableDé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/property

Flux de travail prêts à l'emploi

Flux de travail prêts à l'emploi

01

Commencez à utiliser les paramètres

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.

Property6 champs
organizationIdinteger · int64

Identification de l'organisation.

clientIdinteger · int64

Nom du client.

read-only
componentstring

Le composant.

namestring

Nom.

valuestring

La valeur.

valueNamestring

Nom de valeur.

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

PUT

Mettez en place des biens

/api/property/
Token avec accès à l'écriture

Mettre la propriété à l'aide de PUT /api/property/.

Organisme de demande

application/json
champs d'objetProperty
ChampTypeObligatoireDescription
organizationId integer · int64 Non Identification de l'organisation.
clientId integer · int64 Non Nom du client.
component string Non Le composant.
name string Non Nom.
value string Non La valeur.
valueName string Non Nom de valeur.
curl --request PUT 'https://api.selsup.ru/api/property/' \
  --header 'Authorization: YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "organizationId": 1001,
  "clientId": 1001,
  "component": "string",
  "name": "Example",
  "value": "string",
  "valueName": "Example"
}'

Réponse réussie

200

La réponse n'a pas de corps.

Les erreurs7

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_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_invalid_currency_source
La source du taux de change indiquée n'est pas prise en charge

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

400error_invalid_stock_distribution_rules
Règles de répartition du stock invalides : vérifiez les parts de 0 à 1 et les seuils.

error spécifique au point final. Utilisez le code error_invalid_stock_distribution_rules 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.

GET

Je vous en prie .

/api/property/{organizationId}/{component}
Token avec accès à la lecture

Utilisez GET /api/property/{organizationId}/{component}.

Parametres de parcours

ChampTypeObligatoireDescription
organizationId integer · int64 Oui Identification de l'organisation.
component string Oui Le composant.
curl --request GET 'https://api.selsup.ru/api/property/1001/string' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
"string"
Les erreurs32

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_base_creating
Votre espace personnel est en cours de création, attendez quelques minutes jusqu'à la création complète de l'espace

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

400error_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_cant_receive_stocks
impossible de récupérer les stocks

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

400error_client_branding_failed
Impossible de charger ou enregistrer les paramètres de marque.

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

400error_fbs_marking_code_unsupported
Code de marquage FBS non pris en charge

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

400error_fulfillment_client_access_denied
Fulfillment client access denied

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

400error_fulfillment_client_contract_required
Acceptez le contrat pour acc\xe9der aux op\xe9rations.

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

400error_fulfillment_request_invalid
Requête d'exécution non valide

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

400error_header_logo_upload_failed
Could not upload the logo. Please try again.

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

400error_income_not_found
Commande fournisseur n°{id} introuvable

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

400error_integration_cell_mapping_invalid
Cartographie de cellule d'intégration non valide

error spécifique au point final. Utilisez le code error_integration_cell_mapping_invalid 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_no_price_for_order_product
Prix non spécifié pour le produit : {name}

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

400error_no_quantity_for_order_product
Quantité du produit non spécifiée : {name}

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

400error_order_not_found
Commande non trouvée

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

400error_organization_create_failed
Un problème est survenu lors de la création de l'organisation. Veuillez contacter le support

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

400error_organization_exists
Organisation déjà créée

error spécifique au point final. Utilisez le code error_organization_exists 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_ozon_fbo_workflow_not_found
Le workflow Ozon FBO {id} est introuvable

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

400error_reload
La session d'autorisation a expiré, actualisez la page du navigateur. Si l'actualisation ne fonctionne pas, essayez de supprimer les cookies du site

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

400error_settlement_invalid
Règlement nul

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

400error_subscription_expired
Votre abonnement a expiré. Veuillez payer l'abonnement pour continuer à utiliser le service.

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

400error_supply_not_found
Expédition non trouvée : {name}

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

400error_token_expired_or_revoked
Le jeton API est révoqué ou saisi incorrectement. Vérifiez que la clé API a toutes les fonctionnalités. Générez une nouvelle clé et remplacez-la dans SELSUP, car les clés ont une durée de vie.

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

400error_transport_waybill_invalid
Vérifiez les données de la lettre de voiture.

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

400error_transport_waybill_source
La lettre de voiture est indisponible pour cette expédition ou livraison.

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

400error_user_does_not_have_this_organization
L'utilisateur n'a pas accès à cette organisation

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

400error_warehouse_not_found
Entrepôt non trouvé

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

400error_warehouse_setup_unavailable
Installation de l'entrepôt non disponible

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

GET

Liste des produits

/api/property/list/{component}
Token avec accès à la lecture

Liste utilisant GET /api/property/list/{component}.

Parametres de parcours

ChampTypeObligatoireDescription
component string Oui Le composant.

Paramètres de requête

ChampTypeObligatoireDescription
organizationId integer · int64 Non Identification de l'organisation.
curl --request GET 'https://api.selsup.ru/api/property/list/string' \
  --header 'Authorization: YOUR_API_TOKEN'

Réponse réussie

200
Structure des éléments de l'array Property[]
ChampTypeObligatoireDescription
organizationId integer · int64 Non Identification de l'organisation.
clientId integer · int64 Non Nom du client.
component string Non Le composant.
name string Non Nom.
value string Non La valeur.
valueName string Non Nom de valeur.
[
  "string"
]
Les erreurs34

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_bad_request
Format de requête incorrect

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

400error_base_creating
Votre espace personnel est en cours de création, attendez quelques minutes jusqu'à la création complète de l'espace

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

400error_cabinet_access_denied
Vous ne pouvez pas accéder à cet espace de travail.

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

400error_cant_extract_tariffs
Impossible d'obtenir les tarifs. Contactez le support

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

400error_container_log_read_failed
Lire le journal du conteneur a échoué

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

400error_container_log_request_invalid
Requête de journal du conteneur non valide

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

400error_empty_first_name
Prénom non spécifié

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

400error_empty_last_name
Nom de famille non spécifié

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

400error_empty_organization_form
forme d'organisation non spécifiée

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

400error_empty_organization_inn
INN de l'organisation non spécifié

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

400error_empty_organization_name
Nom de l'organisation non spécifié

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

400error_empty_position_name
Nom du poste non spécifié

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

400error_fulfillment_client_access_denied
Fulfillment client access denied

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

400error_fulfillment_client_contract_required
Acceptez le contrat pour acc\xe9der aux op\xe9rations.

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

400error_fulfillment_document_error
Impossible de générer le document. Vérifiez les paramètres et le contenu de l’opération.

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

400error_fulfillment_request_invalid
Requête d'exécution non valide

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

400error_income_not_found
Commande fournisseur n°{id} introuvable

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

400error_max_page
Le numéro de page ne peut pas dépasser 100 000

error spécifique au point final. Utilisez le code error_max_page 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_no_price_for_order_product
Prix non spécifié pour le produit : {name}

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

400error_no_quantity_for_order_product
Quantité du produit non spécifiée : {name}

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

400error_order_not_found
Commande non trouvée

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

400error_organization_create_failed
Un problème est survenu lors de la création de l'organisation. Veuillez contacter le support

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

400error_organization_exists
Organisation déjà créée

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

400error_position_exists
Un poste avec ce nom existe déjà

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

400error_reload
La session d'autorisation a expiré, actualisez la page du navigateur. Si l'actualisation ne fonctionne pas, essayez de supprimer les cookies du site

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

400error_subscription_expired
Votre abonnement a expiré. Veuillez payer l'abonnement pour continuer à utiliser le service.

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

400error_warehouse_not_found
Entrepôt non trouvé

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

400error_wrong_crm_token
jeton CRM incorrect

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

400error_wrong_inn
INN de l'organisation incorrectement spécifié, longueur de 10 ou 12 chiffres

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

400error_wrong_version
Version incorrectement spécifiée

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

Authorization

Marque pour les demandes d'essai

Obtenir un jeton

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.