Skip to content

サービス契約を検索する#

Description#

リクエストパラメータを検索条件として該当するサービス契約情報を検索します。

Method#

GET

Request Header#

共通リクエストヘッダーを参照してください。

Argument#

Name Type Required Length
(Long/Decimalの場合はValue)
URI Query String Description
apply_start_date_from String 8 - 適用開始年月日From
入力値の適用開始年月日以降
yyyyMMdd形式
apply_start_date_to String 8 - 適用開始年月日To
入力値の適用開始年月日以前
yyyyMMdd形式
apply_end_date_from String 8 - 適用終了年月日From
入力値の適用終了年月日以降
yyyyMMdd形式
apply_end_date_to String 8 - 適用終了年月日To
入力値の適用終了年月日以前
yyyyMMdd形式
charging_start_date_from String 8 - 課金開始年月日From
入力値の課金開始年月日以降
yyyyMMdd形式
charging_start_date_to String 8 - 課金開始年月日To
入力値の適用開始年月日以前
yyyyMMdd形式
charging_end_date_from String 8 - 課金終了年月日From
入力値の課金終了年月日以降
yyyyMMdd形式
charging_end_date_to String 8 - 課金終了年月日To
入力値の課金終了年月日以前
yyyyMMdd形式
service_application_date_from String 8 - サービス申込年月日From
入力値のサービス申込年月日以降
yyyyMMdd形式
service_application_date_to String 8 - サービス申込年月日To
入力値のサービス申込年月日以前
yyyyMMdd形式
service_end_application_date_from String 8 - サービス終了申込年月日From
入力値のサービス終了年月日以降
yyyyMMdd形式
service_end_application_date_to String 8 - サービス終了申込年月日To
入力値のサービス終了年月日以前
yyyyMMdd形式
cancel_date_from String 8 - キャンセル年月日From
入力値のキャンセル年月日以降
yyyyMMdd形式
cancel_date_to String 8 - キャンセル年月日To
入力値のキャンセル年月日以前
yyyyMMdd形式
service_code String 1

10
- サービスコード
商品IDとして使用
半角英数字またはハイフン、アンダーバーのみ入力可能
customer_id String 15 - 顧客ID
顧客を一意に識別するID
basic_contract_id String 15 - 基本契約ID
契約グループを一意に識別するID
bill_to_id String 15 - 請求先ID
請求先を一意に識別するID
order_number String 15 - 注文番号
contract_number String 15 - 契約番号
administration_number Long 1

999
- 管理番号
status String 1

59
- ステータス
ステータスを表す任意のコード値を設定可能
複数指定可。複数指定の場合、カンマ「,」を区切り文字として指定
例)001:契約中、999:解約済
service_contract_id String 15 - サービス契約ID
サービス契約を一意に識別するID
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 - ソート順1
sort_item2 String 1

40
- ソート項目名2
sort2 String 1 - ソート順2
sort_item3 String 1

40
- ソート項目名3
sort3 String 1 - ソート順3
start_position Long 1

9999999
- 開始位置
共通仕様はこちらを参照
end_position Long 1

9999999
- 終了位置
共通仕様はこちらを参照
charge_info_retrieval_flg String 1 - 料金情報取得有無フラグ

URI#

/API/v2/api/servicecontracts

Sample request uri#

基本契約IDとページング指定の開始位置と終了位置を指定しての検索

/API/v2/api/servicecontracts?basic_contract_id=test00000000011
                            &start_position=1&end_position=100  

Parameters in request body#

なし

Return Codes#

Code Description
200 レスポンスが正常の場合は処理成功。レスポンスが異常の場合は入力パラメータエラー。
401 認証エラー。API認証時のエラー。
403 アクセス不可
404 対象なし。対象の情報が見つからない場合。
500 業務不整合。整合性チェックエラー、またはその他のサーバー側のエラー。

Response Header#

なし

Response Parameter#

共通仕様はこちらを参照してください。

  • レスポンス(正常)

Example#

Parameters#

Top