# Upload Bills

Bills are notices of payment sent from vendors and also act as documents for received goods. They are converted from item receipts or can be manually entered. Prepayments, payments, discounts, and vendor credits can be applied to bills.

### Uploading Bills

You can upload bills in bulk using the steps mentioned below:

* Download the latest CSV template from the **“Upload Bills**” module.
* Copy bill information into the CSV template.
* Upload the CSV template into Xoro.

### Downloading the CSV template

* Go to "**Batch Upload Bills"** module using the search menu.
* Click on “**Download Template**“.

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

### Copying the information into the template

Once you’ve downloaded the template file, you can copy your data using any spreadsheet software. There are columns that you must complete and others that are optional. Mandatory fields are marked with a double asterisk (\*\*) prefix.

Below are some points to be noted when entering the data into the template.

* 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 column headings from row 1 in the template as 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 %}

#### Upload Bills File Fields

<table><thead><tr><th width="254">Column Name</th><th width="109.33333333333331">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>**StoreCode</td><td>Text</td><td><p>Enter the store code linked to the bill. This must match exactly with the store code in Xoro.</p><p><strong>Note:</strong> If this field is blank it will be picked up from the upload default values.</p></td></tr><tr><td>**TxnDate</td><td>Date</td><td>Enter the transaction date of the bill in MM-DD-YYYY format.</td></tr><tr><td>**VendorName</td><td>Text</td><td>Enter the vendor name for the bill which has to match exactly with the vendor’s name in Xoro.</td></tr><tr><td>ItemExpenseAccountName</td><td>Text</td><td>If a valid Expense type account is entered here then it will be used as the offset account to the Accounts Payable for the bill. A valid account here will override the App Config Expense account.</td></tr><tr><td>**TotalAmt</td><td>Numeric</td><td>The amount of the bill in the decimal format (For example: 3245.12).</td></tr><tr><td>CurrencyCode</td><td>Text</td><td>Enter a currency for the order and this must match the customer’s currency, for instance, USD, CAD, etc. For more currencies, please contact Xorosoft.</td></tr><tr><td>ExchangeRate</td><td>Text</td><td>If the order is for a foreign customer, enter the exchange rate here. If your order currency is the same as your system home currency, then put “1” here.</td></tr><tr><td>RefNo</td><td>Text</td><td>A reference number can be associated with the bill here.</td></tr><tr><td>Memo</td><td>Text</td><td>This field allows you to provide any notes or any additional information related to the bill. This allows you to add important details or instructions that need to be considered during bill processing.</td></tr><tr><td>BillFromFirstName</td><td>Text</td><td>Enter the first name of the individual linked to the billing address for the order.</td></tr><tr><td>BillFromLastName</td><td>Text</td><td>Enter the last name of the individual linked to the billing address for the order.</td></tr><tr><td>BillFromCompanyName</td><td>Text</td><td>Enter the name of the company to which the bill is being issued.</td></tr><tr><td>VendorAddress</td><td>Text</td><td>Enter the vendor’s address.</td></tr><tr><td>BillFromAddress2</td><td>Text</td><td>This is an additional field that allows you to enter the extended billing address, in case the address is lengthy.</td></tr><tr><td>VendorCity</td><td>Text</td><td>Enter the vendor’s city.</td></tr><tr><td>VendorState</td><td>Text</td><td>Enter the vendor’s state.</td></tr><tr><td>VendorCountry</td><td>Text</td><td>Enter the vendor’s country</td></tr><tr><td>VendorPostalZipCode</td><td>Text</td><td>Enter the vendor’s pin code.</td></tr><tr><td>BillFromPhoneNumber</td><td>Numeric</td><td>Enter the phone number associated with the billing address.</td></tr><tr><td>BillFromEmail</td><td>Text</td><td>Enter the email address of the recipient or the individual representing the billing address.</td></tr><tr><td>ProjectClassName</td><td>Text</td><td>Enter the project/class to associate with the bill.</td></tr><tr><td>ImportError</td><td>Text</td><td>If there are any errors from the upload, they will be listed in this column.</td></tr></tbody></table>

### Uploading the template

Once you have filled out the CSV file with your data, you can follow the steps below to upload it into Xoro:

* The **Default values** for required columns can be configured before the upload.

  <figure><img src="/files/Wh4K14LjxYf75F1vIa4O" alt=""><figcaption></figcaption></figure>
* If the data in the template is blank or incorrect, then the uploader will fall back and use these specified default values.
* Click "**Browse"** to select the saved CSV template file.

  <figure><img src="/files/zKTZjK8jYRlqoc6zSGAv" alt=""><figcaption></figcaption></figure>
* After the file has been selected, click **Verify & Upload** to start importing.

  <figure><img src="/files/NjzrGKXEgdfXNDhoPCdb" alt=""><figcaption></figcaption></figure>
* 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 a message for success or error (if any).
* Bills 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 bills by clicking **Download Existing Bills**, update the necessary values in the CSV file, and upload it back into Xoro.*
{% endhint %}


---

# 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/utilities/data-imports/upload-bills.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.