> 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/back-office-api-reference/delivery-bo-api/event-gift-delivery-management.md).
# Event Gift Delivery Management
## Save Event Gift Delivery Management
> \## Function Description\
> \* Processes event gift delivery.\
> \---\
> \## Detailed Content\
> \* Processes event gift delivery on the Event Gift Delivery Management screen.\
> \* Processes shipment completion and delivery completion for event gifts.\
> \* The event gift delivery management edit target list is required.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EventEtcGiftDeliverySaveRequest":{"type":"object","description":"Event Gift Delivery Management Modification Request DTO","properties":{"eventEtcGiftDeliverySaveInfoList":{"type":"array","description":"Event Gift Delivery Management Modification Target List","items":{"$ref":"#/components/schemas/EventEtcGiftDeliverySaveInfo"},"minItems":1}},"required":["eventEtcGiftDeliverySaveInfoList"]},"EventEtcGiftDeliverySaveInfo":{"type":"object","description":"Event Gift Information DTO","properties":{"etcGftDlvpNo":{"type":"string","description":"Gift Delivery No.","minLength":1},"etcGftStatCd":{"type":"string","description":"Order Detail Status (LO013)","minLength":1},"invNo":{"type":"string","description":"Invoice No."},"hdcCd":{"type":"string","description":"Courier Company Code (LO005)"}},"required":["etcGftDlvpNo","etcGftStatCd"]},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/delivery/eventEtcGiftDeliveryMgmt/saveEventEtcGiftDeliveryProcess":{"post":{"tags":["Event Gift Delivery Management"],"summary":"Save Event Gift Delivery Management","description":"## Function Description\n* Processes event gift delivery.\n---\n## Detailed Content\n* Processes event gift delivery on the Event Gift Delivery Management screen.\n* Processes shipment completion and delivery completion for event gifts.\n* The event gift delivery management edit target list is required.\n","operationId":"saveEventEtcGiftDeliveryProcess","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventEtcGiftDeliverySaveRequest"}}},"required":true},"responses":{"200":{"description":"Event Gift Delivery Management Save Successful"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Event Gift Delivery Management
> \## Function Description\
> \* Retrieves the event gift delivery management list.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of event gifts on the Event Gift Delivery Management screen.\
> \* Only retrieves records whose Other Gift Status Code (LO013) is Shipment Instructed (20), Shipment Completed (30), or Delivery Completed (40).\
> \* Inquiry Period Type, Inquiry Start Date, Inquiry End Date, and Order History Status (Other Gift Status) are required.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EventEtcGiftDeliveryRequest":{"type":"object","description":"Event Gift Delivery Management Request DTO","properties":{"qryGbCd":{"type":"string","description":"Search Type (UR014)"},"indInfoQryCaus":{"type":"string","description":"Personal Information Access Reason"},"searchPeriodType":{"type":"string","description":"Search Period Type","minLength":1},"startDate":{"type":"string","format":"date","description":"Search Start Date"},"endDate":{"type":"string","format":"date","description":"Search End Date"},"eventInfoType":{"type":"string","description":"Event Information Type"},"eventInfo":{"type":"string","description":"Event Information"},"etcGftStatCd":{"type":"string","description":"Order Detail Status (LO013)"},"goodsNo":{"type":"string","description":"Product No."}},"required":["endDate","etcGftStatCd","searchPeriodType","startDate"]},"RealGridListResponseEventEtcGiftDeliveryResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/EventEtcGiftDeliveryResponse"}}}},"EventEtcGiftDeliveryResponse":{"type":"object","description":"Event Gift Delivery Inquiry Response DTO","properties":{"etcGftDlvpNo":{"type":"string","description":"Gift Delivery No."},"etcGftIssuSubCd":{"type":"string","description":"Gift Issuing Entity Code (MK022)"},"etcGftIssuSubNo":{"type":"string","description":"Gift Issuing Entity No."},"etcGftIssuSubDtlNo":{"type":"string","description":"Gift Issuing Entity Detail No."},"etcGftStatCd":{"type":"string","description":"Order History Status Code (LO013)"},"etcGftStatNm":{"type":"string","description":"Order Detail Status Name"},"mbrNo":{"type":"string","description":"Member No."},"goodsNo":{"type":"string","description":"Product No."},"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"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"hdcCd":{"type":"string","description":"Courier Company Code"},"invNo":{"type":"string","description":"Invoice No."},"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"goodsNm":{"type":"string","description":"Product Name"},"loginId":{"type":"string","description":"Login ID"},"mbrNm":{"type":"string","description":"Member Name"},"shipFnshDtm":{"type":"string","format":"date-time","description":"Shipment Completion Date/Time"},"deliFnshDtm":{"type":"string","format":"date-time","description":"Delivery Completion Date/Time"},"fullAddr":{"type":"string","description":"Address"},"shipIndiDtm":{"type":"string","format":"date-time","description":"Shipment Instruction Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftDeliveryInfoList":{"get":{"tags":["Event Gift Delivery Management"],"summary":"Retrieve Event Gift Delivery Management","description":"## Function Description\n* Retrieves the event gift delivery management list.\n---\n## Detailed Description\n* Retrieves the list of event gifts on the Event Gift Delivery Management screen.\n* Only retrieves records whose Other Gift Status Code (LO013) is Shipment Instructed (20), Shipment Completed (30), or Delivery Completed (40).\n* Inquiry Period Type, Inquiry Start Date, Inquiry End Date, and Order History Status (Other Gift Status) are required.\n","operationId":"getEventEtcGiftDeliveryInfoList","parameters":[{"name":"eventEtcGiftDeliveryRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/EventEtcGiftDeliveryRequest"}},{"name":"searchPeriodType","in":"query","description":"Search Period Type","required":true,"schema":{"type":"String"}},{"name":"startDate","in":"query","description":"Search Start Date","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"Search End Date","required":true,"schema":{"type":"LocalDate"}},{"name":"eventInfoType","in":"query","description":"Event Information Type","schema":{"type":"String"}},{"name":"eventInfo","in":"query","description":"Event Information","schema":{"type":"String"}},{"name":"etcGftStatCd","in":"query","description":"Order History Status","required":true,"schema":{"type":"String"}},{"name":"goodsNo","in":"query","description":"Product No.","schema":{"type":"String"}},{"name":"qryGbCd","in":"query","description":"Search Type (UR014)","schema":{"type":"String"}},{"name":"indInfoQryCaus","in":"query","description":"Personal Information Access Reason","schema":{"type":"String"}}],"responses":{"200":{"description":"Event Gift Delivery Management Inquiry Successful","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseEventEtcGiftDeliveryResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Event Gift Delivery Management Bulk Excel Download
> \## Function Description\
> \* Retrieves the bulk data Excel download list.\
> \---\
> \## Detailed Content\
> \* Downloads bulk data as Excel from the Event Gift Delivery Management screen.\
> \* Inquiry Period Type, Inquiry Start Date, Inquiry End Date, and Order History Status (Other Gift Status) are required.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EventEtcGiftDeliveryRequest":{"type":"object","description":"Event Gift Delivery Management Request DTO","properties":{"qryGbCd":{"type":"string","description":"Search Type (UR014)"},"indInfoQryCaus":{"type":"string","description":"Personal Information Access Reason"},"searchPeriodType":{"type":"string","description":"Search Period Type","minLength":1},"startDate":{"type":"string","format":"date","description":"Search Start Date"},"endDate":{"type":"string","format":"date","description":"Search End Date"},"eventInfoType":{"type":"string","description":"Event Information Type"},"eventInfo":{"type":"string","description":"Event Information"},"etcGftStatCd":{"type":"string","description":"Order Detail Status (LO013)"},"goodsNo":{"type":"string","description":"Product No."}},"required":["endDate","etcGftStatCd","searchPeriodType","startDate"]},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","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"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftDeliveryExcelData":{"get":{"tags":["Event Gift Delivery Management"],"summary":"Retrieve Event Gift Delivery Management Bulk Excel Download","description":"## Function Description\n* Retrieves the bulk data Excel download list.\n---\n## Detailed Content\n* Downloads bulk data as Excel from the Event Gift Delivery Management screen.\n* Inquiry Period Type, Inquiry Start Date, Inquiry End Date, and Order History Status (Other Gift Status) are required.\n","operationId":"getEventEtcGiftDeliveryExcelData","parameters":[{"name":"eventEtcGiftDeliveryRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/EventEtcGiftDeliveryRequest"}},{"name":"searchPeriodType","in":"query","description":"Search Period Type","required":true,"schema":{"type":"String"}},{"name":"startDate","in":"query","description":"Search Start Date","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"Search End Date","required":true,"schema":{"type":"LocalDate"}},{"name":"eventInfoType","in":"query","description":"Event Information Type","schema":{"type":"String"}},{"name":"eventInfo","in":"query","description":"Event Information","schema":{"type":"String"}},{"name":"etcGftStatCd","in":"query","description":"Order History Status","required":true,"schema":{"type":"String"}},{"name":"goodsNo","in":"query","description":"Product No.","schema":{"type":"String"}},{"name":"qryGbCd","in":"query","description":"Search Type (UR014)","schema":{"type":"String"}},{"name":"indInfoQryCaus","in":"query","description":"Personal Information Access Reason","schema":{"type":"String"}}],"responses":{"200":{"description":"Event Gift Delivery Management Bulk Data Excel Download Inquiry Successful","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Target Data for Gift Shipment Completion Bulk Registration Validation
> \## Function Description\
> \* Retrieves the target data for validating gift shipment completion bulk registration.\
> \---\
> \## Detailed Content\
> \* Retrieves the detailed list for validation during bulk Excel upload on the Event Gift Delivery Management >> Bulk Registration popup screen.\
> \* The gift delivery number list is required.\
> \---\
> \## Revision History\
> \* Release v2.00\_240829 : Added default address masking
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EventEtcGiftBatchRegisterValidRequest":{"type":"object","description":"Gift Shipment Completion Bulk Registration Validation Request DTO","properties":{"etcGftDlvpNoList":{"type":"array","description":"Gift Delivery No. List","items":{"type":"string"},"minItems":1}},"required":["etcGftDlvpNoList"]},"EventEtcGiftDeliveryResponse":{"type":"object","description":"Event Gift Delivery Inquiry Response DTO","properties":{"etcGftDlvpNo":{"type":"string","description":"Gift Delivery No."},"etcGftIssuSubCd":{"type":"string","description":"Gift Issuing Entity Code (MK022)"},"etcGftIssuSubNo":{"type":"string","description":"Gift Issuing Entity No."},"etcGftIssuSubDtlNo":{"type":"string","description":"Gift Issuing Entity Detail No."},"etcGftStatCd":{"type":"string","description":"Order History Status Code (LO013)"},"etcGftStatNm":{"type":"string","description":"Order Detail Status Name"},"mbrNo":{"type":"string","description":"Member No."},"goodsNo":{"type":"string","description":"Product No."},"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"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"hdcCd":{"type":"string","description":"Courier Company Code"},"invNo":{"type":"string","description":"Invoice No."},"evtNo":{"type":"string","description":"Event No."},"evtNm":{"type":"string","description":"Event Name"},"goodsNm":{"type":"string","description":"Product Name"},"loginId":{"type":"string","description":"Login ID"},"mbrNm":{"type":"string","description":"Member Name"},"shipFnshDtm":{"type":"string","format":"date-time","description":"Shipment Completion Date/Time"},"deliFnshDtm":{"type":"string","format":"date-time","description":"Delivery Completion Date/Time"},"fullAddr":{"type":"string","description":"Address"},"shipIndiDtm":{"type":"string","format":"date-time","description":"Shipment Instruction Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/delivery/eventEtcGiftDeliveryMgmt/getEventEtcGiftBatchRegisterValidList":{"get":{"tags":["Event Gift Delivery Management"],"summary":"Retrieve Target Data for Gift Shipment Completion Bulk Registration Validation","description":"## Function Description\n* Retrieves the target data for validating gift shipment completion bulk registration.\n---\n## Detailed Content\n* Retrieves the detailed list for validation during bulk Excel upload on the Event Gift Delivery Management >> Bulk Registration popup screen.\n* The gift delivery number list is required.\n---\n## Revision History\n* Release v2.00_240829 : Added default address masking\n","operationId":"getEventEtcGiftBatchRegisterValidList","parameters":[{"name":"eventEtcGiftBatchRegisterValidRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/EventEtcGiftBatchRegisterValidRequest"}},{"name":"etcGftDlvpNoList","in":"query","description":"Gift Delivery No. List","required":true,"schema":{"type":"List"}}],"responses":{"200":{"description":"Gift Shipment Completion Bulk Registration Validation Target Data Inquiry Successful","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EventEtcGiftDeliveryResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```