# 주문조회

## 비회원 로그인

> \## 기능 설명\
> \* 비회원 주문조회시 주문 유효성 검사 후 비회원 쿠키 정보 생성\
> \---\
> \## 상세 설명\
> \* 해당 주문이 존재하는지 해당 주문 비회원 비밀번호가 유효한지 체크\
> \* 유효성 검사 성공 후 주문번호, 비회원 비밀번호 쿠키 정보 세팅<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/order/nonMember/loginProcess":{"post":{"tags":["주문조회"],"summary":"비회원 로그인","description":"## 기능 설명\n* 비회원 주문조회시 주문 유효성 검사 후 비회원 쿠키 정보 생성\n---\n## 상세 설명\n* 해당 주문이 존재하는지 해당 주문 비회원 비밀번호가 유효한지 체크\n* 유효성 검사 성공 후 주문번호, 비회원 비밀번호 쿠키 정보 세팅\n","operationId":"nonMemberLoginProcess","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NonMemberLoginRequest"}}},"required":true},"responses":{"200":{"description":"비회원 로그인 처리 성공","content":{"application/json":{}}},"900":{"description":"업무처리 오류 내용","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"NonMemberLoginRequest":{"required":["nonMemberPwd","ordNo","systemType"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"nonMemberPwd":{"type":"string","description":"비회원 비밀번호"},"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## 주문내역 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문 내역 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 회원번호에 해당하는 주문 목록을 조회합니다.\
> &#x20; \* 비회원은 주문 내역 리스트 조회 불가능합니다.\
> &#x20; \* 조회시작일시, 조회종료일시 사이에 포함된 주문 목록만 조회합니다.\
> &#x20; \* 주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C' 로 데이터를 넘겨받습니다.\
> &#x20;   \* 주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.\
> &#x20; \* 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref\_1\_val)과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* release\_231220 : 배송지 컬럼 추가\
> &#x20; \* Release v2.00\_240401:\
> &#x20;   \* 단일상품여부 추가\
> &#x20;   \* 본품주문순번 추가(해당 상품에 대한 사은품 매칭을 위한 값)\
> &#x20;   \* 예약상품 출고예정일 추가\
> &#x20;   \* orderClassificationCode값이 'O'일 경우 전체 조회에서 주문/배송만 조회로 변경\
> &#x20; \* Release v2.00\_240729 : 취소 가능 여부(ordCnclPsbYn) 추가, 상품 필터링 시 상품유형코드(goodsTypCd) e-쿠폰상품 추가<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/mypage/order/orderInfoList":{"post":{"tags":["주문조회"],"summary":"주문내역 조회","description":"  ## 기능 설명\n  * 주문 내역 목록을 조회합니다.\n  ---\n  ## 상세 설명\n  * 회원번호에 해당하는 주문 목록을 조회합니다.\n  * 비회원은 주문 내역 리스트 조회 불가능합니다.\n  * 조회시작일시, 조회종료일시 사이에 포함된 주문 목록만 조회합니다.\n  * 주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C' 로 데이터를 넘겨받습니다.\n    * 주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.\n  * 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\n  ---\n  ## 수정번호\n  * release_231220 : 배송지 컬럼 추가\n  * Release v2.00_240401:\n    * 단일상품여부 추가\n    * 본품주문순번 추가(해당 상품에 대한 사은품 매칭을 위한 값)\n    * 예약상품 출고예정일 추가\n    * orderClassificationCode값이 'O'일 경우 전체 조회에서 주문/배송만 조회로 변경\n  * Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn) 추가, 상품 필터링 시 상품유형코드(goodsTypCd) e-쿠폰상품 추가\n","operationId":"orderInfoList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderInfoRequest":{"type":"object","properties":{"rowsPerPage":{"type":"integer","description":"화면당노출수량","format":"int32"},"pageIdx":{"type":"integer","description":"페이지번호","format":"int32"},"stdDt":{"type":"string","description":"조회시작일","format":"date"},"endDt":{"type":"string","description":"조회종료일","format":"date"},"orderClassificationCode":{"type":"string","description":"주문현황구분코드값(모든주문조회: O / 클레임조회 : C / 선물함조회 : G)"},"pagingYn":{"type":"string","description":"페이징처리여부"}},"description":"주문 목록 조회 DTO"},"OrderListResponse":{"type":"object","properties":{"totCnt":{"type":"integer","description":"주문건수","format":"int32"},"rowsPerPage":{"type":"integer","description":"화면당노출수량","format":"int32"},"pageIdx":{"type":"integer","description":"페이지번호","format":"int32"},"ordList":{"type":"array","description":"주문내역상세목록","items":{"$ref":"#/components/schemas/OrderDetailInfoResponse"}}},"description":"주문 목록 DTO"},"OrderDetailInfoResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordAccpDtm":{"type":"string","description":"주문접수일시","format":"date-time"},"deliMethodCd":{"type":"string","description":"배송방법코드(LO010)"},"deliMethodNm":{"type":"string","description":"배송방법코드명"},"ordManNm":{"type":"string","description":"주문자명"},"ordManCellNo":{"type":"string","description":"주문자 휴대폰번호"},"mbrNo":{"type":"string","description":"회원번호"},"ordGbCd":{"type":"string","description":"주문구분코드(OM002)"},"rcvmnNm":{"type":"string","description":"수취인명"},"rcvmnCellNo":{"type":"string","description":"수취인 휴대폰번호"},"prdList":{"type":"array","description":"상품정보목록","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}},"aeEvtList":{"type":"array","description":"사은품정보목록","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}},"dlvpInfo":{"type":"array","description":"배송지정보목록","items":{"$ref":"#/components/schemas/OrderDetailDlvpInfoResponse"}},"payInfo":{"type":"array","description":"결제정보목록","items":{"$ref":"#/components/schemas/OrderDetailPayInfoResponse"}},"giftAcceptanceDeadlineAndDate":{"type":"integer","format":"int32","writeOnly":true},"additionalInfo":{"type":"integer","format":"int32","writeOnly":true}},"description":"주문 내역 상세 정보 DTO"},"OrderDetailGoodsInfoResponse":{"type":"object","properties":{"system":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"dlvpSeq":{"type":"string","description":"배송순번"},"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":"클레임번호"},"aeOrdSeq":{"type":"string","description":"본품주문순번"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"sngGoodsYn":{"type":"string","description":"단일상품여부"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"goodsTypCdNm":{"type":"string","description":"상품유형코드명"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"ordDtlStatCd":{"type":"string","description":"주문내역상세구분코드(OM005)"},"ordDtlStatCdNm":{"type":"string","description":"주문내역상세구분코드명"},"prestNm":{"type":"string","description":"증정품명"},"norPrc":{"type":"integer","description":"정상가","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int32"},"dcAmt":{"type":"integer","description":"할인금액","format":"int32"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"cnclQty":{"type":"integer","description":"취소수량","format":"int32"},"rtnQty":{"type":"integer","description":"반품수량","format":"int32"},"ordAmt":{"type":"integer","description":"주문금액","format":"int32"},"deliNo":{"type":"string","description":"배송번호"},"deliKindCd":{"type":"string","description":"배송종류코드(LO009)"},"deliKindCdNm":{"type":"string","description":"배송종류코드명"},"shipWaitCaus":{"type":"string","description":"출고대기사유코드(LO007)"},"shipWaitCausNm":{"type":"string","description":"출고대기사유코드명"},"deliTypCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliTypCdNm":{"type":"string","description":"배송상품구분코드명"},"deliGbCd":{"type":"string","description":"배송구분코드(LO001)"},"deliPolcNo":{"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","description":"주문접수일","format":"date-time"},"ordFnshDtm":{"type":"string","description":"주문완료일","format":"date-time"},"goodsRevWrtYn":{"type":"string","description":"상품리뷰작성여부"},"deliFnshDtm":{"type":"string","description":"배송완료일시","format":"date-time"},"goodsImg":{"type":"string","description":"상품이미지"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"prstStatCd":{"type":"string","description":"선물상태코드(OM044)"},"claimMgrpCd":{"type":"string","description":"클레임중분류코드(OM006)"},"claimCauseFaultType":{"type":"string","description":"클레임귀책유형(10: 고객귀책 / 20: 당사귀책)"},"wthdFnshGbCd":{"type":"string","description":"회수완료구분코드(LO011)"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"ordCnclPsbYn":{"type":"string","description":"취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnNo":{"type":"string","description":"e쿠폰번호"},"etcktNo":{"type":"string","description":"e티켓번호"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"deliIndiRsvDtm":{"type":"string","description":"배송지시예약일시","format":"date-time"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"}},"description":"주문 상품 정보 목록 DTO"},"OrderDetailDlvpInfoResponse":{"type":"object","properties":{"dlvpSeq":{"type":"string","description":"배송순번"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"deliAddr":{"type":"string","description":"배송지"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039)"},"deliMsgCdNm":{"type":"string","description":"배송메시지코드명"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관출입기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관출입비밀번호"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"persCstmCd":{"type":"string","description":"통관고유번호"},"deliNo":{"type":"string","description":"대표 배송번호"},"deliInfoGroupList":{"type":"array","description":"배송그룹목록","items":{"$ref":"#/components/schemas/OrderDetailDeliInfoGroupResponse"}}},"description":"주문 배송지 정보 DTO"},"OrderDetailDeliInfoGroupResponse":{"type":"object","properties":{"deliNo":{"type":"string","description":"배송번호"},"prdList":{"type":"array","description":"상품정보목록","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}},"aeEvtList":{"type":"array","description":"사은품정보목록","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}}},"description":"주문 배송그룹 정보 DTO"},"OrderDetailPayInfoResponse":{"type":"object","properties":{"type":{"type":"string","description":"결제유형(최초결제 : P(pay) / 최종환불 : R(return))"},"ordNo":{"type":"string","description":"주문번호"},"totOrdPrc":{"type":"integer","description":"총결제금액","format":"int64"},"totAplyAdtnAmt":{"type":"integer","description":"총배송비금액","format":"int32"},"totDcAmt":{"type":"integer","description":"총할인금액","format":"int32"},"saveMileageAmt":{"type":"integer","description":"적립마일리지","format":"int32"},"addPayAmt":{"type":"integer","description":"추가결제금액","format":"int32"},"totPayAmt":{"type":"integer","description":"실결제금액","format":"int64"},"mileagePayAmt":{"type":"integer","description":"마일리지 결제 금액","format":"int64"},"pgGbCd":{"type":"string","description":"PG 구분 코드"},"payMethodResponses":{"type":"array","description":"사용한 결제 수단 목록","items":{"$ref":"#/components/schemas/PayMethodResponse"}},"accumulatedMileageResponses":{"type":"array","description":"마일리지 적립 내역","items":{"$ref":"#/components/schemas/AccumulatedMileageResponse"}}},"description":"주문 상세 결제 정보 DTO"},"PayMethodResponse":{"type":"object","properties":{"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명"},"payReqCardcoCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"payReqCardcoCdNm":{"type":"string","description":"결제요청카드사코드명"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrCdNm":{"type":"string","description":"매입사코드명"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"bankCdNm":{"type":"string","description":"은행코드명"},"actnNo":{"type":"string","description":"계좌번호"},"dpmnNm":{"type":"string","description":"입금자명"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dlvMonCnt":{"type":"integer","description":"할부개월수","format":"int32"},"nintDivYn":{"type":"string","description":"할부사용여부"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"}},"description":"결제 수단 내역 DTO"},"AccumulatedMileageResponse":{"type":"object","properties":{"type":{"type":"string","description":"최초적립 : FRS(first) / 최종적립 : FNL(final) 구분값"},"adtnDtlGbCd":{"type":"string","description":"부가비용상세구분코드(OM019)"},"adtnDtlGbCdNm":{"type":"string","description":"부가비용상세구분코드명"},"aplyAdtnAmt":{"type":"integer","description":"적용부가비용금액","format":"int64"}},"description":"마일리지 적립 내역 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## 주문내역 상세 조회

> &#x20; \## 기능 설명\
> &#x20; \* 주문 내역 상세를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문번호에 해당하는 주문 상세(주문상품정보, 최초결제정보, 최초적립마일리지, 최종환불정보 등)를 조회합니다.\
> &#x20; \* 비회원일 경우, 비회원 비밀번호와 주문번호가 일치하는 주문이 존재하면 주문 상세를 조회합니다.\
> &#x20; \* 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref\_1\_val)과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* release\_231206 : Response DTO 배송지정보목록 하위에 배송그룹목록(deliInfoGroupList) 추가 세팅(UI 노출 구조 변경 : 배송지 > 배송그룹 > 상품/사은품목록)\
> &#x20; \* Release v2.00\_240425 : 멀티 사이트 확장에 따른 사이트 번호(site\_no) 추가\
> &#x20; \* Release v2.00\_240711 : 추가 배송비 개선에 따른 배송정책번호(deli\_polc\_no) 조회 추가\
> &#x20; \* Release v2.00\_240729 : 취소 가능 여부(ordCnclPsbYn) 추가, 상품 필터링 시 상품유형코드(goodsTypCd) e-쿠폰상품 추가<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/mypage/order/orderDetailInfo":{"post":{"tags":["주문조회"],"summary":"주문내역 상세 조회","description":"  ## 기능 설명\n  * 주문 내역 상세를 조회합니다.\n  ---\n  ## 상세 설명\n  * 주문번호에 해당하는 주문 상세(주문상품정보, 최초결제정보, 최초적립마일리지, 최종환불정보 등)를 조회합니다.\n  * 비회원일 경우, 비회원 비밀번호와 주문번호가 일치하는 주문이 존재하면 주문 상세를 조회합니다.\n  * 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\n  ---\n  ## 수정번호\n  * release_231206 : Response DTO 배송지정보목록 하위에 배송그룹목록(deliInfoGroupList) 추가 세팅(UI 노출 구조 변경 : 배송지 > 배송그룹 > 상품/사은품목록)\n  * Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가\n  * Release v2.00_240711 : 추가 배송비 개선에 따른 배송정책번호(deli_polc_no) 조회 추가\n  * Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn) 추가, 상품 필터링 시 상품유형코드(goodsTypCd) e-쿠폰상품 추가\n","operationId":"orderDetailInfoList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderDetailInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderDetailInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderDetailInfoRequest":{"required":["ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"systemType":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"pagingYn":{"type":"string","description":"페이징여부","enum":["Y","N"]}},"description":"주문 상세 조회 DTO"},"OrderDetailInfoResponse":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordAccpDtm":{"type":"string","description":"주문접수일시","format":"date-time"},"deliMethodCd":{"type":"string","description":"배송방법코드(LO010)"},"deliMethodNm":{"type":"string","description":"배송방법코드명"},"ordManNm":{"type":"string","description":"주문자명"},"ordManCellNo":{"type":"string","description":"주문자 휴대폰번호"},"mbrNo":{"type":"string","description":"회원번호"},"ordGbCd":{"type":"string","description":"주문구분코드(OM002)"},"rcvmnNm":{"type":"string","description":"수취인명"},"rcvmnCellNo":{"type":"string","description":"수취인 휴대폰번호"},"prdList":{"type":"array","description":"상품정보목록","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}},"aeEvtList":{"type":"array","description":"사은품정보목록","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}},"dlvpInfo":{"type":"array","description":"배송지정보목록","items":{"$ref":"#/components/schemas/OrderDetailDlvpInfoResponse"}},"payInfo":{"type":"array","description":"결제정보목록","items":{"$ref":"#/components/schemas/OrderDetailPayInfoResponse"}},"giftAcceptanceDeadlineAndDate":{"type":"integer","format":"int32","writeOnly":true},"additionalInfo":{"type":"integer","format":"int32","writeOnly":true}},"description":"주문 내역 상세 정보 DTO"},"OrderDetailGoodsInfoResponse":{"type":"object","properties":{"system":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"dlvpSeq":{"type":"string","description":"배송순번"},"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":"클레임번호"},"aeOrdSeq":{"type":"string","description":"본품주문순번"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"sngGoodsYn":{"type":"string","description":"단일상품여부"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"goodsTypCdNm":{"type":"string","description":"상품유형코드명"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"ordDtlStatCd":{"type":"string","description":"주문내역상세구분코드(OM005)"},"ordDtlStatCdNm":{"type":"string","description":"주문내역상세구분코드명"},"prestNm":{"type":"string","description":"증정품명"},"norPrc":{"type":"integer","description":"정상가","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int32"},"dcAmt":{"type":"integer","description":"할인금액","format":"int32"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"cnclQty":{"type":"integer","description":"취소수량","format":"int32"},"rtnQty":{"type":"integer","description":"반품수량","format":"int32"},"ordAmt":{"type":"integer","description":"주문금액","format":"int32"},"deliNo":{"type":"string","description":"배송번호"},"deliKindCd":{"type":"string","description":"배송종류코드(LO009)"},"deliKindCdNm":{"type":"string","description":"배송종류코드명"},"shipWaitCaus":{"type":"string","description":"출고대기사유코드(LO007)"},"shipWaitCausNm":{"type":"string","description":"출고대기사유코드명"},"deliTypCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliTypCdNm":{"type":"string","description":"배송상품구분코드명"},"deliGbCd":{"type":"string","description":"배송구분코드(LO001)"},"deliPolcNo":{"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","description":"주문접수일","format":"date-time"},"ordFnshDtm":{"type":"string","description":"주문완료일","format":"date-time"},"goodsRevWrtYn":{"type":"string","description":"상품리뷰작성여부"},"deliFnshDtm":{"type":"string","description":"배송완료일시","format":"date-time"},"goodsImg":{"type":"string","description":"상품이미지"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"prstStatCd":{"type":"string","description":"선물상태코드(OM044)"},"claimMgrpCd":{"type":"string","description":"클레임중분류코드(OM006)"},"claimCauseFaultType":{"type":"string","description":"클레임귀책유형(10: 고객귀책 / 20: 당사귀책)"},"wthdFnshGbCd":{"type":"string","description":"회수완료구분코드(LO011)"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"ordCnclPsbYn":{"type":"string","description":"취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnNo":{"type":"string","description":"e쿠폰번호"},"etcktNo":{"type":"string","description":"e티켓번호"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"deliIndiRsvDtm":{"type":"string","description":"배송지시예약일시","format":"date-time"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"}},"description":"주문 상품 정보 목록 DTO"},"OrderDetailDlvpInfoResponse":{"type":"object","properties":{"dlvpSeq":{"type":"string","description":"배송순번"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"deliAddr":{"type":"string","description":"배송지"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039)"},"deliMsgCdNm":{"type":"string","description":"배송메시지코드명"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관출입기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관출입비밀번호"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"persCstmCd":{"type":"string","description":"통관고유번호"},"deliNo":{"type":"string","description":"대표 배송번호"},"deliInfoGroupList":{"type":"array","description":"배송그룹목록","items":{"$ref":"#/components/schemas/OrderDetailDeliInfoGroupResponse"}}},"description":"주문 배송지 정보 DTO"},"OrderDetailDeliInfoGroupResponse":{"type":"object","properties":{"deliNo":{"type":"string","description":"배송번호"},"prdList":{"type":"array","description":"상품정보목록","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}},"aeEvtList":{"type":"array","description":"사은품정보목록","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}}},"description":"주문 배송그룹 정보 DTO"},"OrderDetailPayInfoResponse":{"type":"object","properties":{"type":{"type":"string","description":"결제유형(최초결제 : P(pay) / 최종환불 : R(return))"},"ordNo":{"type":"string","description":"주문번호"},"totOrdPrc":{"type":"integer","description":"총결제금액","format":"int64"},"totAplyAdtnAmt":{"type":"integer","description":"총배송비금액","format":"int32"},"totDcAmt":{"type":"integer","description":"총할인금액","format":"int32"},"saveMileageAmt":{"type":"integer","description":"적립마일리지","format":"int32"},"addPayAmt":{"type":"integer","description":"추가결제금액","format":"int32"},"totPayAmt":{"type":"integer","description":"실결제금액","format":"int64"},"mileagePayAmt":{"type":"integer","description":"마일리지 결제 금액","format":"int64"},"pgGbCd":{"type":"string","description":"PG 구분 코드"},"payMethodResponses":{"type":"array","description":"사용한 결제 수단 목록","items":{"$ref":"#/components/schemas/PayMethodResponse"}},"accumulatedMileageResponses":{"type":"array","description":"마일리지 적립 내역","items":{"$ref":"#/components/schemas/AccumulatedMileageResponse"}}},"description":"주문 상세 결제 정보 DTO"},"PayMethodResponse":{"type":"object","properties":{"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명"},"payReqCardcoCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"payReqCardcoCdNm":{"type":"string","description":"결제요청카드사코드명"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrCdNm":{"type":"string","description":"매입사코드명"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"bankCdNm":{"type":"string","description":"은행코드명"},"actnNo":{"type":"string","description":"계좌번호"},"dpmnNm":{"type":"string","description":"입금자명"},"dptFcstDt":{"type":"string","description":"입금예정일자"},"dlvMonCnt":{"type":"integer","description":"할부개월수","format":"int32"},"nintDivYn":{"type":"string","description":"할부사용여부"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"}},"description":"결제 수단 내역 DTO"},"AccumulatedMileageResponse":{"type":"object","properties":{"type":{"type":"string","description":"최초적립 : FRS(first) / 최종적립 : FNL(final) 구분값"},"adtnDtlGbCd":{"type":"string","description":"부가비용상세구분코드(OM019)"},"adtnDtlGbCdNm":{"type":"string","description":"부가비용상세구분코드명"},"aplyAdtnAmt":{"type":"integer","description":"적용부가비용금액","format":"int64"}},"description":"마일리지 적립 내역 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```

## 클레임 처리가능 버튼 조회 (BO)

> &#x20; \## 기능 설명\
> &#x20; \* \[BO 전용] BO 주문클레임 처리 주문상품내역의 노출해야 할 버튼 목록만을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* BO에서 하나의 주문에 해당하는 주문상품 목록 조회 후 파라미터로 전달해 줍니다.\
> &#x20; \* BO 시스템 클레임처리 가능상태(ST008) 그룹코드의 주문내역상태코드(ref\_1\_val)과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 조회 후 화면단에서 버튼을 노출합니다.\
> &#x20; \---\
> &#x20; \## 수정 번호\
> &#x20; \* Release v2.00\_240729 : 취소 가능 여부(ordCnclPsbYn), 회수여부(wthdYn), e쿠폰번호(ecpnNo), e티켓번호(etcktNo) 추가 / 상품 유형별 버튼 필터링 추가<br>

```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/mypage/order/getAvailableBOButtonList":{"post":{"tags":["주문조회"],"summary":"클레임 처리가능 버튼 조회 (BO)","description":"  ## 기능 설명\n  * [BO 전용] BO 주문클레임 처리 주문상품내역의 노출해야 할 버튼 목록만을 조회합니다.\n  ---\n  ## 상세 설명\n  * BO에서 하나의 주문에 해당하는 주문상품 목록 조회 후 파라미터로 전달해 줍니다.\n  * BO 시스템 클레임처리 가능상태(ST008) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 조회 후 화면단에서 버튼을 노출합니다.\n  ---\n  ## 수정 번호\n  * Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn), 회수여부(wthdYn), e쿠폰번호(ecpnNo), e티켓번호(etcktNo) 추가 / 상품 유형별 버튼 필터링 추가\n","operationId":"getAvailableBOButtonList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderDetailGoodsInfoResponse"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"type":"string"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderDetailGoodsInfoResponse":{"type":"object","properties":{"system":{"type":"string","description":"        SYSTEM(시스템유형)\n        * 10 : FO\n        * 20 : BO\n","enum":["FO","BO"]},"dlvpSeq":{"type":"string","description":"배송순번"},"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":"클레임번호"},"aeOrdSeq":{"type":"string","description":"본품주문순번"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"sngGoodsYn":{"type":"string","description":"단일상품여부"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"goodsTypCdNm":{"type":"string","description":"상품유형코드명"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"ordDtlStatCd":{"type":"string","description":"주문내역상세구분코드(OM005)"},"ordDtlStatCdNm":{"type":"string","description":"주문내역상세구분코드명"},"prestNm":{"type":"string","description":"증정품명"},"norPrc":{"type":"integer","description":"정상가","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int32"},"dcAmt":{"type":"integer","description":"할인금액","format":"int32"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"cnclQty":{"type":"integer","description":"취소수량","format":"int32"},"rtnQty":{"type":"integer","description":"반품수량","format":"int32"},"ordAmt":{"type":"integer","description":"주문금액","format":"int32"},"deliNo":{"type":"string","description":"배송번호"},"deliKindCd":{"type":"string","description":"배송종류코드(LO009)"},"deliKindCdNm":{"type":"string","description":"배송종류코드명"},"shipWaitCaus":{"type":"string","description":"출고대기사유코드(LO007)"},"shipWaitCausNm":{"type":"string","description":"출고대기사유코드명"},"deliTypCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliTypCdNm":{"type":"string","description":"배송상품구분코드명"},"deliGbCd":{"type":"string","description":"배송구분코드(LO001)"},"deliPolcNo":{"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","description":"주문접수일","format":"date-time"},"ordFnshDtm":{"type":"string","description":"주문완료일","format":"date-time"},"goodsRevWrtYn":{"type":"string","description":"상품리뷰작성여부"},"deliFnshDtm":{"type":"string","description":"배송완료일시","format":"date-time"},"goodsImg":{"type":"string","description":"상품이미지"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"prstStatCd":{"type":"string","description":"선물상태코드(OM044)"},"claimMgrpCd":{"type":"string","description":"클레임중분류코드(OM006)"},"claimCauseFaultType":{"type":"string","description":"클레임귀책유형(10: 고객귀책 / 20: 당사귀책)"},"wthdFnshGbCd":{"type":"string","description":"회수완료구분코드(LO011)"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"ordCnclPsbYn":{"type":"string","description":"취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnNo":{"type":"string","description":"e쿠폰번호"},"etcktNo":{"type":"string","description":"e티켓번호"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"deliIndiRsvDtm":{"type":"string","description":"배송지시예약일시","format":"date-time"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"}},"description":"주문 상품 정보 목록 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","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"}},"description":"validation error list"}}}}
```


---

# Agent Instructions: 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:

```
GET https://tech.x2bee.com/api/store-front-api/order-api/undefined-9.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
