# What is an Item Receipt?

Item Receipts are the acknowledgment of Received Goods into Inventory. If XoroERP’s warehousing system is enabled, it can be automatically generated when an ASN is closed. Otherwise, they can be directly converted from Purchase Orders and they can also be entered manually.

Once an inventory item is saved to an Item Receipt, its on-hand quantity is increased. Item Receipts from the same Vendor can be merged and can be converted into Bills once they are finalized.

### Creating an Item Receipt

An item receipt is automatically generated once an ASN is received and closed. You can find the item receipt in the Item Receipt Centre.

You can use the Item Receipt module to create and edit item receipts.

The item receipt contains the details of the purchase, such as the store, the vendor, the item(s), and the amount payable.

{% hint style="info" %}
Please note that the Item Receipt is not payable. Convert the item receipt into the bill to make the payment.
{% endhint %}

#### Item Receipt Header Fields

<table><thead><tr><th width="137.33333333333331">Section</th><th width="168">Field </th><th>Description</th></tr></thead><tbody><tr><td>Receipt</td><td>Select Store</td><td>This field shows the store where the items are received.</td></tr><tr><td>Receipt</td><td>Date</td><td>This is the date on which the items were received.</td></tr><tr><td>Receipt</td><td>Select Account</td><td>This field displays the account payable for the order.</td></tr><tr><td>Receipt</td><td>Exchange Rate</td><td>If the receipt is for a foreign vendor, the exchange rate can be captured here.</td></tr><tr><td>Receipt</td><td>Packing Slip#</td><td>Enter the packing slip # from the vendor here.</td></tr><tr><td>Receipt</td><td>Total</td><td>This field captures the total amount of the item receipt.</td></tr><tr><td>Receipt</td><td>Select Vendor</td><td>Select the vendor you are purchasing from. This field is editable only before the <strong>Item Receipt</strong> is saved. Once the Item Receipt is created (saved), the vendor cannot be changed. To correct the vendor after creation, the <a href="/pages/fVrEaxmKYewt2AjCOwqK#voiding-an-item-receipt"><strong>Item Receipt</strong> must be voided</a> and recreated.</td></tr><tr><td>Receipt</td><td>Project/Class</td><td>Select a project or class to associate this item receipt with.</td></tr><tr><td>Receipt</td><td>Vendor Bill#</td><td>Specifies the <strong>vendor’s bill reference number</strong> associated with the transaction. </td></tr><tr><td>Other Info</td><td>Vendor Tax Code</td><td>This field allows you to select the tax code for the vendor. If there is a default tax code associated with the vendor, this field should already be fetched once a vendor is selected. Changing this allows you to apply a different tax code to all the items in the item receipt.</td></tr><tr><td>Other Info</td><td>Select Buyer</td><td>This field allows you to choose the Customer (if any) for whom the purchase order is being placed.</td></tr><tr><td>ASN Info</td><td>ASN Number</td><td>This field displays the ASN Number associated with this item receipt.</td></tr><tr><td>ASN Info</td><td>Created At</td><td>This field displays the date and time of ASN creation.</td></tr><tr><td>ASN Info</td><td>Created By</td><td>This field displays the user who created the ASN.</td></tr><tr><td>ASN Info</td><td>PO#</td><td>This field displays the purchase order associated with the item receipt.</td></tr><tr><td>ASN Info</td><td>Receipt Datetime</td><td>This field displays the date and time of item receipt creation.</td></tr><tr><td>ASN Info</td><td>Store</td><td>This field shows the store where the items are received.</td></tr><tr><td>ASN Info</td><td>Status</td><td>This field displays the status  of the ASN.</td></tr><tr><td>Custom Fields</td><td>Custom Fields</td><td>This section allows you to enter data in the custom fields defined for the item receipt entity. This feature provides the flexibility to capture and store additional information relevant to the item receipt.</td></tr><tr><td>Footer</td><td>Memo</td><td>This field captures any notes or additional information added to the purchase order.</td></tr><tr><td>Footer</td><td>Address</td><td>The address of the vendor is captured in this field. If the <strong>"Enable Vendor Address Update from Purchase Order, Item Receipt and Bill modules</strong>" app config is enabled, users will see a <strong>“Update Address in Vendor”</strong> toggle option when editing vendor address details. If users update the vendor address and enable this toggle, the changes will be automatically reflected in the associated vendor’s master record.</td></tr></tbody></table>

{% hint style="info" %}
If the **“**[**Disable Auto Populate Memo in IR/Bill**](/xoroerp-1/configuration/application/app-config/purchase.md#disable-auto-populate-memo-in-ir-bill)**”** app configuration is enabled, the system will not automatically populate the **Memo** field in the **Item Receipt** with the value from the Memo field of the **Purchase Order** from which the transaction was created.
{% endhint %}

#### Item Receipt Details Fields

<table><thead><tr><th width="133.33333333333331">Section</th><th width="144">Field </th><th>Description</th></tr></thead><tbody><tr><td>Items</td><td>Amount</td><td>Displays the calculated amount, which is the result of (Unit Price * Qty+Tax Amount-Disount).</td></tr><tr><td>Items</td><td>Description</td><td>This is an editable input field that displays the description of the item.</td></tr><tr><td>Items</td><td>Discount</td><td>This field allows you to apply a discount to the item.</td></tr><tr><td>Items</td><td>EUP</td><td>Indicates the Effective Unit Price for the item after discount.</td></tr><tr><td>Items</td><td>Expense Account</td><td>This fields allows you to select the account from which the money will be debited.</td></tr><tr><td>Items</td><td>Item#</td><td>The unique identifier for the item.</td></tr><tr><td>Items</td><td>Item Type</td><td>This field specifies the type of item, such as inventory, non-inventory, etc.</td></tr><tr><td>Items</td><td>Landed Amount</td><td>This is the total cost for acquiring all total item quantity, including the cost of shipping/freight.</td></tr><tr><td>Items</td><td>Landed Unit Cost</td><td>This is the total cost for acquiring a unit of item, including the cost of shipping/freight.</td></tr><tr><td>Items</td><td>PO#</td><td>If this item was received on a PO (through the warehousing system or converted directly), its number will be listed here.</td></tr><tr><td>Items</td><td>Project/Class</td><td>This field allows you to select a project or class to associate with the item line.</td></tr><tr><td>Items</td><td>Qty</td><td>This is an editable input field that specifies the quantity of the item.</td></tr><tr><td>Items</td><td>Status</td><td>This field displays the status of the ASN associated with this item receipt.</td></tr><tr><td>Items</td><td>Tax</td><td>This is the tax code of the item.</td></tr><tr><td>Items</td><td>Tax Amount</td><td>Displays the calculated tax amount for the item.</td></tr><tr><td>Items</td><td>Title</td><td>This field captures the title of the product.</td></tr><tr><td>Items</td><td>Unit Cost</td><td>This is an editable input field that allows you to edit the unit cost for the item.</td></tr><tr><td>Items</td><td>Uom</td><td>Specifies the unit of measure for the item (liter, unit, kilogram, etc.).</td></tr><tr><td>Items</td><td>Vendor Part#</td><td>This field captures the vendor part number added onto the purchase order.</td></tr><tr><td>Expense</td><td>Account</td><td>Select an account for adding an expense line.</td></tr><tr><td>Expense</td><td>Tax</td><td>Select a tax code for adding an expense line.</td></tr><tr><td>Expense</td><td>Amount</td><td>Enter an amount here for adding an expense line.</td></tr><tr><td>Expense</td><td>Project/Class</td><td>Select a project or class to associate this expense line with.</td></tr><tr><td>Expense</td><td>Memo</td><td>This field allows you to add any additional information or notes, if required, for adding an expense line.</td></tr></tbody></table>

### Item Receipt Options

#### Header Level Options

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

<table><thead><tr><th width="264">Field</th><th>Description</th></tr></thead><tbody><tr><td>Convert To Bill</td><td>Use this option to convert the item receipt to bill, which you can then pay.</td></tr><tr><td>Convert Selected Lines To Bill</td><td>Use this option to create a bill for selected lines of the item receipt.</td></tr><tr><td>Add PO Lines</td><td>Allows you to add an item line in the item receipt from other PO(s) of the same vendor.</td></tr><tr><td>Add To Email Queue</td><td>Places the item receipt in the email queue for sending at a later time.</td></tr><tr><td>Show Transactions</td><td>Show the Journal Transactional View for the item receipt.</td></tr><tr><td>Show Audit Trail</td><td>Shows the activity log or a detailed history of all the changes, actions, and interactions related to the item receipt.</td></tr><tr><td>Post as New Bill</td><td>This option allows users to post the <strong>entire Item Receipt</strong> as a <strong>new Vendor Bill</strong> in the system.</td></tr><tr><td><a href="#post-selected-lines-as-new-bill">Post Selected Lines as New Bill</a></td><td>This option enables users to select <strong>specific line items</strong> from an Item Receipt and post <strong>only those lines</strong> as a <strong>new Vendor Bill</strong>.</td></tr><tr><td>Void</td><td>Use this option to void the item receipt.</td></tr></tbody></table>

#### Line Level Options

<table><thead><tr><th width="248">Field</th><th>Description</th></tr></thead><tbody><tr><td>Print Label</td><td>Allows you to Print Item Label.</td></tr><tr><td>Batch Unit Cost</td><td>Allows updating unit cost for multiple line items at once.</td></tr><tr><td>Batch Discount</td><td>Allows applying discounts in bulk to multiple line items.</td></tr><tr><td>Batch Apply Custom Price</td><td>Provides sub-options for applying custom prices to multiple line items, including standard unit price, standard unit cost, and up to fourteen custom price options.</td></tr></tbody></table>

#### Sorting Item Receipt Items

Beside the Options menu in the details section of the item receipt, there is an option to sort the items. To sort the items, click on the "Sort By" option and select how you want to sort the items.

**Sorting Options**

The sorting options available include:

* **Item Number:** Arrange items either in ascending or descending order based on their item numbers.
* **Total Price:** Sort items based on their total price, helping you quickly identify high-value transactions. (Please note that this sorting option is unavailable in transfer orders as these orders do not involve pricing.)
* **Quantity:** Arrange items by quantity, aiding inventory management and tracking fulfillment.

### Item Receipt Reconciliation

When you receive inventory, you may be charged for shipping, freight, customs, and duty in addition to your existing Purchase Order.&#x20;

Item Receipt Reconciliation allows you to reconcile the cost of these additional charges with the cost of the newly received items. This ensures the average cost is as accurate as possible, reflecting your true revenue.

When doing a reconciliation, you can choose to add the additional cost to the vendor bill, create a separate expense bill, or generate a liability that can be converted to a bill later on. Refer to this article to learn about the item reconciliation process.

### Merging Item Receipts

Xoro provides you with the ability to merge Item Receipts. This allows you to combine multiple receipts into a single receipt, which can then be converted into a Bill. This can be useful in situations where you receive multiple shipments of goods from the same vendor but want to keep track of them as a single transaction in your system.

You can merge the item receipts from the Item Receipt Centre. Select the Item Receipts that you want to merge and go to Options > Merge.

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

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

You will be asked to select the primary receipt. Choose the desired Receipt and press OK.

<div align="left"><figure><img src="/files/KeWm453r7FaJIucEfpdh" alt=""><figcaption></figcaption></figure></div>

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

{% hint style="info" %}
**Please Note: Only the item receipts with the same "Vendor" and "Store" can be merged.**
{% endhint %}

### Post Selected Lines as New Bill

The **Post Selected Lines as New Bill** feature in the Item Receipt module allows users to selectively convert specific receipt lines into a new Vendor Bill instead of posting the entire receipt at once.

With the latest enhancement, the system now supports **line-level partial posting**, enabling users to enter a different **Post Amount** than the original receipt amount. The system automatically calculates and adjusts the Accounts Payable and Expense impact to maintain accounting accuracy, while preserving audit control and posting integrity.

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

#### Post as New Bill – Fields

| **Field Name**               | **Description**                                                                                            |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
| AP Account                   | Select the Accounts Payable account where the vendor liability will be recorded.                           |
| Memo                         | Optional note or reference for the Vendor Bill.                                                            |
| Post Amount\* (Header Level) | This field cannot be edited and Posting amount must be entered at the line level.                          |
| Vendor Bill#                 | Enter the vendor’s invoice/bill number for tracking purposes.                                              |
| Expense Account              | Account used to record adjustment differences created due to partial posting.                              |
| Bill Date\*                  | Specifies the date of the Vendor Bill. This is a mandatory field.                                          |
| Item#                        | Displays the selected Item Receipt lines being posted to the bill.                                         |
| Amount                       | Shows the original unit cost/amount from the Item Receipt. This field is read-only.                        |
| Post Amount (Line Level)     | Editable field where users enter the amount to be posted for each selected line. Supports partial posting. |

{% hint style="info" %}

### **Fields marked with an asterisk \* suffix are required fields**&#xD;

{% endhint %}

### **Voiding an Item Receipt**

Voiding an Item Receipt is required in scenarios such as correcting an incorrect vendor, item details, or other critical header-level information that cannot be edited after creation.&#x20;

To void an item receipt, first, undo the reconciliation (if any) by clicking on **"Undo Reconcile"**.

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

Then, you can proceed to remove the inventory items. To do that, click on the item's quantity, which will open the "Add/Change Item Receipt Qty" screen. From there, select the location and choose the quantity to "Pick".

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

Once all item lines have been successfully removed, navigate to the "Options" menu and select "Void" to complete the process of voiding the item receipt.

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


---

# Agent Instructions: 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:

```
GET https://docs.xorosoft.com/xoroerp-1/purchase/item-receipt/what-is-an-item-receipt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
