> 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/back-office-api/statistics-bo-api/undefined-2.md).
# 상품 통계
## 상품분석 판매현황 목록 조회
> \## 기능설명\
> \* 상품 판매 현황을 조회하는 기능 입니다.\
> \* 페이징 없이 TOP-N 개 조회합니다.\
> \---\
> \## 상세설명\
> \* \[BO] 통계 > 상품분석 > 판매 현황 페이지에서 조회 버튼 클릭시 호출됩니다.\
> \* \*\*집계구분코드, 조회기간(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"GoodsAnalysisResponse":{"type":"object","description":"상품분석 DTO","properties":{"imgPath":{"type":"string","description":"이미지경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"cvr":{"type":"number","format":"float","description":"구매전환율"},"cnclRtnQty":{"type":"integer","format":"int32","description":"취/반품수량"},"rtnRate":{"type":"number","format":"float","description":"반품율"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/statistics/goods/sales-status":{"get":{"tags":["상품 통계"],"summary":"상품분석 판매현황 목록 조회","description":"## 기능설명\n* 상품 판매 현황을 조회하는 기능 입니다.\n* 페이징 없이 TOP-N 개 조회합니다.\n---\n## 상세설명\n* [BO] 통계 > 상품분석 > 판매 현황 페이지에서 조회 버튼 클릭시 호출됩니다.\n* **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.\n* **표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호**는 선택 조회 조건입니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n","operationId":"getGoodsSalesStatusList","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GoodsAnalysisResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품분석 상품상세 유입정보 목록 조회
> \## 기능설명\
> \* 상품상세 유입정보 목록을 조회하는 기능 입니다.\
> \* 페이징 없이 TOP-N 개 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*집계구분코드, 조회기간(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*사이트번호\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"GoodsAnalysisResponse":{"type":"object","description":"상품분석 DTO","properties":{"imgPath":{"type":"string","description":"이미지경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"cvr":{"type":"number","format":"float","description":"구매전환율"},"cnclRtnQty":{"type":"integer","format":"int32","description":"취/반품수량"},"rtnRate":{"type":"number","format":"float","description":"반품율"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/statistics/goods/inflow-status":{"get":{"tags":["상품 통계"],"summary":"상품분석 상품상세 유입정보 목록 조회","description":"## 기능설명\n* 상품상세 유입정보 목록을 조회하는 기능 입니다.\n* 페이징 없이 TOP-N 개 조회합니다.\n---\n## 상세설명\n* **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.\n* **사이트번호**는 선택 조회 조건입니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n","operationId":"getGoodsInfStatusList","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GoodsAnalysisResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품분석 취소/반품 목록 조회
> \## 기능설명\
> \* 취소/반품 현황 목록을 조회하는 기능 입니다.\
> \* 페이징 없이 TOP-N 개 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*집계구분코드, 조회기간(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"GoodsAnalysisResponse":{"type":"object","description":"상품분석 DTO","properties":{"imgPath":{"type":"string","description":"이미지경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"cvr":{"type":"number","format":"float","description":"구매전환율"},"cnclRtnQty":{"type":"integer","format":"int32","description":"취/반품수량"},"rtnRate":{"type":"number","format":"float","description":"반품율"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/statistics/goods/cancel-return-status":{"get":{"tags":["상품 통계"],"summary":"상품분석 취소/반품 목록 조회","description":"## 기능설명\n* 취소/반품 현황 목록을 조회하는 기능 입니다.\n* 페이징 없이 TOP-N 개 조회합니다.\n---\n## 상세설명\n* **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.\n* **표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호**는 선택 조회 조건입니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n","operationId":"getGoodsCnclRtnStatusList","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GoodsAnalysisResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품분석 판매현황 목록 조회
> \## 기능설명\
> \* 상품 판매 현황을 조회하는 기능 입니다.\
> \---\
> \## 상세설명\
> \* \[BO] 통계 > 상품분석 > 판매 현황 페이지에서 조회 버튼 클릭시 호출됩니다.\
> \* \*\*집계구분코드, 조회기간(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성\
> \* Release v2.00\_260512: Umami → GA4 데이터 소스 마이그레이션 (상품상세 유입수: SM\_DAYCL\_GOODS\_INF\_AGRT → SM\_HOURCL\_GOODS\_INF\_AGRT)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"RealGridListResponseGoodsAnalysisResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsAnalysisResponse"}}}},"GoodsAnalysisResponse":{"type":"object","description":"상품분석 DTO","properties":{"imgPath":{"type":"string","description":"이미지경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"cvr":{"type":"number","format":"float","description":"구매전환율"},"cnclRtnQty":{"type":"integer","format":"int32","description":"취/반품수량"},"rtnRate":{"type":"number","format":"float","description":"반품율"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/statistics/goodsAnalysis/getGoodsSalesStatusList":{"get":{"tags":["상품 통계"],"summary":"상품분석 판매현황 목록 조회","description":"## 기능설명\n* 상품 판매 현황을 조회하는 기능 입니다.\n---\n## 상세설명\n* [BO] 통계 > 상품분석 > 판매 현황 페이지에서 조회 버튼 클릭시 호출됩니다.\n* **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.\n* **표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호**는 선택 조회 조건입니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n* Release v2.00_260512: Umami → GA4 데이터 소스 마이그레이션 (상품상세 유입수: SM_DAYCL_GOODS_INF_AGRT → SM_HOURCL_GOODS_INF_AGRT)\n","operationId":"getGoodsSalesStatusList_1","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseGoodsAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품분석 상품상세 유입정보 목록 조회
> \## 기능설명\
> \* 상품상세 유입정보 목록을 조회하는 기능 입니다.\
> \---\
> \## 상세설명\
> \* \*\*집계구분코드, 조회기간(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*사이트번호\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성\
> \* Release v2.00\_260512: Umami → GA4 데이터 소스 마이그레이션 (상품상세 유입수: SM\_UMAMI\_INF\_AGRT(raw) → SM\_HOURCL\_GOODS\_INF\_AGRT(시간별 사전집계))
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"RealGridListResponseGoodsAnalysisResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsAnalysisResponse"}}}},"GoodsAnalysisResponse":{"type":"object","description":"상품분석 DTO","properties":{"imgPath":{"type":"string","description":"이미지경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"cvr":{"type":"number","format":"float","description":"구매전환율"},"cnclRtnQty":{"type":"integer","format":"int32","description":"취/반품수량"},"rtnRate":{"type":"number","format":"float","description":"반품율"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/statistics/goodsAnalysis/getGoodsInfStatusList":{"get":{"tags":["상품 통계"],"summary":"상품분석 상품상세 유입정보 목록 조회","description":"## 기능설명\n* 상품상세 유입정보 목록을 조회하는 기능 입니다.\n---\n## 상세설명\n* **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.\n* **사이트번호**는 선택 조회 조건입니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n* Release v2.00_260512: Umami → GA4 데이터 소스 마이그레이션 (상품상세 유입수: SM_UMAMI_INF_AGRT(raw) → SM_HOURCL_GOODS_INF_AGRT(시간별 사전집계))\n","operationId":"getGoodsInfStatusList_1","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseGoodsAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품분석 취소/반품 목록 조회
> \## 기능설명\
> \* 취소/반품 현황 목록을 조회하는 기능 입니다.\
> \---\
> \## 상세설명\
> \* \*\*집계구분코드, 조회기간(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"RealGridListResponseGoodsAnalysisResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsAnalysisResponse"}}}},"GoodsAnalysisResponse":{"type":"object","description":"상품분석 DTO","properties":{"imgPath":{"type":"string","description":"이미지경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"cvr":{"type":"number","format":"float","description":"구매전환율"},"cnclRtnQty":{"type":"integer","format":"int32","description":"취/반품수량"},"rtnRate":{"type":"number","format":"float","description":"반품율"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/statistics/goodsAnalysis/getGoodsCnclRtnStatusList":{"get":{"tags":["상품 통계"],"summary":"상품분석 취소/반품 목록 조회","description":"## 기능설명\n* 취소/반품 현황 목록을 조회하는 기능 입니다.\n---\n## 상세설명\n* **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.\n* **표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호**는 선택 조회 조건입니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n","operationId":"getGoodsCnclRtnStatusList_1","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseGoodsAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품분석 공통 목록 조회
> \## 기능설명\
> \* 상품분석 목록을 조회하는 기능 입니다.\
> \---\
> \## 상세설명\
> \* \*\*집계구분코드, 조회기간(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"RealGridListResponseGoodsAnalysisResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsAnalysisResponse"}}}},"GoodsAnalysisResponse":{"type":"object","description":"상품분석 DTO","properties":{"imgPath":{"type":"string","description":"이미지경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"cvr":{"type":"number","format":"float","description":"구매전환율"},"cnclRtnQty":{"type":"integer","format":"int32","description":"취/반품수량"},"rtnRate":{"type":"number","format":"float","description":"반품율"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/statistics/goodsAnalysis/getGoodsAnalysisList":{"get":{"tags":["상품 통계"],"summary":"상품분석 공통 목록 조회","description":"## 기능설명\n* 상품분석 목록을 조회하는 기능 입니다.\n---\n## 상세설명\n* **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.\n* **표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호**는 선택 조회 조건입니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n","operationId":"getGoodsAnalysisList","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseGoodsAnalysisResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품분석 판매현황 그리드 엑셀 일괄 다운로드
> \## 기능설명\
> \* 상품 판매 현황을 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\
> \---\
> \## 상세설명\
> \* 노출 항목은 그리드 목록과 동일 합니다.\
> \* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성\
> \* Release v2.00\_260512: Umami → GA4 데이터 소스 마이그레이션 (상품상세 유입수: SM\_DAYCL\_GOODS\_INF\_AGRT → SM\_HOURCL\_GOODS\_INF\_AGRT)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/statistics/goodsAnalysis/downloadGoodsSalesStatusExcel":{"get":{"tags":["상품 통계"],"summary":"상품분석 판매현황 그리드 엑셀 일괄 다운로드","description":"## 기능설명\n* 상품 판매 현황을 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\n---\n## 상세설명\n* 노출 항목은 그리드 목록과 동일 합니다.\n* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n* Release v2.00_260512: Umami → GA4 데이터 소스 마이그레이션 (상품상세 유입수: SM_DAYCL_GOODS_INF_AGRT → SM_HOURCL_GOODS_INF_AGRT)\n","operationId":"downloadGoodsSalesStatusExcel","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}},{"name":"fileName","in":"query","description":"파일명","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품분석 취소/반품 그리드 엑셀 일괄 다운로드
> \## 기능설명\
> \* 상품 취소/반품 현황을 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\
> \---\
> \## 상세설명\
> \* 노출 항목은 그리드 목록과 동일 합니다.\
> \* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsAnalysisRequest":{"type":"object","description":"상품분석 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"entrNo":{"type":"string","description":"협력사번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"},"top":{"type":"integer","format":"int32","description":"TOP 개수"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v1/statistics/goodsAnalysis/downloadGoodsCnclRtnStatusExcel":{"get":{"tags":["상품 통계"],"summary":"상품분석 취소/반품 그리드 엑셀 일괄 다운로드","description":"## 기능설명\n* 상품 취소/반품 현황을 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\n---\n## 상세설명\n* 노출 항목은 그리드 목록과 동일 합니다.\n* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\n---\n## 수정 번호\n* Release v2.00_240827: 최초 생성\n","operationId":"downloadGoodsCnclRtnStatusExcel","parameters":[{"name":"goodsAnalysisRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsAnalysisRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준분류번호","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"담당MD","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}},{"name":"fileName","in":"query","description":"파일명","schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```