受注伝票検索
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'access_token=xxx&refresh_token=xxx&wait_flag=1&fields=receive_order_shop_id, receive_order_id, receive_order_cancel_date&receive_order_shop_id-eq=xxx' https://api.next-engine.org/api_v1_receiveorder_base/search// POST /api_v1_receiveorder_base/search - 受注伝票検索const params = new URLSearchParams({ access_token: '<access_token>', fields: 'field1,field2', offset: '0', limit: '50', // extension_execution_id: '...', // optional})const res = await fetch('https://api.next-engine.org/api_v1_receiveorder_base/search', { method: 'POST', headers: { 'content-type': 'application/x-www-form-urlencoded' }, body: params,})const json = await res.json()if (json.result !== 'success') throw new Error(json.message ?? json.code)console.log(json.data)# POST /api_v1_receiveorder_base/search - 受注伝票検索import requests
params = { 'access_token': '<access_token>', 'fields': 'field1,field2', 'offset': '0', 'limit': '50', # 'extension_execution_id': '...', # optional}res = requests.post( 'https://api.next-engine.org/api_v1_receiveorder_base/search', data=params,)json = res.json()if json['result'] != 'success': raise RuntimeError(json.get('message') or json.get('code'))print(json.get('data'))Request Body required
Section titled “Request Body required ”object
OAuth2 アクセストークン (必須)
OAuth2 リフレッシュトークン (access_token 期限切れ時の自動更新に使用)
同期実行フラグ。“1” 指定で処理完了を待つ
取得するフィールドをカンマ区切りで指定 (search 系のみ)
検索開始位置 (search 系のみ)
取得件数 (search 系のみ)
拡張機能実行ID / 検索結果画面で実行対象として選択したデータをひとかたまりとして取得することができます。 フィールド名-比較演算子(WHERE句のカラムと比較演算子相当)と同時に指定した場合はAND検索となります。
Responses
Section titled “ Responses ”実行結果 (result が success / error / redirect のいずれか)
object
実行結果ステータス
エラー時のエラーコード
object
更新後のアクセストークン
アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)
更新後のリフレッシュトークン
リフレッシュトークン有効期限
エンドポイント固有のレスポンスデータ
Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)
object
店舗コード / 数値型 / 店舗マスタの店舗コード
伝票番号 / 数値型 / ネクストエンジン内で一意に付与される番号
受注番号 / 文字列型 / 原則、店舗内で一意に付与される番号(重複する可能性あり。)
受注日 / 日時型 / 店舗側で受注した日
取込日 / 日時型 / ネクストエンジンに取り込まれた日
重要チェック区分 / 文字列型 / 1:重要
重要チェック名 / 文字列型 / 重要チェックを付けた担当者名
確認チェック区分 / 文字列型 / 0:確認不要1:確認必要2:確認済み
確認チェック名 / 文字列型 / 確認チェックを付けた担当者名
受注確認内容ID / 文字列型 / 受注確認内容IDが”:“区切りで設定されます。明細行に対する確認は”#“の後に明細行番号が設定されます。Ex: “AO:AA#1:AA#2”の場合送り先の郵便番号と住所があってません。商品コードが商品マスタに存在しません。:1行目商品コードが商品マスタに存在しません。:2行目
メール送信状態値 / 文字列型 / 次の値によりどの種類のメール送信が終了したかを表します。区切り文字はありません。例えばJHとあれば受注メールと発送完了メールが送信済みです。 J:受注確認メール B:印刷日待ち連絡メール C:印刷待ち以降連絡メール H:発送メール N:入金確認メール F:フォローメール
受注分類タグ / 文字列型 / []区切りでタグの名称が設定されている。受注分類タグ自体の検索には未対応。例:[連絡待ち][ゴールド会員]
取込種類区分 / 文字列型 / 0:メール1:CSV2:手入力
取込種類名 / 文字列型
受注キャンセル区分 / 文字列型 / 受注キャンセル区分
受注キャンセル名 / 文字列型
受注キャンセル日 / 日時型
受注状態区分 / 文字列型 / 受注状態区分
受注状態名 / 文字列型
発送方法区分 / 文字列型 / 発送方法区分
発送方法名 / 文字列型
支払区分 / 文字列型 / 支払区分受注伝票の支払方法の値
支払名 / 文字列型
総合計 / 数値型 / 商品計+税金+手数料+発送代+他費用-ポイント数
税金 / 数値型
手数料 / 数値型
発送代 / 数値型
他費用 / 数値型
ポイント数 / 数値型
商品計 / 数値型
入金額 / 文字列型
入金状況区分 / 文字列型 / 入金区分
入金状況名 / 文字列型
入金日 / 日時型
備考 / 文字列型
同梱候補伝票番号 / 数値型 / ネクストエンジンが自動判定した同梱候補の伝票番号
同梱先伝票番号 / 数値型 / 同梱した場合の同梱先の伝票番号
複数配送親伝票番号 / 数値型 / 複数配送の親の伝票番号
分割元伝票番号 / 数値型 / 分割元の伝票番号
複写元伝票番号 / 数値型 / 複写元の伝票番号
複数配送親フラグ / 文字列型 / 複数配送の親か否か
納品書印刷指示日 / 日時型
納品書発行日 / 日時型 / 納品書をダウンロードした日
納品書特記事項 / 文字列型
出荷確定日 / 日時型 / 受注状態が出荷確定済みになった日
出荷予定日 / 日時型
出荷順序 / 文字列型 / ラベル発行フラグがたった順序
作業用欄 / 文字列型
ピッキング指示内容 / 文字列型
ラベル発行日 / 日時型
ラベル発行フラグ / 文字列型 / 配送伝票の印刷対象か否か0:対象外1:対象2:発行済み
配達希望日 / 日時型
配達希望時間帯区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
配達希望時間帯名 / 文字列型
便種区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
便種名 / 文字列型
シール1区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
シール1名 / 文字列型
シール2区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
シール2名 / 文字列型
シール3区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
シール3名 / 文字列型
シール4区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
シール4名 / 文字列型
営業止め区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
営業止め名 / 文字列型
送り状区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
送り状名 / 文字列型
温度区分 / 文字列型 / 指定の発送方法の伝票印字ソフト用の値が設定されます。
温度名 / 文字列型
営業所名 / 文字列型
ギフトフラグ / 文字列型 / 0:ギフトではない1:ギフト
置き配フラグ / 文字列型 / 0:置き配指定なし 1:置き配指定あり
置き配場所名称 / 文字列型 / 例:宅配ボックス、玄関前、メータボックス
発送伝票番号 / 文字列型 / 各発送方法の問い合わせ番号が設定されます。
発送伝票備考欄 / 文字列型
クレジット区分 / 文字列型 / クレジット種類区分
クレジット名 / 文字列型
クレジット承認番号 / 文字列型
クレジット承認額 / 文字列型
クレジット承認区分 / 文字列型 / クレジット承認区分
クレジット承認名 / 文字列型
クレジット承認日 / 日時型
クレジット承認時レート / 数値型
クレジット支払い回数 / 文字列型 / 受注伝票の支払区分の値
クレジット承認センター区分 / 文字列型
クレジット承認センター名 / 文字列型
クレジット承認FAX印刷日 / 日時型
顧客区分 / 文字列型 / 顧客区分
顧客名 / 文字列型
顧客コード / 文字列型 / 顧客区分が9:卸 だった場合に卸先コードが設定されます。
購入者名 / 文字列型
購入者カナ / 文字列型
購入者郵便番号 / 文字列型
購入者住所1 / 文字列型
購入者住所2 / 文字列型
購入者電話番号 / 文字列型
購入者FAX / 文字列型
購入者メールアドレス / 文字列型
送り先名 / 文字列型
送り先カナ / 文字列型
送り先郵便番号 / 文字列型
送り先住所1 / 文字列型
送り先住所2 / 文字列型
送り先電話番号 / 文字列型
送り先FAX / 文字列型
重要チェック担当者ID / 数値型
重要チェック担当者名 / 文字列型
受注担当者ID / 数値型
受注担当者名 / 文字列型
出荷担当者ID / 数値型
出荷担当者名 / 文字列型
作成日 / 日時型
最終更新日 / 日時型
最終更新日 / 日時型 / NULLの場合作成日
作成担当者ID / 数値型
作成担当者名 / 文字列型
最終更新者ID / 数値型
最終更新者ID / 数値型 / NULLの場合作成者ID
最終更新者名 / 文字列型
最終更新者名 / 文字列型 / NULLの場合作成者名
Example
{ "result": "success", "count": "14", "data": [ { "receive_order_shop_id": "1", "receive_order_id": "1", "receive_order_shop_cut_form_id": "12345-6789", "receive_order_date": "2014-05-01 00:00:00", "receive_order_import_date": "2017-01-19 12:55:37", "receive_order_important_check_id": "0", "receive_order_important_check_name": "", "receive_order_confirm_check_id": "1", "receive_order_confirm_check_name": "確認必要(表示)", "receive_order_confirm_ids": "AA:AA#232:AA", "receive_order_gruoping_tag": null, "receive_order_import_type_id": "1", "receive_order_import_type_name": "CSV", "receive_order_cancel_type_id": "1", "receive_order_cancel_type_name": "顧客依頼によりキャンセル", "receive_order_cancel_date": "0000-00-00 00:00:00", "receive_order_order_status_id": "2", "receive_order_order_status_name": "起票済(CSV/手入力)", "receive_order_delivery_id": "10", "receive_order_delivery_name": "佐川急便(e飛伝PRO)", "receive_order_payment_method_id": "15", "receive_order_payment_method_name": "銀行振込前払い", "receive_order_total_amount": "2300.00", "receive_order_tax_amount": "0.00", "receive_order_charge_amount": "0.00", "receive_order_delivery_fee_amount": "300.00", "receive_order_other_amount": "0.00", "receive_order_point_amount": "0.00", "receive_order_goods_amount": "2000.00", "receive_order_deposit_amount": "0.00", "receive_order_deposit_type_id": "0", "receive_order_deposit_type_name": "未入金", "receive_order_deposit_date": null, "receive_order_note": "ok\n▼伝票2より▼\n先に頼んだものと一緒に発送お願いします。", "receive_order_include_possible_order_id": "0", "receive_order_include_to_order_id": "3", "receive_order_multi_delivery_parent_order_id": null, "receive_order_divide_from_order_id": null, "receive_order_copy_from_order_id": null, "receive_order_multi_delivery_parent_flag": "0", "receive_order_statement_delivery_instruct_printing_date": "0000-00-00 00:00:00", "receive_order_statement_delivery_printing_date": null, "receive_order_statement_delivery_text": null, "receive_order_send_date": null, "receive_order_send_plan_date": null, "receive_order_send_sequence": null, "receive_order_worker_text": null, "receive_order_picking_instruct": null, "receive_order_label_print_date": null, "receive_order_label_print_flag": "0", "receive_order_hope_delivery_date": null, "receive_order_hope_delivery_time_slot_id": null, "receive_order_hope_delivery_time_slot_name": null, "receive_order_delivery_method_id": "000", "receive_order_delivery_method_name": null, "receive_order_seal1_id": null, "receive_order_seal1_name": null, "receive_order_seal2_id": null, "receive_order_seal2_name": null, "receive_order_seal3_id": null, "receive_order_seal3_name": null, "receive_order_seal4_id": null, "receive_order_seal4_name": null, "receive_order_business_office_stop_id": null, "receive_order_business_office_stop_name": null, "receive_order_invoice_id": null, "receive_order_invoice_name": null, "receive_order_temperature_id": null, "receive_order_temperature_name": null, "receive_order_business_office_name": null, "receive_order_gift_flag": "0", "receive_order_delivery_cut_form_id": null, "receive_order_delivery_cut_form_note": null, "receive_order_credit_type_id": "0", "receive_order_credit_type_name": "なし", "receive_order_credit_approval_no": null, "receive_order_credit_approval_amount": "0.00", "receive_order_credit_approval_type_id": "0", "receive_order_credit_approval_type_name": "必要なし", "receive_order_credit_approval_date": null, "receive_order_credit_approval_rate": "0.00", "receive_order_credit_number_payments": null, "receive_order_credit_authorization_center_id": null, "receive_order_credit_authorization_center_name": null, "receive_order_credit_approval_fax_printing_date": null, "receive_order_customer_type_id": "0", "receive_order_customer_type_name": "一般顧客", "receive_order_customer_id": null, "receive_order_purchaser_name": "テスト 太郎", "receive_order_purchaser_kana": "テスト タロウ", "receive_order_purchaser_zip_code": "2500111", "receive_order_purchaser_address1": "神奈川県 小田原市", "receive_order_purchaser_address2": "栄町2-9-39 小田原EPO", "receive_order_purchaser_tel": "0311112222", "receive_order_purchaser_fax": null, "receive_order_purchaser_mail_address": "test@example.com", "receive_order_consignee_name": "テスト 太郎", "receive_order_consignee_kana": "テスト タロウ", "receive_order_consignee_zip_code": "0111111", "receive_order_consignee_address1": "神奈川県 小田原市", "receive_order_consignee_address2": "栄町2-9-39 小田原EPO", "receive_order_consignee_tel": "0311112222", "receive_order_consignee_fax": null, "receive_order_reminder_start_date": null, "receive_order_reminder_last_date": null, "receive_order_reminder_count": "0", "receive_order_important_check_pic_id": null, "receive_order_important_check_pic_name": null, "receive_order_pic_id": "10002", "receive_order_pic_name": "xxxxxxxx", "receive_order_send_pic_id": null, "receive_order_send_pic_name": null, "receive_order_deleted_flag": "0", "receive_order_creation_date": "2017-01-19 12:55:37", "receive_order_last_modified_date": "2017-03-22 16:19:16", "receive_order_last_modified_null_safe_date": "2017-03-22 16:19:16", "receive_order_creator_id": "10002", "receive_order_creator_name": "xxxxxxx", "receive_order_last_modified_by_id": "9999", "receive_order_last_modified_by_null_safe_id": "9999", "receive_order_last_modified_by_name": "管理者", "receive_order_last_modified_by_null_safe_name": "管理者" }, { "receive_order_shop_id": "1", "receive_order_id": "2", "receive_order_shop_cut_form_id": "RAKUTEN-123TEST", "receive_order_date": "2014-02-06 03:09:00", "receive_order_import_date": "2017-01-19 12:55:38", "receive_order_important_check_id": "0", "receive_order_important_check_name": "", "receive_order_confirm_check_id": "1", "receive_order_confirm_check_name": "確認必要(表示)", "receive_order_confirm_ids": "AG:AO:CT:AA#1:AA#2", "receive_order_gruoping_tag": null, "receive_order_import_type_id": "1", "receive_order_import_type_name": "CSV", "receive_order_cancel_type_id": "3", "receive_order_cancel_type_name": "他の伝票への統合の為キャンセル", "receive_order_cancel_date": "2017-02-09 18:26:03", "receive_order_order_status_id": "2", "receive_order_order_status_name": "起票済(CSV/手入力)", "receive_order_delivery_id": "10", "receive_order_delivery_name": "佐川急便(e飛伝PRO)", "receive_order_payment_method_id": "15", "receive_order_payment_method_name": "銀行振込前払い", "receive_order_total_amount": "3180.00", "receive_order_tax_amount": "0.00", "receive_order_charge_amount": "0.00", "receive_order_delivery_fee_amount": "0.00", "receive_order_other_amount": "0.00", "receive_order_point_amount": "0.00", "receive_order_goods_amount": "3180.00", "receive_order_deposit_amount": "0.00", "receive_order_deposit_type_id": "0", "receive_order_deposit_type_name": "未入金", "receive_order_deposit_date": null, "receive_order_note": "先に頼んだものと一緒に発送お願いします。", "receive_order_include_possible_order_id": "1", "receive_order_include_to_order_id": "1", "receive_order_multi_delivery_parent_order_id": null, "receive_order_divide_from_order_id": null, "receive_order_copy_from_order_id": null, "receive_order_multi_delivery_parent_flag": "0", "receive_order_statement_delivery_instruct_printing_date": "0000-00-00 00:00:00", "receive_order_statement_delivery_printing_date": null, "receive_order_statement_delivery_text": null, "receive_order_send_date": null, "receive_order_send_plan_date": null, "receive_order_send_sequence": null, "receive_order_worker_text": null, "receive_order_picking_instruct": null, "receive_order_label_print_date": null, "receive_order_label_print_flag": "0", "receive_order_hope_delivery_date": null, "receive_order_hope_delivery_time_slot_id": null, "receive_order_hope_delivery_time_slot_name": null, "receive_order_delivery_method_id": "000", "receive_order_delivery_method_name": null, "receive_order_seal1_id": null, "receive_order_seal1_name": null, "receive_order_seal2_id": null, "receive_order_seal2_name": null, "receive_order_seal3_id": null, "receive_order_seal3_name": null, "receive_order_seal4_id": null, "receive_order_seal4_name": null, "receive_order_business_office_stop_id": null, "receive_order_business_office_stop_name": null, "receive_order_invoice_id": null, "receive_order_invoice_name": null, "receive_order_temperature_id": " ", "receive_order_temperature_name": null, "receive_order_business_office_name": null, "receive_order_gift_flag": "0", "receive_order_delivery_cut_form_id": null, "receive_order_delivery_cut_form_note": null, "receive_order_credit_type_id": "0", "receive_order_credit_type_name": "なし", "receive_order_credit_approval_no": null, "receive_order_credit_approval_amount": "0.00", "receive_order_credit_approval_type_id": "0", "receive_order_credit_approval_type_name": "必要なし", "receive_order_credit_approval_date": null, "receive_order_credit_approval_rate": "0.00", "receive_order_credit_number_payments": null, "receive_order_credit_authorization_center_id": null, "receive_order_credit_authorization_center_name": null, "receive_order_credit_approval_fax_printing_date": null, "receive_order_customer_type_id": "0", "receive_order_customer_type_name": "一般顧客", "receive_order_customer_id": null, "receive_order_purchaser_name": "テスト 太郎", "receive_order_purchaser_kana": "テスト タロウ", "receive_order_purchaser_zip_code": "2500111", "receive_order_purchaser_address1": "神奈川県 小田原市", "receive_order_purchaser_address2": "栄町2-9-39 小田原EPO", "receive_order_purchaser_tel": "0311112222", "receive_order_purchaser_fax": null, "receive_order_purchaser_mail_address": "test@example.com", "receive_order_consignee_name": "テスト 太郎", "receive_order_consignee_kana": "テスト タロウ", "receive_order_consignee_zip_code": "0111111", "receive_order_consignee_address1": "神奈川県 小田原市", "receive_order_consignee_address2": "栄町2-9-39 小田原EPO", "receive_order_consignee_tel": "0311112222", "receive_order_consignee_fax": null, "receive_order_reminder_start_date": null, "receive_order_reminder_last_date": null, "receive_order_reminder_count": "0", "receive_order_important_check_pic_id": null, "receive_order_important_check_pic_name": null, "receive_order_pic_id": "10002", "receive_order_pic_name": "xxxxxxx", "receive_order_send_pic_id": null, "receive_order_send_pic_name": null, "receive_order_deleted_flag": "0", "receive_order_creation_date": "2017-01-19 12:55:38", "receive_order_last_modified_date": "2017-02-09 18:26:03", "receive_order_last_modified_null_safe_date": "2017-02-09 18:26:03", "receive_order_creator_id": "10002", "receive_order_creator_name": "xxxxxxx", "receive_order_last_modified_by_id": "10003", "receive_order_last_modified_by_null_safe_id": "10003", "receive_order_last_modified_by_name": "xxxxxxxx", "receive_order_last_modified_by_null_safe_name": "xxxxxxx" } ], "access_token": "xxxxxxxxxx", "access_token_end_date": "2017-04-13 18:24:53", "refresh_token": "xxxxxxxxxx", "refresh_token_end_date": "2017-04-15 18:24:53"}クライアントエラー (HTTP ステータス自体は 200 + result=error で返ることが多い)
object
実行結果ステータス
エラー時のエラーコード
object
更新後のアクセストークン
アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)
更新後のリフレッシュトークン
リフレッシュトークン有効期限
エンドポイント固有のレスポンスデータ
Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)
Example
{ "result": "success"}