선물함
Access Token
주문 배송지 변경/등록 DTO
주문번호
20230809O007943클레임번호
20230801C008072SYSTEM(시스템유형) * 10 : FO * 20 : BO
10Possible values: 회원번호
10000001배송번호
100008491배송정책번호
10000431배송지명
집수취인명
홍길동우편번호순번
1변경후우편번호
08739변경전우편번호
05837변경전배송지순번
1우편주소
서울 송파구 법원로9길상세주소
에이치비지니스파크 D동 6층23수취인휴대폰구분번호
010수취인휴대폰국번번호
1234수취인휴대폰끝번호
5678배송메시지
문 앞에 두고 가주세요.배송메시지코드(ME039) 10:배송메시지 입력 안함, 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40: 부재 시 경비실에 맡겨주세요, 50: 빠른 배송 부탁 드립니다, 60: 부재 시 핸드폰으로 연락 바랍니다, 70: 직접입력
10공동현관기타방법
자유출입가능공동현관비밀번호
1234공동현관출입방법코드(ME040) 10: 공동현관 출입번호, 20: 자유 출입 가능, 30: 기타
10LO001(배송구분코드) * 10 : 출하 * 20 : 회수
10Possible values: 배송순번
1수취인이메일
test@plateer.com수취인전화지역번호
02수취인전화국번번호
1234수취인전화끝번호
5678해외직구상품여부
성공
No content
업무처리 오류 내용
PUT /api/order/v1/mypage/giftBox/registerShippingAddress HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 721
{
"ordNo": "20230809O007943",
"clmNo": "20230801C008072",
"systemType": "10",
"mbrNo": "10000001",
"deliNo": "100008491",
"deliPolcNo": "10000431",
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNoSeq": 1,
"zipNo": "08739",
"originZipNo": "05837",
"orginDlvpSeq": "1",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층23",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"deliMsg": "문 앞에 두고 가주세요.",
"deliMsgCd": "10",
"comnFrdrEtcMethod": "자유출입가능",
"comnFrdrPwd": "1234",
"comnFrdrCogoMethodCd": "10",
"deliGbCd": "10",
"dlvpSeq": "1",
"rcvmnEmailAddr": "test@plateer.com",
"rcvmnTelRgnNo": "02",
"rcvmnTelTxnoNo": "1234",
"rcvmnTelEndNo": "5678",
"frgnDirPurGoodsYn": "text"
}No content
기능 설명
보낸 선물함 목록을 조회합니다.
상세 설명
회원번호에 해당하는 선물한 주문 목록을 조회합니다.
비회원은 선물하기가 불가능하므로 조회할 수 없습니다.
조회시작일시, 조회종료일시 사이에 포함된 선물 주문 목록만 조회합니다.
주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C', 선물함 클릭시 'G' 로 데이터를 넘겨받습니다.
주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.
주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)
수정 번호
Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn) 추가
Access Token
선물함 목록 조회 DTO
화면당노출수량
10페이지번호
1조회시작일
2023-08-02조회종료일
2023-08-09주문현황구분코드값(모든주문조회: O / 클레임조회 : C / 선물함조회 : G)
C페이징처리여부
Y성공
주문 목록 DTO
주문건수
10화면당노출수량
10페이지번호
1업무처리 오류 내용
POST /api/order/v1/mypage/giftBox/sendGiftBoxList HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 117
{
"rowsPerPage": 10,
"pageIdx": 1,
"stdDt": "2023-08-02",
"endDt": "2023-08-09",
"orderClassificationCode": "C",
"pagingYn": "Y"
}{
"totCnt": 10,
"rowsPerPage": 10,
"pageIdx": 1,
"ordList": [
{
"ordNo": "20230809O007943",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"deliMethodCd": "10",
"deliMethodNm": "10",
"ordManNm": "홍길동",
"ordManCellNo": "Y",
"mbrNo": "100001452",
"ordGbCd": "10",
"rcvmnNm": "홍길동",
"rcvmnCellNo": "Y",
"prdList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"aeEvtList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"dlvpInfo": [
{
"dlvpSeq": "1",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층23",
"deliAddr": "서울 송파구 법원로9길 에이치비지니스파크 D동 6층23",
"rcvmnEmailAddr": "test@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"deliMsg": "문 앞에 두고 가주세요.",
"deliMsgCd": "10",
"deliMsgCdNm": "배송 전 연락바랍니다.",
"comnFrdrEtcMethod": "자유출입가능",
"comnFrdrPwd": "1234",
"comnFrdrCogoMethodCd": "10",
"persCstmCd": "text",
"deliNo": "101016693",
"deliInfoGroupList": [
{
"deliNo": "1",
"prdList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"aeEvtList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
]
}
]
}
],
"payInfo": [
{
"type": "R",
"ordNo": "20230809O007943",
"totOrdPrc": 1000,
"totAplyAdtnAmt": 1000,
"totDcAmt": 1000,
"saveMileageAmt": 10,
"addPayAmt": 1000,
"totPayAmt": 0,
"mileagePayAmt": 1000,
"pgGbCd": "1000",
"payMethodResponses": [
{
"payWayCd": "11",
"payWayCdNm": "신용카드",
"payReqCardcoCd": "201",
"payReqCardcoCdNm": "현대카드",
"acqrCd": "201",
"acqrCdNm": "현대카드",
"bankCd": "10",
"bankCdNm": "우리은행",
"actnNo": "계좌번호 암호화",
"dpmnNm": "김플래티어",
"dptFcstDt": "20990101",
"dlvMonCnt": 6,
"nintDivYn": "Y",
"payAmt": 1000
}
],
"accumulatedMileageResponses": [
{
"type": "FRS",
"adtnDtlGbCd": "41",
"adtnDtlGbCdNm": "기본적립",
"aplyAdtnAmt": 1000
}
]
}
]
}
]
}기능 설명
받은 선물함 목록을 조회합니다.
상세 설명
회원의 휴대전화번호와 선물 주문의 수취인휴대전화번호가 일치하는 주문, 회원의 회원번호와 선물수신자회원번호가 일치하는 주문 목록을 조회합니다.
비회원은 선물하기가 불가능하므로 조회할 수 없습니다.
조회시작일시, 조회종료일시 사이에 포함된 선물 주문 목록만 조회합니다.
주문현황구분코드는 마이페이지 > 주문 현황 > 주문/배송 클릭시 'O', 취소/교환/반품 클릭시 'C', 선물함 클릭시 'G' 로 데이터를 넘겨받습니다.
주문/배송으로 넘어왔을 경우 모든 주문에 대한 목록 조회이며, 취소/교환/반품으로 넘어왔을 경우는 취소/교환/반품에 대한 목록만 조회합니다.
주문상품 단위로 FO 시스템 클레임처리 가능상태(ST007) 그룹코드의 주문내역상태코드(ref_1_val)과 주문내역구분코드(ref_2_val)에 해당하는 각 코드를 가져와 화면단에서 버튼을 노출합니다.(orderButtonList)
받은 선물의 경우 취소/교환/반품 클레임이 불가능합니다.
주문변경, 배송지변경, 배송추적, 배송완료 만 가능합니다.
배송지입력의 경우 주문시점으로부터 3일 이내에 입력 해야합니다. 3일 지난 후 자동취소됩니다.
클레임가능일수(ST006) 그룹코드의 선물수락기한일수(30)으로 기한일수가 변경될 수 있습니다.
Access Token
선물함 목록 조회 DTO
화면당노출수량
10페이지번호
1조회시작일
2023-08-02조회종료일
2023-08-09주문현황구분코드값(모든주문조회: O / 클레임조회 : C / 선물함조회 : G)
C페이징처리여부
Y성공
주문 목록 DTO
주문건수
10화면당노출수량
10페이지번호
1업무처리 오류 내용
POST /api/order/v1/mypage/giftBox/receiveGiftBoxList HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 117
{
"rowsPerPage": 10,
"pageIdx": 1,
"stdDt": "2023-08-02",
"endDt": "2023-08-09",
"orderClassificationCode": "C",
"pagingYn": "Y"
}{
"totCnt": 10,
"rowsPerPage": 10,
"pageIdx": 1,
"ordList": [
{
"ordNo": "20230809O007943",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"deliMethodCd": "10",
"deliMethodNm": "10",
"ordManNm": "홍길동",
"ordManCellNo": "Y",
"mbrNo": "100001452",
"ordGbCd": "10",
"rcvmnNm": "홍길동",
"rcvmnCellNo": "Y",
"prdList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"aeEvtList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"dlvpInfo": [
{
"dlvpSeq": "1",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층23",
"deliAddr": "서울 송파구 법원로9길 에이치비지니스파크 D동 6층23",
"rcvmnEmailAddr": "test@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"deliMsg": "문 앞에 두고 가주세요.",
"deliMsgCd": "10",
"deliMsgCdNm": "배송 전 연락바랍니다.",
"comnFrdrEtcMethod": "자유출입가능",
"comnFrdrPwd": "1234",
"comnFrdrCogoMethodCd": "10",
"persCstmCd": "text",
"deliNo": "101016693",
"deliInfoGroupList": [
{
"deliNo": "1",
"prdList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"aeEvtList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
]
}
]
}
],
"payInfo": [
{
"type": "R",
"ordNo": "20230809O007943",
"totOrdPrc": 1000,
"totAplyAdtnAmt": 1000,
"totDcAmt": 1000,
"saveMileageAmt": 10,
"addPayAmt": 1000,
"totPayAmt": 0,
"mileagePayAmt": 1000,
"pgGbCd": "1000",
"payMethodResponses": [
{
"payWayCd": "11",
"payWayCdNm": "신용카드",
"payReqCardcoCd": "201",
"payReqCardcoCdNm": "현대카드",
"acqrCd": "201",
"acqrCdNm": "현대카드",
"bankCd": "10",
"bankCdNm": "우리은행",
"actnNo": "계좌번호 암호화",
"dpmnNm": "김플래티어",
"dptFcstDt": "20990101",
"dlvMonCnt": 6,
"nintDivYn": "Y",
"payAmt": 1000
}
],
"accumulatedMileageResponses": [
{
"type": "FRS",
"adtnDtlGbCd": "41",
"adtnDtlGbCdNm": "기본적립",
"aplyAdtnAmt": 1000
}
]
}
]
}
]
}기능설명
보낸 / 받은 선물함 상세 내역을 조회합니다.
상세내용
주문번호(ordNo)는 필수 파라미터입니다.
선물함 상세 유형(giftBoxType)값이 없는 경우 default 기타(30)로 할당됩니다.
해당 주문번호의 주문정보가 존재하지 않거나 선물 상품 정보가 없는경우 Exception(code : 1003)이 발생합니다.
보낸 선물함의 경우, 추가적으로 결제정보목록(payInfo)이 세팅됩니다.
배송지정보목록(dlvpInfo)의 첫번째 요소가 선물 수령 배송지입니다.
선물함 상세 유형(giftBoxType : 10 or 20)인 경우에 한해 상품정보목록(prdList)의 버튼목록(orderButtonList)이 세팅됩니다.(로그인 정보 필요)
받은 선물함의 경우, 노출 가능한 버튼 목록(orderButtonList)은 다음과 같습니다.
주문변경(91)
배송지변경(92)
배송추척(94)
수령확인(96)
배송지입력(97)
조회되는 공통코드 목록은 다음과 같습니다.
배송메시지코드(ME039)
공동현관출입방법코드(ME040)
수정번호
Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가
Release v2.00_240711 : 추가 배송비 개선에 따른 배송정책번호(deli_polc_no) 조회 추가
Release v2.00_240729 : 취소 가능 여부(ordCnclPsbYn) 추가
Access Token
선물함 상세 조회 요청 DTO
주문번호
20230809O007943GiftBoxType(선물함유형) * 10 : 받은선물함 * 20 : 보낸선물함 * 30 : 기타
10Possible values: 회원번호
100001311휴대폰구분번호
010휴대폰국번번호
1234휴대폰끝번호
5678성공
선물함 상세 조회 응답 DTO
주문번호
20230809O007943주문접수일시
배송방법코드(LO010)
10배송방법코드명
10주문자명
홍길동주문자 휴대폰번호
Y회원번호
100001452주문구분코드(OM002)
10수취인명
홍길동수취인 휴대폰번호
Y주문자휴대폰구분번호
010주문자휴대폰국번번호
1324주문자휴대폰끝번호
3546선물수신자회원번호
100001452선물수신자명
홍길동선물유형코드(OM045)
10카드이미지
/card-congrats.png선물상태코드(OM044)
10선물상태코드명
요청선물메시지
생일을 축하합니다!업무처리 오류 내용
POST /api/order/v1/mypage/giftBox/getGiftDetailInfo HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 123
{
"ordNo": "20230809O007943",
"giftBoxType": "10",
"mbrNo": "100001311",
"cellSctNo": "010",
"cellTxnoNo": "1234",
"cellEndNo": "5678"
}{
"ordNo": "20230809O007943",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"deliMethodCd": "10",
"deliMethodNm": "10",
"ordManNm": "홍길동",
"ordManCellNo": "Y",
"mbrNo": "100001452",
"ordGbCd": "10",
"rcvmnNm": "홍길동",
"rcvmnCellNo": "Y",
"prdList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"aeEvtList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"dlvpInfo": [
{
"dlvpSeq": "1",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층23",
"deliAddr": "서울 송파구 법원로9길 에이치비지니스파크 D동 6층23",
"rcvmnEmailAddr": "test@plateer.com",
"rcvmnCellSctNo": "010",
"rcvmnCellTxnoNo": "1234",
"rcvmnCellEndNo": "5678",
"deliMsg": "문 앞에 두고 가주세요.",
"deliMsgCd": "10",
"deliMsgCdNm": "배송 전 연락바랍니다.",
"comnFrdrEtcMethod": "자유출입가능",
"comnFrdrPwd": "1234",
"comnFrdrCogoMethodCd": "10",
"persCstmCd": "text",
"deliNo": "101016693",
"deliInfoGroupList": [
{
"deliNo": "1",
"prdList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
],
"aeEvtList": [
{
"system": "10",
"dlvpSeq": "1",
"ordNo": "20230809O007943",
"ordDtlGbCd": "10",
"ordDtlGbCdNm": "주문완료",
"ordGbCd": "10",
"ordGbCdNm": "일반주문",
"ordSeq": "1",
"ordProcSeq": "1",
"claimNo": "20230725C006642",
"aeOrdSeq": "1",
"goodsNo": "10002042",
"goodsNm": "P직매입20",
"itmNo": "001",
"itmNm": "레드>190x190",
"sngGoodsYn": "Y",
"goodsTypCd": "10",
"goodsTypCdNm": "일반상품",
"brandNo": "100002",
"brandNm": "멀버리",
"ordDtlStatCd": "12",
"ordDtlStatCdNm": "주문완료",
"prestNm": "증정품",
"norPrc": 1000,
"salePrc": 1000,
"dcAmt": 0,
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"ordAmt": 1000,
"deliNo": "1",
"deliKindCd": "10",
"deliKindCdNm": "일반배송",
"shipWaitCaus": "10",
"shipWaitCausNm": "재고부족",
"deliTypCd": "01",
"deliTypCdNm": "일반상품",
"deliGbCd": "10",
"deliPolcNo": "10000431",
"rcvmnNm": "홍길동",
"zipNo": "05837",
"zipAddr": "서울 송파구 법원로9길 26",
"dtlAddr": "비즈니스파크",
"deliAddr": "서울 송파구 법원로9길 26 비즈니스파크",
"deliMethodCd": "10",
"deliMethodCdNm": "택배배송",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsRevWrtYn": "N",
"deliFnshDtm": "2026-01-01T00:00:00.000Z",
"goodsImg": "/url",
"rtnPsbYn": "N",
"prstStatCd": "10",
"claimMgrpCd": "100",
"claimCauseFaultType": "10",
"wthdFnshGbCd": "10",
"exchPsbYn": "N",
"ordCnclPsbYn": "Y",
"wthdYn": "Y",
"ecpnNo": "ORD0001",
"etcktNo": "ORD0001",
"saleMethCd": "20",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"frgnDirPurGoodsYn": "text",
"taxGbCd": "text"
}
]
}
]
}
],
"payInfo": [
{
"type": "R",
"ordNo": "20230809O007943",
"totOrdPrc": 1000,
"totAplyAdtnAmt": 1000,
"totDcAmt": 1000,
"saveMileageAmt": 10,
"addPayAmt": 1000,
"totPayAmt": 0,
"mileagePayAmt": 1000,
"pgGbCd": "1000",
"payMethodResponses": [
{
"payWayCd": "11",
"payWayCdNm": "신용카드",
"payReqCardcoCd": "201",
"payReqCardcoCdNm": "현대카드",
"acqrCd": "201",
"acqrCdNm": "현대카드",
"bankCd": "10",
"bankCdNm": "우리은행",
"actnNo": "계좌번호 암호화",
"dpmnNm": "김플래티어",
"dptFcstDt": "20990101",
"dlvMonCnt": 6,
"nintDivYn": "Y",
"payAmt": 1000
}
],
"accumulatedMileageResponses": [
{
"type": "FRS",
"adtnDtlGbCd": "41",
"adtnDtlGbCdNm": "기본적립",
"aplyAdtnAmt": 1000
}
]
}
],
"ordManCellSctNo": "010",
"ordManCellTxnoNo": "1324",
"ordManCellEndNo": "3546",
"prstRecvmnMbrNo": "100001452",
"prstRecvmnNm": "홍길동",
"prstTypCd": "10",
"cardImg": "/card-congrats.png",
"prstStatCd": "10",
"prstStatCdNm": "요청",
"prstMsg": "생일을 축하합니다!",
"codeMap": {
"ANY_ADDITIONAL_PROPERTY": [
{
"cd": "302",
"cdNm": "색상변경",
"cdDesc": "[단순변심]",
"sortSeq": "22",
"ref1Val": "30",
"ref2Val": "10",
"ref3Val": "10",
"ref4Val": "10",
"ref5Val": "Y",
"ref6Val": "null",
"ref7Val": "null"
}
]
}
}마지막 업데이트