> 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 입니다.\
> \---\
> \## 상세설명\
> \* 협력사 정보를 수정합니다.\
> \* 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 수정합니다.\
> \---\
> \## 검증내용\
> \* 수정 시 협력사 정보의 유효성을 검증합니다.\
> \* 협력사명은 중복이 불가합니다.\
> \* 수정 시 담당자 정보의 유효성을 검증합니다.\
> \* 추가, 수정 필수 입력: 직무코드, 담당자명\
> \* 삭제 필수 입력: 담당자 순번\
> \* 수정 시 배송정책 정보의 유효성을 검증합니다.\
> \* 추가, 수정 필수 입력: 협력사번호, 배송비금액, 배송비형태, 기준금액, 회수반품비, 교환배송비\
> \* 삭제 필수 입력: 협력사 번호\
> \* 수정 시 배송지 정보의 유효성을 검증합니다.\
> \* 추가, 수정 필수 입력: 협력사번호, 배송지명, 우편번호순번, 상세주소, 휴대폰번호\
> \* 삭제 필수 입력: 협력사배송지번호
```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 입니다.\
> \---\
> \## 상세설명\
> \* 협력사 정보를 저장합니다.\
> \* 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 저장합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240627: 추가 배송비 정보 등록 기능 추가\
> \---\
> \## 검증내용\
> \* 저장 시 협력사 정보의 유효성을 검증합니다.\
> \* 협력사명은 중복이 불가합니다.\
> \* 필수 입력: 협력사명, 사업자종류코드, 사업자번호, 거래형태코드, 거래상태코드, 계약시작일자, 계약종료일자, 담당자휴대폰번호, 대표자명, 우편번호순번, 우편번호, 우편주소, 상세주소
```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"}}}}}}}}}
```
## 협력사 정보 조회
> \## 기능설명\
> \* 협력사 번호 기준으로 거래대기,거래중 협력사중 사업자 번호 중복여부를 조회합니다.\
> \## 상세설명\
> \* 협력사 번호 기준으로 거래대기,거래중 협력사중 사업자 번호 중복여부를 조회합니다.
```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"}}}}}}}}}
```
## 협력사 정보 조회
> \## 기능설명\
> \* 협력사 번호 기준으로 협력사 정보를 조회합니다.\
> \## 상세설명\
> \* 협력사 번호 기준으로 협력사 정보를 조회합니다.\
> \* 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보, 등록된 사업자번호 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240627: 배송비 정책 정보 조회 시 추가 배송비 조회 추가\
> \---\
> \## 특이사항\
> \* 등록된 협력사의 사업자 번호를 조회하여 저장 시, 사업자 번호 중복 체크에 사용합니다.\
> \---\
> \## 코드정리\
> \* \`\`\` 선택구분 \`\`\` : C:등록, RU:상세조회 및 수정
````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"}}}}}}}}}
````
---
# 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.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.