🚚 CDEK：集成与 API 密钥
与 CDEK 签订合同、个人账户中的 API 密钥（Account 和 Secure password）、仓库-仓库/仓库-门配送费、EDU 测试环境、CDEK 哈萨克斯坦和白俄罗斯。
配置位置： 控制面板 → “发货” → “配送服务”按钮（或门店卡片 → WEB → “配送服务”）。
需要准备什么#
- 与 CDEK 签订的法人或个体经营者合同；
- lk.cdek.ru 个人账户的访问权限；
- 您发出包裹的地址（仓库、商店或办公室）。
如何在服务账户中获取密钥#
- 与 CDEK 签订合同：在 cdek.ru 网站提交申请（“企业” → “签订合同”）或通过您所在城市的客户经理。没有合同不会发放 API 密钥。
- 使用签订合同时所用的账户登录个人账户 lk.cdek.ru。
- 打开 “集成” 部分，为 API 创建密钥（如果已有密钥——直接使用）。
- 复制两个值：Account（客户标识符）和 Secure password（密钥密码）。Secure password 请像密码一样保管：不要通过即时通讯工具转发。
在服务卡片中填写什么#
| 字段 | 填写内容 |
|---|---|
| 发件人地址 | CDEK 上门取件或您送达包裹的仓库或商店地址 |
| 显示哪些配送费 | “仓库-仓库”（您送到自提点，买家在自提点取件）、“仓库-门”（快递员送到买家）、“门-门”（快递员上门取件） |
| account (client_id) | 账户中的 Account 值 |
| secure_password (client_secret) | 账户中的 Secure password 值 |
检查#
- 点击 “保存”。
- 点击 “检查连接”：卡片下方会显示配送费。出现“模拟模式”字样表示密钥未连接，配送费为演示数据。
- 在卡片中勾选“启用 …”——之后该服务会出现在买家下单页面。
无密钥与测试模式#
没有密钥时，卡片在 CDEK 教学环境中运行，如果该环境不可用——则显示演示配送费：这样可以在签订合同前查看配送在店铺前台的展示效果。勾选 “测试模式 (sandbox)” 会将请求发送到教学环境 api.edu.cdek.ru——它需要单独的测试密钥，由 CDEK 发放（文档中公布的演示密钥会被它拒绝）。
常见问题#
- “连接错误” / invalid_client —— 密钥顺序颠倒、复制时带有空格，或在使用正式密钥时开启了“测试模式”。请关闭测试模式，重新填入 Account 和 Secure password。
- 响应中没有配送费 —— 所选配送费不适用于该方向——请再勾选“仓库-门”或检查发件人地址。
- 商店在哈萨克斯坦或白俄罗斯 —— CDEK 哈萨克斯坦 (cdek.kz) 和 CDEK 白俄罗斯 (cdek.by) 是独立公司：俄罗斯账户的密钥在那里无法使用，需要与当地 CDEK 签订合同并开设账户。获取密钥的流程相同。
链接#
- 服务网站：https://www.cdek.ru/
- 个人账户：https://lk.cdek.ru/
- API 文档：https://apidoc.cdek.ru/