> 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.md).

# 협력사 팝업

## 협력사 정보 수정

> \## 기능설명\
> \* 협력사 정보 수정 API 입니다.\
> \---\
> \## 상세설명\
> \* 협력사 정보를 수정합니다.\
> &#x9;\* 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 수정합니다.\
> \---\
> \## 검증내용\
> \* 수정 시 협력사 정보의 유효성을 검증합니다.\
> &#x9;\* 협력사명은 중복이 불가합니다.\
> \* 수정 시 담당자 정보의 유효성을 검증합니다.\
> &#x9;\* 추가, 수정 필수 입력: 직무코드, 담당자명\
> &#x9;\* 삭제 필수 입력: 담당자 순번\
> \* 수정 시 배송정책 정보의 유효성을 검증합니다.\
> &#x9;\* 추가, 수정 필수 입력: 협력사번호, 배송비금액, 배송비형태, 기준금액, 회수반품비, 교환배송비\
> &#x9;\* 삭제 필수 입력: 협력사 번호\
> \* 수정 시 배송지 정보의 유효성을 검증합니다.\
> &#x9;\* 추가, 수정 필수 입력: 협력사번호, 배송지명, 우편번호순번, 상세주소, 휴대폰번호\
> &#x9;\* 삭제 필수 입력: 협력사배송지번호<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":{"SaveVendorWithOtherDataRequest":{"type":"object","description":"협력사 정보 저장 Request","properties":{"createEtEntrAempInfoList":{"type":"array","description":"협력사담당자정보 Create List","items":{"$ref":"#/components/schemas/EtEntrAempInfo"}},"updateEtEntrAempInfoList":{"type":"array","description":"협력사담당자정보 Update List","items":{"$ref":"#/components/schemas/EtEntrAempInfo"}},"deleteEtEntrAempInfoList":{"type":"array","description":"협력사담당자정보 Delete List","items":{"$ref":"#/components/schemas/EtEntrAempInfo"}},"createEtDeliPolcBaseList":{"type":"array","description":"배송정책기본 Create List","items":{"$ref":"#/components/schemas/EtDeliPolcBase"}},"updateEtDeliPolcBaseList":{"type":"array","description":"배송정책기본 Update List","items":{"$ref":"#/components/schemas/EtDeliPolcBase"}},"deleteEtDeliPolcBaseList":{"type":"array","description":"배송정책기본 Delete List","items":{"$ref":"#/components/schemas/EtDeliPolcBase"}},"createEtEntrDlvpInfoList":{"type":"array","description":"협력사배송지정보 Create List","items":{"$ref":"#/components/schemas/EtEntrDlvpInfo"}},"updateEtEntrDlvpInfoList":{"type":"array","description":"협력사배송지정보 Update List","items":{"$ref":"#/components/schemas/EtEntrDlvpInfo"}},"deleteEtEntrDlvpInfoList":{"type":"array","description":"협력사배송지정보 Delete List","items":{"$ref":"#/components/schemas/EtEntrDlvpInfo"}},"etEntrBase":{"$ref":"#/components/schemas/EtEntrBase","description":"협력사기본"}}},"EtEntrAempInfo":{"type":"object","description":"협력사담당자정보","properties":{"entrNo":{"type":"string","default":"1000002","description":"협력사번호"},"aempSeq":{"type":"integer","format":"int64","default":1,"description":"담당자순번"},"dutyCd":{"type":"string","description":"직무코드(VD006) 01:영업, 02:회계"},"aempNm":{"type":"string","default":"엑스투비","description":"담당자명"},"telRgnNo":{"type":"string","default":"02","description":"전화지역번호"},"telTxnoNo":{"type":"string","default":"554","description":"전화국번번호"},"telEndNo":{"type":"string","default":"4668","description":"전화끝번호"},"cellSctNo":{"type":"string","default":"010","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","default":"1111","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","default":"1111","description":"휴대폰끝번호"},"emailAddr":{"type":"string","default":"x2bee@plateer.com","description":"이메일주소"}}},"EtDeliPolcBase":{"type":"object","description":"배송정책기본","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005) 10:무료, 20:유료, 30:조건부무료"},"stdAmt":{"type":"integer","format":"int32","description":"기준금액"},"dlexAmt":{"type":"number","description":"배송비금액"},"wthdRtnAmt":{"type":"number","description":"회수반품비"},"exchDlex":{"type":"integer","format":"int32","description":"교환배송비"},"addDlexAmt":{"type":"integer","format":"int32","description":"추가배송비금액"},"useYn":{"type":"string","description":"사용여부"},"goodsCnt":{"type":"integer","format":"int32","description":"등록상품수"},"deliRegnGrpNo":{"type":"string","description":"배송지역그룹번호"}}},"EtEntrDlvpInfo":{"type":"object","description":"협력사배송지정보","properties":{"entrDlvpNo":{"type":"string","default":"10000000","description":"협력사배송지번호"},"entrNo":{"type":"string","default":"1000002","description":"협력사번호"},"dlvpTypCd":{"type":"string","default":"10","description":"배송지유형코드(VD007) 10:출고지, 20:반품지"},"dlvpNm":{"type":"string","default":"배송지명","description":"배송지명"},"useYn":{"type":"string","default":"Y","description":"사용여부"},"zipNoSeq":{"type":"integer","format":"int64","default":5836,"description":"우편번호순번"},"zipNo":{"type":"string","default":"05836","description":"우편번호"},"zipAddr":{"type":"string","default":"우편주소","description":"우편주소"},"dtlAddr":{"type":"string","default":"상세주소","description":"상세주소"},"utakmnNm":{"type":"string","default":"담당자명","description":"담당자명"},"aempTelRgnNo":{"type":"string","default":"02","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","default":"554","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","default":"4668","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","default":"010","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","default":"1111","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","default":"1111","description":"담당자휴대폰끝번호"}}},"EtEntrBase":{"type":"object","description":"협력사기본","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":"권한그룹번호"},"endPartnerSaleAndAuthGroup":{"type":"string","writeOnly":true}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/popup/partnerMgmt/updateVendorWithOtherData":{"put":{"tags":["협력사 팝업"],"summary":"협력사 정보 수정","description":"## 기능설명\n* 협력사 정보 수정 API 입니다.\n---\n## 상세설명\n* 협력사 정보를 수정합니다.\n\t* 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 수정합니다.\n---\n## 검증내용\n* 수정 시 협력사 정보의 유효성을 검증합니다.\n\t* 협력사명은 중복이 불가합니다.\n* 수정 시 담당자 정보의 유효성을 검증합니다.\n\t* 추가, 수정 필수 입력: 직무코드, 담당자명\n\t* 삭제 필수 입력: 담당자 순번\n* 수정 시 배송정책 정보의 유효성을 검증합니다.\n\t* 추가, 수정 필수 입력: 협력사번호, 배송비금액, 배송비형태, 기준금액, 회수반품비, 교환배송비\n\t* 삭제 필수 입력: 협력사 번호\n* 수정 시 배송지 정보의 유효성을 검증합니다.\n\t* 추가, 수정 필수 입력: 협력사번호, 배송지명, 우편번호순번, 상세주소, 휴대폰번호\n\t* 삭제 필수 입력: 협력사배송지번호\n","operationId":"updateVendorWithOtherData","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveVendorWithOtherDataRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}}}}}}}
```

## 협력사 정보 저장

> \## 기능설명\
> \* 협력사 정보 저장 API 입니다.\
> \---\
> \## 상세설명\
> \* 협력사 정보를 저장합니다.\
> \* 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 저장합니다.\
> &#x20;        \---\
> &#x20;        \## 수정번호\
> &#x20;        \* Release v2.00\_240627: 추가 배송비 정보 등록 기능 추가\
> \---\
> \## 검증내용\
> \* 저장 시 협력사 정보의 유효성을 검증합니다.\
> &#x9;\* 협력사명은 중복이 불가합니다.\
> &#x9;\* 필수 입력: 협력사명, 사업자종류코드, 사업자번호, 거래형태코드, 거래상태코드, 계약시작일자, 계약종료일자, 담당자휴대폰번호, 대표자명, 우편번호순번, 우편번호, 우편주소, 상세주소<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":{"SaveVendorWithOtherDataRequest":{"type":"object","description":"협력사 정보 저장 Request","properties":{"createEtEntrAempInfoList":{"type":"array","description":"협력사담당자정보 Create List","items":{"$ref":"#/components/schemas/EtEntrAempInfo"}},"updateEtEntrAempInfoList":{"type":"array","description":"협력사담당자정보 Update List","items":{"$ref":"#/components/schemas/EtEntrAempInfo"}},"deleteEtEntrAempInfoList":{"type":"array","description":"협력사담당자정보 Delete List","items":{"$ref":"#/components/schemas/EtEntrAempInfo"}},"createEtDeliPolcBaseList":{"type":"array","description":"배송정책기본 Create List","items":{"$ref":"#/components/schemas/EtDeliPolcBase"}},"updateEtDeliPolcBaseList":{"type":"array","description":"배송정책기본 Update List","items":{"$ref":"#/components/schemas/EtDeliPolcBase"}},"deleteEtDeliPolcBaseList":{"type":"array","description":"배송정책기본 Delete List","items":{"$ref":"#/components/schemas/EtDeliPolcBase"}},"createEtEntrDlvpInfoList":{"type":"array","description":"협력사배송지정보 Create List","items":{"$ref":"#/components/schemas/EtEntrDlvpInfo"}},"updateEtEntrDlvpInfoList":{"type":"array","description":"협력사배송지정보 Update List","items":{"$ref":"#/components/schemas/EtEntrDlvpInfo"}},"deleteEtEntrDlvpInfoList":{"type":"array","description":"협력사배송지정보 Delete List","items":{"$ref":"#/components/schemas/EtEntrDlvpInfo"}},"etEntrBase":{"$ref":"#/components/schemas/EtEntrBase","description":"협력사기본"}}},"EtEntrAempInfo":{"type":"object","description":"협력사담당자정보","properties":{"entrNo":{"type":"string","default":"1000002","description":"협력사번호"},"aempSeq":{"type":"integer","format":"int64","default":1,"description":"담당자순번"},"dutyCd":{"type":"string","description":"직무코드(VD006) 01:영업, 02:회계"},"aempNm":{"type":"string","default":"엑스투비","description":"담당자명"},"telRgnNo":{"type":"string","default":"02","description":"전화지역번호"},"telTxnoNo":{"type":"string","default":"554","description":"전화국번번호"},"telEndNo":{"type":"string","default":"4668","description":"전화끝번호"},"cellSctNo":{"type":"string","default":"010","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","default":"1111","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","default":"1111","description":"휴대폰끝번호"},"emailAddr":{"type":"string","default":"x2bee@plateer.com","description":"이메일주소"}}},"EtDeliPolcBase":{"type":"object","description":"배송정책기본","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005) 10:무료, 20:유료, 30:조건부무료"},"stdAmt":{"type":"integer","format":"int32","description":"기준금액"},"dlexAmt":{"type":"number","description":"배송비금액"},"wthdRtnAmt":{"type":"number","description":"회수반품비"},"exchDlex":{"type":"integer","format":"int32","description":"교환배송비"},"addDlexAmt":{"type":"integer","format":"int32","description":"추가배송비금액"},"useYn":{"type":"string","description":"사용여부"},"goodsCnt":{"type":"integer","format":"int32","description":"등록상품수"},"deliRegnGrpNo":{"type":"string","description":"배송지역그룹번호"}}},"EtEntrDlvpInfo":{"type":"object","description":"협력사배송지정보","properties":{"entrDlvpNo":{"type":"string","default":"10000000","description":"협력사배송지번호"},"entrNo":{"type":"string","default":"1000002","description":"협력사번호"},"dlvpTypCd":{"type":"string","default":"10","description":"배송지유형코드(VD007) 10:출고지, 20:반품지"},"dlvpNm":{"type":"string","default":"배송지명","description":"배송지명"},"useYn":{"type":"string","default":"Y","description":"사용여부"},"zipNoSeq":{"type":"integer","format":"int64","default":5836,"description":"우편번호순번"},"zipNo":{"type":"string","default":"05836","description":"우편번호"},"zipAddr":{"type":"string","default":"우편주소","description":"우편주소"},"dtlAddr":{"type":"string","default":"상세주소","description":"상세주소"},"utakmnNm":{"type":"string","default":"담당자명","description":"담당자명"},"aempTelRgnNo":{"type":"string","default":"02","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","default":"554","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","default":"4668","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","default":"010","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","default":"1111","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","default":"1111","description":"담당자휴대폰끝번호"}}},"EtEntrBase":{"type":"object","description":"협력사기본","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":"권한그룹번호"},"endPartnerSaleAndAuthGroup":{"type":"string","writeOnly":true}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/popup/partnerMgmt/saveVendorWithOtherData":{"post":{"tags":["협력사 팝업"],"summary":"협력사 정보 저장","description":"## 기능설명\n* 협력사 정보 저장 API 입니다.\n---\n## 상세설명\n* 협력사 정보를 저장합니다.\n* 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 저장합니다.\n         ---\n         ## 수정번호\n         * Release v2.00_240627: 추가 배송비 정보 등록 기능 추가\n---\n## 검증내용\n* 저장 시 협력사 정보의 유효성을 검증합니다.\n\t* 협력사명은 중복이 불가합니다.\n\t* 필수 입력: 협력사명, 사업자종류코드, 사업자번호, 거래형태코드, 거래상태코드, 계약시작일자, 계약종료일자, 담당자휴대폰번호, 대표자명, 우편번호순번, 우편번호, 우편주소, 상세주소\n","operationId":"saveVendorWithOtherData","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveVendorWithOtherDataRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}}}}}}}
```

## 협력사 정보 조회

> &#x20;  \## 기능설명\
> &#x20;  \* 협력사 번호 기준으로 거래대기,거래중 협력사중 사업자 번호 중복여부를 조회합니다.\
> &#x20;  \## 상세설명\
> &#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":{"ResponseBoolean":{"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":{"type":"boolean","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/popup/partnerMgmt/isDuplicateWithBusinessNo":{"get":{"tags":["협력사 팝업"],"summary":"협력사 정보 조회","description":"   ## 기능설명\n   * 협력사 번호 기준으로 거래대기,거래중 협력사중 사업자 번호 중복여부를 조회합니다.\n   ## 상세설명\n   * 협력사 번호 기준으로 거래대기,거래중 협력사중 사업자 번호 중복여부를 조회합니다.\n","operationId":"isDuplicateWithBusinessNo","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseBoolean"}}}}}}}}}
```

## 협력사 정보 조회

> &#x20;  \## 기능설명\
> &#x20;  \* 협력사 번호 기준으로 협력사 정보를 조회합니다.\
> &#x20;  \## 상세설명\
> &#x20;  \* 협력사 번호 기준으로 협력사 정보를 조회합니다.\
> &#x20;  \* 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보, 등록된 사업자번호 목록을 조회합니다.\
> &#x20;        \---\
> &#x20;        \## 수정번호\
> &#x20;        \* Release v2.00\_240627: 배송비 정책 정보 조회 시 추가 배송비 조회 추가\
> &#x20;  \---\
> &#x20;  \## 특이사항\
> &#x20;  \* 등록된 협력사의 사업자 번호를 조회하여 저장 시, 사업자 번호 중복 체크에 사용합니다.\
> &#x20;  \---\
> &#x20;  \## 코드정리\
> &#x20;  \* \`\`\` 선택구분 \`\`\` : C:등록, RU:상세조회 및 수정<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":{"ResponsePartnerCruPopupResponseEx":{"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/PartnerCruPopupResponseEx","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PartnerCruPopupResponseEx":{"type":"object","properties":{"etEntrBase":{"$ref":"#/components/schemas/EtEntrBase","description":"협력사정보"},"etDeliPolcBaseList":{"type":"array","description":"배송비정책정보 목록","items":{"$ref":"#/components/schemas/EtDeliPolcBase"}},"etEntrAempInfoList":{"type":"array","description":"담당자정보 목록","items":{"$ref":"#/components/schemas/CooperateEmployeeSearchResponse"}},"etEntrDlvpInfoList":{"type":"array","description":"배송지정보 목록","items":{"$ref":"#/components/schemas/CooperateDeliveryInfoResponse"}},"bmanNoList":{"type":"array","description":"등록된 사업자번호 목록","items":{"type":"string"}}}},"EtEntrBase":{"type":"object","description":"협력사기본","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":"권한그룹번호"},"endPartnerSaleAndAuthGroup":{"type":"string","writeOnly":true}}},"EtDeliPolcBase":{"type":"object","description":"배송정책기본","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005) 10:무료, 20:유료, 30:조건부무료"},"stdAmt":{"type":"integer","format":"int32","description":"기준금액"},"dlexAmt":{"type":"number","description":"배송비금액"},"wthdRtnAmt":{"type":"number","description":"회수반품비"},"exchDlex":{"type":"integer","format":"int32","description":"교환배송비"},"addDlexAmt":{"type":"integer","format":"int32","description":"추가배송비금액"},"useYn":{"type":"string","description":"사용여부"},"goodsCnt":{"type":"integer","format":"int32","description":"등록상품수"},"deliRegnGrpNo":{"type":"string","description":"배송지역그룹번호"}}},"CooperateEmployeeSearchResponse":{"type":"object","description":"담당자정보","properties":{"entrNo":{"type":"string","description":"협력사번호"},"aempSeq":{"type":"integer","format":"int64","description":"담당자순번"},"dutyCd":{"type":"string","description":"직무코드(VD006) 01:영업, 02:회계"},"aempNm":{"type":"string","description":"담당자명"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"emailAddr":{"type":"string","description":"이메일주소"},"telNo":{"type":"string","description":"전화번호"},"cellNo":{"type":"string","description":"휴대폰전화번호"}}},"CooperateDeliveryInfoResponse":{"type":"object","description":"배송지정보","properties":{"entrDlvpNo":{"type":"string","description":"협력사배송지번호"},"entrNo":{"type":"string","description":"협력사번호"},"dlvpTypCd":{"type":"string","description":"배송지유형코드(VD007) 10:출고지, 20:반품지"},"dlvpNm":{"type":"string","description":"배송지명"},"useYn":{"type":"string","description":"사용여부"},"zipNoSeq":{"type":"integer","format":"int64","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"utakmnNm":{"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":"담당자휴대폰끝번호"},"aempTelNo":{"type":"string","description":"담당자전화번호"},"aempCellNo":{"type":"string","description":"담당자휴대폰전화번호"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/popup/partnerMgmt/getPartnerDetailWithOtherData":{"get":{"tags":["협력사 팝업"],"summary":"협력사 정보 조회","description":"   ## 기능설명\n   * 협력사 번호 기준으로 협력사 정보를 조회합니다.\n   ## 상세설명\n   * 협력사 번호 기준으로 협력사 정보를 조회합니다.\n   * 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보, 등록된 사업자번호 목록을 조회합니다.\n         ---\n         ## 수정번호\n         * Release v2.00_240627: 배송비 정책 정보 조회 시 추가 배송비 조회 추가\n   ---\n   ## 특이사항\n   * 등록된 협력사의 사업자 번호를 조회하여 저장 시, 사업자 번호 중복 체크에 사용합니다.\n   ---\n   ## 코드정리\n   * ``` 선택구분 ``` : C:등록, RU:상세조회 및 수정\n","operationId":"getPartnerDetailWithOtherData","parameters":[{"name":"entrNo","in":"query","description":"협력사번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePartnerCruPopupResponseEx"}}}}}}}}}
````
