# 주문변경

## 주문배송지 통관고유부호 변경 (FO)

> &#x20; \## 기능 설명\
> &#x20; \* \[FO전용] 주문배송지 통관고유부호를 변경합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문번호, 배송지순번 기준으로 주문배송지 통관고유번호를 업데이트합니다.<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/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)

> &#x20; \## 기능 설명\
> &#x20; \* \[BO전용] 주문 배송지를 변경합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.\
> &#x20; \* 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.\
> &#x20; \* 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.\
> &#x20; \---\
> &#x20; \## 특이사항\
> &#x20; \* ST008 cd 92번(배송지변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* \`\`\`Release v1.05\_231204\`\`\` : Request DTO 변경전배송지순번(orginDlvpSeq) 추가, 변경전배송지순번 값이 있는 경우 주문번호, 변경전배송지순번 기준 배송순번 일괄 업데이트 진행\
> &#x20; \* \`\`\`Release v2.00\_240711\`\`\` : 추가배송비 금액이 동일한 배송지역그룹으로 배송지 변경 가능하도록 수정<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/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)

> &#x20; \## 기능 설명\
> &#x20; \* \[FO전용] 주문 배송지를 변경합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 배송지 변경 가능합니다.\
> &#x20; \* 배송번호와 관계없이 해당하는 주문번호의 모든 배송 순번을 업데이트합니다.\
> &#x20; \* 추가배송비가 발생한 도서산간 지역간의 배송지 변경, 일반지역간의 배송지 변경만 가능합니다.\
> &#x20; \---\
> &#x20; \## 특이사항\
> &#x20; \* ST007 cd 92번(배송지변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* \`\`\`Release v1.05\_231204\`\`\` : Request DTO 변경전배송지순번(orginDlvpSeq) 추가, 변경전배송지순번 값이 있는 경우 주문번호, 변경전배송지순번 기준 배송순번 일괄 업데이트 진행\
> &#x20; \* \`\`\`Release v2.00\_240711\`\`\` : 추가배송비 금액이 동일한 배송지역그룹으로 배송지 변경 가능하도록 수정<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/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)

> &#x20; \## 기능 설명\
> &#x20; \* \[BO전용] 주문 옵션을 변경합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.\
> &#x20; \* 다건의 옵션 변경이 가능합니다.\
> &#x20; \* 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.\
> &#x20; \* 동일단품, 예약상품의 단품은 변경 불가능합니다.\
> &#x20; \---\
> &#x20; \## 특이사항\
> &#x20; \* ST008 cd 91번(옵션변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* \`\`\`Release v2.00\_241202\`\`\`: 주문 변경 상품 필터링 수정 (다중배송 주문 변경 (BO) > 동일 상품, 단품 변경 케이스)<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/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)

> &#x20; \## 기능 설명\
> &#x20; \* \[FO전용] 주문 옵션을 변경합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 주문내역구분코드(OM003)가 주문완료(11)상태일 경우 옵션 변경 가능합니다.\
> &#x20; \* 단건의 옵션 변경만 가능합니다.\
> &#x20; \* 동일금액의 판매중인 상태의 재고가 있는 단품의 컬러+사이즈로 변경 가능합니다.\
> &#x20; \* 동일단품, 예약상품의 단품은 변경 불가능합니다.\
> &#x20; \---\
> &#x20; \## 특이사항\
> &#x20; \* ST007 cd 91번(옵션변경)의 ref\_1\_val(OM005), ref\_2\_val(OM003)값에 따라 배송지 변경 가능 상태 값이 변경될 수 있습니다.\
> &#x20; \---\
> &#x20; \## 수정번호\
> &#x20; \* \`\`\`Release v2.00\_241202\`\`\`: 주문 변경 상품 필터링 수정 (다중배송 주문 변경 (BO) > 동일 상품, 단품 변경 케이스)<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/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"}}}}
````


---

# 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-25.md?ask=<question>
```

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.
