보상유형관리

보상유형 등록/수정

post

기능설명

• 보상유형을 등록/수정 합니다.

---

상세설명

• 신규 보상유형을 등록하거나, 기존 보상유형을 수정 합니다.

• 보상기준이 기타일 경우 기준율에 텍스트 입력 가능 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

cpnsTypNoStringOptional

보상유형번호

cpnsTypNmStringOptional

보상유형명

useYnStringOptional

사용여부

sortSeqStringOptional

정렬순서

cpnsSubCdStringOptional

보상주체코드(CS017)

cpnsStdCdStringOptional

보상기준코드(CS018)

cpnsStdRateStringOptional

보상기준율

maxPayLimStringOptional

최대지급한도

cpnsStdDescStringOptional

보상기준설명

uprCpnsTypCdStringOptional

상위보상유형

Body

application/json

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v2/customerservice/rewardTypeMgmt/saveRewardTypeList

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/rewardTypeMgmt/saveRewardTypeList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 854

{
  "all": [
    {
      "cpnsTypNo": 10311,
      "cpnsTypNm": "기타보상100",
      "useYn": "Y",
      "sortSeq": 100,
      "cpnsSubCd": 10,
      "cpnsStdCd": 10,
      "cpnsStdRate": 10,
      "maxPayLim": 10000,
      "cpnsStdDesc": "보상기준설명내용",
      "uprCpnsTypCd": 10191
    }
  ],
  "create": [
    {
      "cpnsTypNo": 10311,
      "cpnsTypNm": "기타보상100",
      "useYn": "Y",
      "sortSeq": 100,
      "cpnsSubCd": 10,
      "cpnsStdCd": 10,
      "cpnsStdRate": 10,
      "maxPayLim": 10000,
      "cpnsStdDesc": "보상기준설명내용",
      "uprCpnsTypCd": 10191
    }
  ],
  "update": [
    {
      "cpnsTypNo": 10311,
      "cpnsTypNm": "기타보상100",
      "useYn": "Y",
      "sortSeq": 100,
      "cpnsSubCd": 10,
      "cpnsStdCd": 10,
      "cpnsStdRate": 10,
      "maxPayLim": 10000,
      "cpnsStdDesc": "보상기준설명내용",
      "uprCpnsTypCd": 10191
    }
  ],
  "delete": [
    {
      "cpnsTypNo": 10311,
      "cpnsTypNm": "기타보상100",
      "useYn": "Y",
      "sortSeq": 100,
      "cpnsSubCd": 10,
      "cpnsStdCd": 10,
      "cpnsStdRate": 10,
      "maxPayLim": 10000,
      "cpnsStdDesc": "보상기준설명내용",
      "uprCpnsTypCd": 10191
    }
  ]
}

{
  "timestamp": "2026-03-11T21:16:19.243Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

보상/지급 승인 권한 등록/수정/삭제

post

기능설명

• 보상/지급 승인 권한을 등록/수정/삭제 합니다.

---

상세설명

• 보상/지급 승인자 정보를 등록/수정/삭제 합니다.

• 보상 승인자는 최대 5명 까지 등록 가능합니다.

• 지급 승인자는 최대 5명 까지 등록 가능합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

cpnsAprmnGbCdStringRequired

보상승인자구분코드(CS024)

userIdStringRequired

사용자ID

userNmStringRequired

사용자명

Body

application/json

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v2/customerservice/rewardTypeMgmt/saveCustomemrCompenseAuthority

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/rewardTypeMgmt/saveCustomemrCompenseAuthority?cpnsAprmnGbCd=null&userId=null&userNm=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 286

{
  "all": [
    {
      "cpnsAprmnGbCd": 10,
      "userId": "x2beecc",
      "userNm": "삼당사"
    }
  ],
  "create": [
    {
      "cpnsAprmnGbCd": 10,
      "userId": "x2beecc",
      "userNm": "삼당사"
    }
  ],
  "update": [
    {
      "cpnsAprmnGbCd": 10,
      "userId": "x2beecc",
      "userNm": "삼당사"
    }
  ],
  "delete": [
    {
      "cpnsAprmnGbCd": 10,
      "userId": "x2beecc",
      "userNm": "삼당사"
    }
  ]
}

{
  "timestamp": "2026-03-11T21:16:19.243Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

권한별 보상금액한도 수정

post

기능설명

• 권한별 보상금액한도를 수정 합니다.

---

상세설명

• 권한별 현재 보상금액한도을 수정 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v2/customerservice/rewardTypeMgmt/changeCompensationAmountLimit

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/rewardTypeMgmt/changeCompensationAmountLimit HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 334

{
  "all": [
    {
      "grpCd": "CS025",
      "authCd": 10,
      "limitAmount": 50000,
      "newLimitAmount": 50000
    }
  ],
  "create": [
    {
      "grpCd": "CS025",
      "authCd": 10,
      "limitAmount": 50000,
      "newLimitAmount": 50000
    }
  ],
  "update": [
    {
      "grpCd": "CS025",
      "authCd": 10,
      "limitAmount": 50000,
      "newLimitAmount": 50000
    }
  ],
  "delete": [
    {
      "grpCd": "CS025",
      "authCd": 10,
      "limitAmount": 50000,
      "newLimitAmount": 50000
    }
  ]
}

{
  "timestamp": "2026-03-11T21:16:19.243Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

보상유형 목록(Tree) 조회

get

기능설명

• 보상유형 목록을 Tree 형태로 조회 합니다.

---

상세설명

• 조회된 보상유형 정보는 계층형 구조 입니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

useYnstringOptional

사용여부

Example: Y

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/rewardTypeMgmt/getRewardTypeList

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/rewardTypeMgmt/getRewardTypeList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-03-11T21:16:19.243Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "level": 1,
      "cpnsTypNo": "text",
      "cpnsTypNm": "text",
      "cpnsTypLrgNm": "text",
      "cpnsTypSmlNm": "text",
      "useYn": "text",
      "sortSeq": 1,
      "cpnsSubCd": "text",
      "cpnsSubNm": "text",
      "cpnsStdCd": "text",
      "cpnsStdNm": "text",
      "cpnsStdRate": "text",
      "maxPayLim": 1,
      "cpnsStdDesc": "text",
      "cpnsStdDescYn": "text",
      "uprCpnsTypCd": "text",
      "hierarchy": "text",
      "hierarchyText": "text",
      "useCnt": 1
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

하위 보상유형 목록 조회

get

기능설명

• 하위 보상유형 목록을 조회 합니다.

---

상세설명

• 선택한 보상유형에 속한 하위 보상유형을 조회 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

levelinteger · int32Optional

레벨

Example: 1

useYnstringOptional

사용여부

Example: Y

uprCpnsTypCdstringOptional

상위보상유형

Example: 10040

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/rewardTypeMgmt/getLowerRewardTypeList

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/rewardTypeMgmt/getLowerRewardTypeList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "level": 1,
      "cpnsTypNo": "text",
      "cpnsTypNm": "text",
      "cpnsTypLrgNm": "text",
      "cpnsTypSmlNm": "text",
      "useYn": "text",
      "sortSeq": 1,
      "cpnsSubCd": "text",
      "cpnsSubNm": "text",
      "cpnsStdCd": "text",
      "cpnsStdNm": "text",
      "cpnsStdRate": "text",
      "maxPayLim": 1,
      "cpnsStdDesc": "text",
      "cpnsStdDescYn": "text",
      "uprCpnsTypCd": "text",
      "hierarchy": "text",
      "hierarchyText": "text",
      "useCnt": 1
    }
  ]
}

보상/지급 승인자 정보를 조회

get

기능설명

• 보상/지급 승인자 정보를 조회 합니다.

---

상세설명

• 보상승인자, 지급승인자 정보를 조회 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

cpnsAprmnGbCdStringRequired

보상승인자구분코드

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/rewardTypeMgmt/getCustomerCompenseAuthority

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/rewardTypeMgmt/getCustomerCompenseAuthority?cpnsAprmnGbCd=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "cpnsAprmnGbCd": 10,
      "userId": "x2beecc",
      "userNm": "삼당사"
    }
  ]
}

모든 보상유형 조회

get

기능설명

• 모든 보상유형을 조회 합니다.

---

상세설명

• 보상유형조회 공통 팝업에서 사용 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

cpnsTypNmstringOptional

보상유형명

Example: 기타보상

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/rewardTypeMgmt/getCsCompensTypeCodePopup

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/rewardTypeMgmt/getCsCompensTypeCodePopup HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "level": 1,
      "cpnsTypNo": "text",
      "cpnsTypNm": "text",
      "cpnsTypLrgNm": "text",
      "cpnsTypSmlNm": "text",
      "useYn": "text",
      "sortSeq": 1,
      "cpnsSubCd": "text",
      "cpnsSubNm": "text",
      "cpnsStdCd": "text",
      "cpnsStdNm": "text",
      "cpnsStdRate": "text",
      "maxPayLim": 1,
      "cpnsStdDesc": "text",
      "cpnsStdDescYn": "text",
      "uprCpnsTypCd": "text",
      "hierarchy": "text",
      "hierarchyText": "text",
      "useCnt": 1
    }
  ]
}

권한별 보상금액한도 목록 조회

get

기능설명

• 권한별 보상금액한도 목록을 조회 합니다.

---

상세설명

• 권한별 현재 보상금액한도 목록을 조회 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

get

/v2/customerservice/rewardTypeMgmt/getCompensationAmountLimit

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/rewardTypeMgmt/getCompensationAmountLimit HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "grpCd": "CS025",
      "authCd": 10,
      "authCdDesc": "보상승인자",
      "limitAmount": 50000
    }
  ]
}