# Purchase Settings

<p class="doc-lead">Purchase Settings control optional fields, pricing behaviour, discounts, bill layout, data-entry rules, and Quick Purchase options for the entire Purchase module. Configure these once before creating quotations, orders, invoices, and other purchase documents.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/purchase/purchase-settings-config?id=overview">Overview</a>
<a href="#/purchase/purchase-settings-config?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Settings reference</span>
<div class="doc-toc-links">
<a href="#/purchase/purchase-settings-config?id=general-basic">General &amp; Basic Settings</a>
<a href="#/purchase/purchase-settings-config?id=invoice-fields">Invoice Fields &amp; Data Points</a>
<a href="#/purchase/purchase-settings-config?id=data-entry-rules">Data Entry Rules</a>
<a href="#/purchase/purchase-settings-config?id=price">Price</a>
<a href="#/purchase/purchase-settings-config?id=discounts">Discounts</a>
<a href="#/purchase/purchase-settings-config?id=bill-layout">Bill Layout</a>
<a href="#/purchase/purchase-settings-config?id=quick-purchase">Quick Purchase Settings</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/purchase/purchase-settings-config?id=actions">Actions</a>
<a href="#/purchase/purchase-settings-config?id=faq">FAQ</a>
<a href="#/purchase/purchase-settings-config?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; Form View</h2>

Go to <b>Purchase → Settings → Purchase Settings</b> from the left menu.

This is a <b>single settings form</b> — not a list. One record exists per company. Open the page, adjust options in the grouped sections, and click <b>Update</b>. Changes apply company-wide to all purchase transactions after save.

<b>Purchase Settings</b>

<img src="purchase/images/ps1.webp" alt="Purchase Settings" loading="lazy">

Purchase Settings do not post to accounts or inventory. They only control which fields appear, how prices and discounts behave, and how bills print.

<b>Form sections</b>

| **Section** | **Purpose** |
|-------------|-------------|
| General &amp; Basic Settings | Optional header fields on purchase documents |
| Invoice Fields &amp; Data Points | Extra item-line columns and charge fields on bills |
| Data Entry Rules | Validation on suppliers, mandatory fields, over-receipt, and direct invoice rules |
| Price | Previous-supplier price and Basic Pricing update behaviour |
| Discounts | Trade discounts, item-line vs invoice-level discounts |
| Bill Layout | Print layout for totals and tax-inclusive item lines |
| Quick Purchase Settings | Options for Quick Purchase / POS entry only |

<b>Conditional fields</b>

| **Field** | **Shown when** |
|-----------|----------------|
| Set the purchase price to zero if there is no previous price for the supplier | <b>Fetch the previous purchase price for the supplier</b> is enabled |
| Discount in, Discount Method, After-tax invoice discount?, Trade discount | <b>Has discounts</b> is enabled |
| Trade discount | <b>Has discounts</b> is on and company country is India |
| Brand, Batch, Serial Numbers, Variants, Inventory Bin in item line fields | Matching inventory feature is enabled for your company role |

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start</h2>

<h3>1. Navigate</h3>
Go to <b>Purchase → Settings → Purchase Settings</b>.

<h3>2. Review each section</h3>
Work through the sections from top to bottom: General &amp; Basic Settings, Invoice Fields &amp; Data Points, Data Entry Rules, Price, Discounts, Bill Layout, and Quick Purchase Settings.

<h3>3. Save</h3>
Click <b>Update</b> to save. Use <b>Reset</b> to reload the last saved values, or <b>Cancel</b> to leave without saving.

<hr class="doc-section-divider">

<h2 id="general-basic">General &amp; Basic Settings</h2>

<h3 id="has-reference-name">Show field for reference name</h3>

| | |
|---|---|
| **What it does** | Shows the <b>Reference name</b> header field on standard purchase entry screens. Use it for an internal or supplier-side reference label that is separate from the bill number. |
| **Screens affected** | Purchase Quotation, Purchase Order, Purchase Invoice, Debit Note, Purchase Return Order, Work Order |
| **Reports** | No — reference name is not a standard report column. It may appear on printed bills when filled in. |

<h3 id="has-supplier-invoice-date">Show Supplier Invoice Date</h3>

| | |
|---|---|
| **What it does** | Shows the <b>Supplier Invoice Date</b> field on purchase bills. Records the date printed on the supplier's invoice, which may differ from the transaction date. |
| **Screens affected** | Purchase Invoice, Debit Note |
| **Reports** | Yes — <a href="#/purchase/reports/purchase-bill-report">Bill Wise Purchase</a> shows a <b>Supp. Inv Date</b> column when any bill in the result has a supplier invoice date. |

<h3 id="has-prepared-by">Show Prepared by field (In Purchase Order)</h3>

| | |
|---|---|
| **What it does** | Shows the <b>Prepared By</b> employee field on Purchase Order entry and view screens. |
| **Screens affected** | Purchase Order only |
| **Reports** | No dedicated report column. The field may appear on printed purchase orders. |

<hr class="doc-section-divider">

<h2 id="invoice-fields">Invoice Fields &amp; Data Points</h2>

<h3 id="additional-item-line-fields">Select additional item line fields you will like to Add</h3>

| | |
|---|---|
| **What it does** | Adds optional columns to the item line grid on purchase bills. Select one or more fields from the list. Some options (Brand, Batch, Serial Numbers, Variants, Inventory Bin) appear only when the corresponding inventory feature is enabled for your company. |
| **Available options** | Description, Item code, HSN number, Barcode, Taxable Amount, Brand, Batch, Batch Expiry, Batch Manufacturing Date, Serial Numbers, Variants, Inventory Bin, No of Rolls, Length, Width |
| **Screens affected** | Purchase Quotation, Purchase Order, Purchase Invoice, Debit Note, Purchase Return Order, Work Order |
| **Reports** | Yes — enabled line fields can appear in <a href="#/purchase/reports/purchase-bill-report-adv">Bill Wise Purchase Advanced</a> and other item-wise purchase reports when those columns are included in the report layout. |

<h3 id="additional-charges">Select additional charges you will like to Add</h3>

| | |
|---|---|
| **What it does** | Shows selected charge fields in the totals area of purchase bills. |
| **Available options** | Shipping Charge, Miscellaneous charge, TCS |
| **Screens affected** | Purchase Quotation, Purchase Order, Purchase Invoice, Debit Note, Purchase Return Order, Work Order |
| **Reports** | Charge amounts flow into bill totals on purchase reports; there is no separate charge-only report. |

<hr class="doc-section-divider">

<h2 id="data-entry-rules">Data Entry Rules</h2>

<h3 id="prevent-duplicate-supplier-invoice">Prevent duplicate supplier invoice number</h3>

| | |
|---|---|
| **What it does** | Blocks saving a Purchase Invoice when the same supplier already has another approved invoice with the same supplier invoice number (<b>Invoice Ref No</b>). Draft and cancelled invoices are ignored. |
| **Screens affected** | Purchase Invoice |
| **Reports** | No — this is a validation rule at save time only. |

<h3 id="prevent-duplicate-supplier-invoice-financial-year">Prevent duplicate supplier invoice number in current financial year only</h3>

| | |
|---|---|
| **What it does** | Limits the duplicate check above to the <b>current financial year</b> instead of all-time. The same supplier invoice number can be reused across different financial years, but not twice within the same one. The financial year is taken from the invoice date. |
| **Financial year** | India: <b>1 April – 31 March</b>. All other countries: <b>1 January – 31 December</b> (calendar year). |
| **Depends on** | Shown and applied only when <b>Prevent duplicate supplier invoice number</b> is enabled. |
| **Screens affected** | Purchase Invoice |
| **Reports** | No — this is a validation rule at save time only. |

<h3 id="prevent-duplicate-invoice-no">Prevent Duplicate invoice number</h3>

| | |
|---|---|
| **What it does** | Blocks saving a Purchase Invoice when another approved or closed invoice already uses the same <b>Bill number</b>. |
| **Screens affected** | Purchase Invoice |
| **Reports** | No — validation at save time only. |

<h3 id="prevent-over-receipt">Prevent over receipt from purchase order</h3>

| | |
|---|---|
| **What it does** | Blocks received quantities that exceed the remaining unordered quantity on the linked purchase order line. Totals include other open and approved receipts against the same order. |
| **Screens affected** | <a href="#/inventory/goods-receipt-note">Goods Receipt Note</a> and Service Receipt Note when linked from a Purchase Order — checked on update and approve |
| **Reports** | No — validation at save / approve time only. |

<h3 id="prevent-direct-purchase-invoice">Prevent direct creation of purchase invoice</h3>

| | |
|---|---|
| **What it does** | Requires a linked purchase order when creating a Purchase Invoice (opening-balance invoices are exempt). <b>New</b> and <b>Quick</b> on the purchase invoice list are hidden when this setting is on — create invoices from a purchase order or receipt note instead. |
| **Screens affected** | <a href="#/purchase/purchase-invoice">Purchase Invoice</a> — create |
| **Reports** | No — validation at create time only. |

<h3 id="supplier-mandatory-fields">Supplier mandatory fields</h3>

| | |
|---|---|
| **What it does** | Requires the selected fields when creating or updating a supplier. Save is rejected with a message listing any missing fields. |
| **Available options** | Supplier Group, Phone, Email, State, Country |
| **Screens affected** | <a href="#/purchase/suppliers">Suppliers</a> — New and Edit supplier forms. State and Country are checked on the first address line. |
| **Reports** | No — affects supplier master data only. |

<h3 id="purchase-invoice-mandatory-fields">Purchase invoice mandatory fields</h3>

| | |
|---|---|
| **What it does** | Requires the selected header fields when creating or updating a standard <b>Purchase Invoice</b>. Save is rejected on the screen and by the API with a message listing any missing fields. |
| **Available options** | Supplier Invoice Reference Number, Payment Term, Project (shown only when your role has Project module access) |
| **Screens affected** | <a href="#/purchase/purchase-invoice">Purchase Invoice</a> — standard full-form entry only (not Quick Purchase or Debit Note) |
| **Reports** | No — validation at save time only. |

<b>Conditional validation</b>

| **Field** | **Required when** |
|-----------|-------------------|
| Supplier Invoice Reference Number | Always, when selected in this list |
| Payment Term | Only when the Payment Term field is shown on the invoice — credit-style payment with due dates configured to use payment terms in <a href="#/settings/transaction-preferences">Transaction Preferences</a>, and not hidden by purchase-order balance rules |
| Project | Always, when selected in this list and Project module is enabled |

<hr class="doc-section-divider">

<h2 id="price">Price</h2>

<p>On purchase bill entry, item <b>Rate</b> is resolved in this order:</p>

<ol>
<li><b>Previous supplier price</b> — last rate for this supplier + item + unit when <b>Fetch the previous purchase price for the supplier</b> is enabled below. <b>Set the purchase price to zero if there is no previous price for the supplier</b> stops the chain at zero instead of falling through.</li>
<li><b>Pricing Rule</b> — supplier-specific → supplier group → generic. A <b>Price</b> scheme sets the rate; discount schemes fill discount fields and the chain continues for the base rate. See <a href="#/purchase/pricing-rules">Pricing Rule</a>.</li>
<li><b>Basic Pricing</b> — grid purchase price, supplier group column when applicable, item UOM cost, or item master <b>costPrice</b>. See <a href="#/purchase/basic-pricing">Basic Pricing</a>.</li>
</ol>

<p><b>Set default purchase price from last purchase invoice</b> (below) updates Basic Pricing when a Purchase Invoice is approved — it does not change the resolution order on bill entry.</p>

<h3 id="prev-supplier-price">Fetch the previous purchase price for the supplier</h3>

| | |
|---|---|
| **What it does** | When you select an item on a purchase bill, the system looks up the last purchase rate for that item, unit, and supplier and fills the <b>Rate</b> automatically. Uses tax-exclusive or tax-inclusive price to match the bill's rate type. |
| **Screens affected** | Purchase Quotation, Purchase Order, Purchase Invoice, Debit Note, Purchase Return Order, Work Order |
| **Reports** | No — affects data entry only. Reported purchase values reflect whatever rate was saved on the bill. |

<h3 id="zero-price-if-not-previous">Set the purchase price to zero if there is no previous price for the supplier</h3>

| | |
|---|---|
| **What it does** | Shown only when <b>Fetch the previous purchase price for the supplier</b> is enabled. If no previous supplier rate exists, the item <b>Rate</b> defaults to zero instead of falling back to Basic Pricing or item default cost. |
| **Screens affected** | Same purchase bill screens as previous-supplier-price setting |
| **Reports** | No — data entry only. |

<h3 id="set-default-cost-from-last-purchase">Set default purchase price from last purchase invoice</h3>

| | |
|---|---|
| **What it does** | When a Purchase Invoice is approved, updates the item's purchase price in <a href="#/purchase/basic-pricing">Basic Pricing</a> from the invoiced rates (unless the invoice uses a foreign currency or is an opening-balance invoice). |
| **Screens affected** | Purchase Invoice (on approve); <a href="#/purchase/basic-pricing">Basic Pricing</a> (prices updated as a side effect) |
| **Reports** | No direct report impact. Future purchase entry may pick up the updated Basic Pricing rate. |

<hr class="doc-section-divider">

<h2 id="discounts">Discounts</h2>

<p>When <b>Has discounts</b> is off, discount columns and invoice-level discount fields are hidden on purchase bills. When on, the dependent fields below become visible and required.</p>

<h3 id="has-discount">Has discounts</h3>

| | |
|---|---|
| **What it does** | Master switch for trade discounts, item-line discounts, and invoice-level discounts on purchase bills. |
| **Screens affected** | Purchase Quotation, Purchase Order, Purchase Invoice, Debit Note, Purchase Return Order, Work Order |
| **Reports** | Discount columns appear on purchase reports when discounts exist on saved transactions. |

<h3 id="discount-in">Discount in</h3>

| | |
|---|---|
| **What it does** | Chooses where discounts are entered. <b>Item line</b> — per-line discount fields. <b>Invoice level</b> — a single discount on the bill header/totals area. |
| **Screens affected** | All purchase bill screens listed above |
| **Reports** | Report discount columns reflect saved item-line or invoice-level discounts. |

<h3 id="discount-method">Discount Method</h3>

| | |
|---|---|
| **What it does** | Sets whether invoice-level discount is entered as a fixed <b>Value</b> or <b>Percentage</b>. |
| **Screens affected** | Purchase bills when <b>Discount in</b> is set to <b>Invoice level</b> |
| **Reports** | No separate setting — saved discount amounts appear on reports. |

<h3 id="after-tax-invoice-discount">After-tax invoice discount?</h3>

| | |
|---|---|
| **What it does** | When enabled with invoice-level discounts, allows an invoice discount to be applied after tax is calculated rather than before. |
| **Screens affected** | Purchase bill entry and totals calculation |
| **Reports** | Totals on purchase reports reflect the after-tax discount when used. |

<h3 id="trade-discount">Trade discount</h3>

| | |
|---|---|
| **What it does** | Shows the <b>Trade Discount</b> column on item lines. Available for India companies when <b>Has discounts</b> is enabled. Hidden for tax-inclusive bills using percentage invoice discount in some combinations. |
| **Screens affected** | Purchase Quotation, Purchase Order, Purchase Invoice, Debit Note, Purchase Return Order, Work Order |
| **Reports** | Trade discount values appear on item-wise purchase reports when present on saved lines. |

<hr class="doc-section-divider">

<h2 id="bill-layout">Bill Layout</h2>

<h3 id="bill-totals-view">Bill totals view in *</h3>

| | |
|---|---|
| **What it does** | Controls how the totals block is arranged on printed and previewed purchase bills. <b>Row</b> — totals sit in a row alongside item lines. <b>Column</b> — totals stack in a column layout. Required field. |
| **Screens affected** | Print and preview for Purchase Quotation, Purchase Order, Purchase Invoice, Debit Note, Purchase Return Order, Work Order |
| **Reports** | Affects printed/PDF bill layout only, not tabular Excel reports. |

<h3 id="item-line-layout">Item line layout (tax inclusive) *</h3>

| | |
|---|---|
| **What it does** | Chooses column order for item lines on tax-inclusive purchase bills. Required field. |
| **Options** | <b>Layout 1</b> — Sl No, Item, Qty, Unit, Price, Amount, Discount, Taxable Amount, Taxes, Tax Amount, Total<br><b>Layout 2</b> — Sl No, Item, Qty, Unit, Price, Price inc tax, Discount inc tax, Taxable Amount, Taxes, Tax Amount, Total |
| **Screens affected** | Print and preview for purchase bills when the bill rate type is tax inclusive |
| **Reports** | Print/PDF layout only. |

<hr class="doc-section-divider">

<h2 id="quick-purchase">Quick Purchase Settings</h2>

<p>These settings apply to the Quick Purchase (POS-style) purchase entry flow, not standard full-form purchase screens.</p>

<h3 id="date-change-quick-purchase">Provision to change date</h3>

| | |
|---|---|
| **What it does** | Allows changing the transaction date on the Quick Purchase screen. When off, the date field is fixed to the current date/time. |
| **Screens affected** | Quick Purchase entry only |
| **Reports** | No — affects which date is stored on invoices created through Quick Purchase. |

<h3 id="reference-name-quick-purchase">Add Reference name</h3>

| | |
|---|---|
| **What it does** | Shows the <b>Reference name</b> field on Quick Purchase entry. Separate from <b>Show field for reference name</b>, which controls standard purchase forms. |
| **Screens affected** | Quick Purchase entry only |
| **Reports** | No dedicated report column. |

<hr class="doc-section-divider">

<h2 id="actions">Actions</h2>

| **Button** | **Description** |
|------------|-----------------|
| Update | Saves all Purchase Settings. |
| Reset | Reloads the form with the last saved values. |
| Cancel | Closes without saving. |

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Do Purchase Settings affect existing approved bills?</b><br>
No. They affect new entry, editing of open drafts, print layout, and validation going forward. Approved bill line data is not recalculated when you change settings.

<b>Why do I not see Brand or Batch in additional item line fields?</b><br>
Those options require the corresponding inventory features (brand tracking, batch tracking, etc.) to be enabled for your company.

<b>Why is Trade discount hidden?</b><br>
Trade discount appears only when <b>Has discounts</b> is on and your company country is India.

<b>What is the difference between the two reference name settings?</b><br>
<b>Show field for reference name</b> applies to full purchase forms. <b>Add Reference name</b> under Quick Purchase Settings applies only to Quick Purchase.

<b>Which setting stops duplicate supplier invoice numbers?</b><br>
<b>Prevent duplicate supplier invoice number</b> checks the supplier invoice reference against other approved invoices for the same supplier.

<b>Can I allow the same supplier invoice number in a new financial year?</b><br>
Yes. Enable <b>Prevent duplicate supplier invoice number in current financial year only</b> (available when the duplicate check is on). The number is then checked only within the invoice's financial year — India uses 1 April – 31 March, other countries use the calendar year — so the same number can be reused in a later year.

<b>What does Prevent duplicate supplier reference number do?</b><br>
Blocks saving when the same supplier reference number already exists on another approved purchase document for that supplier.

<b>What does Prevent over receipt from purchase order do?</b><br>
Blocks receipt note (and service receipt note) quantities that exceed remaining purchase order quantity — enforced on update and approve of linked documents.

<b>What does Prevent direct creation of purchase invoice do?</b><br>
Stops users from creating a standalone purchase invoice with <b>New</b> or <b>Quick</b>. Invoices must be created from a purchase order (or receipt note flow). Opening-balance invoices are still allowed.

<b>How does Previous supplier price work?</b><br>
When enabled, the last approved purchase rate from the same supplier is suggested on new purchase lines before pricing rules and basic pricing.

<b>What is Zero price if not previous?</b><br>
If previous supplier price is enabled but no prior purchase exists, the line rate defaults to zero instead of basic pricing — forcing manual entry.

<b>Which supplier fields can be made mandatory?</b><br>
Under <b>Supplier mandatory fields</b>, you can require group, phone, email, state, and/or country on every new or edited supplier.

<b>Which purchase invoice fields can be made mandatory?</b><br>
Under <b>Purchase invoice mandatory fields</b>, you can require supplier invoice reference number, payment term (when applicable), and/or project on standard purchase invoices.

<b>Does Payment Term mandatory apply on cash purchase invoices?</b><br>
No. Payment term is enforced only when the Payment Term field is visible on the invoice form — typically credit purchases with due dates set to use payment terms in Transaction Preferences.

<b>What additional item line fields can I enable?</b><br>
Serial numbers, batch, variant, manufacturing date, expiry, and other line columns — depending on inventory features enabled for your company.

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/purchase/purchase-settings">Purchase Settings hub</a> — links to all purchase configuration pages.</li>
<li><a href="#/purchase/purchase-types">Purchase Types</a> — form types, numbering, and tax rules per document type.</li>
<li><a href="#/purchase/basic-pricing">Basic Pricing</a> — default purchase prices updated when <b>Set default purchase price from last purchase invoice</b> is enabled.</li>
<li><a href="#/purchase/purchase-invoice">Purchase Invoice</a> — main screen affected by many of these settings.</li>
</ul>
