> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/cs-bo-api/undefined-3.md).
# 고객보상관리
## 고객보상 상세 정보 수정
> \## 기능설명\
> \* 고객보상 상세 정보를 수정 합니다.\
> \---\
> \## 상세설명\
> \* 고객보상수단(쿠폰): 승인상태가 접수 일 때 수정 가능 합니다.\
> \* 고객보상수단(현금): 승인상태가 접수 일 때 수정 가능 합니다.\
> \* 고객보상수단(마일리지): 승인상태 접수 일 때 수정 가능 합니다.
```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)
```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)
```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"}}}}}}}}}
```
## 고객보상 승인처리
> \## 기능설명\
> \* 접수된 고객보상을 승인처리 합니다.\
> \---\
> \## 상세설명\
> \* 접수 > 보상승인 > 지급승인 단계로 처리됩니다.\
> \* 보상수단이 쿠폰, 마일리지일 경우 지급승인되면 지급상태는 지금완료 처리됩니다.\
> \* 보상수단이 현금일 경우 지급승인되면 지급상태는 지급대기로 처리되며 고객에게 입금완료 후 지급완료 처리됩니다.
```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 변경
```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: 고객 보상 대분류 조회 추가
```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:승인요청자 & 지급승인자
```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"}}}}}}}}}
```