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

# Collection

## Update Collection Progress Status (BO)

> \## Function Description\
> \* \[BO] Updates the collection status.\
> \---\
> \## Detailed Description\
> \* Updates the collection status when the collection-instruction-processing button is clicked on the BO collection confirmation processing screen, or the collection-completion button is clicked on the collection completion processing screen.\
> \* The current order history status (OM005), the order history status to update to (OM005), and the collection-progress-status update target list are required.\
> \---\
> \## Revision History\
> \* Release v2.00\_240729 : Allowed null for delivery company code (hdcCd) and tracking number (invNo) for e-coupon deliveries,\
> &#x9;					 updated order delivery information (OP\_ORD\_DELI\_INFO) with deduplication by delivery number and prioritized saving of data with collection status 'Y'<br>

```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/delivery/withdrawProcess/saveWithdrawStatUpdateProcess":{"post":{"tags":["Collection"],"summary":"Update Collection Progress Status (BO)","description":"## Function Description\n* [BO] Updates the collection status.\n---\n## Detailed Description\n* Updates the collection status when the collection-instruction-processing button is clicked on the BO collection confirmation processing screen, or the collection-completion button is clicked on the collection completion processing screen.\n* The current order history status (OM005), the order history status to update to (OM005), and the collection-progress-status update target list are required.\n---\n## Revision History\n* Release v2.00_240729 : Allowed null for delivery company code (hdcCd) and tracking number (invNo) for e-coupon deliveries,\n\t\t\t\t\t\t updated order delivery information (OP_ORD_DELI_INFO) with deduplication by delivery number and prioritized saving of data with collection status 'Y'\n","operationId":"saveWithdrawStatUpdateProcess","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawStatUpdateSaveRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"WithdrawStatUpdateSaveRequest":{"required":["ordDtlStatCd","updateTargetOrdDtlStatCd","withdrawStatUpdateSaveInfoList"],"type":"object","properties":{"ordDtlStatCd":{"type":"string","description":"Current Order Progress Status"},"updateTargetOrdDtlStatCd":{"type":"string","description":"Order Progress Status to Update"},"withdrawStatUpdateSaveInfoList":{"type":"array","description":"Collection Progress Status Update Target List","items":{"$ref":"#/components/schemas/WithdrawStatUpdateSaveInfo"}}}},"WithdrawStatUpdateSaveInfo":{"required":["deliNo","hdcCd","invNo","ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"Order No."},"deliNo":{"type":"string","description":"Delivery No."},"hdcCd":{"type":"string","description":"Courier Company Code"},"invNo":{"type":"string","description":"Invoice No."},"wthdFnshGbCd":{"type":"string","description":"Collection Completion Classification Code"},"wthdYn":{"type":"string","description":"Collection Status"}},"description":"Collection Progress Status Update Target List"},"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"}}}}
```

## Collection Instruction (BO)

> \## Function Description\
> \* \[BO] Processes collection instructions.\
> \---\
> \## Detailed Description\
> \* Processes collection instructions when the collection-instruction-processing button is clicked on the BO collection instruction processing screen.\
> \* The collection-instruction target list is required.\
> \* Changes orders in order history status (OM005) return-received (32) to collection-instructed (34) status.<br>

```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/delivery/withdrawProcess/saveWithdrawInstructProcess":{"post":{"tags":["Collection"],"summary":"Collection Instruction (BO)","description":"## Function Description\n* [BO] Processes collection instructions.\n---\n## Detailed Description\n* Processes collection instructions when the collection-instruction-processing button is clicked on the BO collection instruction processing screen.\n* The collection-instruction target list is required.\n* Changes orders in order history status (OM005) return-received (32) to collection-instructed (34) status.\n","operationId":"saveWithdrawInstructProcess","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawInstructHandlingSaveRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"WithdrawInstructHandlingSaveRequest":{"type":"object","properties":{"withdrawInstructHandlingSaveInfoList":{"type":"array","description":"Collection Instruction Target List","items":{"$ref":"#/components/schemas/WithdrawInstructHandlingSaveInfo"}}}},"WithdrawInstructHandlingSaveInfo":{"required":["deliNo","ordNo","rtnQty"],"type":"object","properties":{"ordNo":{"type":"string","description":"Order No."},"deliNo":{"type":"string","description":"Delivery No."},"rtnQty":{"type":"integer","description":"Return Quantity","format":"int32"}},"description":"Collection Instruction Target List"},"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"}}}}
```