> 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/store-front-api/order-api/undefined-17.md).

# 회수

## 회수 진행상태 수정(BO)

> \## 기능설명\
> \* \[BO] 회수 상태를 업데이트합니다.\
> \---\
> \## 상세설명\
> \* BO 회수확인 처리 화면 회수지시 처리 버튼 클릭, 회수완료 처리 화면 회수 완료 버튼 클릭시 회수 상태 업데이트를 진행합니다.\
> \* 현재 주문내역상태(OM005), 업데이트할 주문내역상태(OM005), 회수 진행상태 업데이트 대상 리스트는 필수값입니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240729 : 택배사코드(hdcCd), 송장번호(invNo) e-쿠폰배송인 경우, null 허용\
> &#x9;					 주문배송정보(OP\_ORD\_DELI\_INFO) 업데이트 시 배송번호 단위로 중복 제거 및 회수 여부가 '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":["회수"],"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) 상태로 변경합니다.<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":["회수"],"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"}}}}
```