> 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"}}}}}}}}}
```
---
# 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-9.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.