# 고객보상관리

## 고객보상 상세 정보 수정

> \## 기능설명\
> \* 고객보상 상세 정보를 수정 합니다.\
> \---\
> \## 상세설명\
> \* 고객보상수단(쿠폰): 승인상태가 접수 일 때 수정 가능 합니다.\
> \* 고객보상수단(현금): 승인상태가 접수 일 때 수정 가능 합니다.\
> \* 고객보상수단(마일리지): 승인상태 접수 일 때 수정 가능 합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"UpdateCustomerCompensDetailRequest":{"type":"object","description":"고객보상 상세정보 수정 요청 DTO","properties":{"cpnsMeanCd":{"type":"string","description":"20"},"mbrNo":{"type":"string","description":"100000513"},"custCpnsAplyNo":{"type":"string","description":"고객보상신청번호"},"cpnsAmtNo":{"type":"string","description":"보상금액번호"},"promoNm":{"type":"string","description":"쿠폰명"},"accpCont":{"type":"string","description":"접수내용"},"payReqMemo":{"type":"string","description":"지급요청메모"},"payBankCd":{"type":"string","description":"지급은행코드"},"payActnNo":{"type":"string","description":"지급계좌번호"},"payDepositorNm":{"type":"string","description":"지급예금주명"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/customerCompensMgmt/updateCustomerCompensDetail":{"post":{"tags":["고객보상관리"],"summary":"고객보상 상세 정보 수정","description":"## 기능설명\n* 고객보상 상세 정보를 수정 합니다.\n---\n## 상세설명\n* 고객보상수단(쿠폰): 승인상태가 접수 일 때 수정 가능 합니다.\n* 고객보상수단(현금): 승인상태가 접수 일 때 수정 가능 합니다.\n* 고객보상수단(마일리지): 승인상태 접수 일 때 수정 가능 합니다.\n","operationId":"updateCustomerCompensDetail","parameters":[{"name":"custCpnsAplyNo","in":"query","description":"고객보상신청번호","schema":{"type":"String"}},{"name":"cpnsAmtNo","in":"query","description":"보상금액번호","schema":{"type":"String"}},{"name":"promoNm","in":"query","description":"쿠폰명","schema":{"type":"String"}},{"name":"accpCont","in":"query","description":"접수내용","schema":{"type":"String"}},{"name":"payReqMemo","in":"query","description":"지급요청메모","schema":{"type":"String"}},{"name":"payBankCd","in":"query","description":"지급은행코드","schema":{"type":"String"}},{"name":"payActnNo","in":"query","description":"지급계좌번호","schema":{"type":"String"}},{"name":"payDepositorNm","in":"query","description":"지급예금주명","schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCustomerCompensDetailRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 고객보상 접수취소/반려

> \## 기능설명\
> \* 선택한 고객보상을 접수취소/반려 처리 합니다.\
> \---\
> \## 상세설명\
> \* 반려는 각 권한별 사용자만 처리 가능합니다.\
> \* 접수취소/반려 처리된 고객보상접수는 재 신청이 불가능하며 상담신청부터 다시 등록해야 합니다.\
> \## 코드정리\
> \* 접수취소/반려 분류타입(type): 접수취소(C), 보상승인반려(A), 지급승인반려(B)<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CsCompensReturnRequestV2":{"type":"object","properties":{"type":{"type":"string","description":"접수취소/반려 분류타입"},"custCpnsAplyNo":{"type":"array","description":"고객보상신청번호","items":{"type":"string"}},"memo":{"type":"string","description":"반려사유"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/customerCompensMgmt/returnCustomerCompensDetail":{"post":{"tags":["고객보상관리"],"summary":"고객보상 접수취소/반려","description":"## 기능설명\n* 선택한 고객보상을 접수취소/반려 처리 합니다.\n---\n## 상세설명\n* 반려는 각 권한별 사용자만 처리 가능합니다.\n* 접수취소/반려 처리된 고객보상접수는 재 신청이 불가능하며 상담신청부터 다시 등록해야 합니다.\n## 코드정리\n* 접수취소/반려 분류타입(type): 접수취소(C), 보상승인반려(A), 지급승인반려(B)\n","operationId":"returnCustomerCompensDetail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CsCompensReturnRequestV2"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

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

> \## 기능설명\
> \* 고객보상 지급승인하기 위한 상세 정보를 조회 합니다.\
> \---\
> \## 상세설명\
> \* 선택한 고객보상신청번호, 고객보상분류타입에 해당하는 상세 정보를 조회 합니다.\
> \## 코드정리\
> \* 고객보상분류타입(type): 보상승인(A), 지급승인(P)<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GetCustomerCompensInfoRequest":{"type":"object","description":"고객보상 지급승인위한 상세정보 조회 요청 DTO","properties":{"custCpnsAplyNoList":{"type":"array","description":"고객보상신청번호 목록","items":{"type":"string"}},"type":{"type":"string","description":"고객보상분류타입"}}},"ResponseListCsCustomerCompensAcceptInfo":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/CsCustomerCompensAcceptInfo"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CsCustomerCompensAcceptInfo":{"type":"object","properties":{"payActnNo":{"type":"string"},"custCpnsAplyNo":{"type":"string"},"ccnNo":{"type":"string"},"cpnsTypNo":{"type":"string"},"cpnsMeanCd":{"type":"string"},"rspnGbCd":{"type":"string"},"cpnsAprvStatCd":{"type":"string"},"cpnsPayStatCd":{"type":"string"},"mbrNo":{"type":"string"},"accpDtm":{"type":"string"},"accpCont":{"type":"string"},"acptmnId":{"type":"string"},"cpnsAmtNo":{"type":"string"},"promoNm":{"type":"string"},"aprvDtm":{"type":"string"},"aprmnId":{"type":"string"},"payReqMemo":{"type":"string"},"retnDtm":{"type":"string"},"retnProcmnId":{"type":"string"},"payDtm":{"type":"string"},"paymnId":{"type":"string"},"payCont":{"type":"string"},"payReqDtm":{"type":"string"},"payBankCd":{"type":"string"},"payDepositorNm":{"type":"string"},"ordNo":{"type":"string"},"goodsNo":{"type":"string"},"retnCausCont":{"type":"string"},"couponNo":{"type":"string"},"mileage":{"type":"string"},"giftNo":{"type":"string"},"getUserNm":{"type":"string"},"getUserCellNo":{"type":"string"},"zipcode":{"type":"string"},"zipcodeD":{"type":"string"},"zipNo":{"type":"string"},"payCpnsNo":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/customerCompensMgmt/getCustomerCompensInfo":{"post":{"tags":["고객보상관리"],"summary":"고객보상 지급승인 위한 상세정보 조회","description":"## 기능설명\n* 고객보상 지급승인하기 위한 상세 정보를 조회 합니다.\n---\n## 상세설명\n* 선택한 고객보상신청번호, 고객보상분류타입에 해당하는 상세 정보를 조회 합니다.\n## 코드정리\n* 고객보상분류타입(type): 보상승인(A), 지급승인(P)\n","operationId":"getCustomerCompensInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCustomerCompensInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListCsCustomerCompensAcceptInfo"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 고객보상 승인처리

> \## 기능설명\
> \* 접수된 고객보상을 승인처리 합니다.\
> \---\
> \## 상세설명\
> \* 접수 > 보상승인 > 지급승인 단계로 처리됩니다.\
> \* 보상수단이 쿠폰, 마일리지일 경우 지급승인되면 지급상태는 지금완료 처리됩니다.\
> \* 보상수단이 현금일 경우 지급승인되면 지급상태는 지급대기로 처리되며 고객에게 입금완료 후 지급완료 처리됩니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ApproveCustomerCompensDetailRequestV2":{"type":"object","description":"고객보상 승인처리 요청 DTO","properties":{"request":{"type":"array","description":"고객보상접수정보","items":{"$ref":"#/components/schemas/CsCustomerCompensAcceptInfoRequest"}}}},"CsCustomerCompensAcceptInfoRequest":{"type":"object","description":"고객보상접수정보 요청 DTO","properties":{"custCpnsAplyNo":{"type":"string","description":"10000911"},"ccnNo":{"type":"string","description":"10004891"},"cpnsTypNo":{"type":"string"},"cpnsMeanCd":{"type":"string","description":"20"},"rspnGbCd":{"type":"string"},"cpnsAprvStatCd":{"type":"string","description":"30"},"cpnsPayStatCd":{"type":"string"},"mbrNo":{"type":"string","description":"100000513"},"mbrNm":{"type":"string"},"loginId":{"type":"string","description":"kdh9110"},"accpDtm":{"type":"string","description":"승인 바랍니다."},"accpCont":{"type":"string"},"acptmnId":{"type":"string","description":"x2beecc"},"cpnsAmtNo":{"type":"string","description":"100000"},"promoNm":{"type":"string"},"aprvDtm":{"type":"string"},"aprmnId":{"type":"string"},"payReqMemo":{"type":"string","description":"승인 요청합니다."},"retnDtm":{"type":"string"},"retnProcmnId":{"type":"string"},"payDtm":{"type":"string"},"paymnId":{"type":"string"},"payCont":{"type":"string"},"payReqDtm":{"type":"string"},"payBankCd":{"type":"string"},"payActnNo":{"type":"string","description":"110999988888"},"noEncryptPayActnNo":{"type":"string","description":"110999988888"},"payDepositorNm":{"type":"string","description":"홍길동"},"ordNo":{"type":"string","description":"20230718O002626"},"goodsNo":{"type":"string"},"retnCausCont":{"type":"string"},"couponNo":{"type":"string"},"mileage":{"type":"string"},"request":{"$ref":"#/components/schemas/CsCustomerCompensAcceptInfoRequest"},"custCpnsAplyNoList":{"type":"array","items":{"type":"string"}}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/customerCompensMgmt/approveCustomerCompensDetail":{"post":{"tags":["고객보상관리"],"summary":"고객보상 승인처리","description":"## 기능설명\n* 접수된 고객보상을 승인처리 합니다.\n---\n## 상세설명\n* 접수 > 보상승인 > 지급승인 단계로 처리됩니다.\n* 보상수단이 쿠폰, 마일리지일 경우 지급승인되면 지급상태는 지금완료 처리됩니다.\n* 보상수단이 현금일 경우 지급승인되면 지급상태는 지급대기로 처리되며 고객에게 입금완료 후 지급완료 처리됩니다.\n","operationId":"approveCustomerCompensDetail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveCustomerCompensDetailRequestV2"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 고객보상관리 목록 조회

> \## 기능설명\
> \* 고객보상관리 목록을 조회 합니다.\
> \---\
> \## 상세설명\
> \* 선택한 조건에 대한 고객보상관리 목록을 조회 합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선\
> \* Release v2.00\_240827: V2 RealGridListResponse 변경<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridListResponseCsCustomerCompensResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CsCustomerCompensResponse"}}}},"CsCustomerCompensResponse":{"type":"object","properties":{"custCpnsAplyNo":{"type":"string"},"accpDtm":{"type":"string"},"accpCont":{"type":"string"},"cpnsAprvStatCd":{"type":"string"},"cpnsAprvStatNm":{"type":"string"},"cpnsPayStatCd":{"type":"string"},"cpnsPayStatNm":{"type":"string"},"cpnsTypNm":{"type":"string"},"cpnsMeanCd":{"type":"string"},"cpnsMeanNm":{"type":"string"},"rspnGbCd":{"type":"string"},"rspnGbNm":{"type":"string"},"cpnsAmtNo":{"type":"string"},"maxPayLim":{"type":"string"},"overAmt":{"type":"string"},"ccnNo":{"type":"string"},"ordNo":{"type":"string"},"goodsNo":{"type":"string"},"goodsNm":{"type":"string"},"itmNm":{"type":"string"},"loginId":{"type":"string"},"mbrNm":{"type":"string"},"mbrNo":{"type":"string"},"entrNm":{"type":"string"},"acptmnId":{"type":"string"},"aprvDtm":{"type":"string"},"aprmnId":{"type":"string"},"retnDtm":{"type":"string"},"retnProcmnId":{"type":"string"},"payDtm":{"type":"string"},"paymnId":{"type":"string"},"payCont":{"type":"string"},"payReqMemo":{"type":"string"},"payBankCd":{"type":"string"},"payActnNo":{"type":"string"},"payDepositorNm":{"type":"string"},"siteNm":{"type":"string"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/customerCompensMgmt/getCustomerCompensList":{"get":{"tags":["고객보상관리"],"summary":"고객보상관리 목록 조회","description":"## 기능설명\n* 고객보상관리 목록을 조회 합니다.\n---\n## 상세설명\n* 선택한 조건에 대한 고객보상관리 목록을 조회 합니다.\n---\n## 수정번호\n* Release v2.00_240613: 기간 검색 조건 개선\n* Release v2.00_240827: V2 RealGridListResponse 변경\n","operationId":"getCsCounselTemplateInfoList","parameters":[{"name":"periodType","in":"query","description":"기간검색종류","required":false,"schema":{"type":"string","description":"기간검색종류"}},{"name":"startDate","in":"query","description":"시작일자","required":false,"schema":{"type":"string","format":"date","description":"시작일자"}},{"name":"endDate","in":"query","description":"종료일자","required":false,"schema":{"type":"string","format":"date","description":"종료일자"}},{"name":"rspnGbCd","in":"query","description":"귀책구분코드(CS020)","required":false,"schema":{"type":"string","description":"귀책구분코드(CS020)","enum":["CUSTOMER","COMPANY","CONSIGNMENT_COMPANY"]}},{"name":"cpnsTypNo","in":"query","description":"보상유형번호","required":false,"schema":{"type":"string","description":"보상유형번호"}},{"name":"cpnsMeanCd","in":"query","description":"보상수단코드(CS019)","required":false,"schema":{"type":"string","description":"보상수단코드(CS019)","enum":["COUPON","CASH","MILEAGE","GIFT"]}},{"name":"mbrType","in":"query","description":"회원검색종류","required":false,"schema":{"type":"string","description":"회원검색종류"}},{"name":"loginId","in":"query","description":"회원ID","required":false,"schema":{"type":"string","description":"회원ID"}},{"name":"cpnsAprvStatCd","in":"query","description":"보상승인상태코드(CS021)","required":false,"schema":{"type":"string","description":"보상승인상태코드(CS021)","enum":["RECEIPT","CANCEL","REWARD_APPROVAL","REWARD_RETURN","PAYMENT_APPROVAL","PAYMENT_RETURN"]}},{"name":"cpnsPayStatCd","in":"query","description":"보상지급상태코드(CS020)","required":false,"schema":{"type":"string","description":"보상지급상태코드(CS020)","enum":["CUSTOMER","COMPANY","CONSIGNMENT_COMPANY"]}},{"name":"userType","in":"query","description":"처리자검색종류","required":false,"schema":{"type":"string","description":"처리자검색종류"}},{"name":"userId","in":"query","description":"담당자ID","required":false,"schema":{"type":"string","description":"담당자ID"}},{"name":"businessType","in":"query","description":"업무타입","required":false,"schema":{"type":"string","description":"업무타입"}},{"name":"businessNumber","in":"query","description":"업무번호","required":false,"schema":{"type":"string","description":"업무번호"}},{"name":"siteNo","in":"query","description":"사이트번호","required":false,"schema":{"type":"string","description":"사이트번호"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCsCustomerCompensResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 고객보상 상세 정보 조회

> \## 기능설명\
> \* 고객보상 상세 정보를 조회 합니다.\
> \---\
> \## 상세설명\
> \* 선택한 고객보상 상세정보를 조회 합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240905: 고객 보상 대분류 조회 추가<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseCustomerCompensDetailSaveViewResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/CustomerCompensDetailSaveViewResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CustomerCompensDetailSaveViewResponse":{"type":"object","description":"고객보상 상세 화면 응답 DTO","properties":{"csCompensDetailResponse":{"$ref":"#/components/schemas/CsCompensDetailResponse","description":"고객보상상세정보 응답 DTO"},"loginId":{"type":"string","description":"로그인한 사용자ID"},"codeList":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"공통코드리스트"},"csCpGradeAmtCode":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"보상금액결제한도(CS025)"},"csCpUserGrade":{"type":"string","description":"로그인한 사용자 권한"},"csCpUserGradeOfAcptmId":{"type":"string","description":"고객보상 접수자 권한"}}},"CsCompensDetailResponse":{"type":"object","properties":{"custCpnsAplyNo":{"type":"string"},"mbrNm":{"type":"string"},"mbrNo":{"type":"string"},"loginId":{"type":"string"},"ccnNo":{"type":"string"},"ordNo":{"type":"string"},"otherCount":{"type":"integer","format":"int32"},"goodsNo":{"type":"string"},"goodsNm":{"type":"string"},"promoNm":{"type":"string"},"cpnsMeanCd":{"type":"string"},"cpnsTypNm":{"type":"string"},"cpnsTypLrgNm":{"type":"string"},"rspnGbCd":{"type":"string"},"standard":{"type":"string"},"maxPayLim":{"type":"integer","format":"int32"},"cpnsAmtNo":{"type":"string"},"payBankCd":{"type":"string"},"payDepositorNm":{"type":"string"},"payActnNo":{"type":"string"},"cpnsAprvStatCd":{"type":"string"},"cpnsAprvStatNm":{"type":"string"},"cpnsPayStatCd":{"type":"string"},"cpnsPayStatNm":{"type":"string"},"accpCont":{"type":"string"},"payReqMemo":{"type":"string"},"acptmnId":{"type":"string"},"accpDtm":{"type":"string"},"aprmnId":{"type":"string"},"aprvDtm":{"type":"string"},"retnProcmnId":{"type":"string"},"retnDtm":{"type":"string"},"paymnId":{"type":"string"},"payDtm":{"type":"string"},"retnCausCont":{"type":"string"},"dcRateAmt":{"type":"number"},"cpnsConts":{"type":"string"}}},"StStdCd":{"type":"object","description":"그룹코드 조회/등록/수정 Request","properties":{"grpCd":{"type":"string","description":"그룹코드"},"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"useYn":{"type":"string","description":"사용여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값 설명"},"ref2Val":{"type":"string","description":"참조2값 설명"},"ref3Val":{"type":"string","description":"참조3값 설명"},"ref4Val":{"type":"string","description":"참조4값 설명"},"ref5Val":{"type":"string","description":"참조5값 설명"},"ref6Val":{"type":"string","description":"참조6값 설명"},"ref7Val":{"type":"string","description":"참조7값 설명"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/customerCompensMgmt/getCustomerCompensDetailSaveView":{"get":{"tags":["고객보상관리"],"summary":"고객보상 상세 정보 조회","description":"## 기능설명\n* 고객보상 상세 정보를 조회 합니다.\n---\n## 상세설명\n* 선택한 고객보상 상세정보를 조회 합니다.\n---\n## 수정번호\n* Release v2.00_240905: 고객 보상 대분류 조회 추가\n","operationId":"getCustomerCompensDetailSaveView","parameters":[{"name":"custCpnsAplyNo","in":"query","description":"고객보상신청번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseCustomerCompensDetailSaveViewResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 고객보상 접수자 권한 조회

> \## 기능설명\
> \* 고객보상 접수자의 권한을 조회 합니다.\
> \---\
> \## 상세설명\
> \* 고객보상을 접수한 삼당원의 권한을 조회 합니다.\
> \* N:없음  A:승인요청자 , P:지급승인자 , All:승인요청자 & 지급승인자<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/customerCompensMgmt/getCsCompensUserGrade":{"get":{"tags":["고객보상관리"],"summary":"고객보상 접수자 권한 조회","description":"## 기능설명\n* 고객보상 접수자의 권한을 조회 합니다.\n---\n## 상세설명\n* 고객보상을 접수한 삼당원의 권한을 조회 합니다.\n* N:없음  A:승인요청자 , P:지급승인자 , All:승인요청자 & 지급승인자\n","operationId":"getCsCompensUserGrade","parameters":[{"name":"loginId","in":"query","description":"로그인한 상담사ID","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api/back-office-api/cs-bo-api/undefined-3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
