> 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/store-front-api/goods-api/undefined-2.md).
# 상품공급협력사
## 협력사 정보 조회
> \## 기능설명\
> \* 협력사 정보를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 협력사번호 배열 값으로 해당 협력사 정보 목록을 조회합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"VendorRequest":{"type":"object","description":"협력사 조회관련 조건 Request","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"entrNos":{"type":"array","default":"1000001","description":"협력사번호","items":{"type":"string"}}}},"VendorResponse":{"type":"object","description":"협력사 기본 Response","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"entrGbCd":{"type":"string","description":"협력사구분코드(VD001) 10:상품공급업자, 20:제휴사업자"},"entrGbCdNm":{"type":"string","description":"협력사구분코드명"},"latt":{"type":"string","description":"위도"},"lngt":{"type":"string","description":"경도"},"trdTypCd":{"type":"string","description":"거래유형코드(VD002) 10:직매입, 20:위탁판매, 30:제휴사"},"trdTypCdNm":{"type":"string","description":"거래유형코드명"},"trdStatCd":{"type":"string","description":"거래상태코드(VD003) 10:거래대기, 20:거래중, 30:거래종료"},"trdStatCdNm":{"type":"string","description":"거래상태코드명"},"lgcEntrNo":{"type":"string","description":"기간계협력사번호"},"rpstmnNm":{"type":"string","description":"대표자명"},"bmanNo":{"type":"string","description":"사업자등록번호"},"corpnNo":{"type":"string","description":"법인번호"},"btyp":{"type":"string","description":"업태"},"bkind":{"type":"string","description":"업종"},"contStrtDy":{"type":"string","description":"계약시작일자"},"contEndDy":{"type":"string","description":"계약종료일자"},"aempNm":{"type":"string","description":"담당자명"},"aempTelRgnNo":{"type":"string","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","description":"담당자휴대폰끝번호"},"faxRgnNo":{"type":"string","description":"팩스지역번호"},"faxTxnoNo":{"type":"string","description":"팩스국번번호"},"faxEndNo":{"type":"string","description":"팩스끝번호"},"bmanKindCd":{"type":"string","description":"사업자종류코드(VD004) 10:면세업자, 20:일반과세자"},"zipNoSeq":{"type":"string","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rmkCont":{"type":"string","description":"비고내용"},"mrgnRateGbCd":{"type":"string","description":"마진율구분코드(VD008) 10:고정마진, 20:구간마진"},"mrgnRateGbCdNm":{"type":"string","description":"마진율구분코드명"},"mrgnRate1":{"type":"string","description":"마진율1"},"mrgnRate2":{"type":"string","description":"마진율2"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/vendor/list":{"post":{"tags":["상품공급협력사"],"summary":"협력사 정보 조회","description":"## 기능설명\n* 협력사 정보를 조회하는 API 입니다.\n---\n## 상세설명\n* 협력사번호 배열 값으로 해당 협력사 정보 목록을 조회합니다.\n","operationId":"getEntrList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorRequest"}}},"required":true},"responses":{"200":{"description":"협력사 정보 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VendorResponse"}}}}},"900":{"description":"협력사 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 협력사 평가등급 조회
> \## 기능설명\
> \* 협력사 평가등급을 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 협력사번호에 따라 협력사의 '전월' 평가등급을 조회합니다.\
> \* 해당 업체의 월집계 테이블의 정보가 1건도 없을 시 (조회결과가 없는 경우)\
> \* '평가등급코드 = 우수' (VD009)\
> \* '통합점수 = 95'\
> \---\
> \## 수정번호\
> \* Release v2.00\_240613: FO 협력사 평가등급 조회 기능 신규 개발
```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"VendorEvltGradeResponse":{"type":"object","description":"협력사 평가등급 Response","properties":{"evltGradeCd":{"type":"string","description":"평가등급코드(VD009)"},"cmbnScr":{"type":"integer","format":"int32","description":"통합점수"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/vendor/getEvltGrade":{"get":{"tags":["상품공급협력사"],"summary":"협력사 평가등급 조회","description":"## 기능설명\n* 협력사 평가등급을 조회하는 API 입니다.\n---\n## 상세설명\n* 협력사번호에 따라 협력사의 '전월' 평가등급을 조회합니다.\n* 해당 업체의 월집계 테이블의 정보가 1건도 없을 시 (조회결과가 없는 경우)\n* '평가등급코드 = 우수' (VD009)\n* '통합점수 = 95'\n---\n## 수정번호\n* Release v2.00_240613: FO 협력사 평가등급 조회 기능 신규 개발\n","operationId":"getEvltGrade","parameters":[{"name":"entrNo","in":"query","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"협력사 평가등급 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/VendorEvltGradeResponse"}}}},"900":{"description":"협력사 평가등급 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
---
# 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/store-front-api/goods-api/undefined-2.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.