割引契約を編集する

Description

入力情報をもとに割引契約の登録や変更、削除を行います。本APIにより、「割引契約情報」の登録や変更が行えます。
本APIの実行前に、「基本契約を編集する」、「サービス料金情報を編集する」(料金計算API参照)で基本契約情報、サービスマスタ情報、料金プランマスタ情報を登録した上で、割引を適用する「サービス契約情報」を 登録する必要があります。

Method

POST

Request Header

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

Argument

なし

URI

/API/v2/api/discountcontracts

Parameters in request body

共通仕様はこちらを参照してください。
下記の例には一部項目を記載しています。全項目の詳細は表を参照してください。

Example

▼ Exampleを展開

{
    "entry_id":"O00000000000001",
    "customer_id":"123456789012345",
    "administration_number":"1",
    "order_number_get_flag":"1",
    "contract_number_get_flag":"1",
    "individualized_service_contract_edition_list":
        [
        {   
            "service_code":"C000000003",
            "service_application_date":"20180226",
            "apply_start_month":"201804",
            "bill_to_id":"000000000000011",
            "free_item":{
                "free_item":"任意項目"
            },
            "free_item1":"任意項目１",
            "free_item2":"任意項目２",
            "free_item3":"任意項目３",
            "free_item4":"任意項目４",
            "free_item5":"任意項目５",
            "free_item6":"任意項目６",
            "free_item7":"任意項目７",
            "free_item8":"任意項目８",
            "free_item9":"任意項目９",
            "free_item10":"任意項目１０",
            "discount_target_entry_information_list":[{
                "service_contract_id":"000000000000062",
                "price_plan_code":"plancode1"
            }]
        }       
        ]
}

Parameters

▼ Request Bodyを展開

Name			Type	Required	Length （Long /Decimalの場合はValue）	Description
entry_id			String	Yes	1 ～ 15	登録者ＩＤ 登録の処理を行ったユーザーのID
customer_id			String	Yes	15	顧客ＩＤ 顧客を一意に識別するＩＤ
order_number			String		15	注文番号
contract_number			String		15	契約番号
administration_number			Long	Yes	1 ～ 999	管理番号
order_number_get_flag			String		1	注文番号採番フラグ
contract_number_get_flag			String		1	契約番号採番フラグ
individualized_service_contract_edition_list			list		Multiple	個別サービス契約編集リスト
	version_info		Long		1 ～ 999999999	バージョン情報 変更、削除時必須 共通仕様はこちらを参照
	discount_contract_id		String		15	割引契約ＩＤ 割引契約を一意に識別するＩＤ 変更、削除時必須
	service_code		String	Yes	10	サービスコード 商品ＩＤとして使用 半角英数字またはハイフン、アンダーバーのみ入力可能
	service_application_date		String		8	サービス申込年月日 顧客がサービスを申し込んだ年月日 実際にサービス提供を行う日付とは異なる 登録、変更時必須 yyyyMMdd形式
	service_end_application_date		String		8	サービス終了申込年月日 顧客がサービス終了を申し込んだ年月日 実際にサービス提供が終了する日付とは異なる yyyyMMdd形式
	apply_start_month		String		6	適用開始年月 サービスの適用を開始する年月日（当日を含む） yyyyMM形式 変更時必須
	apply_end_month		String		6	適用終了年月 サービスの適用を終了する年月日（当日を含む） yyyyMM形式
	bill_to_id		String	Yes	15	請求先ＩＤ 請求先を一意に識別するＩＤ
	status		String		1 ～ 3	ステータス ステータスを表す任意のコード値を設定可能 例)001：契約中、999：解約済
	free_item		String		0 ～ 30000	フリー項目
	free_item1		String		0 ～ 1000	フリー項目１
	free_item2		String		0 ～ 1000	フリー項目２
	free_item3		String		0 ～ 1000	フリー項目３
	free_item4		String		0 ～ 1000	フリー項目４
	free_item5		String		0 ～ 1000	フリー項目５
	free_item6		String		0 ～ 1000	フリー項目６
	free_item7		String		0 ～ 1000	フリー項目７
	free_item8		String		0 ～ 1000	フリー項目８
	free_item9		String		0 ～ 1000	フリー項目９
	free_item10		String		0 ～ 1000	フリー項目１０
	deletion_targeted_flag		String		1	削除対象フラグ 削除時、削除対象のデータに設定
	discount_target_entry_information_list		list		Single	割引対象情報リスト 登録時必須
		service_contract_id	String	Yes	15	サービス契約ＩＤ サービス契約を一意に識別するＩＤ
		price_plan_code	String	Yes	9	料金プランコード

Return Codes

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

Response Header

なし

Response Parameter

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

• レスポンス（正常）

Example

▼ Exampleを展開

{
    "order_number":"000000000000060",
    "contract_number":"000000000000059",
    "result_information":{
        "result":"OK"
    },
    "discountcontract_id_information_list":[{
        "discount_contract_id":"000000000000325"
    }]
}

Parameters

▼ Responseを展開

Name		Type	Required	Length （Long /Decimalの場合はValue）	Description
order_number		String	Yes	15	注文番号
contract_number		String		15	契約番号
result_information		list		Single	結果情報
	result	String		2	結果 OKまたはNGを返却
	detailed_result	String		1 ～ 256	結果詳細 NGの場合、エラー内容を返却
servicecontract_id_information_list		list		Multiple	サービス契約ＩＤ情報リスト
	service_contract_id	String	Yes	15	サービス契約ＩＤ サービス契約を一意に識別するＩＤ
discountcontract_id_information_list		list		Multiple	割引契約ＩＤ情報リスト
	discount_contract_id	String	Yes	15	割引契約ＩＤ 割引契約を一意に識別するＩＤ

• レスポンス（異常）
  共通エラー情報を参照してください。

Top