> 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-4.md).

# 상품제공

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

> \## 기능 설명\
> \- 상품평 등록 여부를 완료로 업데이트합니다.\
> \---\
> \## 상세 설명\
> \- 요청한 주문 상품의 상품평을 등록 완료 처리합니다.\
> \---\
> \## 특이사항\
> \- 로그인이 필수입니다.\
> \- 이미 등록이 완료된 주문 상품을 요청 시 예외가 발생합니다.\
> \## 수정번호\
> \- 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"}}}}
```
