仕入伝票件数取得
リクエストURL
Section titled “リクエストURL”ホスト
https://api.next-engine.org
エンドポイント
/api_v1_supplyorder_base/count
リファレンス内容
Section titled “リファレンス内容”件数取得について
Section titled “件数取得について”入力パラメータはPOST、出力パラメータはレスポンス(レスポンスボディにJSON)になります
検索条件を複数指定した場合、全ての条件がかつ(AND)となります
入力パラメータ
Section titled “入力パラメータ”| パラメータ | 値 | 省略 | 備考 |
|---|---|---|---|
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の商品マスタを検索します |
出力パラメータ
Section titled “出力パラメータ”| パラメータ名 | 値 | 備考 |
|---|---|---|
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 | 検索結果の件数 |
| 項目名 | フィールド名 | データ型 | 備考 |
|---|---|---|---|
| 仕入伝票番号 | supply_order_id | 数値型 | |
| 仕入コード | supply_order_supplier_id | 文字列型 | |
| 仕入伝票区分 | supply_order_type_id | 数値型 | |
| 仕入伝票区分名 | supply_order_type_name | 文字列型 | |
| 仕入日 | supply_order_date | 日時型 | |
| 納品書番号 | supply_order_delivery_id | 文字列型 | |
| 該当発注伝票番号 | supply_order_correspond_order_id | 数値型 | |
| 仕入元伝票番号 | supply_order_original_order_id | 数値型 | |
| 仕入金 | supply_order_amount | 数値型 | |
| 仕入状態区分 | supply_order_status_id | 文字列型 | |
| 仕入状態区分名 | supply_order_status_name | 文字列型 | |
| 削除フラグ | supply_order_deleted_flag | 文字列型 | 1:有効 1以外:無効 |
| 作成日 | supply_order_creation_date | 日時型 | |
| 最終更新日 | supply_order_last_modified_date | 日時型 | |
| 最終更新日 | supply_order_last_modified_null_safe_date | 日時型 | NULLの場合作成日 |
| 作成担当者ID | supply_order_creator_id | 数値型 | |
| 作成担当者名 | supply_order_creator_name | 文字列型 | |
| 最終更新者ID | supply_order_last_modified_by_id | 数値型 | |
| 最終更新者ID | supply_order_last_modified_by_null_safe_id | 数値型 | NULLの場合作成者ID |
| 最終更新者名 | supply_order_last_modified_by_name | 文字列型 | |
| 最終更新者名 | supply_order_last_modified_by_null_safe_name | 文字列型 | NULLの場合作成者名 |
サンプル
リクエスト
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'access_token=xxxxx&refresh_token=xxxxx&wait_flag=1&supply_order_last_modified_null_safe_date-gt=2018-01-23 13:53:52' https://api.next-engine.org/api_v1_supplyorder_base/countレスポンス
{ "result": "success" "count": "xxx", "access_token":"xxxxxxxxxx", "access_token_end_date":"2018-02-24 12:13:16", "refresh_token":"xxxxxxxxxx", "refresh_token_end_date":"2018-02-24 13:54:35"}エラーコード
Section titled “エラーコード”エンドポイント固有のエラーコードはありません。 共通エラーコードは メッセージコード一覧 を参照してください。
- 構造化スキーマビュー:
/openapi/operations/api_v1_supplyorder_base_count/(OpenAPI 3.1 のインタラクティブ仕様) - エラーコード一覧:
/guides/param/message/(result/code/messageの意味)
同じカテゴリの他のエンドポイント (仕入伝票)
Section titled “同じカテゴリの他のエンドポイント (仕入伝票)”- 仕入伝票検索 —
POST /api_v1_supplyorder_base/search