> 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-1.md).
# 주문 통계
## 주문(매출) 현황 전주 대비
> \## 기능설명\
> \* 주문(매출) 현황 전주 대비 데이터를 조회합니다.\
> \---\
> \## 상세설명\
> \* \[BO] 통계 > 주문통계 > 주문 현황(매출 현황) 페이지 상단의 그래프에서 전주대비 버튼 클릭시 호출됩니다.\
> \* \*\*집계구분코드(agrtGb)\*\*는 필수 조회 조건입니다.\
> \
\
\
> \* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\
> \* 조회일자 기준 7일 간의 데이터(주문 현황: 순주문금액 / 매출 현황: 매출금액)\
> \* 조회일자 7일 전 기준 7일 간의 데이터(주문 현황: 기간 대비 순주문 금액 / 매출 현황: 기간 대비 매출금액)\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"OrderStatusRequest":{"type":"object","description":"주문/매출 현황 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"calendarType":{"type":"string","description":"일간 or 월간"},"startMonth":{"type":"string","description":"조회기간(시작월)"},"endMonth":{"type":"string","description":"조회기간(종료월)"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"}}},"OrderStatusResponse":{"type":"object","description":"주문 현황/매출 현황 DTO","properties":{"agrtDt":{"type":"string","description":"조회일자"},"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":"브랜드명"},"dcAmt2nd":{"type":"number","description":"2차할인금액"},"dcAmt3rd":{"type":"number","description":"3차할인금액"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"finalOrdAmt":{"type":"integer","format":"int64","description":"순주문 금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"finalOrdQty":{"type":"integer","format":"int32","description":"순주문 수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"compareDataList":{"type":"array","description":"기간대비금액목록","items":{"$ref":"#/components/schemas/OrderSalesStatusInfo"}},"realOrdQty":{"type":"integer","format":"int32","description":"순주문 수량"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문 금액"},"dcAmt":{"type":"number","description":"할인금액"},"currRealOrdAmt":{"type":"integer","format":"int64","description":"현재순주문금액"}}},"OrderSalesStatusInfo":{"type":"object","description":"주문(매출)현황 그래프 DTO","properties":{"agrtDt":{"type":"string","description":"기준일자(기준시간)"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문금액(순매출금액)"},"pwRealOrdAmt":{"type":"integer","format":"int64","description":"기간대비순주문금액(기간대비순매출금액)"},"realOrdQty":{"type":"integer","format":"int64","description":"순주문수량(순매출수량)"},"pwRealOrdQty":{"type":"integer","format":"int64","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/orderStatus/getOrderSalesStatusWeekGraph":{"post":{"tags":["주문 통계"],"summary":"주문(매출) 현황 전주 대비","description":"## 기능설명\n* 주문(매출) 현황 전주 대비 데이터를 조회합니다.\n---\n## 상세설명\n* [BO] 통계 > 주문통계 > 주문 현황(매출 현황) 페이지 상단의 그래프에서 전주대비 버튼 클릭시 호출됩니다.\n* **집계구분코드(agrtGb)**는 필수 조회 조건입니다.\n
\n* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\n * 조회일자 기준 7일 간의 데이터(주문 현황: 순주문금액 / 매출 현황: 매출금액)\n * 조회일자 7일 전 기준 7일 간의 데이터(주문 현황: 기간 대비 순주문 금액 / 매출 현황: 기간 대비 매출금액)\n---\n## 수정 번호\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getOrderSalesStatusWeekGraph","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderStatusRequest"}}},"required":true},"responses":{"200":{"description":"전주 대비 데이터 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 주문(매출) 현황 전월 대비
> \## 기능설명\
> \* 주문(매출) 현황 전월 대비 데이터를 조회합니다.\
> \---\
> \## 상세설명\
> \* \[BO] 통계 > 주문통계 > 주문 현황(매출 현황) 페이지 상단의 그래프에서 전월대비 버튼 클릭시 호출됩니다.\
> \* \*\*집계구분코드(agrtGb)\*\*는 필수 조회 조건입니다.\
> \
\
\
> \* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\
> \* 조회일자 기준 30일 동안의 데이터(주문 현황: 순주문금액 / 매출 현황: 매출금액)\
> \* 조회일자 30일 전 기준 30일 동안의 데이터(주문 현황: 기간 대비 순주문 금액 / 매출 현황: 기간 대비 매출금액)\
> \---\
> \## 수정번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"OrderStatusRequest":{"type":"object","description":"주문/매출 현황 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"calendarType":{"type":"string","description":"일간 or 월간"},"startMonth":{"type":"string","description":"조회기간(시작월)"},"endMonth":{"type":"string","description":"조회기간(종료월)"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"}}},"OrderStatusResponse":{"type":"object","description":"주문 현황/매출 현황 DTO","properties":{"agrtDt":{"type":"string","description":"조회일자"},"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":"브랜드명"},"dcAmt2nd":{"type":"number","description":"2차할인금액"},"dcAmt3rd":{"type":"number","description":"3차할인금액"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"finalOrdAmt":{"type":"integer","format":"int64","description":"순주문 금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"finalOrdQty":{"type":"integer","format":"int32","description":"순주문 수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"compareDataList":{"type":"array","description":"기간대비금액목록","items":{"$ref":"#/components/schemas/OrderSalesStatusInfo"}},"realOrdQty":{"type":"integer","format":"int32","description":"순주문 수량"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문 금액"},"dcAmt":{"type":"number","description":"할인금액"},"currRealOrdAmt":{"type":"integer","format":"int64","description":"현재순주문금액"}}},"OrderSalesStatusInfo":{"type":"object","description":"주문(매출)현황 그래프 DTO","properties":{"agrtDt":{"type":"string","description":"기준일자(기준시간)"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문금액(순매출금액)"},"pwRealOrdAmt":{"type":"integer","format":"int64","description":"기간대비순주문금액(기간대비순매출금액)"},"realOrdQty":{"type":"integer","format":"int64","description":"순주문수량(순매출수량)"},"pwRealOrdQty":{"type":"integer","format":"int64","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/orderStatus/getOrderSalesStatusMonthGraph":{"post":{"tags":["주문 통계"],"summary":"주문(매출) 현황 전월 대비","description":"## 기능설명\n* 주문(매출) 현황 전월 대비 데이터를 조회합니다.\n---\n## 상세설명\n* [BO] 통계 > 주문통계 > 주문 현황(매출 현황) 페이지 상단의 그래프에서 전월대비 버튼 클릭시 호출됩니다.\n* **집계구분코드(agrtGb)**는 필수 조회 조건입니다.\n
\n* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\n * 조회일자 기준 30일 동안의 데이터(주문 현황: 순주문금액 / 매출 현황: 매출금액)\n * 조회일자 30일 전 기준 30일 동안의 데이터(주문 현황: 기간 대비 순주문 금액 / 매출 현황: 기간 대비 매출금액)\n---\n## 수정번호\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getOrderSalesStatusMonthGraph","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderStatusRequest"}}},"required":true},"responses":{"200":{"description":"전월 대비 데이터 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 주문(매출) 현황 전일 대비
> \## 기능설명\
> \* 주문(매출) 현황 전일 대비 데이터를 조회합니다.\
> \---\
> \## 상세설명\
> \* \[BO] 통계 > 주문통계 > 주문 현황(매출 현황) 페이지 상단의 그래프에서 전일대비 버튼 클릭시 호출됩니다.\
> \* \*\*집계구분코드(agrtGb)\*\*는 필수 조회 조건입니다.\
> \
\
\
> \* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\
> \* 조회시간 기준 24시간 동안의 데이터(주문 현황: 순주문금액 / 매출 현황: 매출금액)\
> \* 조회시간 24시간 전 기준 24시간 동안의 데이터(주문 현황: 기간 대비 순주문 금액 / 매출 현황: 기간 대비 매출금액)\
> \---\
> \## 수정번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"OrderStatusRequest":{"type":"object","description":"주문/매출 현황 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"calendarType":{"type":"string","description":"일간 or 월간"},"startMonth":{"type":"string","description":"조회기간(시작월)"},"endMonth":{"type":"string","description":"조회기간(종료월)"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"}}},"OrderStatusResponse":{"type":"object","description":"주문 현황/매출 현황 DTO","properties":{"agrtDt":{"type":"string","description":"조회일자"},"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":"브랜드명"},"dcAmt2nd":{"type":"number","description":"2차할인금액"},"dcAmt3rd":{"type":"number","description":"3차할인금액"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"finalOrdAmt":{"type":"integer","format":"int64","description":"순주문 금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"finalOrdQty":{"type":"integer","format":"int32","description":"순주문 수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"compareDataList":{"type":"array","description":"기간대비금액목록","items":{"$ref":"#/components/schemas/OrderSalesStatusInfo"}},"realOrdQty":{"type":"integer","format":"int32","description":"순주문 수량"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문 금액"},"dcAmt":{"type":"number","description":"할인금액"},"currRealOrdAmt":{"type":"integer","format":"int64","description":"현재순주문금액"}}},"OrderSalesStatusInfo":{"type":"object","description":"주문(매출)현황 그래프 DTO","properties":{"agrtDt":{"type":"string","description":"기준일자(기준시간)"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문금액(순매출금액)"},"pwRealOrdAmt":{"type":"integer","format":"int64","description":"기간대비순주문금액(기간대비순매출금액)"},"realOrdQty":{"type":"integer","format":"int64","description":"순주문수량(순매출수량)"},"pwRealOrdQty":{"type":"integer","format":"int64","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/orderStatus/getOrderSalesStatusDayGraph":{"post":{"tags":["주문 통계"],"summary":"주문(매출) 현황 전일 대비","description":"## 기능설명\n* 주문(매출) 현황 전일 대비 데이터를 조회합니다.\n---\n## 상세설명\n* [BO] 통계 > 주문통계 > 주문 현황(매출 현황) 페이지 상단의 그래프에서 전일대비 버튼 클릭시 호출됩니다.\n* **집계구분코드(agrtGb)**는 필수 조회 조건입니다.\n
\n* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\n * 조회시간 기준 24시간 동안의 데이터(주문 현황: 순주문금액 / 매출 현황: 매출금액)\n * 조회시간 24시간 전 기준 24시간 동안의 데이터(주문 현황: 기간 대비 순주문 금액 / 매출 현황: 기간 대비 매출금액)\n---\n## 수정번호\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getOrderSalesStatusDayGraph","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderStatusRequest"}}},"required":true},"responses":{"200":{"description":"전일 대비 데이터 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrderStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 주문통계 > 연령대별 성별 주문/매출 현황 조회(그리드)
> \## 기능설명\
> \* 주문통계 > 연령대별 성별 주문/매출 현황을 조회합니다.(그리드용)\
> \---\
> \## 상세설명\
> \* 그리드 컬럼에 맞춰 조회한 데이터 입니다.\
> \* 20대 \~ 60대, 미입력 순으로 정렬됩니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"SalesStatusByGenderAgeRequest":{"type":"object","properties":{"agrtGb":{"type":"string"},"startDate":{"type":"string","format":"date"},"endDate":{"type":"string","format":"date"},"stdCtgNo":{"type":"string"}}},"RealGridListResponseSalesStatusByGenderAgeResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SalesStatusByGenderAgeResponse"}}}},"SalesStatusByGenderAgeResponse":{"type":"object","properties":{"ageGroup":{"type":"string","description":"연령대그룹"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"salesFnshQtyFemale":{"type":"integer","format":"int64","description":"여성주문/매출수량"},"salesFnshAmtFemale":{"type":"integer","format":"int64","description":"여성주문/매출금액"},"dcAmtFemale":{"type":"integer","format":"int64","description":"여성할인금액"},"salesFnshQtyMale":{"type":"integer","format":"int64","description":"남성주문/매출수량"},"salesFnshAmtMale":{"type":"integer","format":"int64","description":"남성주문/매출금액"},"dcAmtMale":{"type":"integer","format":"int64","description":"남성할인금액"},"salesFnshQtyNotEntered":{"type":"integer","format":"int64","description":"미입력주문/매출수량"},"salesFnshAmtNotEntered":{"type":"integer","format":"int64","description":"미입력주문/매출금액"},"dcAmtNotEntered":{"type":"integer","format":"int64","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/orderStatus/getSalesStatusByGenderAgeGrid":{"get":{"tags":["주문 통계"],"summary":"주문통계 > 연령대별 성별 주문/매출 현황 조회(그리드)","description":" ## 기능설명\n * 주문통계 > 연령대별 성별 주문/매출 현황을 조회합니다.(그리드용)\n ---\n ## 상세설명\n * 그리드 컬럼에 맞춰 조회한 데이터 입니다.\n * 20대 ~ 60대, 미입력 순으로 정렬됩니다.\n ---\n ## 수정 번호\n * Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getSalesStatusByGenderAgeGroupGrid","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SalesStatusByGenderAgeRequest"}},{"name":"agrtGb","in":"query","description":"집계구분코드","required":true,"schema":{"type":"String"}},{"name":"startDate","in":"query","description":"조회기간(시작일)","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회기간(종료일)","schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준카테고리번호","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSalesStatusByGenderAgeResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 주문통계 > 연령대별 성별 주문/매출 현황 조회(차트)
> \## 기능설명\
> \* 주문통계 > 연령대별 성별 주문/매출 현황을 조회합니다.(차트)\
> \---\
> \## 상세설명\
> \* 차트를 구성하기 위한 데이터 입니다.\
> \* 연령대, 성별, 주문/매출 합계 목록으로 조회됩니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"SalesStatusByGenderAgeRequest":{"type":"object","properties":{"agrtGb":{"type":"string"},"startDate":{"type":"string","format":"date"},"endDate":{"type":"string","format":"date"},"stdCtgNo":{"type":"string"}}},"SalesStatusByGenderAgeChartResponse":{"type":"object","properties":{"ageGroup":{"type":"string","description":"연령대그룹"},"totalSales":{"type":"integer","format":"int64","description":"주문/매출 합계"},"sexGbCd":{"type":"string","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/orderStatus/getSalesStatusByGenderAgeChart":{"get":{"tags":["주문 통계"],"summary":"주문통계 > 연령대별 성별 주문/매출 현황 조회(차트)","description":" ## 기능설명\n * 주문통계 > 연령대별 성별 주문/매출 현황을 조회합니다.(차트)\n ---\n ## 상세설명\n * 차트를 구성하기 위한 데이터 입니다.\n * 연령대, 성별, 주문/매출 합계 목록으로 조회됩니다.\n ---\n ## 수정 번호\n * Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getSalesStatusByGenderAgeGroupChart","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SalesStatusByGenderAgeRequest"}},{"name":"agrtGb","in":"query","description":"집계구분코드","required":true,"schema":{"type":"String"}},{"name":"startDate","in":"query","description":"조회기간(시작일)","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회기간(종료일)","schema":{"type":"LocalDate"}},{"name":"stdCtgNo","in":"query","description":"표준카테고리번호","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SalesStatusByGenderAgeChartResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 주문(매출) 현황 목록 조회
> \## 기능설명\
> \* 주문(매출) 현황을 조회하는 기능 입니다.\
> \---\
> \## 상세설명\
> \* \[BO] 통계 > 주문통계 > 주문 현황(매출 현황) 페이지에서 조회 버튼 클릭시 호출됩니다.\
> \* \*\*집계구분코드, 조회기간(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*표준분류번호, 상품번호, 협력사번호, 브랜드번호\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"OrderStatusRequest":{"type":"object","description":"주문/매출 현황 DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"calendarType":{"type":"string","description":"일간 or 월간"},"startMonth":{"type":"string","description":"조회기간(시작월)"},"endMonth":{"type":"string","description":"조회기간(종료월)"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"mdId":{"type":"string","description":"담당MD"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"goodsNo":{"type":"string","description":"상품번호"},"agrtGb":{"type":"string","description":"집계구분"}}},"RealGridListResponseOrderStatusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderStatusResponse"}}}},"OrderStatusResponse":{"type":"object","description":"주문 현황/매출 현황 DTO","properties":{"agrtDt":{"type":"string","description":"조회일자"},"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":"브랜드명"},"dcAmt2nd":{"type":"number","description":"2차할인금액"},"dcAmt3rd":{"type":"number","description":"3차할인금액"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"finalOrdAmt":{"type":"integer","format":"int64","description":"순주문 금액"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"finalOrdQty":{"type":"integer","format":"int32","description":"순주문 수량"},"infCnt":{"type":"integer","format":"int32","description":"유입건수"},"compareDataList":{"type":"array","description":"기간대비금액목록","items":{"$ref":"#/components/schemas/OrderSalesStatusInfo"}},"realOrdQty":{"type":"integer","format":"int32","description":"순주문 수량"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문 금액"},"dcAmt":{"type":"number","description":"할인금액"},"currRealOrdAmt":{"type":"integer","format":"int64","description":"현재순주문금액"}}},"OrderSalesStatusInfo":{"type":"object","description":"주문(매출)현황 그래프 DTO","properties":{"agrtDt":{"type":"string","description":"기준일자(기준시간)"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문금액(순매출금액)"},"pwRealOrdAmt":{"type":"integer","format":"int64","description":"기간대비순주문금액(기간대비순매출금액)"},"realOrdQty":{"type":"integer","format":"int64","description":"순주문수량(순매출수량)"},"pwRealOrdQty":{"type":"integer","format":"int64","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/orderStatus/getOrderStatusList":{"get":{"tags":["주문 통계"],"summary":"주문(매출) 현황 목록 조회","description":"## 기능설명\n* 주문(매출) 현황을 조회하는 기능 입니다.\n---\n## 상세설명\n* [BO] 통계 > 주문통계 > 주문 현황(매출 현황) 페이지에서 조회 버튼 클릭시 호출됩니다.\n* **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.\n* **표준분류번호, 상품번호, 협력사번호, 브랜드번호**는 선택 조회 조건입니다.\n---\n## 수정 번호\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getOrderStatusList","parameters":[{"name":"orderStatusRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderStatusRequest"}},{"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":"goodsNo","in":"query","description":"상품번호","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"brandNo","in":"query","description":"브랜드번호","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"주문 현황 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 주문통계 > 연령별/등급별 주문/매출 금액 비율 목록 조회
> \## 기능설명\
> \* 주문통계 > 연령별 주문/매출 현황 및 등급별 주문/매출 현황 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 집계구분코드(주문/매출)와 그룹구분코드(연령별/등급별)를 파라미터로 넘겨받아 조건에 해당하는 데이터를 조회 합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"OrderSalesGroupStatusRequest":{"type":"object","description":"연령별/등급별 주문/매출 현황 DTO","properties":{"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준분류번호"},"ageList":{"type":"array","description":"연령대","items":{"type":"string"}},"selectTopYn":{"type":"string","description":"연령별 상위 항목 조회 여부"},"agrtGb":{"type":"string","description":"집계구분"},"groupCd":{"type":"string","description":"그룹구분"}}},"RealGridListResponseOrderSalesGroupStatusInfoResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OrderSalesGroupStatusInfoResponse"}}}},"OrderSalesGroupStatusInfoResponse":{"type":"object","description":"연령별/등급별 주문/매출 현황 응답 DTO","properties":{"groupCd":{"type":"string","description":"그룹구분코드 A: 연령별, G: 등급별"},"agrtDt":{"type":"string","description":"조회일자"},"stdCtgNm":{"type":"string","description":"표준분류명"},"ordQty":{"type":"integer","format":"int32","description":"주문수량"},"cnclQty":{"type":"integer","format":"int32","description":"취소수량"},"realOrdQty":{"type":"integer","format":"int32","description":"순주문수량"},"ordAmt":{"type":"number","description":"주문금액"},"cnclAmt":{"type":"number","description":"취소금액"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문금액"},"dcAmt":{"type":"number","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/orderStatus/getOrderSalesGroupStatusList":{"get":{"tags":["주문 통계"],"summary":"주문통계 > 연령별/등급별 주문/매출 금액 비율 목록 조회","description":" ## 기능설명\n * 주문통계 > 연령별 주문/매출 현황 및 등급별 주문/매출 현황 목록을 조회합니다.\n ---\n ## 상세설명\n * 집계구분코드(주문/매출)와 그룹구분코드(연령별/등급별)를 파라미터로 넘겨받아 조건에 해당하는 데이터를 조회 합니다.\n ---\n ## 수정 번호\n * Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getOrderSalesGroupStatusList","parameters":[{"name":"orderSalesGroupStatusRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderSalesGroupStatusRequest"}},{"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":"ageList","in":"query","description":"연령대","schema":{"type":"String"}},{"name":"selectTopYn","in":"query","description":"연령별 상위 항목 조회 여부","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}},{"name":"groupCd","in":"query","description":"그룹구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseOrderSalesGroupStatusInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 주문통계 > 연령별/등급별 주문/매출 금액 비율 데이터 조회
> \## 기능설명\
> \* 주문통계 > 연령별 주문/매출 금액 비율 그래프 및 등급별 주문/매출 금액 비율 그래프에 넣을 데이터를 조회 합니다.\
> \---\
> \## 상세설명\
> \* 집계구분코드(주문/매출)와 그룹구분코드(연령별/등급별)를 파라미터로 넘겨받아 조건에 해당하는 데이터를 조회 합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```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":{"OrderSalesGroupStatusRequest":{"type":"object","description":"연령별/등급별 주문/매출 현황 DTO","properties":{"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"stdCtgNo":{"type":"string","description":"표준분류번호"},"ageList":{"type":"array","description":"연령대","items":{"type":"string"}},"selectTopYn":{"type":"string","description":"연령별 상위 항목 조회 여부"},"agrtGb":{"type":"string","description":"집계구분"},"groupCd":{"type":"string","description":"그룹구분"}}},"OrderSalesGroupStatusChartResponse":{"type":"object","description":"연령별/등급별 주문/매출 금액 비율 DTO","properties":{"groupCd":{"type":"string","description":"그룹코드 A:연령별, G: 등급별"},"ordAmt":{"type":"number","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/orderStatus/getOrderSalesGroupStatusChart":{"get":{"tags":["주문 통계"],"summary":"주문통계 > 연령별/등급별 주문/매출 금액 비율 데이터 조회","description":" ## 기능설명\n * 주문통계 > 연령별 주문/매출 금액 비율 그래프 및 등급별 주문/매출 금액 비율 그래프에 넣을 데이터를 조회 합니다.\n ---\n ## 상세설명\n * 집계구분코드(주문/매출)와 그룹구분코드(연령별/등급별)를 파라미터로 넘겨받아 조건에 해당하는 데이터를 조회 합니다.\n ---\n ## 수정 번호\n * Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getOrderSalesGroupStatusChart","parameters":[{"name":"orderSalesGroupStatusRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OrderSalesGroupStatusRequest"}},{"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":"ageList","in":"query","description":"연령대","schema":{"type":"String"}},{"name":"selectTopYn","in":"query","description":"연령별 상위 항목 조회 여부","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}},{"name":"groupCd","in":"query","description":"그룹구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrderSalesGroupStatusChartResponse"}}}}},"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-1.md?ask=
```
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.