API連携の仕様(ネクストエンジン)

受注取込

ネクストエンジン上の注文データをSCシステムへ取り込みます。

1. 連携間隔

• 約10分に1回、注文データを自動的に連携

2. 取得条件

• 取込対象の注文ステータス：印刷待ち

• すべての商品に商品分類タグ [STOCKCREW連携対象] が登録されている
• 受注分類タグに以下のいずれも含まれていない
  • [STOCKCREW除外]
  • [STOCKCREW出荷指示失敗]
• 伝票がキャンセルされていない 
• 発送方法が下記のいずれかに該当する

1. • • ヤマト(発払い)B2v6
     • ヤマト(発払い)B2v5
     • ヤマト(ネコポス)

※ 上記以外の配送方法も取得可能です。 

※ SCシステムの配送方法への変換ルール（商品分類タグ [SCハード資材発送] が設定されている場合を含む）は、
「デフォルトの配送方法(ネクストエンジン)」をご確認ください。 

3. 出荷依頼「成功」時

• 伝票に [STOCKCREW出荷指示済み] タグが登録されます。

• 伝票のステータスが [印刷待ち] から [印刷済み] へ移動します。

4. 出荷依頼「失敗」時

• 伝票に受注分類タグ [STOCKCREW出荷指示失敗] が登録されます。
• 伝票のステータスは[印刷待ち]のまま移動しません。
• SCシステムのAPI連携ログ一覧にエラーで表示されます。

5. 配送方法をコンパクトに連携する場合

配送方法を「宅急便コンパクト」に指定する場合は、ネクストエンジンの受注明細画面にある「送り状情報」セクション内の項目を以下のように設定してください。

• 発送方法：ネコポス
• 送り状：コンパクト

配送実績反映

SCシステムから出荷実績情報をネクストエンジンへ反映します。

1. 反映内容

• 伝票に受注分類タグ [STOCKCREW出荷済み] が登録されます。

• 伝票のステータスが [出荷済み] へ移動します。
• 伝票に発送伝票が反映されます。

伝票の発送方法が、実際に出荷した配送方法へ更新されます（対象の配送方法のみ。詳細は「3. 発送方法の更新について」をご確認ください）

2. 連携間隔

• 約15分に1回、出荷実績を自動的に連携

3. 発送方法の更新について

SCシステム側で配送方法が自動変更された場合、出荷実績の連携時に、ネクストエンジンの伝票の発送方法も実際に出荷した配送方法へ更新されます。送り状番号のみの連携ではありません。

発送方法と送り状番号を更新したうえで出荷確定が行われるため、ネクストエンジン側で発送方法に応じた発送連絡メールのテンプレート判定が可能です。

4. 発送方法の更新対象

以下の配送方法へ自動変更された場合が、発送方法の更新対象です。

• ヤマト運輸（宅急便・ネコポス）
• 佐川急便

代金引換の場合も、対応する発送方法へ変換されて更新されます。

在庫連携

SCシステムから在庫情報をネクストエンジンへ反映します。

1. 連携条件

• SCシステムの商品対応表が登録されている商品

• 前回在庫更新以降、在庫数が変更された商品
• 初回連携の商品
• ネクストエンジンの在庫数と差異がある商品

2. 連携内容

• STOCKCREWの 総在庫数 が連携されます。

3. 連携間隔

• 約20分に1回、在庫情報を自動的に連携

4. 連携方法

• 商品対応表を登録する：CSVインポートをご確認ください。
• API連携設定で在庫連携先を指定する：在庫連携先の拠点設定をご確認ください。

5. 注意点

• ネクストエンジン側の商品分類タグは関係しません。SCシステムで商品対応表の登録及び在庫連携がONになっている商品が在庫連携されます。
• 在庫数は総在庫数が連携されます。(ネクストエンジン側でフリー在庫＝在庫数-引当数のため)

よくあるエラーについて