> 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-24.md). # 주문변경 ## 주문배송지 통관고유부호 변경 (FO) > \## 기능 설명\ > \* \[FO전용] 주문배송지 통관고유부호를 변경합니다.\ > \---\ > \## 상세 설명\ > \* 주문번호, 배송지순번 기준으로 주문배송지 통관고유번호를 업데이트합니다.
```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/claim/orderChange/ordDlvpPcccChangeFo":{"post":{"tags":["주문변경"],"summary":"주문배송지 통관고유부호 변경 (FO)","description":" ## 기능 설명\n * [FO전용] 주문배송지 통관고유부호를 변경합니다.\n ---\n ## 상세 설명\n * 주문번호, 배송지순번 기준으로 주문배송지 통관고유번호를 업데이트합니다.\n","operationId":"ordDlvpPcccChangeFo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PcccChangeRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PcccChangeRequest":{"required":["dlvpSeq","ordNo","persCstmCd"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"dlvpSeq":{"type":"string","description":"배송지순번"},"persCstmCd":{"type":"string","description":"통관고유번호"}},"description":"주문배송지 통관고유부호 변경 Request"},"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전용] 주문 배송지를 변경합니다.\ > \---\ > \## 상세 설명\ > \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.\ > \* 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.\ > \* 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.\ > \---\ > \## 특이사항\ > \* ST008 cd 92번(배송지변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v1.05\_231204\`\`\` : Request DTO 변경전배송지순번(orginDlvpSeq) 추가, 변경전배송지순번 값이 있는 경우 주문번호, 변경전배송지순번 기준 배송순번 일괄 업데이트 진행\ > \* \`\`\`Release v2.00\_240711\`\`\` : 추가배송비 금액이 동일한 배송지역그룹으로 배송지 변경 가능하도록 수정
````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/claim/orderChange/ordDlvChange":{"post":{"tags":["주문변경"],"summary":"주문 배송지 수정 (BO)","description":" ## 기능 설명\n * [BO전용] 주문 배송지를 변경합니다.\n ---\n ## 상세 설명\n * 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.\n * 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.\n * 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.\n ---\n ## 특이사항\n * ST008 cd 92번(배송지변경)의 ref_1_val(OM005), ref_2_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\n ---\n ## 수정번호\n * ```Release v1.05_231204``` : Request DTO 변경전배송지순번(orginDlvpSeq) 추가, 변경전배송지순번 값이 있는 경우 주문번호, 변경전배송지순번 기준 배송순번 일괄 업데이트 진행\n * ```Release v2.00_240711``` : 추가배송비 금액이 동일한 배송지역그룹으로 배송지 변경 가능하도록 수정\n","operationId":"ordDlvChange","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryInfoChangeRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"DeliveryInfoChangeRequest":{"required":["deliNo","deliPolcNo","dlvpNm","ordNo","rcvmnCellEndNo","rcvmnCellSctNo","rcvmnCellTxnoNo","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"clmNo":{"type":"string","description":"클레임번호"},"systemType":{"type":"string","description":" SYSTEM(시스템유형)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]},"mbrNo":{"type":"string","description":"회원번호"},"deliNo":{"type":"string","description":"배송번호"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNoSeq":{"type":"integer","description":"우편번호순번","format":"int32"},"zipNo":{"type":"string","description":"변경후우편번호"},"originZipNo":{"type":"string","description":"변경전우편번호"},"orginDlvpSeq":{"type":"string","description":"변경전배송지순번"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 10:배송메시지 입력 안함, 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40: 부재 시 경비실에 맡겨주세요, 50: 빠른 배송 부탁 드립니다, 60: 부재 시 핸드폰으로 연락 바랍니다, 70: 직접입력"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10: 공동현관 출입번호, 20: 자유 출입 가능, 30: 기타"},"deliGbCd":{"type":"string","description":" LO001(배송구분코드)\n * 10 : 출하\n * 20 : 회수\n","enum":["SHIPPING","WITHDRAWAL"]},"dlvpSeq":{"type":"string","description":"배송순번"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"}},"description":"주문 배송지 변경/등록 DTO"},"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"}}}} ```` ## 주문 배송지 수정 (FO) > \## 기능 설명\ > \* \[FO전용] 주문 배송지를 변경합니다.\ > \---\ > \## 상세 설명\ > \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.\ > \* 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.\ > \* 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.\ > \---\ > \## 특이사항\ > \* ST007 cd 92번(배송지변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v1.05\_231204\`\`\` : Request DTO 변경전배송지순번(orginDlvpSeq) 추가, 변경전배송지순번 값이 있는 경우 주문번호, 변경전배송지순번 기준 배송순번 일괄 업데이트 진행\ > \* \`\`\`Release v2.00\_240711\`\`\` : 추가배송비 금액이 동일한 배송지역그룹으로 배송지 변경 가능하도록 수정
````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/claim/orderChange/ordDlvChangeFO":{"post":{"tags":["주문변경"],"summary":"주문 배송지 수정 (FO)","description":" ## 기능 설명\n * [FO전용] 주문 배송지를 변경합니다.\n ---\n ## 상세 설명\n * 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.\n * 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.\n * 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.\n ---\n ## 특이사항\n * ST007 cd 92번(배송지변경)의 ref_1_val(OM005), ref_2_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\n ---\n ## 수정번호\n * ```Release v1.05_231204``` : Request DTO 변경전배송지순번(orginDlvpSeq) 추가, 변경전배송지순번 값이 있는 경우 주문번호, 변경전배송지순번 기준 배송순번 일괄 업데이트 진행\n * ```Release v2.00_240711``` : 추가배송비 금액이 동일한 배송지역그룹으로 배송지 변경 가능하도록 수정\n","operationId":"ordDlvChangeFO","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryInfoChangeRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"DeliveryInfoChangeRequest":{"required":["deliNo","deliPolcNo","dlvpNm","ordNo","rcvmnCellEndNo","rcvmnCellSctNo","rcvmnCellTxnoNo","rcvmnNm","zipAddr","zipNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"clmNo":{"type":"string","description":"클레임번호"},"systemType":{"type":"string","description":" SYSTEM(시스템유형)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]},"mbrNo":{"type":"string","description":"회원번호"},"deliNo":{"type":"string","description":"배송번호"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"zipNoSeq":{"type":"integer","description":"우편번호순번","format":"int32"},"zipNo":{"type":"string","description":"변경후우편번호"},"originZipNo":{"type":"string","description":"변경전우편번호"},"orginDlvpSeq":{"type":"string","description":"변경전배송지순번"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rcvmnCellSctNo":{"type":"string","description":"수취인휴대폰구분번호"},"rcvmnCellTxnoNo":{"type":"string","description":"수취인휴대폰국번번호"},"rcvmnCellEndNo":{"type":"string","description":"수취인휴대폰끝번호"},"deliMsg":{"type":"string","description":"배송메시지"},"deliMsgCd":{"type":"string","description":"배송메시지코드(ME039) 10:배송메시지 입력 안함, 20:배송 전 연락 바랍니다, 30:부재 시 문 앞에 놓아주세요, 40: 부재 시 경비실에 맡겨주세요, 50: 빠른 배송 부탁 드립니다, 60: 부재 시 핸드폰으로 연락 바랍니다, 70: 직접입력"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040) 10: 공동현관 출입번호, 20: 자유 출입 가능, 30: 기타"},"deliGbCd":{"type":"string","description":" LO001(배송구분코드)\n * 10 : 출하\n * 20 : 회수\n","enum":["SHIPPING","WITHDRAWAL"]},"dlvpSeq":{"type":"string","description":"배송순번"},"rcvmnEmailAddr":{"type":"string","description":"수취인이메일"},"rcvmnTelRgnNo":{"type":"string","description":"수취인전화지역번호"},"rcvmnTelTxnoNo":{"type":"string","description":"수취인전화국번번호"},"rcvmnTelEndNo":{"type":"string","description":"수취인전화끝번호"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"}},"description":"주문 배송지 변경/등록 DTO"},"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전용] 주문 옵션을 변경합니다.\ > \---\ > \## 상세 설명\ > \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.\ > \* 다건의 옵션 변경이 가능합니다.\ > \* 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.\ > \* 동일단품, 예약상품의 단품은 변경 불가능합니다.\ > \---\ > \## 특이사항\ > \* ST008 cd 91번(옵션변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v2.00\_241202\`\`\`: 주문 변경 상품 필터링 수정 (다중배송 주문 변경 (BO) > 동일 상품, 단품 변경 케이스)
````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/claim/orderChange/ordChange":{"post":{"tags":["주문변경"],"summary":"주문 상품 옵션변경 (BO)","description":" ## 기능 설명\n * [BO전용] 주문 옵션을 변경합니다.\n ---\n ## 상세 설명\n * 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.\n * 다건의 옵션 변경이 가능합니다.\n * 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.\n * 동일단품, 예약상품의 단품은 변경 불가능합니다.\n ---\n ## 특이사항\n * ST008 cd 91번(옵션변경)의 ref_1_val(OM005), ref_2_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\n ---\n ## 수정번호\n * ```Release v2.00_241202```: 주문 변경 상품 필터링 수정 (다중배송 주문 변경 (BO) > 동일 상품, 단품 변경 케이스)\n","operationId":"ordChange","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrdGoodsInfoRequest"}}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrdGoodsInfoRequest":{"required":["chngItmNo","goodsNo","itmNo","ordNo","ordProcSeq","ordSeq"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"chngItmNo":{"type":"string","description":"변경단품번호"},"ordQty":{"type":"integer","description":"수량","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"goodsNm":{"type":"string","description":"상품명"},"systemType":{"type":"string","description":" SYSTEM(시스템유형)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]}},"description":"주문 옵션 변경 DTO"},"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"}}}} ```` ## 주문 상품 옵션변경 (FO) > \## 기능 설명\ > \* \[FO전용] 주문 옵션을 변경합니다.\ > \---\ > \## 상세 설명\ > \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.\ > \* 단건의 옵션 변경만 가능합니다.\ > \* 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.\ > \* 동일단품, 예약상품의 단품은 변경 불가능합니다.\ > \---\ > \## 특이사항\ > \* ST007 cd 91번(옵션변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\ > \---\ > \## 수정번호\ > \* \`\`\`Release v2.00\_241202\`\`\`: 주문 변경 상품 필터링 수정 (다중배송 주문 변경 (BO) > 동일 상품, 단품 변경 케이스)
````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/claim/orderChange/ordChangeFO":{"post":{"tags":["주문변경"],"summary":"주문 상품 옵션변경 (FO)","description":" ## 기능 설명\n * [FO전용] 주문 옵션을 변경합니다.\n ---\n ## 상세 설명\n * 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.\n * 단건의 옵션 변경만 가능합니다.\n * 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.\n * 동일단품, 예약상품의 단품은 변경 불가능합니다.\n ---\n ## 특이사항\n * ST007 cd 91번(옵션변경)의 ref_1_val(OM005), ref_2_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\n ---\n ## 수정번호\n * ```Release v2.00_241202```: 주문 변경 상품 필터링 수정 (다중배송 주문 변경 (BO) > 동일 상품, 단품 변경 케이스)\n","operationId":"ordChangeFO","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdGoodsInfoRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrdGoodsInfoRequest":{"required":["chngItmNo","goodsNo","itmNo","ordNo","ordProcSeq","ordSeq"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"chngItmNo":{"type":"string","description":"변경단품번호"},"ordQty":{"type":"integer","description":"수량","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"goodsNm":{"type":"string","description":"상품명"},"systemType":{"type":"string","description":" SYSTEM(시스템유형)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]}},"description":"주문 옵션 변경 DTO"},"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"}}}} ````