Search
Duplicate

Crossmall API 連動ガイド

API連動とは？

スマートシップシステムがショッピングモールの注文を取得し、注文確認および発送処理を遠隔で行うためにはAPI接続が必要です。 本文書では、 Crossmall サービスに対するAPI接続設定方法について説明します。
スマートシップがショッピングモールのAPIを使用する際には、販売者のアクセス権限が必要です。 接続時に販売者のログイン認証情報をスマートシップが直接保存することはできないため、「APIキー」という別途認証された情報を入力する必要があります。 APIキーはショッピングモール別に「パートナーキー」「秘密キー」などの名前で呼ばれることもあります。
準備事項
Crossmall サービスへのAPI接続設定には、次の情報が必要です。
•
ショップID： Crossmall のログインID
•
API KEY : Crossmall にて発行する認証鍵(下記ガイド参照)

スマートシップで Crossmall APIを設定する

1. Crossmall API KEYの発行を受ける

Crossmallでは、次の手順に従ってAPIキーを照会/発行することができます。
1.
Crossmall にログインした後 , システム設定 > 基本情報 > 基本情報 メニューに入ります。
2.
ページ下部の[編集]ボタンを押してください。
3.
ページ下部のAPI設定の[表示]ボタンを押すとAPIKEYが確認できます。 Crossmallが提供するAPIオプションは有料オプションですので、APIKEYが確認されない場合はCrossmallにお問い合わせください。 API設定中にIPアクセス制限の項目が0.0.0.0のみ入力されている場合は利用できませんので、正しいIPを入力してください。

2. スマートシップにCrossmall APIを登録する

ルート : スマートシップ > 注文 > ショッピングモール連動 > ショッピングモールAPI設定
次のようなステップに従ってAPI連動設定を行うことができます。
1.
ショッピングモールAPI設定ページに入り、右上の[+新規登録] を選択してください。
2.
“Crossmall”を選択した後、下段の"ショッピングモール連動登録"へスクロールを移動してください。
3.
API連動設定に必要な情報を入力して登録してください。
•
ショップID : CrossmallのログインIDを記載します。
•
Company Code : 1. CrossmallでAPI KEYの発行を受ける。の システム設定 > 基本情報 > 基本情報 メニューの ‘ 会社コード ‘部分がCompany Code です。
•
API Key : 1. CrossmallでAPI KEYの発行を受けるの 発行されたAPIKEY（認証鍵）を入力します
•
その他の注文連動オプションも選択してください。 詳細はガイドページの下部でご確認いただけます。

API接続設定オプション

API接続設定時に注文および商品連動動作の詳細を調整できるオプションがあります。
•
自動注文連動
•
自動注文確認
•
自動フルフィルメント出荷指示
•
自動在庫同期設定
•
追加設定
オプション設定の詳細については、以下のページをご確認くださ

API設定情報の確認

API接続情報を追加した後は、正常な通信が可能か確認します
•
[接続テスト] ボタンを押して、正常に接続されているかどうかを確認します。

Crossmall 注文連動可能ステータス値

Crossmallで発生した新規注文のうち “発送待機” 状態の注文を取得します。
システム設定 ＞ 処理フェーズ  メニューから ”QXPRESS発送済み” のフェーズを新たに追加してください。別の名称の値でフェーズが作成されますと、配送状態のアップデートはできませんので、ご参考ください。

Crossmall販売商品にSKU接続(フルフィルメント利用時)

在庫同期およびフルフィルメントサービスをご利用の場合は、 Crossmall 販売商品にスマートシップSKUを接続してください。
1.
スマートシップでCrossmallの商品名とスマートシップのSKUを接続することができます この時に入力する商品名/オプション値は、分かち書き、大文字、小文字をはじめとするテキストを同一に入力してください。
パス: スマートシップ > 在庫管理 > Fulfillment 商品管理
2.
Crossmallで発行した商品番号を入力してください。
3.
Crossmallで登録した商品のオプション名を属性1と属性2を半角カンマで組み合わせて入れてください。e.g. ホワイト,Sサイズ
パス: Crossmall Seller Shop > 出品処理 ＞商品一括処理＞＞商品を検索 ＞商品コード（標準）をクリック ＞ 商品情報