🚚 СДЭК: Verbindung und API-Schlüssel
Vertrag mit СДЭК, API-Schlüssel im Konto (Account und Secure password), Liefergebühren Lager-Lager/Lager-Tür, Testumgebung EDU, СДЭК Kasachstan und Belarus.
Wo die Einrichtung erfolgt: Verwaltungsbereich → „Sendungen“ → Schaltfläche „Lieferdienste“ (oder Karte des Standorts → WEB → „Lieferdienste“).
Was Sie benötigen#
- einen Vertrag mit СДЭК für eine juristische Person oder ein Einzelunternehmen;
- Zugang zum Konto lk.cdek.ru;
- die Adresse, von der aus Sie Pakete übergeben (Lager, Geschäft oder Büro).
Wie Sie die Schlüssel im Konto des Dienstes erhalten#
- Schließen Sie einen Vertrag mit СДЭК ab: Antrag auf der Website cdek.ru („Für Unternehmen“ → „Vertrag abschließen“) oder über den Manager Ihrer Stadt. Ohne Vertrag werden keine API-Schlüssel ausgegeben.
- Melden Sie sich im Konto lk.cdek.ru mit dem Benutzerkonto an, auf das der Vertrag ausgestellt ist.
- Öffnen Sie den Bereich „Integration“ und erstellen Sie einen Schlüssel für die API (falls bereits ein Schlüssel vorhanden ist, verwenden Sie diesen).
- Kopieren Sie zwei Werte: Account (Kundenkennung) und Secure password (geheimes Passwort). Behandeln Sie das Secure password wie ein Passwort: Senden Sie es nicht über Messenger.
Was in die Karte des Dienstes einzutragen ist#
| Feld | Was einzutragen ist |
|---|---|
| Absenderadresse | Adresse des Lagers oder Geschäfts, von der СДЭК abholt oder zu der Sie Pakete bringen |
| Welche Liefergebühren angezeigt werden | „Lager-Lager“ (Sie geben am Abholpunkt ab, der Käufer holt am Abholpunkt ab), „Lager-Tür“ (Kurier bis zum Käufer), „Tür-Tür“ (Kurier holt bei Ihnen ab) |
| account (client_id) | der Wert Account aus dem Konto |
| secure_password (client_secret) | der Wert Secure password aus dem Konto |
Prüfung#
- Klicken Sie auf „Speichern“.
- Klicken Sie auf „Verbindung prüfen“: Unter der Karte erscheinen die Liefergebühren. Die Anzeige „Mock-Modus“ bedeutet, dass die Schlüssel nicht verbunden sind und die Liefergebühren nur zur Demonstration dienen.
- Aktivieren Sie „Einschalten …“ in der Karte — danach erscheint der Dienst beim Käufer bei der Bestellung.
Ohne Schlüssel und Testmodus#
Ohne Schlüssel arbeitet die Karte in der Lernumgebung von СДЭК, und falls diese nicht verfügbar ist, zeigt sie Demonstrations-Liefergebühren an: So können Sie sehen, wie die Lieferung im Schaufenster aussieht, noch vor dem Vertrag. Das Kontrollkästchen „Testmodus (sandbox)“ sendet Anfragen an die Lernumgebung api.edu.cdek.ru — dafür sind separate Testschlüssel erforderlich, die СДЭК ausgibt (in der Dokumentation veröffentlichte Demo-Schlüssel lehnt er ab).
Häufige Probleme#
- „Verbindungsfehler“ / invalid_client — die Schlüssel sind vertauscht, mit einem Leerzeichen kopiert oder der „Testmodus“ ist mit Produktivschlüsseln eingeschaltet. Schalten Sie den Testmodus aus und fügen Sie Account und Secure password erneut ein.
- Keine Liefergebühren in der Antwort — die gewählte Liefergebühr funktioniert für diese Richtung nicht — aktivieren Sie zusätzlich „Lager-Tür“ oder prüfen Sie die Absenderadresse.
- Geschäft in Kasachstan oder Belarus — СДЭК Kasachstan (cdek.kz) und СДЭК Belarus (cdek.by) sind separate Unternehmen: Die Schlüssel des russischen Kontos funktionieren dort nicht, erforderlich sind ein Vertrag und ein Konto des lokalen СДЭК. Das Verfahren zum Erhalt der Schlüssel ist dasselbe.
Links#
- Website des Dienstes: https://www.cdek.ru/
- Konto: https://lk.cdek.ru/
- API-Dokumentation: https://apidoc.cdek.ru/