# Creating a Sales Estimate

Creating sales estimates in XoroERP involves entering details of items and services for which your customers have requested a quotation. By doing so, customers can grasp the details of the items and associated costs, making it easier for them to accept the estimate.

### Entering a Sales Estimate

When entering an estimate, you'll start by entering essential header-level information, such as the store, customer details, order date, and validity date. 

{% hint style="info" %}
*To create an estimate, go to **Menu > Sales > Estimate***
{% endhint %}

#### Estimate header fields

<table><thead><tr><th width="133">Section</th><th width="307">Field</th><th>Description</th></tr></thead><tbody><tr><td>Sales</td><td>Sale Store</td><td>This is the store from which the sale is being processed.</td></tr><tr><td>Sales</td><td>Ship Store</td><td>This is the store from which the estimate is being shipped. You can change this store if the goods are being shipped or picked up from another location.</td></tr><tr><td>Sales</td><td>Payment Term</td><td>You can specify the agreed-upon terms of payment for the estimate, defining when and how the customer should make the payment.</td></tr><tr><td>Sales</td><td>Ref No</td><td>A reference number can be entered here. Often this can be to an old Estimate# or an Estimate# from another system.</td></tr><tr><td>Sales</td><td>Select Customer</td><td>Type a name, phone number, or email here to select a customer for the order. Click the "i" icon (<img src="/files/493yrQWRhcDSXcpZX9sH" alt="">) for more details on the selected customer.</td></tr><tr><td>Sales</td><td>Customer Tax Code</td><td>This is the tax code associated with the customer record. Changing this allows you to apply a different tax code to all the items in the SO. This field should be automatically fetched once a customer has been selected. This field can also be configured to be calculated automatically based on the customer's shipping address for customers from the US and Canada.</td></tr><tr><td>Sales</td><td>Date</td><td>This is the date the estimate is being recorded.</td></tr><tr><td>Sales</td><td>Valid Until Date</td><td>Select a date here to keep a track of how long this estimate will be valid for. By default, the validity of the estimate is 60 days. However, you can update the time period for the valid until date in the "<strong>Date offsets for Sales Order, Estimate and Invoice Date"</strong> app config<strong>.</strong></td></tr><tr><td>Sales</td><td>Sales Rep</td><td>This is the Sales Rep for this estimate. Once a customer has been selected, this field will automatically be filled.</td></tr><tr><td>Sales</td><td>Follow Up Date</td><td>Select a follow-up date for the estimate here. This date is used in the Sales Rep Dashboard to indicate Estimates that need following up. By default, it is one week after the estimate date. However, you can update the time period for the follow-up date in the "<strong>Date offsets for Sales Order, Estimate and Invoice Date"</strong> app config<strong>.</strong></td></tr><tr><td>Sales</td><td>Require Advance Payment</td><td>Use this field to enter an advance payment that is required from the customer; you can select an absolute amount or percentage of the order. This payment will be required to process the sales order. </td></tr><tr><td>Sales</td><td>Project/Class</td><td>Select a project or class to associate with this estimate.</td></tr><tr><td>Sales</td><td>Third Party Ref No</td><td>This field allows you to enter a third-party reference number for the estimate to improve cross-document traceability.</td></tr><tr><td>Shipping</td><td>Ship Method</td><td>This field enables you to select the preferred method of shipment for the estimate. Select "Pick Up" if the customer is picking up the goods by themselves. Select "Delivery (Own Truck)" if your own company’s truck will be used for the delivery. Select "Delivery (Third Party)" if an external company will be shipping the goods for you.</td></tr><tr><td>Shipping</td><td>Ship Via/Carrier</td><td>Specify the carrier or shipping service responsible for delivering the order to the customer. If Delivery (Own Truck) is selected, the company’s own carrier can be selected. If however Delivery (Third Party) is selected, choose another company’s carrier for shipping (FedEx, UPS, etc.).</td></tr><tr><td>Shipping</td><td>F.O.B</td><td>Specify the freight on board - origin or destination.</td></tr><tr><td>Shipping</td><td>Total Weight</td><td>Specify the total estimated weight of the shipment for tracking and logistics purposes.</td></tr><tr><td>Shipping</td><td>Shipping Account Number</td><td>This field allows you to enter the unique identification number associated with a shipping or freight account. This number is used by shipping carriers or freight companies to track and bill shipments.</td></tr><tr><td>Shipping</td><td>Shipping Terms</td><td>This field allows you to specify the Shipping Terms options for the estimate. Available options are- Prepaid, Collect, Prepaid &#x26; Billed, Collect &#x26; Allowed, Third Party Billing.</td></tr><tr><td>Shipping</td><td>Ship Service</td><td>This field allows you to specify the type of shipping service for the estimate, such as Standard Ground, Express Overnight, Two-Day Delivery, etc.</td></tr><tr><td>Shipping</td><td>Ship Package Type</td><td>This field allows you to specify the type of packaging used for the order shipment, such as "Box," "Envelope," or "Pallet".</td></tr><tr><td>Shipping</td><td>Shipping Notes</td><td>This field allows you to add any relevant notes or instructions related to the shipment.</td></tr><tr><td>Shipping</td><td>Estimated Ship Date</td><td>This field allows you to specify the date on which the order is estimated to be shipped.</td></tr><tr><td>Shipping</td><td>Shipping Cost</td><td>You can specify the total cost that will be incurred for shipping the order in this field.</td></tr><tr><td>Shipping</td><td>Tax Code</td><td>This field allows you to specify the tax code applicable for the shipping charges.</td></tr><tr><td>Shipping</td><td>Shipping Tax Amount</td><td>Specify the amount of tax applied to the shipping costs here.</td></tr><tr><td>Shipping</td><td>Total Amount</td><td>This field displays the overall total cost of the shipping, including shipping taxes.</td></tr><tr><td>Others</td><td>Order Tags</td><td>Allows users to assign tags to the estimate for categorization and easier filtering.</td></tr><tr><td>Others</td><td>Risk Analysis</td><td>This field displays risk-related information associated with the estimate.</td></tr><tr><td>Others</td><td>Custom Comment</td><td>Allows users to enter custom notes or comments related to the estimate.</td></tr><tr><td>Others</td><td>Order Type</td><td>A dropdown field that allows users to select the type of order. The available options are configured in the system and may include values such as Shopify, Wholesale, Warranty, B2B, D2C, PROMO, and other custom order types.</td></tr><tr><td>Others</td><td>Brand</td><td>A dropdown field that allows users to associate the estimate with a specific brand.</td></tr><tr><td>Footer</td><td>Bill To Address</td><td>This field displays the billing address for the estimate. When you select a customer, this field is automatically populated with the associated billing address, which can be edited as needed.</td></tr><tr><td>Footer</td><td>Ship To Address</td><td>This field displays the shipping address for the estimate. When a customer is selected, this field is automatically filled with the corresponding shipping address. You can choose other addresses from the drop-down menu or edit the address by clicking on it.</td></tr><tr><td>Footer</td><td>Exchange Rate</td><td>If the estimate is for a foreign customer, the "Exchange Rate" field allows you to specify the conversion rate for currency exchange.</td></tr><tr><td>Footer</td><td>Customer Message</td><td>In this field, you can enter a personalized message for the customer or choose from pre-written messages to include in the estimate printout.</td></tr><tr><td>Footer</td><td>Memo</td><td>This field provides space for writing notes or any additional information related to the order. This allows you to add important details or instructions that need to be considered during order processing.</td></tr></tbody></table>

### Adding Lines to an Estimate

After inputting the header level information in the estimate, you'll proceed to enter line-level details, which encompass the specific goods and services requested by the customer. In the line-level section, you can add individual items, and specify their quantities, unit prices, and any applicable discounts or taxes.

There are multiple ways to add an item to a sales order and are listed as follows:

* **Add Item**: This option allows you to add a single item at a time to the estimate, ideal for quickly including individual items with specific attributes or quantities. To use this option, click the "Add Item" button in the Estimate Details section.
* **Advanced Variant Finder**: With the Advanced Variant Finder, you can efficiently bulk add items using a variant grid view, perfect for managing complex product configurations or multiple variants in a single operation. To use this option, click the "Advanced Variant Finder" button in the Estimate Details section. \
  \
  XoroERP allows you to update the price of the item directly from the Advance Variant Finder option. This feature is based on the app config, “**Enable Price Edit in Advance Variant Finder**”. <br>

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

  If this configuration is turned ON, a new price field will be displayed in the Advance Variant Finder pop-up. By default, the price field will be automatically pre-filled with the minimum price obtained from all items with the same Option 1. For example, if the Option 1 code is "XL" and there are 5 items with "XL," the minimum price from those items will be set as the default value in the price field.

  <br>

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

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

  Users have the liberty to modify the price in the field as needed. You can update the price according to your specific requirements. <br>

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

  \
  However, please note that, if you manually update the price from the "Unit Price Column", when you open the advance variant finder in the edit state then the price field will be disabled.<br>

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

  <figure><img src="/files/wdz6a90er5hsTK1V8XG5" alt=""><figcaption></figcaption></figure>
* **Quick Add Items**: The Quick Add Items feature enables the bulk addition of items to the sales order using a table form with search capabilities, making it a convenient choice for quickly populating the order with multiple items. To use this option, click the "Quick Add Items" button in the Estimate Detailssection.
* **Last Ordered Items**: This option allows you to bulk add items or easily repeat items from the customer's last ordered items, streamlining the reordering process for frequently purchased items. To use this option, click the "Last Ordered Items" button in the Estimate Details section.
* **Kit Finder**: The Kit Finder feature simplifies adding kits to the sales order, allowing you to efficiently include pre-configured sets of items or components with a single selection. To use this option, click the "Kit Finder" button in the Estimate Details section.

{% hint style="info" %}
Use the convenient keyboard shortcut **(Alt+A)** for the "Add Item" option
{% endhint %}

#### Estimate Line Fields

<table><thead><tr><th width="239">Field</th><th>Description</th></tr></thead><tbody><tr><td>Item#</td><td>The unique identifier for the item.</td></tr><tr><td>Item Type</td><td>This field displays the type of item, such as inventory, non-inventory, etc.</td></tr><tr><td>Description</td><td>This is an editable input field that displays the description of the item.</td></tr><tr><td>Unit Price</td><td>This is an editable input field that allows you to edit the unit price for the item.</td></tr><tr><td>Discount Type</td><td>Specifies the type of discount applied to the item: Percentage or Flat Amount. </td></tr><tr><td>Discount</td><td>This field allows you to apply a discount to the item.</td></tr><tr><td>Customer Item#</td><td>This field display's the item number assigned by the customer in item customer mapping module.</td></tr><tr><td>Qty</td><td>This is an editable input field that specifies the order quantity of the item.</td></tr><tr><td>Uom</td><td>This field specifies the unit of measure for the item (liter, unit, kilogram, etc.).</td></tr><tr><td>Notes</td><td>This field provides the ability to add notes or additional information for the item line.</td></tr><tr><td>Tax</td><td>This is an editable input field that specifies the tax code applied to the item.</td></tr><tr><td>Tax Amount</td><td>This field displays the calculated tax amount for the item.</td></tr><tr><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>EUP</td><td>This field indicates the Effective Unit Price for the item after the discount.</td></tr><tr><td>Availability</td><td>This field indicates whether the item is available or unavailable for sale from its Ship Store.</td></tr><tr><td>VAS Item</td><td>This is an editable input field that indicates whether the item has a VAS (Value-Added Service) item applied to it or not.</td></tr><tr><td>VAS Item Unit Cost</td><td>This field displays the unit cost for the Value-Added Service item.</td></tr><tr><td>VAS Item Total Cost</td><td>This field displays the total cost for the Value-Added Service item.</td></tr><tr><td>Amount</td><td>This field displays the calculated amount, which is the result of (Unit Price * Qty - Discount).</td></tr><tr><td>Alternative Item Number1</td><td>This field displays an alternative item number1 for the item, providing additional identification.</td></tr><tr><td>Alternative Item Number2</td><td>This field displays an alternative item number2 for the item, providing additional identification.</td></tr><tr><td>Alternative Item Number3</td><td>This field displays an alternative item number3 for the item, providing additional identification.</td></tr><tr><td>Barcode</td><td>This field allows you to enter the barcode associated with the item.</td></tr><tr><td>Pencil Icon</td><td>This field allows you to update the item quantity (add a new item or remove any item (set the qty to 0 to remove it)). If the “Enable Price Edit in Advance Variant Finder” app config is on, there will also be an option to edit the price in the advance variant finder.</td></tr><tr><td>Case Qty</td><td>Case Quantity is calculates as Item Quantity/Master Case Quantity</td></tr><tr><td>Master Case Qty</td><td>The Master Case Quantity defines the total number of individual units packed within a single master case.</td></tr></tbody></table>

After completing the header fields and adding items, click on the **"Save"** button to create an estimate. The system will automatically assign a unique number to the estimate in the format of ES-E000001, where "ES" denotes the sales store code and 1 denotes a sequential series. This number will be displayed on the top left corner of the page. Once this number is generated, it becomes a permanent identifier and cannot be altered.

When the estimate is converted into a sales order, the SO number remains the same as the estimate number.

{% hint style="info" %}
*Use the convenient keyboard shortcut **(Alt+S)** for the "Save" action and **(Alt+N)** for the "Save and New" action.*
{% endhint %}

The new estimate will be created in the **Open** status. For more details on the estimate statuses, read [***Estimate statuses***](/xoroerp-1/sales/estimate/what-is-a-sales-estimate.md#estimate-statuses).


---

# 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/sales/estimate/what-is-a-sales-estimate/creating-a-sales-estimate.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.