ストア連携
他店の商品を自店に取り込んで販売します。顧客が注文すると、あなたの店が自動的に残高で上流に発注し、受け取ったカードを顧客に渡します。すべて顧客からは見えません。
連携は何段でも入れ子にできます — あなたと連携した相手が、さらに別の相手と連携できます。発送は常に最上流の店舗から行われます。
他店と連携する手順
1. 相手の店で登録する
連携したい店舗でアカウントを作り、会員センター → マイページから 2 つを取得します。
- 加盟店 ID（
app_id） - 加盟店キー（
app_key）
2. 店舗を追加する
自分の管理画面 → ストア連携 → 店舗を追加。相手の店舗アドレスと、取得した ID・キーを入力して確定します。
3. 商品を取り込む
追加できると、操作列にプラグのアイコンが表示されます。これをクリックすると相手の商品を自分のカテゴリに取り込めます。
取り込んだ商品は既定で非公開です。価格を調整してから公開してください。
4. 残高をチャージする
これを忘れないでください。 顧客が注文すると、システムは相手の店にあるあなたの残高で仕入れます。残高が無ければ、代金を受け取ったのに発送できません。
推奨：
- 上流に十分な残高を確保しておく
- 残高警告系のプラグインを入れて、尽きる前に気付けるようにする
上流のアカウントで資金操作の追加認証がオンになっている場合（2段階認証を有効にすると自動でオンになります）は、先に上流の会員センターで、自分のサーバーの IP を連携用 IP ホワイトリストに追加してください。追加しないと連携注文は拒否されます。既定のテーマでは「連携用ホワイトリスト」ページ、ほかのテーマでは「2段階認証」ページにあります。IP が分からなければ、まず 1 件注文してみてください。拒否された IP がホワイトリストの下の「最近拒否された接続元」に表示され、ワンクリックで追加できます。資金操作の追加認証がオフでも、追加しておくことをおすすめします。加盟店キーが万一漏れても、ほかの IP からあなたの残高で注文されることはありません。上流がまだ 3.8.1 の場合はホワイトリストがないため、資金操作の追加認証をオフにするしかありません。
顧客が注文したとき何が起きるか
- 顧客があなたの店で支払う
- あなたの店が
app_id／app_keyで上流に発注し、残高で支払う - 上流が発送する（カード、または上流側のプラグインによる発送）
- 結果があなたのローカル注文に保存され、顧客に表示される
顧客には、商品が他店から来たことは分かりません。
価格と利益
利益は「あなたの販売価格 − 上流があなたに提示する価格」です。
上流の価格は、その店でのあなたの会員ランクで決まります。ランクが高いほど安くなります。より安く仕入れたいなら、上流でチャージしてランクを上げるか、ランクを直接調整してもらってください。
価格同期を使うと、上流の価格変動に合わせてローカル価格を自動更新できます。
逆に、自分が上流になる場合
他店に自分の商品を卸すには：
- 商品の API 連携を有効にする（無効だと取得されません。商品管理参照）
- 連携先に適切な会員ランクを割り当てる。ランクが仕入れ値を決めます
- 特定の商品の卸値を制御したい場合は、その商品の会員価格でランク別に設定する
プロトコルの詳細は API リファレンスにあります。
確認リスト
| 症状 | 原因 |
|---|---|
| 店舗の追加に失敗する | アドレス・加盟店 ID・キーの誤り、または相手側で連携が無効 |
| 商品一覧が取得できない | 相手の商品で「API 連携」が有効になっていない |
| 顧客の注文でエラーになり発送されない | 上流での残高が尽きています |
| 注文時に「该账号已开启资金二次验证，必须先登记对接白名单 IP 才能通过对接接口用余额下单。请登录该账号的会员中心，在「对接白名单」（或「两步验证」页）把服务器 IP 加入白名单；被拒的 IP 会列在那里」（資金操作の追加認証が有効なため、先に連携用ホワイトリストへ IP を登録する必要がある）というエラーになる | 上流は 3.8.2 以降で、上流のアカウントで資金操作の追加認証がオンになっているのに、ホワイトリストが空です。上流の「連携用ホワイトリスト」ページ（ほかのテーマでは「2段階認証」ページ）で、「最近拒否された接続元」から自分のサーバーの IP を連携用 IP ホワイトリストに追加してください |
| 注文時に「调用方 IP 不在该账号的对接白名单内。请登录该账号的会员中心，在「对接白名单」（或「两步验证」页）把服务器 IP 加入白名单；被拒的 IP 会列在那里」（呼び出し元の IP がこのアカウントの連携用ホワイトリストにない）というエラーになる | 上流は 3.8.2 以降で、上流のアカウントにはホワイトリストがありますが、自分のサーバーの IP が入っていません（サーバーを移した場合など）。同じく「最近拒否された接続元」から追加してください |
| 注文時に「该账号已开启资金二次验证，无法通过对接接口消费余额」（連携 API では残高を使えない）というエラーになる | 上流は 3.8.1 で、ホワイトリストがありません。上流の「2段階認証」ページで資金操作の追加認証をオフにするか、上流に 3.8.2 へのアップグレードを依頼してホワイトリストを使ってください |
| 想定より価格が高い | 上流でのランクが低い、またはその商品に個別価格が設定されています |
上乗せテンプレート
管理画面の上乗せテンプレートでは、共通の値付けルール（上流価格 × 1.2 など）を定義し、取り込んだ商品にまとめて適用できます。1 件ずつ価格を直す必要がありません。