# 在庫入出庫履歴 — ネクストエンジン API > 在庫入出庫履歴 カテゴリの API endpoint (2 件) を集約したファイル。 > インデックス: https://developer.next-engine.com/llms.txt | 全文: https://developer.next-engine.com/llms-full.txt --- # 在庫入出庫履歴件数取得 URL: https://developer.next-engine.com/api/api_v1_master_stockiohistory/count/ Method: POST API Endpoint: https://api.next-engine.org/api_v1_master_stockiohistory/count Tag: 在庫入出庫履歴 Required parameters: access_token Optional parameters: refresh_token, wait_flag, fields, offset, limit ## リクエストURL ホスト `https://api.next-engine.org` エンドポイント `/api_v1_master_stockiohistory/count` ## リファレンス内容 ### 件数取得について 入力パラメータはPOST、出力パラメータはレスポンス(レスポンスボディにJSON)になります 検索条件を複数指定した場合、全ての条件がかつ(AND)となります ### 入力パラメータ | パラメータ | 値 | 省略 | 備考 | | --- | --- | --- | --- | | `access_token` | access_token取得により取得した値 | 必須(SDKの場合不要) | | | `refresh_token` | access_token取得により取得した値 | 可能(SDKの場合不要) | 【指定してaccess_tokenの有効期限が切れた場合】 正常に出力パラメータが設定されaccess_tokenとrefresh_tokenが新しい値に更新されます 【省略してaccess_tokenの有効期限が切れた場合】 出力パラメータ「result」の値がredirectになります（成功時以外の出力パラメータ参照) | | `wait_flag` | 1:メイン機能過負荷でも可能な限りエラーにせず実行1以外:メイン機能過負荷の場合、003002のエラーを返却 | 可能(省略時は1以外とする) | 詳細はパラメータ共通事項「待機フラグについて」を参照して下さい | | フィールド名-比較演算子(WHERE句のカラムと比較演算子相当) | 検索条件の値(WHERE句の値相当) | 可能 | 例：商品マスタ検索でパラメータ：goods_id-like、値："%-red"と指定した場合、商品コードが*-redの商品マスタを検索します | ### 出力パラメータ | パラメータ名 | 値 | 備考 | | --- | --- | --- | | `result` | `success` | success以外の場合の出力パラメータは成功時以外の出力パラメータ参照 | | `access_token` | 入力パラメータで指定したaccess_token／新たに発行されたaccess_token | 有効なrefresh_tokenを指定してaccess_tokenの有効期限がきれた場合、新たに発行(この時点から1日有効)されたaccess_tokenになります | | `access_token_end_date` | access_tokenの有効期限切れ日時 | | | `refresh_token` | 入力パラメータで指定したrefresh_token／新たに発行されたrefresh_token | access_tokenが新しく発行された場合、新たに発行(この時点から3日有効)されたrefresh_tokenになります | | `refresh_token_end_date` | refresh_tokenの有効期限切れ日時 | | | `count` | 検索結果の件数 | | ### 在庫入出庫履歴 | 項目名 | フィールド名 | データ型 | 備考 | | --- | --- | --- | --- | | 在庫入出庫履歴ID | `stock_io_history_id` | 数値型 | | | 店舗コード | `stock_io_history_shop_id` | 数値型 | | | 商品コード | `stock_io_history_goods_id` | 文字列型 | | | 入出庫日 | `stock_io_history_date` | 日時型 | | | 更新前在庫数 | `stock_io_history_before_stock_quantity` | 数値型 | | | 更新後在庫数 | `stock_io_history_after_stock_quantity` | 数値型 | | | 更新前不良在庫数 | `stock_io_history_before_bad_stock_quantity` | 数値型 | | | 更新後不良在庫数 | `stock_io_history_after_bad_stock_quantity` | 数値型 | | | 入出庫数 | `stock_io_history_quantity` | 数値型 | | | 伝票番号 | `stock_io_history_cut_form_id` | 数値型 | 入出庫した処理別の伝票番号が設定される。例えば受注伝票により出庫された場合は受注伝票の伝票番号が設定される。 | | 入出庫フラグ | `stock_io_history_io_flag` | 文字列型 | 0:入庫、1:出庫 | | 入出庫区分 | `stock_io_history_io_type_id` | 文字列型 | | | 入出庫名 | `stock_io_history_io_type_name` | 文字列型 | | | 事由 | `stock_io_history_reason` | 文字列型 | | | 担当者ID | `stock_io_history_pic_id` | 数値型 | | | 担当者名 | `stock_io_history_pic_name` | 文字列型 | | | 削除フラグ | `stock_io_history_deleted_flag` | 文字列型 | | | 作成日 | `stock_io_history_creation_date` | 日時型 | | | 最終更新日 | `stock_io_history_last_modified_date` | 日時型 | | | 最終更新日 | `stock_io_history_last_modified_null_safe_date` | 日時型 | NULLの場合作成日 | | 作成担当者ID | `stock_io_history_creator_id` | 数値型 | | | 作成担当者名 | `stock_io_history_creator_name` | 文字列型 | | | 最終更新者ID | `stock_io_history_last_modified_by_id` | 数値型 | | | 最終更新者ID | `stock_io_history_last_modified_by_null_safe_id` | 数値型 | NULLの場合作成者ID | | 最終更新者名 | `stock_io_history_last_modified_by_name` | 文字列型 | | | 最終更新者名 | `stock_io_history_last_modified_by_null_safe_name` | 文字列型 | NULLの場合作成者名 | サンプル ### サンプル リクエスト ```bash curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'access_token=xxxxxxxxxxxxxx&refresh_token=xxxxxxxxxxxxxx&wait_flag=1&stock_io_history_deleted_flag-eq=0' https://api.next-engine.org/api_v1_master_stockiohistory/count ``` レスポンス ```json { "result": "success", "count": "66", "access_token": "xxxxx", "access_token_end_date": "2017-04-15 13:03:47", "refresh_token": "xxxxx", "refresh_token_end_date": "2017-04-17 13:03:47" } ``` ## エラー ### エラーコード エンドポイント固有のエラーコードはありません。 共通エラーコードは [メッセージコード一覧](/guides/param/message/) を参照してください。 ## 関連リンク - 構造化スキーマビュー: [`/openapi/operations/api_v1_master_stockiohistory_count/`](/openapi/operations/api_v1_master_stockiohistory_count/) (OpenAPI 3.1 のインタラクティブ仕様) - エラーコード一覧: [`/guides/param/message/`](/guides/param/message/) (`result`/`code`/`message` の意味) - フィールド一覧: [`/guides/fields/master_stockiohistory/`](/guides/fields/master_stockiohistory/) (このエンドポイントが扱うデータ項目) ### 同じカテゴリの他のエンドポイント (在庫入出庫履歴) - [在庫入出庫履歴検索](/api/api_v1_master_stockiohistory/search/) — `POST /api_v1_master_stockiohistory/search` --- # 在庫入出庫履歴検索 URL: https://developer.next-engine.com/api/api_v1_master_stockiohistory/search/ Method: POST API Endpoint: https://api.next-engine.org/api_v1_master_stockiohistory/search Tag: 在庫入出庫履歴 Required parameters: access_token Optional parameters: refresh_token, wait_flag, fields, offset, limit ## リクエストURL ホスト `https://api.next-engine.org` エンドポイント `/api_v1_master_stockiohistory/search` ## リファレンス内容 ### 検索について 入力パラメータはPOST、出力パラメータはレスポンス(レスポンスボディにJSON)になります 検索条件を複数指定した場合、全ての条件がかつ(AND)となります ### 入力パラメータ | パラメータ | 値 | 省略 | 備考 | | --- | --- | --- | --- | | `access_token` | access_token取得により取得した値 | 必須(SDKの場合不要) | | | `refresh_token` | access_token取得により取得した値 | 可能(SDKの場合不要) | 【指定してaccess_tokenの有効期限が切れた場合】 正常に出力パラメータが設定されaccess_tokenとrefresh_tokenが新しい値に更新されます 【省略してaccess_tokenの有効期限が切れた場合】 出力パラメータ「result」の値がredirectになります（成功時以外の出力パラメータ参照) | | `wait_flag` | 1:メイン機能過負荷でも可能な限りエラーにせず実行1以外:メイン機能過負荷の場合、003002のエラーを返却 | 可能(省略時は1以外とする) | 詳細はパラメータ共通事項「待機フラグについて」を参照して下さい | | `fields` | 検索結果で取得するフィールドをカンマ区切りで指定(SELECT句相当) | 必須 | 例：商品マスタ検索で「goods_id, goods_name, stock_quantity, supplier_name」を指定した場合、「商品コード、商品名、在庫数、仕入先名」を検索結果として取得します | | フィールド名-比較演算子(WHERE句のカラムと比較演算子相当) | 検索条件の値(WHERE句の値相当) | 可能 | 例：商品マスタ検索でパラメータ：goods_id-like、値："%-red"と指定した場合、商品コードが*-redの商品マスタを検索します | | `offset` | オフセットの数値(OFFSET句相当) | 可能(省略時0) | 0：一番最初の検索結果から取得、1:２番めの検索結果から取得・・・ | | `limit` | 取得数の数値(LIMIT句相当) | 可能(省略時10000) | | ### 出力パラメータ | パラメータ名 | 値 | 備考 | | --- | --- | --- | | `result` | `success` | success以外の場合の出力パラメータは成功時以外の出力パラメータ参照 | | `access_token` | 入力パラメータで指定したaccess_token／新たに発行されたaccess_token | 有効なrefresh_tokenを指定してaccess_tokenの有効期限がきれた場合、新たに発行(この時点から1日有効)されたaccess_tokenになります | | `access_token_end_date` | access_tokenの有効期限切れ日時 | | | `refresh_token` | 入力パラメータで指定したrefresh_token／新たに発行されたrefresh_token | access_tokenが新しく発行された場合、新たに発行(この時点から3日有効)されたrefresh_tokenになります | | `refresh_token_end_date` | refresh_tokenの有効期限切れ日時 | | | `count` | 検索結果の件数 | | | `data` | 検索結果の連想配列(JSONのオブジェクト型) | | ### 検索速度について 入力パラメータのfieldsの指定を増やすほど処理に時間が掛かります。必要な情報のみ検索した方がより高速になります 検索結果のデータ量が増える程、指数関数的に検索結果の取得に時間がかかります(アプリのWebサーバーの性能が低い程顕著です)。Webサーバーの見直し又は、limit又はfieldsを調整して下さい 大量の検索結果を取得する場合、アクセスが集中する07:00～22:00の時間帯を避けてバックグラウンドで情報を取得することを推奨します ### 在庫入出庫履歴 | 項目名 | フィールド名 | データ型 | 備考 | | --- | --- | --- | --- | | 在庫入出庫履歴ID | `stock_io_history_id` | 数値型 | | | 店舗コード | `stock_io_history_shop_id` | 数値型 | | | 商品コード | `stock_io_history_goods_id` | 文字列型 | | | 入出庫日 | `stock_io_history_date` | 日時型 | | | 更新前在庫数 | `stock_io_history_before_stock_quantity` | 数値型 | | | 更新後在庫数 | `stock_io_history_after_stock_quantity` | 数値型 | | | 更新前不良在庫数 | `stock_io_history_before_bad_stock_quantity` | 数値型 | | | 更新後不良在庫数 | `stock_io_history_after_bad_stock_quantity` | 数値型 | | | 入出庫数 | `stock_io_history_quantity` | 数値型 | | | 伝票番号 | `stock_io_history_cut_form_id` | 数値型 | 入出庫した処理別の伝票番号が設定される。例えば受注伝票により出庫された場合は受注伝票の伝票番号が設定される。 | | 入出庫フラグ | `stock_io_history_io_flag` | 文字列型 | 0:入庫、1:出庫 | | 入出庫区分 | `stock_io_history_io_type_id` | 文字列型 | | | 入出庫名 | `stock_io_history_io_type_name` | 文字列型 | | | 事由 | `stock_io_history_reason` | 文字列型 | | | 担当者ID | `stock_io_history_pic_id` | 数値型 | | | 担当者名 | `stock_io_history_pic_name` | 文字列型 | | | 削除フラグ | `stock_io_history_deleted_flag` | 文字列型 | | | 作成日 | `stock_io_history_creation_date` | 日時型 | | | 最終更新日 | `stock_io_history_last_modified_date` | 日時型 | | | 最終更新日 | `stock_io_history_last_modified_null_safe_date` | 日時型 | NULLの場合作成日 | | 作成担当者ID | `stock_io_history_creator_id` | 数値型 | | | 作成担当者名 | `stock_io_history_creator_name` | 文字列型 | | | 最終更新者ID | `stock_io_history_last_modified_by_id` | 数値型 | | | 最終更新者ID | `stock_io_history_last_modified_by_null_safe_id` | 数値型 | NULLの場合作成者ID | | 最終更新者名 | `stock_io_history_last_modified_by_name` | 文字列型 | | | 最終更新者名 | `stock_io_history_last_modified_by_null_safe_name` | 文字列型 | NULLの場合作成者名 | サンプル ### サンプル リクエスト ```bash curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'access_token=xxxxxxxxxxxxxx&refresh_token=xxxxxxxxxxxxxx&wait_flag=1&stock_io_history_deleted_flag-eq=0&fields=stock_io_history_id, stock_io_history_goods_id, stock_io_history_date&offset=0&limit=5' https://api.next-engine.org/api_v1_master_stockiohistory/search ``` レスポンス ```json { "result": "success", "count": "5", "data": [ { "stock_io_history_id": "1", "stock_io_history_goods_id": "T101", "stock_io_history_date": "2017-01-18 15:40:06" }, { "stock_io_history_id": "2", "stock_io_history_goods_id": "T101", "stock_io_history_date": "2017-01-18 15:50:26" }, { "stock_io_history_id": "3", "stock_io_history_goods_id": "T101", "stock_io_history_date": "2017-01-18 16:12:04" }, { "stock_io_history_id": "4", "stock_io_history_goods_id": "T101", "stock_io_history_date": "2017-02-10 14:55:59" }, { "stock_io_history_id": "5", "stock_io_history_goods_id": "T101", "stock_io_history_date": "2017-02-10 14:58:10" } ], "access_token": "xxxxx", "access_token_end_date": "2017-04-15 13:03:47", "refresh_token": "xxxxx", "refresh_token_end_date": "2017-04-17 13:03:47" } ``` ## エラー ### エラーコード エンドポイント固有のエラーコードはありません。 共通エラーコードは [メッセージコード一覧](/guides/param/message/) を参照してください。 ## 関連リンク - 構造化スキーマビュー: [`/openapi/operations/api_v1_master_stockiohistory_search/`](/openapi/operations/api_v1_master_stockiohistory_search/) (OpenAPI 3.1 のインタラクティブ仕様) - エラーコード一覧: [`/guides/param/message/`](/guides/param/message/) (`result`/`code`/`message` の意味) - フィールド一覧: [`/guides/fields/master_stockiohistory/`](/guides/fields/master_stockiohistory/) (このエンドポイントが扱うデータ項目) ### 同じカテゴリの他のエンドポイント (在庫入出庫履歴) - [在庫入出庫履歴件数取得](/api/api_v1_master_stockiohistory/count/) — `POST /api_v1_master_stockiohistory/count`