仕入明細検索
curl -X POST -H 'content-type: application/x-www-form-urlencoded' -d 'access_token=xxxxx&refresh_token=xxxxx&wait_flag=1&fields=supply_order_id,supply_order_row_no,supply_order_row_goods_id,supply_order_row_goods_name,supply_order_row_goods_option,supply_order_row_surplus_quantity,supply_order_row_quantity,supply_order_row_unit_price,supply_order_row_sub_total_price,supply_order_row_order_id,supply_order_row_order_row_no,supply_order_row_receive_order_id,supply_order_row_receive_order_row_no,supply_order_row_status,supply_order_row_completed_flag,supply_order_row_note,supply_order_row_deleted_flag,supply_order_row_creation_date,supply_order_row_last_modified_date,supply_order_row_last_modified_null_safe_date,supply_order_row_creator_id,supply_order_row_creator_name,supply_order_row_last_modified_by_id,supply_order_row_last_modified_by_null_safe_id,supply_order_row_last_modified_by_name,supply_order_row_last_modified_by_null_safe_name&offset=0&limit=10&supply_order_id-eq=1' https://api.next-engine.org/api_v1_supplyorder_row/search// POST /api_v1_supplyorder_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_supplyorder_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_supplyorder_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_supplyorder_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
仕入伝票番号 / 数値型
仕入明細行 / 数値型
商品コード / 文字列型
商品名 / 文字列型
商品オプション / 文字列型
余剰数 / 数値型
仕入数 / 数値型
仕入単価 / 数値型
小計金 / 数値型
発注伝票番号 / 数値型
発注明細行 / 数値型
受注伝票番号 / 数値型
受注明細行 / 数値型
仕入明細行区分 / 文字列型 / 0:通常仕入, 95:不良品振替
仕入完了状態 / 文字列型 / 0:未完了,1:完了
備考 / 文字列型
削除フラグ / 文字列型 / 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の場合作成者名
仕入伝票番号 / 数値型
仕入コード / 文字列型
仕入伝票区分 / 数値型
仕入伝票区分名 / 文字列型
仕入日 / 日時型
納品書番号 / 文字列型
該当発注伝票番号 / 数値型
仕入元伝票番号 / 数値型
仕入金 / 数値型
仕入状態区分 / 文字列型
仕入状態区分名 / 文字列型
削除フラグ / 文字列型 / 0:削除されていない 1:削除済み
作成日 / 日時型
最終更新日 / 日時型
最終更新日 / 日時型 / NULLの場合作成日
作成担当者ID / 数値型
作成担当者名 / 文字列型
最終更新者ID / 数値型
最終更新者ID / 数値型 / NULLの場合作成者ID
最終更新者名 / 文字列型
最終更新者名 / 文字列型 / NULLの場合作成者名
Example
{ "result": "success", "count": "3", "data": [ { "supply_order_id": "1", "supply_order_row_no": "1", "supply_order_row_goods_id": "bn,nm", "supply_order_row_goods_name": "2", "supply_order_row_goods_option": "", "supply_order_row_surplus_quantity": "250", "supply_order_row_quantity": "250", "supply_order_row_unit_price": "1.00", "supply_order_row_sub_total_price": "250.00", "supply_order_row_order_id": "0", "supply_order_row_order_row_no": "1", "supply_order_row_receive_order_id": "0", "supply_order_row_receive_order_row_no": "0", "supply_order_row_status": "0", "supply_order_row_completed_flag": "0", "supply_order_row_note": "", "supply_order_row_deleted_flag": "0", "supply_order_row_creation_date": "2018-02-23 13:51:57", "supply_order_row_last_modified_date": "2018-02-23 13:51:57", "supply_order_row_last_modified_null_safe_date": "2018-02-23 13:51:57", "supply_order_row_creator_id": "10012", "supply_order_row_creator_name": "Le Hung", "supply_order_row_last_modified_by_id": "10012", "supply_order_row_last_modified_by_null_safe_id": "10012", "supply_order_row_last_modified_by_name": "Le Hung", "supply_order_row_last_modified_by_null_safe_name": "Le Hung" }, { "supply_order_id": "1", "supply_order_row_no": "2", "supply_order_row_goods_id": ",,inverter300-12v60hz_fuse", "supply_order_row_goods_name": "インバーター定格300W 12DCV 60Hz用予備ヒューズ", "supply_order_row_goods_option": "", "supply_order_row_surplus_quantity": "350", "supply_order_row_quantity": "350", "supply_order_row_unit_price": "1.00", "supply_order_row_sub_total_price": "350.00", "supply_order_row_order_id": "0", "supply_order_row_order_row_no": "2", "supply_order_row_receive_order_id": "0", "supply_order_row_receive_order_row_no": "0", "supply_order_row_status": "0", "supply_order_row_completed_flag": "0", "supply_order_row_note": "", "supply_order_row_deleted_flag": "0", "supply_order_row_creation_date": "2018-02-23 13:51:57", "supply_order_row_last_modified_date": "2018-02-23 13:51:57", "supply_order_row_last_modified_null_safe_date": "2018-02-23 13:51:57", "supply_order_row_creator_id": "10012", "supply_order_row_creator_name": "Le Hung", "supply_order_row_last_modified_by_id": "10012", "supply_order_row_last_modified_by_null_safe_id": "10012", "supply_order_row_last_modified_by_name": "Le Hung", "supply_order_row_last_modified_by_null_safe_name": "Le Hung" }, { "supply_order_id": "1", "supply_order_row_no": "3", "supply_order_row_goods_id": ",,,,,bnnnm", "supply_order_row_goods_name": "1", "supply_order_row_goods_option": "", "supply_order_row_surplus_quantity": "450", "supply_order_row_quantity": "450", "supply_order_row_unit_price": "1.00", "supply_order_row_sub_total_price": "450.00", "supply_order_row_order_id": "0", "supply_order_row_order_row_no": "3", "supply_order_row_receive_order_id": "0", "supply_order_row_receive_order_row_no": "0", "supply_order_row_status": "0", "supply_order_row_completed_flag": "0", "supply_order_row_note": "", "supply_order_row_deleted_flag": "0", "supply_order_row_creation_date": "2018-02-23 13:51:57", "supply_order_row_last_modified_date": "2018-02-23 13:51:57", "supply_order_row_last_modified_null_safe_date": "2018-02-23 13:51:57", "supply_order_row_creator_id": "10012", "supply_order_row_creator_name": "Le Hung", "supply_order_row_last_modified_by_id": "10012", "supply_order_row_last_modified_by_null_safe_id": "10012", "supply_order_row_last_modified_by_name": "Le Hung", "supply_order_row_last_modified_by_null_safe_name": "Le Hung" } ], "access_token": "xxxxx", "access_token_end_date": "2018-02-24 12:13:16", "refresh_token": "xxxxx", "refresh_token_end_date": "2018-02-26 12:13:16"}クライアントエラー (HTTP ステータス自体は 200 + result=error で返ることが多い)
object
実行結果ステータス
エラー時のエラーコード
object
更新後のアクセストークン
アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)
更新後のリフレッシュトークン
リフレッシュトークン有効期限
エンドポイント固有のレスポンスデータ
Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)
Example
{ "result": "success"}