> 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/collection-processing.md).

# Collection Processing

## Update Retrieval Status

> \## Function Description\
> \* Updates the retrieval status.\
> \---\
> \## Detailed Description\
> \* The retrieval status is updated when the Retrieval Instruction button is clicked on the BO Retrieval Confirmation screen, or when the Retrieval Complete button is clicked on the Retrieval Complete screen.\
> \* The status is updated by calling the Retrieval Status Update API in API-ORDER.\
> \* Current Order History Status (OM005), Order History Status to Update (OM005), and the target list for retrieval progress status update are required.\
> \---\
> \## Revision History\
> \* Release v2.00\_240729 : Allowed null for Courier Code (hdcCd) and Invoice No. (invNo) in the case of e-coupon delivery<br>

```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":{"WithdrawStatUpdateSaveRequest":{"type":"object","description":"Retrieval Status Update Request DTO","properties":{"ordDtlStatCd":{"type":"string","description":"Current Order Progress Status (OM005)","minLength":1},"updateTargetOrdDtlStatCd":{"type":"string","description":"Order Progress Status to Update (OM005)","minLength":1},"withdrawStatUpdateSaveInfoList":{"type":"array","description":"Collection Progress Status Update Target List","items":{"$ref":"#/components/schemas/WithdrawStatUpdateSaveInfo"},"minItems":1}},"required":["ordDtlStatCd","updateTargetOrdDtlStatCd","withdrawStatUpdateSaveInfoList"]},"WithdrawStatUpdateSaveInfo":{"type":"object","description":"Retrieval Status Update Information DTO","properties":{"ordNo":{"type":"string","description":"Order No.","minLength":1},"deliNo":{"type":"string","description":"Delivery No.","minLength":1},"hdcCd":{"type":"string","description":"Courier Company Code"},"invNo":{"type":"string","description":"Invoice No."},"wthdFnshGbCd":{"type":"string","description":"Collection Completion Classification Code (LO011)"},"wthdYn":{"type":"string","description":"Collection Status"}},"required":["deliNo","hdcCd","invNo","ordNo"]},"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/withdrawMgmt/saveWithdrawStatUpdateProcess":{"post":{"tags":["Collection Processing"],"summary":"Update Retrieval Status","description":"## Function Description\n* Updates the retrieval status.\n---\n## Detailed Description\n* The retrieval status is updated when the Retrieval Instruction button is clicked on the BO Retrieval Confirmation screen, or when the Retrieval Complete button is clicked on the Retrieval Complete screen.\n* The status is updated by calling the Retrieval Status Update API in API-ORDER.\n* Current Order History Status (OM005), Order History Status to Update (OM005), and the target list for retrieval progress status update are required.\n---\n## Revision History\n* Release v2.00_240729 : Allowed null for Courier Code (hdcCd) and Invoice No. (invNo) in the case of e-coupon delivery\n","operationId":"saveWithdrawStatUpdateProcess","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawStatUpdateSaveRequest"}}},"required":true},"responses":{"200":{"description":"Retrieval Status Update Successful"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Process Retrieval Instruction

> \## Function Description\
> \* Processes the retrieval instruction.\
> \---\
> \## Detailed Content\
> \* The retrieval instruction is processed when the Retrieval Instruction button is clicked on the BO Retrieval Instruction Processing screen.\
> \* The retrieval instruction is processed by calling the Retrieval Instruction Processing API in API-ORDER.\
> \* The retrieval instruction target list is required.\
> \* Changes orders whose order history status (OM005) is Return Accepted (32) to Retrieval Instructed (34) status.<br>

```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":{"WithdrawInstructHandlingSaveRequest":{"type":"object","description":"Retrieval Instruction Target Processing Request DTO","properties":{"withdrawInstructHandlingSaveInfoList":{"type":"array","description":"Collection Instruction Target List","items":{"$ref":"#/components/schemas/WithdrawInstructHandlingSaveInfo"}}}},"WithdrawInstructHandlingSaveInfo":{"type":"object","description":"Retrieval Instruction Target Information DTO","properties":{"ordNo":{"type":"string","description":"Order No.","minLength":1},"deliNo":{"type":"string","description":"Delivery No.","minLength":1},"rtnQty":{"type":"integer","format":"int32","description":"Return Quantity"}},"required":["deliNo","ordNo","rtnQty"]},"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/withdrawMgmt/saveWithdrawInstructHandlingList":{"post":{"tags":["Collection Processing"],"summary":"Process Retrieval Instruction","description":"## Function Description\n* Processes the retrieval instruction.\n---\n## Detailed Content\n* The retrieval instruction is processed when the Retrieval Instruction button is clicked on the BO Retrieval Instruction Processing screen.\n* The retrieval instruction is processed by calling the Retrieval Instruction Processing API in API-ORDER.\n* The retrieval instruction target list is required.\n* Changes orders whose order history status (OM005) is Return Accepted (32) to Retrieval Instructed (34) status.\n","operationId":"saveWithdrawInstructHandlingList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawInstructHandlingSaveRequest"}}},"required":true},"responses":{"200":{"description":"Retrieval Instruction Processing Successful"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Return Processing During Exchange

> \## Function Description\
> \* Processes conversion to return.\
> \---\
> \## Detailed Description\
> \* Conversion to return during exchange is processed when the Convert to Return button is clicked on the BO Retrieval Complete Processing screen.\
> \* This is processed by calling the Convert to Return API in API-ORDER.\
> \* Order No., Claim No., and Order Channel Code are required.<br>

```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":{"ReturnTrnsformRequest":{"type":"object","description":"Convert to Return Request DTO","properties":{"ordNo":{"type":"string","description":"Order No.","minLength":1},"claimNo":{"type":"string","description":"Claim No.","minLength":1},"ordMediaCd":{"type":"string","description":"Order Channel Code (OM007)","minLength":1}},"required":["claimNo","ordMediaCd","ordNo"]},"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/withdrawMgmt/returnTrnsformProcess":{"post":{"tags":["Collection Processing"],"summary":"Return Processing During Exchange","description":"## Function Description\n* Processes conversion to return.\n---\n## Detailed Description\n* Conversion to return during exchange is processed when the Convert to Return button is clicked on the BO Retrieval Complete Processing screen.\n* This is processed by calling the Convert to Return API in API-ORDER.\n* Order No., Claim No., and Order Channel Code are required.\n","operationId":"returnTrnsformProcess","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReturnTrnsformRequest"}}},"required":true},"responses":{"200":{"description":"Return Processing During Exchange Successful"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Process Return Not Possible

> \## Function Description\
> \* Processes Return Not Possible.\
> \---\
> \## Detailed Description\
> \* Return Not Possible is processed when the Return Not Possible button is clicked on the BO Retrieval Complete Processing screen.\
> \* This is processed by calling the Return Not Possible API in API-ORDER.<br>

```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":{"NoAllowedReturnRequest":{"type":"object","description":"Return Not Possible Request DTO","properties":{"ordNo":{"type":"string","description":"Order No.","minLength":1},"claimNo":{"type":"string","description":"Claim No.","minLength":1},"ordMediaCd":{"type":"string","description":"Order Channel Code (OM007)","minLength":1},"wthdFnshWaitProcCaus":{"type":"string","description":"Return Not Possible Reason"}},"required":["claimNo","ordMediaCd","ordNo"]},"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/withdrawMgmt/noAllowedReturnProcess":{"post":{"tags":["Collection Processing"],"summary":"Process Return Not Possible","description":"## Function Description\n* Processes Return Not Possible.\n---\n## Detailed Description\n* Return Not Possible is processed when the Return Not Possible button is clicked on the BO Retrieval Complete Processing screen.\n* This is processed by calling the Return Not Possible API in API-ORDER.\n","operationId":"noAllowedReturnProcess","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoAllowedReturnRequest"}}},"required":true},"responses":{"200":{"description":"Return Not Possible Processing Successful"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Retrieval Information

> &#x20; \## Function Description\
> &#x20; \* Retrieves retrieval data.\
> &#x20; \---\
> &#x20; \## Detailed Content\
> &#x20; \* Retrieves the list shown on the Retrieval Instruction Processing, Retrieval Confirmation Processing, and Retrieval Complete Processing screens.\
> &#x20; \* Inquiry Period Type, Inquiry Start Date, Inquiry End Date, and Delivery Type are required.\
> &#x20; \* The Retrieval Instruction Processing screen retrieves the order list in Accepted status, and the Retrieval Confirmation Processing screen retrieves the order list in Retrieval Instructed status.\
> &#x20; \---\
> &#x20; \## Revision History\
> &#x20; \* Release v2.00\_240729 : Added Retrieval Status (wthdYn), Delivery Processing Type Code Name (deliProcTypCdNm), Non-Retrievable Order Status (isAllNonReturnable)\
> &#x20; \* Release v2.01\_240910 : Added retrieval of Delivery Type Code Name (deliTypCdNm), Order History Status Code Name (ordDtlStatCdNm), and Courier Name (hdcCdNm)<br>

```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":{"WithdrawSearchRequest":{"type":"object","description":"Retrieval Information Inquiry Request DTO","properties":{"searchDateType":{"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"},"searchOrdDeliType":{"type":"string","description":"Delivery Information"},"deliveryType":{"type":"string","description":"Delivery Information Type"},"deliTypCd":{"type":"string","description":"Delivery Type (LO002)"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type (PR008)"},"searchOrdManType":{"type":"string","description":"Orderer Information Type"},"ordManVal":{"type":"string","description":"Orderer Information"},"deliKindCd":{"type":"string","description":"Delivery Type Code (LO009)"},"entrNo":{"type":"string","description":"Vendor No."},"hdcCd":{"type":"string","description":"Courier Code"},"ordDtlStatCd":{"type":"string","description":"Order Detail Status (OM005)"},"ordDtlStatCdInput":{"type":"string","description":"Order Detail Status for Pickup Confirmation Screen (OM005)"},"targetOrdDtlStatCd":{"type":"string","description":"Order Detail Status for Pickup Confirmation Screen (OM005)"},"wthdYn":{"type":"string","description":"Collection Required Status"}},"required":["deliKindCd","deliProcTypCd","entrNo","hdcCd","ordDtlStatCd","ordManVal","searchDateType","searchOrdManType"]},"RealGridListResponseWithdrawSearchResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/WithdrawSearchResponse"}}}},"WithdrawSearchResponse":{"type":"object","description":"Retrieval Information Inquiry Response DTO","properties":{"ordNo":{"type":"string","description":"Order No."},"ordMediaCd":{"type":"string","description":"Order Channel Code (OM007)"},"deliNo":{"type":"string","description":"Delivery No."},"rtnAccpDtm":{"type":"string","format":"date-time","description":"Return Reception Date/Time"},"ordFnshDtm":{"type":"string","format":"date-time","description":"Order Completion Date/Time"},"deliTypCd":{"type":"string","description":"Delivery Type Code (LO002)"},"deliTypCdNm":{"type":"string","description":"Delivery Type Code Name"},"ordDtlGbCd":{"type":"string","description":"Order Detail Classification Code (OM003)"},"ordDtlStatCd":{"type":"string","description":"Order Detail Status Code (OM005)"},"ordDtlStatCdNm":{"type":"string","description":"Order Detail Status Code Name"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Code Name"},"deliKindCd":{"type":"string","description":"Delivery Type Code (LO009)"},"ordSaleTypCd":{"type":"string","description":"Order Sales Type Code (OM004)"},"entrNm":{"type":"string","description":"Vendor Name"},"loginId":{"type":"string","description":"Login ID"},"ordManNm":{"type":"string","description":"Orderer Name"},"ordManCellSctNo":{"type":"string","description":"Orderer's Mobile Phone Prefix Code"},"ordManCellTxnoNo":{"type":"string","description":"Orderer's Mobile Phone Exchange Code"},"ordManCellEndNo":{"type":"string","description":"Orderer's Mobile Phone Last Digits"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"rcvmnCellSctNo":{"type":"string","description":"Recipient's Mobile Phone Prefix Code"},"rcvmnCellTxnoNo":{"type":"string","description":"Recipient's Mobile Phone Exchange Code"},"rcvmnCellEndNo":{"type":"string","description":"Recipient's Mobile Phone Last Digits"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"itmNm":{"type":"string","description":"Item Name"},"rtnQty":{"type":"integer","format":"int32","description":"Return Quantity"},"mbrNo":{"type":"string","description":"Member No."},"invNo":{"type":"string","description":"Invoice No."},"hdcCd":{"type":"string","description":"Courier Company Code"},"hdcCdNm":{"type":"string","description":"Courier Company Code Name"},"wthdFnshGbCd":{"type":"string","description":"Collection Completion Classification Code (LO011)"},"claimNo":{"type":"string","description":"Claim No."},"wthdYn":{"type":"string","description":"Collection Required Status"},"isAllNonReturnable":{"type":"string","description":"Retrieval Not Required Order Status"},"shipIndiDtm":{"type":"string","description":"Retrieval Instruction Date and Time"},"deliIndiDtm":{"type":"string","description":"Delivery/Retrieval Instruction Date and Time"},"shipCfmDtm":{"type":"string","format":"date-time","description":"Retrieval Confirmation Date and 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/withdrawMgmt/getWithdrawList":{"get":{"tags":["Collection Processing"],"summary":"Retrieve Retrieval Information","description":"  ## Function Description\n  * Retrieves retrieval data.\n  ---\n  ## Detailed Content\n  * Retrieves the list shown on the Retrieval Instruction Processing, Retrieval Confirmation Processing, and Retrieval Complete Processing screens.\n  * Inquiry Period Type, Inquiry Start Date, Inquiry End Date, and Delivery Type are required.\n  * The Retrieval Instruction Processing screen retrieves the order list in Accepted status, and the Retrieval Confirmation Processing screen retrieves the order list in Retrieval Instructed status.\n  ---\n  ## Revision History\n  * Release v2.00_240729 : Added Retrieval Status (wthdYn), Delivery Processing Type Code Name (deliProcTypCdNm), Non-Retrievable Order Status (isAllNonReturnable)\n  * Release v2.01_240910 : Added retrieval of Delivery Type Code Name (deliTypCdNm), Order History Status Code Name (ordDtlStatCdNm), and Courier Name (hdcCdNm)\n","operationId":"withdrawList","parameters":[{"name":"withdrawSearchRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/WithdrawSearchRequest"}},{"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":"searchOrdDeliType","in":"query","description":"Delivery Information","schema":{"type":"String"}},{"name":"deliveryType","in":"query","description":"Delivery Information Type","schema":{"type":"String"}},{"name":"deliTypCd","in":"query","description":"Delivery Type","required":true,"schema":{"type":"String"}},{"name":"deliTypCdNm","in":"query","description":"Delivery Type Code Name","required":true,"schema":{"type":"String"}},{"name":"deliProcTypCd","in":"query","description":"Delivery Processing Type","schema":{"type":"String"}},{"name":"searchOrdManType","in":"query","description":"Orderer Information Type","schema":{"type":"String"}},{"name":"ordManVal","in":"query","description":"Orderer Information","schema":{"type":"String"}},{"name":"deliKindCd","in":"query","description":"Delivery Type Code","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"Vendor Information","schema":{"type":"String"}},{"name":"ordDtlStatCd","in":"query","description":"Order History Status","schema":{"type":"String"}},{"name":"ordDtlStatCdNm","in":"query","description":"Order Detail Status Code Name","schema":{"type":"String"}},{"name":"ordDtlStatCdInput","in":"query","description":"Order History Status on Retrieval Confirmation Screen (Retrieval Instructed)","schema":{"type":"String"}},{"name":"targetOrdDtlStatCd","in":"query","description":"Order History Status on Retrieval Confirmation Screen (Retrieval Confirmed)","schema":{"type":"String"}},{"name":"wthdYn","in":"query","description":"Collection Required Status","schema":{"type":"String"}}],"responses":{"200":{"description":"Retrieval Inquiry Successful","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseWithdrawSearchResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Retrieval Detail Popup

> \## Function Description\
> \* Retrieves retrieval detail popup information.\
> \---\
> \## Detailed Description\
> \* Retrieves orderer information and return detail information using the delivery number.\
> \* If the inflow channel is PO, only the corresponding vendor's data is retrieved.\
> \* Personal information in the response is masked.\
> \---\
> \## Revision History\
> \* Release v2.00\_241122 : Added retrieval of Retrieval Required Status (wthdYn), and Order No. (ordNo), Order Sequence (ordSeq), and Order Processing Sequence (ordProcSeq) for calling the return/exchange reason popup\
> \* Release v2.00\_2508829 : Added masking processing based on authorization status<br>

```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":{"WithdrawDetailRequest":{"type":"object","description":"Retrieval Detail Inquiry Request DTO","properties":{"deliNo":{"type":"string","description":"Delivery No.","minLength":1}},"required":["deliNo"]},"WithdrawDetailResponse":{"type":"object","description":"Retrieval Detail Response DTO","properties":{"withdrawDeliNo":{"type":"string","description":"Collection Delivery No."},"rtnAccpDtm":{"type":"string","format":"date-time","description":"Return Reception Date/Time"},"ordNo":{"type":"string","description":"Order No."},"ordSeq":{"type":"integer","format":"int32","description":"Order Sequence No."},"ordProcSeq":{"type":"integer","format":"int32","description":"Order Processing Sequence No."},"ordFnshDtm":{"type":"string","format":"date-time","description":"Order Completion Date/Time"},"deliTypCd":{"type":"string","description":"Delivery Type Code Name (LO002)"},"deliTypCdNm":{"type":"string","description":"Delivery Type Code Name (LO002)"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Code Name"},"ordManNm":{"type":"string","description":"Orderer Name"},"ordManCellSctNo":{"type":"string","description":"Orderer's Mobile Phone Prefix Code"},"ordManCellTxnoNo":{"type":"string","description":"Orderer's Mobile Phone Exchange Code"},"ordManCellEndNo":{"type":"string","description":"Orderer's Mobile Phone Last Digits"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"rcvmnCellSctNo":{"type":"string","description":"Recipient's Mobile Phone Prefix Code"},"rcvmnCellTxnoNo":{"type":"string","description":"Recipient's Mobile Phone Exchange Code"},"rcvmnCellEndNo":{"type":"string","description":"Recipient's Mobile Phone Last Digits"},"zipAddr":{"type":"string","description":"Basic Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"wthdYn":{"type":"string","description":"Collection Required Status"},"withdrawDetailGoodsInfoList":{"type":"array","description":"Retrieval Product Information List","items":{"$ref":"#/components/schemas/WithdrawDetailGoodsInfo"}}}},"WithdrawDetailGoodsInfo":{"type":"object","description":"Retrieval Detail Product List Response DTO","properties":{"ordNo":{"type":"string","description":"Order No."},"ordSeq":{"type":"integer","format":"int32","description":"Order Sequence No."},"ordProcSeq":{"type":"integer","format":"int32","description":"Order Processing Sequence No."},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"itmNm":{"type":"string","description":"Item Name"},"puTypCd":{"type":"string","description":"Pickup Type Code Name (LO006)"},"ordDtlStatCd":{"type":"string","description":"Order Detail Status Code (OM005)"},"ordDtlStatCdNm":{"type":"string","description":"Order History Status Code Name (OM005)"},"hdcCd":{"type":"string","description":"Courier Code Name (LO005)"},"invNo":{"type":"string","description":"Invoice No."},"claimCause":{"type":"string","description":"Claim Medium Category Code Name (OM006)"},"claimDtlCause":{"type":"string","description":"Other Claim Reason Details"},"wthdFnshGbCd":{"type":"string","description":"Retrieval Completion Type Code Name (LO011)"}}},"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/withdrawMgmt/getWithdrawDetail":{"get":{"tags":["Collection Processing"],"summary":"Retrieve Retrieval Detail Popup","description":"## Function Description\n* Retrieves retrieval detail popup information.\n---\n## Detailed Description\n* Retrieves orderer information and return detail information using the delivery number.\n* If the inflow channel is PO, only the corresponding vendor's data is retrieved.\n* Personal information in the response is masked.\n---\n## Revision History\n* Release v2.00_241122 : Added retrieval of Retrieval Required Status (wthdYn), and Order No. (ordNo), Order Sequence (ordSeq), and Order Processing Sequence (ordProcSeq) for calling the return/exchange reason popup\n* Release v2.00_2508829 : Added masking processing based on authorization status\n","operationId":"getWithdrawDetail","parameters":[{"name":"withdrawDetailRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/WithdrawDetailRequest"}},{"name":"deliNo","in":"query","description":"Delivery No.","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"Retrieval Detail Popup Inquiry Successful","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WithdrawDetailResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```