# Purchase Invoice

<p class="doc-lead">A Purchase Invoice records a supplier bill for goods or services received. Use it to update accounts payable, post inventory costs, and track supplier payments. Purchase invoices post to accounts and inventory when approved.</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-invoice?id=overview">Overview &amp; List View</a>
<a href="#/purchase/purchase-invoice?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/purchase/purchase-invoice?id=header-fields">Header Fields</a>
<a href="#/purchase/purchase-invoice?id=custom-fields">Custom Fields</a>
<a href="#/purchase/purchase-invoice?id=item-lines">Item Lines</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">View and actions</span>
<div class="doc-toc-links">
<a href="#/purchase/purchase-invoice?id=view">View</a>
<a href="#/purchase/purchase-invoice?id=actions-status">Actions &amp; Status</a>
<a href="#/purchase/purchase-invoice?id=master-update">Master Update</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-invoice?id=best-practices">Best Practices</a>
<a href="#/purchase/purchase-invoice?id=faq">FAQ</a>
<a href="#/purchase/purchase-invoice?id=related">Related &amp; Videos</a>
</div>
</div>
</div>

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

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

The Purchase Invoices list shows all supplier bills with supplier, date, amount, payment mode, and status. Use quick filters to view Default, Approved, Draft, Cancelled, Closed, or Multi Level Approval invoices. From the list you can create new invoices, use <b>Quick</b> for Quick Purchase / POS entry, open existing invoices, edit drafts, or delete draft invoices. When <b>Prevent direct creation of purchase invoice</b> is on in Purchase Settings, <b>New</b> and <b>Quick</b> are hidden — create invoices from a purchase order or receipt note instead.

<b>List View</b>

<img src="purchase/images/purchase-invoices-list.webp" alt="Purchase Invoices list with invoice number, supplier, TRN, amount, pay mode, and status" loading="lazy">

<b>List row actions</b>

| **Action** | **Available when status is** |
|------------|------------------------------|
| Edit | Draft, For Revisal |
| Delete | Draft, For Revisal |
| View | All statuses |
| Quick | Opens Quick Purchase / POS entry from the list. |

<b id="creation-variants">Creation variants</b>

| **Variant** | **Description** |
|-------------|-----------------|
| Standard new | Full invoice entry from <b>New</b> or converted from an order, quotation, or receipt. |
| Quick Purchase / POS | Fast entry using the <b>Quick</b> button on the list for counter or POS-style purchases. |
| Opening Balance invoice | Created from <a href="#/purchase/opening-balance">Supplier Opening Balance</a>. Limited edit and cancel options apply. |
| Job Card | On an <b>Approved</b> or <b>Closed</b> Job Card, use <b>Create Purchase Invoice</b>. Purchase type comes from the Job Type. Each job card item becomes a line with quantity <b>1</b>, rate equal to the job card <b>Cost</b>, the item's purchase unit, and taxes for that purchase type. Review the supplier before saving. |

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

<h2 id="quick-start">Quick Start — Create a Purchase Invoice</h2>

<h3>1. Navigate</h3>
Go to <b>Purchase → Purchase Invoice</b> from the left menu.

<h3>2. Create new invoice</h3>
Click <b>New</b> for a standard invoice, or <b>Quick</b> on the list for Quick Purchase / POS entry. You can also create an invoice from an approved <a href="#/purchase/purchase-quotations">Purchase Quotation</a>, <a href="#/purchase/purchase-order">Purchase Order</a>, or <a href="#/purchase/work-order">Work Order</a>.

<img src="purchase/images/purchase-invoice-new.webp" alt="New Purchase Invoice form with header fields, item lines, and totals" loading="lazy">

<h3>3. Fill in details</h3>
<ul>
<li>Enter <b>Effective Date</b> and <b>Bill Number</b>.</li>
<li>Choose the <b>Supplier</b> and select <b>Payment mode</b> (Cash, Bank, Credit, Digital Wallet, or Prepaid).</li>
<li>For Cash, Bank, Digital Wallet, or Prepaid, select the <b>Cash Account</b>.</li>
<li>Enter <b>Supplier Invoice Number</b> and <b>Payment Due Date</b> when applicable.</li>
<li>Add item lines with <b>Qty</b>, <b>Unit</b>, and <b>Rate</b>.</li>
</ul>

<h3>4. Save</h3>
<ul>
<li><b>save</b> — keeps the invoice as a <b>Draft</b>.</li>
<li><b>Save And Approve</b> — approves and posts the invoice in one step.</li>
<li><b>Cancel</b> — closes the form without saving.</li>
</ul>

<h3>5. After approval</h3>
<ul>
<li>Accounts payable and inventory are updated on approval.</li>
<li>Cash, Bank, Digital Wallet, and Prepaid invoices auto-close on approve when fully paid by the selected payment mode.</li>
<li>Use <b>Payment Out</b> for additional or credit payments.</li>
</ul>

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

<h2 id="header-fields">Header Fields Reference</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Effective Date * | Accounting date of the invoice. |
| Form Type | Purchase type that controls numbering, tax rules, and print layout. Required when purchase types are enabled. |
| Bill Number * | Unique invoice reference. Auto-generated when numbering is configured on the purchase type. |
| Payment mode | How the invoice is paid: Cash, Bank, Credit, Digital Wallet, or Prepaid. |
| Cash Account | Bank or cash account for Cash, Bank, Digital Wallet, or Prepaid payment modes. |
| Payment Due Date | Date payment is due. Shown for Credit and based on payment term settings. |
| Supplier Invoice Number | Supplier's own bill or invoice reference number. Can be required via <a href="#/purchase/purchase-settings-config?id=purchase-invoice-mandatory-fields">Purchase invoice mandatory fields</a>. |
| Employee In charge | Purchase employee responsible for this invoice. |
| Supplier * | Supplier issuing the bill. |
| Contact person | Supplier contact. Enabled after a supplier is selected. |
| Reference name | Optional reference label. Shown when <b>Show field for reference name</b> is enabled in Purchase Settings. |
| Supplier Billing Address | Auto-filled from the supplier. Read-only. |
| Supplier Shipping Address | Auto-filled from the supplier. Read-only. |
| Branch | Branch for the transaction. Shown when multi-branch is enabled. |
| Brand | Brand for brand-wise profit tracking. Shown when enabled. |
| Shipping Center | Shipping or receiving center. |
| Billing center * | Billing center for the transaction. |
| Payment Term | Supplier payment terms. Can be required when the field is shown and configured in <a href="#/purchase/purchase-settings-config?id=purchase-invoice-mandatory-fields">Purchase invoice mandatory fields</a>. |
| Delivery Term | Delivery terms for the purchase. |
| Project | Optional project link. Can be required via <a href="#/purchase/purchase-settings-config?id=purchase-invoice-mandatory-fields">Purchase invoice mandatory fields</a> when Project module is enabled. |
| Project Task | Task within the selected project. Enabled after a project is selected. |
| Job Card | Job card allocation for the invoice. Shown when job card tracking is enabled. |
| Currency / Currency Exchange Rate | Shown when multi-currency is enabled and this document is selected in <a href="#/settings/transaction-preferences?id=general">Transaction Preference</a> → <b>Transactions with currency support</b>. |
| Payment Terms | Custom payment terms text. Shown when due-date option is set to custom. |
| Notes | Remarks printed on the invoice. |
| Internal Notes | Internal remarks not shown on print. |

> Many optional header and line fields are controlled by <a href="#/purchase/purchase-settings-config">Purchase Settings</a> (additional item line fields, discounts, charges, bill layout). Selected header fields can be made mandatory under <b>Purchase invoice mandatory fields</b> in <a href="#/purchase/purchase-settings-config?id=purchase-invoice-mandatory-fields">Purchase Settings → Data Entry Rules</a>.

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

<h2 id="custom-fields">Custom Fields</h2>

Purchase invoices support <a href="#/settings/custom-fields">Custom Fields</a>. Create fields under <b>Settings → Others → Custom Fields</b> with Collection <b>Purchase Invoice</b>.

<ul>
<li>On New and Edit, the field is added to the invoice header. <b>Show in Form Group</b> is <b>Billing Details</b>.</li>
<li>On the invoice view, values appear with the other header details.</li>
<li>On the list, enable <b>Show in List</b> for a column and <b>Show in Filter</b> for Advanced Filters.</li>
<li><b>Hide in Print</b> omits the field from the printed invoice.</li>
</ul>

Field types: text, number, dropdown, checkbox, date, and textarea. Required custom fields must be filled before save. Reload the app after you save a new field so the form picks it up.

You can hide a field until another header field or custom field matches a value — for example show a GRN reference only when <b>Payment mode</b> is Credit. See <a href="#/settings/custom-fields?id=show-when">Custom Fields — Show this field only when</a>.

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

<h2 id="item-lines">Item Lines — ITEMS</h2>

| **Column** | **Description** |
|------------|-----------------|
| Sl.No | Line serial number. |
| Item | Item being invoiced. Required. |
| Item code, Variant, Description, HSN, Brand | Optional columns enabled in Purchase Settings. |
| Qty | Quantity invoiced. Required. |
| Unit | Unit of measure. Required. |
| Rate | Price per unit. Required. |
| Amount, Trade Discount, discounts, Taxable Amount, Taxes, Tax Amount, Total | Calculated based on tax and discount settings. |

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

<h2 id="view">View</h2>

Open a purchase invoice in full view to see the document, status, and side panels. Click the expand icon on a tab to open the same data in a larger modal.

<img src="purchase/images/purchase-invoice-view.webp" alt="Approved Purchase Invoice view with more menu showing Payment Out, Purchase Expense, Create Debit Note, and Return Order" loading="lazy">

<h3 id="view-tabs">Side panels</h3>

<b>Top panel</b>

| **Tab** | **What it shows** |
|---------|-------------------|
| Summary | Linked documents — debit notes, return orders, receipt notes, payments, and related follow-up transactions. See <a href="#/purchase/reports/transaction-summary">Purchase Transaction Summary</a>. |
| Supplier Info. | Quick supplier stats: recent purchases, outstanding balance, and activity for the supplier on this invoice. See <a href="#/purchase/reports/supplier-summary">Supplier Summary</a>. |
| Journal Info | Accounting journal entries posted by this invoice. Requires journal access. See <a href="#/accounts/reports/journal-report">Journal Report</a>. |

<b>Middle panel</b>

| **Tab** | **What it shows** |
|---------|-------------------|
| Payments | Payment vouchers recorded against this invoice. |
| RP | Returnable packaging (RP) movement with the supplier — record <b>In</b> and <b>Out</b> quantities per RP Item on this invoice. Shown on Approved or Closed invoices when returnable packaging is enabled and you have supplier RP access. See <a href="#/rp/supplier-rp">Supplier RP</a>. |

<h3>RP tab — returnable packaging</h3>

Use the <b>RP</b> tab on an approved Purchase Invoice to book returnable packaging received with the purchase.

<p><b>Example:</b> First purchase of 500 milk crates — enter <b>In</b> = 500 on Milk Crate, click <b>Save and Approve</b>. This creates a <a href="#/rp/supplier-rp">Supplier RP</a> linked to the invoice and adds crates to RP stock at the center.</p>

<p><b>Example:</b> Coconut oil in 10 L returnable tins — <b>In</b> = quantity of tins received on the invoice.</p>

<p>Full RP module documentation: <a href="#/rp/">Returnable Packaging (RP)</a>.</p>

<b>Bottom panel (all transactions)</b>

| **Tab** | **What it shows** |
|---------|-------------------|
| History | Activity log — who created, approved, edited, or cancelled the invoice and when. |
| Attachments | Files uploaded to this invoice. |
| Secondary Status | Custom secondary status history and updates, when secondary status is configured. |

Toolbar and more-menu actions on this screen are listed under <a href="#/purchase/purchase-invoice?id=actions-status">Actions &amp; Status</a>.

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

<h2 id="actions-status">Actions &amp; Status</h2>

<h3>View toolbar actions</h3>

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Approve | Finalizes and posts the invoice. | Draft |
| Edit | Opens the invoice for editing. | Draft, For Revisal |
| Delete | Permanently removes the invoice. | Draft, For Revisal |
| Clone | Creates a copy of the invoice. | All (if permitted) |
| Print | Prints the invoice. | All |
| Export | Exports the invoice to Excel. | All |

<h3>More menu (⋮) actions</h3>

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Payment Out | Records a supplier payment against the invoice. | Approved, Closed |
| Purchase Expense | Opens a Purchase Expense linked to this invoice. | Approved, Closed |
| Create Debit Note | Opens a Debit Note against this invoice. | Approved, Closed |
| Return Order | Opens a Purchase Return Order for returned goods. | Approved, Closed |
| Create Sale Invoice | Opens a <a href="#/sales/sale-invoice">Sale Invoice</a> linked to this purchase invoice, with item lines, sale prices, and sale tax classes pre-filled from the purchase invoice. | Approved, Closed |
| Cancel | Cancels the invoice. | Approved |
| Revise Invoice | Creates a revised invoice from a cancelled invoice. | Cancelled |
| Add Job Card Allocation | Allocates invoice lines to job cards. | Approved, Closed |
| WorkFlow Request | Starts a company process linked to this invoice. Does not approve the invoice. See <a href="#/hr/workflow-request">WorkFlow Request</a>. | Approved, Closed |
| Create Shipment | Creates a shipment linked to this invoice. | Approved, Closed |
| Create Delivery Challan | Opens an inward <a href="#/inventory/delivery-challan">Delivery Challan</a> linked to this invoice, with the supplier and item lines pre-filled, to document goods moved against the purchase. | Approved, Closed |
| Update Serial Numbers | Updates serial numbers on inventory item lines. | Approved, Closed |
| Set Sale Price | Sets sale prices from purchase rates on item lines. | Approved, Closed |
| Add/Update Note | Adds or edits an internal note on the invoice. | All |
| Update Secondary Status | Updates a custom secondary status. | Approved, Closed |
| Master Update | Updates selected header fields without reopening the full form. See <a href="#/purchase/purchase-invoice?id=master-update">Master Update</a>. | Approved, Closed |
| Mark As Closed | Manually closes the invoice. | Approved |
| Undo Close | Reverts a manual close. | Closed (only when manually closed) |
| Print Labels | Prints item labels from invoice lines. | Approved, Closed |
| Export Items | Exports item lines to Excel. | All |

<h3>Statuses</h3>

| **Status** | **Description** |
|------------|-----------------|
| Draft | Saved but not yet approved. Can be edited or deleted. |
| For Revisal | Sent back for changes. Treated like Draft for edit and delete. |
| Approved | Finalized and posted. Updates accounts and inventory. |
| Closed | Invoice is closed — typically after full payment or manual close. |
| Cancelled | Invoice has been cancelled. Use <b>Revise Invoice</b> to create a replacement. |
| Multi Level Approval | Awaiting multi-level approval workflow. |

<b>Posting note:</b> Purchase Invoices post to accounts and inventory on approve. Cash, Bank, Digital Wallet, and Prepaid payment modes auto-close the invoice on approve when the full amount is settled through the selected payment mode. Credit invoices remain open until paid via <b>Payment Out</b>.

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

<h2 id="master-update">Master Update</h2>

<b>Master Update</b> lets you change selected header fields on an approved or closed invoice without editing the full document or item lines. Open the three-dot menu on the invoice and select <b>Master Update</b>.

| **Field** | **Can be updated?** | **Notes** |
|-----------|---------------------|-----------|
| Date * | Yes | Effective date. Cannot be set before the accounts closing date. |
| Employee In charge | Yes | |
| Payment Term | Yes | |
| Delivery Term | Yes | |
| Due Date | Yes | Payment due date. |
| Supplier Invoice Number | Yes | Supplier's bill reference. |
| Branch | Yes | Shown when multi-branch is enabled. |
| Brand | Yes | Shown when brand-wise tracking is enabled. |
| Project | Yes | |
| Job Card | Yes | Shown when job card tracking is enabled. |
| Supplier, payment mode, centers, item lines, totals | No | Edit the full invoice (Draft / For Revisal) or cancel and revise. |

Click <b>Confirm</b> to save changes or <b>Cancel</b> to close without saving.

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

<h2 id="best-practices">Best Practices</h2>

<ul>
<li>Match <b>Supplier Invoice Number</b> to the supplier's physical bill for easier reconciliation.</li>
<li>Create invoices from <a href="#/purchase/purchase-order">Purchase Orders</a> or <a href="#/purchase/work-order">Work Orders</a> so quantities and rates carry forward automatically.</li>
<li>Use <b>Quick</b> on the list for fast counter purchases; use <b>New</b> for full invoices with all header details.</li>
<li>Select the correct <b>Payment mode</b> — Cash, Bank, Digital Wallet, and Prepaid invoices auto-close on approve when fully paid.</li>
<li>Use <b>Payment Out</b> for credit invoices and partial payments after approval.</li>
<li>Opening Balance invoices have limited edit and cancel options — create them carefully during initial setup.</li>
<li>Configure <a href="#/purchase/purchase-types">Purchase Types</a> and <a href="#/purchase/purchase-settings-config">Purchase Settings</a> before creating invoices.</li>
</ul>

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

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

<b>Can I add extra fields to a purchase invoice?</b><br>
Yes. Create them under <b>Settings → Others → Custom Fields</b> with Collection <b>Purchase Invoice</b>. They appear on New, Edit, view, and print. See <a href="#/purchase/purchase-invoice?id=custom-fields">Custom Fields</a>.

<b>How do I set the footer note on a purchase invoice?</b><br>
Set it on the purchase type, not in Print Settings or Transaction Preference. Go to <b>Purchase → Settings → Purchase Types</b>, edit the purchase type, and enter <b>Purchase Invoice Footer Note</b> under <b>Footer Notes</b>. The invoice shows the footer note of the purchase type selected as <b>Form Type</b>. See <a href="#/purchase/purchase-types">Purchase Types</a>.

<b>Can I edit an approved purchase invoice?</b><br>
No. Use <b>Master Update</b> for allowed header fields, or <b>Cancel</b> and <b>Revise Invoice</b> to create a new version.

<b>When does a purchase invoice post to accounts and inventory?</b><br>
On <b>Approve</b> or <b>Save And Approve</b>. Draft invoices do not affect stock or ledgers.

<b>Why did my cash invoice close automatically on approve?</b><br>
Invoices with <b>Cash</b>, <b>Bank</b>, <b>Digital Wallet</b>, or <b>Prepaid</b> payment mode auto-close on approve when the full amount is settled through the selected payment mode.

<b>Can I create a purchase invoice without a purchase order?</b><br>
Yes, unless <b>Prevent direct creation of purchase invoice</b> is enabled in <a href="#/purchase/purchase-settings-config?id=prevent-direct-purchase-invoice">Purchase Settings</a>. When that setting is on, <b>New</b> and <b>Quick</b> are hidden and a purchase order is required (opening-balance invoices are exempt). Otherwise use <b>New</b> or <b>Quick</b> for a standalone invoice, or convert from a <a href="#/purchase/purchase-quotations">Purchase Quotation</a>.

<b>What is an Opening Balance invoice?</b><br>
An invoice created from <a href="#/purchase/opening-balance">Supplier Opening Balance</a> to bring forward supplier balances from a prior period. It has limited edit and cancel options.

<b>How do I return goods after invoicing?</b><br>
On an approved invoice, use <b>Return Order</b> from the more menu to create a <a href="#/purchase/purchase-return-order">Purchase Return Order</a>.

<b>Why is Approve hidden on my invoice?</b><br>
When multi-level approval is configured on the purchase type, approval follows the approval workflow instead of the direct Approve button.

<b>Why won't my invoice approve when linked to a purchase order?</b><br>
The linked <a href="#/purchase/purchase-order">Purchase Order</a> must be <b>Approved</b> (not Draft or Cancelled) and belong to the same supplier as the invoice.

<b>Why does approve fail when I invoice from a receipt note?</b><br>
The usual cause is a <a href="#/purchase/purchase-invoice">Purchase Invoice</a> created from a <a href="#/inventory/goods-receipt-note">Receipt Note</a> (or from a purchase order that already has receipt notes) and you then changed <b>quantity</b>, items, or units. Approve compares the invoice lines to the linked receipt notes — they must match what was received. Stock already came in on the receipt note, so the invoice cannot bill a different qty. Put the invoice quantities back to the receipt-note quantities, then Approve. To bill a different qty, cancel the draft invoice, correct or cancel the receipt note, and create the invoice again. The invoice date must also be after the receipt-note date.

<b>Why can't I cancel my purchase invoice?</b><br>
Cancel is blocked while linked payments, debit notes, purchase expenses, return orders, or receipt voucher adjustments exist. Remove or cancel those documents first.

<b>Why does approve fail with "payment mode missing"?</b><br>
Select a <b>Payment mode</b> before approving. Payment mode is required on every purchase invoice.

<b>How do I pay a credit purchase invoice?</b><br>
Open the approved invoice and use <b>Payment Out</b> from the more menu. Credit invoices stay open with a balance until fully paid.

<b>Which payment modes auto-close on approve?</b><br>
<b>Cash</b>, <b>Bank</b>, <b>Digital Wallet</b>, and <b>Prepaid</b> close automatically when the full amount is settled through the selected mode. <b>Credit</b> stays open until paid via <b>Payment Out</b>.

<b>What is Revise Invoice?</b><br>
After cancelling an approved invoice, use <b>Revise Invoice</b> to create a corrected copy. The cancelled version is kept for audit; the revised invoice starts as Draft.

<b>Which header fields can I change with Master Update?</b><br>
Date, Employee In charge, Branch, Brand, Project, Due Date, payment/delivery terms, Supplier Invoice Number, and Job Card. Item lines, amounts, and payment mode cannot be changed through Master Update.

<b>Does a purchase invoice always need a purchase order?</b><br>
Not by default. A purchase invoice can be raised in a few ways:
<ul>
<li><b>Direct purchase invoice</b> — create a standalone invoice with <b>New</b> or <b>Quick</b>, without any prior document (blocked when <b>Prevent direct creation of purchase invoice</b> is on).</li>
<li><b>Purchase Order → Receipt Note → Purchase Invoice</b> — order the goods, record their receipt, then invoice from the receipt note.</li>
<li><b>Purchase Quotation → Purchase Order → Receipt Note → Purchase Invoice</b> — the full flow starting from a supplier quotation.</li>
</ul>
When <b>Prevent direct creation of purchase invoice</b> is enabled, only order-linked (or opening-balance) invoices are allowed.

<b>How do I create a Sale Invoice from a Purchase Invoice?</b><br>
On an approved or closed purchase invoice, open the more menu (⋮) and select <b>Create Sale Invoice</b>. A new <a href="#/sales/sale-invoice">Sale Invoice</a> opens with the item lines copied from the purchase invoice — <b>sale prices</b> and <b>sale tax classes</b> are generated automatically from each item's sale price list and sale tax configuration. Quantities already billed on earlier sale invoices created from the same purchase invoice are deducted, so only the remaining quantity is carried forward. Choose the customer and other sale details, then save or approve as usual. This is useful for trading or drop-ship flows where goods are bought and on-sold against the same document.

<b>How do I create a Delivery Challan from a Purchase Invoice?</b><br>
On an approved or closed purchase invoice, open the more menu (⋮) and select <b>Create Delivery Challan</b>. A new <a href="#/inventory/delivery-challan">Delivery Challan</a> opens as an <b>Inward</b> supply with the <b>Supplier</b> and item lines pre-filled from the invoice. Use it to document goods in transit against the purchase and to generate an e-Way Bill where required. The challan is a movement document only — it does not post to stock or accounts.

<b>What is the difference between a Purchase Invoice and a Purchase Order?</b><br>
A <a href="#/purchase/purchase-order">Purchase Order</a> confirms what you ordered — it does not post stock or payables. A purchase invoice bills received goods or services and posts to accounts and inventory on approve.

<h2 id="related">Related Topics &amp; Videos</h2>

<b>Related documentation</b>
<ul>
<li><a href="#/purchase/purchase-order">Purchase Order</a> — confirm goods before invoicing.</li>
<li><a href="#/purchase/work-order">Work Orders</a> — service purchases before invoicing.</li>
<li><a href="#/purchase/purchase-quotations">Purchase Quotation</a> — quote-to-invoice workflow.</li>
<li><a href="#/purchase/debit-note">Debit Note</a> — adjust or claim against a purchase invoice.</li>
<li><a href="#/purchase/purchase-expense">Purchase Expense</a> — record expenses linked to an invoice.</li>
<li><a href="#/purchase/purchase-return-order">Purchase Return Order</a> — return goods after invoicing.</li>
<li><a href="#/purchase/opening-balance">Supplier Opening Balance</a> — opening balance invoices.</li>
<li><a href="#/purchase/purchase-settings-config">Purchase Settings</a> — configure fields, discounts, and bill layout.</li>
<li><a href="#/settings/custom-fields">Custom Fields</a> — extra header fields on the invoice.</li>
</ul>

<b>Video — Purchase Invoice overview</b>
<iframe width="560" height="315" src="https://www.youtube.com/embed/Eoe-OrCoj6g?si=H6VYFE0u83VkI-go" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

<section class="ai-index-only">

## Errors and warnings

Exact messages for Purchase Invoice from the ERP screen and `fs_api`. Visitors do not see this section; Vertex AI Search uses it to answer questions about on-screen errors. Shared date, status, bill-number, batch, and inventory-not-found strings are also catalogued under <a href="#/features/transaction-errors">Shared transaction errors</a>.


### Future or back-dated date

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** Date is in the future and future-date transactions are off, or the user cannot enter previous dates, or the date is before the allowed cutoff.
- **Example message:** *Future date transactions are not allowed.* or *Previous date transaction entries are not allowed.* or *Transaction date cannot be before YYYY-MM-DD.*
- **Outcome:** The document is not saved.
- **Solution:** Set Date to an allowed date, then save.

### Accounts closed for the date

- **Type:** Error
- **Action:** Approve, Save And Approve, Master Update
- **When:** The document date is in a closed accounting period.
- **Example message:** *Accounts closed for the date*
- **Outcome:** Not posted, or the date is not changed.
- **Solution:** Use a date after the accounts closing date.

### Multi-level approval required

- **Type:** Error / workflow
- **Action:** Approve, Save And Approve
- **When:** An active multi-level approval template matches this document.
- **Example message:** *Multi level approval is required*
- **Outcome:** Direct approve is blocked.
- **Solution:** Use Send Request on the first stage. For Send Request, stage Approve, Reject, Send For Revise, and Cancel Request messages, see <a href="#/features/multiapproval?id=action-errors">Multi Approval — Action error messages</a>.

### Edit or delete not allowed

- **Type:** Error
- **Action:** Edit, Delete
- **When:** Status is not Draft or For Revisal, or auto bill-number is on for delete.
- **Example message:** *Edit not allowed in the current status* or *Invalid status* or *Delete prevented..*
- **Outcome:** Posted documents stay in the ledger.
- **Solution:** Cancel a posted document after unlinking related records. Delete only drafts.

### Cancel date restriction

- **Type:** Error
- **Action:** Cancel
- **When:** User cannot cancel previous-date transactions, or the date is before the cancel cutoff.
- **Example message:** *Cancelling previous date transactions are not allowed* or *Cancelling transactions before YYYY-MM-DD is not allowed.*
- **Outcome:** Not cancelled.
- **Solution:** Cancel only dates the user is allowed to cancel.

### Items missing or invalid

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** Item lines are empty, a required field is missing, or line totals do not match.
- **Example message:** *items not found* or *Invalid Data in lines {N}* (`fs_api`). ERP: *Items contains invalid data* or *Items required*.
- **Outcome:** Not saved.
- **Solution:** Add valid item lines, then save.

### Serial Number missing

- **Type:** Error
- **Action:** Approve, Save And Approve
- **When:** A serial-tracked item line has no serial numbers when stock posts (Purchase Invoice and similar receive documents).
- **Example message:** *Serial Number missing*
- **Outcome:** Not approved.
- **Solution:** Enter one serial per unit for the line quantity. Shared catalog: <a href="#/inventory/serial-numbers">Serial Numbers</a>.

### Duplicate Serial Number found

- **Type:** Error
- **Action:** Save, Approve, Save And Approve
- **When:** The same serial name or id appears more than once on a line, or approve stock posting finds duplicate serial ids.
- **Example message:** *Duplicate Serial Number found <b>SN-001</b> for Item <b>Widget</b> ( ItemId 1160 ) in line 2* or *Duplicate Serial Number found for  Item <b>Widget ( ItemId 1160 ) </b> in line 2*
- **Outcome:** Not saved / not approved.
- **Solution:** Enter each serial only once on the line.

### Serial Number Quantity Mismatch

- **Type:** Error
- **Action:** Approve, Save And Approve
- **When:** The count of serial numbers differs from the line quantity (or in quantity).
- **Example message:** *Serial Number Quantity Mismatch for  Item <b>Widget ( ItemId 1160 ) </b> in line 2*
- **Outcome:** Not approved.
- **Solution:** Enter exactly as many unique serials as the line quantity.

### SerialNumber already exist

- **Type:** Error
- **Action:** Approve, Save And Approve
- **When:** Approving creates serials and the name already exists for the item. On Purchase Invoice and Receipt Note, also when that serial is still in stock.
- **Example message:** *SerialNumber <b>SN-001</b> in line 2 already exist*
- **Outcome:** Not approved. New serials are not created.
- **Solution:** Use a unique serial name, or on Purchase Invoice / Receipt Note reuse only a serial that is currently out of stock.

### Inventory not available

- **Type:** Error (blocks the action)
- **Action:** Cancel
- **When:** On cancel, the normal stock this invoice added is no longer in the same layer (item, center, batch, inventory bin, and variant).
- **Example message:** *Inventory not available* or *Inventory Not Found for Item … in line N*
- **Outcome:** Not posted.
- **Solution:** Cancel takes the received quantity back from <b>normal stock</b> (WIP blank). Open <a href="#/inventory/reports/item-enquiry">Item Enquiry</a> and search the item for a basic view (<b>Item Stock</b>, and <b>In hand</b> versus <b>WIP</b> by center). For the exact layer, open <a href="#/inventory/reports/inventory-summary">Inventory Summary</a>, turn on every <b>Group by</b> button (<b>Item</b>, <b>WIP</b>, <b>Center</b>, <b>Variant</b>, <b>Batch</b>, <b>Inv Bin</b>), search the item, and match the center, batch, inventory bin, and variant on the line. The system does not allow negative stock, so that row must already hold the quantity. The goods must still be in that layer. Approve adds stock, so this message is raised when cancelling, not when approving.

### Value cannot be negative

- **Type:** Error (blocks the action)
- **Action:** Cancel
- **When:** Cancel takes back the quantity this invoice added to normal stock. The quantity may still be there, but removing it at the layer's cost would leave a negative stock value.
- **Example message:** *Insufficient stock value of {amount} for item id {id}*
- **Outcome:** Not cancelled. Stock value is not changed.
- **Solution:** Cancelling will result in a negative item value. Increase the item value through <a href="#/inventory/inventory-revaluation">Inventory Revaluation</a> on that same layer, then cancel.

### Quality inspection pending

- **Type:** Error (blocks approve)
- **Action:** Approve
- **When:** QC is required and still pending (`qcStatus` pending).
- **Example message:** *Quality Inspection is Pending*
- **Outcome:** Approve fails.
- **Solution:** Complete Quality Inspection first, then Approve.

### Direct invoice blocked

- **Type:** Error
- **Action:** Save (New)
- **When:** Company setting requires purchase invoices only from a purchase order.
- **Example message:** *Purchase invoice can only be created through purchase order* (ERP and `fs_api`)
- **Outcome:** The invoice is not created.
- **Solution:** Create the invoice from an approved Purchase Order (or Work Order) with pending receipt notes.
### Mandatory header fields

- **Type:** Error
- **Action:** Save, Save And Approve
- **When:** Purchase Settings lists mandatory invoice fields that are empty.
- **Example message:** *Please fill all mandatory fields: {labels}* (ERP and `fs_api`)
- **Outcome:** Not saved.
- **Solution:** Fill every listed mandatory field.
### Cash account required

- **Type:** Error
- **Action:** Save / Approve
- **When:** A paid amount is entered without a cash/bank account.
- **Example message:** *Please provide cash Account details* (ERP) or *cashAccountId not found* (`fs_api`)
- **Outcome:** Not saved / not posted.
- **Solution:** Select Cash Account.
### Receipt or service-receipt links missing

- **Type:** Error
- **Action:** Approve
- **When:** Note IDs are stored but junction links are missing.
- **Example message:** *Receipt note links missing. receiptNoteIds present but receiptNotes not linked. Repair links before approving.* or *Service receipt note links missing…* or *Receipt from subcontracting links missing…*
- **Outcome:** Approve fails.
- **Solution:** Re-select the notes so links are stored, then Approve.
### Quantity mismatch with receipt note — invoice quantity changed

This is the main case for *Quantity mismatch with receipt note* / *Items mismatch with receipt note* on a Purchase Invoice.

- **Type:** Error (blocks approve)
- **Action:** Approve, Save And Approve
- **When:** The purchase invoice was created from one or more Receipt Notes (Receipt Notes field, Create Invoice from a Receipt Note, or Create Invoice from a Purchase Order that already has receipt notes). After the lines were copied, someone changed **Qty** on a line, added or removed an item, or changed the unit. Approve compares invoice item ids and quantities to the linked receipt notes.
- **Example message:** *Quantity mismatch with receipt note. ItemId = …* or *Items mismatch with receipt note. ItemId = …* or *Items mismatch with receipt note. ItemId = … not found*. Also *Invoice date must be greater than the receipt note date.* when the invoice date is before the linked receipt. Related: *Invoice date must be greater than the receipt from subcontracting date.*
- **Outcome:** The invoice is not approved. Linked receipt notes stay open. Stock is not posted again (it already moved on the receipt note).
- **Solution:** Set invoice Qty (and items / units) back to the receipt-note quantities, then Approve. Do not bill a different qty on this invoice. If the receipt was wrong: leave the invoice as Draft or cancel it, cancel or correct the Receipt Note, then create a new invoice from the corrected note. If the invoice is already approved, use a Debit Note — do not edit qty.
### Duplicate supplier invoice or bill number

- **Type:** Error
- **Action:** Approve
- **When:** The same supplier invoice number already exists for this supplier, or the bill number is reused.
- **Example message:** *Purchase invoice exist with same supplier invoice number for this supplier* or *Same bill number … exist*
- **Outcome:** Not approved.
- **Solution:** Use a unique supplier invoice number and bill number.
### Cancel blocked by linked documents

- **Type:** Error
- **Action:** Cancel
- **When:** Payments, receipt-voucher adjustments, debit notes, purchase expenses, return orders, RP, or custom links remain.
- **Example message:** *Cancel Payments before cancelling Invoice (Id:…)*; *Cancel debit notes before cancelling Invoice (Id:…)*; *Cancel Purchase expenses before cancelling Invoice*; *Cancel Purchase return order before cancelling Invoice*; *Cancel RP before cancelling Invoice (Id:…)*; *Cancel Custom Links before cancelling Purchase Invoice (Id:…)*
- **Outcome:** Not cancelled.
- **Solution:** Cancel or unlink those documents first.
### Account mapping missing

- **Type:** Error
- **Action:** Approve
- **When:** Item, TCS, or RCM accounts are not mapped.
- **Example message:** *Account mapping not found for item {itemCode}* or *Account map not set for TCS Receivable* or *RCM Tax not found for RCM Tax …*
- **Outcome:** Journal is not posted.
- **Solution:** Map the item / TCS / RCM accounts, then Approve.

</section>
