商品

ネクストエンジン API の「商品」に関するよくある質問です。

在庫更新エンドポイントはありますか？商品在庫数の更新方法を教えてください。

在庫更新は商品マスタアップロード (/api_v1_master_goods/upload)にて行うことができます。 商品在庫数は、実数ではなく加算数または減算数を設定します。

実数で更新したい場合は、一度現在の在庫数を取得し更新したい在庫数の差分で更新することになります。

ex. 現在の在庫数が「6」、更新したい在庫の実数が「4」、在庫数は「-2」で設定する

更新するCSVフィールド名は下記の通りです。

在庫数: zaiko_su

予約在庫数: yoyaku_zaiko_su

商品マスタアップロードエンドポイントで利用するdata(CSV)の仕様はネクストエンジン(メイン機能)のルールと同様になりますので、こちらをご参照ください。

商品ページ（β版）のAPI対応の予定はありますか？

商品ページ（β版）が正式版となりましたら、APIについても対応する予定です。

現時点でβ版終了日は未定となっております。

在庫マスタ検索(/api_v1_master_stock/search)エンドポイントにおいて、where句パラメータのIN句に記述できるデータの上限数はいくつになりますでしょうか？

上限は1000個になります。

商品マスタアップロード(/api_v1_master_goods/upload)エンドポイントにおいて、パラメータのCSV部分に改行区切りでセットできるレコード数に上限はありますでしょうか？

上限はございませんが、量が多くなる場合は、data_typeをgzにして、圧縮ファイルをアップロードするようにしてください。

データ量によってはアップロードエラーになる場合があります。

商品マスタアップロードエンドポイントに関して、メイン機能へのアップロードに失敗したがsuccessで返却される仕様について教えてください。

商品データアップロードエンドポイントのレスポンス内容はメイン機能の更新結果ではなく、ファイルアップロードが成功したか否かの結果になります。

メイン機能の更新処理の結果については、アップロードキュー検索API(エンドポイント /api_v1_system_que/search)を参照してください。

返品処理について教えてください。

商品マスタアップロードエンドポイント(/api_v1_master_goods/upload)を利用する事により返品処理を行う事ができます。

在庫数の加算/減算値(zaiko_su)で返品数を設定し、入出庫履歴の事由(nyusyukko_riyu)に返品理由を設定します。

エンドポイントについてはこちらをご覧ください。

商品マスタアップロード (/api_v1_master_goods/upload)

アップロード用のcsvファイルについてはこちらをご覧ください。

http://manual.ec-doc.net/operation/operation-tips/zaiko-tips/k003/

APIを利用して商品マスタに商品画像の登録はできますか？

商品画像のアップロード機能は提供していません。

「受注分類タグ」によりステータスを「確認待ち」に自動遷移させることは可能でしょうか。

「受注分類タグ」による自動遷移はできかねます。「商品分類タグ」をご使用ください。

在庫数を変更する際に、加算・減算ではなく実数による上書きは可能でしょうか。

在庫数の更新は加算または減算のみ可能です。実数で更新したい場合は、一度現在の在庫数を取得し、更新したい在庫数の差分で更新をしてください。

一般的にはAPIで更新後、手動で「対象」にチェックを入れてページ作成、アップロードを行うのでしょうか？

ご認識のとおりでございます。

APIでは、商品マスタは商品コードから参照できますが、セット商品マスタはセット商品コードから参照できないのでしょうか。

APIでセット商品を取得する方法はございません。