連携スタートまでの設定手順 (受注処理)【Yahoo!ショッピング】 ID:64626

Yahoo!ショッピングの受注処理(API)を開始するための設定リストです。
本ページの設定をすべて行うと、受注処理に必要な設定が完了します。

設定に困ったら

「操作がうまくいかない」「エラーがでる」などご不明な点がありましたらお気軽にサポートセンターへご相談ください。

■ネクストエンジン サポートセンター

電話  :メイン機能画面 右上をご参照ください

受付時間:平日10:00~12:30/13:30~18:00
(定休日:土曜/日曜/祝祭日)

API利用時の受注処理の流れ

■自動化される処理の概要

Yahoo!ショッピングとの連携に受注APIを利用すると、下記の処理を自動化できます。

・Yahoo側の受注データの取り込み

・Yahoo側の入金情報の取り込み (前払い決済の注文のみ)

・本システムからYahoo側への出荷情報反映(ステータス更新)

※注文受付後にYahoo側で内容の確認や修正が必要な場合は、APIではなく受注CSVをご利用ください。

■受注処理の流れ

商品登録はお済みですか?

受注処理を開始するためには、本システムに商品登録が必要です。
商品登録がお済みではない場合、本設定とあせて商品登録を行ってください。

商品コードルール、商品の登録方法は下記マニュアルをご参照ください。

商品登録の進め方 店舗の商品データを利用した商品登録

1.店舗の登録

【本システム画面】

  1. [設定]→[基本]より[店舗]をクリック

■店舗を新規登録する場合

  1. [店舗の追加画面を開く]をクリック

■店舗情報を更新する場合

  1. 対象の店舗を選択
  2. [編集画面を開く]をクリック
  1. 必須項目を入力

    1.店舗名称
    店舗の名称を入力

    2.店舗略記
    検索画面や受注伝票画面での表示名を入力
    ※使用可能文字:英数字、かな、漢字
    ※入力可能数:半角/全角5文字

    3.出店モール
    Yahoo!ショッピング」を選択

    4.規定の発送方法
    各種機能の初期値に利用する発送方法を選択

    5.税区分
    「税込」を選択
    (Yahoo!ショッピングは、受注データに固定で税込金額が反映される仕様です。税抜きを選択した場合、受注伝票の商品計が正しく計算されません。)

    6.税計算順序
    税金の計算方法を選択

    7.通貨単位区分
    モール側の通貨単位を選択

  1. [店舗を新規登録]をクリック
    (店舗情報の更新の場合は[店舗情報を更新]と表示されます)

2.API認証情報の登録

Yahoo!ショッピングの受注情報自動取り込み、在庫連携のためのAPI認証情報を本システムに登録します。

必ずご確認ください

・ログインアカウント
本操作を行う際は、ストアクリエイターProをログアウトするか、必ず設定するYahoo!ショッピング店舗のアカウントでストアクリエイターProにログインしていることを確認のうえ、設定を行ってください。

・操作可能なユーザー権限
ストアクリエイターProにツール管理権限(Yahoo!ビジネスマネージャー)が付与された、Yahoo! JAPANビジネスIDのみ操作が可能です。

2-1.Yahoo!ショッピングより「公開鍵」を発行

【ストアクリエイターPro画面】

  1. [設定]より[暗号鍵管理]をクリック
  1. 「Web APIを利用する」にチェックをつける
  2. [公開鍵発行]をクリック
  1. 「有効/無効」にて「有効」にチェック
  2. 有効にした公開鍵の「バージョン」を確認
    (次章にて本システムにバージョンを設定します)
  3. 「公開鍵」にて[コピー]をクリック
    (次章にて本システムに公開鍵を貼り付けます)

2-2.本システムへ「公開鍵」を登録

■API公開鍵の有効期限
API公開鍵の有効期限は1年です。期限を過ぎるとAPIでの連携ができなくなります。

【本システム画面】

  1. [設定]→[基本]より[API]をクリック
  1. Yahoo店を選択
  2. ストアアカウントを入力

ストアアカウントの確認方法

ストアクリエイターPro右手をご確認ください。

  1. コピーした「公開鍵」を貼り付け

    ※コピーした内容をそのまま貼り付けてください

  2. 確認した「バージョン」を選択
    ※入力する場合は半角数字
  3. [設定を保存]をクリック
  1. 「API設定を更新しました。」と表示されたことを確認

※「店舗情報取得に失敗しました。正しく店舗設定がされているか確認してください」が表示された場合、入力内容に誤りがあります。再度手順3より設定を行ってください。

2-3.API連携認可の取得

■事前の確認事項

・連携認可の有効期限は4週間(28日間)です。4週間ごとに再認可が必要です。

・API認証(公開鍵の登録)を行っていない場合、12時間ごとに再認可が必要となります。

【本システム画面】
[設定]→[基本]より[API]を開く

  1. [Y!ログイン]をクリック

    Yahoo!ショッピングログイン画面が開く
  1. 注文管理権限が付与されたYahoo! JAPANビジネスIDに紐づく、Yahoo! JAPAN IDでログイン
  1. 注意事項を確認し、[同意してはじめる]をクリック
  1. 「認可情報を登録しました」と表示されたことを確認

API認可の有効期限は4週間です

期限を過ぎるとAPI連携ができなくなります。
下記をご参照の上、再認可を4週間ごとに行ってください。

API連携の再認可(4週間ごと)

  1. 利用する機能をチェック
    (左図の※1~4の機能に関しては、下記「API連携の機能概要」をご参照ください。)
  2. [設定を保存]をクリック


API連携が可能な状態となります。

■API連携の機能概要

※1:キャンセル受付中の連携設定
Yahoo側でキャンセル受付中の注文も取込対象にする場合に必要な項目です。詳細は下記をご参照ください。

キャンセル受付中の注文取込設定

※2:自動入金確認
Yahoo側の入金状況を、本システムの伝票に反映するための項目です。詳細は下記をご参照ください。

入金済データの取込設定(API)

※3:注文ステータス自動完了
出荷が完了した際、Yahoo側のステータス自動更新、および配送情報の反映を行うための項目です。詳細は下記をご参照ください。

店舗のステータス更新と配送番号反映(自動)

※4:注文ステータス自動キャンセル
本システムの受注伝票キャンセル時、Yahoo側の注文ステータスを自動で「キャンセル」にするための項目です。ご利用前に必ず下記ページをご参照ください。

受注キャンセルを店舗に自動反映

3.配送方法の取込設定

本システムの受注伝票に配送方法を反映するための手順です。
Yahoo!ショッピング側で設定されている配送方法の名称を、本システムの発送方法に紐づけます。

3-1.Yahoo!ショッピングの配送方法を確認する

【ストアクリエイターPro画面】

  1. [ストア構築]→[カート設定]より[配送方法、送料設定]をクリック
  1. [配送方法、配送スケジュール、送料]にて[配送方法(表示名)]を確認

3-2.確認した配送方法(表示名)を発送方法に紐づける

【メイン機能画面】

  1. [設定]→[受注]より[支払発送変換]をクリック
  1. 左側「受注CSVファイルでの名称」とYahoo!ショッピングの「配送方法(表示名)」が一致する場合、右側「変換する値」にて任意の発送方法を選択

    左側「受注CSVファイルでの名称」に一致する名称がない場合、画面下部の空欄に「配送方法(表示名)」を入力し、発送方法を選択してください

  2. [変換内容を保存] をクリック

4.配送希望日と時間帯の取込設定

購入者が指定したお届け希望日時の情報を受注伝票に取り込むための設定です。
受注データ取込時に「備考欄」に入る情報を、備考欄変換にて「時間指定」「配達希望日」に反映させます。

4-1.Yahoo!ショッピングにて配送日時を設定

【Yahoo!ショッピング画面】

  1. [ストア構築]→[カート設定]より[配送方法、送料設定]をクリック
  1. 設定を行う配送方法の「配送スケジュール」にて[編集]をクリック
  1. 「お届け希望日の設定」にて[表示する]を選択

    ※「最短お届け日」が未設定の場合、[編集]をクリックして設定を行ってください

  2. 「お届け希望時間帯の設定」にて[表示する]を選択
  3. 時間帯を追加する

    ※時間帯は下記の■配送会社ごとのお届け時間帯表をご参照ください。


[確認]をクリックし、設定を完了させてください

■配送会社ごとのお届け時間帯表

佐川急便 ヤマト運輸 福山通運 西濃運輸 日本通運 ゆうパック
指定なし 指定なし 指定なし 指定なし 指定なし 指定なし
午前中 午前中 AM指定 午前中 午前中 午前中
12時-14時 14時-16時 PM指定 午後 12時-14時 12時頃-14時頃
14時-16時 16時-18時 10時-12時 14時-16時 14時頃-16時頃
16時-18時 18時-20時 12時-14時 16時-18時 16時頃-18時頃
18時-20時 19時-21時 14時-16時 18時-20時 18時頃-20時頃
18時-21時 16時-18時 20時-21時 19時頃-21時頃
19時-21時 18時-20時 20時頃-21時頃

4-2.本システムの備考欄変換設定

受注伝票の「備考欄」に入るデータを変換し、「時間指定」に反映させる設定を行います。
同時に、反映済みのデータを備考欄から削除する設定を行うと、[確認待ち]ステータスに止まる伝票を削減できます。

(お届け希望日を伝票に反映させる設定は本システムにあらかじめ設定されています。)

  1. [設定]→[受注]より[備考欄変換]をクリック

店舗を選択

  1. 受注伝票の項目に反映させる設定
    変換前 :Yahoo側に登録した時間帯を入力
    変換方法:[項目に変換]を選択
    変換後 :受注伝票に反映させる値を選択

※時間帯は「お届け時間:HH:MM-HH:MM」(半角コロン区切り)形式で入力してください。

  1. 反映後、「備考欄」の値を消す設定
    変換前 :Yahoo側に登録した時間帯を再入力
    変換方法:[文字列に変換]を選択
    変換後 :空欄
  2. [変換内容を保存]をクリック

5.受注メールの取込設定

Yahoo!ショッピングから送信される受注メール(注文確認メール)を、本システムに転送させる設定です。
受注メールが取り込まれると、受注管理画面の[新規受付]ステータスに受注伝票が作成され、在庫の引当(割り当て)が行われます。

5-1.本システムの「受注情報取込み用メールアドレス」を確認

【本システム画面】

  1. [設定]→[基本]より[店舗]をクリック
  1. Yahoo店を選択
  2. 「受注情報取込み用メールアドレス」を確認

5-2.Yahoo!ショッピング側にアドレスを登録

【ストアクリエイターPro画面】

  1. [設定]より[アラート・通知]をクリック
  1. [メールアドレスを追加]をクリック

※1:本システムへのメール取込を停止する場合は該当のアドレスを確認し、[削除]をクリックしてください。

  1. 「メールアドレス」に受注情報取込み用メールアドレスを入力
  2. 「注文」にチェック
  3. [メールアドレスを追加]をクリック

6.受注取込を開始する

6-1.事前の確認事項

Yahoo!ショッピングの受注データの自動取込を開始するための設定です。
本設定を完了すると、約15分間隔でYahoo!ショッピングの受注データが自動取込されます。

■受注取込時の動き
APIにて受注データを取得した際、Yahoo側のステータスを下記の通りに更新します。
・注文ステータス:[新規注文] → [処理中]、[新規予約] → [予約中]
・注文処理状況 :[新規注文] → [出荷待ち]

■取込対象の受注
・Yahoo側のステータス[新規注文]と[新規予約]の注文
・前回受注API取込の実行タイミング以降の注文

■初回受注API起動時の注意
初めて受注APIが動作した際は、24時間前まで遡って受注を取り込みます。

■注文保留の注文
Yahoo側で注文保留状態となった注文は、審査完了後に審査OKの注文のみ受注データを取り込みます。
注文保留受注の運用詳細は下記マニュアルご参照ください。

注文保留受注の運用方法

■ソーシャルギフトの注文
受け取り側が住所入力を完了しストアクリエイターProに注文が起票された後、受注データを取り込みます。

■注文承諾メール、出荷通知メールについて
受注APIを利用した受注データの取り込み、出荷通知を行った場合、Yahooにて「注文承諾メール」「出荷通知メール」は自動送信されません。(Yahooの仕様上、API処理によりステータス更新のみ行われるため)

6-2.操作手順

【本システム画面】

  1. [設定]→[基本]より[自動実行処理]をクリック
  1. [設定]→[基本]→[自動実行処理]にて、「受注取得API」を「起動」に変更

    ※「引当処理」が「停止」の場合は「起動」に変更

  2. [自動実行処理を変更]をクリック

あわせて確認しておきたい便利機能

■[確認待ち]ステータスで止めるための設定

住所不備や購入者メッセージなど、目視確認が必要な注文を自動で保留し、誤出荷を防ぐ設定ができます。
「受注確認内容設定」にて条件を指定することで、該当伝票を[確認待ち]ステータスに自動で留めます。

特定条件の受注を[確認待ち]に止める

■自動送信メールの設定

伝票のステータス状況に応じて、サンクスメールや発送案内メールを自動送信することができます。

自動送信メールのご利用に必要な設定

■送り状発行システムの連携設定

送り状発行システムと連携も可能です。
出荷業務を開始するための設定は、下記マニュアルをご参照ください。

送り状発行システムとの連携