> 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/claim-bo-api/undefined-1.md).

# 주문클레임처리

## 비회원 환불 계좌 등록

> \## 기능설명\
> \* 비회원의 환불 계좌를 등록합니다.\
> \---\
> \## 상세설명\
> \---\
> \## 특이사항\
> \* 예금주명은 주문자명과 일치해야합니다.\
> \* 계좌 인증이 환료되어야 합니다.\
> \* 필수 값 목록\
> &#x20;  \* 계좌번호\
> &#x20;  \* 은행코드\
> &#x20;  \* 계좌 인증 유무<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":{"RefundAcceptRegisterRequest":{"type":"object","properties":{"rfdNo":{"type":"string"},"ordNo":{"type":"string"},"mbrNo":{"type":"string","minLength":1},"mbrNm":{"type":"string","minLength":1},"loginId":{"type":"string","minLength":1},"rfdTypCd":{"type":"string","minLength":1},"rfdPrgsStatCd":{"type":"string","minLength":1},"rfdBankCd":{"type":"string","minLength":1},"rfdActnNo":{"type":"string","minLength":1},"rfdActnDepositorNm":{"type":"string","minLength":1},"rfdCausCd":{"type":"string","minLength":1},"rfdActnCertiYn":{"type":"string","minLength":1},"rfdAmt":{"type":"number"},"rfdCmsnAmt":{"type":"number"},"acptmnId":{"type":"string","minLength":1},"rfdSmsSndYn":{"type":"string","minLength":1}},"required":["acptmnId","loginId","mbrNm","mbrNo","rfdActnCertiYn","rfdActnDepositorNm","rfdActnNo","rfdAmt","rfdBankCd","rfdCausCd","rfdCmsnAmt","rfdPrgsStatCd","rfdSmsSndYn","rfdTypCd"]},"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":{"/v1/claim/orderClaimProc/saveNonMemberRefundActn":{"post":{"tags":["주문클레임처리"],"summary":"비회원 환불 계좌 등록","description":"## 기능설명\n* 비회원의 환불 계좌를 등록합니다.\n---\n## 상세설명\n---\n## 특이사항\n* 예금주명은 주문자명과 일치해야합니다.\n* 계좌 인증이 환료되어야 합니다.\n* 필수 값 목록\n   * 계좌번호\n   * 은행코드\n   * 계좌 인증 유무\n","operationId":"saveNonMemberRefundActn","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundAcceptRegisterRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 결제/환불 정보 중 프로모션 정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문번호에 해당하는 사용한 프로모션 정보(쿠폰, 할인, 적립마일리지)를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문번호에 해당하는 사용한 프로모션 정보(쿠폰, 할인, 적립마일리지)를 조회합니다.<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":{"DepositNotifyRequest":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호","minLength":1}},"required":["ordNo"]},"DepositNotifyResult":{"type":"object","description":"가상계좌 입금 확인 처리 응답","properties":{"result":{"type":"string"},"alreadyConfirmed":{"type":"boolean"}}},"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":{"/v1/claim/orderClaimProc/saveManualConfirm":{"post":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 결제/환불 정보 중 프로모션 정보 조회","description":"  ## 기능 설명\n  * 주문번호에 해당하는 사용한 프로모션 정보(쿠폰, 할인, 적립마일리지)를 조회합니다.\n  ---\n  ## 상세 설명\n  * 주문번호에 해당하는 사용한 프로모션 정보(쿠폰, 할인, 적립마일리지)를 조회합니다.\n","operationId":"saveManualConfirm","parameters":[{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepositNotifyRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/DepositNotifyResult"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 배송지를 변경합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 배송지를 변경합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.\
> &#x20; \* 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트 합니다.\
> &#x20; \* 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.\
> &#x20; \---\
> &#x20; \## 특이사항\
> &#x20; \* ST008 cd 92번(배송지변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값 에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* \`\`\`Release v2.00\_240711\`\`\` : 추가 배송비 개선에 따른 배송정책번호(deli\_polc\_no) 추가<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":{"DeliveryInfoChangeRequest":{"type":"object","description":"주문 배송지 변경 DTO","properties":{"ordNo":{"type":"string","description":"주문번호","minLength":1},"systemType":{"type":"string","description":"시스템구분코드"},"deliNo":{"type":"string","description":"배송번호","minLength":1},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명","minLength":1},"zipNoSeq":{"type":"integer","format":"int32","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"originZipNo":{"type":"string","description":"원주문우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호","minLength":1},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호","minLength":1},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호","minLength":1},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드"},"deliGbCd":{"type":"string","description":"배송구분코드"},"dlvpSeq":{"type":"string","description":"배송순번"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"orginDlvpSeq":{"type":"string","description":"원배송순번"}},"required":["deliNo","ordNo","rcvmnCellEndNo","rcvmnCellSctNo","rcvmnCellTxnoNo","rcvmnNm"]},"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":{"/v1/claim/orderClaimProc/ordDlvChange":{"post":{"tags":["주문클레임처리"],"summary":"배송지를 변경합니다.","description":"  ## 기능 설명\n  * 배송지를 변경합니다.\n  ---\n  ## 상세 설명\n  * 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.\n  * 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트 합니다.\n  * 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.\n  ---\n  ## 특이사항\n  * ST008 cd 92번(배송지변경)의 ref_1_val(OM005), ref_2_val(OM003)값 에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\n  ---\n  ## 수정번호\n  * ```Release v2.00_240711``` : 추가 배송비 개선에 따른 배송정책번호(deli_polc_no) 추가\n","operationId":"modifyOrdDlvChange","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryInfoChangeRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## 주문변경 > 주문상품의 단품을 변경합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 주문상품의 단품을 변경합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.\
> &#x20; \* 다건의 옵션 변경이 가능합니다.\
> &#x20; \* 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.\
> &#x20; \* 동일단품, 예약상품의 단품은 변경 불가능합니다.\
> &#x20; \---\
> &#x20; \## 특이사항\
> &#x20; \* ST008 cd 91번(옵션변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값 에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.<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":{"OrdGoodsInfoRequest":{"type":"object","description":"단품 변경 DTO","properties":{"ordNo":{"type":"string","description":"주문번호","minLength":1},"ordSeq":{"type":"integer","format":"int32","description":"주문순번"},"ordProcSeq":{"type":"integer","format":"int32","description":"주문처리순번"},"goodsNo":{"type":"string","description":"상품번호순번","minLength":1},"itmNo":{"type":"string","description":"단품번호","minLength":1},"chngItmNo":{"type":"string","description":"변경단품번호","minLength":1},"ordQty":{"type":"integer","format":"int32","description":"수량"},"salePrc":{"type":"number","description":"판매가"},"goodsNm":{"type":"string","description":"상품명"}},"required":["chngItmNo","goodsNo","itmNo","ordNo","ordProcSeq","ordSeq"]},"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":{"/v1/claim/orderClaimProc/ordChange":{"post":{"tags":["주문클레임처리"],"summary":"주문변경 > 주문상품의 단품을 변경합니다.","description":"  ## 기능 설명\n  * 주문상품의 단품을 변경합니다.\n  ---\n  ## 상세 설명\n  * 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.\n  * 다건의 옵션 변경이 가능합니다.\n  * 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.\n  * 동일단품, 예약상품의 단품은 변경 불가능합니다.\n  ---\n  ## 특이사항\n  * ST008 cd 91번(옵션변경)의 ref_1_val(OM005), ref_2_val(OM003)값 에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\n","operationId":"ordChange","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrdGoodsInfoRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문변경 > 주문 배송지 목록을 조회합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 주문 배송지를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문 배송지를 조회합니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* \`\`\`Release v2.00\_240827\`\`\`: 주문 번호로 주문 배송지 목록을 조회\
> &#x20; \* \`\`\`Release v2.00\_240829\`\`\`: 마스킹 처리 현행화<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":{"DeliveryDetailRequest":{"type":"object","properties":{"ordNo":{"type":"string"},"deliNo":{"type":"string"},"dlvpSeq":{"type":"string"}}},"OrderChangeDlvpResponse":{"type":"object","description":"주문 배송지 조회 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"dlvpSeq":{"type":"string","description":"배송순번"},"deliNo":{"type":"string","description":"배송번호"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"주소"},"dtlAddr":{"type":"string","description":"상세주소"},"deliMsg":{"type":"string","description":"배송메시지"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"deliRegnGrpYn":{"type":"string","description":"도서산간지역여부"},"deliGbCd":{"type":"string","description":"배송구분코드(LO001)"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"ordDtlStatNm":{"type":"string","description":"주문내역상태"},"ordDtlGbNm":{"type":"string","description":"주문내역구분"},"ordGbCd":{"type":"string","description":"주문구분코드"},"ordGbNm":{"type":"string","description":"주문구분"},"ordPrc":{"type":"integer","format":"int64","description":"주문금액"},"goodsTypNm":{"type":"string","description":"상품유형"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"frgnDirPurGoodsYn":{"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":{"/v1/claim/orderClaimProc/getOrderChangeDlvp":{"post":{"tags":["주문클레임처리"],"summary":"주문변경 > 주문 배송지 목록을 조회합니다.","description":"  ## 기능 설명\n  * 주문 배송지를 조회합니다.\n  ---\n  ## 상세 설명\n  * 주문 배송지를 조회합니다.\n  ---\n  ## 수정번호\n  * ```Release v2.00_240827```: 주문 번호로 주문 배송지 목록을 조회\n  * ```Release v2.00_240829```: 마스킹 처리 현행화\n","operationId":"getOrderChangeDlvpList","parameters":[{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryDetailRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderChangeDlvpResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## 도서산간 지역 여부를 조회합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 도서 산간 지역 여부를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 도서 산간 지역 여부를 조회합니다.<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":{"DeliveryRegionRequest":{"type":"object","description":"도서산간 조회 DTO","properties":{"zipNo":{"type":"string","description":"변경후우편번호"},"originZipNo":{"type":"string","description":"변경전우편번호"},"deliPolcNo":{"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":{"/v1/claim/orderClaimProc/deliveryRegionCheck":{"post":{"tags":["주문클레임처리"],"summary":"도서산간 지역 여부를 조회합니다.","description":"  ## 기능 설명\n  * 도서 산간 지역 여부를 조회합니다.\n  ---\n  ## 상세 설명\n  * 도서 산간 지역 여부를 조회합니다.\n","operationId":"deliveryRegionCheck","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryRegionRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 > 결제/환불 현황 팝업 조회

> &#x20; \## 기능설명\
> &#x20; \* 주문 관리 > 주문 클레임 처리 화면의 결제/환불 정보에서 결제/환불 현황 버튼 클릭 시 해당 주문의 결제/환불 이력 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세설명\
> &#x20; \* 주결제수단과 보조결제수단으로 0원 초과의 금액 결제/환불이 발생했을 경우 쌓이는 결제 데이터입니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* Release v2.00\_240829 : 우편주소 마스킹 처리 추가<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":{"PaymentMgmtPopupRequest":{"type":"object","properties":{"ordNo":{"type":"string"}}},"RealGridListResponsePaymentRefundPrcondResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/PaymentRefundPrcondResponse"}}}},"PaymentRefundPrcondResponse":{"type":"object","properties":{"payGbNm":{"type":"string","description":"결제구분"},"payWayCd":{"type":"string","description":"결제수단코드(OM013) 11:신용카드, 12:실시간계좌이체, 32:마일리지"},"payWayNm":{"type":"string","description":"결제/환불수단"},"payStatNm":{"type":"string","description":"결제/환불상태"},"payFnshDtm":{"type":"string","format":"date-time","description":"결제/환불완료일시"},"payAmt":{"type":"number","description":"결제금액"},"methodType":{"type":"string","description":"결제수단 타입"},"cardBank":{"type":"string","description":"카드/은행명"},"cardNo":{"type":"string","description":"카드번호"},"actnNo":{"type":"string","description":"계좌번호"},"mid":{"type":"string","description":"MID"},"dpmnNm":{"type":"string","description":"입금자/예금주"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dptCnfmDtm":{"type":"string","format":"date-time","description":"입금확인일시"},"aprvNo":{"type":"string","description":"승인번호"},"nintDivYn":{"type":"string","description":"할부여부"},"divMonCnt":{"type":"integer","format":"int32","description":"할부개월"},"claimNo":{"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":{"/v1/claim/orderClaimProc/getPaymentRefundPrcondList":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 > 결제/환불 현황 팝업 조회","description":"  ## 기능설명\n  * 주문 관리 > 주문 클레임 처리 화면의 결제/환불 정보에서 결제/환불 현황 버튼 클릭 시 해당 주문의 결제/환불 이력 목록을 조회합니다.\n  ---\n  ## 상세설명\n  * 주결제수단과 보조결제수단으로 0원 초과의 금액 결제/환불이 발생했을 경우 쌓이는 결제 데이터입니다.\n  ---\n  ## 수정번호\n  * Release v2.00_240829 : 우편주소 마스킹 처리 추가\n","operationId":"getPaymentRefundPrcondList","parameters":[{"name":"paymentMgmtPopupRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/PaymentMgmtPopupRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponsePaymentRefundPrcondResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문변경 > 옵션 변경이 가능한 상품을 조회 합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 현재 주문 상품 중 옵션 변경이 가능한 상품 목록을 조회 합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 현재 주문 상품 중 옵션 변경이 가능한 상품 목록을 조회 합니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* \`\`\`Release v2.00\_240711\`\`\`: 추가 배송비 개선에 따른 배송정책번호(deli\_polc\_no) 조회 추가<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"RealGridListResponseOrderChangeItmResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderChangeItmResponse"}}}},"OrderChangeItmResponse":{"type":"object","description":"주문변경 현재 주문 상품 중 변경 가능한 단품 목록 조회 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","format":"int32","description":"주문순번"},"ordProcSeq":{"type":"integer","format":"int32","description":"주문처리순번"},"deliNo":{"type":"string","description":"배송번호"},"dlvpSeq":{"type":"string","description":"배송순번"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"salePrc":{"type":"number","description":"판매가"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"ordSaleTypNm":{"type":"string","description":"주문판매유형(OM004)"},"ordDtlStatCd":{"type":"string","description":"주문내역상태코드(OM005)"},"ordDtlStatNm":{"type":"string","description":"주문내역상태명"},"ordManNm":{"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":{"/v1/claim/orderClaimProc/getOrderChangeItmList":{"get":{"tags":["주문클레임처리"],"summary":"주문변경 > 옵션 변경이 가능한 상품을 조회 합니다.","description":"  ## 기능 설명\n  * 현재 주문 상품 중 옵션 변경이 가능한 상품 목록을 조회 합니다.\n  ---\n  ## 상세 설명\n  * 현재 주문 상품 중 옵션 변경이 가능한 상품 목록을 조회 합니다.\n  ---\n  ## 수정번호\n  * ```Release v2.00_240711```: 추가 배송비 개선에 따른 배송정책번호(deli_polc_no) 조회 추가\n","operationId":"getOrderChangeItmList","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderChangeItmResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## 주문관리 > 주문 클레임 처리 결제/환불 정보 중 프로모션 정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문번호에 해당하는 사용한 프로모션 정보(쿠폰, 할인, 적립마일리지)를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문번호에 해당하는 사용한 프로모션 정보(쿠폰, 할인, 적립마일리지)를 조회합니다.<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"OrderClaimPromotionInfoResponse":{"type":"object","description":"주문클레임 처리 프로모션 정보 조회 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"cpnGoodsDcGoodsNm":{"type":"string","description":"상품할인쿠폰 상품명"},"cpnGoodsDcAmt":{"type":"integer","format":"int32","description":"상품할인쿠폰"},"cpnCartDcAmt":{"type":"integer","format":"int32","description":"장바구니쿠폰"},"stafDcAmt":{"type":"integer","format":"int32","description":"임직원할인"},"cpnOvrlpDcAmt":{"type":"integer","format":"int32","description":"중복할인쿠폰"},"cpnFreeDlvrycAmt":{"type":"integer","format":"int32","description":"무료배송비쿠폰"},"cpnFreeRtnDlvrycAmt":{"type":"integer","format":"int32","description":"무료반품비쿠폰"},"acclmMileageAmt":{"type":"integer","format":"int32","description":"적립마일리지"},"goodsDirectAmt":{"type":"integer","format":"int32","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":{"/v1/claim/orderClaimProc/getOrdClmProcPromotionInfo":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 결제/환불 정보 중 프로모션 정보 조회","description":"  ## 기능 설명\n  * 주문번호에 해당하는 사용한 프로모션 정보(쿠폰, 할인, 적립마일리지)를 조회합니다.\n  ---\n  ## 상세 설명\n  * 주문번호에 해당하는 사용한 프로모션 정보(쿠폰, 할인, 적립마일리지)를 조회합니다.\n","operationId":"getOrdClmProcPromotionInfo","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderClaimPromotionInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 결제/환불 정보 중 결제수단 정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문번호에 해당하는 결제수단 정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문번호에 해당하는 결제수단 정보를 조회합니다.<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"OrderClaimPayWayInfoResponse":{"type":"object","description":"결제수단 정보 조회 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명"},"lclPayAmt":{"type":"string","description":"로컬결제금액"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"payStatCdNm":{"type":"string","description":"결제상태코드명"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"bankCdNm":{"type":"string","description":"은행코드명(OM026)"},"actnNo":{"type":"string","description":"계좌번호"},"dpmnNm":{"type":"string","description":"입금자명"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dptCnfmDtm":{"type":"string","format":"date-time","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":{"/v1/claim/orderClaimProc/getOrdClmProcPayWayInfoList":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 결제/환불 정보 중 결제수단 정보 조회","description":"  ## 기능 설명\n  * 주문번호에 해당하는 결제수단 정보를 조회합니다.\n  ---\n  ## 상세 설명\n  * 주문번호에 해당하는 결제수단 정보를 조회합니다.\n","operationId":"getOrdClmProcPayWayInfoList","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimPayWayInfoResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 결제/환불 정보 중 결제상세 정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문번호에 해당하는 결제상세 정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 결제 상세 정보 및 미결제 금액, 환불대기금액, 미환불금액, 결제/환불 오류 금액을 조회합니다.<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"OrderClaimPayDtlInfoResponse":{"type":"object","description":"결제상세 정보 조회 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"nonPayAmt":{"type":"integer","format":"int32","description":"미결제금액"},"rfndWaitAmt":{"type":"integer","format":"int32","description":"환불대기금액"},"nonRfndAmt":{"type":"integer","format":"int32","description":"미환불금액"},"rfndErrorAmt":{"type":"integer","format":"int32","description":"환불오류금액"},"goodsAmt":{"type":"integer","format":"int32","description":"상품금액"},"dcAmt":{"type":"number","description":"할인금액"},"dlvryChrg":{"type":"integer","format":"int32","description":"배송비"},"payAmt":{"type":"number","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":{"/v1/claim/orderClaimProc/getOrdClmProcPayDtlInfo":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 결제/환불 정보 중 결제상세 정보 조회","description":"  ## 기능 설명\n  * 주문번호에 해당하는 결제상세 정보를 조회합니다.\n  ---\n  ## 상세 설명\n  * 결제 상세 정보 및 미결제 금액, 환불대기금액, 미환불금액, 결제/환불 오류 금액을 조회합니다.\n","operationId":"getOrdClmProcPayDtlInfo","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderClaimPayDtlInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 주문정보 및 회원정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문목록에서 선택한 주문 row의 주문정보와 주문자 정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 선택한 주문 row의 주문번호로 주문정보와 주문자 정보를 조회합니다.\
> &#x20; \* 회원일 경우에 한해서 쿠폰 개수는 프로모션 api, 현재 사용 가능한 마일리지는 회원 api 통해 조회해 옵니다.<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"OrderClaimOrdMbrInfoResponse":{"type":"object","description":"주문정보 및 회원정보 조회 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"ordNo":{"type":"string","description":"주문번호"},"ordAccpDtm":{"type":"string","format":"date-time","description":"주문접수일시"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"ordMediaCdNm":{"type":"string","description":"주문매체코드명"},"siteNm":{"type":"string","description":"사이트명"},"ordManNm":{"type":"string","description":"회원명"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)"},"mbrGradeCdNm":{"type":"string","description":"회원등급명"},"mbrMgrCd":{"type":"string","description":"회원관리코드(ME002)"},"mbrMgrCdNm":{"type":"string","description":"회원등급코드명"},"cashRcptYn":{"type":"string","description":"현금영수증신청여부"},"emailAddr":{"type":"string","description":"이메일"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"instMbrYn":{"type":"string","description":"관심고객"},"instMbrGbNm":{"type":"string","description":"관심고객 구분"},"loginId":{"type":"string","description":"회원ID"},"mbrNo":{"type":"string","description":"회원번호"},"dlvCnt":{"type":"integer","format":"int32","description":"무료배송쿠폰 개수"},"cpnCnt":{"type":"integer","format":"int32","description":"쿠폰 개수"},"mlgAvalAmt":{"type":"integer","format":"int64","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":{"/v1/claim/orderClaimProc/getOrdClmProcOrdMbrInfo":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 주문정보 및 회원정보 조회","description":"  ## 기능 설명\n  * 주문목록에서 선택한 주문 row의 주문정보와 주문자 정보를 조회합니다.\n  ---\n  ## 상세 설명\n  * 선택한 주문 row의 주문번호로 주문정보와 주문자 정보를 조회합니다.\n  * 회원일 경우에 한해서 쿠폰 개수는 프로모션 api, 현재 사용 가능한 마일리지는 회원 api 통해 조회해 옵니다.\n","operationId":"getOrdClmProcOrdMbrInfo","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderClaimOrdMbrInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 주문내역 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문 관리 > 주문 클레임 처리에서 고객 목록 조회 후 선택한 고객 row의 주문목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 선택한 고객 row의 mbrNo와 cellNo를 조건으로 하여 주문목록을 조회합니다.\
> &#x20; \* 주문번호 입력 시에는 주문번호 또한 조건으로 하여 주문목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* Release v2.00\_240530: 날짜조회 쿼리 변경<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"RealGridListResponseOrderClaimOrdInfoListResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimOrdInfoListResponse"}}}},"OrderClaimOrdInfoListResponse":{"type":"object","description":"주문 클레임 처리 주문내역 목록 DTO","properties":{"rglrDeliNo":{"type":"string","description":"정기배송번호"},"ordNo":{"type":"string","description":"주문번호"},"ordManNm":{"type":"string","description":"주문자명"},"siteNm":{"type":"string","description":"사이트명"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"ordMediaCdNm":{"type":"string","description":"주문매체코드명"},"ordGbCd":{"type":"string","description":"주문구분코드(OM002)"},"ordGbCdNm":{"type":"string","description":"주문구분코드명"},"ordAccpDtm":{"type":"string","format":"date-time","description":"주문접수일"},"salePrc":{"type":"number","description":"주문금액"},"dcAmt":{"type":"number","description":"할인금액"},"dlvryCost":{"type":"number","description":"배송비"},"totalSalePrc":{"type":"number","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":{"/v1/claim/orderClaimProc/getOrdClmProcOrdInfoList":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 주문내역 조회","description":"  ## 기능 설명\n  * 주문 관리 > 주문 클레임 처리에서 고객 목록 조회 후 선택한 고객 row의 주문목록을 조회합니다.\n  ---\n  ## 상세 설명\n  * 선택한 고객 row의 mbrNo와 cellNo를 조건으로 하여 주문목록을 조회합니다.\n  * 주문번호 입력 시에는 주문번호 또한 조건으로 하여 주문목록을 조회합니다.\n  ---\n  ## 수정번호\n  * Release v2.00_240530: 날짜조회 쿼리 변경\n","operationId":"getOrdClmProcOrdInfoList","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"cellNo","in":"query","description":"휴대전화번호","schema":{"type":"String"}},{"name":"ordNo","in":"query","description":"주문번호","schema":{"type":"String"}},{"name":"mbrNo","in":"query","description":"회원번호","schema":{"type":"String"}},{"name":"ordAccpStrtDt","in":"query","description":"주문접수시작일","schema":{"type":"LocalDate"}},{"name":"ordAccpEndDt","in":"query","description":"주문접수종료일","schema":{"type":"LocalDate"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimOrdInfoListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 주문상품내역 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문번호에 해당하는 주문상품 내역을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* BO 시스템 클레임처리 가능상태(ST008) 그룹코드의 주문내역상태코드(ref\_1\_val) 과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 조회 후 해당하는 버튼을 노출합니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \- \`\`\`release\_231009\_01\`\`\`: 주문혜택관계 테이블 컬럼 추가(ORD\_QTY, CNCL\_QTY)로 인한 쿼리 수정\
> &#x20; \- \`\`\`Release v2.00\_240729\`\`\`: 취소 가능 여부(ordCnclPsbYn), 회수여부(wthdYn), e쿠폰번호(ecpnNo), e티켓번호(etcktNo) 추가\
> &#x20; \- \`\`\`Release v2.00\_240829\`\`\`: 마스킹 처리 현행화<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"RealGridListResponseOrderClaimOrdGoodsInfoResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimOrdGoodsInfoResponse"}}}},"OrderClaimOrdGoodsInfoResponse":{"type":"object","description":"주문상품내역 조회 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordDtlGbCd":{"type":"string","description":"주문내역구분코드(OM003)"},"ordDtlGbCdNm":{"type":"string","description":"주문내역구분코드명"},"ordGbCd":{"type":"string","description":"주문구분코드(OM002)"},"ordGbCdNm":{"type":"string","description":"주문구분코드명"},"ordSeq":{"type":"string","description":"주문순번"},"ordProcSeq":{"type":"string","description":"주문처리순번"},"claimNo":{"type":"string","description":"클레임번호"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"goodsTypCdNm":{"type":"string","description":"상품유형코드명"},"brandNm":{"type":"string","description":"브랜드명"},"ordDtlStatCd":{"type":"string","description":"주문내역상세구분코드(OM005)"},"ordDtlStatCdNm":{"type":"string","description":"주문내역상세구분코드명"},"prestNm":{"type":"string","description":"증정품명"},"salePrc":{"type":"number","description":"판매가"},"dcAmt":{"type":"number","description":"할인금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"rtnQty":{"type":"integer","format":"int32","description":"반품수량"},"ordAmt":{"type":"number","description":"주문금액"},"deliNo":{"type":"string","description":"배송번호"},"deliKindCd":{"type":"string","description":"배송종류코드(LO009)"},"deliKindCdNm":{"type":"string","description":"배송종류코드명"},"shipWaitCaus":{"type":"string","description":"출고대기사유코드(LO007)"},"shipWaitCausNm":{"type":"string","description":"출고대기사유코드명"},"shipWaitCausCont":{"type":"string","description":"출고대기상세사유"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"deliAddr":{"type":"string","description":"배송지"},"deliMethodCd":{"type":"string","description":"배송방법코드(LO010)"},"deliMethodCdNm":{"type":"string","description":"배송방법코드명"},"ordAccpDtm":{"type":"string","format":"date-time","description":"주문접수일"},"ordFnshDtm":{"type":"string","format":"date-time","description":"주문완료일"},"entrNo":{"type":"string","description":"협력사번호"},"orginDeliNo":{"type":"string","description":"원배송번호"},"rtnDeliNo":{"type":"string","description":"회수배송번호"},"deliPolcNo":{"type":"string","description":"배송비정책번호"},"deliGbCd":{"type":"string","description":"배송구분코드(LO001)"},"claimMgrpCd":{"type":"string","description":"클레임중분류코드(OM006)"},"claimCauseFaultType":{"type":"string","description":"클레임귀책유형(10: 고객귀책 / 20: 당사귀책)"},"wthdFnshGbCd":{"type":"string","description":"회수완료구분코드(LO011)"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"ordCnclPsbYn":{"type":"string","description":"취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnNo":{"type":"string","description":"e쿠폰번호"},"rtnRejectProcSeq":{"type":"string","description":"반품철회주문처리순번"},"buttonCdList":{"type":"array","description":"클레임버튼목록","items":{"type":"string"}},"deliSeq":{"type":"integer","format":"int32","description":"배송순번"},"deliDtlStatCd":{"type":"string","description":"배송상세코드명"},"deliDtlStatCdNm":{"type":"string","description":"배송상세코드(LO016)"},"shipQty":{"type":"integer","format":"int32","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":{"/v1/claim/orderClaimProc/getOrdClmProcOrdGoodsList":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 주문상품내역 조회","description":"  ## 기능 설명\n  * 주문번호에 해당하는 주문상품 내역을 조회합니다.\n  ---\n  ## 상세 설명\n  * BO 시스템 클레임처리 가능상태(ST008) 그룹코드의 주문내역상태코드(ref_1_val) 과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 조회 후 해당하는 버튼을 노출합니다.\n  ---\n  ## 수정번호\n  - ```release_231009_01```: 주문혜택관계 테이블 컬럼 추가(ORD_QTY, CNCL_QTY)로 인한 쿼리 수정\n  - ```Release v2.00_240729```: 취소 가능 여부(ordCnclPsbYn), 회수여부(wthdYn), e쿠폰번호(ecpnNo), e티켓번호(etcktNo) 추가\n  - ```Release v2.00_240829```: 마스킹 처리 현행화\n","operationId":"getOrdClmProcOrdGoodsList","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimOrdGoodsInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## 주문관리 > 주문 클레임 처리 > 적립마일리지 상세 팝업 조회

> &#x20; \## 기능설명\
> &#x20; \* 주문 관리 > 주문 클레임 처리 화면의 결제/환불 정보에서 프로모션 > 적립마일리지 클릭 시 해당 주문의 적립/적립(예정)/취소 상태의 마일리지 이력 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세설명\
> &#x20; \* 주문/클레임 발생 시에 혜택 테이블에 쌓인 적립 이력들을 클레임 번호 단위로 조회합니다.<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":{"OrdBaseRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"tmpOrdNo":{"type":"string"},"bsketNo":{"type":"string"},"ordMediaCd":{"type":"string"},"mbrNo":{"type":"string"},"ordManNm":{"type":"string"},"ordAccpDtm":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"},"mbrGradeCd":{"type":"string"},"mbrMgrCd":{"type":"string"},"fstOrdYn":{"type":"string"},"umemEmailAddr":{"type":"string"},"umemCellSctNo":{"type":"string"},"umemCellTxnoNo":{"type":"string"},"umemCellEndNo":{"type":"string"},"umemTelRgnNo":{"type":"string"},"umemTelTxnoNo":{"type":"string"},"umemTelEndNo":{"type":"string"},"umemZipNoSeq":{"type":"integer","format":"int32"},"umemZipNo":{"type":"string"},"umemZipAddr":{"type":"string"},"umemDtlAddr":{"type":"string"},"rfdBankCd":{"type":"string"},"rfdActnNo":{"type":"string"},"rfdActnDepositorNm":{"type":"string"},"trnsDt":{"type":"string"},"trnsTm":{"type":"string"},"ordNo":{"type":"string"},"ordRsltCd":{"type":"string"},"ordRsltMsgCont":{"type":"string"},"rtnExchgGbCd":{"type":"string"},"deilRtnGbCd":{"type":"string"},"pagingYn":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"goodsImgDomain":{"type":"string"},"condxSysRegDtmAll":{"type":"string"},"umbrNo":{"type":"string"}}},"RealGridListResponseOrderClaimMileageHistResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimMileageHistResponse"}}}},"OrderClaimMileageHistResponse":{"type":"object","properties":{"claimNo":{"type":"string","description":"클레임번호"},"purchaseAmt":{"type":"integer","format":"int64","description":"구매금액"},"mileage":{"type":"integer","format":"int64","description":"마일리지"},"procDtm":{"type":"string","format":"date-time","description":"처리일시"},"rsrvYn":{"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":{"/v1/claim/orderClaimProc/getOrdClmProcMileageHistList":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 > 적립마일리지 상세 팝업 조회","description":"  ## 기능설명\n  * 주문 관리 > 주문 클레임 처리 화면의 결제/환불 정보에서 프로모션 > 적립마일리지 클릭 시 해당 주문의 적립/적립(예정)/취소 상태의 마일리지 이력 목록을 조회합니다.\n  ---\n  ## 상세설명\n  * 주문/클레임 발생 시에 혜택 테이블에 쌓인 적립 이력들을 클레임 번호 단위로 조회합니다.\n","operationId":"getOrdClmProcMileageHistList","parameters":[{"name":"ordBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrdBaseRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimMileageHistResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 고객목록 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문 관리 > 주문 클레임 처리에서 조회 버튼 클릭 시 고객목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 회원ID/명, 휴대폰번호, 주문번호에 해당하는 고객목록을 조회 합니다.\
> &#x20; \* 비회원의 경우 회원ID/명 입력 후 조회 시 조회 되지 않습니다.\
> &#x20; \* 주문을 한번이라도 했던 고객에 한하여 조회됩니다. 주문을 하지 않은 고객에 대해서는 조회되지 않습니다.\
> &#x20; \## 수정번호\
> &#x20; \* Release v2.00\_241120: 회원 정보 테이블을 기준으로 주문이 있는 고객 목록을 조회하도록 변경(기존:주문기본 테이블 기준)<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"RealGridListResponseOrderClaimMbrInfoListResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimMbrInfoListResponse"}}}},"OrderClaimMbrInfoListResponse":{"type":"object","description":"주문클레임 처리 고객목록 조회 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"로그인아이디"},"mbrNm":{"type":"string","description":"회원명"},"mbrGbCd":{"type":"string","description":"회원구분코드(ME001)"},"mbrGbCdNm":{"type":"string","description":"회원구분코드명"},"mbrGradeCd":{"type":"string","description":"회원등급코드(ME008)"},"mbrGradeCdNm":{"type":"string","description":"회원등급코드명"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"emailAddr":{"type":"string","description":"이메일주소"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"siteNm":{"type":"string","description":"사이트명"},"telNo":{"type":"string","description":"전화번호"},"cellNo":{"type":"string","description":"휴대폰번호"},"mgrGbCd":{"type":"string","description":"관리회원구분코드(ME019)"},"mgrGbCdNm":{"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":{"/v1/claim/orderClaimProc/getOrdClmProcMbrInfoList":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 고객목록 조회","description":"  ## 기능 설명\n  * 주문 관리 > 주문 클레임 처리에서 조회 버튼 클릭 시 고객목록을 조회합니다.\n  ---\n  ## 상세 설명\n  * 회원ID/명, 휴대폰번호, 주문번호에 해당하는 고객목록을 조회 합니다.\n  * 비회원의 경우 회원ID/명 입력 후 조회 시 조회 되지 않습니다.\n  * 주문을 한번이라도 했던 고객에 한하여 조회됩니다. 주문을 하지 않은 고객에 대해서는 조회되지 않습니다.\n  ## 수정번호\n  * Release v2.00_241120: 회원 정보 테이블을 기준으로 주문이 있는 고객 목록을 조회하도록 변경(기존:주문기본 테이블 기준)\n","operationId":"getOrdClmProcMbrInfoList","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"mbrIdNm","in":"query","description":"회원ID/명","schema":{"type":"String"}},{"name":"cellNo","in":"query","description":"휴대전화번호","schema":{"type":"String"}},{"name":"ordNo","in":"query","description":"주문번호","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimMbrInfoListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 상품 정보 및 협력사 정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 하나의 주문 상품 row에 해당하는 상품 정보와 상품 협력사 정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 하나의 주문 상품 row에 해당하는 상품 정보와 상품 협력사 정보를 조회합니다.<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":{"GoodsEntrInfoRequest":{"type":"object","properties":{"entrNo":{"type":"string"},"itmNo":{"type":"string"},"goodsNo":{"type":"string"},"deliPolcNo":{"type":"string"}}},"OrderClaimGoodsEntrInfoResponse":{"type":"object","description":"상품 정보 및 협력사 정보 조회 DTO","properties":{"orderClaimEntrInfoResponses":{"type":"array","description":"협력사정보","items":{"$ref":"#/components/schemas/OrderClaimEntrInfoResponse"}},"orderClaimGoodsInfoResponses":{"type":"array","description":"상품정보","items":{"$ref":"#/components/schemas/OrderClaimGoodsInfoResponse"}},"orderClaimEtDeliPolcInfoResponses":{"type":"array","description":"배송정책정보","items":{"$ref":"#/components/schemas/OrderClaimEtDeliPolcInfoResponse"}}}},"OrderClaimEntrInfoResponse":{"type":"object","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"entrGbCd":{"type":"string","description":"협력사구분코드(VD001)"},"entrGbCdNm":{"type":"string","description":"협력사구분코드명"},"latt":{"type":"string","description":"위도"},"lngt":{"type":"string","description":"경도"},"trdTypCd":{"type":"string","description":"거래유형코드(VD002)"},"trdStatCd":{"type":"string","description":"거래상태코드(VD003)"},"trdStatCdNm":{"type":"string","description":"거래상태코드명"},"lgcEntrNo":{"type":"string","description":"기간계협력사번호"},"rpstmnNm":{"type":"string","description":"대표자명"},"bmanNo":{"type":"string","description":"사업자 번호"},"corpnNo":{"type":"string","description":"법인번호"},"btyp":{"type":"string","description":"업태"},"bkind":{"type":"string","description":"업종"},"contStrtDy":{"type":"string","description":"계약시작일자"},"contEndDy":{"type":"string","description":"계약종료일자"},"aempNm":{"type":"string","description":"담당자명"},"aempTelRgnNo":{"type":"string","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","description":"담당자휴대폰끝번호"},"faxRgnNo":{"type":"string","description":"팩스지역번호"},"faxTxnoNo":{"type":"string","description":"팩스국번번호"},"faxEndNo":{"type":"string","description":"팩스끝번호"},"bmanKindCd":{"type":"string","description":"사업자종류코드(VD004)"},"zipNoSeq":{"type":"string","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rmkCont":{"type":"string","description":"비고내용"},"mrgnRateGbCd":{"type":"string","description":"마진율구분코드(VD008)"},"mrgnRate1":{"type":"string","description":"마진율1"},"mrgnRate2":{"type":"string","description":"마진율2"}}},"OrderClaimGoodsInfoResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsCompCdNm":{"type":"string","description":"상품구성코드명"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"goodsTypCdNm":{"type":"string","description":"상품유형코드명"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"saleMethCdNm":{"type":"string","description":"판매방식코드명"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"string","description":"최소제한수량"},"maxLmtQty":{"type":"string","description":"최대제한수량"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"supPcost":{"type":"number","description":"공급가"},"norPrc":{"type":"number","description":"정상가"},"preSalePrc":{"type":"number","description":"기존판매가"},"salePrc":{"type":"number","description":"판매가"},"mrgnRate":{"type":"number","description":"마진율"},"payMeanInfo":{"type":"string","description":"결제수단정보"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stkQty":{"type":"integer","format":"int32","description":"수량"},"prestNm":{"type":"string","description":"증정품명"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"},"tsupPrc":{"type":"number"},"tsalePrc":{"type":"number"}}},"OrderClaimEtDeliPolcInfoResponse":{"type":"object","properties":{"deliPolcNo":{"type":"string","description":"배송정책번호"},"entrNo":{"type":"string","description":"협력사번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005)"},"stdAmt":{"type":"integer","format":"int64","description":"기준금액"},"dlexAmt":{"type":"number","description":"배송비금액"},"wthdRtnAmt":{"type":"number","description":"회수반품비"},"exchDlex":{"type":"integer","format":"int64","description":"교환배송비"},"addDlexInfoList":{"type":"array","description":"추가배송비","items":{"$ref":"#/components/schemas/EtAddDlexInfoResponse"}},"useYn":{"type":"string","description":"사용여부"}}},"EtAddDlexInfoResponse":{"type":"object","description":"추가배송비정보 Response","properties":{"deliRegnGrpNo":{"type":"string","description":"배송지역그룹번호"},"deliRegnGrpNm":{"type":"string","description":"배송지역그룹명"},"addDlexAmt":{"type":"number","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":{"/v1/claim/orderClaimProc/getOrdClmProcGoodsEntrInfo":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 상품 정보 및 협력사 정보 조회","description":"  ## 기능 설명\n  * 하나의 주문 상품 row에 해당하는 상품 정보와 상품 협력사 정보를 조회합니다.\n  ---\n  ## 상세 설명\n  * 하나의 주문 상품 row에 해당하는 상품 정보와 상품 협력사 정보를 조회합니다.\n","operationId":"getOrdClmProcGoodsEntrInfo","parameters":[{"name":"goodsEntrInfoRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsEntrInfoRequest"}},{"name":"entrNo","in":"query","description":"협력사번호","required":true,"schema":{"type":"String"}},{"name":"itmNo","in":"query","description":"단품번호","required":true,"schema":{"type":"String"}},{"name":"goodsNo","in":"query","description":"상품번호","required":true,"schema":{"type":"String"}},{"name":"deliPolcNo","in":"query","description":"배송정책번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderClaimGoodsEntrInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 > 혜택 적용이력 팝업 조회

> &#x20; \## 기능설명\
> &#x20; \* 주문 관리 > 주문 클레임 처리 화면의 결제/환불 정보에서 혜택적용 이력 버튼 클릭 시 해당 주문에 적용/취소 된 혜택 이력 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세설명\
> &#x20; \* 주문/클레임 발생 시에 혜택 테이블에 쌓인 할인 이력들을 클레임 번호 단위로 조회합니다.<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":{"OrdBaseRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"tmpOrdNo":{"type":"string"},"bsketNo":{"type":"string"},"ordMediaCd":{"type":"string"},"mbrNo":{"type":"string"},"ordManNm":{"type":"string"},"ordAccpDtm":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"},"mbrGradeCd":{"type":"string"},"mbrMgrCd":{"type":"string"},"fstOrdYn":{"type":"string"},"umemEmailAddr":{"type":"string"},"umemCellSctNo":{"type":"string"},"umemCellTxnoNo":{"type":"string"},"umemCellEndNo":{"type":"string"},"umemTelRgnNo":{"type":"string"},"umemTelTxnoNo":{"type":"string"},"umemTelEndNo":{"type":"string"},"umemZipNoSeq":{"type":"integer","format":"int32"},"umemZipNo":{"type":"string"},"umemZipAddr":{"type":"string"},"umemDtlAddr":{"type":"string"},"rfdBankCd":{"type":"string"},"rfdActnNo":{"type":"string"},"rfdActnDepositorNm":{"type":"string"},"trnsDt":{"type":"string"},"trnsTm":{"type":"string"},"ordNo":{"type":"string"},"ordRsltCd":{"type":"string"},"ordRsltMsgCont":{"type":"string"},"rtnExchgGbCd":{"type":"string"},"deilRtnGbCd":{"type":"string"},"pagingYn":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"goodsImgDomain":{"type":"string"},"condxSysRegDtmAll":{"type":"string"},"umbrNo":{"type":"string"}}},"RealGridListResponseOrderClaimFvrAplyHistResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimFvrAplyHistResponse"}}}},"OrderClaimFvrAplyHistResponse":{"type":"object","properties":{"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"adtnBassNo":{"type":"string","description":"부가비용근거번호"},"adtnDtlGbNm":{"type":"string","description":"부가비용상세구분코드명"},"promoNm":{"type":"string","description":"쿠폰/프로모션명"},"adtnOcurGbCd":{"type":"string","description":"발생구분코드"},"useCnclDtm":{"type":"string","format":"date-time","description":"적용/취소일시"},"aplyAdtnAmt":{"type":"number","description":"적용금액"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"claimNo":{"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":{"/v1/claim/orderClaimProc/getOrdClmProcFvrAplyHistList":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 > 혜택 적용이력 팝업 조회","description":"  ## 기능설명\n  * 주문 관리 > 주문 클레임 처리 화면의 결제/환불 정보에서 혜택적용 이력 버튼 클릭 시 해당 주문에 적용/취소 된 혜택 이력 목록을 조회합니다.\n  ---\n  ## 상세설명\n  * 주문/클레임 발생 시에 혜택 테이블에 쌓인 할인 이력들을 클레임 번호 단위로 조회합니다.\n","operationId":"getOrdClmProcFvrAplyHistList","parameters":[{"name":"ordBaseRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrdBaseRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimFvrAplyHistResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 > 배송비 상세 내역 팝업 조회

> &#x20; \## 기능설명\
> &#x20; \* 주문 관리 > 주문 클레임 처리 화면의 결제/환불 정보에서 배송비 클릭 시 배송비 상세 내역을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세설명\
> &#x20; \* 해당하는 주문번호에 해당하는 배송비 상세 내역이 조회됩니다.\
> &#x20; \* 배송비 무료 쿠폰 사용 주문 건의 경우 쿠폰 발급 번호가 함께 조회됩니다.<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":{"DeliveryDetailRequest":{"type":"object","properties":{"ordNo":{"type":"string"},"deliNo":{"type":"string"},"dlvpSeq":{"type":"string"}}},"RealGridListResponseOrderClaimDeliveryHistResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimDeliveryHistResponse"}}}},"OrderClaimDeliveryHistResponse":{"type":"object","properties":{"deliNo":{"type":"string","description":"배송번호"},"stdAmt":{"type":"integer","format":"int64","description":"기준금액"},"dlexAmt":{"type":"number","description":"배송비금액"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"entrNm":{"type":"string","description":"협력사명"},"dlexAmtSum":{"type":"integer","format":"int64","description":"합계 배송비"},"dlvpNm":{"type":"string","description":"배송지명"},"adtnOcurGbNm":{"type":"string","description":"비용발생 구분"},"dlexOcurGbNm":{"type":"string","description":"배송비 구분"},"aplyAdtnAmt":{"type":"number","description":"적용금액"},"fvrPolcAplyVal":{"type":"integer","format":"int64","description":"혜택정책적용값"},"adtnDtlBassNo":{"type":"string","description":"부가비용상세근거번호"},"claimNo":{"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":{"/v1/claim/orderClaimProc/getOrdClmProcDeliveryHistList":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 > 배송비 상세 내역 팝업 조회","description":"  ## 기능설명\n  * 주문 관리 > 주문 클레임 처리 화면의 결제/환불 정보에서 배송비 클릭 시 배송비 상세 내역을 조회합니다.\n  ---\n  ## 상세설명\n  * 해당하는 주문번호에 해당하는 배송비 상세 내역이 조회됩니다.\n  * 배송비 무료 쿠폰 사용 주문 건의 경우 쿠폰 발급 번호가 함께 조회됩니다.\n","operationId":"getOrdClmProcDeliveryHistList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/DeliveryDetailRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimDeliveryHistResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 배송상세 및 반품/회수정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문번호에 해당하는 배송상세 및 반품/회수정보 내역을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 교환 주문의 경우, 교환건의 출하 row의 배송정보 회수 row의 반품 회수정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* Release v2.00\_240829 : 마스킹 처리 현행화<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":{"DeliveryReturnInfoRequest":{"type":"object","properties":{"ordNo":{"type":"string"},"ordSeq":{"type":"integer","format":"int32"},"ordProcSeq":{"type":"integer","format":"int32"},"originDeliNo":{"type":"string"},"rtnDeliNo":{"type":"string"},"deliSeq":{"type":"integer","format":"int32"}}},"OrderClaimDeliveryReturnInfoResponse":{"type":"object","description":"배송상세 및 반품/회수정보 조회 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"string","description":"주문순번"},"ordProcSeq":{"type":"string","description":"주문처리순번"},"ordDtlStatCd":{"type":"string","description":"주문내역상태코드(OM005)"},"ordDtlStatCdNm":{"type":"string","description":"주문내역상태코드명"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"hdcCd":{"type":"string","description":"택배사코드(LO005)"},"hdcCdNm":{"type":"string","description":"택배사명"},"invNo":{"type":"string","description":"송장번호"},"ordManNm":{"type":"string","description":"주문자명"},"rcvmnNm":{"type":"string","description":"수취인명"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039)"},"deliMsgCdNm":{"type":"string","description":"배송메시지코드명"},"exRtnGbCd":{"type":"string","description":"회수구분코드(OM002)"},"exRtnGbCdNm":{"type":"string","description":"회수구분코드명"},"exRtnStatCd":{"type":"string","description":"반품진행상태코드(OM005)"},"exRtnStatCdNm":{"type":"string","description":"반품진행상태코드명"},"claimMgrpCd":{"type":"string","description":"클레임중분류코드(OM006)"},"claimMgrpCdNm":{"type":"string","description":"클레임중분류코드명"},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"rtnDeliProcTypCd":{"type":"string","description":"회수처리유형코드(PR008)"},"rtnDeliProcTypCdNm":{"type":"string","description":"회수처리유형코드명"},"rtnHdcCd":{"type":"string","description":"수거택배사코드(LO005)"},"rtnHdcCdNm":{"type":"string","description":"수거택배사코드명"},"rtnInvNo":{"type":"string","description":"수거송장번호"},"rtnZipNo":{"type":"string","description":"반품우편번호"},"rtnZipAddr":{"type":"string","description":"반품우편주소"},"rtnDtlAddr":{"type":"string","description":"반품상세주소"},"rtnDeliMsg":{"type":"string","description":"반품배송메시지"},"rtnDeliMsgCd":{"type":"string","description":"반품배송메시지코드(ME039)"},"rtnDeliMsgCdNm":{"type":"string","description":"반품배송메시지코드명"},"wthdFnshGbCdNm":{"type":"string","description":"회수완료구분(LO011)"},"deliDtlStatCdNm":{"type":"string","description":"배송내역상태코드명"},"persCstmCd":{"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":{"/v1/claim/orderClaimProc/getOrdClmProcDeliRtnInfo":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 배송상세 및 반품/회수정보 조회","description":"  ## 기능 설명\n  * 주문번호에 해당하는 배송상세 및 반품/회수정보 내역을 조회합니다.\n  ---\n  ## 상세 설명\n  * 교환 주문의 경우, 교환건의 출하 row의 배송정보 회수 row의 반품 회수정보를 조회합니다.\n  ---\n  ## 수정번호\n  * Release v2.00_240829 : 마스킹 처리 현행화\n","operationId":"getOrdClmProcDeliRtnInfo","parameters":[{"name":"deliveryReturnInfoRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/DeliveryReturnInfoRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}},{"name":"ordSeq","in":"query","description":"주문순번","schema":{"type":"Integer"}},{"name":"ordProcSeq","in":"query","description":"주문처리순번","schema":{"type":"Integer"}},{"name":"originDeliNo","in":"query","description":"원배송번호","schema":{"type":"String"}},{"name":"rtnDeliNo","in":"query","description":"회수배송번호","schema":{"type":"String"}},{"name":"deliSeq","in":"query","description":"배송순번","schema":{"type":"Integer"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderClaimDeliveryReturnInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 진행상태이력을 조회합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 배송의 진행상태이력 조회, 반품/회수의 진행상태이력을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 배송의 진행상태이력 조회, 반품/회수의 진행상태이력을 조회합니다.<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":{"OrdDtlStatHistSearchRequest":{"type":"object","properties":{"ordNo":{"type":"string"},"ordSeq":{"type":"integer","format":"int32"},"deliNo":{"type":"string"},"returnTabYn":{"type":"string"},"ordDtlGbCd":{"type":"string"},"chgDtm":{"type":"string","format":"date"}}},"RealGridListResponseOrderClaimOrdDtlStatChgHistResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimOrdDtlStatChgHistResponse"}}}},"OrderClaimOrdDtlStatChgHistResponse":{"type":"object","description":"진행상태이력조회 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"string","description":"주문순번"},"ordDtlStatCd":{"type":"string","description":"주문내역상태코드(OM005)"},"ordDtlStatCdNm":{"type":"string","description":"주문내역상태코드명"},"chgDtm":{"type":"string","format":"date-time","description":"변경일시"},"ordDtlGbCd":{"type":"string","description":"주문내역구분코드(OM002)"},"ordDtlGbCdNm":{"type":"string","description":"주문내역구분코드명"},"goodsNm":{"type":"string","description":"상품명"},"itmNm":{"type":"string","description":"단품명"},"ordDtlChgGbCd":{"type":"string","description":"변경구분코드(OM002)"},"ordDtlChgGbCdNm":{"type":"string","description":"변경구분코드명"},"orderClaimOrdDtlGbCdResponseList":{"type":"array","description":"주문내역구분코드목록","items":{"$ref":"#/components/schemas/OrderClaimOrdDtlGbCdResponse"}}}},"OrderClaimOrdDtlGbCdResponse":{"type":"object","description":"주문내역구분코드 목록 DTO","properties":{"chgDate":{"type":"string","format":"date","description":"변경일시"},"ordDtlGbCd":{"type":"string","description":"주문내역구분코드(OM002)"},"ordDtlGbCdNm":{"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":{"/v1/claim/orderClaimProc/getOrdClmOrdDtlStatChgHistList":{"get":{"tags":["주문클레임처리"],"summary":"진행상태이력을 조회합니다.","description":"  ## 기능 설명\n  * 배송의 진행상태이력 조회, 반품/회수의 진행상태이력을 조회합니다.\n  ---\n  ## 상세 설명\n  * 배송의 진행상태이력 조회, 반품/회수의 진행상태이력을 조회합니다.\n","operationId":"getOrdClmOrdDtlStatChgHistList","parameters":[{"name":"searchRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrdDtlStatHistSearchRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}},{"name":"ordSeq","in":"query","description":"주문순번","required":true,"schema":{"type":"int"}},{"name":"deliNo","in":"query","description":"배송번호","required":true,"schema":{"type":"String"}},{"name":"returnTabYn","in":"query","description":"반품회수탭여부","required":true,"schema":{"type":"String"}},{"name":"ordDtlGbCd","in":"query","description":"주문상세구분코드","required":true,"schema":{"type":"String"}},{"name":"chgDtm","in":"query","description":"상태변경일시","schema":{"type":"LocalDate"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimOrdDtlStatChgHistResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 고객서비스 > 통합 상담관리 > 상담등록 팝업 > 고객 주문 목록 조회 팝업

> &#x20; \## 기능 설명\
> &#x20; \- 고객 주문 목록 조회 팝업에서 고객의 주문 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 내용\
> &#x20; \- 회원번호, 주문일자, 상품명에 해당하는 고객의 주문목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* Release v2.00\_240830: OM003(주문내역구분코드) 10: 주문일반, 30: 교환주문 조건 추가<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":{"CustomerOrderSearchRequest":{"type":"object","properties":{"mbrNo":{"type":"string"},"ordStrtDate":{"type":"string","format":"date"},"ordEndDate":{"type":"string","format":"date"},"goodsNm":{"type":"string"},"entiretyPeriodYn":{"type":"string"}}},"RealGridListResponseOrderClaimCustomerOrderResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderClaimCustomerOrderResponse"}}}},"OrderClaimCustomerOrderResponse":{"type":"object","properties":{"ordNo":{"type":"string"},"ordSeq":{"type":"string"},"ordAccpDtm":{"type":"string","format":"date-time"},"mbrNo":{"type":"string"},"goodsNo":{"type":"string"},"goodsNm":{"type":"string"},"itmNo":{"type":"string"},"itmNm":{"type":"string"},"salePrc":{"type":"number"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"ordDtlGbCdNm":{"type":"string"},"ordDtlStatCdNm":{"type":"string"},"rcvmnNm":{"type":"string"},"rcvmnCellSctNo":{"type":"string"},"rcvmnCellTxnoNo":{"type":"string"},"rcvmnCellEndNo":{"type":"string"},"rcvmnCellNo":{"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":{"/v1/claim/orderClaimProc/getOrdClmCustomerOrderList":{"get":{"tags":["주문클레임처리"],"summary":"고객서비스 > 통합 상담관리 > 상담등록 팝업 > 고객 주문 목록 조회 팝업","description":"  ## 기능 설명\n  - 고객 주문 목록 조회 팝업에서 고객의 주문 목록을 조회합니다.\n  ---\n  ## 상세 내용\n  - 회원번호, 주문일자, 상품명에 해당하는 고객의 주문목록을 조회합니다.\n  ---\n  ## 수정번호\n  * Release v2.00_240830: OM003(주문내역구분코드) 10: 주문일반, 30: 교환주문 조건 추가\n","operationId":"getOrdClmCustomerOrderList","parameters":[{"name":"customerOrderSearchRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CustomerOrderSearchRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderClaimCustomerOrderResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문변경 > 변경 가능한 단품 목록을 조회합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 변경 가능한 단품 목록를 조회 합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 변경 가능한 단품 목록를 조회 합니다.<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":{"OrderClaimRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"mbrNo":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"ordNo":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"}}},"ClaimItmOtherInfoListResponse":{"type":"object","description":"주문 변경 단품 목록 조회 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"reqIteNo":{"type":"string","description":"변경할단품번호"},"itmNos":{"type":"array","description":"단품번호목록","items":{"$ref":"#/components/schemas/ClaimItmOtherInfoResponse"}}}},"ClaimItmOtherInfoResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stkQty":{"type":"integer","format":"int64","description":"남은수량"},"supPcost":{"type":"number","description":"공급가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"tsalePrc":{"type":"number","description":"최종판매가"},"tsupPrc":{"type":"number","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":{"/v1/claim/orderClaimProc/getGoodsItmInfoList":{"get":{"tags":["주문클레임처리"],"summary":"주문변경 > 변경 가능한 단품 목록을 조회합니다.","description":"  ## 기능 설명\n  * 변경 가능한 단품 목록를 조회 합니다.\n  ---\n  ## 상세 설명\n  * 변경 가능한 단품 목록를 조회 합니다.\n","operationId":"getGoodsItmInfoList","parameters":[{"name":"orderClaimRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderClaimRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClaimItmOtherInfoListResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 주문관리 > 주문 클레임 처리 > 배송비 상세 내역 팝업 내 배송번호 옵션 리스트

> &#x20; \## 기능설명\
> &#x20; \* 배송비 상세 내역 팝업 호출 시, 해당하는 주문번호의 모든 배송번호를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세설명\
> &#x20; \* 팝업 화면의 옵션 리스트 용 배송번호 목록입니다.<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":{"OrdBaseRequest":{"type":"object","properties":{"siteNo":{"type":"string"},"tmpOrdNo":{"type":"string"},"bsketNo":{"type":"string"},"ordMediaCd":{"type":"string"},"mbrNo":{"type":"string"},"ordManNm":{"type":"string"},"ordAccpDtm":{"type":"string"},"ordAccpStrtDt":{"type":"string","format":"date"},"ordAccpEndDt":{"type":"string","format":"date"},"mbrGradeCd":{"type":"string"},"mbrMgrCd":{"type":"string"},"fstOrdYn":{"type":"string"},"umemEmailAddr":{"type":"string"},"umemCellSctNo":{"type":"string"},"umemCellTxnoNo":{"type":"string"},"umemCellEndNo":{"type":"string"},"umemTelRgnNo":{"type":"string"},"umemTelTxnoNo":{"type":"string"},"umemTelEndNo":{"type":"string"},"umemZipNoSeq":{"type":"integer","format":"int32"},"umemZipNo":{"type":"string"},"umemZipAddr":{"type":"string"},"umemDtlAddr":{"type":"string"},"rfdBankCd":{"type":"string"},"rfdActnNo":{"type":"string"},"rfdActnDepositorNm":{"type":"string"},"trnsDt":{"type":"string"},"trnsTm":{"type":"string"},"ordNo":{"type":"string"},"ordRsltCd":{"type":"string"},"ordRsltMsgCont":{"type":"string"},"rtnExchgGbCd":{"type":"string"},"deilRtnGbCd":{"type":"string"},"pagingYn":{"type":"string"},"mbrIdNm":{"type":"string"},"cellNo":{"type":"string"},"goodsImgDomain":{"type":"string"},"condxSysRegDtmAll":{"type":"string"},"umbrNo":{"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":{"/v1/claim/orderClaimProc/getDeliNoListByOrdNo":{"get":{"tags":["주문클레임처리"],"summary":"주문관리 > 주문 클레임 처리 > 배송비 상세 내역 팝업 내 배송번호 옵션 리스트","description":"  ## 기능설명\n  * 배송비 상세 내역 팝업 호출 시, 해당하는 주문번호의 모든 배송번호를 조회합니다.\n  ---\n  ## 상세설명\n  * 팝업 화면의 옵션 리스트 용 배송번호 목록입니다.\n","operationId":"getDeliNoListByOrdNo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrdBaseRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"type":"string"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 반품/교환사유조회

> \## 기능설명\
> 반품 및 교환 접수 시 사용자가 선택한 반품 교환 사유를 조회합니다.\
> \<br>\<br>\
> \---\
> \## 상세내용\
> \* \*\*주문번호(ordNo), 주문순번(ordSeq), 주문처리순번(ordProcSeq)\*\* 기준으로 조회합니다.\<br>\<br>\
> \* 클레임 정보 및 클레임 대분류/중분류/기타 사유 정보를 조회합니다.\<br>\<br>\
> \* 반품 교환 접수 시 사유 선택은 필수 값이므로, 조회 결과 값이 없는경우 \*\*ValidationException\*\* 발생합니다.<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":{"ClaimCausePopupRequest":{"type":"object","description":"클레임 반품/교환 사유 팝업 요청 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","format":"int32","description":"주문순번"},"ordProcSeq":{"type":"integer","format":"int32","description":"주문처리순번"}}},"ClaimCausePopupResponse":{"type":"object","description":"클레임 반품/교환 사유 팝업 응답 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","format":"int32","description":"주문순번"},"ordProcSeq":{"type":"integer","format":"int32","description":"주문처리순번"},"goodsNm":{"type":"string","description":"상품명"},"itmNm":{"type":"string","description":"단품명"},"claimLgrpCd":{"type":"string","description":"클레임대분류코드(OM047)"},"claimLgrpCdNm":{"type":"string","description":"클레임대분류코드명"},"claimMgrpCd":{"type":"string","description":"클레임중분류코드(OM006)"},"claimMgrpCdNm":{"type":"string","description":"클레임중분류코드명"},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"filePath":{"type":"string","description":"파일경로"},"wthdFnshWaitProcCaus":{"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":{"/v1/claim/orderClaimProc/getClaimCauseInfo":{"get":{"tags":["주문클레임처리"],"summary":"반품/교환사유조회","description":"## 기능설명\n반품 및 교환 접수 시 사용자가 선택한 반품 교환 사유를 조회합니다.\n<br><br>\n---\n## 상세내용\n* **주문번호(ordNo), 주문순번(ordSeq), 주문처리순번(ordProcSeq)** 기준으로 조회합니다.<br><br>\n* 클레임 정보 및 클레임 대분류/중분류/기타 사유 정보를 조회합니다.<br><br>\n* 반품 교환 접수 시 사유 선택은 필수 값이므로, 조회 결과 값이 없는경우 **ValidationException** 발생합니다.\n","operationId":"getClaimCauseInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ClaimCausePopupRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}},{"name":"ordSeq","in":"query","description":"주문순번","required":true,"schema":{"type":"Integer"}},{"name":"ordProcSeq","in":"query","description":"주문처리순번","required":true,"schema":{"type":"Integer"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClaimCausePopupResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 반품/교환사유 첨부 이미지 목록 조회

> \## 기능설명\
> 반품 및 교환 접수 시, 사용자가 첨부한 이미지 목록을 조회합니다.\
> \<br>\<br>\
> \---\
> \## 상세내용\
> \* \*\*주문번호(ordNo), 주문순번(ordSeq), 주문처리순번(ordProcSeq)\*\* 기준으로 조회합니다.\<br>\<br>\
> \* 클레임 사유 선택 시 첨부한 이미지 목록과 이미지 갯수 정보를 조회합니다.\<br>\<br>\
> \* 사유 이미지 첨부는 최대 5개 까지 허용되며, 결과 목록은 그리드 Response 형태로 리턴됩니다.\<br>\<br><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":{"ClaimCausePopupRequest":{"type":"object","description":"클레임 반품/교환 사유 팝업 요청 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","format":"int32","description":"주문순번"},"ordProcSeq":{"type":"integer","format":"int32","description":"주문처리순번"}}},"RealGridListResponseClaimCausePopupResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/ClaimCausePopupResponse"}}}},"ClaimCausePopupResponse":{"type":"object","description":"클레임 반품/교환 사유 팝업 응답 DTO","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","format":"int32","description":"주문순번"},"ordProcSeq":{"type":"integer","format":"int32","description":"주문처리순번"},"goodsNm":{"type":"string","description":"상품명"},"itmNm":{"type":"string","description":"단품명"},"claimLgrpCd":{"type":"string","description":"클레임대분류코드(OM047)"},"claimLgrpCdNm":{"type":"string","description":"클레임대분류코드명"},"claimMgrpCd":{"type":"string","description":"클레임중분류코드(OM006)"},"claimMgrpCdNm":{"type":"string","description":"클레임중분류코드명"},"claimCausEtcCont":{"type":"string","description":"클레임사유기타내용"},"filePath":{"type":"string","description":"파일경로"},"wthdFnshWaitProcCaus":{"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":{"/v1/claim/orderClaimProc/getClaimCauseAttachFileList":{"get":{"tags":["주문클레임처리"],"summary":"반품/교환사유 첨부 이미지 목록 조회","description":"## 기능설명\n반품 및 교환 접수 시, 사용자가 첨부한 이미지 목록을 조회합니다.\n<br><br>\n---\n## 상세내용\n* **주문번호(ordNo), 주문순번(ordSeq), 주문처리순번(ordProcSeq)** 기준으로 조회합니다.<br><br>\n* 클레임 사유 선택 시 첨부한 이미지 목록과 이미지 갯수 정보를 조회합니다.<br><br>\n* 사유 이미지 첨부는 최대 5개 까지 허용되며, 결과 목록은 그리드 Response 형태로 리턴됩니다.<br><br>\n","operationId":"getClaimCauseAttachFileList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ClaimCausePopupRequest"}},{"name":"ordNo","in":"query","description":"주문번호","required":true,"schema":{"type":"String"}},{"name":"ordSeq","in":"query","description":"주문순번","required":true,"schema":{"type":"Integer"}},{"name":"ordProcSeq","in":"query","description":"주문처리순번","required":true,"schema":{"type":"Integer"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseClaimCausePopupResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
