Dijit.app Dijit.app Documentation

Documentation/ Checking the document header/ VAT, withholding tax and deductions

VAT, withholding tax and deductions

Tax is the part of a document where the odd cases gather. Dijit.app pulls out the whole breakdown, including documents with several rates, exempt transactions and anything with tax withheld.

Document › General tab › the tax block

The VAT breakdown

For every tax rate on the document, the system records three things:

ValueWhat it is
NetThe amount that rate is applied to.
RateThe tax rate applied.
AmountWhat that tax comes to.

The check tests that the tax amounts add up to the document's tax total. When they do not, the status is Review VAT.

Documents with several rates

An invoice can carry goods at different rates: food at one, drinks at another, services at a third. The system handles it: it records as many breakdown lines as there are rates, each with its own net and its own tax.

That has a consequence for exports: the file with the tax breakdown gives you one row per rate, so an invoice with two rates takes two rows. Some accounting packages insist on one row per invoice; in that case use the documents export or a format built to order.

It is also the commonest reason for the Review VAT status: one rate read wrongly or missing is enough to stop the total agreeing.

Fixing the breakdown and updating the amounts

When the breakdown has not been read properly, you correct it by hand in the tax table. That only fixes the table: the header amounts stay as they were, and the document still does not add up.

That is what Update amounts is for, on the table's totals row. It carries the breakdown's figures up into the header:

Header fieldWhat it gets
Net amountThe breakdown's nets added up.
Total VATThe tax amounts added up.
Total surchargesThe surcharges added up, on the documents where that field exists.
TotalNet plus VAT plus surcharge plus extra charges, less withholding.

Before anything changes, a window shows the current and the new value of each field, with the rows that change highlighted. Accept it and the amounts are filled in on screen: you have to save the document to keep them.

The button tells you and changes nothing if the amounts already agree with the breakdown, or if the table is empty, so that correct amounts are never wiped by accident. The overall discount and the carriage do not come into the calculation, because they are already inside the net.

Exempt and intra-community transactions

They go through the same way, except that the tax amount is zero or not there at all:

On these documents the net and the total are the same. Nothing has been read wrongly.

Withholding tax

The header has fields of its own for both, each with a rate and an amount:

WhatWhere you usually see it
IRPFInvoices from self-employed professionals, and rent.
WithholdingAny other amount the document holds back.

The nominal coding also takes a withholding account of its own, separate from the expense one and from the creditor's.

What each does to the total

Tax and withholding do not pull the same way, and mixing them up leads to calling a perfectly good document wrong:

WhatEffect on the total
VATAdds
Equivalence surchargeAdds
IRPFSubtracts
WithholdingSubtracts

An invoice from a professional with VAT at 21 % and 15 % withheld has a total lower than net plus VAT. That is right.

What to check

  1. That every rate on the document is there.
  2. That the nets add up to the total net.
  3. That withholding has been picked up when the document applies it: this is the one most often missed, because it subtracts, and leaving it out makes the total too high.
  4. That the surcharge is there, if the buyer is in that scheme.

Particular cases

CaseHow it is handled
Tax inside the total, not broken outSwitch on the VAT included calculation.
A retailer on the Spanish special schemeAs well as VAT, it carries the equivalence surcharge.
A credit noteThe tax amounts take the same sign as the net: if the net is negative, so is the tax.
Differences of a penny or twoUsually the issuer's rounding, working the tax out line by line. Nothing to correct.
A document in another currencyThe amounts are recorded as they stand; the application does not convert them.

↑ Back to top

Last reviewed: 11 September 2026 · The Dijit.app team