> 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/api-en/store-front-api-reference/goods-api/product-supply-vendor.md).

# Product Supply Vendor

## Vendor Information Retrieval

> \## Function Description\
> \* This API retrieves partner information.\
> \---\
> \## Detailed Description\
> \* Retrieves the list of partner information corresponding to the given array of partner numbers.<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":"Partner Inquiry Condition Request","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No."},"entrNos":{"type":"array","default":"1000001","description":"Vendor No.","items":{"type":"string"}}}},"VendorResponse":{"type":"object","description":"Partner Basic Response","properties":{"entrNo":{"type":"string","description":"Vendor No."},"entrNm":{"type":"string","description":"Vendor Name"},"entrGbCd":{"type":"string","description":"Vendor Classification Code (VD001) 10: Product Supplier, 20: Affiliate Partner"},"entrGbCdNm":{"type":"string","description":"Vendor Type Code Name"},"latt":{"type":"string","description":"Latitude"},"lngt":{"type":"string","description":"Longitude"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002) 10: Direct Purchase, 20: Consignment Sale, 30: Affiliate"},"trdTypCdNm":{"type":"string","description":"Transaction Type Code Name"},"trdStatCd":{"type":"string","description":"Transaction Status Code (VD003) 10: Pending Transaction, 20: In Transaction, 30: Transaction Ended"},"trdStatCdNm":{"type":"string","description":"Transaction Status Code Name"},"lgcEntrNo":{"type":"string","description":"Core System Vendor No."},"rpstmnNm":{"type":"string","description":"Representative Name"},"bmanNo":{"type":"string","description":"Business Registration No."},"corpnNo":{"type":"string","description":"Corporate Registration No."},"btyp":{"type":"string","description":"Business Type"},"bkind":{"type":"string","description":"Business Category"},"contStrtDy":{"type":"string","description":"Contract Start Date"},"contEndDy":{"type":"string","description":"Contract End Date"},"aempNm":{"type":"string","description":"Person in Charge Name"},"aempTelRgnNo":{"type":"string","description":"Contact Person's Phone Area Code"},"aempTelTxnoNo":{"type":"string","description":"Contact Person's Phone Exchange Code"},"aempTelEndNo":{"type":"string","description":"Contact Person's Phone Last Digits"},"aempCellSctNo":{"type":"string","description":"Contact Person's Mobile Phone Prefix Code"},"aempCellTxnoNo":{"type":"string","description":"Contact Person's Mobile Phone Exchange Code"},"aempCellEndNo":{"type":"string","description":"Contact Person's Mobile Phone Last Digits"},"faxRgnNo":{"type":"string","description":"Fax Area Code"},"faxTxnoNo":{"type":"string","description":"Fax Exchange Code"},"faxEndNo":{"type":"string","description":"Fax Last Digits"},"bmanKindCd":{"type":"string","description":"Business Type Code (VD004) 10: Tax-Exempt Business, 20: General Taxable Business"},"zipNoSeq":{"type":"string","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"rmkCont":{"type":"string","description":"Remarks"},"mrgnRateGbCd":{"type":"string","description":"Margin Rate Classification Code (VD008) 10: Fixed Margin, 20: Tiered Margin"},"mrgnRateGbCdNm":{"type":"string","description":"Margin Rate Type Code Name"},"mrgnRate1":{"type":"string","description":"Margin Rate 1"},"mrgnRate2":{"type":"string","description":"Margin Rate 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":["Product Supply Vendor"],"summary":"Vendor Information Retrieval","description":"## Function Description\n* This API retrieves partner information.\n---\n## Detailed Description\n* Retrieves the list of partner information corresponding to the given array of partner numbers.\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":"Vendor Information Retrieved Successfully","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VendorResponse"}}}}},"900":{"description":"Vendor Information Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Partner Rating Grade

> \## Function Description\
> \* This API retrieves the partner rating grade.\
> \---\
> \## Detailed Description\
> \* Retrieves the 'previous month' rating grade of the partner according to the partner number.\
> \* If there is not even a single record in the monthly aggregate table for the partner (i.e., no inquiry results)\
> \* 'Rating Grade Code = Excellent' (VD009)\
> \* 'Overall Score = 95'\
> \---\
> \## Revision History\
> \* Release v2.00\_240613: Newly developed the FO partner rating grade inquiry feature<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":"Partner Rating Grade Response","properties":{"evltGradeCd":{"type":"string","description":"Rating Grade Code (VD009)"},"cmbnScr":{"type":"integer","format":"int32","description":"Integrated Score"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/vendor/getEvltGrade":{"get":{"tags":["Product Supply Vendor"],"summary":"Retrieve Partner Rating Grade","description":"## Function Description\n* This API retrieves the partner rating grade.\n---\n## Detailed Description\n* Retrieves the 'previous month' rating grade of the partner according to the partner number.\n* If there is not even a single record in the monthly aggregate table for the partner (i.e., no inquiry results)\n* 'Rating Grade Code = Excellent' (VD009)\n* 'Overall Score = 95'\n---\n## Revision History\n* Release v2.00_240613: Newly developed the FO partner rating grade inquiry feature\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":"Partner Rating Grade Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/VendorEvltGradeResponse"}}}},"900":{"description":"Partner Rating Grade Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```