> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/store-front-api-reference/order-api/event-provision.md).
# Event Provision
## Save Gift Delivery Address
> \## Function Description\
> \- Registers or modifies the delivery address for event gift delivery.\
> \---\
> \## Detailed Description\
> \- If \*\*the miscellaneous gift delivery address number\*\* is absent, registers a delivery address\
> \- If \*\*the miscellaneous gift delivery address number\*\* is present, modifies the delivery address\
> \- Only delivery address information can be changed during modification.\
> \- \*(recipient, recipient phone number, delivery address, detailed delivery address, etc.)\*\
> \- \*\*The miscellaneous gift delivery address number\*\* is required when completing registration or modification.
```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/event/registModifyEtcGftDlvp":{"post":{"tags":["Event Provision"],"summary":"Save Gift Delivery Address","description":"## Function Description\n- Registers or modifies the delivery address for event gift delivery.\n---\n## Detailed Description\n- If **the miscellaneous gift delivery address number** is absent, registers a delivery address\n- If **the miscellaneous gift delivery address number** is present, modifies the delivery address\n- Only delivery address information can be changed during modification.\n - *(recipient, recipient phone number, delivery address, detailed delivery address, etc.)*\n- **The miscellaneous gift delivery address number** is required when completing registration or modification.\n","operationId":"registModifyEtcGftDlvp","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EtcGftDlvpRequest"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EtcGftDlvpResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EtcGftDlvpRequest":{"type":"object","properties":{"etcGftDlvpNo":{"type":"string","description":"Other Gift Delivery Address No.","nullable":true,"enum":["null","기타사은품배송지번호"]},"etcGftIssuSubCd":{"type":"string","description":"Other Free Gift Issuer Code (MK022) (Required upon Registration)","nullable":true,"enum":["10"]},"etcGftIssuSubNo":{"type":"string","description":"Other Gift Issuer No.","nullable":true},"etcGftIssuSubDtlNo":{"type":"string","description":"Other Gift Issuer Detail No.","nullable":true},"etcGftNm":{"type":"string","description":"Free Gift Name","nullable":true},"mbrNo":{"type":"string","description":"Customer No.","nullable":true},"mbrNm":{"type":"string","description":"Customer Name","nullable":true},"loginId":{"type":"string","description":"Member ID","nullable":true},"goodsNo":{"type":"string","description":"Product No.","nullable":true},"goodsNm":{"type":"string","description":"Product Name","nullable":true},"rcvmnNm":{"type":"string","description":"Recipient Name"},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"cellSctNo":{"type":"string","description":"Mobile Phone Prefix Code"},"cellTxnoNo":{"type":"string","description":"Mobile Phone Exchange Code"},"cellEndNo":{"type":"string","description":"Mobile Phone Last Digits"},"deliMsg":{"type":"string","description":"Delivery Message","nullable":true},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method","nullable":true},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password","nullable":true},"sysRegId":{"type":"string","description":"Registrant ID"},"winRnk":{"type":"integer","description":"Winner Rank","format":"int32","nullable":true},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code (ME040)","nullable":true,"enum":["10","20","30"]}},"description":"Register/Modify Gift Delivery Address Request"},"EtcGftDlvpResponse":{"type":"object","properties":{"etcGftDlvpNo":{"type":"string","description":"Other Gift Delivery Address No."},"etcGftIssuSubNo":{"type":"string","description":"Other Gift Issuer No.","nullable":true},"etcGftIssuSubDtlNo":{"type":"string","description":"Other Gift Issuer Detail No.","nullable":true},"winRnk":{"type":"integer","description":"Winner Rank","format":"int32","nullable":true}},"description":"Register/Modify Gift Delivery Address Request"},"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"}}}}
```
## Look Up Event Target Amount
> \## Function Description\
> \- Looks up a list of order amounts meeting the requested criteria within the member's requested period.\
> \---\
> \## Detailed Description\
> \- Order amounts that were cancelled or returned are deducted or excluded.\
> \- Field criteria within the request are queried with AND conditions, and information within a field criterion (values within a list) is queried with OR conditions.
```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/event/evtOrdList":{"post":{"tags":["Event Provision"],"summary":"Look Up Event Target Amount","description":"## Function Description\n- Looks up a list of order amounts meeting the requested criteria within the member's requested period.\n---\n## Detailed Description\n- Order amounts that were cancelled or returned are deducted or excluded.\n- Field criteria within the request are queried with AND conditions, and information within a field criterion (values within a list) is queried with OR conditions.\n","operationId":"getMemberEventOrderAmtList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderAmtRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderAmtInfoResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrderAmtRequest":{"required":["buyEndDtm","buyStrDtm","mbrNo"],"type":"object","properties":{"mbrNo":{"type":"string","description":"Customer No."},"buyStrDtm":{"type":"string","description":"Purchase Period Start Date/Time","format":"date-time"},"buyEndDtm":{"type":"string","description":"Purchase Period End Date/Time","format":"date-time"},"siteList":{"type":"array","description":"Site List (Application Target)","items":{"type":"string","description":"Site List (Application Target)"}},"categoryList":{"type":"array","description":"Category List (Application Target)","items":{"type":"string","description":"Category List (Application Target)"}},"exCategoryList":{"type":"array","description":"Category List (Exclusion Target)","items":{"type":"string","description":"Category List (Exclusion Target)"}},"mkDisplayList":{"type":"array","description":"Special Promotion List (Application Target)","items":{"type":"string","description":"Special Promotion List (Application Target)"}},"brandList":{"type":"array","description":"Brand List (Application Target)","items":{"type":"string","description":"Brand List (Application Target)"}},"goodsList":{"type":"array","description":"Product List (Application Target)","items":{"type":"string","description":"Product List (Application Target)"}},"exGoodsList":{"type":"array","description":"Product List (Exclusion Target)","items":{"type":"string","description":"Product List (Exclusion Target)"}},"channelList":{"type":"array","description":"Channel List (Application Target)","items":{"type":"string","description":"Channel List (Application Target)"}}},"description":"Search Event Target Amount Request"},"OrderAmtInfoResponse":{"type":"object","properties":{"orderList":{"type":"array","description":"Order History","items":{"$ref":"#/components/schemas/OrderAmtInfo"}},"totOrdAmt":{"type":"integer","description":"Total Order Amount in Order History","format":"int64"}},"description":"Search Event Target Amount Response"},"OrderAmtInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"Order No."},"ordDtm":{"type":"string","description":"Order Date/Time","format":"date-time"},"ordAmt":{"type":"integer","description":"Order Amount","format":"int64"}},"description":"Order Info"},"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"}}}}
```