> 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/multi-uom/what-is-multi-uom-and-how-is-it-handled-in-xoro.md).

# What is Multi UOM and how is it handled in Xoro?

Multi UOM, or Multi-Unit of Measurement, refers to a system that enables the use of different units of measurement for the same item or product. It proves beneficial when products are purchased or sold in units different from those stored within the system.

Consider the food industry, where an item may be purchased in kilograms for wholesale purposes but sold in grams for retail purposes. This means that the item might be stored in the system in a particular unit of measurement but sold or purchased in a different UOM.

A Multi UOM system facilitates easy conversion between these units of measurement, without requiring manual calculations or conversions.

### How is Multi UOM helpful?

Having multiple units of measure for an item can help in the accurate tracking of inventory, better cost management, and efficient order processing. However, it is important to ensure that the conversion factors between the units are accurately defined and consistent throughout the system to avoid confusion or errors.

### Defining the Units and Factors in Xoro

To implement the Multi UOM, we need to define Units of Measurement and the factor used for the conversion for an item. This information is then used while making a transaction (sale or purchase). In Xoro, these are defined in the Multi UOM Mapping module.

<figure><img src="/files/5ubU6flyn3KzKfx1Xxg7" alt=""><figcaption></figcaption></figure>

Before looking at how to create Multi UOM Mappings, let’s understand some basic terms used for the mapping.

**From UOM:** This is the unit of measurement in which the item is sold or purchased.

**To UOM:** This is the unit of measurement in which the item is stored in the system.&#x20;

**Factor:** This is the numerical value that is used for the conversion of measurements from one unit of measure (From UOM) to another unit of measure (To UOM)&#x20;

Let’s understand this with an example.

Let’s say that the inventory is stored in Kilogram (KG) in your system and it is sold or purchased in Gram (GM). So, in this case:

**From UOM:** KG

&#x20;    **To UOM:** GM

&#x20;       **Factor:** 0.001

That means that for every 1000 units sold or purchased, 1 unit will be depleted from or added to the system.

### How to create Multi UOM Mapping?

Please follow the steps below to create Multi UOM Mapping.

* Navigate to the Multi UOM Mapping module.
* Select the Item for which you want to create the mapping.<br>

  <figure><img src="/files/S4VplggyKxGIZmXv3qTq" alt=""><figcaption></figcaption></figure>
* Then, select the From UOM and To UOM, fill in the Factor value, and click on “Add Mapping”.<br>

  <figure><img src="/files/xifsoqITLxjiBcNQYmP7" alt=""><figcaption></figcaption></figure>
* You will be asked for confirmation.<br>

  <div align="left"><figure><img src="/files/V6mr5sGe6ZeOAt0RXae5" alt=""><figcaption></figcaption></figure></div>
* Press OK to create the mapping.<br>

  <figure><img src="/files/CohriY7G7SfrkagsqGfp" alt=""><figcaption></figcaption></figure>

\*Please note that you can create multiple mappings for an Item.

### Defining the UOMs on the Item

Once the UOM Mapping is set up, it's important to define the UOM specifics in the item details. Here’s a step-by-step guide on how to do that:

* Open the item from the Item Centre.
* Navigate to the UOM tab.
* Choose the SKU UOM, which represents the unit in which the item is stored in the system.<br>

  <figure><img src="/files/jLyd26dZjhMBLGMKmkxu" alt=""><figcaption></figcaption></figure>
* Next, select the Allowed Purchase UOM(s) and Default Purchase UOM.<br>

  <figure><img src="/files/loqRRX9Tx7x8mfl8NKVG" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/xNrClKmpWu4iMmtKFcY2" alt=""><figcaption></figcaption></figure>
* The Allowed Purchase UOM(s) are the UOM(s) in which you can purchase the Item based on the UOM mapping. For instance, if you have created a mapping from KG to Gram, you can purchase the Item in both Gram and Kilogram. Default UOM is the default purchasing unit of measurement for the Item. Please note that you can add multiple purchase UOMs
* Next, select the Sell Purchase UOM(s) and Default Purchase UOM.<br>

  <figure><img src="/files/vbQ32TuAZ6e0CfJLO4DT" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/4CbpYcK5ctqDxu1u1jpi" alt=""><figcaption></figcaption></figure>
* The Sell Purchase UOM is the UOM(s) in which you can purchase the Item based on the UOM mapping. For instance, if you have created a mapping from KG to Gram, you can sell the Item in both Gram and Kilogram. Default UOM is the default selling unit of measurement for the Item. Please note that you can add multiple sell UOMs as well.

### Multi UOM in Sales and Purchase

After you have defined the UOM on the Item, you can use different units of measurement for sale and purchase.

**How does it work?**

Let’s understand the working of the Multi UOM with the example item mapped earlier- **GWB1314-1-BEIGE**. As per the mapping, the item is stored in Kilograms in the system and sold and purchased in Grams. Suppose we are creating a Purchase Order for this Item.

* When adding the Item to the Purchase Order, you can see the Default Purchase UOM beside the Qty field. This indicates the UOM in which you are ordering the Item.<br>

  <figure><img src="/files/7oBSMNqmNms15ZrjSix0" alt=""><figcaption></figcaption></figure>
* Put in the value corresponding to that UOM. For instance, let’s suppose you are ordering 1000 grams of the item.
* You can see the UOM and the UOM Factor in the Purchase Order Details section.<br>

  <figure><img src="/files/6gihuRUJiWoAIddV7Ykq" alt=""><figcaption></figcaption></figure>
* As per the mapping, while 1000 grams are being ordered, your system will record 1 unit (i.e. 1 kilogram) inventory. This can be seen in the Item Inventory Snapshot.<br>

  <figure><img src="/files/UHwiY1MNZ0NKgNfN0Hkh" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/lhUxUUPpu6pqrwMLDPGi" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you are unable to find the **Multi UOM Mapping module** in the system, please check with your administrator to ensure that access to the module is enabled under **App Module Access**.
{% 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/admin/multi-uom/what-is-multi-uom-and-how-is-it-handled-in-xoro.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.