> 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/api-en/back-office-api-reference/cs-bo-api/customer-compensation-management.md).

# Customer Compensation Management

## Modify Customer Compensation Detail Information

> \## Function Description\
> \* Modifies customer compensation detail information.\
> \---\
> \## Detailed Description\
> \* Compensation method (Coupon): Can be modified when the approval status is Received.\
> \* Compensation method (Cash): Can be modified when the approval status is Received.\
> \* Compensation method (Mileage): Can be modified when the approval status is Received.<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":"Customer Compensation Detail Information Modification Request DTO","properties":{"cpnsMeanCd":{"type":"string","description":"20"},"mbrNo":{"type":"string","description":"100000513"},"custCpnsAplyNo":{"type":"string","description":"Customer Compensation Request No."},"cpnsAmtNo":{"type":"string","description":"Compensation Amount No."},"promoNm":{"type":"string","description":"Coupon Name"},"accpCont":{"type":"string","description":"Receipt Details"},"payReqMemo":{"type":"string","description":"Payment Request Memo"},"payBankCd":{"type":"string","description":"Payment Bank Code"},"payActnNo":{"type":"string","description":"Payment Account No."},"payDepositorNm":{"type":"string","description":"Payment Account Holder Name"}}},"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":["Customer Compensation Management"],"summary":"Modify Customer Compensation Detail Information","description":"## Function Description\n* Modifies customer compensation detail information.\n---\n## Detailed Description\n* Compensation method (Coupon): Can be modified when the approval status is Received.\n* Compensation method (Cash): Can be modified when the approval status is Received.\n* Compensation method (Mileage): Can be modified when the approval status is Received.\n","operationId":"updateCustomerCompensDetail","parameters":[{"name":"custCpnsAplyNo","in":"query","description":"Customer Compensation Request No.","schema":{"type":"String"}},{"name":"cpnsAmtNo","in":"query","description":"Compensation Amount No.","schema":{"type":"String"}},{"name":"promoNm","in":"query","description":"Coupon Name","schema":{"type":"String"}},{"name":"accpCont","in":"query","description":"Receipt Details","schema":{"type":"String"}},{"name":"payReqMemo","in":"query","description":"Payment Request Memo","schema":{"type":"String"}},{"name":"payBankCd","in":"query","description":"Payment Bank Code","schema":{"type":"String"}},{"name":"payActnNo","in":"query","description":"Payment Account No.","schema":{"type":"String"}},{"name":"payDepositorNm","in":"query","description":"Payment Account Holder Name","schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCustomerCompensDetailRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Cancel/Reject Customer Compensation Receipt

> \## Function Description\
> \* Cancels the receipt of or rejects the selected customer compensation.\
> \---\
> \## Detailed Description\
> \* Rejection can only be processed by users with the corresponding authorization.\
> \* A customer compensation receipt that has been cancelled or rejected cannot be reapplied; it must be re-registered starting from the consultation application.\
> \## Code Reference\
> \* Receipt cancellation/rejection classification type (type): Receipt Cancellation (C), Compensation Approval Rejection (A), Payment Approval Rejection (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":"Receipt Cancellation/Rejection Classification Type"},"custCpnsAplyNo":{"type":"array","description":"Customer Compensation Request No.","items":{"type":"string"}},"memo":{"type":"string","description":"Rejection Reason"}}},"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":["Customer Compensation Management"],"summary":"Cancel/Reject Customer Compensation Receipt","description":"## Function Description\n* Cancels the receipt of or rejects the selected customer compensation.\n---\n## Detailed Description\n* Rejection can only be processed by users with the corresponding authorization.\n* A customer compensation receipt that has been cancelled or rejected cannot be reapplied; it must be re-registered starting from the consultation application.\n## Code Reference\n* Receipt cancellation/rejection classification type (type): Receipt Cancellation (C), Compensation Approval Rejection (A), Payment Approval Rejection (B)\n","operationId":"returnCustomerCompensDetail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CsCompensReturnRequestV2"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Detail Information for Customer Compensation Payment Approval

> \## Function Description\
> \* Retrieves the detail information for approving customer compensation payment.\
> \---\
> \## Detailed Description\
> \* Retrieves the detail information corresponding to the selected customer compensation application number and customer compensation classification type.\
> \## Code Reference\
> \* Customer compensation classification type (type): Compensation Approval (A), Payment Approval (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":"Detail Information Inquiry Request DTO for Customer Compensation Payment Approval","properties":{"custCpnsAplyNoList":{"type":"array","description":"Customer Compensation Application No. List","items":{"type":"string"}},"type":{"type":"string","description":"Customer Compensation Classification Type"}}},"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":["Customer Compensation Management"],"summary":"Retrieve Detail Information for Customer Compensation Payment Approval","description":"## Function Description\n* Retrieves the detail information for approving customer compensation payment.\n---\n## Detailed Description\n* Retrieves the detail information corresponding to the selected customer compensation application number and customer compensation classification type.\n## Code Reference\n* Customer compensation classification type (type): Compensation Approval (A), Payment Approval (P)\n","operationId":"getCustomerCompensInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCustomerCompensInfoRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListCsCustomerCompensAcceptInfo"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Process Customer Compensation Approval

> \## Function Description\
> \* Approves a received customer compensation.\
> \---\
> \## Detailed Description\
> \* Processed through the stages of Receipt > Compensation Approval > Payment Approval.\
> \* If the compensation method is coupon or mileage, the payment status is set to Payment Complete once payment is approved.\
> \* If the compensation method is cash, the payment status is set to Payment Pending once payment is approved, and is set to Payment Complete after the deposit to the customer is confirmed.<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":"Customer Compensation Approval Processing Request DTO","properties":{"request":{"type":"array","description":"Customer Compensation Receipt Information","items":{"$ref":"#/components/schemas/CsCustomerCompensAcceptInfoRequest"}}}},"CsCustomerCompensAcceptInfoRequest":{"type":"object","description":"Customer Compensation Receipt Information Request 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":"Please approve."},"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":"Requesting approval."},"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":"Hong Gil-dong"},"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":["Customer Compensation Management"],"summary":"Process Customer Compensation Approval","description":"## Function Description\n* Approves a received customer compensation.\n---\n## Detailed Description\n* Processed through the stages of Receipt > Compensation Approval > Payment Approval.\n* If the compensation method is coupon or mileage, the payment status is set to Payment Complete once payment is approved.\n* If the compensation method is cash, the payment status is set to Payment Pending once payment is approved, and is set to Payment Complete after the deposit to the customer is confirmed.\n","operationId":"approveCustomerCompensDetail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveCustomerCompensDetailRequestV2"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Customer Compensation Management List

> \## Function Description\
> \* Retrieves the customer compensation management list.\
> \---\
> \## Detailed Description\
> \* Retrieves the customer compensation management list for the selected conditions.\
> \---\
> \## Revision History\
> \* Release v2.00\_240613: Improved period search conditions\
> \* Release v2.00\_240827: Changed to 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":["Customer Compensation Management"],"summary":"Retrieve Customer Compensation Management List","description":"## Function Description\n* Retrieves the customer compensation management list.\n---\n## Detailed Description\n* Retrieves the customer compensation management list for the selected conditions.\n---\n## Revision History\n* Release v2.00_240613: Improved period search conditions\n* Release v2.00_240827: Changed to V2 RealGridListResponse\n","operationId":"getCsCounselTemplateInfoList","parameters":[{"name":"periodType","in":"query","description":"Period Search Type","required":false,"schema":{"type":"string","description":"Period Search Type"}},{"name":"startDate","in":"query","description":"Start Date","required":false,"schema":{"type":"string","format":"date","description":"Start Date"}},{"name":"endDate","in":"query","description":"End Date","required":false,"schema":{"type":"string","format":"date","description":"End Date"}},{"name":"rspnGbCd","in":"query","description":"Responsibility Type Code (CS020)","required":false,"schema":{"type":"string","description":"Responsibility Type Code (CS020)","enum":["CUSTOMER","COMPANY","CONSIGNMENT_COMPANY"]}},{"name":"cpnsTypNo","in":"query","description":"Compensation Type No.","required":false,"schema":{"type":"string","description":"Compensation Type No."}},{"name":"cpnsMeanCd","in":"query","description":"Compensation Method Code (CS019)","required":false,"schema":{"type":"string","description":"Compensation Method Code (CS019)","enum":["COUPON","CASH","MILEAGE","GIFT"]}},{"name":"mbrType","in":"query","description":"Member Search Type","required":false,"schema":{"type":"string","description":"Member Search Type"}},{"name":"loginId","in":"query","description":"Member ID","required":false,"schema":{"type":"string","description":"Member ID"}},{"name":"cpnsAprvStatCd","in":"query","description":"Compensation Approval Status Code (CS021)","required":false,"schema":{"type":"string","description":"Compensation Approval Status Code (CS021)","enum":["RECEIPT","CANCEL","REWARD_APPROVAL","REWARD_RETURN","PAYMENT_APPROVAL","PAYMENT_RETURN"]}},{"name":"cpnsPayStatCd","in":"query","description":"Compensation Payment Status Code (CS020)","required":false,"schema":{"type":"string","description":"Compensation Payment Status Code (CS020)","enum":["CUSTOMER","COMPANY","CONSIGNMENT_COMPANY"]}},{"name":"userType","in":"query","description":"Handler Search Type","required":false,"schema":{"type":"string","description":"Handler Search Type"}},{"name":"userId","in":"query","description":"Person in Charge ID","required":false,"schema":{"type":"string","description":"Person in Charge ID"}},{"name":"businessType","in":"query","description":"Task Type","required":false,"schema":{"type":"string","description":"Task Type"}},{"name":"businessNumber","in":"query","description":"Task No.","required":false,"schema":{"type":"string","description":"Task No."}},{"name":"siteNo","in":"query","description":"Site No.","required":false,"schema":{"type":"string","description":"Site No."}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCsCustomerCompensResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Customer Compensation Detail Information

> \## Function Description\
> \* Retrieves customer compensation detail information.\
> \---\
> \## Detailed Description\
> \* Retrieves the detail information of the selected customer compensation.\
> \---\
> \## Revision History\
> \* Release v2.00\_240905: Added customer compensation major category inquiry<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":"Customer Compensation Detail Screen Response DTO","properties":{"csCompensDetailResponse":{"$ref":"#/components/schemas/CsCompensDetailResponse","description":"Customer Compensation Detail Information Response DTO"},"loginId":{"type":"string","description":"Logged-in User ID"},"codeList":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"Common Code List"},"csCpGradeAmtCode":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/StStdCd"}},"description":"Compensation Amount Payment Limit (CS025)"},"csCpUserGrade":{"type":"string","description":"Logged-In User Authority"},"csCpUserGradeOfAcptmId":{"type":"string","description":"Customer Compensation Receiver Authorization"}}},"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":"Group Code Search/Register/Modify Request","properties":{"grpCd":{"type":"string","description":"Group Code"},"cd":{"type":"string","description":"Code"},"cdNm":{"type":"string","description":"Code Name"},"cdDesc":{"type":"string","description":"Code Description"},"useYn":{"type":"string","description":"Usage Status"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"ref1Val":{"type":"string","description":"Reference Value 1 Description"},"ref2Val":{"type":"string","description":"Reference Value 2 Description"},"ref3Val":{"type":"string","description":"Reference Value 3 Description"},"ref4Val":{"type":"string","description":"Reference Value 4 Description"},"ref5Val":{"type":"string","description":"Reference Value 5 Description"},"ref6Val":{"type":"string","description":"Reference Value 6 Description"},"ref7Val":{"type":"string","description":"Reference Value 7 Description"}}},"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":["Customer Compensation Management"],"summary":"Retrieve Customer Compensation Detail Information","description":"## Function Description\n* Retrieves customer compensation detail information.\n---\n## Detailed Description\n* Retrieves the detail information of the selected customer compensation.\n---\n## Revision History\n* Release v2.00_240905: Added customer compensation major category inquiry\n","operationId":"getCustomerCompensDetailSaveView","parameters":[{"name":"custCpnsAplyNo","in":"query","description":"Customer Compensation Request No.","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseCustomerCompensDetailSaveViewResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Customer Compensation Receiver Authorization

> \## Function Description\
> \* Retrieves the authorization of the customer compensation receiver.\
> \---\
> \## Detailed Description\
> \* Retrieves the authorization of the agent who received the customer compensation.\
> \* N: None, A: Approval Requester, P: Payment Approver, All: Approval Requester & Payment Approver<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":["Customer Compensation Management"],"summary":"Retrieve Customer Compensation Receiver Authorization","description":"## Function Description\n* Retrieves the authorization of the customer compensation receiver.\n---\n## Detailed Description\n* Retrieves the authorization of the agent who received the customer compensation.\n* N: None, A: Approval Requester, P: Payment Approver, All: Approval Requester & Payment Approver\n","operationId":"getCsCompensUserGrade","parameters":[{"name":"loginId","in":"query","description":"Logged-in Agent ID","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```