> 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/utilities/data-imports/upload-item-customer-mapping.md).

# Upload Item Customer Mapping

An Item Customer Mapping maps an item to a customer so that whenever a sales order is created with that particular customer and item, the mapped rate and discount are retrieved. This can be useful when certain customers are offered special rates for specific items.

You can use the Upload Item Customer Mapping module to batch import the item customer mapping using the steps mentioned below:

* Download the latest CSV template from the “Batch Upload Item Customer Mapping” module.
* Copy the mapping information into the CSV template.
* Upload the CSV template into Xoro.

### Downloading the CSV template file

* Go to **"Batch Upload Item Customer Mapping"** module using the Search Menu.
* Click on “**Download Template**“.

### Copying the information into the CSV template

Once you’ve downloaded the template file, you can add/copy your data into the CSV. Mandatory fields are marked with a double asterisk (\*\*) prefix.

* The file must be a CSV (Comma-separated values) file. The name of your file must end with CSV.
* Make sure you don’t change any of the column headings from row 1 in the template – these are needed for the file to import correctly.
* All date fields will accept the MM-DD-YYYY format.
* Be mindful of any leading zeros in your data; some spreadsheet software will trim them automatically without notifying you. This can be resolved by ensuring your columns have correct formatting.
* Sometimes long numbers (UPC, etc.) are formatted as scientific notation. Be sure to change the formatting on this data to display these long numbers correctly.

{% hint style="info" %}
*If you’re importing more than 5,000 records, we recommend you split up the file.*
{% endhint %}

<table><thead><tr><th width="242">Column Name</th><th width="110.33333333333331">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>**CustomerName</td><td>Text</td><td>Enter the Customer you want to map the Item to.</td></tr><tr><td>**ItemNumber</td><td>Text</td><td>Enter the Item number of the Item you want to map.</td></tr><tr><td>**CustomerItemNumber</td><td>Text</td><td>Enter the item number assigned by the customer.</td></tr><tr><td>CustomerItemDescription</td><td>Text</td><td>Enter the description of the item.</td></tr><tr><td>ImportError</td><td>Text</td><td>If there are any errors from an upload, they will be listed in this column.</td></tr><tr><td>UOMCode</td><td>Text</td><td>Enter the Unit of Measure (UOM) code for the Item Customer Mapping. When the Multi UOM feature is enabled, this field is mandatory and is used along with Customer and Item to uniquely identify the mapping record.</td></tr></tbody></table>

### Uploading the template

Once you have entered data into the CSV file, you can follow the steps below to upload it into Xoro:

* Click **Browse** to select the saved CSV Template file.
* After the file has been selected, click **Upload** to start importing.
* While the import is in progress, the summary of the progress will be displayed at the bottom of the screen with the progress bar.
* After the import has been completed, the result will be displayed with the message for success or error (if any).
* Item Customer Mapping will only get uploaded into the system if there are no errors in the file.
* If there are errors in the file, you can download the error file, fix the errors in the **Original File,** and upload it back into Xoro.

{% hint style="info" %}
If you want to batch update the existing data, you can download the existing Inventory by clicking **Download Master Inventory File(Aggregate)**, update the necessary values in the CSV file and upload it back into Xoro.
{% 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/utilities/data-imports/upload-item-customer-mapping.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.