> 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"}}}}}}}}}
```