# Pro Forma Invoice

<p class="doc-lead">A Pro Forma Invoice is a preliminary bill of sale sent to a customer before shipment or final billing. Use it for price confirmation, export documentation, and advance payment workflows. Pro forma invoices do not post to accounts or inventory.</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="#/sales/pro-forma-invoice?id=overview">Overview &amp; List View</a>
<a href="#/sales/pro-forma-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="#/sales/pro-forma-invoice?id=header-fields">Header Fields</a>
<a href="#/sales/pro-forma-invoice?id=item-lines">Item Lines</a>
<a href="#/sales/pro-forma-invoice?id=advance-requested">Advance Requested</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="#/sales/pro-forma-invoice?id=view">View</a>
<a href="#/sales/pro-forma-invoice?id=actions-status">Actions &amp; Status</a>
<a href="#/sales/pro-forma-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="#/sales/pro-forma-invoice?id=best-practices">Best Practices</a>
<a href="#/sales/pro-forma-invoice?id=faq">FAQ</a>
<a href="#/sales/pro-forma-invoice?id=related">Related &amp; Videos</a>
</div>
</div>
</div>

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

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

The Pro Forma Invoices list shows all pro forma documents with customer, date, amount, and status. Use quick filters to view Approved, Draft, Cancelled, Closed, or Multi Level Approval entries. From the list you can create new pro forma invoices, open existing ones, edit drafts, or delete draft entries.

<b>List View</b>

<img src="sales/images/pro-forma-invoices-list.webp" alt="Pro Forma Invoices list with invoice number, customer, date, amount, 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 |

<b>Creation sources</b>

| **Source** | **Description** |
|------------|-----------------|
| Direct | Create from <b>Sales → Pro Forma Invoice → New</b>. |
| Sale Quotation | Use <b>Create Pro Forma Invoice</b> on an approved <a href="#/sales/sale-quotation">Sale Quotation</a>. |
| Sale Order | Use <b>Create Pro Forma Invoice</b> on an approved <a href="#/sales/sale-order">Sale Order</a>. |
| Job Card | On an <b>Approved</b> or <b>Closed</b> Job Card, use <b>Create Proforma Invoice</b>. Customer, sale type, and item lines are pre-filled — each job card item becomes a line with quantity <b>1</b> and rate equal to the job card <b>Sale Amount</b>. |

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

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

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

<h3>2. Create new pro forma invoice</h3>
Click <b>New</b> to open the entry screen, or create from an approved sale quotation, sale order, or Job Card (<b>Create Proforma Invoice</b> — customer, sale type, and item lines are pre-filled).

<img src="sales/images/pro-forma-invoice-new.webp" alt="New Pro Forma Invoice form with header fields, item lines, and totals" loading="lazy">

<h3>3. Fill in details</h3>
<ul>
<li>Select <b>Form Type</b> and enter the <b>Pro Forma Number</b>.</li>
<li>Choose the <b>Customer</b> and add item lines with <b>Qty</b>, <b>Unit</b>, and <b>Rate</b>.</li>
<li>Set <b>Payment Term</b>, <b>Due Date</b>, and <b>Delivery Term</b> as needed.</li>
<li>Add <b>Notes</b> or <b>Internal Notes</b> if required.</li>
</ul>

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

<h3>5. After approval</h3>
<ul>
<li>Collect an advance with <b>Payment In</b> (creates an <b>Other Incomes / Custom</b> <a href="#/accounts/receipt-voucher">Receipt Voucher</a> linked to this pro forma).</li>
<li>Convert to a <a href="#/sales/sale-invoice">Sale Invoice</a> or <a href="#/purchase/purchase-order">Purchase Order</a> from the more menu.</li>
<li>Add <b>Export Details</b> for international shipments when export settings are enabled.</li>
<li>When a sale invoice is approved from this pro forma, matching advance receipts are linked to the invoice automatically, and the pro forma is typically closed.</li>
</ul>

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

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

| **Field** | **Description** |
|-----------|-----------------|
| Date * | Date of the pro forma invoice. |
| Form Type | Sale type that controls numbering, tax rules, and print layout. |
| Pro Forma Number * | Unique pro forma reference. Auto-generated when numbering is configured on the sale type. |
| Customer * | Customer receiving the pro forma invoice. |
| Customer Billing Address | Auto-filled from the customer. Read-only. |
| Shipping Address | Delivery address for the shipment. |
| Contact person | Customer contact. Enabled after a customer is selected. |
| Reference Name | Optional reference label. Shown when <b>Show Reference Name &amp; Phone field</b> is enabled in Sale Settings. |
| Reference Phone | Phone linked to the reference name. |
| Notify Party | Third-party notify party. Shown when <b>Show Notify Party field</b> is enabled. |
| Notify Party Address | Address for the notify party. |
| LPO/FPO Id | Customer purchase order reference. |
| Employee | Sales employee responsible for this document. |
| Prepared By | Employee who prepared the document. Shown when <b>Show Prepared by field</b> is enabled. |
| Payment Term | Customer payment terms. |
| Delivery Term | Delivery terms text. Shown when <b>Show Delivery Terms</b> is enabled. |
| Due Date | Payment due date based on payment terms. |
| Branch | Branch for the transaction. Shown when multi-branch is enabled. |
| Brand | Brand for brand-wise profit tracking. |
| Billing center * | Billing center for the transaction. |
| Project | Optional project link. |
| Project Task | Task within the selected project. |
| 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>. |
| Notes | Remarks printed on the pro forma invoice. |
| Internal Notes | Internal remarks not shown on print. |

> Many optional header and line fields are controlled by <a href="#/sales/sale-settings-config">Sale Settings</a>.

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

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

| **Column** | **Description** |
|------------|-----------------|
| Sl.No | Line serial number. |
| Item | Item being quoted. Required. |
| Item code, Variant, Description, HSN, MRP, Brand | Optional columns enabled in Sale Settings. |
| Qty | Quantity on the pro forma. 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="advance-requested">Advance Requested</h2>

Under <b>Total</b>, you can record the advance you are asking the customer to pay. It does not change the invoice total or the amount in words.

<ul>
<li>Set <b>Advance Requested</b> to <b>Amount</b> or <b>% of Total</b>.</li>
<li><b>Amount</b> is a fixed figure. <b>% of Total</b> is a percentage of the invoice total. It is recalculated when the lines or the total change. Opening an existing pro forma does not recalculate it until you change the total or the percentage.</li>
<li>On the view and on print, a percentage shows as <b>30% Advance Amount</b> with the calculated amount. A fixed amount shows as <b>Advance Requested</b>. The row is omitted when it is blank or zero.</li>
<li>On a foreign-currency pro forma, the percentage applies to the total in the document currency, and that is the amount printed.</li>
<li><b>Payment In</b> on an approved pro forma uses this advance when it is greater than zero. Otherwise the receipt is filled with the full total.</li>
<li>Clone and Revise keep the advance. Create Invoice and Create Purchase Order do not.</li>
</ul>

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

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

When you open a pro forma invoice in full view (not in a small modal), the right side shows tabbed panels. Click the expand icon on a tab to open the same data in a larger modal.

<img src="sales/images/pro-forma-invoice-view.webp" alt="Closed Pro Forma Invoice view with more menu showing Cancel, Create Purchase Order, and Master Update" loading="lazy">

<h3>Top panel</h3>

| **Tab** | **What it shows** |
|---------|-------------------|
| Summary | Linked documents for this pro forma — sale invoices, purchase orders, advance <a href="#/accounts/receipt-voucher">Receipt Vouchers</a> created with <b>Payment In</b>, and related follow-up transactions. See <a href="#/sales/reports/sale-transaction-summary">Sale Transaction Summary</a>. |

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

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

<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 the pro forma invoice. | Draft |
| Edit | Opens the pro forma invoice for editing. | Draft, For Revisal |
| Delete | Permanently removes the pro forma invoice. | Draft, For Revisal |
| Clone | Creates a copy of the pro forma invoice. | All (if permitted) |
| Print | Prints the pro forma invoice. | All |
| Export | Exports the pro forma invoice to Excel. | All |

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

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Create Invoice | Opens a new <a href="#/sales/sale-invoice">Sale Invoice</a> pre-filled from this pro forma. Hidden when the pro forma already has a sale order. | Approved |
| Create Purchase Order | Opens a new <a href="#/purchase/purchase-order">Purchase Order</a> from this pro forma. | Approved, Closed |
| Payment In | Opens a new <a href="#/accounts/receipt-voucher">Receipt Voucher</a> as <b>Other Incomes / Custom</b>, pre-filled from this pro forma (customer, pro forma reference, and amount). The amount is <b>Advance Requested</b> when one is set; otherwise it is the full total. | Approved |
| Revise Pro Forma Invoice | Creates a revised pro forma from an approved one. | Approved |
| Cancel | Cancels the pro forma invoice. | Approved |
| WorkFlow Request | Starts a company process linked to this pro forma. Does not approve the pro forma. See <a href="#/hr/workflow-request">WorkFlow Request</a>. | Approved, Closed |
| Add Export Details | Captures export shipping and customs details. Shown when export settings are enabled. | Draft, Approved, Closed |
| Mark As Closed | Manually closes the pro forma invoice. | Approved |
| Undo Close | Reverts a manual close. | Closed (only when manually closed) |
| Add/Update Note | Adds or edits an internal note. | All |
| Master Update | Updates selected header fields. See <a href="#/sales/pro-forma-invoice?id=master-update">Master Update</a>. | Approved, Closed |
| Update Secondary Status | Updates a custom secondary status. | Approved, Closed |
| Get PDF | Downloads a PDF copy. | All except Draft |
| 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. Can be converted to sale invoice or purchase order. |
| Open | Active pro forma not yet fully processed. |
| Closed | Pro forma is closed — typically after conversion to sale invoice or manual close. |
| Cancelled | Pro forma has been cancelled. |
| Multi Level Approval | Awaiting multi-level approval workflow. |

<b>Posting note:</b> Pro Forma Invoices do not post to accounts or inventory. They are documentation-only until converted to a sale invoice or other posting transaction.

<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 pro forma invoice without editing item lines. Open the three-dot menu and select <b>Master Update</b>.

| **Field** | **Can be updated?** | **Notes** |
|-----------|---------------------|-----------|
| Date * | Yes | Cannot be set before the accounts closing date. |
| Payment Term | Yes | |
| Delivery Term | Yes | Shown when delivery terms are enabled in Sale Settings. |
| Due Date | Yes | Payment due date. |
| Employee In charge | Yes | |
| Prepared By | Yes | Shown when prepared-by is enabled in Sale Settings. |
| LPO/FPO Id | Yes | Customer purchase order reference. |
| Branch | Yes | When multi-branch is enabled. |
| Brand | Yes | When brand-wise tracking is enabled. |
| Project | Yes | |
| Customer, centers, item lines, totals | No | Edit the full document (Draft / For Revisal) or cancel and revise. |

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

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

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

<ul>
<li>Approve the pro forma before <b>Create Invoice</b> so rates and items carry forward automatically.</li>
<li>Use <b>Payment In</b> to collect customer advances against the pro forma; when you later approve a sale invoice from this pro forma, those receipts are linked to the invoice automatically.</li>
<li>Use <b>Add Export Details</b> for export shipments to keep customs and logistics data with the document.</li>
<li>Close or convert pro formas promptly after final billing to keep the pipeline accurate.</li>
<li>Configure <a href="#/sales/sale-types">Sale Types</a> for correct numbering and tax rules before creating pro forma invoices.</li>
</ul>

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

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

<b>Does a pro forma invoice post to accounts?</b><br>
No. Pro forma invoices are non-posting documents. Only the resulting sale invoice (and any <b>Payment In</b> receipt vouchers you create) posts to accounts.

<b>How do I collect an advance against a pro forma?</b><br>
On an approved pro forma, open the more menu (⋮) and select <b>Payment In</b>. This creates an <b>Other Incomes / Custom</b> receipt voucher linked to the pro forma. Approve the receipt to post cash or bank. When you later approve a sale invoice created from this pro forma, the system links matching receipts to that invoice automatically. You can also use <b>Link with Bill</b> on the receipt for any remaining amount.

<b>What happens when I create a sale invoice from a pro forma?</b><br>
A new sale invoice opens pre-filled from the pro forma. When the sale invoice is approved, matching advance receipt vouchers from this pro forma are linked to the invoice automatically, and the related pro forma is typically closed.

<b>Can I create a purchase order from a pro forma?</b><br>
Yes. Use <b>Create Purchase Order</b> on an approved pro forma to start procurement against the same items.

<b>When is Add Export Details available?</b><br>
When export-related settings are enabled for your company. Use it to record shipping, port, and customs information.

<b>Why is Customer Info or Profit Summary not shown?</b><br>
Pro forma invoices show only the <b>Summary</b> tab in the top panel. Customer and profit widgets are not available on this transaction type.

<b>Can I create a pro forma from a sale order?</b><br>
Yes. On an approved sale order use <b>Create Pro Forma Invoice</b> to generate a non-posting export estimate from order lines.

<b>Can I create a pro forma from a Job Card?</b><br>
Yes. On an <b>Approved</b> or <b>Closed</b> Job Card, use <b>Create Proforma Invoice</b>. The new pro forma opens with customer (from the booking consignee), sale type, and all job card items pre-filled — quantity <b>1</b> and rate from each line's <b>Sale Amount</b>. Review rates and taxes before saving.

<b>Does pro forma affect stock or GST returns?</b><br>
No. It is a planning and customer communication document until converted to a sale invoice.

<b>What is the typical export workflow?</b><br>
Quotation or Sale Order → Pro Forma (customer approval) → Commercial Invoice (customs) → Sale Invoice (accounts and inventory).

<b>Can I edit a closed pro forma?</b><br>
Closed documents are read-only. Revise or create a new pro forma if terms change before final billing.

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

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

<ul>
<li><a href="#/sales/sale-quotation">Sale Quotation</a></li>
<li><a href="#/sales/sale-order">Sale Order</a></li>
<li><a href="#/sales/sale-invoice">Sale Invoice</a></li>
<li><a href="#/sales/commercial-invoice">Commercial Invoice</a></li>
<li><a href="#/accounts/receipt-voucher">Receipt Voucher</a> — including <b>Payment In</b> advances and <b>Link with Bill</b></li>
<li><a href="#/sales/sale-settings-config">Sale Settings</a></li>
</ul>

<b>Video — Pro Forma Invoice</b>
<iframe width="560" height="315" src="https://www.youtube.com/embed/Up4mReCuVFE?si=T7UKmgEj7ptKes8O" 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 Pro Forma 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.



### Billing and shipping address required (GST)

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** GSTN is set on the document and billing or shipping (or consignee) address is missing. Applies to Sale Invoice, Credit Note, Sale Debit Note, Pro Forma Invoice, and Commercial Invoice.
- **Example message:** *Billing address and shipping address required*
- **Outcome:** The document is not saved.
- **Solution:** Select Customer Billing Address and Shipping Address, then save.


### Create Invoice hidden when a sale order exists

- **Type:** Restriction (action hidden)
- **Action:** Create Invoice
- **When:** The pro forma already has a linked sale order.
- **Example message:** No toast — the action is hidden.
- **Outcome:** You cannot create another sale invoice from this pro forma.
- **Solution:** Open the linked Sale Order or Sale Invoice instead.

### Closed pro forma is read-only

- **Type:** Restriction
- **Action:** Edit
- **When:** Status is Closed.
- **Example message:** No toast — the form is read-only.
- **Outcome:** Fields cannot be changed.
- **Solution:** Use Revise Pro Forma Invoice, or create a new pro forma.

### Convert to purchase order — id missing

- **Type:** Error
- **Action:** Create Purchase Order
- **When:** The pro forma id is missing on the request.
- **Example message:** *Pro Forma Invoice Id missing*
- **Outcome:** The purchase order is not created.
- **Solution:** Open the saved pro forma and use Create Purchase Order again.


### 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 previous-date 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 (blocks approve or Master Update)
- **Action:** Approve, Save And Approve, Master Update → Confirm
- **When:** The document date is in a closed accounting period.
- **Example message:** *Accounts closed for the date*
- **Outcome:** The document is not posted, or the date is not changed.
- **Solution:** Use a date after the accounts closing date.

### Items missing or invalid

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** The items table is empty, a line is missing Item / Qty / Unit / Rate, quantity is zero (except Sale Quotation when zero qty is allowed), or line totals do not match.
- **Example message:** *items not found* or *Invalid Data in lines {N}* (`fs_api`). ERP: *Items contains invalid data* with *Quantity must be a greater than zero* or *{field} must be a positive number*.
- **Outcome:** The document is not saved.
- **Solution:** Add valid item lines with quantity greater than zero, then save.

### FOC / zero price on a line

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** A line price is 0 and Allow FOC sale is off.
- **Example message:** *Foc sale is not allowed for item in line {N}*
- **Outcome:** The document is not saved.
- **Solution:** Enter a rate greater than zero, or turn on Allow FOC sale.

### Tax required on every item line

- **Type:** Error (blocks approve; ERP may also block save)
- **Action:** Save, Approve, Save And Approve
- **When:** The sale type has Require tax for every item, and a line has no tax.
- **Example message:** *Tax Required for all items*
- **Outcome:** Approve / save is blocked.
- **Solution:** Add tax on every line or set Sale Tax Config defaults.

### Sale type required fields

- **Type:** Error (blocks approve)
- **Action:** Approve, Save And Approve
- **When:** The sale type lists LPO Number, Employee, Brand, or Route as required and that field is empty.
- **Example message:** *LPO number is required.* or *fields required - {fields}*
- **Outcome:** Approve fails.
- **Solution:** Fill the required sale-type fields, then Approve.

### 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>.

### Customer inactive or missing

- **Type:** Error (blocks save or approve)
- **Action:** Save, Approve
- **When:** No customer is selected, or the customer master is inactive / suspended.
- **Example message:** *Customer is required* or *Customer is not active*
- **Outcome:** The document is not saved or posted.
- **Solution:** Select an active customer, or activate the customer master.

### Duplicate LPO or bill number

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** Prevent Duplicate invoice number (or LPO check) is on and the same number already exists.
- **Example message:** *Same bill number … exist* or *Same LPO number … exist*
- **Outcome:** The document is not saved.
- **Solution:** Use a unique bill / LPO number.

### Master Update — date before accounts closing

- **Type:** Error
- **Action:** Master Update → Confirm
- **When:** The new Date is on or before the accounts closing date.
- **Example message:** *Accounts closed for the date* or ERP *Date is required* if Date is empty.
- **Outcome:** The header is not updated.
- **Solution:** Pick a date after the closing date. Item lines cannot be changed in Master Update.

### Delete only Draft or For Revisal

- **Type:** Error / restriction
- **Action:** Delete
- **When:** Status is not Draft or For Revisal.
- **Example message:** *Delete prevented..* (`fs_api`) or ERP confirm *Are you sure ?* only when delete is allowed.
- **Outcome:** Posted documents stay in the ledger.
- **Solution:** Cancel a posted document after unlinking related records. Delete only drafts.

</section>
