ネクストエンジン API 開発者フォーラム: 商品マスタへの商品一括登録にてアイテム数の制限はありますか？

ネクストエンジン API のネクストエンジンAPIについてに関する開発者フォーラムの質問と回答。クライアントアプリ・ストア連携・エンジン利用についてのQ&A。

投稿者: 匿名ユーザー　日時: 2021/01/20

カテゴリ: ネクストエンジンAPIについて

お世話になっております。

テスト店舗にて在庫連携と商品マスタへの登録を書きテストさせていただきました。

その結果、250件の登録はできたのですが送信したデータが1000件を超えるものであったため、原因分析をしたいと思っています。

下記3点教えてください。

テスト店舗での制限、一括登録の上限などございますでしょうか。
キューのエラー確認などはどこで行えばよかったでしょうか。
マイナスに振れる在庫加算数の時、在庫数の更新はどのように扱われますか。

　※ 在庫数10に対して zaiko_su = -30 で更新したときなど

よろしくお願いいたします。

回答 (7件)

運営 — 2021/01/20

1.sandbox環境において、制限などは特にございません。

　登録データの内容に問題がないかご確認ください。

2.登録結果につきましては、下記エンドポイントより

　キューの検索を実行することが可能です。

　・アップロードキュー検索

　　https://developer.next-engine.com/api/api_v1_system_que/search

　なお、メイン機能内、下記メニューからも商品一括登録の状態を確認することが可能です。

　該当メニュー：

　（β版）商品管理の一括登録（商品マスタ一括登録も同様）

　- ページ最下部「商品一括登録の状態・履歴」

3.在庫数は「0」となります。

匿名ユーザー（質問者） — 2021/01/20

お世話になっております。

回答ありがとうございました。

すみません、追加で2点ほど教えてください。

アップロードキュー検索では『メッセージ』にて登録が止まったsyohin_codeなどの情報は提供されますでしょうか。
商品登録時に在庫数がマイナス値（例：zaiko_su = -1600）の場合、エラーとなりますか。

4について

（β版）商品管理の一括登録「商品一括登録の状態・履歴」を確認したところ、登録が止まったレコードについての情報がありませんでした。

アップロードキュー検索では『取り込みが止まった場所』を探すことができると考えてよかったですか。

5について

登録されたレコード以外を抽出したところ、最初の値（止まった原因と思われるレコード）の在庫数が【-1069】となっていました。

弊社の社内システムに予約販売が組み込まれているためこのような数値となっています。

これが登録が止まる原因であれば修正したいと思いますので教えてください。

よろしくお願いいたします。

運営 — 2021/01/20

例として下記のようなメッセージが表示されますので、

商品コードの特定は可能です。

===========================================

[3]件取り込みましたが、以下をご確認ください。

商品マスタCSVの[2]行目：フリー在庫数が0個のため、

出庫されませんでした。(商品コード:XXXX)

===========================================

しかしながら、商品コードの明記の有無はエラー内容により

異なります。

たとえば、仕入先コードに未登録のものが指定されていた場合は

下記のようなメッセージが表示されます。

===========================================

117行目

仕入先コードは登録済のものを入力してください

===========================================

新規登録時にマイナスの値を設定して登録を行った場合、

在庫数は「0」で登録されます。

そのため、今回の処理が止まった原因は他にあるかと思われますので

CSVの内容など改めてご確認いただければと存じます。

匿名ユーザー（質問者） — 2021/01/21

お世話になっております。

回答ありがとうございました。

その後いろいろとテストしてみた結果、エラーとなっているレコードの特定が出来ました。

以下1点教えてください。

商品名に文字【&】が入っている事が原因でした。その他【&】以外にシステム内で読み込まれない可能性のある文字はありますか

6について

止まったと推定したレコードを記載します。

===========================================

syohin_code,sire_code,jan_code,kataban,syohin_name,genka_tnk,hyoji_tnk,baika_tnk,zaiko_su

20033,9999,4980511620033,20033,“GGジンジャーグレーター&マドラーホワイト”,180,0,200,72

===========================================

※この中の＆をスペースに変更したところ、下記エラーは発生せず取り込みが出来ました。

▼上記レコードをシングルでPOSTした結果（アップロードキュー検索より抽出）

[2021-01-21 11:54:16] production.INFO: array (

‘result’ => ‘error’,

‘code’ => ‘006005’,

‘message’ => ‘データが1件も存在しません’,

‘access_token’ => （以下略）

▼投げたパラメータ

access_token=—&refresh_token=—&wait_flag=1&data_type=csv&data=syohin_code,sire_code,jan_code,kataban,syohin_name,genka_tnk,hyoji_tnk,baika_tnk,zaiko_su

20033,9999,4980511620033,20033,“GGジンジャーグレーター&マドラーホワイト”,180,0,200,72

よろしくお願いいたします。

運営 — 2021/01/21

メイン機能にて使用不可と定義している文字は以下ページに記載がございます。

　・本システムの使用不可文字：

　　https://manual.next-engine.net/main/starter/str_overview/kiso_kyoutsuu/8…

今回のエラーの起因である「&」につきましては、上記ページでは定義しておりませんが、

画面からの操作とAPIリクエストによる差異でございます。

メイン機能からの操作では「&」が商品名などに含まれていることは問題ないものの、

APIリクエスト文に含まれている場合、パラメータを繋ぐ文字列との関連によりエラーが

発生する可能性がございます。

匿名ユーザー（質問者） — 2021/01/21

お世話になっております。

回答ありがとうございます、確認させていただきました。

リンク先の文字については既にエスケイプ処理しているので、これ以外にないと言う事であれば問題なさそうです。

ありがとうございます。

ちなみに、今回行ったアップロード実験の結果【＆】については全角/半角ともにダメでした。

※ダブルクォーテーションで囲っても同じ結果。

その他、思いつく限りのエスケイプ処理をやってみたのですが、こちらもすべてダメでした。

別の文字への置換で対応したいと思います。

情報提供ありがとうございました。

■追加

商品コードに【_｜アンダーバー】が入っているとキューにスローされた後の登録工程でエラーが発生する用です。

このエラーはキューに入ってからなので【商品コードは半角英数,ハイフンで入力してください】とメッセージをもらえました。

【_】は画面上からの登録できたのですが、登録できる方がイレギュラーと考えてよかったでしょうか。

運営 — 2021/01/28

アンダーバーの取り扱いにつきましては、ご認識のとおりでございます。