ネクストエンジン API 開発者フォーラム: 受注伝票検索APIについて

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

投稿者: 匿名ユーザー　日時: 2018/02/06

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

お世話になります。サポートに問い合わせたところ、こちらで問い合わせてくださいとのことでしたので質問させていただきます。

受注伝票検索API（エンドポイント：/api_v1_receiveorder_base/search）につきまして、次の点をご教授願えませんでしょうか？

①「受注確認内容ID（receive_order_confirm_ids）」とは、「確認チェック区分（receive_order_confirm_check_id）」が「1:確認必要」だった際に設定されるものという理解で合っていますでしょうか？

②以下の各区分の具体的な区分値とその意味を事前に知りたいのですが、御社サイトのどこを参照すればわかりますでしょうか？

(a) 「受注確認内容ID（receive_order_confirm_ids）」

(b) 「受注キャンセル区分（receive_order_cancel_type_id）」

(d) 「発送方法区分（receive_order_delivery_id）」

(e) 「入金状況区分（receive_order_deposit_type_id）」

回答 (4件)

運営 — 2018/02/07

①「受注確認内容ID（receive_order_confirm_ids）」とは、「確認チェック区分（receive_order_confirm_check_id）」が「1:確認必要」だった際に設定されるものという理解で合っていますでしょうか？

受注確認内容IDはネクストエンジン本体の[設定]→[受注]→[受注確認内容]でチェックした条件で取り込まれた伝票に対して、設定されます。

条件に合った注確認内容IDが”:“区切りで設定されます。設定された場合、確認チェック区分が「1:確認必要」になります。その後伝票にチェックを行うと「2:確認済み」になります。

受注確認内容のについてはこちらをご覧ください

http://manual.ec-doc.net/operation/operation-tips/jyucyu-tips/a007/

②以下の各区分の具体的な区分値とその意味を事前に知りたいのですが、御社サイトのどこを参照すればわかりますでしょうか？

(a) 「受注確認内容ID（receive_order_confirm_ids）」

受注確認内容についてはこちらのページの確認内容一覧をご確認ください。

http://manual.ec-doc.net/operation/operation-tips/jyucyu-tips/a007/

IDと内容の一覧を確認するには受注確認内容検索(エンドポイント /api_v1_receiveorder_confirm/search) を実行してご確認ください。

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

(b) 「受注キャンセル区分（receive_order_cancel_type_id）」

ネクストエンジン本体の[設定]→[受注]→[受注確認内容]の受注キャンセルタブよりご確認ください

(c) 「受注状態区分（receive_order_order_status_id）」

以下のページのワンポイントアドバイスをご確認ください。

http://manual.ec-doc.net/operation/operation-tips/jyucyu-tips/b003/

(d) 「発送方法区分（receive_order_delivery_id）」

ネクストエンジン本体の[設定]→[受注]→[受注確認内容]の発送方法タブよりご確認ください

(e) 「入金状況区分（receive_order_deposit_type_id）」

以下の値になります

0:未入金 1:一部入金 2:入金済み

匿名ユーザー（質問者） — 2018/02/08

お忙しい中、詳細なご回答ありがとうございます。

(a) 「受注確認内容ID（receive_order_confirm_ids）」

受注確認内容についてはこちらのページの確認内容一覧をご確認ください。

http://manual.ec-doc.net/operation/operation-tips/jyucyu-tips/a007/

IDと内容の一覧を確認するには受注確認内容検索(エンドポイント /api_v1_receiveorder_confirm/search) を実行してご確認ください。

ご指示いただきましたページにはメッセージの一覧しかないと思うのですが、IDから内容を判断して後続処理を変えるというバッチ処理の実装を考えております。

メッセージの内容で識別することもできないことはないのですが、メッセージが1文字でも異なってしまうと正常に動作しなくなりますので、できましたらIDを知りたいと存じます。その際に、ご指示いただいたページの一覧表にあるすべてのメッセージの状態を意図的に作り出してIDを確認するというのは大変な作業になりますので、メッセージごとのIDをお持ちだと存じますので、それをお教えいただくことはできませんでしょうか？（上記ページに記載していただく形でもかまいません）

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

運営 — 2018/02/08

受注確認内容IDの値については、マニュアル等ではご用意していないのでお手数ですが、受注確認内容検索(エンドポイント /api_v1_receiveorder_confirm/search) を実行して、ご確認いただけるようお願い致します。

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

APIを実行するとIDとメッセージの一覧を取得する事が出来ます。

API実行例

　curl -X POST -H ‘content-type: application/x-www-form-urlencoded’

-d ‘access_token=アクセストークン&refresh_token=リフレッシュトークン&wait_flag=1&fields=項目名’

https://api.next-engine.org/api_v1_receiveorder_confirm/search

Response 例

{

“result”: “success”,

“count”: “1”,

“data”: [

{

“confirm_id”: “AA”,

“confirm_name”: “商品コードが商品マスタに存在しません。”,

“confirm_display_order”: “1”,

“confirm_html”: “商品コードが商品マスタに存在しない場合、確認内容に表示します。”,

“confirm_value”: null,

“confirm_valid_flag”: “0”,

“confirm_deleted_flag”: “0”,

“confirm_creation_date”: “2007-02-28 00:00:00”,

“confirm_last_modified_date”: “0000-00-00 00:00:00”,

“confirm_last_modified_null_safe_date”: “0000-00-00 00:00:00”,

“confirm_creator_id”: “9978”,

“confirm_creator_name”: null,

“confirm_last_modified_by_id”: “0”,

“confirm_last_modified_by_null_safe_id”: “0”,

“confirm_last_modified_by_name”: “System”,

“confirm_last_modified_by_null_safe_name”: “System”

}

“access_token”: “xxx”,

“access_token_end_date”: “2017-04-18 11:19:26”,

“refresh_token”: “xxx”,

“refresh_token_end_date”: “2017-04-20 11:19:26”

}

匿名ユーザー（質問者） — 2018/02/08

了解いたしました。詳細なご説明をいただきありがとうございました。