Creating an invoice
TL;DR
This page covers raising an invoice from one or more purchase orders: every field, how orders are brought in, and how tax is worked out. The company's and customer's details are copied onto the invoice as it is created, so correct them before you raise it, not after.
What this is for
An invoice turns one or more purchase orders into a shipment. It carries the goods, the prices, the ports, and the tax. Everything after it hangs off the invoice: packing, pallets, and the documents that travel with the goods.
An invoice starts as a draft. It carries a temporary number and can be changed freely. It becomes final only when you complete it. See Completing an invoice.
Before you start
- The company must be set up and switched on. Only companies that are switched on can be chosen.
- The customer must be set up under that company. Customers that are switched off still appear in the list here.
- The customer must have at least one purchase order in Pending, In Progress or Partially Dispatch, with quantity still outstanding on at least one line.
- The purchase order's currency must match the customer's currency.
- If the goods go to a dispatch location rather than the customer's own address, the purchase order must already name that same location.
Creating an invoice
- Open Invoice in the top menu.
- Select Add new invoice. The "Add Invoice" page opens.
- Fill in the header fields, described below.
- Choose the purchase orders and set the dispatch quantities.
- Select Save.
You return to the list and see "Invoice has been created successfully!".
IMAGE PLACEHOLDER: creating-an-invoice-form-01 · annotated screenshot · status: pending
Shows: the "Add Invoice" screen with its two parts: the header fields above, the purchase-order lines below
Must include: the header boxes in screen order (Invoice Date, Company, Customer, Currency, Exchange Rate, Dispatch Details, Port of Loading, Port of Discharge, Transport Mode, Declaration, Allow Pallet, Terms of Delivery & Payment); the item table beneath with its columns; the totals row at the foot; a marker showing that Company, Customer, Currency and Dispatch Details can never be changed after the first save
Must not show: any real customer, company, order number or price
Alt text (draft): The Add Invoice screen has two parts. Header fields at the top set the company, customer, currency, ports, transport mode and pallet answer. A table below holds one row per purchase order line, with the dispatch quantity and rate for each. Company, customer, currency and dispatch location are fixed once the invoice is first saved.
The header fields
| Field | Rules | Notes |
|---|---|---|
| Invoice Date | Required. | The date window is described below. |
| Company | Required. | Only companies that are switched on appear. Fixed after the first save. |
| Customer | Required. | Only customers belonging to the chosen company appear, switched on or not. Fixed after the first save. |
| Currency | Required. | Filled in from the customer and cannot be changed. Fixed after the first save. |
| Exchange Rate | Optional. A number, no less than 0. | Read below before entering 0. |
| Dispatch Details | Optional. | The customer's delivery location, if the goods do not go to the customer's own address. Fixed after the first save. |
| Port of Loading | Required for export invoices only. | See below. |
| Port of Discharge | Required for export invoices only. | See below. |
| Transport Mode | Required for export invoices only. Shipment or By Air. | Decides what pallet work completion needs, and whether the ports apply. One of the few boxes that can still be corrected after completion; see Changing an invoice. |
| Declaration | Required. | The company's own wording, chosen from the declarations set up against it. |
| Allow Pallet | Required. Yes or No. | No default, so you must choose. Changing this to No later destroys pallet work; see Changing an invoice. |
| Terms of Delivery & Payment | Optional. Up to 5,000 characters. | Free text. Prints on the commercial invoice. |
When the ports and transport mode are required
The rule is the destination country, not the customer's type.
Export ERP compares the company's country with the destination country. The destination is the dispatch location's country if you chose a dispatch location, and the customer's country otherwise.
- The two countries differ: an export. Port of Loading, Port of Discharge and Transport Mode are all required.
- The two countries match: a domestic invoice. All three boxes are switched off on screen, emptied, and lose their required marker. Anything already in them is cleared when you save.
The boxes react as soon as you change the company, the customer or the dispatch location. A box that was required a moment ago can empty itself in front of you.
What the Exchange Rate does
The exchange rate converts the invoice's currency into the company's own currency, for tax. The note beside the box shows the direction, as "(CUSTOMER CURRENCY to COMPANY CURRENCY)".
Leave it empty when it does not apply. An empty box is treated as a rate of 1, and nothing on the documents changes.
Do not enter 0 to mean "not applicable". Zero is accepted, and it does not zero your amounts. The screen treats 0 as 1 while working out the taxable amount, so the figures look right. But the 0 is stored. The tax invoice shows its converted-amount columns whenever the rate is anything other than 1. A rate of 0 therefore makes those columns appear, filled with figures worked out at a rate of 1. The document shows a conversion that did not happen.
If the two currencies are the same, the box fills itself with 1.
The date window
Invoice Date must fall between today and the first day of the month three months ahead. A date outside that range is refused with "Date must be after or equal to" or "Date must be before or equal to", followed by the boundary date in day-month-year form.
Your installation can be set to accept any date. Where that has been done, no window applies. If dates outside the window are accepted for you, that is why.
Bringing in purchase orders
Choose the company and customer first. The purchase order list then offers only orders that pass every one of these:
- They belong to that company and that customer.
- Their status is Pending, In Progress or Partially Dispatch. Complete and Delete orders never appear.
- At least one line still has quantity outstanding.
- Their dispatch location matches the invoice's. If you chose a dispatch location, only orders naming that same location appear. If you chose none, only orders with no dispatch location appear.
An order that seems to be missing has failed one of these. The dispatch-location rule is the one people miss.
Every order on one invoice must share the customer's currency. If any does not, the save is refused and the message names the offending orders: "The following Purchase Order(s) have a different currency than the invoice currency: " followed by the order numbers.
The dispatch location is checked again on save. If an order's location no longer matches the invoice's, the save is refused with "The following selected Purchase Order(s) do not match the selected invoice dispatch details: " followed by the order numbers.
Choosing orders brings in every line that still has quantity outstanding. Lines already fully dispatched are left behind.
Dispatch quantities
Each line arrives with Dispatch Qty already filled in with the amount still outstanding on that line. You can lower it, invoice part of the order now, and invoice the rest later on another invoice.
Remaining Qty on the row shows what was outstanding before this invoice.
The outstanding amount is the line's ordered quantity minus everything already dispatched on other invoices. Export ERP works it out again at the moment you save, so a colleague invoicing the same order while you were typing will change it.
Going above the outstanding amount is refused with "Exceeds available qty (12.000).", unless over-dispatching is allowed. Your own figure will differ.
That permission comes from the purchase order, not from the customer. The order took a copy of the customer's Allowed Extra Quantity answer when the order was created. Changing the customer's answer afterwards does not reach orders already raised, and the invoice reads the order's copy. To change it for an order, revise the order. See The over-ordering setting.
Rates, amounts and totals
Each line carries a Rate you can change, and an Amount worked out as dispatch quantity times rate. You cannot type into Amount.
Additional Charges is the one figure under the table you can type into. It starts at 0.0000 and cannot be negative.
Everything else under the table is worked out for you: Total Amount, Taxable Amount, Total Taxable Amount and Final Amount. Final Amount is Total Amount plus Additional Charges.
Taxes
Which taxes apply is decided by where the company and the customer are, not by anything you choose:
- The company is not in India: no tax is worked out at all.
- The company is in India, the customer is abroad: IGST applies if the company is set up to export with payment of IGST, and no tax applies otherwise.
- Both are in India, in the same state: CGST and SGST apply, each half the product's GST percentage.
- Both are in India, in different states: IGST applies.
Each line's tax comes from its product's GST percentage, worked out on the line's converted amount.
Taxes are worked out when you save the invoice, not when you complete it. See Completing an invoice for why that matters.
Errors you may see
| What happened | What you see |
|---|---|
| No date chosen | "Please select a date." |
| The date is outside the window | "Date must be after or equal to 01-04-2026." / "Date must be before or equal to 31-07-2026." (your dates will differ) |
| No company chosen | "Please select a company." |
| No customer chosen | "Please select a customer." |
| No currency chosen | "Please select a currency." |
| The exchange rate is not a number | "Exchange rate must be a number." |
| A negative exchange rate | "Exchange rate must be greater than or equal to 0." |
| No port of loading on an export invoice | "Please select a port of loading." |
| No port of discharge on an export invoice | "Please select a port of discharge." |
| No declaration chosen | "Please select a declaration." |
| No transport mode on an export invoice | "Please select transport mode." |
| No answer to Allow Pallet | "Please select whether pallet is allowed." |
| Terms of Delivery & Payment too long | "Terms of Delivery & Payment must be less than or equal to 5000 characters." |
| A negative figure in Additional Charges | "Additional charges cannot be negative." |
| No lines on the invoice | "Please add at least one item to the invoice." |
| A dispatch quantity left empty | "Please enter dispatch quantity." |
| A dispatch quantity of 0 or less | "Dispatch quantity must be greater than 0." |
| A dispatch quantity with too many decimals | "Dispatch quantity only up to 3 digits are allowed after the decimal point." |
| A dispatch quantity above what is outstanding | "Exceeds available qty (12.000)." (your figure will differ) |
| A rate left empty | "Please enter rate." |
| A rate of 0 or less | "Rate must be greater than 0." |
| A rate with too many decimals | "Rate only up to 4 digits are allowed after the decimal point." |
| An HSN code containing anything but digits | "HSN code must contain only numbers." |
| An order in a different currency | "The following Purchase Order(s) have a different currency than the invoice currency: " then the order numbers |
| An order with a different dispatch location | "The following selected Purchase Order(s) do not match the selected invoice dispatch details: " then the order numbers |
| Something else went wrong | "Something went wrong. Please try again later." |
What happens behind the scenes
- The company's and customer's details are copied onto the invoice as it is created. From the company: name, address, logo, GSTIN, PAN, bank details, IEC, AEO certificate number, REX number, EORI number, CIN and country. From the customer: name, to-the-order name, address, GSTIN, EORI number, country, state and currency. Also the chosen dispatch location, the port names and the declaration wording. Correcting any of those afterwards never reaches this invoice or its documents. The correction must be made before the invoice is created, or the invoice must be raised again.
- Saving an invoice moves its purchase orders to In Progress, without telling you. Only orders sitting at Pending move; orders already further along stay where they are.
- The orders' outstanding quantities are rewritten to reflect what this invoice takes. Other invoices drawing on the same orders have their outstanding figures refreshed at the same time.
- The invoice is given a draft number as it is created, built from the company's own invoice numbering with "-DRAFT" on the end. See The different numbers.
- Nothing about packing exists yet. Packing is entered separately once the invoice exists. See How packing works.
FAQs
Why did the port and transport mode boxes empty themselves?
When the company's country and the destination country match, the invoice is domestic: Port of Loading, Port of Discharge and Transport Mode are switched off, emptied, and lose their required marker. The boxes react as soon as you change the company, the customer or the dispatch location.
Why is a purchase order missing from the list?
An order appears only if it belongs to the chosen company and customer, its status is Pending, In Progress or Partially Dispatch, at least one line still has quantity outstanding, and its dispatch location matches the invoice's. The dispatch-location rule is the one people miss.
Should I enter 0 in Exchange Rate when it does not apply?
No, leave the box empty; an empty box is treated as a rate of 1. A 0 is stored, and it makes the tax invoice's converted-amount columns appear, filled with figures worked out at a rate of 1, showing a conversion that did not happen.
Can I invoice only part of an order?
Yes. Each line arrives with the outstanding amount filled in as its Dispatch Qty, and you can lower it to invoice part of the order now. The rest stays on the order for another invoice later.
Why didn't correcting the customer's address change my invoice?
The company's and customer's details are copied onto the invoice as it is created, and corrections made afterwards never reach it or its documents. The correction must be made before the invoice is created, or the invoice must be raised again.
Why did the purchase order's status change to In Progress on its own?
Saving an invoice moves its purchase orders from Pending to In Progress without telling you. Orders already further along stay where they are.
Related pages
- Changing an invoice: what changes safely and what destroys work
- Completing an invoice: the final, irreversible step
- Finding invoices: the list, its filters and its exports
- Creating a purchase order: where the orders come from
- Customer: dispatch locations and the over-ordering setting
- Company: declarations, invoice numbering and the tax setting
- How packing works: the next step
- About documents: the paperwork this invoice produces
- Trade and tax terms: IGST, CGST, SGST and the rest
Last verified: 22 September 2026
No comments to display
No comments to display