# 회수
## 회수 진행상태 수정(BO)
> \## 기능설명\
> \* \[BO] 회수 상태를 업데이트합니다.\
> \---\
> \## 상세설명\
> \* BO 회수확인 처리 화면 회수지시 처리 버튼 클릭, 회수완료 처리 화면 회수 완료 버튼 클릭시 회수 상태 업데이트를 진행합니다.\
> \* 현재 주문내역상태(OM005), 업데이트할 주문내역상태(OM005), 회수 진행상태 업데이트 대상 리스트는 필수값입니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240729 : 택배사코드(hdcCd), 송장번호(invNo) e-쿠폰배송인 경우, null 허용\
> 주문배송정보(OP\_ORD\_DELI\_INFO) 업데이트 시 배송번호 단위로 중복 제거 및 회수 여부가 'Y'인 데이터 우선 저장
```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":["회수"],"summary":"회수 진행상태 수정(BO)","description":"## 기능설명\n* [BO] 회수 상태를 업데이트합니다.\n---\n## 상세설명\n* BO 회수확인 처리 화면 회수지시 처리 버튼 클릭, 회수완료 처리 화면 회수 완료 버튼 클릭시 회수 상태 업데이트를 진행합니다.\n* 현재 주문내역상태(OM005), 업데이트할 주문내역상태(OM005), 회수 진행상태 업데이트 대상 리스트는 필수값입니다.\n---\n## 수정번호\n* Release v2.00_240729 : 택배사코드(hdcCd), 송장번호(invNo) e-쿠폰배송인 경우, null 허용\n\t\t\t\t\t\t 주문배송정보(OP_ORD_DELI_INFO) 업데이트 시 배송번호 단위로 중복 제거 및 회수 여부가 '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":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"WithdrawStatUpdateSaveRequest":{"required":["ordDtlStatCd","updateTargetOrdDtlStatCd","withdrawStatUpdateSaveInfoList"],"type":"object","properties":{"ordDtlStatCd":{"type":"string","description":"현재 주문진행상태"},"updateTargetOrdDtlStatCd":{"type":"string","description":"업데이트할 주문진행상태"},"withdrawStatUpdateSaveInfoList":{"type":"array","description":"회수 진행상태 업데이트 대상 리스트","items":{"$ref":"#/components/schemas/WithdrawStatUpdateSaveInfo"}}}},"WithdrawStatUpdateSaveInfo":{"required":["deliNo","hdcCd","invNo","ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"deliNo":{"type":"string","description":"배송번호"},"hdcCd":{"type":"string","description":"택배사코드"},"invNo":{"type":"string","description":"송장번호"},"wthdFnshGbCd":{"type":"string","description":"회수완료구분코드"},"wthdYn":{"type":"string","description":"회수여부"}},"description":"회수 진행상태 업데이트 대상 리스트"},"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"}}}}
```
## 회수지시(BO)
> \## 기능설명\
> \* \[BO] 회수 지시 처리를 진행합니다.\
> \---\
> \## 상세설명\
> \* BO 회수지시 처리 화면 회수지시 처리 버튼 클릭시 회수지시 처리를 진행합니다.\
> \* 회수지시대상목록은 필수값입니다.\
> \* 주문내역상태(OM005)가 반품접수(32)인 상태인 주문을 회수지시(34) 상태로 변경합니다.
```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":["회수"],"summary":"회수지시(BO)","description":"## 기능설명\n* [BO] 회수 지시 처리를 진행합니다.\n---\n## 상세설명\n* BO 회수지시 처리 화면 회수지시 처리 버튼 클릭시 회수지시 처리를 진행합니다.\n* 회수지시대상목록은 필수값입니다.\n* 주문내역상태(OM005)가 반품접수(32)인 상태인 주문을 회수지시(34) 상태로 변경합니다.\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":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"WithdrawInstructHandlingSaveRequest":{"type":"object","properties":{"withdrawInstructHandlingSaveInfoList":{"type":"array","description":"회수 지시 대상 리스트","items":{"$ref":"#/components/schemas/WithdrawInstructHandlingSaveInfo"}}}},"WithdrawInstructHandlingSaveInfo":{"required":["deliNo","ordNo","rtnQty"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"deliNo":{"type":"string","description":"배송번호"},"rtnQty":{"type":"integer","description":"반품수량","format":"int32"}},"description":"회수 지시 대상 리스트"},"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"}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/store-front-api/order-api/undefined-18.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.