← User guide

Advance Invoices (Sales)

Advance (proforma) invoices as their own documents, a tax document for every payment received on them, and the deduction of the advance on the final invoice.

Version19.0.2.8.1
EditionCommunity and Enterprise
LicenceAGPL-3
Requiressale, sale_management, account_payment
Extended byaccount_edi_isdoc_sale_advance, advance_invoice_saldo_xlsx, l10n_cz_sale_order_advance_invoice, l10n_sk_sale_order_advance_invoice, sale_order_advance_invoice_payment_match

What it is for

In Czech and Slovak practice an advance is handled in three documents:

  1. the advance invoice (CZ zálohová faktura, SK zálohová or preddavková faktúra) — a request for payment, not an accounting or tax document, and not posted;
  2. the tax document for the payment received (CZ daňový doklad k přijaté platbě, SK faktúra k prijatej platbe) — issued once the money has arrived, because the VAT falls due on the day of payment;
  3. the final invoice (CZ vyúčtovací / konečná faktura, SK vyúčtovacia faktúra) — the whole supply, from which the advance and the VAT already declared on it are deducted, so the VAT is paid only once.

Odoo's own down payments post an invoice for the advance straight away. This module instead keeps the advance invoice as a separate quotation-like document, numbered ADV00001, ADV00002…, which the customer can pay by QR code, through the customer portal or by bank transfer. Only the payment and the tax document reach the ledger.

The module is country-neutral. The Czech and Slovak account wiring comes from the localization add-ons described under Localization add-ons. The supplier side is purchase_order_advance_invoice.

Slovakia — zákon o DPH:

Czech Republic — zákon č. 235/2004 Sb., o dani z přidané hodnoty:

Setting it up

Sales → Configuration → Settings, block Invoicing:

Setting What it does
Advance Tax Documents Journal The journal the tax documents go to. Installing the module creates a general journal TDADV for the company and selects it.
Advance Clearing Account A reconcilable account on which the payment and the tax document meet, e.g. 324001.
Received Advance Account (short-term) Carries the net received advance until the final invoice, e.g. 324000.
Received Advance Account (long-term) The same for advances marked Long-term Advance, e.g. 475000.

Without a localization add-on you fill in the three accounts yourself.

Before the first advance, also check:

Localization add-ons

l10n_cz_sale_order_advance_invoice and l10n_sk_sale_order_advance_invoice fill in the settings above for every company with the Czech or Slovak chart of accounts — at installation, and again whenever the chart is loaded later, for example for a new company:

Role Account Czech name Slovak name
Clearing account (created by the add-on, reconcilable) 324001 Přijaté zálohy – zúčtování (daňový doklad) Prijaté preddavky – zúčtovanie (daňový doklad)
Received advances, short-term 324000 Přijaté provozní zálohy Prijaté preddavky
Received advances, long-term 475000 Dlouhodobé přijaté zálohy Dlhodobé prijaté preddavky
Journal TDADV — Daňové doklady k přijatým platbám Faktúry k prijatým platbám

Only empty settings are filled, so accounts you chose yourself are kept.

Creating an advance invoice

On a confirmed sales order, click Create Advance Invoice and choose:

Option Result
Full amount one Advance line per order line, priced at that line's subtotal
Percentage of total amount one Advance line for the percentage of the untaxed total
Fixed amount one Advance line for the untaxed amount you enter
Include the ordered items the order's own products, quantities and VAT rates instead of Advance lines; for a percentage or a fixed amount the unit prices are scaled down and the quantities stay as ordered

Tick Include the ordered items whenever the order's VAT rate differs from the Advance product's, or the order mixes rates. Without it every advance line carries the Advance product's taxes, and so does the tax document raised on the payment. The final invoice then settles the difference, so no VAT is lost or charged twice, but the VAT declared on the payment was at the wrong rate.

The advance invoice opens as a new document linked to the order. On it:

The order gets an Advance Invoices section with a zero-quantity line per advance, kept up to date with its state, payment date and tax document, and an Advance Invoices smart button. Advance invoices do not appear under Quotations or Orders. They have their own menu, Sales → Orders → Advance Invoices and Accounting → Customers → Advance Invoices, which is also where you create one without an order (see Advances without an order).

Confirming an advance never creates a delivery: the goods are delivered from the original order.

Receiving the payment

The Payment Status of an advance (Not Paid, Partially Paid, Fully Paid, Overpaid) follows the payments linked to it. The two smart buttons below appear once the advance has been sent or confirmed and part of it is still unpaid. A payment can arrive in four ways:

The tax document for the payment

Once something is paid, the advance's Accounting Status moves from Nothing to Account to Waiting, and the header shows Create Invoice. Clicking it creates a draft tax document for the paid amount not yet covered by an earlier tax document. Each instalment of a partly paid advance can therefore have its own.

The tax document:

Check it and post it. Posting reconciles it on the clearing account with the payments of that advance, and the status becomes Accounted.

The advance list shows the deadline in Accounting Date Due, turning red once it has passed. It follows the company's country (see Legal background):

Country Deadline
Czech Republic 15 days after the payment
Slovakia 15 days after the payment or the last day of that month, whichever is later (15 days for payments before 2016)
any other 15 days after the payment

Settling on the final invoice

Invoice the order as usual (Create Invoice on the order). Every paid advance is added below the regular lines in an Advance Invoices section, as a negative line:

Only what was received is deducted: a partly paid advance is deducted for the part paid, not for its full amount. A tax document still in draft covers nothing. An advance is deducted only once something has been paid on it, and only together with regular lines that are ready to invoice. If nothing else can be invoiced yet, for example because nothing has been delivered, Odoo reports that there is nothing to invoice.

Foreign currency. A deduction is converted at the rate its tax documents were declared at, and so is the part of the supply the advance paid for. Only the rest of the supply is converted at the final invoice's rate. A fully prepaid supply therefore nets to zero VAT and leaves nothing on the receivable, as § 37a requires for the Czech Republic.

Advances without an order

An advance invoice created directly from the Advance Invoices menu has no order. To settle it, open the final customer invoice while it is still a draft and click Link Advance Invoices. You can pick confirmed advances of the same customer with something paid on them that no other invoice deducts. Each one is added exactly as on an order's final invoice: the part covered by posted tax documents net with their VAT reversed, one line per rate, and the rest of what was received gross without VAT.

Limitations