Withholding tax is not calculated or does not go into the payment guide

Symptom

On a vendor bill, the Taxes column comes without withholding, or Confirm is refused. Or the bill has withholding but, when you click Generate on the month's guide, the total stays at 0.00 € and no line appears, without any message.

Message

On a 50.00 € bill from a supplier with 23 % withholding, when you click Confirm:

“The withholding of 11,50 € on “Retenção IRS 23% — trabalho independente (art. 151.º)” is below the legal minimum of 25,00 € per withholding (CIRS art. 101.º-B no. 1 d)), so it is exempt. Take the withholding tax off the line and post again.”

If the line only has the withholding, without VAT:

“Line "Honorários de outubro" of the invoice to Ana Ferreira has no VAT tax. Choose a VAT tax (or a 0% VAT tax with an exemption reason, or a "not subject" tax).”

The messages on this page were triggered in the demo database, with a user who only has the Accountant profile. The amount in the message is the one on the Withholding tax line of the bill total. Pending validation by a certified accountant: the legal minimum per withholding that the message cites.

When you confirm a bill with a withholding tax whose percentage is not the legal rate on that date. Use the tax the message indicates, or correct the date of the document:

“Tax “Retenção IRS 20% — trabalho independente” withholds 20,00% but the legal rate for “IRS cat. B — atividades profissionais da tabela do art. 151.º” on 06/11/2026 is 23,00%. Use the tax “Retenção IRS 23% — trabalho independente (art. 151.º)” (the rate follows the date of the payment or availability of the income), or correct the date of the document.”

If no rate is loaded for the date of the income (in the demo, 15/03/2000 in Special operations › Payment/availability date of the income), the bill is not refused: it becomes Posted, and the note appears in the document's history:

“Configuration error: there is no withholding rate loaded for “IRS cat. B — atividades profissionais da tabela do art. 151.º” on 15/03/2000. The document was posted with the rate of the chosen tax (23,00%) and was not checked against the law. Ask the certified accountant to load the rate for that period with its legal source (Accounting › Configure › VAT and withholding › Withholding rules and codes).”

For now, on an old document, fill in Payment/availability date of the income. With the field empty, the rate is not checked on the document date: on a vendor bill dated 15/03/2015, with the period locked up to 31/12/2025, the entry moved to 31/01/2026 and the 23 % withholding was accepted with no refusal and without this note. Confirm the rate on the income date with the certified accountant.

Verified causes

• The supplier has no Default withholding. The Taxes column comes empty and nothing warns you (in the demo, Papelaria Central).
• The withholding does not replace the VAT. With Default withholding, Taxes only brings the withholding; the line's VAT is chosen separately.
• The withholding is below the legal minimum. fiscaldoo refuses the withholding, which in this case is exempt.
• The withholding was removed from the line of a supplier that is subject to it. See “Confirming the bill is refused” in How to set up withholding tax.
• The bill is in draft or has not been paid yet. The guide only reads Posted bills and follows the month of payment, not the month of the bill. A Posted bill that is still unpaid does not go in. In the demo, a 1,000.00 € draft with withholding did not change the November guide.
• The guide was not generated again. The draft only shows what existed when you clicked Generate.
• The guide is for the wrong tax. An IRC withholding guide does not show Personal Income Tax (IRS) withholdings, and vice versa. In the demo, the November IRC guide stayed at 0.00 €, with the IRS guide for the same month at 230.00 €.
• The withholding is the one your customer made on you. Only the withholdings the company makes on its suppliers go into the guide. In the demo, a 1,000.00 € customer invoice, with 230.00 € withheld by the customer and already paid, did not change the guide.

What to check

1. On the supplier record, Sales & Purchase tab, the Default withholding.
2. On the bill, the Taxes column and the total: a 1,000.00 € bill with 23 % VAT and 23 % withholding shows IVA 23% 230.00 €, Withholding tax -230.00 € and Total amount 1,000.00 €.
3. The income code and the rule's rate, in Accounting › Configure › VAT and withholding › Withholding rules and codes. The menu appears to the Certified accountant profile; not to the Accountant.
4. Whether the bill is paid, and in which month.

How to fix it

The bill has no withholding

If the supplier must always have withholding, fill in the Default withholding on the record: How to set up withholding tax. On the draft bill, add the withholding and the VAT in Taxes.

Who does it: Accountant.

The withholding is below the minimum

On the line, remove Retenção IRS 23%… from Taxes, keep the VAT and click Confirm. In the demo, the 50.00 € bill became Posted with a total of 61.50 €.

On an account with a VAT deduction rule, the withholding is calculated on the whole line amount. In the demo, a 120.00 € bill on an account with 75 % deduction became Posted with Withholding tax -27.60 €, with no refusal.

Who does it: Accountant.

The withholding does not appear in the guide

1. Register the payment of the bill with the Pay button.
2. In Accounting › Declare › What is there to do with the withholdings?, open Withholding guides and the guide for the tax and month of payment.
3. With the guide in draft, click Generate again.

In the demo, FTF/2026/00046 (1,000.00 € with 230.00 € withholding, dated 03/11/2026) gave 0.00 € in the November guide while it was unpaid. Once paid, the same guide showed IRS cat. B — atividades profissionais da tabela do art. 151.º, with a base of 1,000.00 € and 230.00 €.

Who does it: Certified accountant. The Accountant profile sees the list of guides, but does not have the New button. Issuing and paying the guide: How to pay the month's withholding tax.

Expected result

The bill becomes Posted with the right withholding, or without it if it is exempt, and the guide for the month of payment has a line with the base and the amount. Form 10 (Modelo 10) and the Form 30 (Modelo 30) map have their own refusals, covered in those articles.

When to contact support

• The bill is paid, the guide is for the right tax and month, and Generate still gives no line.
• The message gives a legal rate different from the one the rule shows.

Information to send

• The bill number (for example FTF/2026/00046) and the guide number.
• The full text of the message, copied from the screen.
• The supplier, the date of the bill and the date of payment.