🚚 CDEK:接続とAPIキー
CDEKとの契約、管理画面のAPIキー(AccountとSecure password)、倉庫-倉庫/倉庫-ドアの配達料金、テスト環境EDU、CDEKカザフスタンとベラルーシ。
設定場所: 管理パネル → 「発送」 → 「配送サービス」ボタン(または店舗のカード → WEB → 「配送サービス」)。
必要なもの#
- 法人または個人事業主としてのCDEKとの契約
- 管理画面 lk.cdek.ru へのアクセス
- 荷物を引き渡す住所(倉庫、店舗、またはオフィス)
サービス管理画面でキーを取得する方法#
- CDEKと契約を締結します:cdek.ruのサイト(「法人向け」→「契約を締結」)またはお住まいの都市の担当者を通じて申し込みます。契約がないとAPIキーは発行されません。
- 契約を結んだアカウントで管理画面 lk.cdek.ru にログインします。
- 「インテグレーション」 セクションを開き、API用のキーを作成します(すでにキーがある場合はそれを使用します)。
- 2つの値をコピーします:Account(クライアントID)と 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/