> 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/api-guides-en/back-office/vendor-bo/vendor-management.md). # Vendor Management The vendor management service systematically manages vendor information, delivery fee policies, contact person information, and partnership/channel information. Delivery fee policies are applied to delivery information during product registration, and partnership/channel information is used in the channel application classification area during popup registration/modification. In addition, the seller (vendor) evaluation and grading management feature calculates seller grades based on operational metrics such as delivery compliance rate and order fulfillment rate, and provides an approval-request/approval/rejection workflow for grade details (/v1/vendor/vendorSalesGrade). *** ## Key Features * **Delivery Fee Policy Information Management** * Define and save the delivery fee type, base amount, delivery fee amount, additional delivery fee, pickup delivery fee, exchange delivery fee, etc. * Delivery fee policy information cannot be deleted and is managed via a usage status flag. * Duplicate delivery fee policies cannot be saved. * Delivery-related amounts can be entered in units of 100 KRW, and input is restricted under certain conditions. * **Vendor Information Management** * Register, modify, and delete vendor information. * Assign delivery fee policy information to a vendor to manage delivery fees. * **Partnership/Channel Information Management** * Register, modify, and delete information about affiliates and channels. * Channel information is used during popup registration/modification and applied to a specific channel. * Define channel commission information and manage the commission as a flat amount or a fixed rate. ## Process Definition — Vendor and Affiliate Information Management This is the process followed when an administrator accesses vendor management.
{% stepper %} {% step %} ### Vendor Information Management Lookup Look up vendor information management. * Look up registered vendor information by vendor number, vendor name, transaction status code, and transaction type code, and display it in the vendor lookup results. * The vendor classification code (VD001) for a vendor is 'Product Supplier (10)'. {% endstep %} {% step %} ### Affiliate Management Lookup Look up affiliate management. * Look up registered affiliate information by vendor number, vendor name, transaction status code, and transaction type code, and display it in the affiliate list. * The vendor classification code (VD001) for an affiliate is 'Affiliate Business (20)'. {% endstep %} {% step %} ### Affiliate List Lookup Look up the affiliate list. * Look up the affiliate list by vendor number and vendor name, and display it in descending order of affiliate number. {% endstep %} {% step %} ### Affiliate Detail Information Lookup Look up affiliate detail information by vendor number. * Look up the registered affiliate's business registration number, used for duplicate-check when saving. {% endstep %} {% step %} ### Save Affiliate Detail Information Save the affiliate detail information. * For an affiliate, the transaction type code (VD008) is saved as 'Affiliate (30)', with a default margin rate of '0'. * Affiliate names cannot be duplicated. {% endstep %} {% endstepper %} ## Process Definition — Delivery Fee and Channel Commission Management This is the process followed when an administrator accesses vendor management, channel commission information, and the common channel popup.
{% stepper %} {% step %} ### Delivery Fee Management Lookup Look up delivery fee information by vendor. * Look up registered delivery fee information and basic product information (number of registered products) by vendor number and delivery fee type, and display it in the vendor list. {% endstep %} {% step %} ### Save Delivery Fee Management Save delivery fee information by vendor. * Save new delivery policy information by vendor number. {% endstep %} {% step %} ### Channel History Lookup Look up channel history by vendor number. * Look up channels with a deletion flag of 'N', by affiliate number. {% endstep %} {% step %} ### Save Channel History Save added, modified, or deleted channel history. * Add, modify, or delete channel history by channel number. {% endstep %} {% step %} ### Detailed Channel History Lookup Look up detailed channel history by channel number. * Look up detailed channel history with a deletion flag of 'N', by channel number. {% endstep %} {% step %} ### Save Detailed Channel History Save added, modified, or deleted detailed channel history. * Add or modify detailed channel history by channel number and channel type. * Delete detailed channel history by channel number and channel detail number. {% endstep %} {% step %} ### Save Channel Commission Information Save channel commission information. * Channel commission information cannot be duplicated for the same channel detail number, application start date, and application end date. {% endstep %} {% step %} ### Channel Commission Information Lookup Look up channel commission information. * Look up channel commission information by channel detail number, sorted in descending order of channel detail number and application start date. {% endstep %} {% step %} ### Common Popup – Channel Information List Lookup Look up the channel information list and list count. * Look up the channel information list and list count by channel number, channel name, and channel classification code, sorted in ascending order of channel number. {% endstep %} {% step %} ### Common Popup – Channel Information List Count Lookup * (Same as above) {% endstep %} {% endstepper %} ## Process Definition — Vendor Popup Management This is the process followed when an administrator accesses the vendor common popup and vendor popup.
{% stepper %} {% step %} ### Vendor List Lookup Look up the vendor list. * Look up the list of registered vendor information and provide it to the vendor common popup. {% endstep %} {% step %} ### Vendor Information Lookup Look up vendor information by vendor number. * Look up basic vendor information, delivery policy information and basic product information (number of registered products), vendor contact person information, and vendor shipping address information by vendor number. {% endstep %} {% step %} ### Modify Vendor Information Modify vendor information. * Modify basic vendor information, delivery policy information, vendor contact person information, and vendor shipping address information by vendor number. * Modification is not allowed if the transaction status is 'Transaction Ended'. {% endstep %} {% step %} ### Save Vendor Information Save vendor information. * Save basic vendor information, delivery policy information, vendor contact person information, and vendor shipping address information for a new vendor. {% endstep %} {% endstepper %} ## API Function List — Vendor Management | API | Description | Server | Method | Remarks | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | Save Delivery Fee Management | - Save delivery fee information. - For add/modify, duplicate values of vendor number, delivery fee type, base amount, delivery fee amount, pickup return fee, exchange delivery fee, and additional delivery fee are not allowed. - For delete, vendor number and delivery policy number are required. | BO | POST | [🔗View 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) | | Save Affiliate Detail Information | - Save affiliate detail information. - Affiliate names cannot be duplicated. | BO | POST | [🔗View 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) | | Save Detailed Channel History | - Save detailed channel history. - For add/modify, channel number and channel type are required. - For delete, channel number and channel detail number are required. | BO | POST | [🔗View 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) | | Save Channel History | - Save channel history. - For add/modify, vendor number, channel type, channel name, application start date, and application end date are required. - For delete, channel number is required. | BO | POST | [🔗View 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) | | Vendor Information Management Lookup | - Look up the vendor information list in descending order of vendor number. | BO | GET | [🔗View 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) | | Delivery Fee Management Lookup | - Look up the delivery fee information list in ascending order of vendor number and delivery fee type. - Look up the count of registered products (all approved/on-sale statuses except temporarily saved and discontinued) for use when changing the usage status. | BO | GET | [🔗View 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) | | Affiliate Management Lookup | - Look up the affiliate information list in descending order of affiliate number. | BO | GET | [🔗View 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) | | Affiliate List Lookup | - Look up the affiliate list in descending order of affiliate number. | BO | GET | [🔗View 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) | | Affiliate Detail Information Lookup | - Look up affiliate detail information by affiliate number. - Look up the registered affiliate's business registration number, used for duplicate-check when saving. | BO | GET | [🔗View 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) | | Detailed Channel History Lookup | - Look up detailed channel history by channel number. - Look up channels with a deletion flag of 'N'. | BO | GET | [🔗View 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) | | Channel History Lookup | - Look up channel history by affiliate number. - Look up channels with a deletion flag of 'N'. | BO | GET | [🔗View 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 Function List — Channel Commission Information | API | Description | Server | Method | Remarks | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------ | ------- | | Save Channel Commission Information | - Save channel commission information. - Channel detail number, application start date, and application end date cannot be duplicated. | BO | POST | --- | | Channel Commission Information Lookup | - Look up channel commission information by channel detail number, in descending order of channel detail number and application start date. | BO | GET | --- | ## API Function List — Common Channel Popup | API | Description | Server | Method | Remarks | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------ | ------- | | Common Popup – Channel Information List Lookup | - Look up channel information by channel number, channel name, and channel classification code, in ascending order of channel number. | BO | GET | --- | | Common Popup – Channel Information List Count Lookup | - Look up the channel information count by channel number, channel name, and channel classification code. | BO | GET | --- | ## API Function List — Common Vendor Popup | API | Description | Server | Method | Remarks | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------ | ------- | | Vendor List Lookup | - Look up the vendor information list in descending order of vendor number. - When vendor number/name input is required, call the common vendor lookup popup, which provides the registered vendor information via this API. | BO | GET | --- | ## API Function List — Vendor Popup | API | Description | Server | Method | Remarks | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------ | ------- | | Modify Vendor Information | - Modify vendor information, delivery fee policy information, contact person information, and shipping address information. - Vendor names cannot be duplicated. | BO | PUT | --- | | Save Vendor Information | - Save vendor information, delivery fee policy information, contact person information, and shipping address information. - Vendor names cannot be duplicated. | BO | POST | --- | | Vendor Information Lookup | - Look up vendor information, delivery fee policy information, contact person information, and shipping address information by vendor number. - Look up the registered vendor's business registration number, used for duplicate-check when saving/modifying. | BO | GET | --- | ## Term Definitions
TermDescription
VendorRefers to any business partner that provides or receives products and services to/from the shopping mall.
Product SupplierA vendor that provides products and services to customers through the shopping mall.
AffiliateA business that partners with the shopping mall to provide products and services to customers.
(e.g., Naver, Daum, etc.)