> 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.md).
# 주문 분석
## 주문(매출) 현황 기간 대비
> \## 기능설명\
> \* 주문(매출) 현황 기간 대비 데이터를 조회합니다.\
> \---\
> \## 상세설명\
> \* 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지 상단의 그래프에서 조회 버튼 클릭 시 호출됩니다.\
> \* calendarType이 date(일간)인 경우, \*\*집계구분코드, 조회기간(조회 시작일, 조회 종료일)\*\*는 필수 조회 조건입니다.\
> \* calendarType이 month(월간)인 경우, \*\*집계구분코드, 조회기간(조회 시작월, 조회 종료월)\*\*는 필수 조회 조건입니다.\
> \
\
\
> \* 2개의 조회결과가 막대 그래프의 형태로 나타납니다.\
> \* 조회기간 기준 동안의 데이터 (주문 현황: 순주문금액 / 매출 현황: 순매출금액)\
> \* 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문금액 / 매출 현황: 기간대비 순매출금액)\
> \* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\
> \* 조회기간 기준 동안의 데이터 (주문 수량: 순주문수량 / 매출 수량: 순매출수량)\
> \* 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문수량 / 매출 현황: 기간대비 순매출수량)\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827: 기간별 주문(매출) 현황 조회 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PeriodBasedStatusRequest":{"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":"집계구분"}}},"PeriodBasedStatusResponse":{"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/periodBasedStatus/getPeriodBasedStatusGraphData":{"post":{"tags":["주문 분석"],"summary":"주문(매출) 현황 기간 대비","description":"## 기능설명\n* 주문(매출) 현황 기간 대비 데이터를 조회합니다.\n---\n## 상세설명\n* 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지 상단의 그래프에서 조회 버튼 클릭 시 호출됩니다.\n* calendarType이 date(일간)인 경우, **집계구분코드, 조회기간(조회 시작일, 조회 종료일)**는 필수 조회 조건입니다.\n* calendarType이 month(월간)인 경우, **집계구분코드, 조회기간(조회 시작월, 조회 종료월)**는 필수 조회 조건입니다.\n
\n* 2개의 조회결과가 막대 그래프의 형태로 나타납니다.\n * 조회기간 기준 동안의 데이터 (주문 현황: 순주문금액 / 매출 현황: 순매출금액)\n * 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문금액 / 매출 현황: 기간대비 순매출금액)\n* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\n * 조회기간 기준 동안의 데이터 (주문 수량: 순주문수량 / 매출 수량: 순매출수량)\n * 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문수량 / 매출 현황: 기간대비 순매출수량)\n---\n## 수정번호\n* Release v2.00_240827: 기간별 주문(매출) 현황 조회 최초 생성\n","operationId":"getPeriodBasedStatusGraphData","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeriodBasedStatusRequest"}}},"required":true},"responses":{"200":{"description":"기간 대비 데이터 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PeriodBasedStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시간대별 주문(매출) 현황 그래프 데이터 조회
> \## 기능 설명\
> \* 시간대별 주문(매출) 현황 그래프 데이터를 조회합니다.\
> \---\
> \## 상세 설명\
> \* 조회일자와 집계구분코드값은 필수 조건입니다.\
> \* 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.\
> \* 조회일자 기준 하루동안 발생한 주문 현황 목록을 조회합니다.\
> \* 검색 조건이 있는 경우, 해당 값으로 목록을 필터링 합니다.\
> \* 검색 일자에 발생한 주문 목록에 대해 시간대별 순 주문금액, 주문수량을 조회합니다.\
> \* 검색 일자에 발생한 주문 목록에 대해 총 순 주문금액, 주문수량을 조회합니다.\
> \* 검색 일자 -1일에 발생한 주문 목록에 대해 시간대별 기간대비 순 주문금액, 주문수량을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"HourBasedStatusRequest":{"type":"object","description":"시간대 별 주문/매출 현황 Request DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"targetDate":{"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":"집계구분"}}},"HourBasedStatusResponse":{"type":"object","description":"시간대 별 주문/매출 현황 Response DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"agrtDt":{"type":"string","description":"조회시간"},"imgPath":{"type":"string","description":"대표이미지"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"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"}}}},"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/hourBasedStatus/getHourBasedStatusGraphData":{"post":{"tags":["주문 분석"],"summary":"시간대별 주문(매출) 현황 그래프 데이터 조회","description":" ## 기능 설명\n * 시간대별 주문(매출) 현황 그래프 데이터를 조회합니다.\n ---\n ## 상세 설명\n * 조회일자와 집계구분코드값은 필수 조건입니다.\n * 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.\n * 조회일자 기준 하루동안 발생한 주문 현황 목록을 조회합니다.\n * 검색 조건이 있는 경우, 해당 값으로 목록을 필터링 합니다.\n * 검색 일자에 발생한 주문 목록에 대해 시간대별 순 주문금액, 주문수량을 조회합니다.\n * 검색 일자에 발생한 주문 목록에 대해 총 순 주문금액, 주문수량을 조회합니다.\n * 검색 일자 -1일에 발생한 주문 목록에 대해 시간대별 기간대비 순 주문금액, 주문수량을 조회합니다.\n ---\n ## 수정번호\n * Release v2.00_240827 : 최초 생성\n","operationId":"getHourBasedStatusGraphData","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HourBasedStatusRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/HourBasedStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 주문(매출) 현황 기간 대비
> \## 기능설명\
> \* 주문(매출) 현황 기간 대비 데이터를 조회합니다.\
> \---\
> \## 상세설명\
> \* 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지 상단의 그래프에서 조회 버튼 클릭 시 호출됩니다.\
> \* calendarType이 date(일간)인 경우, \*\*집계구분코드, 조회기간(조회 시작일, 조회 종료일)\*\*는 필수 조회 조건입니다.\
> \* calendarType이 month(월간)인 경우, \*\*집계구분코드, 조회기간(조회 시작월, 조회 종료월)\*\*는 필수 조회 조건입니다.\
> \
\
\
> \* 2개의 조회결과가 막대 그래프의 형태로 나타납니다.\
> \* 조회기간 기준 동안의 데이터 (주문 현황: 순주문금액 / 매출 현황: 순매출금액)\
> \* 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문금액 / 매출 현황: 기간대비 순매출금액)\
> \* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\
> \* 조회기간 기준 동안의 데이터 (주문 수량: 순주문수량 / 매출 수량: 순매출수량)\
> \* 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문수량 / 매출 현황: 기간대비 순매출수량)\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827: 기간별 주문(매출) 현황 조회 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PeriodBasedStatusRequest":{"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":"집계구분"}}},"PeriodBasedStatusResponse":{"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":{"/v2/statistics/period/sales-status/graph-data":{"get":{"tags":["주문 분석"],"summary":"주문(매출) 현황 기간 대비","description":"## 기능설명\n* 주문(매출) 현황 기간 대비 데이터를 조회합니다.\n---\n## 상세설명\n* 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지 상단의 그래프에서 조회 버튼 클릭 시 호출됩니다.\n* calendarType이 date(일간)인 경우, **집계구분코드, 조회기간(조회 시작일, 조회 종료일)**는 필수 조회 조건입니다.\n* calendarType이 month(월간)인 경우, **집계구분코드, 조회기간(조회 시작월, 조회 종료월)**는 필수 조회 조건입니다.\n
\n* 2개의 조회결과가 막대 그래프의 형태로 나타납니다.\n * 조회기간 기준 동안의 데이터 (주문 현황: 순주문금액 / 매출 현황: 순매출금액)\n * 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문금액 / 매출 현황: 기간대비 순매출금액)\n* 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.\n * 조회기간 기준 동안의 데이터 (주문 수량: 순주문수량 / 매출 수량: 순매출수량)\n * 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문수량 / 매출 현황: 기간대비 순매출수량)\n---\n## 수정번호\n* Release v2.00_240827: 기간별 주문(매출) 현황 조회 최초 생성\n","operationId":"getPeriodBasedStatusGraphData_1","parameters":[{"name":"periodBasedStatusRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/PeriodBasedStatusRequest"}}],"responses":{"200":{"description":"기간 대비 데이터 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PeriodBasedStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시간대별 주문(매출) 현황 그래프 데이터 조회
> \## 기능 설명\
> \* 시간대별 주문(매출) 현황 그래프 데이터를 조회합니다.\
> \---\
> \## 상세 설명\
> \* 조회일자와 집계구분코드값은 필수 조건입니다.\
> \* 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.\
> \* 조회일자 기준 하루동안 발생한 주문 현황 목록을 조회합니다.\
> \* 검색 조건이 있는 경우, 해당 값으로 목록을 필터링 합니다.\
> \* 검색 일자에 발생한 주문 목록에 대해 시간대별 순 주문금액, 주문수량을 조회합니다.\
> \* 검색 일자에 발생한 주문 목록에 대해 총 순 주문금액, 주문수량을 조회합니다.\
> \* 검색 일자 -1일에 발생한 주문 목록에 대해 시간대별 기간대비 순 주문금액, 주문수량을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"HourBasedStatusRequest":{"type":"object","description":"시간대 별 주문/매출 현황 Request DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"targetDate":{"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":"집계구분"}}},"HourBasedStatusResponse":{"type":"object","description":"시간대 별 주문/매출 현황 Response DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"agrtDt":{"type":"string","description":"조회시간"},"imgPath":{"type":"string","description":"대표이미지"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"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"}}}},"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":{"/v2/statistics/period/hourly/sales-status/graph-data":{"get":{"tags":["주문 분석"],"summary":"시간대별 주문(매출) 현황 그래프 데이터 조회","description":" ## 기능 설명\n * 시간대별 주문(매출) 현황 그래프 데이터를 조회합니다.\n ---\n ## 상세 설명\n * 조회일자와 집계구분코드값은 필수 조건입니다.\n * 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.\n * 조회일자 기준 하루동안 발생한 주문 현황 목록을 조회합니다.\n * 검색 조건이 있는 경우, 해당 값으로 목록을 필터링 합니다.\n * 검색 일자에 발생한 주문 목록에 대해 시간대별 순 주문금액, 주문수량을 조회합니다.\n * 검색 일자에 발생한 주문 목록에 대해 총 순 주문금액, 주문수량을 조회합니다.\n * 검색 일자 -1일에 발생한 주문 목록에 대해 시간대별 기간대비 순 주문금액, 주문수량을 조회합니다.\n ---\n ## 수정번호\n * Release v2.00_240827 : 최초 생성\n","operationId":"getHourBasedStatusGraphData_1","parameters":[{"name":"orderStatusRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/HourBasedStatusRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/HourBasedStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 카테고리별 주문(매출) 현황 목록 조회 - 대시보드
> \## 기능설명\
> \* 카테고리별 주문(매출) 현황 목록을 조회합니다.\
> \* 페이징 없이 TOP-N 개 조회합니다.\
> \---\
> \## 상세설명\
> \* 매일 09시 기준으로 전날 집계를 수행합니다.\
> \* 카테고리별 주문(매출) 현황 목록을 조회합니다.\
> \* 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CategoryStatusRequest":{"type":"object","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 개수"}}},"CategoryStatusResponse":{"type":"object","properties":{"stdCtgNo":{"type":"string","description":"표준 카테고리 번호"},"stdCtgNm":{"type":"string","description":"표준 카테고리명"},"siteNm":{"type":"string","description":"사이트명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD"},"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":"순주문수량"}}},"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/category/sales-status":{"get":{"tags":["주문 분석"],"summary":"카테고리별 주문(매출) 현황 목록 조회 - 대시보드","description":"## 기능설명\n* 카테고리별 주문(매출) 현황 목록을 조회합니다.\n* 페이징 없이 TOP-N 개 조회합니다.\n---\n## 상세설명\n* 매일 09시 기준으로 전날 집계를 수행합니다.\n* 카테고리별 주문(매출) 현황 목록을 조회합니다.\n* 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.\n---\n## 수정번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"getCategoryStatusList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CategoryStatusRequest"}},{"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":"결제수단코드(OM013)","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"MD ID","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CategoryStatusResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 기간별 주문(매출) 현황 목록 조회
> \## 기능설명\
> \* 기간별 주문(매출) 현황을 조회하는 기능 입니다.\
> \---\
> \## 상세설명\
> \* \[BO] 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지에서 조회 버튼 클릭 시 호출됩니다.\
> \* calendarType이 date(일간)인 경우, \*\*집계구분코드, 조회기간(조회 시작일, 조회 종료일)\*\*는 필수 조회 조건입니다.\
> \* calendarType이 month(월간)인 경우, \*\*집계구분코드, 조회기간(조회 시작월, 조회 종료월)\*\*는 필수 조회 조건입니다.\
> \* \*\*표준분류번호, 담당MD, 협력사번호, 브랜드번호, 상품번호 사이트\*\*는 선택 조회 조건입니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827: 기간별 주문(매출) 현황 조회 최초 생성\
> \* Release v2.00\_260512: Umami → GA4 데이터 소스 마이그레이션 (기간별 상품상세 유입수: SM\_DAYCL\_GOODS\_INF\_AGRT → SM\_HOURCL\_GOODS\_INF\_AGRT)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PeriodBasedStatusRequest":{"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":"집계구분"}}},"RealGridListResponsePeriodBasedStatusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/PeriodBasedStatusResponse"}}}},"PeriodBasedStatusResponse":{"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/periodBasedStatus/getPeriodBasedStatusList":{"get":{"tags":["주문 분석"],"summary":"기간별 주문(매출) 현황 목록 조회","description":"## 기능설명\n* 기간별 주문(매출) 현황을 조회하는 기능 입니다.\n---\n## 상세설명\n* [BO] 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지에서 조회 버튼 클릭 시 호출됩니다.\n* calendarType이 date(일간)인 경우, **집계구분코드, 조회기간(조회 시작일, 조회 종료일)**는 필수 조회 조건입니다.\n* calendarType이 month(월간)인 경우, **집계구분코드, 조회기간(조회 시작월, 조회 종료월)**는 필수 조회 조건입니다.\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":"getPeriodBasedStatusList","parameters":[{"name":"periodBasedStatusRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/PeriodBasedStatusRequest"}},{"name":"calendarType","in":"query","description":"일간 or 월간","required":true,"schema":{"type":"String"}},{"name":"startMonth","in":"query","description":"조회 시작월","schema":{"type":"String"}},{"name":"endMonth","in":"query","description":"조회 종료월","schema":{"type":"String"}},{"name":"startDate","in":"query","description":"조회 시작일","schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","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":"goodsNo","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/RealGridListResponsePeriodBasedStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 기간별 주문(매출) 현황 그리드 엑셀 일괄 다운로드
> \## 기능 설명\
> \* 기간별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\
> \---\
> \## 상세 설명\
> \* 노출 항목은 그리드 목록과 동일 합니다.\
> \* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\
> \* calendarType이 date(일간)인 경우, \*\*집계구분코드, 조회기간(조회 시작일, 조회 종료일)\*\*는 필수 조회 조건입니다.\
> \* calendarType이 month(월간)인 경우, \*\*집계구분코드, 조회기간(조회 시작월, 조회 종료월)\*\*는 필수 조회 조건입니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827: 기간별 주문(매출) 현황 조회 최초 생성\
> \* Release v2.00\_260512: Umami → GA4 데이터 소스 마이그레이션 (기간별 상품상세 유입수: SM\_DAYCL\_GOODS\_INF\_AGRT → SM\_HOURCL\_GOODS\_INF\_AGRT)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PeriodBasedStatusRequest":{"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":"집계구분"}}},"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/periodBasedStatus/downloadPeriodBasedStatusExcel":{"get":{"tags":["주문 분석"],"summary":"기간별 주문(매출) 현황 그리드 엑셀 일괄 다운로드","description":" ## 기능 설명\n * 기간별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\n ---\n ## 상세 설명\n * 노출 항목은 그리드 목록과 동일 합니다.\n * 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\n * calendarType이 date(일간)인 경우, **집계구분코드, 조회기간(조회 시작일, 조회 종료일)**는 필수 조회 조건입니다.\n * calendarType이 month(월간)인 경우, **집계구분코드, 조회기간(조회 시작월, 조회 종료월)**는 필수 조회 조건입니다.\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":"downloadPeriodBasedStatusExcel","parameters":[{"name":"periodBasedStatusRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/PeriodBasedStatusRequest"}},{"name":"calendarType","in":"query","description":"일간 or 월간","required":true,"schema":{"type":"String"}},{"name":"startMonth","in":"query","description":"조회 시작월","schema":{"type":"String"}},{"name":"endMonth","in":"query","description":"조회 종료월","schema":{"type":"String"}},{"name":"startDate","in":"query","description":"조회 시작일","schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","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":"goodsNo","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":"엑셀 다운로드 성공"},"900":{"description":"엑셀 다운로드 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 결제수단별 주문(매출) 현황 목록 엑셀 다운로드
> \## 기능설명\
> \* 결제수단별 주문(매출) 현황 목록을 엑셀 다운로드합니다.\
> \---\
> \## 상세설명\
> \* 검색 조건에 해당하는 결제수단별 주문(매출) 현황 목록을 페이징 처리가 안된 데이터로 엑셀 다운로드 합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PayWayStatusRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"startDate":{"type":"string","format":"date","description":"시작일자"},"endDate":{"type":"string","format":"date","description":"종료일자"},"agrtGb":{"type":"string","description":"집계구분"},"payWayCd":{"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/payWayStatus/payWayStatusExcelDownload":{"get":{"tags":["주문 분석"],"summary":"결제수단별 주문(매출) 현황 목록 엑셀 다운로드","description":"## 기능설명\n* 결제수단별 주문(매출) 현황 목록을 엑셀 다운로드합니다.\n---\n## 상세설명\n* 검색 조건에 해당하는 결제수단별 주문(매출) 현황 목록을 페이징 처리가 안된 데이터로 엑셀 다운로드 합니다.\n---\n## 수정번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"payWayStatusExcelDownload","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/PayWayStatusRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"payWayCd","in":"query","description":"결제수단코드(OM013)","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 결제수단별 주문(매출) 현황 목록 조회
> \## 기능설명\
> \* 결제수단별 주문(매출) 현황 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 매일 09시 기준으로 전날 집계를 수행합니다.\
> \* 결제수단별 주문(매출) 현황 목록을 조회합니다.\
> \* 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PayWayStatusRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"startDate":{"type":"string","format":"date","description":"시작일자"},"endDate":{"type":"string","format":"date","description":"종료일자"},"agrtGb":{"type":"string","description":"집계구분"},"payWayCd":{"type":"string","description":"결제수단코드"}}},"RealGridListResponsePayWayStatusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/PayWayStatusResponse"}}}},"PayWayStatusResponse":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"agrtDt":{"type":"string","description":"집계일자"},"agrtGb":{"type":"string","description":"집계구분"},"payWayCd":{"type":"string","description":"결제수단코드"},"payWayNm":{"type":"string","description":"결제수단"},"siteNm":{"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":"순주문수량"}}},"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/payWayStatus/getPayWayStatusList":{"get":{"tags":["주문 분석"],"summary":"결제수단별 주문(매출) 현황 목록 조회","description":"## 기능설명\n* 결제수단별 주문(매출) 현황 목록을 조회합니다.\n---\n## 상세설명\n* 매일 09시 기준으로 전날 집계를 수행합니다.\n* 결제수단별 주문(매출) 현황 목록을 조회합니다.\n* 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.\n---\n## 수정번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"getPayWayStatusList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/PayWayStatusRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"payWayCd","in":"query","description":"결제수단코드(OM013)","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponsePayWayStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시간대별 주문(매출) 현황 그리드 목록 조회
> \## 기능 설명\
> \* 시간대별 주문(매출) 현황 그리드 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 조회일자와 집계구분코드값은 필수 조건입니다.\
> \* 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.\
> \* 조회일자 기준 24시간 내에 포함되는 주문건(주문상태일시 비교)을 시간 구간별로 구분하여 조회합니다.\
> \* 검색 조건이 있는 경우, 해당 값으로 목록을 필터링합니다.\
> \* 주문 내역이 없는 시간대에 대해서도 목록에 노출합니다.\
> \* 상품상세 유입 건수의 경우, 동일 시간 구간에 상품상세유입집계 테이블에 등록된 데이터 수를 기반으로 추출합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성\
> \* Release v2.00\_260512: Umami → GA4 데이터 소스 마이그레이션 (시간대별 상품상세 유입수: SM\_UMAMI\_INF\_AGRT(raw) → SM\_HOURCL\_GOODS\_INF\_AGRT(시간별 사전집계))
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"HourBasedStatusRequest":{"type":"object","description":"시간대 별 주문/매출 현황 Request DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"targetDate":{"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":"집계구분"}}},"RealGridListResponseHourBasedStatusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/HourBasedStatusResponse"}}}},"HourBasedStatusResponse":{"type":"object","description":"시간대 별 주문/매출 현황 Response DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"agrtDt":{"type":"string","description":"조회시간"},"imgPath":{"type":"string","description":"대표이미지"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"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"}}}},"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/hourBasedStatus/getHourBasedStatusList":{"get":{"tags":["주문 분석"],"summary":"시간대별 주문(매출) 현황 그리드 목록 조회","description":" ## 기능 설명\n * 시간대별 주문(매출) 현황 그리드 목록을 조회합니다.\n ---\n ## 상세 설명\n * 조회일자와 집계구분코드값은 필수 조건입니다.\n * 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.\n * 조회일자 기준 24시간 내에 포함되는 주문건(주문상태일시 비교)을 시간 구간별로 구분하여 조회합니다.\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":"getHourBasedStatusList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/HourBasedStatusRequest"}},{"name":"targetDate","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":"goodsNo","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/RealGridListResponseHourBasedStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 시간대별 주문(매출) 현황 그리드 엑셀 일괄 다운로드
> \## 기능 설명\
> \* 시간대별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\
> \---\
> \## 상세 설명\
> \* 노출 항목은 그리드 목록과 동일 합니다.\
> \* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성\
> \* Release v2.00\_260512: Umami → GA4 데이터 소스 마이그레이션 (시간대별 상품상세 유입수: SM\_UMAMI\_INF\_AGRT(raw) → SM\_HOURCL\_GOODS\_INF\_AGRT(시간별 사전집계))
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"HourBasedStatusRequest":{"type":"object","description":"시간대 별 주문/매출 현황 Request DTO","properties":{"siteNo":{"type":"string","description":"사이트번호"},"targetDate":{"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":"집계구분"}}},"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/hourBasedStatus/downloadHourBasedStatusExcel":{"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":"downloadHourBasedStatusExcel","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/HourBasedStatusRequest"}},{"name":"targetDate","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":"goodsNo","in":"query","description":"상품번호","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트번호","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분코드","required":true,"schema":{"type":"String"}},{"name":"fileName","in":"query","description":"파일명","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"엑셀 다운로드 성공"},"900":{"description":"엑셀 다운로드 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품 별 주문(매출) 현황 목록 조회
> \## 기능설명\
> \* 상품 별 주문(매출) 현황 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 매일 09시 기준으로 전날 집계를 수행합니다.\
> \* 주문 별 주문(매출) 현황 목록을 조회합니다.\
> \* 집계 구분값으로 주문(01), 매출(02)여부를 구분합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsStatusRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"agrtGb":{"type":"string","description":"집계구분"},"goodsNo":{"type":"string","description":"상품번호"},"entrNo":{"type":"string","description":"협력사번호"}}},"RealGridListResponseGoodsStatusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsStatusResponse"}}}},"GoodsStatusResponse":{"type":"object","properties":{"imgPath":{"type":"string","description":"상품이미지경로"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"siteNm":{"type":"string","description":"사이트명"},"dcAmt2nd":{"type":"number","description":"2차 할인금액"},"dcAmt3rd":{"type":"number","description":"3차 할인금액"},"ordAmt":{"type":"number","description":"주문(배송완료)금액"},"cnclAmt":{"type":"number","description":"취소(반품완료)금액"},"realOrdAmt":{"type":"integer","format":"int64","description":"순주문금액"},"ordQty":{"type":"integer","format":"int64","description":"주문(배송완료)수량"},"cnclQty":{"type":"integer","format":"int64","description":"취소(반품완료)수량"},"realOrdQty":{"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/goodsStatus/getGoodsStatusList":{"get":{"tags":["주문 분석"],"summary":"상품 별 주문(매출) 현황 목록 조회","description":"## 기능설명\n* 상품 별 주문(매출) 현황 목록을 조회합니다.\n---\n## 상세 설명\n* 매일 09시 기준으로 전날 집계를 수행합니다.\n* 주문 별 주문(매출) 현황 목록을 조회합니다.\n* 집계 구분값으로 주문(01), 매출(02)여부를 구분합니다.\n---\n## 수정 번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"getGoodsStatusList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsStatusRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"goodsNo","in":"query","description":"상품번호","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseGoodsStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 상품 별 주문(매출) 현황 그리드 엑셀 일괄 다운로드
> \## 기능설명\
> \* 상품 별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\
> \---\
> \## 상세 설명\
> \* 노출 항목은 그리드 목록과 동일 합니다.\
> \* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsStatusRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"agrtGb":{"type":"string","description":"집계구분"},"goodsNo":{"type":"string","description":"상품번호"},"entrNo":{"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/goodsStatus/downloadGoodsStatusExcel":{"get":{"tags":["주문 분석"],"summary":"상품 별 주문(매출) 현황 그리드 엑셀 일괄 다운로드","description":"## 기능설명\n* 상품 별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\n---\n## 상세 설명\n* 노출 항목은 그리드 목록과 동일 합니다.\n* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\n---\n## 수정 번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"downloadGoodsStatusExcel","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsStatusRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"goodsNo","in":"query","description":"상품번호","schema":{"type":"String"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}},{"name":"fileName","in":"query","description":"파일명","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"엑셀 다운로드 성공"},"900":{"description":"엑셀 다운로드 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 협력사 별 주문(매출) 현황 목록 조회
> \## 기능설명\
> \* 협력사 별 주문(매출) 현황 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* 매일 09시 기준으로 전날 집계를 수행합니다.\
> \* 협력사 별 주문(매출) 현황 목록을 조회합니다.\
> \* 집계 구분값으로 주문(01), 매출(02)여부를 구분합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EnterpriseStatusRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"agrtGb":{"type":"string","description":"집계구분"},"entrNo":{"type":"string","description":"협력사번호"}}},"RealGridListResponseEnterpriseStatusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/EnterpriseStatusResponse"}}}},"EnterpriseStatusResponse":{"type":"object","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"siteNm":{"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":"int64","description":"주문(배송완료)수량"},"cnclQty":{"type":"integer","format":"int64","description":"취소(반품완료)수량"},"finalOrdQty":{"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/enterpriseStatus/getEnterpriseStatusList":{"get":{"tags":["주문 분석"],"summary":"협력사 별 주문(매출) 현황 목록 조회","description":"## 기능설명\n* 협력사 별 주문(매출) 현황 목록을 조회합니다.\n---\n## 상세 설명\n* 매일 09시 기준으로 전날 집계를 수행합니다.\n* 협력사 별 주문(매출) 현황 목록을 조회합니다.\n* 집계 구분값으로 주문(01), 매출(02)여부를 구분합니다.\n---\n## 수정 번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"getEnterpriseStatusList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/EnterpriseStatusRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseEnterpriseStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 협력사 별 주문(매출) 현황 그리드 엑셀 일괄 다운로드
> \## 기능설명\
> \* 협력사 별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\
> \---\
> \## 상세 설명\
> \* 노출 항목은 그리드 목록과 동일 합니다.\
> \* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EnterpriseStatusRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"startDate":{"type":"string","format":"date","description":"조회기간(시작일)"},"endDate":{"type":"string","format":"date","description":"조회기간(종료일)"},"agrtGb":{"type":"string","description":"집계구분"},"entrNo":{"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/enterpriseStatus/downloadEnterpriseStatusExcel":{"get":{"tags":["주문 분석"],"summary":"협력사 별 주문(매출) 현황 그리드 엑셀 일괄 다운로드","description":"## 기능설명\n* 협력사 별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.\n---\n## 상세 설명\n* 노출 항목은 그리드 목록과 동일 합니다.\n* 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.\n---\n## 수정 번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"downloadEnterpriseStatusExcel","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/EnterpriseStatusRequest"}},{"name":"startDate","in":"query","description":"조회 시작일","required":true,"schema":{"type":"LocalDate"}},{"name":"endDate","in":"query","description":"조회 종료일","required":true,"schema":{"type":"LocalDate"}},{"name":"entrNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}},{"name":"fileName","in":"query","description":"파일명","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"엑셀 다운로드 성공"},"900":{"description":"엑셀 다운로드 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 카테고리별 주문(매출) 현황 목록 조회
> \## 기능설명\
> \* 카테고리별 주문(매출) 현황 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 매일 09시 기준으로 전날 집계를 수행합니다.\
> \* 카테고리별 주문(매출) 현황 목록을 조회합니다.\
> \* 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CategoryStatusRequest":{"type":"object","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 개수"}}},"RealGridListResponseCategoryStatusResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CategoryStatusResponse"}}}},"CategoryStatusResponse":{"type":"object","properties":{"stdCtgNo":{"type":"string","description":"표준 카테고리 번호"},"stdCtgNm":{"type":"string","description":"표준 카테고리명"},"siteNm":{"type":"string","description":"사이트명"},"mdId":{"type":"string","description":"담당MD"},"mdNm":{"type":"string","description":"담당MD"},"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":"순주문수량"}}},"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/categoryStatus/getCategoryStatusList":{"get":{"tags":["주문 분석"],"summary":"카테고리별 주문(매출) 현황 목록 조회","description":"## 기능설명\n* 카테고리별 주문(매출) 현황 목록을 조회합니다.\n---\n## 상세설명\n* 매일 09시 기준으로 전날 집계를 수행합니다.\n* 카테고리별 주문(매출) 현황 목록을 조회합니다.\n* 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.\n---\n## 수정번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"getCategoryStatusList_1","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CategoryStatusRequest"}},{"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":"결제수단코드(OM013)","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"MD ID","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCategoryStatusResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 카테고리별 주문(매출) 현황 목록 엑셀 다운로드
> \## 기능설명\
> \* 카테고리별 주문(매출) 현황 목록을 엑셀 다운로드합니다.\
> \---\
> \## 상세설명\
> \* 검색 조건에 해당하는 카테고리별 주문(매출) 현황 목록을 페이징 처리가 안된 데이터로 엑셀 다운로드 합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240827 : 최초 생성
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"CategoryStatusRequest":{"type":"object","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/categoryStatus/categoryStatusExcelDownload":{"get":{"tags":["주문 분석"],"summary":"카테고리별 주문(매출) 현황 목록 엑셀 다운로드","description":"## 기능설명\n* 카테고리별 주문(매출) 현황 목록을 엑셀 다운로드합니다.\n---\n## 상세설명\n* 검색 조건에 해당하는 카테고리별 주문(매출) 현황 목록을 페이징 처리가 안된 데이터로 엑셀 다운로드 합니다.\n---\n## 수정번호\n* Release v2.00_240827 : 최초 생성\n","operationId":"categoryStatusExcelDownload","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CategoryStatusRequest"}},{"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":"결제수단코드(OM013)","schema":{"type":"String"}},{"name":"mdId","in":"query","description":"MD ID","schema":{"type":"String"}},{"name":"agrtGb","in":"query","description":"집계구분","required":true,"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.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.