> 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.&#x20;

### 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.

<figure><img src="/files/29mLPSdxEQAABGi06Tf4" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="226">Field</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Active Map</td><td>This 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.</td><td></td></tr><tr><td>Item Number*</td><td>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.</td><td></td></tr><tr><td>Add New Item</td><td>In 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.</td><td></td></tr><tr><td>Vendor*</td><td>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.</td><td></td></tr><tr><td>Is Default Vendor?*</td><td>This checkbox allows users to specify if the selected Vendor is the Default Vendor.</td><td></td></tr><tr><td>Vendor List Price*</td><td><p>This field allows users to specify the vendor's list price for the selected item and UOM. The value is used when creating Purchase Orders, providing visibility into the agreed-upon vendor pricing.</p><p>When the <strong>Enable Item Unit Cost on Item Vendor Mapping</strong> application configuration is enabled, the system automatically populates this field with the calculated <strong>Item Unit Cost</strong> for the selected UOM. If the configuration is disabled, the <strong>Vendor List Price</strong> can be manually entered.</p></td><td></td></tr><tr><td>Vendor Discount*</td><td>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.</td><td></td></tr><tr><td>Vendor Part Number*</td><td>This field allows users to enter the part number assigned by the vendor for the mapped item. When an item with an existing Item Vendor Mapping is added to a Purchase Order, the system automatically populates the Vendor Part # field from this value, regardless of whether the <a href="/pages/mBVj4CW4tIYriEhtEvTp#enable-vendor-mapping-price-use-in-purchase-modules"><strong>Use Vendor Mapping Price in Purchase Modules</strong></a> app configuration is enabled.</td><td></td></tr><tr><td>Lead Time (days)</td><td>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 <strong>Delivery Date</strong> at the Purchase Order line level by adding the Vendor Lead Days to the <strong>PO Order Date</strong> when an Item–Vendor Mapping exists. </td><td></td></tr><tr><td>UOM</td><td>Select the unit of measure applicable for the vendor item from the dropdown menu which includes Volume, Weight, Time, Size, and Count.</td><td></td></tr><tr><td>Vendor Part Description</td><td>This allows you to fill in the description of the assigned vendor part.</td><td></td></tr><tr><td>Internal Notes</td><td>This allows you to fill in any special instruction or notes for your team or vendor.</td><td></td></tr><tr><td>Inventory</td><td>This field mentions inventory num associated with the mapped item.</td><td></td></tr><tr><td>Item Unit Cost</td><td><p>This field displays the calculated unit cost of the item for the selected vendor and UOM. The value is automatically derived from the item's <strong>Standard Cost</strong> and the applicable UOM conversion factor based on the selected UOM. This is a <strong>read-only</strong> field and cannot be edited manually.</p><p>The calculated <strong>Item Unit Cost</strong> is also automatically populated as the <strong>Vendor List Price</strong>, regardless of whether the selected UOM matches the item's Base UOM.</p></td><td></td></tr></tbody></table>

{% hint style="info" %}
The **Item Unit Cost** field is available only when the [**Enable Item Unit Cost on Item Vendor Mapping**](/xoroerp-1/configuration/application/app-config/general.md#enable-item-unit-cost-on-item-vendor-mapping) application configuration is enabled.

When enabled, the system calculates the **Item Unit Cost** based on the configured UOM conversion. Therefore, **Multi UOM** must be enabled, the [**Dynamic Unit Price Calculation Based on UOM F**](/xoroerp-1/configuration/application/app-config/general.md#dynamic-unit-price-calculation-based-on-uom-factor)**actor** application configuration must also be enabled, and the selected UOM must have a valid conversion mapping to the item's **Base UOM** in the [**Multi UOM Mapping**](https://docs.xorosoft.com/xoroerp-1/admin/multi-uom/what-is-multi-uom-and-how-is-it-handled-in-xoro) module.
{% endhint %}

{% 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 in the top right 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:

<figure><img src="/files/9iFsocp4FBROHwVEfjF8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If the [**Restrict Automatic Item Vendor Mapping Creation**](/xoroerp-1/configuration/application/app-config/general.md#restrict-automatic-item-vendor-mapping-creation) app configuration is enabled, the system will not automatically create new Item Vendor Mapping records during item creation, updates, imports, or when the Default Vendor is changed. In such cases, Item Vendor Mapping records must be created manually. Existing Item Vendor Mapping records remain unaffected.
{% endhint %}


---

# 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=<question>&goal=<endgoal>
```

`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.
