> 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/store-front-api/order-api/undefined-9.md).
# 주문조회
## 비회원 로그인
> \## 기능 설명\
> \* 비회원 주문조회시 주문 유효성 검사 후 비회원 쿠키 정보 생성\
> \---\
> \## 상세 설명\
> \* 해당 주문이 존재하는지 해당 주문 비회원 비밀번호가 유효한지 체크\
> \* 유효성 검사 성공 후 주문번호, 비회원 비밀번호 쿠키 정보 세팅
```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"}}}}
```
## 주문내역 조회
> \## 기능 설명\
> \* 주문 내역 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 회원번호에 해당하는 주문 목록을 조회합니다.\
> \* 비회원은 주문 내역 리스트 조회 불가능합니다.\
> \* 조회시작일시, 조회종료일시 사이에 포함된 주문 목록만 조회합니다.\
> \* 주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C' 로 데이터를 넘겨받습니다.\
> \* 주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.\
> \* 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref\_1\_val)과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\
> \---\
> \## 수정번호\
> \* release\_231220 : 배송지 컬럼 추가\
> \* Release v2.00\_240401:\
> \* 단일상품여부 추가\
> \* 본품주문순번 추가(해당 상품에 대한 사은품 매칭을 위한 값)\
> \* 예약상품 출고예정일 추가\
> \* orderClassificationCode값이 'O'일 경우 전체 조회에서 주문/배송만 조회로 변경\
> \* Release v2.00\_240729 : 취소 가능 여부(ordCnclPsbYn) 추가, 상품 필터링 시 상품유형코드(goodsTypCd) e-쿠폰상품 추가
```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"}}}}
```
## 주문내역 상세 조회
> \## 기능 설명\
> \* 주문 내역 상세를 조회합니다.\
> \---\
> \## 상세 설명\
> \* 주문번호에 해당하는 주문 상세(주문상품정보, 최초결제정보, 최초적립마일리지, 최종환불정보 등)를 조회합니다.\
> \* 비회원일 경우, 비회원 비밀번호와 주문번호가 일치하는 주문이 존재하면 주문 상세를 조회합니다.\
> \* 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref\_1\_val)과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\
> \---\
> \## 수정번호\
> \* release\_231206 : Response DTO 배송지정보목록 하위에 배송그룹목록(deliInfoGroupList) 추가 세팅(UI 노출 구조 변경 : 배송지 > 배송그룹 > 상품/사은품목록)\
> \* Release v2.00\_240425 : 멀티 사이트 확장에 따른 사이트 번호(site\_no) 추가\
> \* Release v2.00\_240711 : 추가 배송비 개선에 따른 배송정책번호(deli\_polc\_no) 조회 추가\
> \* Release v2.00\_240729 : 취소 가능 여부(ordCnclPsbYn) 추가, 상품 필터링 시 상품유형코드(goodsTypCd) e-쿠폰상품 추가
```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)
> \## 기능 설명\
> \* \[BO 전용] BO 주문클레임 처리 주문상품내역의 노출해야 할 버튼 목록만을 조회합니다.\
> \---\
> \## 상세 설명\
> \* BO에서 하나의 주문에 해당하는 주문상품 목록 조회 후 파라미터로 전달해 줍니다.\
> \* BO 시스템 클레임처리 가능상태(ST008) 그룹코드의 주문내역상태코드(ref\_1\_val)과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 조회 후 화면단에서 버튼을 노출합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240729 : 취소 가능 여부(ordCnclPsbYn), 회수여부(wthdYn), e쿠폰번호(ecpnNo), e티켓번호(etcktNo) 추가 / 상품 유형별 버튼 필터링 추가
```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"}}}}
```