> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/purchase/item-vendor-mapping/item-vendor-mapping-fields.md). # Item Vendor Mapping Fields The Item Vendor Mapping page now consists of two sub-tabs: Primary and Custom Fields. ### Tabs #### Primary The Primary sub-tab captures all core details required to establish and manage an item–vendor relationship. Within this, you'll view the fields necessary to fulfill the Item Vendor Mapping, facilitating a successful completion of the process. Detailed descriptions of these fields are provided below for your reference.
FieldDescription
Active MapThis checkbox allows users to activate or deactivate the mapping. When checked, the mapping will be enabled, ensuring that the specified item-vendor association takes effect. By activating the map, users ensure that the configured pricing and discounts are applied during procurement processes.
Item Number*This field enables users to select the unique identifier of the item they wish to map. When a purchase order is created with the selected vendor and this item, the system retrieves the specified item's rate and discount automatically.
Add New ItemIn the Item Number Field, users have the ability to add a new item. By clicking on the + icon, users are redirected to the Item module, where they can input the necessary information to create and save a new item. Subsequently, the newly created item is automatically included in the Item Field within the Vendor Item Mapping module.
Vendor*In this field, users can select the vendor they want to associate with the chosen item. Clicking on this field will display a dropdown of Vendors created by the respective users. By linking the item to a specific vendor, users ensure that procurement transactions involving this item are directed to the selected vendor.
Is Default Vendor?*This checkbox allows users to specify if the selected Vendor is the Default Vendor.
Vendor List Price*This field allows users to enter the list price for the vendor-item mapping. The entered list price will be fetched into the purchase order, ensuring that the procurement team has visibility into the agreed-upon pricing terms with the vendor.
Vendor Discount*Users can enter the discount provided by the vendor for the mapped item in this field. The specified discount will be applied to the item's list price when generating the purchase order, resulting in cost savings for the organization.
Vendor Part Number*In this field, users can enter the part number assigned by the vendor for the mapped item.
Lead Time (days)The value entered in this field represents the number of days the vendor typically takes to deliver the item after the order is placed. This lead time is used by the system to automatically calculate the Delivery Date at the Purchase Order line level by adding the Vendor Lead Days to the PO Order Date when an Item–Vendor Mapping exists.
UOMSelect the unit of measure applicable for the vendor item from the dropdown menu which includes Volume, Weight, Time, Size, and Count.
Vendor Part DescriptionThis allows you to fill in the description of the assigned vendor part.
Internal NotesThis allows you to fill in any special instruction or notes for your team or vendor.
InventoryThis field mentions inventory num associated with the mapped item.
{% hint style="info" %} It is important to note that when an Item is created (either manually or via an upload) with a default Vendor, an Item Vendor Mapping will be automatically generated. {% endhint %} #### Custom Fields The custom fields sub-tab allows you to define the custom fields for the item vendor mapping. | **Field** | **Description** | | ----------------- | ------------------------------------------------------------------------------------------------------ | | TEXT | A free-text field used to capture additional textual information related to the item–vendor mapping. | | LIST | A dropdown field that allows selection from predefined values: **LIST1, LIST2, LIST3, LIST4, LIST5**. | | MULTI LINE TEXT | A multi-line text field used to enter detailed notes or extended descriptions. | | DISCONTINUED | A dropdown field with **Yes / No** options indicating whether the vendor item mapping is discontinued. | | 123 | A numeric field used to capture number-based data such as reference values or identifiers. | | MULTI-SELECT-LIST | A dropdown field allowing multiple selections from predefined values: **LIST1, LIST2, LIST3**. | After filling in all the details, click on the **Save** button on the right top corner of the page to save the details. ### Activating Item Vendor Mapping To enable or disable the use of Item Vendor Mappings, see the App Config settings:
--- # 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, and the optional `goal` query parameter: ``` GET https://docs.xorosoft.com/xoroerp-1/purchase/item-vendor-mapping/item-vendor-mapping-fields.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.