API連携の仕様(ショップサーブ)

ショップサーブとAPI連携する際の、受注取込・商品コード・出荷実績反映・在庫連携の動作仕様をまとめたページです。
連携前にあわせてご確認ください。

受注取込

ショップサーブ上で受注処理中の注文のうち、お届け先の発送ステータスが「未発送」のものを取込対象としています。
ここでの「受注処理中の注文」とは、「取引完了」「キャンセル」「ごみ箱に移動」のいずれも行われていない注文を指します。

あわせて、以下を確認し、条件に合わない受注は取り込みません。

• 不正注文シグナルが正常であること
• 決済方法・決済ステータス・入金ステータス・配送方法・配送希望時間が、SCシステム側で変換可能であること

商品コードの仕様

ショップサーブとSCシステムを連携する際は、ショップサーブ上で商品番号などの設定が必要です。
商品コードは、選択肢の有無によって構成が異なります。

選択肢のない商品の場合

ショップサーブの「商品番号」が、そのまま商品コードとなります。

選択肢つき（商品バリエーション）商品の場合

バリエーション管理にて「商品枝番号」の設定が必要です。
「商品番号」と「商品枝番号」を連結した文字列が商品コードとなります。

• ショップサーブ公式ページ：バリエーションを登録・変更・削除する

出荷実績反映

SCシステムで出荷が完了すると、以下の項目がショップサーブ側へ送信されます。

• 配送会社コード
• 出荷日
• 送り状No

在庫連携

ショップサーブと在庫連携する際は、次の仕様にご注意ください。

• SCシステムとの在庫連携時は、ショップサーブの「在庫わずか機能」はご利用いただけません。連携時に「未設定」へ書き換えられます。
• 「在庫わずか機能」をご利用の品番は、連携を無効に設定してください。
• 在庫連携時は在庫数が上書きされます。在庫数を無制限に設定している品番も、連携を無効に設定してください。

• ショップサーブ公式マニュアル（在庫わずか機能・在庫設定）：https://help.shopserve.jp/manual/029/