> 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-9.md).
# 판매자통계
## 협력사 판매등급 통계목록(월별)
> \## 기능설명\
> \* 월별로 협력사별 판매등급을 조회합니다.\
> \---\
> \## 상세설명\
> \* 월별로 협력사별 판매등급을 조회합니다.\
> \* 조회가 1년단위의 연도별 조회며, 현재 년을 기준으로 5년 전의 데이터까지 조회가 가능합니다.\
> \* 협력사/MD ID를 검색 조건에 추가를 할 수 있습니다..\
> \## 수정번호\
> \* Release v2.00\_240613: 판매등급 협력사별 월 통계 기능 신규 개발
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SalesGradeStatisticsRequest":{"type":"object","properties":{"period":{"type":"string","description":"기간(년도)"},"companyNo":{"type":"string","description":"협력사번호"},"companyName":{"type":"string","description":"협력사명"},"periodMonth":{"type":"string","description":"기간(년도월)"},"mdUserId":{"type":"string","description":"MD ID"},"partnerNoList":{"type":"array","description":"협력사번호List","items":{"type":"string"}}}},"RealGridListResponseSalesGradeStatisticsResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SalesGradeStatisticsResponse"}}}},"SalesGradeStatisticsResponse":{"type":"object","properties":{"companyNo":{"type":"string","description":"협력사번호"},"companyName":{"type":"string","description":"협력사명"},"items":{"type":"string","description":"평가항목"},"period":{"type":"string","description":"기간"},"yearAverage":{"type":"string","description":"연평균"},"jan":{"type":"string","description":"1월"},"feb":{"type":"string","description":"2월"},"mar":{"type":"string","description":"3월"},"apr":{"type":"string","description":"4월"},"may":{"type":"string","description":"5월"},"jun":{"type":"string","description":"6월"},"jul":{"type":"string","description":"7월"},"aug":{"type":"string","description":"8월"},"sep":{"type":"string","description":"9월"},"oct":{"type":"string","description":"10월"},"nov":{"type":"string","description":"11월"},"dec":{"type":"string","description":"12월"},"gradeCd":{"type":"string","description":"등급코드"},"janColor":{"type":"string","description":"1월 색상"},"febColor":{"type":"string","description":"2월 색상"},"marColor":{"type":"string","description":"3월 색상"},"aprColor":{"type":"string","description":"4월 색상"},"mayColor":{"type":"string","description":"5월 색상"},"junColor":{"type":"string","description":"6월 색상"},"julColor":{"type":"string","description":"7월 색상"},"augColor":{"type":"string","description":"8월 색상"},"sepColor":{"type":"string","description":"9월 색상"},"octColor":{"type":"string","description":"10월 색상"},"novColor":{"type":"string","description":"11월 색상"},"decColor":{"type":"string","description":"12월 색상"}}},"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/seller/searchSalesGradeStatisticsMonth":{"get":{"tags":["판매자통계"],"summary":"협력사 판매등급 통계목록(월별)","description":" ## 기능설명\n * 월별로 협력사별 판매등급을 조회합니다.\n ---\n ## 상세설명\n * 월별로 협력사별 판매등급을 조회합니다.\n * 조회가 1년단위의 연도별 조회며, 현재 년을 기준으로 5년 전의 데이터까지 조회가 가능합니다.\n * 협력사/MD ID를 검색 조건에 추가를 할 수 있습니다..\n ## 수정번호\n * Release v2.00_240613: 판매등급 협력사별 월 통계 기능 신규 개발\n","operationId":"searchSalesGradeStatisticsMonth","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SalesGradeStatisticsRequest"}},{"name":"periodMonth","in":"query","description":"조회기간","required":true,"schema":{"type":"String"}},{"name":"companyNo","in":"query","description":"협력사번호","schema":{"type":"String"}},{"name":"mdUserId","in":"query","description":"담당 MD","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSalesGradeStatisticsResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 판매등급 일자별 통계현황(그리드)
> \## 기능설명\
> \* 협력사 판매등급 통계목록(월별)에서 특정월의 상세 현황을 조회할때 사용을 합니다.\
> \---\
> \## 상세설명\
> \* 통합점수로만 노출되던 부분을 출고준수, 주문이행, 답변리드타임. 3가지의 항복으로 세분화 하여 확인합니다.\
> \## 수정번호\
> \* Release v2.00\_240613: 판매등급 월별 통계현황 기능 신규 개발
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SalesGradeStatisticsRequest":{"type":"object","properties":{"period":{"type":"string","description":"기간(년도)"},"companyNo":{"type":"string","description":"협력사번호"},"companyName":{"type":"string","description":"협력사명"},"periodMonth":{"type":"string","description":"기간(년도월)"},"mdUserId":{"type":"string","description":"MD ID"},"partnerNoList":{"type":"array","description":"협력사번호List","items":{"type":"string"}}}},"RealGridListResponseSalesGradeStatisticsResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SalesGradeStatisticsResponse"}}}},"SalesGradeStatisticsResponse":{"type":"object","properties":{"companyNo":{"type":"string","description":"협력사번호"},"companyName":{"type":"string","description":"협력사명"},"items":{"type":"string","description":"평가항목"},"period":{"type":"string","description":"기간"},"yearAverage":{"type":"string","description":"연평균"},"jan":{"type":"string","description":"1월"},"feb":{"type":"string","description":"2월"},"mar":{"type":"string","description":"3월"},"apr":{"type":"string","description":"4월"},"may":{"type":"string","description":"5월"},"jun":{"type":"string","description":"6월"},"jul":{"type":"string","description":"7월"},"aug":{"type":"string","description":"8월"},"sep":{"type":"string","description":"9월"},"oct":{"type":"string","description":"10월"},"nov":{"type":"string","description":"11월"},"dec":{"type":"string","description":"12월"},"gradeCd":{"type":"string","description":"등급코드"},"janColor":{"type":"string","description":"1월 색상"},"febColor":{"type":"string","description":"2월 색상"},"marColor":{"type":"string","description":"3월 색상"},"aprColor":{"type":"string","description":"4월 색상"},"mayColor":{"type":"string","description":"5월 색상"},"junColor":{"type":"string","description":"6월 색상"},"julColor":{"type":"string","description":"7월 색상"},"augColor":{"type":"string","description":"8월 색상"},"sepColor":{"type":"string","description":"9월 색상"},"octColor":{"type":"string","description":"10월 색상"},"novColor":{"type":"string","description":"11월 색상"},"decColor":{"type":"string","description":"12월 색상"}}},"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/seller/getSalesGradePartnerCompanyDetail":{"get":{"tags":["판매자통계"],"summary":"판매등급 일자별 통계현황(그리드)","description":" ## 기능설명\n * 협력사 판매등급 통계목록(월별)에서 특정월의 상세 현황을 조회할때 사용을 합니다.\n ---\n ## 상세설명\n * 통합점수로만 노출되던 부분을 출고준수, 주문이행, 답변리드타임. 3가지의 항복으로 세분화 하여 확인합니다.\n ## 수정번호\n * Release v2.00_240613: 판매등급 월별 통계현황 기능 신규 개발\n","operationId":"getSalesGradePartnerCompanyDetail","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SalesGradeStatisticsRequest"}},{"name":"companyNo","in":"query","description":"협력사번호","required":true,"schema":{"type":"String"}},{"name":"period","in":"query","description":"조회기간(시작년월)","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSalesGradeStatisticsResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 판매등급 일자별 통계현황(그리드)
> \## 기능설명\
> \* 평가항목별 통계목록에서 월별의 데이터를 일자로 확인을 가능합게 노출합니다.\
> \---\
> \## 상세설명\
> \* 일자별 집계형환 테이블에서 누적된 데이터를 만들어서 보여줍니다.\
> \## 수정번호\
> \* Release v2.00\_240613: 판매등급 일자별 통계 기능 신규 개발
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SalesGradeStatisticsRequest":{"type":"object","properties":{"period":{"type":"string","description":"기간(년도)"},"companyNo":{"type":"string","description":"협력사번호"},"companyName":{"type":"string","description":"협력사명"},"periodMonth":{"type":"string","description":"기간(년도월)"},"mdUserId":{"type":"string","description":"MD ID"},"partnerNoList":{"type":"array","description":"협력사번호List","items":{"type":"string"}}}},"RealGridListResponseSalesGradeDetailStatisticsResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SalesGradeDetailStatisticsResponse"}}}},"SalesGradeDetailStatisticsResponse":{"type":"object","properties":{"period":{"type":"string","description":"기간"},"gradeIntergratedScore":{"type":"string","description":"통합점수"},"gradeShipScore":{"type":"string","description":"출고준수"},"gradeOrdScore":{"type":"string","description":"주문이행"},"gradeAnswerScore":{"type":"string","description":"답변리드타임"},"gradeShipScoreColor":{"type":"string","description":"출고준수색상"},"gradeOrdScoreColor":{"type":"string","description":"주문이행색상"},"gradeAnswerScoreColor":{"type":"string","description":"답변리드타임색상"},"gradeIntergratedScoreColor":{"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/seller/getSalesGradePartnerCompanyDetailOfDay":{"get":{"tags":["판매자통계"],"summary":"판매등급 일자별 통계현황(그리드)","description":" ## 기능설명\n * 평가항목별 통계목록에서 월별의 데이터를 일자로 확인을 가능합게 노출합니다.\n ---\n ## 상세설명\n * 일자별 집계형환 테이블에서 누적된 데이터를 만들어서 보여줍니다.\n ## 수정번호\n * Release v2.00_240613: 판매등급 일자별 통계 기능 신규 개발\n","operationId":"getSalesGradePartnerCompanyDetailOfDay","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SalesGradeStatisticsRequest"}},{"name":"companyNo","in":"query","description":"협력사번호","required":true,"schema":{"type":"String"}},{"name":"periodMonth","in":"query","description":"조회기간(시작년월)","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSalesGradeDetailStatisticsResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```