본문으로 건너뛰기
For the complete documentation index, see llms.txt. This page is also available as Markdown.

보상유형관리

보상유형 등록/수정

post

기능설명

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


상세설명

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

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
cpnsTypNoStringOptional

보상유형번호

cpnsTypNmStringOptional

보상유형명

useYnStringOptional

사용여부

sortSeqStringOptional

정렬순서

cpnsSubCdStringOptional

보상주체코드(CS017)

cpnsStdCdStringOptional

보상기준코드(CS018)

cpnsStdRateStringOptional

보상기준율

maxPayLimStringOptional

최대지급한도

cpnsStdDescStringOptional

보상기준설명

uprCpnsTypCdStringOptional

상위보상유형

Body
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/rewardTypeMgmt/saveRewardTypeList
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-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

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

post

기능설명

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


상세설명

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

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

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
cpnsAprmnGbCdStringRequired

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

userIdStringRequired

사용자ID

userNmStringRequired

사용자명

Body
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/rewardTypeMgmt/saveCustomemrCompenseAuthority
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-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

권한별 보상금액한도 수정

post

기능설명

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


상세설명

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/rewardTypeMgmt/changeCompensationAmountLimit
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-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

보상유형 목록(Tree) 조회

get

기능설명

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


상세설명

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
useYnstringOptional

사용여부

Example: Y
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v2/customerservice/rewardTypeMgmt/getRewardTypeList
GET /api/bo/v2/customerservice/rewardTypeMgmt/getRewardTypeList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
levelinteger · int32Optional

레벨

Example: 1
useYnstringOptional

사용여부

Example: Y
uprCpnsTypCdstringOptional

상위보상유형

Example: 10040
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/rewardTypeMgmt/getLowerRewardTypeList
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
cpnsAprmnGbCdStringRequired

보상승인자구분코드

Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/rewardTypeMgmt/getCustomerCompenseAuthority
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
cpnsTypNmstringOptional

보상유형명

Example: 기타보상
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/rewardTypeMgmt/getCsCompensTypeCodePopup
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/rewardTypeMgmt/getCompensationAmountLimit
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
    }
  ]
}

마지막 업데이트