> 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/payment-bo-api/undefined.md).
# 환불관리
## 환불처리결과 업데이트
> \## 기능 설명\
> \- 환불처리결과를 업데이트하는 API입니다.\
> \---\
> \## 상세 설명\
> \- 요청한 환불번호 리스트를 환불접수취소 처리합니다.\
> \- 접수취소가 가능한 상태의 환불 건만 취소처리 합니다.
```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":{"RefundProcRsltUpdateRequest":{"type":"object","properties":{"dataList":{"type":"array","description":"환불처리결과 리스트","items":{"$ref":"#/components/schemas/RefundProcRslt"},"minItems":1}},"required":["dataList"]},"RefundProcRslt":{"type":"object","properties":{"rfdNo":{"type":"string","description":"환불번호","minLength":1},"rfdProcRsltCd":{"type":"string","description":"환불처리결과코드(OM049) 10:미처리,20:성공,30:실패","minLength":1}},"required":["rfdNo","rfdProcRsltCd"]},"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/payment/refundMgmt/saveRefundProcRslt":{"post":{"tags":["환불관리"],"summary":"환불처리결과 업데이트","description":"## 기능 설명\n- 환불처리결과를 업데이트하는 API입니다.\n---\n## 상세 설명\n- 요청한 환불번호 리스트를 환불접수취소 처리합니다.\n- 접수취소가 가능한 상태의 환불 건만 취소처리 합니다.\n","operationId":"saveRefundProcRslt","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundProcRsltUpdateRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 원결제 환불 완료 처리
> \## 기능 설명\
> \* BO에서 원결제 환불 완료 처리합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임번호(claimNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템유형(systemType)\*\*은 필수로 있어야 합니다.\
> \* 대상 클레임을 반품완료처리 합니다.\
> \* \*\*반품완료처리 설명\*\*\
> \* 주문내역구분(OM003) 값이 \*\*반품(20)\*\* 이고, 주문내역상태(OM005) 값이 \*\*회수완료(36)\*\* 상태인 경우 처리 가능합니다.\
> \* API 호출 시점의 주문 상태를 재 확인, 완료 처리 가능 여부를 확인합니다.\
> \* 주문상세 테이블의 주문내역상태코드(OM005) 값이 반품완료(37) 상태로 변경되며(사은품 포함), 주문완료일시(ordFnshDtm)를 업데이트 합니다.\
> \* 주문배송정보 테이블의 배송완료일시(deliFnshDtm)를 업데이트 합니다.\
> \* 주문시 사용되었던 쿠폰과 주문상품(사은품 포함)의 재고가 복원됩니다. 단, 주문상세의 교환중반품여부(exchMidRtnYn)값이 (Y)인 경우 재고 복원대상에서 제외됩니다.\
> \* 환불 절차를 진행합니다.\
> \* 반품 완료 처리 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\
> \* 반품 완료 처리 후 처리 이력을 생성합니다.\
> \* 대상 클레임들을 모두 환불 완료 후 결과를 전달합니다.\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*반품완료(22)\*\*인 경우에 원결제 환불 완료 처리합니다.
```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":{"RefundBundleApproMgmtCUDSaveRequest":{"type":"object","description":"원주문 환불완료처리 요청 DTO","properties":{"claimBusinessType":{"type":"string","description":"클레임 업무 유형","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM"]},"ordNo":{"type":"string","description":"주문번호"},"ordMediaCd":{"type":"string","description":"주문매체코드"},"systemType":{"type":"string","description":"시스템유형","enum":["FO","BO"]},"claimNo":{"type":"string","description":"클레임번호"}},"required":["claimBusinessType","ordMediaCd","ordNo","systemType"]},"ResponseListRefundBundleApproMgmtCUDResponse":{"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/RefundBundleApproMgmtCUDResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RefundBundleApproMgmtCUDResponse":{"type":"object","description":"원주문 환불완료처리 응답 DTO","properties":{"claimNo":{"type":"string","description":"클레임번호"},"resultCode":{"type":"string","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/payment/refundMgmt/saveRefundBundleApproMgmtList":{"post":{"tags":["환불관리"],"summary":"원결제 환불 완료 처리","description":"## 기능 설명\n* BO에서 원결제 환불 완료 처리합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임번호(claimNo)**, **클레임업무유형(claimBusinessType)**, **시스템유형(systemType)**은 필수로 있어야 합니다.\n* 대상 클레임을 반품완료처리 합니다.\n * **반품완료처리 설명**\n * 주문내역구분(OM003) 값이 **반품(20)** 이고, 주문내역상태(OM005) 값이 **회수완료(36)** 상태인 경우 처리 가능합니다.\n * API 호출 시점의 주문 상태를 재 확인, 완료 처리 가능 여부를 확인합니다.\n * 주문상세 테이블의 주문내역상태코드(OM005) 값이 반품완료(37) 상태로 변경되며(사은품 포함), 주문완료일시(ordFnshDtm)를 업데이트 합니다.\n * 주문배송정보 테이블의 배송완료일시(deliFnshDtm)를 업데이트 합니다.\n * 주문시 사용되었던 쿠폰과 주문상품(사은품 포함)의 재고가 복원됩니다. 단, 주문상세의 교환중반품여부(exchMidRtnYn)값이 (Y)인 경우 재고 복원대상에서 제외됩니다.\n * 환불 절차를 진행합니다.\n * 반품 완료 처리 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\n * 반품 완료 처리 후 처리 이력을 생성합니다.\n* 대상 클레임들을 모두 환불 완료 후 결과를 전달합니다.\n---\n## 특이 사항\n* **클레임업무유형(claimBusinessType)**이 **반품완료(22)**인 경우에 원결제 환불 완료 처리합니다.\n","operationId":"saveRefundBundleApproMgmtList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RefundBundleApproMgmtCUDSaveRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListRefundBundleApproMgmtCUDResponse"}}}},"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":{"RefundExcelUploadRequest":{"type":"object","properties":{"excelDataList":{"type":"array","items":{"$ref":"#/components/schemas/RefundExcelRow"}}}},"RefundExcelRow":{"type":"object","properties":{"rfdNo":{"type":"string","description":"환불번호"},"ordNo":{"type":"string","description":"주문번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"rfdTypNm":{"type":"string","description":"환불유형(OM023) 주문환불, 보상금환불"},"rfdPrgsStatNm":{"type":"string","description":"환불진행상태(OM024). 환불접수, 환불완료, 환불취소"},"rfdBankNm":{"type":"string","description":"환불은행(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불예금주명"},"rfdCausNm":{"type":"string","description":"환불사유(OM025). 주문취소, 교환, 반품, 보상금환불, 기타"},"rfdAmt":{"type":"number","description":"환불금액"},"acptmnId":{"type":"string","description":"접수자ID"},"acptmnNm":{"type":"string","description":"접수자명"},"accpDtm":{"type":"string","description":"접수일시"},"rfdProcRsltNm":{"type":"string","description":"환불처리결과(OM049). 미처리, 성공, 실패"}}},"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/payment/refundMgmt/refundExcelUpload":{"post":{"tags":["환불관리"],"summary":"수기 환불처리 엑셀 업로드 업데이트","description":"## 기능 설명\n- 수기 환불처리 엑셀로 환불상태를 업데이트 합니다.\n---\n## 상세 내용\n- 계좌정보가 다르면 업데이트에 실패합니다.\n","operationId":"refundExcelUpload","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundExcelUploadRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 환불접수취소
> \## 기능 설명\
> \- 수기 환불내역을 접수취소 처리하는 API입니다.\
> \---\
> \## 상세 설명\
> \- 요청한 환불번호 리스트를 환불접수취소 처리합니다.\
> \- 접수취소가 가능한 상태의 환불 건만 취소처리 합니다.
```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":{"RefundAcceptCancelRequest":{"type":"object","properties":{"rfdNoList":{"type":"array","description":"환불번호리스트","items":{"type":"string","minLength":1},"minItems":1}},"required":["rfdNoList"]},"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/payment/refundMgmt/cancelRefundAccept":{"post":{"tags":["환불관리"],"summary":"환불접수취소","description":"## 기능 설명\n- 수기 환불내역을 접수취소 처리하는 API입니다.\n---\n## 상세 설명\n- 요청한 환불번호 리스트를 환불접수취소 처리합니다.\n- 접수취소가 가능한 상태의 환불 건만 취소처리 합니다.\n","operationId":"cancelRefundAccept","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundAcceptCancelRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 수기 환불처리 엑셀 다운로드 권한 체크
> \## 기능 설명\
> \- 수기 환불처리 엑셀 다운로드 권한이 있는지 체크하는 API입니다.\
> \---\
> \## 상세 내용\
> \- 요청한 환불처리 엑셀 다운로드 권한이 있는지 확인합니다.\
> \- 엑셀 다운로드를 위해선 ID, 이름, 계좌번호 조회 권한이 있어야 합니다.
```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":{"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/payment/refundMgmt/hasRefundExcelDownloadPermission":{"get":{"tags":["환불관리"],"summary":"수기 환불처리 엑셀 다운로드 권한 체크","description":"## 기능 설명\n- 수기 환불처리 엑셀 다운로드 권한이 있는지 체크하는 API입니다.\n---\n## 상세 내용\n- 요청한 환불처리 엑셀 다운로드 권한이 있는지 확인합니다.\n- 엑셀 다운로드를 위해선 ID, 이름, 계좌번호 조회 권한이 있어야 합니다.\n","operationId":"hasRefundExcelDownloadPermission","responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"boolean"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 수기 환불내역 조회
> \## 기능 설명\
> \- 수기 환불내역을 조회하는 API입니다.\
> \---\
> \## 상세 설명\
> \- from 값이 "ACCEPT"일 경우 환불완료 건은 조회에서 제외됩니다.\
> \- from 값이 "COMPLETE"일 경우 환불취소 건은 조회에서 제외됩니다.
```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":{"RefundMgmtRequest":{"type":"object","properties":{"from":{"type":"string","description":"요청 화면. 접수:ACCEPT,완료:COMPLETE","enum":["ACCEPT","COMPLETE"],"minLength":1},"rfdDtmOption":{"type":"string","description":"환불기간 조건 값. 접수일시:ACCEPT,완료일시:COMPLETE","enum":["ACCEPT","COMPLETE"],"minLength":1},"startDtm":{"type":"string","format":"date","description":"조회시작일"},"endDtm":{"type":"string","format":"date","description":"조회종료일"},"condKdOption":{"type":"string","description":"조회조건. 주문번호:ordAmt,환불요청금액:refundAmount)","enum":["ordNo","refundAmount"]},"condKdVl":{"type":"string","description":"조회조건 값"},"rfdCausCd":{"type":"string","description":"환불사유코드(OMO25) 10:주문취소,11:교환,12:반품,31:보상금환불,99:기타"},"rfdPrgsStatCd":{"type":"string","description":"환불진행상태코드(OM024) 10:환불접수,30:환불완료,99:환불취소"},"mbrNo":{"type":"string","description":"회원번호"},"rfdProcRsltCd":{"type":"string","description":"환불상태코드(OM049) 10:미처리,20:성공,30:실패"},"ordNo":{"type":"string","description":"주문번호"},"dateSelect":{"type":"string","description":"검색기간 전체구분값"}},"required":["endDtm","from","rfdDtmOption","startDtm"]},"RealGridListResponseRefundMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/RefundMgmtResponse"}}}},"RefundMgmtResponse":{"type":"object","properties":{"accpDtm":{"type":"string","format":"date-time","description":"조회시작일자"},"fnshDtm":{"type":"string","format":"date-time","description":"조회종료일자"},"rfdPrgsStatCd":{"type":"string","description":"환불진행상태코드(OM024)"},"rfdPrgsStatCdNm":{"type":"string","description":"환불진행상태코드명(OM024)"},"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인ID"},"mbrNm":{"type":"string","description":"회원이름"},"rfdBankCd":{"type":"string","description":"은행코드(OM026)"},"rfdBankCdNm":{"type":"string","description":"은행코드명(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"예금주"},"rfdAmt":{"type":"number","description":"환불금액"},"rfdCausCd":{"type":"string","description":"환불사유코드(OM025)"},"rfdCausCdNm":{"type":"string","description":"환불사유코드명(OM025)"},"fnshmnId":{"type":"string","description":"완료자ID"},"fnshmnNm":{"type":"string","description":"완료자명"},"acptmnId":{"type":"string","description":"접수자ID"},"acptmnNm":{"type":"string","description":"접수자명"},"rfdProcRsltCd":{"type":"string","description":"환불처리결과코드(OM049)"},"rfdProcRsltCdNm":{"type":"string","description":"환불처리결과코드명(OM049)"},"rfdNo":{"type":"string","description":"환불번호"},"originRfdProcRsltCd":{"type":"string","description":"그리드 selectbox 제어용 환불처리결과코드"}}},"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/payment/refundMgmt/getRefundMgmtList":{"get":{"tags":["환불관리"],"summary":"수기 환불내역 조회","description":"## 기능 설명\n- 수기 환불내역을 조회하는 API입니다.\n---\n## 상세 설명\n- from 값이 \"ACCEPT\"일 경우 환불완료 건은 조회에서 제외됩니다.\n- from 값이 \"COMPLETE\"일 경우 환불취소 건은 조회에서 제외됩니다.\n","operationId":"getRefundAcceptMgmtList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RefundMgmtRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseRefundMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 수기 환불처리 엑셀 다운로드
> \## 기능 설명\
> \- 수기 환불처리 대상 엑셀을 다운로드 하는 API입니다.\
> \---\
> \## 상세 내용\
> \- 환불완료 처리가 가능한 환불목록을 엑셀로 다운로드합니다.
```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":{"IndInfoLogCommonEntity":{"type":"object","properties":{"qryGbCd":{"type":"string","description":"개인정보 조회구분코드(UR014) 10:조회,20:엑셀다운로드,30:수정"},"indInfoQryCaus":{"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/payment/refundMgmt/getRefundExcelData":{"get":{"tags":["환불관리"],"summary":"수기 환불처리 엑셀 다운로드","description":"## 기능 설명\n- 수기 환불처리 대상 엑셀을 다운로드 하는 API입니다.\n---\n## 상세 내용\n- 환불완료 처리가 가능한 환불목록을 엑셀로 다운로드합니다.\n","operationId":"getRefundExcelData","parameters":[{"name":"indiInfoLog","in":"query","required":true,"schema":{"$ref":"#/components/schemas/IndInfoLogCommonEntity"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 원주문 환불완료처리대상 목록 조회
> \## 기능 설명\
> \* BO에서 원주문 환불완료처리대상 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 주문반품금액이 0원 이상 \*\*((주문수량 – 취소수량 – 반품수량) \* 수량 > 0)\*\*\
> \* \*\*주문내역구분(OM003)\*\* 값이 \*\*반품(20)\*\*\
> \* \*\*주문내역상태코드(OM005)\*\* 값이 \*\*회수완료(36)\*\*, \*\*반품완료(37)\*\*\
> \* 위의 조건(기본조건) 외 조회조건에 따라 조회조건에 추가됩니다.(조회 조건 중 \*\*주문진행상태(OM005)\*\*를 \*\*회수완료(36)\*\*, \*\*반품완료(37)\*\*로 선택할 수 있습니다.)\
> \---\
> \## 수정번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"RefundBundleApproMgmtRequest":{"type":"object","description":"원주문 환불완료처리대상조회 요청 DTO","properties":{"entrNo":{"type":"string","description":"협력사번호"},"ordNo":{"type":"string","description":"주문번호"},"comboRfndDtm":{"type":"string","description":"반품접수일/환불처리완료일","minLength":1},"startDate":{"type":"string","format":"date","description":"기간(시작)"},"endDate":{"type":"string","format":"date","description":"기간(끝)"},"ordManInfoGb":{"type":"string","description":"(주문자정보)이름/휴대폰"},"ordManInfo":{"type":"string","description":"(주문자정보)이름/휴대폰의 검색내용"},"ordStatCd":{"type":"string","description":"주문진행상태(OM005)"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"pgApprRslt":{"type":"string","description":"PG승인결과"},"dateSelect":{"type":"string","description":"기간유형"}},"required":["comboRfndDtm","endDate","startDate"]},"RealGridListResponseRefundBundleApproMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/RefundBundleApproMgmtResponse"}}}},"RefundBundleApproMgmtResponse":{"type":"object","description":"원주문 환불완료처리대상조회 응답 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"loginId":{"type":"string","description":"로그인ID"},"ordManNm":{"type":"string","description":"주문자명"},"cellNo":{"type":"string","description":"핸드폰번호"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"returnAccpDtm":{"type":"string","format":"date-time","description":"반품접수일시"},"claimNo":{"type":"string","description":"클레임번호"},"ordPrc":{"type":"number","description":"주문금액"},"ordDtlStatCd":{"type":"string","description":"주문내역상태코드(OM005)"},"ordDtlStatCdNm":{"type":"string","description":"주문내역상태코드명"},"pgAprvCd":{"type":"string","description":"PG승인결과"},"pgAprvCdNm":{"type":"string","description":"PG승인결과명"},"rfdFnshDtm":{"type":"string","format":"date-time","description":"환불완료일시"},"rfdPayStatCd":{"type":"string","description":"환불결제상태코드(OM014)"},"rfdPayStatCdNm":{"type":"string","description":"환불결제상태코드명"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"pgGbCdNm":{"type":"string","description":"PG구분코드명"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명"},"cancelAmt":{"type":"number","description":"취소금액"},"mainCancelAmt":{"type":"number","description":"주결제취소금액"},"milgCancelAmt":{"type":"number","description":"마일리지취소금액"},"rfdAmt":{"type":"number","description":"환불금액"},"errorConts":{"type":"string","description":"환불오류내용"}}},"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/payment/refundMgmt/getRefundBundleApproMgmtList":{"get":{"tags":["환불관리"],"summary":"원주문 환불완료처리대상 목록 조회","description":" ## 기능 설명\n * BO에서 원주문 환불완료처리대상 목록을 조회합니다.\n ---\n ## 상세 설명\n * 주문반품금액이 0원 이상 **((주문수량 – 취소수량 – 반품수량) * 수량 > 0)**\n * **주문내역구분(OM003)** 값이 **반품(20)**\n * **주문내역상태코드(OM005)** 값이 **회수완료(36)**, **반품완료(37)**\n * 위의 조건(기본조건) 외 조회조건에 따라 조회조건에 추가됩니다.(조회 조건 중 **주문진행상태(OM005)**를 **회수완료(36)**, **반품완료(37)**로 선택할 수 있습니다.)\n ---\n## 수정번호\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getRefundBundleApproMgmtList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RefundBundleApproMgmtRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseRefundBundleApproMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/payment-bo-api/undefined.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.