🚚 СДЭК : connexion et clés API
Contrat avec СДЭК, clé API dans l'espace client (Account et Secure password), frais de livraison entrepôt-entrepôt/entrepôt-porte, environnement de test EDU, СДЭК Kazakhstan et Biélorussie.
Où configurer : Panneau de gestion → « Expéditions » → bouton « Services de livraison » (ou fiche de l'établissement → WEB → « Services de livraison »).
Ce qu'il faut#
- un contrat avec СДЭК pour une personne morale ou un entrepreneur individuel ;
- un accès à l'espace client lk.cdek.ru ;
- une adresse depuis laquelle vous remettez les colis (entrepôt, magasin ou bureau).
Comment obtenir les clés dans l'espace client du service#
- Concluez un contrat avec СДЭК : demande sur le site cdek.ru (« Entreprises » → « Conclure un contrat ») ou via le responsable de votre ville. Sans contrat, les clés API ne sont pas délivrées.
- Connectez-vous à l'espace client lk.cdek.ru avec le compte sous lequel le contrat est établi.
- Ouvrez la section « Intégration » et créez une clé pour l'API (si une clé existe déjà, utilisez-la).
- Copiez deux valeurs : Account (identifiant client) et Secure password (mot de passe secret). Conservez Secure password comme un mot de passe : ne le transmettez pas par messagerie.
Ce qu'il faut saisir dans la fiche du service#
| Champ | Ce qu'il faut saisir |
|---|---|
| Adresse de l'expéditeur | adresse de l'entrepôt ou du magasin depuis lequel СДЭК récupère les colis ou vers lequel vous les apportez |
| Quels frais de livraison afficher | « entrepôt-entrepôt » (vous déposez en point de retrait, l'acheteur récupère en point de retrait), « entrepôt-porte » (coursier jusqu'à l'acheteur), « porte-porte » (le coursier récupère chez vous) |
| account (client_id) | valeur Account de l'espace client |
| secure_password (client_secret) | valeur Secure password de l'espace client |
Vérification#
- Cliquez sur « Enregistrer ».
- Cliquez sur « Vérifier la connexion » : les frais de livraison apparaissent sous la fiche. La mention « Mode simulé » signifie que les clés ne sont pas connectées et que les frais de livraison sont des exemples.
- Cochez « Activer … » dans la fiche — le service apparaît alors chez l'acheteur lors de la commande.
Sans clés et mode test#
Sans clés, la fiche fonctionne dans l'environnement de formation de СДЭК, et s'il est indisponible, elle affiche des frais de livraison de démonstration : vous pouvez ainsi voir à quoi ressemble la livraison sur la vitrine, avant même le contrat. La case « Mode test (sandbox) » envoie les requêtes vers l'environnement de formation api.edu.cdek.ru — il nécessite des clés de test distinctes, délivrées par СДЭК (les clés de démonstration publiées dans la documentation sont rejetées).
Problèmes fréquents#
- « Erreur de connexion » / invalid_client — les clés sont inversées, copiées avec un espace ou le « Mode test » est activé avec des clés de production. Désactivez le mode test et saisissez à nouveau Account et Secure password.
- Aucun frais de livraison dans la réponse — les frais de livraison sélectionnés ne fonctionnent pas pour cette destination — cochez aussi « entrepôt-porte » ou vérifiez l'adresse de l'expéditeur.
- Magasin au Kazakhstan ou en Biélorussie — СДЭК Kazakhstan (cdek.kz) et СДЭК Biélorussie (cdek.by) sont des sociétés distinctes : les clés de l'espace client russe n'y fonctionnent pas, il faut un contrat et un espace client du СДЭК local. La procédure d'obtention des clés est la même.
Liens#
- Site du service : https://www.cdek.ru/
- Espace client : https://lk.cdek.ru/
- Documentation API : https://apidoc.cdek.ru/