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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tech.x2bee.com/api/back-office-api/claim-bo-api/undefined-1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
