> 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/product-provision.md).

# Product Provision

## Update Order Product Review Registration Completion

> \## Function Description\
> \- Updates the product review registration status to completed.\
> \---\
> \## Detailed Description\
> \- Marks the requested order product's review as registration-complete.\
> \---\
> \## Notes\
> \- Login is required.\
> \- An exception occurs if a request is made for an order product whose registration is already complete.\
> \## Revision History\
> \- Release v2.00\_240401 : Added transaction annotation<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/review/updateRevWriteY":{"post":{"tags":["Product Provision"],"summary":"Update Order Product Review Registration Completion","description":"## Function Description\n- Updates the product review registration status to completed.\n---\n## Detailed Description\n- Marks the requested order product's review as registration-complete.\n---\n## Notes\n- Login is required.\n- An exception occurs if a request is made for an order product whose registration is already complete.\n## Revision History\n- Release v2.00_240401 : Added transaction annotation\n","operationId":"updateReviewWriteY","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateReviewWriteRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"UpdateReviewWriteRequest":{"required":["goodsNo","itmNo","ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"Order No."},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."}},"description":"Review Writable Status Update 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"}}}}
```

## Look Up Products Eligible for Review Registration

> \## Function Description\
> \- Looks up the list of order products for which a review can be written.\
> \---\
> \## Detailed Description\
> \- Looks up the list of order products for which a review can be written within the requested period.\
> \---\
> \## Notes\
> \- Login is required.\
> \---\
> \## Revision History\
> \- Release v2.00\_240425 : Added site number (site\_no) for multi-site expansion<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/review/revWritePsbList":{"post":{"tags":["Product Provision"],"summary":"Look Up Products Eligible for Review Registration","description":"## Function Description\n- Looks up the list of order products for which a review can be written.\n---\n## Detailed Description\n- Looks up the list of order products for which a review can be written within the requested period.\n---\n## Notes\n- Login is required.\n---\n## Revision History\n- Release v2.00_240425 : Added site number (site_no) for multi-site expansion\n","operationId":"getReviewWritePossibleList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewWritePossibleListRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReviewWritePossibleResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ReviewWritePossibleListRequest":{"required":["endDt","strDt"],"type":"object","properties":{"pageIdx":{"minimum":1,"type":"integer","description":"Page No.","format":"int32","default":1},"strDt":{"pattern":"yyyyMMdd","type":"string","description":"Start Date","format":"date"},"endDt":{"pattern":"yyyyMMdd","type":"string","description":"End Date","format":"date"},"pageSize":{"minimum":1,"type":"integer","description":"Page Display Count","format":"int32","default":10}}},"ReviewWritePossibleResponse":{"type":"object","properties":{"totCnt":{"type":"integer","description":"Total Count","format":"int64"},"revWritePsbList":{"type":"array","description":"Review-Writable List","items":{"$ref":"#/components/schemas/ReviewWritePossibleGoods"}}},"description":"Search Review-Writable List Response"},"ReviewWritePossibleGoods":{"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"},"deliFnshDtm":{"type":"string","description":"Delivery Completion Date/Time","format":"date-time"},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"},"imgUrl":{"type":"string","description":"Product Image URL"},"dday":{"type":"integer","description":"Writable Days","format":"int32"},"stdCtgNo":{"type":"string","description":"Standard Category No."}},"description":"Review-Writable Order Info"},"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"}}}}
```

## Look Up Count of Products Eligible for Review Registration

> \## Function Description\
> \- Looks up the number of order products for which a review can be written.\
> \---\
> \## Detailed Description\
> \- Looks up the number of order products for which a review has not been written within the requested period.\
> \---\
> \## Notes\
> \- Login is required.\
> \---\
> \## Revision History\
> \- Release v2.00\_240425 : Added site number (site\_no) for multi-site expansion<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/review/revWritePsbCnt":{"post":{"tags":["Product Provision"],"summary":"Look Up Count of Products Eligible for Review Registration","description":"## Function Description\n- Looks up the number of order products for which a review can be written.\n---\n## Detailed Description\n- Looks up the number of order products for which a review has not been written within the requested period.\n---\n## Notes\n- Login is required.\n---\n## Revision History\n- Release v2.00_240425 : Added site number (site_no) for multi-site expansion\n","operationId":"getReviewWritePossibleCount","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewWritePossibleCountRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReviewWritePossibleCount"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ReviewWritePossibleCountRequest":{"required":["endDt","strDt"],"type":"object","properties":{"mbrNo":{"type":"string","description":"Customer No."},"strDt":{"pattern":"yyyyMMdd","type":"string","description":"Start Date","format":"date"},"endDt":{"pattern":"yyyyMMdd","type":"string","description":"End Date","format":"date"}},"description":"Search Review-Writable Count Request"},"ReviewWritePossibleCount":{"type":"object","properties":{"revWritePsbCnt":{"type":"integer","description":"Review-Writable Quantity","format":"int64"}},"description":"Search Review-Writable Count Response"},"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"}}}}
```

## Look Up Reserved Product Order Quantity

> \## Function Description\
> \* Looks up the order quantity for a reserved product.\
> \---\
> \## Detailed Description\
> \* Looks up the item-level order quantity within the period, based on product number, item number, and reservation start/end datetime.<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/goods/ordRsvGoodsTotCnt":{"post":{"tags":["Product Provision"],"summary":"Look Up Reserved Product Order Quantity","description":"## Function Description\n* Looks up the order quantity for a reserved product.\n---\n## Detailed Description\n* Looks up the item-level order quantity within the period, based on product number, item number, and reservation start/end datetime.\n","operationId":"getOrdRsvGoodsTotCnt","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrdRsvGoodsTotCntRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrdRsvGoodsTotCntResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrdRsvGoodsTotCntRequest":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"rsvStrtDtm":{"pattern":"yyyyMMddHHmmss","type":"string","description":"Reservation Start Date/Time","format":"date-time"},"rsvEndDtm":{"pattern":"yyyyMMddHHmmss","type":"string","description":"Reservation End Date/Time","format":"date-time"}},"description":"Search Reservation Product Order Quantity Request"},"OrdRsvGoodsTotCntResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"ordTotCnt":{"type":"integer","description":"Total Order Quantity","format":"int32"}},"description":"Search Reservation Product Order Quantity Response"},"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"}}}}
```

## Look Up Gift Order Quantity

> \## Function Description\
> \* Looks up the order quantity for a gift.\
> \---\
> \## Detailed Description\
> \* Looks up the gift's order quantity based on the gift's product number.<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/goods/getAeOrdTotCnt":{"post":{"tags":["Product Provision"],"summary":"Look Up Gift Order Quantity","description":"## Function Description\n* Looks up the order quantity for a gift.\n---\n## Detailed Description\n* Looks up the gift's order quantity based on the gift's product number.\n","operationId":"getAeOrdTotCnt","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"string","description":"Product No."}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AeOrdTotCntResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"AeOrdTotCntResponse":{"type":"object","properties":{"aeOrdTotCnt":{"type":"integer","description":"Total Free Gift Order Quantity","format":"int64"}},"description":"Search Free Gift Order Quantity Response"},"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"}}}}
```
