> 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/admin/item-customer-mapping/creating-item-customer-mapping.md).

# Creating Item Customer Mapping

Item Customer Mapping is used to reconcile the disparity between the names of items recognized by customers and those maintained within the This mapping allows you to effortlessly track and align their products with the specific requirements or identifiers used by their customers. In essence, it facilitates a smoother transaction process, ensuring that both parties are on the same page regarding product identification.

Creating an item customer mapping involves entering the essential details, such as item number, description, and the customer name. By creating the mapping, you can enhance operational efficiency, reduce the potential for errors, and improve customer satisfaction by ensuring products are correctly identified and matched with the customer's expectations.&#x20;

{% hint style="info" %}
To create an Item Customer Mapping, go to **Admin > Item Customer Mapping**
{% endhint %}

#### **Item Customer Mapping Fields**

<table><thead><tr><th width="168">Field</th><th>Description</th></tr></thead><tbody><tr><td>Item Number</td><td>Enter the unique identifier used internally by a company to track and manage its inventory.</td></tr><tr><td>Customer</td><td>Search and select the customer for whom you want to create the mapping.</td></tr><tr><td>Customer Item Number</td><td>Enter the name assigned to the item by the customer.</td></tr><tr><td>Customer Item Description</td><td>Enter the description assigned to the item by the customer.</td></tr><tr><td>UOM</td><td>Select the Unit of Measure (UOM) to associate with the selected item for the customer. When the <a href="/xoroerp-1/configuration/application/app-config/sales.md#use-uom-from-the-customer-item-customer-mapping-on-add-item"><strong>Use UOM from the Customer/Item Customer Mapping on Add Item</strong></a> app configuration is enabled with the <strong>Item Customer Mapping</strong> option selected, the system automatically applies this UOM when the mapped item is added to a sales transaction for the customer. If multiple Item Customer Mappings exist for the same customer and item, the system uses the UOM from the most recently created mapping. Users can modify the UOM at the transaction line level if required.</td></tr></tbody></table>

Once all the information is entered, click "Save" to create the mapping.&#x20;

<figure><img src="https://3188343778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf8DNCjEfcSm64PCPcmf%2Fuploads%2FJlXtYXQpp0xjk5xijU91%2Fimage.png?alt=media&amp;token=54fe6b29-e6a6-485c-8a15-731a0143c3fd" alt=""><figcaption></figcaption></figure>

All the mappings created in the system are listed on the **Item Customer Mapping Centre**.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.xorosoft.com/xoroerp-1/admin/item-customer-mapping/creating-item-customer-mapping.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
