ネクストエンジン API 開発者フォーラム: 受注伝票有効化
ネクストエンジン API のネクストエンジンAPIについてに関する開発者フォーラムの質問と回答。クライアントアプリ・ストア連携・エンジン利用についてのQ&A。
投稿者: 匿名ユーザー 日時: 2020/03/18
カテゴリ: ネクストエンジンAPIについて
ネクストエンジンAPIを使って、こちらのURLの「受注伝票有効化」にあたる処理を行いたい（ [新規受付]ステータスの受注伝票を[確認待ち]以降に変更したい）のですが、
受注伝票一括更新のAPIを使って試したところ、受注状態がメール取込済（新規受付）のものは更新できないとのエラーが出力されました。
https://manual.next-engine.net/main/orders/ord_torikomi-shori/juchu_tori…
エラー内容
code: ‘020009’,
message: ‘[receive_order_order_status_id]は受注状態がメール取込済のため更新できません
APIを使って「受注伝票有効化」にあたる処理を行うことはできない仕様なのでしょうか？
回答 (8件)
Section titled “回答 (8件)”運営 — 2020/03/19
Section titled “運営 — 2020/03/19”受注伝票の有効化と同等にあたる処理につきましては、
下記の流れで実現可能でございます。
1.受注伝票の検索により受注状態区分が「1.受注メール取込済」であるもののみを取得する
エンドポイント：/api_v1_receiveorder_base/search
2.1で取得した受注伝票の情報をもとに取込用CSVファイルを作成し、受注伝票アップロードを行う
エンドポイント：/api_v1_receiveorder_base/upload
※CSVファイルの作成の際は、メイン機能で各店舗ごとに設定した
受注一括登録パターンで作成を行う必要がございます
下記エンドポイントより受注一括登録パターンIDを取得できます
エンドポイント：/api_v1_receiveorder_uploadpattern/info
3.アップロード後、伝票の状態によって確認待ち～印刷待ちのいずれかに遷移します
匿名ユーザー（質問者） — 2020/03/19
Section titled “匿名ユーザー（質問者） — 2020/03/19”ご回答ありがとうございます！
＞ ※CSVファイルの作成の際は、メイン機能で各店舗ごとに設定した
＞ 受注一括登録パターンで作成を行う必要がございます
＞ 下記エンドポイントより受注一括登録パターンIDを取得できます
＞ エンドポイント：/api_v1_receiveorder_uploadpattern/info
この部分について再度質問させてください。
弊社には複数の店舗があるのですが（Makeshop, Amazonなど）、その全てを一括で更新したい場合、
受注一括登録フォーマットパターンとして90：汎用標準パターンを使用し、
こちら（https://manual.next-engine.net/main/orders/ord_torikomi-shori/juchu_tori…）の
フォーマットに沿ったCSVを作成することで実現できるものと考えましたが、正しいでしょうか？
運営 — 2020/03/19
Section titled “運営 — 2020/03/19”アップロード時には受注一括登録パターンIDを指定しますが、
各パターンIDには下記のとおり店舗IDが含まれているため、
1店舗ごとのアップロード処理が必要となります。
https://developer.next-engine.com/guides/fields/receiveorder_receive_order_…
そのためたとえ同じパターンを設定されていても、
複数の店舗に対して一括で受注CSVファイルをアップロードすることはできかねます。
匿名ユーザー（質問者） — 2020/03/19
Section titled “匿名ユーザー（質問者） — 2020/03/19”ありがとうございました。よくわかりました。
たびたび申し訳ありませんが、APIによるアップロードの仕様について質問させてください。
https://manual.next-engine.net/main/orders/ord_torikomi-shori/juchu_tori…
こちらのページに以下のガイドがございました。
＞受注CSVファイルを取り込むと、[新規受付]ステータスの受注伝票は[確認待ち]ステータス以降に移動します。
＞受注メール取込を利用していない場合は、受注CSVファイルを取り込むと同時に[確認待ち]ステータス以降に受注伝票が作成されます。
①作成済みの新規受付ステータスの受注伝票にすでにある項目が、アップロード時のCSVにはなかった場合
（たとえば「受注名カナ」が作成済みの受注伝票には登録されているが、CSVでは列を省略した場合）、
対象項目は据え置きとなるという理解で正しいでしょうか？ それとも削除されてしまうのでしょうか？
②新規受付ステータスの受注伝票にすでに商品の受注明細が登録されていた場合、
アップロード時のCSVに指定された商品情報との関係はどうなるのでしょうか？
・明細が追加される
・同じ商品コード（？）であれば上書きする
・無視されて登録済みの明細情報が維持される など・・
また、もし「明細が追加される」である場合、明細を追加せずにアップロードすることは可能でしょうか？
前述のURLのガイドでは商品名などが必須項目となっていたため、
「取得した受注伝票の情報をもとに取込用CSVファイルを作成し、受注伝票アップロードを行う」とすると
ステータスを更新するだけでなく明細情報が重複してしまうのではないかと危惧しています。
匿名ユーザー（質問者） — 2020/03/24
Section titled “匿名ユーザー（質問者） — 2020/03/24”こちらの件、直近の質問だけお答えいただけていないので、お願いできませんでしょうか。
お忙しいようでしたら②だけで大丈夫です。
自分でテスト環境で実験して試せればよいのですが、手動で伝票新規作成を行うと、
はじめからステータスが「確認待ち」等（受注状態：２）になってしまうため、実験ができない状態です。
（私の理解が浅く、代替のやり方があるのかもしれませんが。）
なにとぞよろしくお願い申し上げます。
運営 — 2020/03/25
Section titled “運営 — 2020/03/25”＞①作成済みの新規受付ステータスの受注伝票にすでにある項目が、アップロード時のCSVにはなかった場合
＞ （たとえば「受注名カナ」が作成済みの受注伝票には登録されているが、CSVでは列を省略した場合）、
＞ 対象項目は据え置きとなるという理解で正しいでしょうか？ それとも削除されてしまうのでしょうか？
列を省略した場合、登録済のデータは変更されず据え置きとなります。
＞②新規受付ステータスの受注伝票にすでに商品の受注明細が登録されていた場合、
＞ アップロード時のCSVに指定された商品情報との関係はどうなるのでしょうか？
同一店舗の同一店舗伝票番号で、受注メール取込時とCSV作成時で
受注明細の内容が異なる場合があるということでしょうか。
（原則、受注メールとCSVの内容は一致しているかと存じます）
https://manual.next-engine.net/main/stock/stk_settei-unyou/zaiko_hanyo/4…
上記を参照のうえ、受注メールをメイン機能に取り込んでいただくと
新規作成された受注伝票は「新規受付」ステータスに入りますので、
挙動をご確認いただけるかと存じます。
匿名ユーザー（質問者） — 2020/03/25
Section titled “匿名ユーザー（質問者） — 2020/03/25”ご回答ありがとうございます。
＞ 同一店舗の同一店舗伝票番号で、受注メール取込時とCSV作成時で
＞ 受注明細の内容が異なる場合があるということでしょうか。
いえ、そうではありません。
「（新規受付）伝票A 明細A-1, A-2」に対して「伝票A 明細A-1, A-2」と同じ内容のデータをCSVで上書きしたときに、
「伝票A 明細A-1, A-2, A-1, A-2」と明細がだぶってしまうことにならないか？を心配していました。
ご回答のトーンから推測すると、
「A-1, A-2がそれぞれ上書きされて、A-1とA-2はキーも中身も同じなので結果としては変わらない」ということでしょうか。
（であれば嬉しいのですが。）
運営 — 2020/03/25
Section titled “運営 — 2020/03/25”はい、重複して登録されることはございません。