> 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 입니다.\
> \---\
> \## 상세설명\
> \* 협력사 정보 목록을 조회합니다.\
> \* 협력사 번호 내림차순으로 정렬합니다.
```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"}}}}}}}}}
```
---
# 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/popup-bo-api/undefined-11.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.