> 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-guide/back-office/vendor-bo/undefined.md). # 협력사 관리 협력사 관리 서비스는 협력사 정보와 배송비 정책, 담당자 정보, 제휴/채널 정보를 체계적으로 관리합니다. 배송비 정책은 상품 등록 시에 배송 정보에 적용되며, 제휴/채널 정보는 팝업 등록/수정 시에 채널 적용 구분 영역에 활용됩니다. 아울러 판매자(협력사) 평가·등급 관리 기능을 통해 배송 준수율·주문 이행률 등 운영 지표를 기준으로 판매자 등급을 산정하며, 등급 상세에 대한 승인요청·승인·반려 워크플로를 제공합니다(/v1/vendor/vendorSalesGrade). *** ## 주요 기능 * **배송비 정책 정보 관리** * 배송비 형태, 기준 금액, 배송비 금액, 추가 배송비, 회수 배송비, 교환 배송비 등을 정의하고 저장합니다. * 배송비 정책 정보는 삭제가 불가능하며 사용 여부로 관리됩니다. * 중복된 배송비 정책은 저장할 수 없습니다. * 배송 관련 금액은 100원 단위로 입력 가능하며, 특정 조건에 따라 입력이 제한됩니다. * **협력사 정보 관리** * 협력사의 정보를 등록, 수정, 삭제합니다. * 배송비 정책 정보를 협력사에 할당하여 배송비를 관리합니다. * **제휴/채널 정보 관리** * 제휴사와 채널에 대한 정보를 등록, 수정, 삭제합니다. * 채널 정보는 팝업 등록/수정 시에 활용되어 특정 채널에 적용됩니다. * 채널 수수료 정보를 정의하고, 정액 또는 정률로 수수료를 관리합니다. ## 프로세스 정의 — 협력사 및 제휴사 정보 관리 관리자가 협력사 관리에 접근할 때의 프로세스입니다.
{% stepper %} {% step %} ### 협력사 정보 관리 조회 협력사 정보 관리를 조회합니다. * 등록된 협력사의 정보를 협력사번호, 협력사명, 거래상태코드, 거래형태코드 기준으로 조회하여 협력사 조회 결과에 노출합니다. * 협력사의 협력사구분코드(VD001)는 ‘상품공급업자(10)’입니다. {% endstep %} {% step %} ### 제휴사 관리 조회 제휴사 관리를 조회합니다. * 등록된 제휴사의 정보를 협력사번호, 협력사명, 거래상태코드, 거래형태코드 기준으로 조회하여 제휴사 목록에 노출합니다. * 제휴사의 협력사구분코드(VD001)는 ‘제휴사업자(20)’입니다. {% endstep %} {% step %} ### 제휴사 목록 조회 제휴사 목록을 조회합니다. * 제휴사 목록을 협력사번호, 협력사명 기준으로 조회하여 제휴사 번호 내림차순으로 노출합니다. {% endstep %} {% step %} ### 제휴사 상세정보 조회 협력사번호 별 제휴사 상세정보를 조회합니다. * 등록된 제휴사의 사업자번호를 조회하여 저장 시, 사업자번호 중복 체크에 사용합니다. {% endstep %} {% step %} ### 제휴사 상세정보 저장 제휴사 상세정보를 저장합니다. * 제휴사는 거래형태코드(VD008)를 ‘제휴사(30)’으로, 마진율을 기본값 ‘0’으로 저장합니다. * 제휴사명은 중복 저장이 불가합니다. {% endstep %} {% endstepper %} ## 프로세스 정의 — 배송비 및 채널 수수료 관리 관리자가 협력사 관리, 채널 수수료 정보, 채널 공통 팝업에 접근할 때의 프로세스입니다.
{% stepper %} {% step %} ### 배송비 관리 조회 협력사 별 배송비 정보를 조회합니다. * 등록된 배송비 정보 및 상품 기본 정보(등록상품 수)를 협력사번호, 배송비 형태 기준으로 조회하여 협력사 목록에 노출합니다. {% endstep %} {% step %} ### 배송비 관리 저장 협력사 별 배송비 정보를 저장합니다. * 협력사번호 기준으로 신규 배송 정책 정보를 저장합니다. {% endstep %} {% step %} ### 채널 내역 조회 협력사번호 별 채널 내역을 조회합니다. * 제휴사번호 기준으로 삭제여부 ‘N’인 채널에 대해 조회합니다. {% endstep %} {% step %} ### 채널 내역 저장 추가, 수정, 삭제한 채널 내역을 저장합니다. * 채널번호 기준으로 채널 내역을 추가, 수정, 삭제합니다. {% endstep %} {% step %} ### 상세 채널 내역 조회 채널번호 별 상세 채널 내역을 조회합니다. * 채널번호 기준으로 삭제여부 ’N’인 상세 채널 내역을 조회합니다. {% endstep %} {% step %} ### 상세 채널 내역 저장 추가, 수정, 삭제한 상세 채널 내역을 저장합니다. * 채널번호, 채널유형 기준으로 상세 채널 내역을 추가, 수정합니다. * 채널번호, 채널상세번호 기준으로 상세 채널 내역을 삭제합니다. {% endstep %} {% step %} ### 채널 수수료 정보 저장 채널 수수료 정보를 저장합니다. * 채널 수수료 정보는 채널 상세번호, 적용 시작일자, 적용 종료일자 중복이 불가합니다. {% endstep %} {% step %} ### 채널 수수료 정보 조회 채널 수수료 정보를 조회합니다. * 채널 상세번호 기준으로 채널 수수료 정보를 채널 상세번호, 적용 시작일자 내림차순으로 조회합니다. {% endstep %} {% step %} ### 공통 팝업 – 채널 정보 목록 조회 채널 정보 목록 및 목록 수를 조회합니다. * 채널번호, 채널명, 채널분류코드 기준으로 채널 정보 목록 및 목록 수를 채널번호 오름차순으로 조회합니다. {% endstep %} {% step %} ### 공통 팝업 – 채널 정보 목록 개수 조회 * (상동) {% endstep %} {% endstepper %} ## 프로세스 정의 — 협력사 팝업 관리 관리자가 협력사 공통 팝업, 협력사 팝업에 접근할 때의 프로세스입니다.
{% stepper %} {% step %} ### 협력사 목록 조회 협력사 목록을 조회합니다. * 등록된 협력사 정보 목록을 조회하여 협력사 공통 팝업에 제공합니다. {% endstep %} {% step %} ### 협력사 정보 조회 협력사번호 별 협력사 정보를 조회합니다. * 협력사번호 기준으로 협력사 기본 정보, 배송 정책 정보 및 상품 기본 정보(등록상품 수), 협력사 담당자 정보, 협력사 배송지 정보를 조회합니다. {% endstep %} {% step %} ### 협력사 정보 수정 협력사 정보를 수정합니다. * 협력사번호 기준으로 협력사 기본 정보, 배송 정책 정보, 협력사 담당자 정보, 협력사 배송지 정보를 수정합니다. * 거래 상태가 ‘거래종료’인 경우, 수정이 불가합니다. {% endstep %} {% step %} ### 협력사 정보 저장 협력사 정보를 저장합니다. * 신규 협력사의 협력사 기본 정보, 배송 정책 정보, 협력사 담당자 정보, 협력사 배송지 정보를 저장합니다. {% endstep %} {% endstepper %} ## API 기능 목록 — 협력사 관리 | API | 설명 | Server | 메소드 | 비고 | | ------------ | ------------------------------------------------------------------------------------------------------------------- | ------ | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | 배송비 관리 저장 | - 배송비 정보를 저장합니다. - 추가/수정 시 협력사번호, 배송비형태, 기준금액, 배송비금액, 회수반품비, 교환배송비, 추가배송비 중복이 불가합니다. - 삭제 시 협력사번호, 배송정책번호는 필수 값입니다. | BO | POST | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=registCUD) | | 제휴사 상세정보 저장 | - 제휴사 상세정보를 저장합니다. - 제휴사명은 중복이 불가합니다. | BO | POST | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=saveCooperateWithOtherData) | | 상세 채널 내역 저장 | - 상세 채널 내역을 저장합니다. - 추가/수정 시 채널번호, 채널유형은 필수 값입니다. - 삭제 시 채널번호, 채널상세번호는 필수 값입니다. | BO | POST | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=getCcChlDtlInfoByChlNo) | | 채널 내역 저장 | - 채널 내역을 저장합니다. - 추가/수정 시 협력사번호, 채널유형, 채널명, 적용시작일자, 적용종료일자는 필수 값입니다. - 삭제 시 채널번호는 필수 값입니다. | BO | POST | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=saveCcChlBase) | | 협력사 정보 관리 조회 | - 협력사 정보 목록을 협력사번호 내림차순으로 조회합니다. | BO | GET | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=getPartnerSearchList) | | 배송비 관리 조회 | - 배송비 정보 목록을 협력사번호, 배송비형태 오름차순으로 조회합니다. - 등록 상품(임시저장, 판매종료 외 모든 승인/판매 상태 상품) 수를 조회하여 사용여부 변경 시에 사용합니다. | BO | GET | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=getDeliveryPolicySearchList) | | 제휴사 관리 조회 | - 제휴사 정보 목록을 제휴사번호 내림차순으로 조회합니다. | BO | GET | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=getCooperateSearchList) | | 제휴사 목록 조회 | - 제휴사 목록을 제휴사번호 내림차순으로 조회합니다. | BO | GET | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=getCooperateChannelSearchList) | | 제휴사 상세정보 조회 | - 제휴사번호 기준으로 제휴사 상세정보를 조회합니다. - 등록된 제휴사의 사업자번호를 조회하여 저장 시, 사업자번호 중복 체크에 사용합니다. | BO | GET | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=getCooperateAndOthersByEntrNo) | | 상세 채널 내역 조회 | - 채널번호 기준으로 상세 채널 내역을 조회합니다. - 삭제여부 ‘N’인 채널에 대해 조회합니다. | BO | GET | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=getCcChlDtlInfoByChlNo) | | 채널 내역 조회 | - 제휴사번호 기준으로 채널 내역을 조회합니다. - 삭제여부 ‘N’인 채널에 대해 조회합니다. | BO | GET | [🔗API 확인하기 >](https://apibo.x2bee.com/content?bo=vendor\&depth=%ED%98%91%EB%A0%A5%EC%82%AC%20%EA%B4%80%EB%A6%AC\&path=getCcChlBaseByEntrNo) | ## API 기능 목록 — 채널 수수료 정보 | API | 설명 | Server | 메소드 | 비고 | | ------------ | ----------------------------------------------------------- | ------ | ---- | --- | | 채널 수수료 정보 저장 | - 채널 수수료 정보를 저장합니다. - 채널 상세번호, 적용 시작일자, 적용 종료일자는 중복이 불가합니다. | BO | POST | --- | | 채널 수수료정보 조회 | - 채널 상세번호 기준으로 채널 수수료 정보를 채널 상세번호, 적용 시작일자 내림차순으로 조회합니다. | BO | GET | --- | ## API 기능 목록 — 채널 공통 팝업 | API | 설명 | Server | 메소드 | 비고 | | --------------------- | -------------------------------------------------- | ------ | --- | --- | | 공통팝업 – 채널 정보 목록 조회 | - 채널번호, 채널명, 채널분류코드 기준으로 채널 정보를 채널번호 오름차순으로 조회합니다. | BO | GET | --- | | 공통팝업 – 채널 정보 목록 개수 조회 | - 채널번호, 채널명, 채널분류코드에 따라 채널 정보 개수를 조회합니다. | BO | GET | --- | ## API 기능 목록 — 협력사 공통 팝업 | API | 설명 | Server | 메소드 | 비고 | | --------- | ------------------------------------------------------------------------------------------------------- | ------ | --- | --- | | 협력사 목록 조회 | - 협력사 정보 목록을 협력사번호 내림차순으로 조회합니다. - 협력사번호/명 입력이 필요한 경우 협력사 조회 공통 팝업을 호출하며, 해당 API를 통해 등록된 협력사 정보를 제공합니다. | BO | GET | --- | ## API 기능 목록 — 협력사 팝업 | API | 설명 | Server | 메소드 | 비고 | | --------- | ----------------------------------------------------------------------------------------------------------- | ------ | ---- | --- | | 협력사 정보 수정 | - 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 수정합니다. - 협력사명은 중복이 불가합니다. | BO | PUT | --- | | 협력사 정보 저장 | - 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 저장합니다. - 협력사명은 중복이 불가합니다. | BO | POST | --- | | 협력사 정보 조회 | - 협력사 번호 기준으로 협력사 정보, 배송비 정책 정보, 담당자 정보, 배송지 정보를 조회합니다. - 등록된 협력사의 사업자번호를 조회하여 저장/수정 시, 사업자번호 중복 체크에 사용합니다. | BO | GET | --- | ## 용어 정의
명칭설명
협력사쇼핑몰에 상품 및 서비스를 제공하거나 제공받는 모든 거래업체를 의미합니다.
상품공급업체쇼핑몰을 통해 고객에게 상품 및 서비스를 제공하는 협력사입니다.
제휴업체쇼핑몰과 제휴하여 고객에게 상품 및 서비스를 제공하는 업체입니다.
(ex. 네이버, 다음 등)