受注明細検索
curl -X POST -H 'content-type: application/x-www-form-urlencoded' \ -d 'access_token=xxx&refresh_token=xxx&wait_flag=1&fields=xxx&receive_order_row_receive_order_id-eq=1' \ https://api.next-engine.org/api_v1_receiveorder_row/search// POST /api_v1_receiveorder_row/search - 受注明細検索const params = new URLSearchParams({ access_token: '<access_token>', fields: 'field1,field2', offset: '0', limit: '50',})const res = await fetch('https://api.next-engine.org/api_v1_receiveorder_row/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_row/search - 受注明細検索import requests
params = { 'access_token': '<access_token>', 'fields': 'field1,field2', 'offset': '0', 'limit': '50',}res = requests.post( 'https://api.next-engine.org/api_v1_receiveorder_row/search', data=params,)json = res.json()if json['result'] != 'success': raise RuntimeError(json.get('message') or json.get('code'))print(json.get('data'))Request Bodyrequired
Section titled “Request Bodyrequired”object
OAuth2 アクセストークン (必須)
OAuth2 リフレッシュトークン (access_token 期限切れ時の自動更新に使用)
同期実行フラグ。“1” 指定で処理完了を待つ
取得するフィールドをカンマ区切りで指定 (search 系のみ)
検索開始位置 (search 系のみ)
取得件数 (search 系のみ)
Responses
Section titled “Responses”実行結果 (result が success / error / redirect のいずれか)
object
実行結果ステータス
エラー時のエラーコード
object
更新後のアクセストークン
アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)
更新後のリフレッシュトークン
リフレッシュトークン有効期限
エンドポイント固有のレスポンスデータ
Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)
object
伝票番号 / 数値型 / ネクストエンジン内で一意に付与される番号
受注番号 / 文字列型 / 原則、店舗内で一意に付与される番号(重複する可能性あり。)
明細行番号 / 数値型 / ネクストエンジンで付与した明細行番号
受注明細行番号 / 文字列型 / 店舗で付与された明細行番号
商品コード / 文字列型
商品名 / 文字列型
受注数 / 数値型
単価 / 数値型
受注時原価 / 数値型 / 受注時の商品マスタの原価。
消費税率(%) / 数値型
掛率 / 数値型
小計金額 / 数値型 / 単価*(掛率/10)*受注数
商品OP / 文字列型
キャンセルフラグ / 文字列型
同梱元伝票番号 / 数値型
同梱元明細行番号 / 数値型
複数配送親伝票番号 / 数値型
分割元明細行番号 / 数値型
複写元明細行番号 / 数値型
引当数 / 数値型
予約引当数 / 数値型
引当日 / 日時型
受注時取扱区分 / 文字列型 / 受注時の商品マスタの値が設定されます。
受注時取扱名 / 文字列型
受注時商品区分 / 文字列型 / 受注時の商品マスタの値が設定されます。
受注時商品名 / 文字列型
良品返品数 / 数値型
不良品返品数 / 数値型
返品事由区分 / 文字列型
返品事由名 / 文字列型
元受注明細行番号 / 数値型
削除フラグ / 文字列型 / 0:削除されていない 1:削除済み
作成日 / 日時型
最終更新日 / 日時型
最終更新日 / 日時型 / NULLの場合作成日
受注伝票・受注明細の最終更新日 / 日時型 / 受注伝票と受注明細の内、より新しい方の最終更新日
作成担当者ID / 数値型
作成担当者名 / 文字列型
最終更新者ID / 数値型
最終更新者ID / 数値型 / NULLの場合作成者ID
最終更新者名 / 文字列型
最終更新者名 / 文字列型 / NULLの場合作成者名
商品コード / 文字列型
代表商品コード / 文字列型
商品名 / 文字列型
英語商品名 / 文字列型
インボイス用品目名 / 文字列型 / 輸出時のインボイス(税関に出す書類)に印字する品目名
商品区分 / 文字列型
商品区分名 / 文字列型
取扱区分 / 文字列型
取扱区分名 / 文字列型
輸送方法指定 / 文字列型
輸送方法指定名 / 文字列型
商品ステータス区分 / 文字列型
商品ステータス名 / 文字列型
発送方法区分 / 文字列型 / 商品マスタの配送業者の区分値
発送方法名 / 文字列型 / 商品マスタの配送業者の名称
仕入先コード / 文字列型
JANコード / 文字列型
メーカー名 / 文字列型
メーカーカナ / 文字列型
メーカー住所 / 文字列型
メーカー郵便番号 / 文字列型
型番 / 文字列型
HSコード / 文字列型
色 / 文字列型
モールカテゴリ / 文字列型
店舗カテゴリ / 文字列型
原価 / 数値型
定価 / 数値型
売価単価 / 数値型
外国売価単価 / 数値型
消費税率(%) / 数値型
掛率 / 数値型
重さ / 数値型
幅 / 数値型
奥行き / 数値型
高さ / 数値型
発売日 / 日時型
初販売日 / 日時型
最終販売日 / 日時型
初仕入れ日 / 日時型
最終仕入れ日 / 日時型
在庫定数 / 数値型
発注点 / 数値型
ロット / 数値型
掲載日 / 日時型
在庫管理フラグ / 文字列型
備考 / 文字列型
表示フラグ / 文字列型
商品分類タグ / 文字列型 / 値は名称値(goods_tag_name)が設定されている。複数設定可能。
ロケーション / 文字列型
メール便可否フラグ / 数値型
メール便最大数量 / 文字列型
ギフト可フラグ / 数値型
サイズ / 文字列型
メーカー型番 / 文字列型
在庫アラートメール閾値 / 数値型
卸引当用敷居値 / 数値型
発送元コード / 文字列型
メールタグ / 文字列型
項目1 / 文字列型
項目2 / 文字列型
項目3 / 文字列型
項目4 / 文字列型
項目5 / 文字列型
項目6 / 文字列型
項目7 / 文字列型
項目8 / 文字列型
項目9 / 文字列型
項目10 / 文字列型
項目11 / 文字列型
項目12 / 文字列型
項目13 / 文字列型
項目14 / 文字列型
項目15 / 文字列型
項目16 / 文字列型
項目17 / 文字列型
項目18 / 文字列型
項目19 / 文字列型
項目20 / 文字列型
選択肢ID1 / 数値型
選択肢名1 / 文字列型
選択肢ID2 / 数値型
選択肢名2 / 文字列型
選択肢ID3 / 数値型
選択肢名3 / 文字列型
選択肢ID4 / 数値型
選択肢名4 / 文字列型
選択肢ID5 / 数値型
選択肢名5 / 文字列型
選択肢ID6 / 数値型
選択肢名6 / 文字列型
選択肢ID7 / 数値型
選択肢名7 / 文字列型
選択肢ID8 / 数値型
選択肢名8 / 文字列型
選択肢ID9 / 数値型
選択肢名9 / 文字列型
選択肢ID10 / 数値型
選択肢名10 / 文字列型
掲載担当者ID / 数値型
掲載担当者名 / 文字列型
卸在庫数 / 数値型
商品説明(テキスト) / 文字列型
商品説明(HTML) / 文字列型
スペック(テキスト) / 文字列型
スペック(HTML) / 文字列型
注意事項(テキスト) / 文字列型
注意事項(HTML) / 文字列型
商品状態説明 / 文字列型
商品状態ID / 文字列型 / 01:新品 10:中古 99:その他
ヒット商品お知らせ個数 / 数値型
納期ID / 文字列型
納期指定日 / 文字列型 / 納期IDが’date’の場合のみ有効
パッケージ込みの高さ(cm) / 数値型
パッケージ込みの幅(cm) / 数値型
パッケージ込みの奥行き(cm) / 数値型
パッケージ込みの重さ(g) / 数値型
販売開始日 / 日時型
販売終了日 / 日時型
消費税 / 数値型 / 0:税別 1:税込 2:非課税
ブランド名 / 文字列型
原産地 / 文字列型
原材料 / 文字列型
保存方法 / 文字列型
保証書の有無 / 数値型 / 0:なし 1:あり
のし対応 / 数値型 / 0:対応しない 1:対応する
当日・翌日配送 / 数値型 / 1:当日 2:翌日
作成日 / 日時型
最終更新日 / 日時型
最終更新日 / 日時型 / NULLの場合作成日
作成担当者ID / 数値型
作成担当者名 / 文字列型
最終更新者ID / 数値型
最終更新者ID / 数値型 / NULLの場合作成者ID
最終更新者名 / 文字列型
最終更新者名 / 文字列型 / NULLの場合作成者名
店舗コード / 数値型 / 店舗マスタの店舗コード
伝票番号 / 数値型 / ネクストエンジン内で一意に付与される番号
受注番号 / 文字列型 / 原則、店舗内で一意に付与される番号(重複する可能性あり。)
受注日 / 日時型 / 店舗側で受注した日
取込日 / 日時型 / ネクストエンジンに取り込まれた日
重要チェック区分 / 文字列型 / 1:重要
重要チェック名 / 文字列型 / 重要チェックを付けた担当者名
確認チェック区分 / 文字列型 / 0:確認不要1:確認必要2:確認済み
確認チェック名 / 文字列型 / 確認チェックを付けた担当者名
受注確認内容ID / 文字列型 / 受注確認内容IDが”:“区切りで設定されます。明細行に対する確認は”#“の後に明細行番号が設定されます。Ex: “AO:AA#1:AA#2”の場合送り先の郵便番号と住所があってません。商品コードが商品マスタに存在しません。:1行目商品コードが商品マスタに存在しません。:2行目
メール送信状態値 / 文字列型 / 次の値によりどの種類のメール送信が終了したかを表します。区切り文字はありません。例えばJHとあれば受注メールと発送完了メールが送信済みです。 J:受注確認メール B:印刷日待ち連絡メール C:印刷待ち以降連絡メール H:発送メール N:入金確認メール F:フォローメール
受注分類タグ / 文字列型 / []区切りでタグの名称が設定されている。例:[連絡待ち][ゴールド会員]
取込種類区分 / 文字列型 / 0:メール1:CSV2:手入力
取込種類名 / 文字列型
受注キャンセル区分 / 文字列型 / 受注キャンセル区分
受注キャンセル名 / 文字列型
受注キャンセル日 / 日時型
受注状態区分 / 文字列型 / 受注状態区分
受注状態名 / 文字列型
発送方法区分 / 文字列型 / 発送方法区分
発送方法名 / 文字列型
支払区分 / 文字列型 / 支払区分受注伝票の支払方法の値
支払名 / 文字列型
総合計 / 数値型 / 商品計+税金+手数料+発送代+他費用-ポイント数
税金 / 数値型
手数料 / 数値型
発送代 / 数値型
他費用 / 数値型
ポイント数 / 数値型
商品計 / 数値型
入金額 / 文字列型
入金状況区分 / 文字列型 / 入金区分
入金状況名 / 文字列型
入金日 / 日時型
備考 / 文字列型
同梱候補伝票番号 / 数値型 / ネクストエンジンが自動判定した同梱候補の伝票番号
同梱先伝票番号 / 数値型 / 同梱した場合の同梱先の伝票番号
複数配送親伝票番号 / 数値型 / 複数配送の親の伝票番号
分割元伝票番号 / 数値型 / 分割元の伝票番号
複写元伝票番号 / 数値型 / 複写元の伝票番号
複数配送親フラグ / 文字列型 / 複数配送の親か否か
納品書印刷指示日 / 日時型 / 受注状態区分が 20(納品書印刷待ち)の受注で、この日が今日より後なら画面では「印刷日待ち」、今日以前か未設定(0000-00-00 00:00:00)なら「印刷待ち」と表示されます。API で分けて取る条件はよくある間違いと対処の 3 にあります。
納品書発行日 / 日時型 / 納品書をダウンロードした日
納品書特記事項 / 文字列型
出荷確定日 / 日時型 / 受注状態が出荷確定済みになった日
出荷予定日 / 日時型
出荷順序 / 文字列型 / ラベル発行フラグがたった順序
作業用欄 / 文字列型
ピッキング指示内容 / 文字列型
ラベル発行日 / 日時型
ラベル発行フラグ / 文字列型 / 配送伝票の印刷対象か否か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の場合作成者名
拠点ID / 数値型 / ネクストエンジンで付与したユニークな拠点識別番号
拠点名 / 文字列型
作成日 / 日時型 / 拠点の作成日
最終更新日 / 日時型 / 拠点マスタの最終更新日
作成担当者ID / 数値型 / 拠点の作成担当者ID
作成担当者名 / 文字列型 / 拠点の作成担当者名
最終更新者ID / 数値型 / 拠点マスタの最終更新者ID
最終更新者名 / 文字列型 / 拠点マスタの最終更新者名
Example
{ "result": "success", "data": [ { "receive_order_row_receive_order_id": "1", "receive_order_row_shop_cut_form_id": "xxx", "receive_order_row_no": "1", "receive_order_row_shop_row_no": "93656155", "receive_order_row_goods_id": "TEST-804575", "receive_order_row_goods_name": "テスト商品", "receive_order_row_quantity": "0", "receive_order_row_unit_price": "5650.00", "receive_order_row_received_time_first_cost": "0.00", "receive_order_row_wholesale_retail_ratio": "10.0", "receive_order_row_sub_total_price": "0.00", "receive_order_row_goods_option": null, "receive_order_row_cancel_flag": "0", "receive_order_include_from_order_id": null, "receive_order_include_from_row_no": null, "receive_order_row_multi_delivery_parent_order_id": null, "receive_order_row_divide_from_row_no": null, "receive_order_row_copy_from_row_no": null, "receive_order_row_stock_allocation_quantity": "0", "receive_order_row_advance_order_stock_allocation_quantity": "0", "receive_order_row_stock_allocation_date": null, "receive_order_row_received_time_merchandise_id": null, "receive_order_row_received_time_merchandise_name": null, "receive_order_row_received_time_goods_type_id": null, "receive_order_row_received_time_goods_type_name": null, "receive_order_row_returned_good_quantity": "0", "receive_order_row_returned_bad_quantity": "0", "receive_order_row_returned_reason_id": null, "receive_order_row_returned_reason_name": null, "receive_order_row_org_row_no": null, "receive_order_row_deleted_flag": "0", "receive_order_row_creation_date": "2017-01-19 12:55:38", "receive_order_row_last_modified_date": "2017-03-22 16:19:16", "receive_order_row_last_modified_null_safe_date": "2017-03-22 16:19:16", "receive_order_row_last_modified_newest_date": "2017-04-14 16:24:36", "receive_order_row_creator_id": "10002", "receive_order_row_creator_name": "xxx", "receive_order_row_last_modified_by_id": "9999", "receive_order_row_last_modified_by_null_safe_id": "9999", "receive_order_row_last_modified_by_name": "管理者", "receive_order_row_last_modified_by_null_safe_name": "管理者" }, { "receive_order_row_receive_order_id": "1", "receive_order_row_shop_cut_form_id": "xxx", "receive_order_row_no": "2", "receive_order_row_shop_row_no": "93816145", "receive_order_row_goods_id": "TEST-504893", "receive_order_row_goods_name": "テスト商品2", "receive_order_row_quantity": "1", "receive_order_row_unit_price": "1000.00", "receive_order_row_received_time_first_cost": "0.00", "receive_order_row_wholesale_retail_ratio": "10.0", "receive_order_row_sub_total_price": "1000.00", "receive_order_row_goods_option": null, "receive_order_row_cancel_flag": "1", "receive_order_include_from_order_id": "2", "receive_order_include_from_row_no": "1", "receive_order_row_multi_delivery_parent_order_id": null, "receive_order_row_divide_from_row_no": null, "receive_order_row_copy_from_row_no": null, "receive_order_row_stock_allocation_quantity": "0", "receive_order_row_advance_order_stock_allocation_quantity": "0", "receive_order_row_stock_allocation_date": null, "receive_order_row_received_time_merchandise_id": null, "receive_order_row_received_time_merchandise_name": null, "receive_order_row_received_time_goods_type_id": null, "receive_order_row_received_time_goods_type_name": null, "receive_order_row_returned_good_quantity": "0", "receive_order_row_returned_bad_quantity": "0", "receive_order_row_returned_reason_id": null, "receive_order_row_returned_reason_name": null, "receive_order_row_org_row_no": null, "receive_order_row_deleted_flag": "0", "receive_order_row_creation_date": "2017-02-09 18:26:03", "receive_order_row_last_modified_date": "2017-03-22 16:19:16", "receive_order_row_last_modified_null_safe_date": "2017-03-22 16:19:16", "receive_order_row_last_modified_newest_date": "2017-04-14 16:24:36", "receive_order_row_creator_id": "10003", "receive_order_row_creator_name": "xxx", "receive_order_row_last_modified_by_id": "9999", "receive_order_row_last_modified_by_null_safe_id": "9999", "receive_order_row_last_modified_by_name": "管理者", "receive_order_row_last_modified_by_null_safe_name": "管理者" } ], "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"}クライアントエラー (HTTP ステータス自体は 200 + result=error で返ることが多い)
object
実行結果ステータス
エラー時のエラーコード
object
更新後のアクセストークン
アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)
更新後のリフレッシュトークン
リフレッシュトークン有効期限
エンドポイント固有のレスポンスデータ
Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)
Example
{ "result": "success"}