基本契約を検索する
Description
リクエストパラメータを検索条件として該当する基本契約情報を検索します。
Method
GET
共通リクエストヘッダーを参照してください。
Argument
Name |
Type |
Required |
Length (Long/Decimalの場合はValue) |
URI |
Query String |
Description |
basic_contract_id |
String |
|
15 |
- |
○ |
基本契約ID 契約グループを一意に識別するID |
customer_id |
String |
|
15 |
- |
○ |
顧客ID 顧客を一意に識別するID |
business_date |
String |
|
8 |
- |
○ |
業務日付 yyyyMMdd形式 |
group_id |
String |
|
8 |
- |
○ |
グループID グループを一意に識別するID |
classification_of_contract |
String |
|
1 |
- |
○ |
契約種別 |
bill_to_id |
String |
|
15 |
- |
○ |
請求先ID 請求先を一意に識別するID |
administration_number |
Long |
|
1 ~ 999 |
- |
○ |
管理番号 |
free_item1 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目1 |
free_item2 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目2 |
free_item3 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目3 |
free_item4 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目4 |
free_item5 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目5 |
free_item6 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目6 |
free_item7 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目7 |
free_item8 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目8 |
free_item9 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目9 |
free_item10 |
String |
|
1 ~ 1000 |
- |
○ |
フリー項目10 |
sort_item1 |
String |
|
1 ~ 40 |
- |
○ |
ソート項目名1 |
sort1 |
String |
|
1 |
- |
○ |
ソート順 |
sort_item2 |
String |
|
1 ~ 40 |
- |
○ |
ソート項目名2 |
sort2 |
String |
|
1 |
- |
○ |
ソート順 |
sort_item3 |
String |
|
1 ~ 40 |
- |
○ |
ソート項目名3 |
sort3 |
String |
|
1 |
- |
○ |
ソート順 |
start_position |
Long |
|
1 ~ 9999999 |
- |
○ |
開始位置 共通仕様はこちらを参照 |
end_position |
Long |
|
1 ~ 9999999 |
- |
○ |
終了位置 共通仕様はこちらを参照 |
URI
/API/v2/api/basiccontract
Sample request uri
顧客IDとページング指定の開始位置と終了位置を指定しての検索
/API/v2/api/basiccontract?customer_id=C00000000000001&start_position=1&end_position=100
Parameters in request body
なし
Return Codes
Code |
Description |
200 |
レスポンスが正常の場合は処理成功。レスポンスが異常の場合は入力パラメータエラー。 |
401 |
認証エラー。API認証時のエラー。 |
403 |
アクセス不可 |
404 |
対象なし。対象の情報が見つからない場合。 |
500 |
業務不整合。整合性チェックエラー、またはその他のサーバー側のエラー。 |
なし
Response Parameter
共通仕様はこちらを参照してください。
Example
{
"result_information":{
"result":"OK"
},
"basic_contract_list":[
{
"entry_system_date":"20170915192940900",
"entry_id":"O00000000000001",
"bill_to_version_info":"1",
"contractgroup_version_info":"1",
"bill_to_id":"000000000000012",
"administration_number":"1",
"apply_start_date":"20170912",
"apply_end_date":"20200912",
"customer_id":"123456789012345",
"basic_contract_id":"000000000000012",
"group_id":"12345678",
"classification_of_contract":"1",
"free_item":
{
"free1":"100",
"free2":"テスト",
"free3":"ABC"
},
"free_item1":"任意項目1",
"free_item2":"任意項目2",
"free_item3":"任意項目3",
"free_item4":"任意項目4",
"free_item5":"任意項目5",
"free_item6":"任意項目6",
"free_item7":"任意項目7",
"free_item8":"任意項目8",
"free_item9":"任意項目9",
"free_item10":"任意項目10"
}
]
}
Parameters
Name |
Type |
Required |
Length
(Long/Decimalの場合はValue) |
Description |
result_information |
list |
|
Single |
結果情報 |
|
result |
String |
|
2 |
結果
OKまたはNGを返却 |
detailed_result |
String |
|
1 ~ 256 |
結果詳細
NGの場合、エラー内容を返却 |
basic_contract_list |
list |
|
Multiple |
基本契約リスト |
|
entry_system_date |
String |
Yes |
17 |
登録システム日時 |
entry_id |
String |
Yes |
1 ~ 15 |
登録者ID 登録の処理を行ったユーザーのID |
update_system_date |
String |
|
17 |
更新システム日時 |
update_id |
String |
|
1 ~ 15 |
更新者ID 変更、削除の処理を行ったユーザーのID |
bill_to_version_info |
Long |
Yes |
1 ~ 999999999 |
請求先バージョン情報
共通仕様はこちらを参照 |
contractgroup_version_info |
Long |
Yes |
1 ~ 999999999 |
契約グループバージョン情報
共通仕様はこちらを参照 |
bill_to_id |
String |
Yes |
15 |
請求先ID 請求先を一意に識別するID |
administration_number |
Long |
Yes |
1 ~ 999 |
管理番号 |
apply_start_date |
String |
Yes |
8 |
適用開始年月日 顧客の適用を開始する年月日(当日を含む) |
apply_end_date |
String |
|
8 |
適用終了年月日 顧客の適用を終了する年月日(当日を含む) |
customer_id |
String |
|
15 |
顧客ID 顧客を一意に識別するID |
basic_contract_idd |
String |
Yes |
15 |
基本契約ID 契約グループを一意に識別するID |
group_id |
String |
|
8 |
グループID グループを一意に識別するID |
classification_of_contract |
String |
Yes |
1 |
契約種別 |
bill_to_name |
String |
|
1 ~ 128 |
請求先名称 |
zip_code |
String |
|
1 ~ 7 |
郵便番号 |
address1 |
String |
|
1 ~ 30 |
住所1 |
address2 |
String |
|
1 ~ 30 |
住所2 |
address3 |
String |
|
1 ~ 30 |
住所3 |
address4 |
String |
|
1 ~ 30 |
住所4 |
phone_number1 |
String |
|
1 ~ 30 |
電話番号1 |
phone_number2 |
String |
|
1 ~ 30 |
電話番号2 |
email_address1 |
String |
|
1 ~ 256 |
メールアドレス1 |
email_address2 |
String |
|
1 ~ 256 |
メールアドレス2 |
free_item |
String |
|
1 ~ 30000 |
フリー項目 |
free_item1 |
String |
|
1 ~ 1000 |
フリー項目1 |
free_item2 |
String |
|
1 ~ 1000 |
フリー項目2 |
free_item3 |
String |
|
1 ~ 1000 |
フリー項目3 |
free_item4 |
String |
|
1 ~ 1000 |
フリー項目4 |
free_item5 |
String |
|
1 ~ 1000 |
フリー項目5 |
free_item6 |
String |
|
1 ~ 1000 |
フリー項目6 |
free_item7 |
String |
|
1 ~ 1000 |
フリー項目7 |
free_item8 |
String |
|
1 ~ 1000 |
フリー項目8 |
free_item9 |
String |
|
1 ~ 1000 |
フリー項目9 |
free_item10 |
String |
|
1 ~ 1000 |
フリー項目10 |
Top