コンテンツにスキップ

仕入先マスタ件数取得

POST

/api_v1_master_supplier/count

curl -X POST https://api.next-engine.org/api_v1_master_supplier/count -H 'cache-control: no-cache' -F access_token=xxxxxx -F refresh_token=xxxxxx -F wait_flag=1 -F supplier_name-like=%VENDOR -F supplier_id-eq=8888

// POST /api_v1_master_supplier/count - 仕入先マスタ件数取得
const params = new URLSearchParams({
  access_token: '<access_token>',
  fields: 'field1,field2',
})
const res = await fetch('https://api.next-engine.org/api_v1_master_supplier/count', {
  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_master_supplier/count - 仕入先マスタ件数取得
import requests

params = {
    'access_token': '<access_token>',
    'fields': 'field1,field2',
}
res = requests.post(
    'https://api.next-engine.org/api_v1_master_supplier/count',
    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

application/x-www-form-urlencoded

object

access_token

required

OAuth2 アクセストークン (必須)

string

refresh_token

OAuth2 リフレッシュトークン (access_token 期限切れ時の自動更新に使用)

string

wait_flag

同期実行フラグ。“1” 指定で処理完了を待つ

string

Allowed values: 0 1

fields

取得するフィールドをカンマ区切りで指定 (search 系のみ)

string

offset

検索開始位置 (search 系のみ)

integer

limit

取得件数 (search 系のみ)

integer

>= 1

Responses

200

実行結果 (result が success / error / redirect のいずれか)

application/json

object

result

required

実行結果ステータス

string

Allowed values: success error redirect

code

エラー時のエラーコード

string

message

One of:

string
Array<object>

string

access_token

更新後のアクセストークン

string

access_token_end_date

アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)

string

refresh_token

更新後のリフレッシュトークン

string

refresh_token_end_date

リフレッシュトークン有効期限

string

data

エンドポイント固有のレスポンスデータ

count

Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)

integer | string

data

Array<object>

object

supplier_id

仕入先コード / 文字列型

string | integer | number | boolean | null

supplier_name

仕入先名 / 文字列型

string | integer | number | boolean | null

supplier_kana

仕入先カナ / 文字列型

string | integer | number | boolean | null

supplier_zip_code

郵便番号 / 文字列型

string | integer | number | boolean | null

supplier_address1

住所１ / 文字列型

string | integer | number | boolean | null

supplier_address2

住所２ / 文字列型

string | integer | number | boolean | null

supplier_tel

電話番号 / 文字列型

string | integer | number | boolean | null

supplier_fax

FAX番号 / 文字列型

string | integer | number | boolean | null

supplier_mail_address

メールアドレス / 文字列型

string | integer | number | boolean | null

supplier_post

部署名 / 文字列型

string | integer | number | boolean | null

supplier_pic_name

担当者名 / 文字列型

string | integer | number | boolean | null

supplier_pic_kana

担当者カナ / 文字列型

string | integer | number | boolean | null

supplier_post_zip_code

部署郵便番号 / 文字列型

string | integer | number | boolean | null

supplier_post_address1

部署住所１ / 文字列型

string | integer | number | boolean | null

supplier_post_address2

部署住所２ / 文字列型

string | integer | number | boolean | null

supplier_post_tel

部署電話番号 / 文字列型

string | integer | number | boolean | null

supplier_post_fax

部署FAX / 文字列型

string | integer | number | boolean | null

supplier_post_mail_address

部署メールアドレス / 文字列型

string | integer | number | boolean | null

supplier_order_id

発注区分 / 文字列型

string | integer | number | boolean | null

supplier_order_name

発注名 / 文字列型

string | integer | number | boolean | null

supplier_condition_quantity

数量条件 / 数値型

string | integer | number | boolean | null

supplier_condition_money

金額条件 / 数値型

string | integer | number | boolean | null

supplier_order_condition_id

発注条件区分 / 文字列型

string | integer | number | boolean | null

supplier_order_condition_name

発注条件名 / 文字列型

string | integer | number | boolean | null

supplier_order_pending_date

発注保留日 / 文字列型

string | integer | number | boolean | null

supplier_pay_out_id

支払方法区分 / 文字列型

string | integer | number | boolean | null

supplier_pay_out_name

支払方法名 / 文字列型

string | integer | number | boolean | null

supplier_closing_day

締日 / 文字列型

string | integer | number | boolean | null

supplier_usance_date

支払サイト日 / 文字列型

string | integer | number | boolean | null

supplier_order_invalid_flag

発注無効フラグ / 文字列型

string | integer | number | boolean | null

supplier_order_forbid_date

発注禁止日 / 日時型

string | integer | number | boolean | null

supplier_note

備考 / 文字列型

string | integer | number | boolean | null

supplier_wholesale_retail_ratio

掛率 / 数値型

string | integer | number | boolean | null

supplier_deleted_flag

削除フラグ / 文字列型

string | integer | number | boolean | null

supplier_creation_date

作成日 / 日時型

string | integer | number | boolean | null

supplier_last_modified_date

最終更新日 / 日時型

string | integer | number | boolean | null

supplier_last_modified_null_safe_date

最終更新日 / 日時型 / NULLの場合作成日

string | integer | number | boolean | null

supplier_creator_id

作成担当者ID / 数値型

string | integer | number | boolean | null

supplier_creator_name

作成担当者名 / 文字列型

string | integer | number | boolean | null

supplier_last_modified_by_id

最終更新者ID / 数値型

string | integer | number | boolean | null

supplier_last_modified_by_null_safe_id

最終更新者ID / 数値型 / NULLの場合作成者ID

string | integer | number | boolean | null

supplier_last_modified_by_name

最終更新者名 / 文字列型

string | integer | number | boolean | null

supplier_last_modified_by_null_safe_name

最終更新者名 / 文字列型 / NULLの場合作成者名

string | integer | number | boolean | null

key

additional properties

any

Example

{
  "result": "success",
  "count": "1",
  "access_token": "xxxxxxxxxxx",
  "access_token_end_date": "2017-04-13 18:24:53",
  "refresh_token": "xxxxxxxxxxx",
  "refresh_token_end_date": "2017-04-15 18:24:53"
}

4XX

クライアントエラー (HTTP ステータス自体は 200 + result=error で返ることが多い)

application/json

object

result

required

実行結果ステータス

string

Allowed values: success error redirect

code

エラー時のエラーコード

string

message

One of:

string
Array<object>

string

access_token

更新後のアクセストークン

string

access_token_end_date

アクセストークン有効期限 (YYYY-MM-DD HH:MM:SS)

string

refresh_token

更新後のリフレッシュトークン

string

refresh_token_end_date

リフレッシュトークン有効期限

string

data

エンドポイント固有のレスポンスデータ

count

Count/search 系のヒット件数 (form-urlencoded レスポンスでは文字列で返ることがある)

integer | string

Example

{
  "result": "success"
}