Ctrlk
X2BEE 바로가기
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
custCpnsAplyNoStringOptional

고객보상신청번호

cpnsAmtNoStringOptional

보상금액번호

promoNmStringOptional

쿠폰명

accpContStringOptional

접수내용

payReqMemoStringOptional

지급요청메모

payBankCdStringOptional

지급은행코드

payActnNoStringOptional

지급계좌번호

payDepositorNmStringOptional

지급예금주명

Body

고객보상 상세정보 수정 요청 DTO

cpnsMeanCdstringOptional

20

Example: 보상수단코드(CS019)
mbrNostringOptional

100000513

Example: 회원번호
custCpnsAplyNostringOptional

고객보상신청번호

Example: 10000901
cpnsAmtNostringOptional

보상금액번호

Example: C1003671
promoNmstringOptional

쿠폰명

Example: 고객보상 정액 50000원
accpContstringOptional

접수내용

Example: 보상접수내용 입니다.
payReqMemostringOptional

지급요청메모

Example: 지급요청바랍니다.
payBankCdstringOptional

지급은행코드

payActnNostringOptional

지급계좌번호

payDepositorNmstringOptional

지급예금주명

Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/customerCompensMgmt/updateCustomerCompensDetail
POST /api/bo/v2/customerservice/customerCompensMgmt/updateCustomerCompensDetail HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 301

{
  "cpnsMeanCd": "보상수단코드(CS019)",
  "mbrNo": "회원번호",
  "custCpnsAplyNo": 10000901,
  "cpnsAmtNo": "C1003671",
  "promoNm": "고객보상 정액 50000원",
  "accpCont": "보상접수내용 입니다.",
  "payReqMemo": "지급요청바랍니다.",
  "payBankCd": "text",
  "payActnNo": "text",
  "payDepositorNm": "text"
}
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 접수취소/반려

post

기능설명

  • 선택한 고객보상을 접수취소/반려 처리 합니다.

상세설명

  • 반려는 각 권한별 사용자만 처리 가능합니다.

  • 접수취소/반려 처리된 고객보상접수는 재 신청이 불가능하며 상담신청부터 다시 등록해야 합니다.

코드정리

  • 접수취소/반려 분류타입(type): 접수취소(C), 보상승인반려(A), 지급승인반려(B)

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

접수취소/반려 분류타입

Example: C
custCpnsAplyNostring[]Optional

고객보상신청번호

Example: 10000901
memostringOptional

반려사유

Example: 반려합니다.
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/customerCompensMgmt/returnCustomerCompensDetail
POST /api/bo/v2/customerservice/customerCompensMgmt/returnCustomerCompensDetail HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "type": "C",
  "custCpnsAplyNo": 10000901,
  "memo": "반려합니다."
}
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 지급승인 위한 상세정보 조회

post

기능설명

  • 고객보상 지급승인하기 위한 상세 정보를 조회 합니다.

상세설명

  • 선택한 고객보상신청번호, 고객보상분류타입에 해당하는 상세 정보를 조회 합니다.

코드정리

  • 고객보상분류타입(type): 보상승인(A), 지급승인(P)

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

고객보상 지급승인위한 상세정보 조회 요청 DTO

custCpnsAplyNoListstring[]Optional

고객보상신청번호 목록

Example: [10000901]
typestringOptional

고객보상분류타입

Example: A
Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

post/v2/customerservice/customerCompensMgmt/getCustomerCompensInfo
POST /api/bo/v2/customerservice/customerCompensMgmt/getCustomerCompensInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "custCpnsAplyNoList": [
    10000901
  ],
  "type": "A"
}
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "payActnNo": "text",
      "custCpnsAplyNo": "text",
      "ccnNo": "text",
      "cpnsTypNo": "text",
      "cpnsMeanCd": "text",
      "rspnGbCd": "text",
      "cpnsAprvStatCd": "text",
      "cpnsPayStatCd": "text",
      "mbrNo": "text",
      "accpDtm": "text",
      "accpCont": "text",
      "acptmnId": "text",
      "cpnsAmtNo": "text",
      "promoNm": "text",
      "aprvDtm": "text",
      "aprmnId": "text",
      "payReqMemo": "text",
      "retnDtm": "text",
      "retnProcmnId": "text",
      "payDtm": "text",
      "paymnId": "text",
      "payCont": "text",
      "payReqDtm": "text",
      "payBankCd": "text",
      "payDepositorNm": "text",
      "ordNo": "text",
      "goodsNo": "text",
      "retnCausCont": "text",
      "couponNo": "text",
      "mileage": "text",
      "giftNo": "text",
      "getUserNm": "text",
      "getUserCellNo": "text",
      "zipcode": "text",
      "zipcodeD": "text",
      "zipNo": "text",
      "payCpnsNo": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 승인처리

post

기능설명

  • 접수된 고객보상을 승인처리 합니다.

상세설명

  • 접수 > 보상승인 > 지급승인 단계로 처리됩니다.

  • 보상수단이 쿠폰, 마일리지일 경우 지급승인되면 지급상태는 지금완료 처리됩니다.

  • 보상수단이 현금일 경우 지급승인되면 지급상태는 지급대기로 처리되며 고객에게 입금완료 후 지급완료 처리됩니다.

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

고객보상 승인처리 요청 DTO

Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

post/v2/customerservice/customerCompensMgmt/approveCustomerCompensDetail
POST /api/bo/v2/customerservice/customerCompensMgmt/approveCustomerCompensDetail HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1152

{
  "request": [
    {
      "custCpnsAplyNo": "고객보상신청번호",
      "ccnNo": "상담번호",
      "cpnsTypNo": "보상유형번호",
      "cpnsMeanCd": "보상수단코드(CS019)",
      "rspnGbCd": "귀책구분코드(CS020)",
      "cpnsAprvStatCd": "보상승인상태코드(CS021)",
      "cpnsPayStatCd": "보상지급상태코드(CS020)",
      "mbrNo": "회원번호",
      "mbrNm": "회원명",
      "loginId": "회원ID",
      "accpDtm": "접수일시",
      "accpCont": "접수내용",
      "acptmnId": "접수자ID",
      "cpnsAmtNo": "보상금액번호",
      "promoNm": "프로모션명(쿠폰명)",
      "aprvDtm": "승인일시",
      "aprmnId": "승인자ID",
      "payReqMemo": "지급요청메모",
      "retnDtm": "반려일시",
      "retnProcmnId": "반려처리자ID",
      "payDtm": "지급일시",
      "paymnId": "지급자ID",
      "payCont": "지급내용",
      "payReqDtm": "지급요청일시",
      "payBankCd": "지급은행코드",
      "payActnNo": "지급계좌번호",
      "noEncryptPayActnNo": "지급계좌번호(복호화)",
      "payDepositorNm": "지급예금주명",
      "ordNo": "주문번호",
      "goodsNo": "상품번호",
      "retnCausCont": "반려사유내용",
      "couponNo": "쿠폰번호",
      "mileage": "마일리지",
      "request": "고객보상접수정보 요청 DTO",
      "custCpnsAplyNoList": "고객보상신청번호 목록"
    }
  ]
}
{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상관리 목록 조회

get

기능설명

  • 고객보상관리 목록을 조회 합니다.

상세설명

  • 선택한 조건에 대한 고객보상관리 목록을 조회 합니다.

수정번호

  • Release v2.00_240613: 기간 검색 조건 개선

  • Release v2.00_240827: V2 RealGridListResponse 변경

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

기간검색종류

Example: 0
startDatestring · dateOptional

시작일자

Example: 2023-07-01
endDatestring · dateOptional

종료일자

Example: 2023-09-15
rspnGbCdstring · enumOptional

귀책구분코드(CS020)

Example: 10Possible values:
cpnsTypNostringOptional

보상유형번호

Example: 10053
cpnsMeanCdstring · enumOptional

보상수단코드(CS019)

Example: 10Possible values:
mbrTypestringOptional

회원검색종류

Example: 1
loginIdstringOptional

회원ID

Example: kdh9110
cpnsAprvStatCdstring · enumOptional

보상승인상태코드(CS021)

Example: 10Possible values:
cpnsPayStatCdstring · enumOptional

보상지급상태코드(CS020)

Example: 10Possible values:
userTypestringOptional

처리자검색종류

Example: 1
userIdstringOptional

담당자ID

Example: x2beecc
businessTypestringOptional

업무타입

Example: 1
businessNumberstringOptional

업무번호

Example: 12345
siteNostringOptional

사이트번호

Example: 1
Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v2/customerservice/customerCompensMgmt/getCustomerCompensList
GET /api/bo/v2/customerservice/customerCompensMgmt/getCustomerCompensList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "custCpnsAplyNo": "text",
      "accpDtm": "text",
      "accpCont": "text",
      "cpnsAprvStatCd": "text",
      "cpnsAprvStatNm": "text",
      "cpnsPayStatCd": "text",
      "cpnsPayStatNm": "text",
      "cpnsTypNm": "text",
      "cpnsMeanCd": "text",
      "cpnsMeanNm": "text",
      "rspnGbCd": "text",
      "rspnGbNm": "text",
      "cpnsAmtNo": "text",
      "maxPayLim": "text",
      "overAmt": "text",
      "ccnNo": "text",
      "ordNo": "text",
      "goodsNo": "text",
      "goodsNm": "text",
      "itmNm": "text",
      "loginId": "text",
      "mbrNm": "text",
      "mbrNo": "text",
      "entrNm": "text",
      "acptmnId": "text",
      "aprvDtm": "text",
      "aprmnId": "text",
      "retnDtm": "text",
      "retnProcmnId": "text",
      "payDtm": "text",
      "paymnId": "text",
      "payCont": "text",
      "payReqMemo": "text",
      "payBankCd": "text",
      "payActnNo": "text",
      "payDepositorNm": "text",
      "siteNm": "text"
    }
  ]
}

고객보상 상세 정보 조회

get

기능설명

  • 고객보상 상세 정보를 조회 합니다.

상세설명

  • 선택한 고객보상 상세정보를 조회 합니다.

수정번호

  • Release v2.00_240905: 고객 보상 대분류 조회 추가

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

고객보상신청번호

Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

get/v2/customerservice/customerCompensMgmt/getCustomerCompensDetailSaveView
GET /api/bo/v2/customerservice/customerCompensMgmt/getCustomerCompensDetailSaveView?custCpnsAplyNo=null 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": {
    "csCompensDetailResponse": {
      "custCpnsAplyNo": "text",
      "mbrNm": "text",
      "mbrNo": "text",
      "loginId": "text",
      "ccnNo": "text",
      "ordNo": "text",
      "otherCount": 1,
      "goodsNo": "text",
      "goodsNm": "text",
      "promoNm": "text",
      "cpnsMeanCd": "text",
      "cpnsTypNm": "text",
      "cpnsTypLrgNm": "text",
      "rspnGbCd": "text",
      "standard": "text",
      "maxPayLim": 1,
      "cpnsAmtNo": "text",
      "payBankCd": "text",
      "payDepositorNm": "text",
      "payActnNo": "text",
      "cpnsAprvStatCd": "text",
      "cpnsAprvStatNm": "text",
      "cpnsPayStatCd": "text",
      "cpnsPayStatNm": "text",
      "accpCont": "text",
      "payReqMemo": "text",
      "acptmnId": "text",
      "accpDtm": "text",
      "aprmnId": "text",
      "aprvDtm": "text",
      "retnProcmnId": "text",
      "retnDtm": "text",
      "paymnId": "text",
      "payDtm": "text",
      "retnCausCont": "text",
      "dcRateAmt": 1,
      "cpnsConts": "text"
    },
    "loginId": "text",
    "codeList": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "grpCd": "ME001",
          "cd": 11,
          "cdNm": "상품즉시할인",
          "cdDesc": "다국어 코드설명",
          "useYn": "Y",
          "sortSeq": 1,
          "ref1Val": "기준코드 참조1값에 대한 설명",
          "ref2Val": "기준코드 참조2값에 대한 설명",
          "ref3Val": "기준코드 참조3값에 대한 설명",
          "ref4Val": "기준코드 참조4값에 대한 설명",
          "ref5Val": "기준코드 참조5값에 대한 설명",
          "ref6Val": "기준코드 참조6값에 대한 설명",
          "ref7Val": "기준코드 참조7값에 대한 설명"
        }
      ]
    },
    "csCpGradeAmtCode": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "grpCd": "ME001",
          "cd": 11,
          "cdNm": "상품즉시할인",
          "cdDesc": "다국어 코드설명",
          "useYn": "Y",
          "sortSeq": 1,
          "ref1Val": "기준코드 참조1값에 대한 설명",
          "ref2Val": "기준코드 참조2값에 대한 설명",
          "ref3Val": "기준코드 참조3값에 대한 설명",
          "ref4Val": "기준코드 참조4값에 대한 설명",
          "ref5Val": "기준코드 참조5값에 대한 설명",
          "ref6Val": "기준코드 참조6값에 대한 설명",
          "ref7Val": "기준코드 참조7값에 대한 설명"
        }
      ]
    },
    "csCpUserGrade": "text",
    "csCpUserGradeOfAcptmId": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

고객보상 접수자 권한 조회

get

기능설명

  • 고객보상 접수자의 권한을 조회 합니다.

상세설명

  • 고객보상을 접수한 삼당원의 권한을 조회 합니다.

  • N:없음 A:승인요청자 , P:지급승인자 , All:승인요청자 & 지급승인자

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

로그인한 상담사ID

Responses
200

성공

*/*
timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

get/v2/customerservice/customerCompensMgmt/getCsCompensUserGrade
GET /api/bo/v2/customerservice/customerCompensMgmt/getCsCompensUserGrade?loginId=null 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": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}
이전1:1문의유형관리
다음고객서비스 공지사항

마지막 업데이트