🚚 СДЭК: connessione e chiavi API
Contratto con СДЭК, chiave API nell'area riservata (Account e Secure password), tariffe magazzino-magazzino/magazzino-porta, ambiente di test EDU, СДЭК Kazakistan e Bielorussia.
Dove si configura: Pannello di controllo → «Spedizioni» → pulsante «Servizi di consegna» (oppure scheda della sede → WEB → «Servizi di consegna»).
Cosa serve#
- contratto con СДЭК per persona giuridica o imprenditore individuale;
- accesso all'area riservata lk.cdek.ru;
- indirizzo da cui si consegnano i pacchi (magazzino, negozio o ufficio).
Come ottenere le chiavi nell'area riservata del servizio#
- Stipulate il contratto con СДЭК: richiesta sul sito cdek.ru («Per le aziende» → «Stipulare un contratto») oppure tramite il manager della vostra città. Senza contratto le chiavi API non vengono rilasciate.
- Accedete all'area riservata lk.cdek.ru con l'account a cui è intestato il contratto.
- Aprite la sezione «Integrazione» e create una chiave per l'API (se la chiave esiste già, usatela).
- Copiate due valori: Account (identificativo del cliente) e Secure password (password segreta). Conservate Secure password come una password: non inviatela tramite messaggistica.
Cosa inserire nella scheda del servizio#
| Campo | Cosa inserire |
|---|---|
| Indirizzo del mittente | indirizzo del magazzino o del negozio da cui СДЭК ritira o a cui consegnate i pacchi |
| Quali tariffe mostrare | «magazzino-magazzino» (consegnate al Punto di ritiro, l'acquirente ritira al Punto di ritiro), «magazzino-porta» (corriere fino all'acquirente), «porta-porta» (il corriere ritira da voi) |
| account (client_id) | valore Account dall'area riservata |
| secure_password (client_secret) | valore Secure password dall'area riservata |
Verifica#
- Premete «Salva».
- Premete «Verifica connessione»: sotto la scheda compariranno le tariffe. La dicitura «Modalità mock» significa che le chiavi non sono collegate e le tariffe sono dimostrative.
- Spuntate «Attiva …» nella scheda: dopo di che il servizio comparirà all'acquirente durante la creazione dell'ordine.
Senza chiavi e modalità di test#
Senza chiavi la scheda funziona nell'ambiente di formazione di СДЭК e, se questo non è disponibile, mostra tariffe dimostrative: così è possibile vedere come appare la consegna nella vetrina, ancora prima del contratto. La casella «Modalità di test (sandbox)» invia le richieste all'ambiente di formazione api.edu.cdek.ru: per esso servono chiavi di test separate, rilasciate da СДЭК (le chiavi demo pubblicate nella documentazione vengono rifiutate).
Problemi frequenti#
- «Errore di connessione» / invalid_client — le chiavi sono invertite, copiate con uno spazio oppure è attiva la «Modalità di test» con chiavi di produzione. Disattivate la modalità di test e inserite di nuovo Account e Secure password.
- Nessuna tariffa nella risposta — la tariffa selezionata non è attiva per questa destinazione: spuntate anche «magazzino-porta» oppure verificate l'indirizzo del mittente.
- Negozio in Kazakistan o Bielorussia — СДЭК Kazakistan (cdek.kz) e СДЭК Bielorussia (cdek.by) sono società separate: le chiavi dell'area riservata russa non funzionano lì, servono un contratto e un'area riservata del СДЭК locale. La procedura per ottenere le chiavi è la stessa.
Link#
- Sito del servizio: https://www.cdek.ru/
- Area riservata: https://lk.cdek.ru/
- Documentazione API: https://apidoc.cdek.ru/