Gift Box
Function Description
Applies the gift recipient's delivery address to the corresponding order data.
Detailed Description
Called when the delivery address input button is clicked on the gifting landing page, received gift box detail, or received gift box list.
Updates the order's delivery address information to the address entered by the recipient.
Updates the delivery instruction reservation datetime of the order detail data to the acceptance datetime.
Changes the gift status code (OM044) of the order's basic data to accepted.
Revision History
Release v2.00_240711 : Modified the additional-delivery-fee occurrence check due to additional delivery fee improvements
Access Token
Order Delivery Address Change/Registration DTO
Order No.
20230809O007943Claim No.
20230801C008072SYSTEM (System Type) * 10 : FO * 20 : BO
10Possible values: Member No.
10000001Delivery No.
100008491Delivery Policy No.
10000431Delivery Address Name
집Recipient Name
홍길동Postal Code Sequence No.
1New Postal Code
8739Previous Postal Code
5837Delivery Address Sequence No. Before Change
1Postal Address
서울 송파구 법원로9길Detailed Address
에이치비지니스파크 D동 6층23Recipient's Mobile Phone Prefix Code
010Recipient's Mobile Phone Exchange Code
1234Recipient's Mobile Phone Last Digits
5678Delivery Message
문 앞에 두고 가주세요.Delivery Message Code (ME039) 10: No delivery message, 20: Please call before delivery, 30: Leave at the door if absent, 40: Leave with security desk if absent, 50: Please deliver quickly, 60: Please call my mobile if absent, 70: Enter manually
10Other Common Entrance Access Method
자유출입가능Common Entrance Password
1234Common Entrance Access Method Code (ME040) 10: Entrance access code, 20: Free access, 30: Other
10LO001(Delivery Type Code) * 10 : Shipment * 20 : Return
10Possible values: Delivery Sequence No.
1Recipient Email
test@plateer.comRecipient's Phone Area Code
02Recipient's Phone Exchange Code
1234Recipient's Phone Last Digits
5678Overseas Direct Purchase Product Status
Success
No content
Business processing error details
PUT /api/order/v1/mypage/giftBox/registerShippingAddress HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 715
{
"ordNo": "20230809O007943",
"clmNo": "20230801C008072",
"systemType": "10",
"mbrNo": "10000001",
"deliNo": "100008491",
"deliPolcNo": "10000431",
"dlvpNm": "집",
"rcvmnNm": "홍길동",
"zipNoSeq": 1,
"zipNo": 8739,
"originZipNo": 5837,
"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
Function Description
Looks up the sent gift box list.
Detailed Description
Looks up the list of gift orders sent, corresponding to the member number.
Non-members cannot look this up since gifting is not available to them.
Only looks up gift order lists included between the lookup start datetime and lookup end datetime.
The order status classification code is passed as 'O' when clicking Order/Delivery, 'C' when clicking Cancel/Exchange/Return, and 'G' when clicking Gift Box, under My Page > Order Status.
When passed as Order/Delivery, all orders are listed; when passed as Cancel/Exchange/Return, only orders in Cancel/Exchange/Return status are listed.
For each order product, retrieves the codes matching the order history status code (ref_1_val) and order history type code (ref_2_val) of the FO system claim-processable-status (ST007) group code, to display buttons on the screen (orderButtonList).
Revision History
Release v2.00_240729 : Added order-cancellation-allowed status (ordCnclPsbYn)
Access Token
Search Gift Box List DTO
Display Quantity per Screen
10Page No.
1Search Start Date
2023-08-02Search End Date
2023-08-09Order Status Classification Code Value (All Orders: O / Claims: C / Gift Box: G)
CPaging Status
YSuccess
Order List DTO
Order Count
10Display Quantity per Screen
10Page No.
1Business processing error details
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": 5837,
"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": 5837,
"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": 5837,
"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": 5837,
"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": 5837,
"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
}
]
}
]
}
]
}Function Description
Looks up the received gift box list.
Detailed Description
Looks up orders where the member's phone number matches the gift order's recipient phone number, and orders where the member's member number matches the gift recipient member number.
Non-members cannot look this up since gifting is not available to them.
Only looks up gift order lists included between the lookup start datetime and lookup end datetime.
The order status classification code is passed as 'O' when clicking Order/Delivery, 'C' when clicking Cancel/Exchange/Return, and 'G' when clicking Gift Box, under My Page > Order Status.
When passed as Order/Delivery, all orders are listed; when passed as Cancel/Exchange/Return, only orders in Cancel/Exchange/Return status are listed.
For each order product, retrieves the codes matching the order history status code (ref_1_val) and order history type code (ref_2_val) of the FO system claim-processable-status (ST007) group code, to display buttons on the screen (orderButtonList).
For received gifts, Cancel/Exchange/Return claims are not possible.
Only order change, delivery address change, delivery tracking, and delivery completion are possible.
Delivery address entry must be completed within 3 days of order time. It is automatically cancelled after 3 days.
The deadline may be changed by the gift-acceptance deadline days (30) of the claim-allowed-days (ST006) group code.
Access Token
Search Gift Box List DTO
Display Quantity per Screen
10Page No.
1Search Start Date
2023-08-02Search End Date
2023-08-09Order Status Classification Code Value (All Orders: O / Claims: C / Gift Box: G)
CPaging Status
YSuccess
Order List DTO
Order Count
10Display Quantity per Screen
10Page No.
1Business processing error details
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": 5837,
"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": 5837,
"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": 5837,
"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": 5837,
"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": 5837,
"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
}
]
}
]
}
]
}Function Description
Looks up sent / received gift box details.
Detailed Description
Order No. (ordNo) is a required parameter.
If the gift box detail type (giftBoxType) value is absent, it defaults to Other (30).
An Exception (code: 1003) occurs if no order information exists for the given order number or no gift product information exists.
For a sent gift box, the payment information list (payInfo) is additionally set.
The first element of the delivery address information list (dlvpInfo) is the gift delivery address.
The button list (orderButtonList) of the product information list (prdList) is only set for gift box detail type (giftBoxType: 10 or 20). (login information required)
For a received gift box, the buttons that can be displayed (orderButtonList) are as follows.
Order Change (91)
Delivery Address Change (92)
Delivery Tracking (94)
Receipt Confirmation (96)
Delivery Address Entry (97)
The common codes looked up are as follows.
Delivery Message Code (ME039)
Common Entrance Access Method Code (ME040)
Revision History
Release v2.00_240425 : Added site number (site_no) for multi-site expansion
Release v2.00_240711 : Added lookup of delivery policy number (deli_polc_no) due to additional delivery fee improvements
Release v2.00_240729 : Added order-cancellation-allowed status (ordCnclPsbYn)
Access Token
Search Gift Box Detail Request DTO
Order No.
20230809O007943GiftBoxType (Gift Box Type) * 10 : Received Gift Box * 20 : Sent Gift Box * 30 : Other
10Possible values: Member No.
100001311Mobile Phone Prefix Code
010Mobile Phone Exchange Code
1234Mobile Phone Last Digits
5678Success
Search Gift Box Detail Response DTO
Order No.
20230809O007943Order Receipt Date/Time
Delivery Method Code (LO010)
10Delivery Method Code Name
10Orderer Name
홍길동Orderer Mobile Phone No.
YMember No.
100001452Order Classification Code (OM002)
10Recipient Name
홍길동Recipient Mobile Phone No.
YOrderer's Mobile Phone Prefix Code
010Orderer's Mobile Phone Exchange Code
1324Orderer's Mobile Phone Last Digits
3546Gift Recipient Member No.
100001452Gift Recipient Name
홍길동Gift Type Code (OM045)
10Card Image
/card-congrats.pngGift Status Code (OM044)
10Gift Status Code Name
요청Gift Message
생일을 축하합니다!Business processing error details
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": 5837,
"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": 5837,
"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": 5837,
"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": 5837,
"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": 5837,
"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"
}
]
}
}Last updated