> 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/popup-bo-api/undefined-11.md).

# 협력사 공통 팝업

## 협력사 목록 조회

> \## 기능설명\
> \* 협력사 목록 조회 API 입니다.\
> \---\
> \## 상세설명\
> \* 협력사 정보 목록을 조회합니다.\
> &#x20;   \* 협력사 번호 내림차순으로 정렬합니다.<br>

```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":{"ResponseRealGridListResponseEnEntrBaseResponse":{"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":{"$ref":"#/components/schemas/RealGridListResponseEnEntrBaseResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseEnEntrBaseResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/EnEntrBaseResponse"}}}},"EnEntrBaseResponse":{"type":"object","description":"협력사 기본 정보 Response","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"entrGbCd":{"type":"string","description":"협력사구분코드(VD001) 10:상품공급업자, 20:제휴사업자"},"latt":{"type":"number","format":"double","description":"위도"},"lngt":{"type":"number","format":"double","description":"경도"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002) 10:직매입, 20:위탁판매, 30:제휴사"},"buyTypCdNm":{"type":"string","description":"매입형태코드명"},"trdStatCd":{"type":"string","description":"거래상태코드(VD003) 10:거래대기, 20:거래중, 30:거래종료"},"lgcEntrNo":{"type":"string","description":"기간계협력사번호"},"rpstmnNm":{"type":"string","description":"대표자명"},"bmanNo":{"type":"string","description":"사업자번호"},"bmanKindNm":{"type":"string","description":"사업자종류코드명"},"corpnNo":{"type":"string","description":"법인번호"},"btyp":{"type":"string","description":"업태"},"bkind":{"type":"string","description":"업종"},"contStrtDy":{"type":"string","format":"date","description":"계약시작일자"},"contEndDy":{"type":"string","format":"date","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":"integer","format":"int64","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rmkCont":{"type":"string","description":"비고내용"},"mrgnRateGbCd":{"type":"string","description":"마진율구분코드(VD008) 10:고정마진, 20:구간마진"},"mrgnRate1":{"type":"number","description":"마진율1"},"mrgnRate2":{"type":"number","description":"마진율2"},"singleMrgnRate":{"type":"number","description":"단일마진율"},"intervalMrgnRate1":{"type":"number","description":"구간마진율1"},"intervalMrgnRate2":{"type":"number","description":"구간마진율2"},"ecpnUseYn":{"type":"string","description":"e쿠폰사용여부"},"ecpnLinkGbCd":{"type":"string","description":"E쿠폰연동구분코드"},"ecpnLinkGbNm":{"type":"string","description":"E쿠폰연동구분명"},"entrGbNm":{"type":"string","description":"협력사구분명"},"trdStatNm":{"type":"string","description":"거래상태명"},"itmSaleStatCd":{"type":"string","description":"단품판매상태","enum":["TEMPORARY_STORAGE","WAITING_FOR_APPROVAL","COMPANION","SALES","SOLD_OUT","SALE_END"]},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드","enum":["SALES","SOLD_OUT","SUSPEND","SALE_END","PARTNER_SALE_END"]},"rtGrpNo":{"type":"string","description":"권한그룹번호"},"endPage":{"type":"boolean","description":"마지막페이지 여부"},"totalCount":{"type":"integer","format":"int32","description":"총 개수"},"endPartnerSaleAndAuthGroup":{"type":"string","writeOnly":true}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/popup/enteranceMgmt/getEtEntrBaseList":{"get":{"tags":["협력사 공통 팝업"],"summary":"협력사 목록 조회","description":"## 기능설명\n* 협력사 목록 조회 API 입니다.\n---\n## 상세설명\n* 협력사 정보 목록을 조회합니다.\n    * 협력사 번호 내림차순으로 정렬합니다.\n","operationId":"getEtEntrBaseList","parameters":[{"name":"entrGbCd","in":"query","description":"협력사구분코드(VD001)","required":true,"schema":{"type":"string"}},{"name":"trdStatCd","in":"query","description":"거래상태코드(VD003)","required":true,"schema":{"type":"string"}},{"name":"entrNo","in":"query","description":"협력사번호","required":true,"schema":{"type":"string"}},{"name":"entrNm","in":"query","description":"협력사명","required":true,"schema":{"type":"string"}},{"name":"trdTypCd","in":"query","description":"거래형태코드(VD002)","schema":{"type":"string"}}],"responses":{"200":{"description":"협력사 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseEnEntrBaseResponse"}}}},"900":{"description":"협력사 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```