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