> 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: 최초 생성<br>

```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: 최초 생성<br>

```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: 최초 생성<br>

```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)<br>

```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(시간별 사전집계))<br>

```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: 최초 생성<br>

```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: 최초 생성<br>

```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)<br>

```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: 최초 생성<br>

```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"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/back-office-api/statistics-bo-api/undefined-2.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.
