🚚 CDEK: kết nối và khóa API
Hợp đồng với CDEK, khóa API trong tài khoản cá nhân (Account và Secure password), phí giao hàng kho-kho/kho-cửa, môi trường thử nghiệm EDU, CDEK Kazakhstan và Belarus.
Nơi cấu hình: Bảng điều khiển → “Đơn gửi” → nút “Dịch vụ giao hàng” (hoặc thẻ chi nhánh → WEB → “Dịch vụ giao hàng”).
Cần những gì#
- hợp đồng với CDEK cho pháp nhân hoặc hộ kinh doanh cá thể;
- quyền truy cập vào tài khoản cá nhân lk.cdek.ru;
- địa chỉ nơi bạn gửi bưu kiện đi (kho, cửa hàng hoặc văn phòng).
Cách lấy khóa trong tài khoản của dịch vụ#
- Ký hợp đồng với CDEK: đăng ký trên trang cdek.ru (“Doanh nghiệp” → “Ký hợp đồng”) hoặc qua quản lý của thành phố bạn. Không có hợp đồng thì không được cấp khóa API.
- Đăng nhập vào tài khoản cá nhân lk.cdek.ru bằng tài khoản đã đăng ký hợp đồng.
- Mở mục “Tích hợp” và tạo khóa cho API (nếu đã có khóa — hãy dùng khóa đó).
- Sao chép hai giá trị: Account (mã định danh khách hàng) và Secure password (mật khẩu bí mật). Hãy giữ Secure password như mật khẩu: không gửi nó qua ứng dụng nhắn tin.
Điền gì vào thẻ dịch vụ#
| Trường | Điền gì |
|---|---|
| Địa chỉ người gửi | địa chỉ kho hoặc cửa hàng nơi CDEK đến lấy hoặc nơi bạn mang bưu kiện đến |
| Hiển thị phí giao hàng nào | “kho-kho” (bạn giao tại điểm nhận hàng, người mua nhận tại điểm nhận hàng), “kho-cửa” (chuyển phát đến người mua), “cửa-cửa” (chuyển phát đến lấy tại chỗ bạn) |
| account (client_id) | giá trị Account trong tài khoản |
| secure_password (client_secret) | giá trị Secure password trong tài khoản |
Kiểm tra#
- Nhấn “Lưu”.
- Nhấn “Kiểm tra kết nối”: bên dưới thẻ sẽ hiện ra các phí giao hàng. Dòng chữ “Chế độ mô phỏng” nghĩa là khóa chưa được kết nối và phí giao hàng chỉ là minh họa.
- Đánh dấu “Bật …” trong thẻ — sau đó dịch vụ sẽ xuất hiện cho người mua khi đặt hàng.
Không có khóa và chế độ thử nghiệm#
Không có khóa, thẻ hoạt động trong môi trường học tập của CDEK, còn nếu môi trường đó không khả dụng — sẽ hiển thị phí giao hàng minh họa: như vậy có thể xem giao hàng trông thế nào trên gian hàng ngay cả trước khi ký hợp đồng. Ô đánh dấu “Chế độ thử nghiệm (sandbox)” gửi yêu cầu đến môi trường học tập api.edu.cdek.ru — môi trường này cần khóa thử nghiệm riêng, do CDEK cấp (khóa demo công bố trong tài liệu sẽ bị từ chối).
Vấn đề thường gặp#
- “Lỗi kết nối” / invalid_client — các khóa bị đổi chỗ cho nhau, bị sao chép kèm dấu cách hoặc đang bật “Chế độ thử nghiệm” với khóa thật. Hãy tắt chế độ thử nghiệm và dán lại Account và Secure password.
- Không có phí giao hàng trong phản hồi — phí giao hàng đã chọn không hoạt động theo hướng này — hãy đánh dấu thêm “kho-cửa” hoặc kiểm tra địa chỉ người gửi.
- Cửa hàng ở Kazakhstan hoặc Belarus — CDEK Kazakhstan (cdek.kz) và CDEK Belarus (cdek.by) là các công ty riêng: khóa của tài khoản Nga không hoạt động ở đó, cần hợp đồng và tài khoản của CDEK địa phương. Trình tự lấy khóa vẫn như vậy.
Liên kết#
- Trang dịch vụ: https://www.cdek.ru/
- Tài khoản: https://lk.cdek.ru/
- Tài liệu API: https://apidoc.cdek.ru/