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