> 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/order-change.md). # Order Change ## Change Order Delivery Address Customs ID Code (FO) > \## Function Description\ > \* \[FO only] Changes the customs ID code of the order delivery address.\ > \---\ > \## Detailed Description\ > \* Updates the order delivery address customs ID number based on the order number and delivery address sequence No.
```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":["Order Change"],"summary":"Change Order Delivery Address Customs ID Code (FO)","description":" ## Function Description\n * [FO only] Changes the customs ID code of the order delivery address.\n ---\n ## Detailed Description\n * Updates the order delivery address customs ID number based on the order number and delivery address sequence No.\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":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PcccChangeRequest":{"required":["dlvpSeq","ordNo","persCstmCd"],"type":"object","properties":{"ordNo":{"type":"string","description":"Order No."},"dlvpSeq":{"type":"string","description":"Delivery Address Sequence No."},"persCstmCd":{"type":"string","description":"Personal Customs Clearance Code"}},"description":"Change Order Delivery Address Customs ID Code 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"}}}} ``` ## Modify Order Delivery Address (BO) > \## Function Description\ > \* \[BO only] Changes the order delivery address.\ > \---\ > \## Detailed Description\ > \* The delivery address can be changed when the order history type code (OM003) is Order Completed (11).\ > \* Updates all delivery sequence numbers for the corresponding order number, regardless of the delivery number.\ > \* The delivery address can only be changed between remote (island/mountain) areas that incur additional shipping fees, or between general areas.\ > \---\ > \## Special Notes\ > \* The status values that allow the delivery address to be changed may vary depending on the ref\_1\_val (OM005) and ref\_2\_val (OM003) values of ST008 cd 92 (Change Delivery Address).\ > \---\ > \## Revision History\ > \* \`\`\`Release v1.05\_231204\`\`\` : Added original delivery address sequence No. (orginDlvpSeq) to the request DTO; when an original delivery address sequence value is present, batch-updates the delivery sequence based on the order number and original delivery address sequence\ > \* \`\`\`Release v2.00\_240711\`\`\` : Modified so the delivery address can be changed within the same delivery region group with the same additional shipping fee amount
````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":["Order Change"],"summary":"Modify Order Delivery Address (BO)","description":" ## Function Description\n * [BO only] Changes the order delivery address.\n ---\n ## Detailed Description\n * The delivery address can be changed when the order history type code (OM003) is Order Completed (11).\n * Updates all delivery sequence numbers for the corresponding order number, regardless of the delivery number.\n * The delivery address can only be changed between remote (island/mountain) areas that incur additional shipping fees, or between general areas.\n ---\n ## Special Notes\n * The status values that allow the delivery address to be changed may vary depending on the ref_1_val (OM005) and ref_2_val (OM003) values of ST008 cd 92 (Change Delivery Address).\n ---\n ## Revision History\n * ```Release v1.05_231204``` : Added original delivery address sequence No. (orginDlvpSeq) to the request DTO; when an original delivery address sequence value is present, batch-updates the delivery sequence based on the order number and original delivery address sequence\n * ```Release v2.00_240711``` : Modified so the delivery address can be changed within the same delivery region group with the same additional shipping fee amount\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":"Success"},"900":{"description":"Business processing error details","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":"Order No."},"clmNo":{"type":"string","description":"Claim No."},"systemType":{"type":"string","description":" SYSTEM (System Type)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]},"mbrNo":{"type":"string","description":"Member No."},"deliNo":{"type":"string","description":"Delivery No."},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"dlvpNm":{"type":"string","description":"Delivery Address Name"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"zipNoSeq":{"type":"integer","description":"Postal Code Sequence No.","format":"int32"},"zipNo":{"type":"string","description":"New Postal Code"},"originZipNo":{"type":"string","description":"Previous Postal Code"},"orginDlvpSeq":{"type":"string","description":"Delivery Address Sequence No. Before Change"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"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"},"deliMsg":{"type":"string","description":"Delivery Message"},"deliMsgCd":{"type":"string","description":"Delivery Message Code (ME039) 10: No delivery message, 20: Please call before delivery, 30: Leave at the door if absent, 40: Leave with security desk if absent, 50: Please deliver quickly, 60: Please call my mobile if absent, 70: Enter manually"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code (ME040) 10: Entrance access code, 20: Free access, 30: Other"},"deliGbCd":{"type":"string","description":" LO001(Delivery Type Code)\n * 10 : Shipment\n * 20 : Return\n","enum":["SHIPPING","WITHDRAWAL"]},"dlvpSeq":{"type":"string","description":"Delivery Sequence No."},"rcvmnEmailAddr":{"type":"string","description":"Recipient Email"},"rcvmnTelRgnNo":{"type":"string","description":"Recipient's Phone Area Code"},"rcvmnTelTxnoNo":{"type":"string","description":"Recipient's Phone Exchange Code"},"rcvmnTelEndNo":{"type":"string","description":"Recipient's Phone Last Digits"},"frgnDirPurGoodsYn":{"type":"string","description":"Overseas Direct Purchase Product Status"}},"description":"Order Delivery Address Change/Registration 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"}}}} ```` ## Modify Order Delivery Address (FO) > \## Function Description\ > \* \[FO only] Changes the order delivery address.\ > \---\ > \## Detailed Description\ > \* The delivery address can be changed when the order history type code (OM003) is Order Completed (11).\ > \* Updates all delivery sequence numbers for the corresponding order number, regardless of the delivery number.\ > \* The delivery address can only be changed between remote (island/mountain) areas that incur additional shipping fees, or between general areas.\ > \---\ > \## Special Notes\ > \* The status values that allow the delivery address to be changed may vary depending on the ref\_1\_val (OM005) and ref\_2\_val (OM003) values of ST007 cd 92 (Change Delivery Address).\ > \---\ > \## Revision History\ > \* \`\`\`Release v1.05\_231204\`\`\` : Added original delivery address sequence No. (orginDlvpSeq) to the request DTO; when an original delivery address sequence value is present, batch-updates the delivery sequence based on the order number and original delivery address sequence\ > \* \`\`\`Release v2.00\_240711\`\`\` : Modified so the delivery address can be changed within the same delivery region group with the same additional shipping fee amount
````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":["Order Change"],"summary":"Modify Order Delivery Address (FO)","description":" ## Function Description\n * [FO only] Changes the order delivery address.\n ---\n ## Detailed Description\n * The delivery address can be changed when the order history type code (OM003) is Order Completed (11).\n * Updates all delivery sequence numbers for the corresponding order number, regardless of the delivery number.\n * The delivery address can only be changed between remote (island/mountain) areas that incur additional shipping fees, or between general areas.\n ---\n ## Special Notes\n * The status values that allow the delivery address to be changed may vary depending on the ref_1_val (OM005) and ref_2_val (OM003) values of ST007 cd 92 (Change Delivery Address).\n ---\n ## Revision History\n * ```Release v1.05_231204``` : Added original delivery address sequence No. (orginDlvpSeq) to the request DTO; when an original delivery address sequence value is present, batch-updates the delivery sequence based on the order number and original delivery address sequence\n * ```Release v2.00_240711``` : Modified so the delivery address can be changed within the same delivery region group with the same additional shipping fee amount\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":"Success"},"900":{"description":"Business processing error details","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":"Order No."},"clmNo":{"type":"string","description":"Claim No."},"systemType":{"type":"string","description":" SYSTEM (System Type)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]},"mbrNo":{"type":"string","description":"Member No."},"deliNo":{"type":"string","description":"Delivery No."},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"dlvpNm":{"type":"string","description":"Delivery Address Name"},"rcvmnNm":{"type":"string","description":"Recipient Name"},"zipNoSeq":{"type":"integer","description":"Postal Code Sequence No.","format":"int32"},"zipNo":{"type":"string","description":"New Postal Code"},"originZipNo":{"type":"string","description":"Previous Postal Code"},"orginDlvpSeq":{"type":"string","description":"Delivery Address Sequence No. Before Change"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"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"},"deliMsg":{"type":"string","description":"Delivery Message"},"deliMsgCd":{"type":"string","description":"Delivery Message Code (ME039) 10: No delivery message, 20: Please call before delivery, 30: Leave at the door if absent, 40: Leave with security desk if absent, 50: Please deliver quickly, 60: Please call my mobile if absent, 70: Enter manually"},"comnFrdrEtcMethod":{"type":"string","description":"Other Common Entrance Access Method"},"comnFrdrPwd":{"type":"string","description":"Common Entrance Password"},"comnFrdrCogoMethodCd":{"type":"string","description":"Common Entrance Access Method Code (ME040) 10: Entrance access code, 20: Free access, 30: Other"},"deliGbCd":{"type":"string","description":" LO001(Delivery Type Code)\n * 10 : Shipment\n * 20 : Return\n","enum":["SHIPPING","WITHDRAWAL"]},"dlvpSeq":{"type":"string","description":"Delivery Sequence No."},"rcvmnEmailAddr":{"type":"string","description":"Recipient Email"},"rcvmnTelRgnNo":{"type":"string","description":"Recipient's Phone Area Code"},"rcvmnTelTxnoNo":{"type":"string","description":"Recipient's Phone Exchange Code"},"rcvmnTelEndNo":{"type":"string","description":"Recipient's Phone Last Digits"},"frgnDirPurGoodsYn":{"type":"string","description":"Overseas Direct Purchase Product Status"}},"description":"Order Delivery Address Change/Registration 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"}}}} ```` ## Change Order Product Option (BO) > \## Function Description\ > \* \[BO only] Changes the order product option.\ > \---\ > \## Detailed Description\ > \* The option can be changed when the order history type code (OM003) is Order Completed (11).\ > \* Multiple options can be changed at once.\ > \* Can be changed to a color+size unit item that is on sale with the same price and has stock available.\ > \* Cannot be changed to the same unit item or a unit item of a reservation product.\ > \---\ > \## Special Notes\ > \* The status values that allow the delivery address to be changed may vary depending on the ref\_1\_val (OM005) and ref\_2\_val (OM003) values of ST008 cd 91 (Change Option).\ > \---\ > \## Revision History\ > \* \`\`\`Release v2.00\_241202\`\`\`: Fixed order change product filtering (Multi-delivery order change (BO) > case of changing the same product/unit item)
````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":["Order Change"],"summary":"Change Order Product Option (BO)","description":" ## Function Description\n * [BO only] Changes the order product option.\n ---\n ## Detailed Description\n * The option can be changed when the order history type code (OM003) is Order Completed (11).\n * Multiple options can be changed at once.\n * Can be changed to a color+size unit item that is on sale with the same price and has stock available.\n * Cannot be changed to the same unit item or a unit item of a reservation product.\n ---\n ## Special Notes\n * The status values that allow the delivery address to be changed may vary depending on the ref_1_val (OM005) and ref_2_val (OM003) values of ST008 cd 91 (Change Option).\n ---\n ## Revision History\n * ```Release v2.00_241202```: Fixed order change product filtering (Multi-delivery order change (BO) > case of changing the same product/unit item)\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":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrdGoodsInfoRequest":{"required":["chngItmNo","goodsNo","itmNo","ordNo","ordProcSeq","ordSeq"],"type":"object","properties":{"ordNo":{"type":"string","description":"Order No."},"ordSeq":{"type":"integer","description":"Order Sequence No.","format":"int32"},"ordProcSeq":{"type":"integer","description":"Order Processing Sequence No.","format":"int32"},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"chngItmNo":{"type":"string","description":"Changed SKU No."},"ordQty":{"type":"integer","description":"Quantity","format":"int32"},"salePrc":{"type":"integer","description":"Selling Price","format":"int64"},"goodsNm":{"type":"string","description":"Product Name"},"systemType":{"type":"string","description":" SYSTEM (System Type)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]}},"description":"Order Option Change 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"}}}} ```` ## Change Order Product Option (FO) > \## Function Description\ > \* \[FO only] Changes the order product option.\ > \---\ > \## Detailed Description\ > \* The option can be changed when the order history type code (OM003) is Order Completed (11).\ > \* Only a single option can be changed at a time.\ > \* Can be changed to a color+size unit item that is on sale with the same price and has stock available.\ > \* Cannot be changed to the same unit item or a unit item of a reservation product.\ > \---\ > \## Special Notes\ > \* The status values that allow the delivery address to be changed may vary depending on the ref\_1\_val (OM005) and ref\_2\_val (OM003) values of ST007 cd 91 (Change Option).\ > \---\ > \## Revision History\ > \* \`\`\`Release v2.00\_241202\`\`\`: Fixed order change product filtering (Multi-delivery order change (BO) > case of changing the same product/unit item)
````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":["Order Change"],"summary":"Change Order Product Option (FO)","description":" ## Function Description\n * [FO only] Changes the order product option.\n ---\n ## Detailed Description\n * The option can be changed when the order history type code (OM003) is Order Completed (11).\n * Only a single option can be changed at a time.\n * Can be changed to a color+size unit item that is on sale with the same price and has stock available.\n * Cannot be changed to the same unit item or a unit item of a reservation product.\n ---\n ## Special Notes\n * The status values that allow the delivery address to be changed may vary depending on the ref_1_val (OM005) and ref_2_val (OM003) values of ST007 cd 91 (Change Option).\n ---\n ## Revision History\n * ```Release v2.00_241202```: Fixed order change product filtering (Multi-delivery order change (BO) > case of changing the same product/unit item)\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":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrdGoodsInfoRequest":{"required":["chngItmNo","goodsNo","itmNo","ordNo","ordProcSeq","ordSeq"],"type":"object","properties":{"ordNo":{"type":"string","description":"Order No."},"ordSeq":{"type":"integer","description":"Order Sequence No.","format":"int32"},"ordProcSeq":{"type":"integer","description":"Order Processing Sequence No.","format":"int32"},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"chngItmNo":{"type":"string","description":"Changed SKU No."},"ordQty":{"type":"integer","description":"Quantity","format":"int32"},"salePrc":{"type":"integer","description":"Selling Price","format":"int64"},"goodsNm":{"type":"string","description":"Product Name"},"systemType":{"type":"string","description":" SYSTEM (System Type)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"]}},"description":"Order Option Change 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"}}}} ````