🚚 СДЭК: conexión y claves API
Contrato con СДЭК, clave API en el área de cliente (Account y Secure password), tarifas almacén-almacén/almacén-puerta, entorno de pruebas EDU, СДЭК Kazajistán y Bielorrusia.
Dónde se configura: Panel de control → «Envíos» → botón «Servicios de entrega» (o ficha del local → WEB → «Servicios de entrega»).
Qué se necesita#
- contrato con СДЭК para persona jurídica o empresario individual;
- acceso al área de cliente lk.cdek.ru;
- dirección desde la que entrega los paquetes (almacén, tienda u oficina).
Cómo obtener las claves en el área de cliente del servicio#
- Celebre un contrato con СДЭК: solicitud en el sitio cdek.ru («Para empresas» → «Celebrar contrato») o a través del gestor de su ciudad. Sin contrato no se emiten claves API.
- Inicie sesión en el área de cliente lk.cdek.ru con la cuenta a cuyo nombre se formalizó el contrato.
- Abra la sección «Integración» y cree una clave para API (si ya tiene una clave, úsela).
- Copie dos valores: Account (identificador del cliente) y Secure password (contraseña secreta). Guarde Secure password como una contraseña: no la envíe por mensajería.
Qué introducir en la ficha del servicio#
| Campo | Qué introducir |
|---|---|
| Dirección del remitente | dirección del almacén o tienda desde donde СДЭК recoge o adonde usted lleva los paquetes |
| Qué tarifas mostrar | «almacén-almacén» (entrega en el Punto de recogida, el comprador recoge en el Punto de recogida), «almacén-puerta» (mensajero hasta el comprador), «puerta-puerta» (el mensajero recoge en su domicilio) |
| account (client_id) | valor Account del área de cliente |
| secure_password (client_secret) | valor Secure password del área de cliente |
Comprobación#
- Pulse «Guardar».
- Pulse «Comprobar conexión»: bajo la ficha aparecerán las tarifas. La etiqueta «Modo simulado» significa que las claves no están conectadas y las tarifas son de demostración.
- Marque «Activar …» en la ficha: después de esto el servicio aparecerá para el comprador al tramitar el pedido.
Sin claves y modo de prueba#
Sin claves, la ficha funciona en el entorno de pruebas de СДЭК y, si no está disponible, muestra tarifas de demostración: así puede ver cómo se muestra la entrega en el escaparate incluso antes del contrato. La casilla «Modo de prueba (sandbox)» envía las solicitudes al entorno de pruebas api.edu.cdek.ru; para él se necesitan claves de prueba aparte, las emite СДЭК (rechaza las claves de demostración publicadas en la documentación).
Problemas frecuentes#
- «Error de conexión» / invalid_client — las claves están intercambiadas, copiadas con un espacio o está activado el «Modo de prueba» con claves de producción. Desactive el modo de prueba e introduzca de nuevo Account y Secure password.
- No hay tarifas en la respuesta — la tarifa seleccionada no funciona para esta dirección: marque también «almacén-puerta» o compruebe la dirección del remitente.
- Tienda en Kazajistán o Bielorrusia — СДЭК Kazajistán (cdek.kz) y СДЭК Bielorrusia (cdek.by) son empresas distintas: las claves del área de cliente rusa no funcionan allí, se necesita un contrato y un área de cliente del СДЭК local. El procedimiento para obtener las claves es el mismo.
Enlaces#
- Sitio del servicio: https://www.cdek.ru/
- Área de cliente: https://lk.cdek.ru/
- Documentación de API: https://apidoc.cdek.ru/