pop-parent 介面文件

更新時間：2026-04-29 16:23:12

儲存線上自訂續約套餐資訊

介面位址

POST /pcs/v1/customer/online-custom-package/save

介面說明

儲存線上自訂續約套餐資訊，並發起後續審批流程。

請求頭

Content-Type: application/json

請求參數

欄位名	類型	必填	說明
`id`	`Long`	否	為空表示新增，有值表示修改
`customerId`	`String`	是	客戶 ID
`status`	`String`	是	狀態，建議傳 `audit`
`ext`	`String`	是	自訂套餐詳情 JSON 字串
`createUserId`	`String`	否	前端無需傳，系統自動取當前登入人 `saleUserId`

說明：

如果當前登入使用者 saleUserId 為空，介面會直接報錯。
實際儲存時，下游會將狀態重設為 audit。
如果該客戶已存在 audit 或 pass 狀態記錄，不允許再次提交。

ext 欄位結構

ext 是一個 JSON 字串，對應 OnlinePackageVO。

公共欄位：

欄位名	類型	說明
`packageName`	`String`	套餐名稱
`packageId`	`Long`	套餐 ID
`businessType`	`String`	業務類型，`live` 或 `vod`
`amount`	`Long`	套餐金額
`businessStartTime`	`Date`	業務開始時間
`businessEndTime`	`Date`	業務結束時間
`billingPlanCode`	`String`	計費方式編碼
`cooperationSubject`	`String`	合作主體

直播相關欄位：

欄位名	類型	說明
`livePackageMinutesQuantity`	`Long`	直播分鐘數
`liveConcurrentQuantity`	`Long`	直播並發值
`liveConcurrentIsLimit`	`Short`	是否限制並發
`liveConcurrentDuration`	`Long`	直播並發購買時長
`liveConcurrentDurationUnit`	`String`	直播並發購買時長單位

點播相關欄位：

欄位名	類型	說明
`vodSpace`	`Long`	點播空間
`vodFlow`	`Long`	點播流量
`vodPackageType`	`String`	點播套餐類型編碼
`vodPackageIsAnnualFlow`	`Short`	是否年流量套餐
`vodPackageFlowMonthsOfYear`	`Integer`	年流量月數

請求範例

{
  "customerId": "821775ea6c",
  "status": "audit",
  "ext": "{\"packageName\":\"直播定制套餐\",\"packageId\":1001,\"businessType\":\"live\",\"amount\":120000,\"businessStartTime\":\"2026-05-01 00:00:00\",\"businessEndTime\":\"2027-04-30 23:59:59\",\"billingPlanCode\":\"live_duration\",\"cooperationSubject\":\"0\",\"livePackageMinutesQuantity\":50000}"
}

回傳結構

回傳類型：ResponseVO<OnlineCustomPackageVO>

ResponseVO 欄位

欄位名	類型	說明
`code`	`Integer`	狀態碼，成功一般為 `200`
`status`	`String`	`success` / `error`
`requestId`	`String`	請求 ID
`error`	`Object`	失敗資訊
`data`	`OnlineCustomPackageVO`	回傳資料

OnlineCustomPackageVO 欄位

欄位名	類型	說明
`id`	`Long`	主鍵
`customerId`	`String`	客戶 ID
`status`	`String`	狀態
`ext`	`String`	套餐詳情 JSON 字串
`createUserId`	`String`	建立人 ID
`createTime`	`Date`	建立時間
`updateTime`	`Date`	更新時間

成功回傳範例

{
  "code": 200,
  "status": "success",
  "data": {
    "id": 12,
    "customerId": "821775ea6c",
    "status": "audit",
    "ext": "{\"packageName\":\"直播定制套餐\"}",
    "createUserId": "sale123",
    "createTime": "2026-04-29T16:00:00+08:00",
    "updateTime": "2026-04-29T16:00:00+08:00"
  }
}

失敗回傳範例

{
  "code": 400,
  "status": "error",
  "error": {
    "code": 400,
    "desc": "当前登录用户saleUserId为空，不允许提交"
  }
}