# 선물함
## 선물 수신자 배송지 입력
> \## 기능 설명\
> \* 선물 수신자의 배송지를 해당 주문 데이터에 반영합니다.\
> \---\
> \## 상세 설명\
> \* 선물하기 랜딩페이지, 받은 선물함 상세, 받은 선물함 목록에서 배송지 입력 버튼 클릭 시에 호출됩니다.\
> \* 해당 주문의 배송지 정보를 수신자가 입력한 배송지로 UPDATE합니다.\
> \* 해당 주문 상세 데이터의 배송지시예약일시를 수락한 일시로 UPDATE합니다.\
> \* 해당 주문 기본 데이터의 선물상태코드(OM044)를 수락으로 변경합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240711 : 추가 배송비 개선에 따라 추가 배송비 발생 여부 체크 수정
```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/giftBox/registerShippingAddress":{"put":{"tags":["선물함"],"summary":"선물 수신자 배송지 입력","description":" ## 기능 설명\n * 선물 수신자의 배송지를 해당 주문 데이터에 반영합니다.\n ---\n ## 상세 설명\n * 선물하기 랜딩페이지, 받은 선물함 상세, 받은 선물함 목록에서 배송지 입력 버튼 클릭 시에 호출됩니다.\n * 해당 주문의 배송지 정보를 수신자가 입력한 배송지로 UPDATE합니다.\n * 해당 주문 상세 데이터의 배송지시예약일시를 수락한 일시로 UPDATE합니다.\n * 해당 주문 기본 데이터의 선물상태코드(OM044)를 수락으로 변경합니다.\n ---\n ## 수정번호\n * Release v2.00_240711 : 추가 배송비 개선에 따라 추가 배송비 발생 여부 체크 수정\n","operationId":"registerShippingAddressForReceiveGift","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryInfoChangeRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"DeliveryInfoChangeRequest":{"required":["deliNo","deliPolcNo","dlvpNm","ordNo","rcvmnCellEndNo","rcvmnCellSctNo","rcvmnCellTxnoNo","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"clmNo":{"type":"string","description":"클레임번호"},"systemType":{"type":"string","description":" SYSTEM(시스템유형)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]},"mbrNo":{"type":"string","description":"회원번호"},"deliNo":{"type":"string","description":"배송번호"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNoSeq":{"type":"integer","description":"우편번호순번","format":"int32"},"zipNo":{"type":"string","description":"변경후우편번호"},"originZipNo":{"type":"string","description":"변경전우편번호"},"orginDlvpSeq":{"type":"string","description":"변경전배송지순번"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 10:배송메시지 입력 안함, 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40: 부재 시 경비실에 맡겨주세요, 50: 빠른 배송 부탁 드립니다, 60: 부재 시 핸드폰으로 연락 바랍니다, 70: 직접입력"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10: 공동현관 출입번호, 20: 자유 출입 가능, 30: 기타"},"deliGbCd":{"type":"string","description":" LO001(배송구분코드)\n * 10 : 출하\n * 20 : 회수\n","enum":["SHIPPING","WITHDRAWAL"]},"dlvpSeq":{"type":"string","description":"배송순번"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"}},"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"}}}}
```
## 보낸 선물함 내역 조회
> \## 기능 설명\
> \* 보낸 선물함 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 회원번호에 해당하는 선물한 주문 목록을 조회합니다.\
> \* 비회원은 선물하기가 불가능하므로 조회할 수 없습니다.\
> \* 조회시작일시, 조회종료일시 사이에 포함된 선물 주문 목록만 조회합니다.\
> \* 주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C', 선물함 클릭시 'G' 로 데이터를 넘겨받습니다.\
> \* 주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.\
> \* 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref\_1\_val)과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240729 : 취소 가능 여부(ordCnclPsbYn) 추가
```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/giftBox/sendGiftBoxList":{"post":{"tags":["선물함"],"summary":"보낸 선물함 내역 조회","description":" ## 기능 설명\n * 보낸 선물함 목록을 조회합니다.\n ---\n ## 상세 설명\n * 회원번호에 해당하는 선물한 주문 목록을 조회합니다.\n * 비회원은 선물하기가 불가능하므로 조회할 수 없습니다.\n * 조회시작일시, 조회종료일시 사이에 포함된 선물 주문 목록만 조회합니다.\n * 주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C', 선물함 클릭시 'G' 로 데이터를 넘겨받습니다.\n * 주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.\n * 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\n ---\n ## 수정 번호\n * Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn) 추가\n","operationId":"sendGiftBoxList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GiftInfoRequest":{"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"}}}}
```
## 받은 선물함 내역 조회
> \## 기능 설명\
> \* 받은 선물함 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 회원의 휴대전화번호와 선물 주문의 수취인휴대전화번호가 일치하는 주문, 회원의 회원번호와 선물수신자회원번호가 일치하는 주문 목록을 조회합니다.\
> \* 비회원은 선물하기가 불가능하므로 조회할 수 없습니다.\
> \* 조회시작일시, 조회종료일시 사이에 포함된 선물 주문 목록만 조회합니다.\
> \* 주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C', 선물함 클릭시 'G' 로 데이터를 넘겨받습니다.\
> \* 주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.\
> \* 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref\_1\_val)과 주문내역구분코드(ref\_2\_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\
> \* 받은 선물의 경우 취소/교환/반품 클레임이 불가능합니다.\
> \* 주문변경, 배송지변경, 배송추적, 배송완료 만 가능합니다.\
> \* 배송지입력의 경우 주문시점으로부터 3일 이내에 입력 해야합니다. 3일 지난 후 자동취소됩니다.\
> \* 클레임가능일수(ST006) 그룹코드의 선물수락기한일수(30)으로 기한일수가 변경될 수 있습니다.
```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/giftBox/receiveGiftBoxList":{"post":{"tags":["선물함"],"summary":"받은 선물함 내역 조회","description":" ## 기능 설명\n * 받은 선물함 목록을 조회합니다.\n ---\n ## 상세 설명\n * 회원의 휴대전화번호와 선물 주문의 수취인휴대전화번호가 일치하는 주문, 회원의 회원번호와 선물수신자회원번호가 일치하는 주문 목록을 조회합니다.\n * 비회원은 선물하기가 불가능하므로 조회할 수 없습니다.\n * 조회시작일시, 조회종료일시 사이에 포함된 선물 주문 목록만 조회합니다.\n * 주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C', 선물함 클릭시 'G' 로 데이터를 넘겨받습니다.\n * 주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.\n * 주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)\n * 받은 선물의 경우 취소/교환/반품 클레임이 불가능합니다.\n * 주문변경, 배송지변경, 배송추적, 배송완료 만 가능합니다.\n * 배송지입력의 경우 주문시점으로부터 3일 이내에 입력 해야합니다. 3일 지난 후 자동취소됩니다.\n * 클레임가능일수(ST006) 그룹코드의 선물수락기한일수(30)으로 기한일수가 변경될 수 있습니다.\n","operationId":"receiveGiftBoxList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderListResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GiftInfoRequest":{"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"}}}}
```
## 선물함 상세 조회
> \## 기능설명\
> \* 보낸 / 받은 선물함 상세 내역을 조회합니다.\
> \---\
> \## 상세내용\
> \* 주문번호(ordNo)는 필수 파라미터입니다.\
> \* 선물함 상세 유형(giftBoxType)값이 없는 경우 default 기타(30)로 할당됩니다.\
> \* 해당 주문번호의 주문정보가 존재하지 않거나 선물 상품 정보가 없는경우 Exception(code : 1003)이 발생합니다.\
> \* 보낸 선물함의 경우, 추가적으로 결제정보목록(payInfo)이 세팅됩니다.\
> \* 배송지정보목록(dlvpInfo)의 첫번째 요소가 선물 수령 배송지입니다.\
> \* 선물함 상세 유형(giftBoxType : 10 or 20)인 경우에 한해 상품정보목록(prdList)의 버튼목록(orderButtonList)이 세팅됩니다.\*\*(로그인 정보 필요)\*\*\
> \* 받은 선물함의 경우, 노출 가능한 버튼 목록(orderButtonList)은 다음과 같습니다.\
> 1\) 주문변경(91)\
> 2\) 배송지변경(92)\
> 3\) 배송추척(94)\
> 4\) 수령확인(96)\
> 5\) 배송지입력(97)\
> \* 조회되는 공통코드 목록은 다음과 같습니다.\
> 1\) 배송메시지코드(ME039)\
> 2\) 공동현관출입방법코드(ME040)\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425 : 멀티 사이트 확장에 따른 사이트 번호(site\_no) 추가\
> \* Release v2.00\_240711 : 추가 배송비 개선에 따른 배송정책번호(deli\_polc\_no) 조회 추가\
> \* Release v2.00\_240729 : 취소 가능 여부(ordCnclPsbYn) 추가
```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/giftBox/getGiftDetailInfo":{"post":{"tags":["선물함"],"summary":"선물함 상세 조회","description":"## 기능설명\n* 보낸 / 받은 선물함 상세 내역을 조회합니다.\n---\n## 상세내용\n* 주문번호(ordNo)는 필수 파라미터입니다.\n* 선물함 상세 유형(giftBoxType)값이 없는 경우 default 기타(30)로 할당됩니다.\n* 해당 주문번호의 주문정보가 존재하지 않거나 선물 상품 정보가 없는경우 Exception(code : 1003)이 발생합니다.\n* 보낸 선물함의 경우, 추가적으로 결제정보목록(payInfo)이 세팅됩니다.\n* 배송지정보목록(dlvpInfo)의 첫번째 요소가 선물 수령 배송지입니다.\n* 선물함 상세 유형(giftBoxType : 10 or 20)인 경우에 한해 상품정보목록(prdList)의 버튼목록(orderButtonList)이 세팅됩니다.**(로그인 정보 필요)**\n* 받은 선물함의 경우, 노출 가능한 버튼 목록(orderButtonList)은 다음과 같습니다.\n 1) 주문변경(91)\n 2) 배송지변경(92)\n 3) 배송추척(94)\n 4) 수령확인(96)\n 5) 배송지입력(97)\n* 조회되는 공통코드 목록은 다음과 같습니다.\n 1) 배송메시지코드(ME039)\n 2) 공동현관출입방법코드(ME040)\n---\n## 수정번호\n* Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가\n* Release v2.00_240711 : 추가 배송비 개선에 따른 배송정책번호(deli_polc_no) 조회 추가\n* Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn) 추가\n","operationId":"getGiftDetailInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftDetailInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GiftDetailInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GiftDetailInfoRequest":{"required":["ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"giftBoxType":{"type":"string","description":" GiftBoxType(선물함유형)\n * 10 : 받은선물함\n * 20 : 보낸선물함\n * 30 : 기타\n","enum":["RECEIVE","SEND","ETC"]},"mbrNo":{"type":"string","description":"회원번호"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"}},"description":"선물함 상세 조회 요청 DTO"},"GiftDetailInfoResponse":{"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"}},"ordManCellSctNo":{"type":"string","description":"주문자휴대폰구분번호"},"ordManCellTxnoNo":{"type":"string","description":"주문자휴대폰국번번호"},"ordManCellEndNo":{"type":"string","description":"주문자휴대폰끝번호"},"prstRecvmnMbrNo":{"type":"string","description":"선물수신자회원번호"},"prstRecvmnNm":{"type":"string","description":"선물수신자명"},"prstTypCd":{"type":"string","description":"선물유형코드(OM045)"},"cardImg":{"type":"string","description":"카드이미지"},"prstStatCd":{"type":"string","description":"선물상태코드(OM044)"},"prstStatCdNm":{"type":"string","description":"선물상태코드명"},"prstMsg":{"type":"string","description":"선물메시지"},"codeMap":{"type":"object","additionalProperties":{"type":"array","description":"공통코드","items":{"$ref":"#/components/schemas/StCdDtlResponse"}},"description":"공통코드"},"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"},"StCdDtlResponse":{"type":"object","properties":{"cd":{"type":"string","description":"코드"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"},"sortSeq":{"type":"string","description":"정렬순서"},"ref1Val":{"type":"string","description":"참조1값"},"ref2Val":{"type":"string","description":"참조2값"},"ref3Val":{"type":"string","description":"참조3값"},"ref4Val":{"type":"string","description":"참조4값"},"ref5Val":{"type":"string","description":"참조5값"},"ref6Val":{"type":"string","description":"참조6값"},"ref7Val":{"type":"string","description":"참조7값"}},"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-1.md?ask=
```
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.