> 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 입니다.\
> \---\
> \## 상세설명\
> \* 협력사번호 배열 값으로 해당 협력사 정보 목록을 조회합니다.<br>

```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 협력사 평가등급 조회 기능 신규 개발<br>

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