# 상품제공

## 주문 상품평 등록완료 수정

> \## 기능 설명\
> \- 상품평 등록 여부를 완료로 업데이트합니다.\
> \---\
> \## 상세 설명\
> \- 요청한 주문 상품의 상품평을 등록 완료 처리합니다.\
> \---\
> \## 특이사항\
> \- 로그인이 필수입니다.\
> \- 이미 등록이 완료된 주문 상품을 요청 시 예외가 발생합니다.\
> \## 수정번호\
> \- Release v2.00\_240401 : 트랜잭션 어노테이션 추가<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":["상품제공"],"summary":"주문 상품평 등록완료 수정","description":"## 기능 설명\n- 상품평 등록 여부를 완료로 업데이트합니다.\n---\n## 상세 설명\n- 요청한 주문 상품의 상품평을 등록 완료 처리합니다.\n---\n## 특이사항\n- 로그인이 필수입니다.\n- 이미 등록이 완료된 주문 상품을 요청 시 예외가 발생합니다.\n## 수정번호\n- Release v2.00_240401 : 트랜잭션 어노테이션 추가\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":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"UpdateReviewWriteRequest":{"required":["goodsNo","itmNo","ordNo"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"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"}}}}
```

## 상품평 등록가능 상품 조회

> \## 기능 설명\
> \- 상품평이 작성 가능한 주문 상품 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \- 요청 기간 내 상품평 작성이 가능한 주문 상품 목록을 조회합니다.\
> \---\
> \## 특이사항\
> \- 로그인이 필수입니다.\
> \---\
> \## 수정번호\
> \- Release v2.00\_240425 : 멀티 사이트 확장에 따른 사이트 번호(site\_no) 추가<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":["상품제공"],"summary":"상품평 등록가능 상품 조회","description":"## 기능 설명\n- 상품평이 작성 가능한 주문 상품 목록을 조회합니다.\n---\n## 상세 설명\n- 요청 기간 내 상품평 작성이 가능한 주문 상품 목록을 조회합니다.\n---\n## 특이사항\n- 로그인이 필수입니다.\n---\n## 수정번호\n- Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가\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":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReviewWritePossibleResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ReviewWritePossibleListRequest":{"required":["endDt","strDt"],"type":"object","properties":{"pageIdx":{"minimum":1,"type":"integer","description":"페이지번호","format":"int32","default":1},"strDt":{"pattern":"yyyyMMdd","type":"string","description":"시작일자","format":"date"},"endDt":{"pattern":"yyyyMMdd","type":"string","description":"종료일자","format":"date"},"pageSize":{"minimum":1,"type":"integer","description":"페이지 노출수","format":"int32","default":10}}},"ReviewWritePossibleResponse":{"type":"object","properties":{"totCnt":{"type":"integer","description":"전체건수","format":"int64"},"revWritePsbList":{"type":"array","description":"상품평작성가능목록","items":{"$ref":"#/components/schemas/ReviewWritePossibleGoods"}}},"description":"상품평작성가능목록 조회 Response"},"ReviewWritePossibleGoods":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"deliFnshDtm":{"type":"string","description":"배송완료일시","format":"date-time"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"goodsNm":{"type":"string","description":"상품명"},"brandNm":{"type":"string","description":"브랜드명"},"imgUrl":{"type":"string","description":"상품이미지URL"},"dday":{"type":"integer","description":"작성가능일수","format":"int32"},"stdCtgNo":{"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"}}}}
```

## 상품평 등록가능 상품건수 조회

> \## 기능 설명\
> \- 상품평이 작성 가능한 주문 상품의 수를 조회합니다.\
> \---\
> \## 상세 설명\
> \- 요청 기간 내 상품평 작성을 하지 않은 주문 상품의 개수를 조회합니다.\
> \---\
> \## 특이사항\
> \- 로그인이 필수입니다.\
> \---\
> \## 수정번호\
> \- Release v2.00\_240425 : 멀티 사이트 확장에 따른 사이트 번호(site\_no) 추가<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":["상품제공"],"summary":"상품평 등록가능 상품건수 조회","description":"## 기능 설명\n- 상품평이 작성 가능한 주문 상품의 수를 조회합니다.\n---\n## 상세 설명\n- 요청 기간 내 상품평 작성을 하지 않은 주문 상품의 개수를 조회합니다.\n---\n## 특이사항\n- 로그인이 필수입니다.\n---\n## 수정번호\n- Release v2.00_240425 : 멀티 사이트 확장에 따른 사이트 번호(site_no) 추가\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":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReviewWritePossibleCount"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ReviewWritePossibleCountRequest":{"required":["endDt","strDt"],"type":"object","properties":{"mbrNo":{"type":"string","description":"고객번호"},"strDt":{"pattern":"yyyyMMdd","type":"string","description":"시작일자","format":"date"},"endDt":{"pattern":"yyyyMMdd","type":"string","description":"종료일자","format":"date"}},"description":"상품평 작성 가능 건수 조회 Request"},"ReviewWritePossibleCount":{"type":"object","properties":{"revWritePsbCnt":{"type":"integer","description":"상품평작성가능수량","format":"int64"}},"description":"상품평가능건수 조회 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"}}}}
```

## 예약상품 주문 수량 조회

> \## 기능 설명\
> \* 예약상품의 주문 수량을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 상품번호, 단품번호, 예약 시작, 종료 일시를 기준으로 기간 내 단품 단위 주문 수량 조회합니다.<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":["상품제공"],"summary":"예약상품 주문 수량 조회","description":"## 기능 설명\n* 예약상품의 주문 수량을 조회합니다.\n---\n## 상세 설명\n* 상품번호, 단품번호, 예약 시작, 종료 일시를 기준으로 기간 내 단품 단위 주문 수량 조회합니다.\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":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrdRsvGoodsTotCntResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"OrdRsvGoodsTotCntRequest":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"rsvStrtDtm":{"pattern":"yyyyMMddHHmmss","type":"string","description":"예약시작일시","format":"date-time"},"rsvEndDtm":{"pattern":"yyyyMMddHHmmss","type":"string","description":"예약종료일시","format":"date-time"}},"description":"예약상품 주문 수량 조회 Request"},"OrdRsvGoodsTotCntResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"ordTotCnt":{"type":"integer","description":"주문 총 수량","format":"int32"}},"description":"예약상품 주문 수량 조회 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"}}}}
```

## 사은품 주문 수량 조회

> \## 기능 설명\
> \* 사은품의 주문 수량을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 사은품의 상품 번호를 기준으로 사은품의 주문 수량을 조회합니다.<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":["상품제공"],"summary":"사은품 주문 수량 조회","description":"## 기능 설명\n* 사은품의 주문 수량을 조회합니다.\n---\n## 상세 설명\n* 사은품의 상품 번호를 기준으로 사은품의 주문 수량을 조회합니다.\n","operationId":"getAeOrdTotCnt","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"string","description":"상품번호"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AeOrdTotCntResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"AeOrdTotCntResponse":{"type":"object","properties":{"aeOrdTotCnt":{"type":"integer","description":"사은품 주문 총 수량","format":"int64"}},"description":"사은품 주문 수량 조회 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"}}}}
```


---

# 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-4.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.
