はぴロジAPI連携【Yahooショッピング】

◆API接続作業◆

■Yahooショッピング側　

＜ストアアカウント＞

Yahooショッピングの管理画面へログインいただき、ストアアカウントをご確認ください。

＜YahooAPI公開鍵（暗号キー）＞　※管理者権限を持った方のみアクセスが可能です

Yahooショッピングの管理画面へログインいただき、設定より「暗号鍵管理」を開き、以下情報をご確認ください。

• 公開鍵
• 公開鍵:バージョン 
• 公開鍵:有効期限 

確認方法の詳細はこちらの＜公開鍵（暗号キー）の確認方法＞の箇所をご確認ください。

■logiec側作業

　①logiecにログインし、

　「設定」→「事業者情報」→「販売チャネル設定」→「対応API設定」→「API接続設定」
　に進みます。

②API接続設定画面にて、「API接続設定」を有効にしてください。

③Yahooで確認したストアアカウントをご入力ください。

④Yahooで確認した以下情報を入力し、【保存する】をクリックします。

• 公開鍵
• 公開鍵:バージョン 
• 公開鍵:有効期限 

※公開鍵は 「-----BEGIN PUBLIC KEY-----○○○○-----END PUBLIC KEY-----」の全てのご入力が必要です

※この時点で接続テストを行っても接続NGになりますので、
　必ず【保存】をクリック後に接続テストを実施してください

⑤もう一度API接続設定画面にアクセスして【接続テスト】をクリックし、
　「接続テストに成功しました」と表示されれば接続完了です。

※公開鍵の有効期限は1年間なので、期限が切れたら再度この手順が必要となります

⑥保存後、対向API設定の画面に変わりますので、「API接続連携」をクリックし、
　Yahooの管理画面へログインを行ってください。　

※API連携のトークン有効期限は4週間です。
「トークンの有効期限が切れています。」とエラーが表示された場合は、⑥を再度行ってください。

◆出荷指示を連携する為の準備事項◆

１）配送サービスマスタの登録（必須設定*）

　配送便と配送時間帯については、Yahooショッピング画面上
　「ストア構築」→「カート設定」→「配送方法、送料設定」で登録している
　【配送方法（表示名】、【配送スケジュール】の文字列をlogiec上の
　「配送サービスマスタ」に登録します。

　

●logiec画面「配送サービスマスタ」

配送サービスマスタへの行き方はこちら

※「項目追加」で追加が出来ますので、出荷指示に入る可能性のある文字列すべてご入力ください。
※文字列は完全一致である必要があります。

２）支払方法マスタの登録（必須設定*）

お支払方法については、Yahooショッピング画面上
「ストア構築」→「カート設定」→「お支払方法、手数料設定」で利用可能登録をしている
【お支払方法】文字列を、logiec上の「支払方法マスタ」に登録します。

●logiec画面「支払方法マスタ」

支払い方法マスタへの行き方はこちら

※「項目追加」で追加が出来ますので、出荷指示に入る可能性のある文字列すべてご入力ください。
※文字列は完全一致である必要があります。

３）商品マスタ一括登録（必須登録*）

YahooショッピングではAPI連携による一括連携が可能です。
logiec画面：「商品」→「商品マスタアップロード」→「API連携登録」ボタン押下

◆出荷指示を連携する◆

---

■連携する場合の注意事項

　受注を連携対象にする必要があります。
　連携対象のステータスは下記の通りです。

・入金ステータス：支払待ち、支払完了、入金待ち、決済完了

・出荷ステータス：出荷可

※支払方法によって、入金ステータス毎に出荷可になるタイミングが変わります。

　　前払いの場合：「支払完了」or「決済完了」or「入金済み」かつ「出荷可」

　　後払いの場合：「支払待ち」or「支払完了」or「入金待ち」or「決済完了」かつ「出荷可」

　　上記が連携対象の出荷指示データとなります。

■logiecで出荷指示を取得する

　logiecで出荷指示を取得する場合「手動API連携」と「時間による自動連携」の2種類があります。

〇手動API連携方法

・「出荷指示」→「出荷指示アップロード」
＜API連携で取得して登録する＞「API連携登録」ボタンを押下

・「出荷リスト」から受注データを確認

〇時間による自動連携方法

自動連携の設定詳細はこちらをご確認ください。

◆在庫を連携する◆

---

　logiecが保持している在庫データをYahooに返却します。在庫連携のタイミングは1日4回までです。
　また、出荷されていない受注の情報を取得することにより、logiecが保持している販売可能在庫から差し引くことも可能です。
　詳細は以下ページをご覧ください。
　在庫連動機能-設定方法

■連携する場合の注意事項

Yahooでの出荷指示、未出荷の定義を以下のように定義します。

・決済ステータスが「支払い待ち」「支払完了」「入金待ち」「決済完了」且つ、出荷ステータスが「出荷可」の状態を「出荷指示」とします。

・決済ステータスが「支払い待ち」「支払完了」「入金待ち」「決済完了」且つ、出荷ステータスが「出荷可不可」の状態を「未出荷」とします。

・Yahooのステータスは以下の順で遷移します。

■Yahooで在庫を取得する

　Yahooで在庫を取得する場合「手動API連携」と「時間による自動連携」の2種類があります。

▶手動API連携方法
「在庫」→「在庫ダウンロード」＜ダウンロード＞「連携」ボタンを押下

▶時間による自動連携方法
　事前に自動連携時間を設定いただくことにより在庫を取得できます。
　設定方法はこちらの「APIの自動連携項目「在庫」の時間設定」をご参照ください。