How do I define the withholding types?
A withholding type is an income tax withholding (IRPF) percentage with a name: 15 % for professionals, 19 % for rentals, 2 % for agricultural activities. They are defined in Tax → Withholding types, and from there they are chosen on customer, supplier and item records and on document lines.
Where do I define the withholding types?
Go to the Taxes menu and then Withholding types. The screen has two parts: on the left the list of types, with a search box by code or description; on the right the record of the one you have selected, on the Definition tab.
Each row in the list shows the code and the percentage, the description underneath and two labels: the nature and whether it is Active or Inactive.
Withholding types are the same for all your companies. If you change a percentage, it changes for all of them.
What details does a withholding type have?
The record on the Definition tab has six fields:
- Code: the short identifier, for example
RET15. It can’t be repeated and is always saved in capitals. - Percentage (%): what is withheld, between 0 and 100.
- Description: the text you will see when choosing the withholding.
- Nature: what kind of income is being withheld.
- AEAT key and AEAT subkey: the key for the annual summary.
- Active: whether it is still offered when choosing a withholding.
Changes aren’t saved automatically. When you finish, click Save changes. Cancel undoes what you have typed and goes back to the saved details.
What is the nature of a withholding for?
The Nature says what kind of income is withheld, and it determines the form in which that withholding will be declared:
| Nature | Declared in |
|---|---|
| Employment income | 111 and annual summary 190 |
| Professional activities | 111 and annual summary 190 |
| Agricultural activities | 111 and annual summary 190 |
| Rental | 115 and annual summary 180 |
| Investment income | 123 and annual summary 193 |
| Unclassified | none |
Those six forms are generated from the ERP and you have them in the Taxes menu: 111 (in Spanish), 115 (in Spanish), 123 (in Spanish) and their annual summaries 190 (in Spanish), 180 (in Spanish) and 193 (in Spanish). What you do here is the classification they come from: a wrongly classified type is declared in the wrong form, or in none.
Unclassified is the starting value of any type that nobody has classified. An unclassified type still works normally on documents; the only thing that happens is that it is left out of the forms, without any warning. Go through the list and classify the ones you use.
When you select a type that is already saved, the record shows Self-assessment form at the bottom with the result of that choice, so you can check it at a glance.
What do I enter in AEAT key and AEAT subkey?
AEAT key is the letter the annual summary uses to tell the type of income apart, and AEAT subkey is the two digits that some keys need for more detail. Each form has its own table of letters, and the same letter doesn’t mean the same thing in two different forms:
| Nature | Form that uses the key | Examples |
|---|---|---|
| Employment | 190 | A (employees, no subkey) |
| Professional activities | 190 | G + 01 (general percentage), 03 (reduced) |
| Agricultural activities | 190 | H + 01 |
| Investment income | 123 and 193 | A + 02 (dividends) · B + 03 (interest on non-bank loans) · B + 01 (debentures and bonds) · C + its own (rental of movable property, intellectual property…) |
| Rental of real estate | none | leave them empty: Form 180 doesn’t declare by key |
For investment income the key isn’t optional. It is the only thing that tells a dividend apart from interest, because both are investment income and usually go at the same 19 %. If you leave it empty, Forms 123 and 193 assume loan interest (B 03) and warn you; dividends have to be marked with A 02. See how I file Form 123 (in Spanish).
Copy them exactly as the AEAT publishes them. The screen saves them as text and converts them to capitals, but doesn’t check that the combination exists: if you get the key wrong, the error will show up when you file, not here.
The key is frozen when the payment is recorded. Changing it on the record today doesn’t rewrite what has already been recorded: the register entries keep the one they had, so that a financial year already declared doesn’t change by itself.
How do I create a new withholding type?
- Click New type in the header.
- Fill in Code, Percentage (%) and Description.
- Choose the Nature and, if applicable, the AEAT key and the AEAT subkey.
- Click Create type.
The new type appears in the list and stays selected.
How do I stop using a withholding type?
Withholding types aren’t deleted: the documents and items that used them still point to them, and deleting them would leave that data without an explanation.
To retire one, select it, untick Active and click Save changes. It is no longer offered when choosing a withholding on documents and records, but it keeps its history and still appears in this list with the Inactive label.
Which types are already created?
When you set up the program for the first time, some starting types are loaded: the professional withholding at 15 % and the reduced one at 7 %, rentals at 19 %, agricultural activities at 2 % and investment income at 19 %, each with its nature and its key.
They are a starting point, not an obligation: change their percentage if the law changes it, and create any you are missing. If you come from an earlier installation, it is normal to have only the first three; the other two are created by hand with New type.
If something goes wrong
| What you see | What has happened | What to do |
|---|---|---|
| ‘The withholding type code is required.’ | The Code field is empty | Type a code |
| ‘The withholding type description is required.’ | The Description field is empty | Type the description |
| ‘Withholding type ‘…’ already exists.’ | That code is already in the list | Use another code, or edit the one that already exists |
| ‘The withholding percentage must be between 0 and 100.’ | The Percentage (%) is out of range | Correct the percentage |
| ‘The AEAT key is a single letter.’ | More than one character was typed in AEAT key | Leave only the letter |
| ‘The AEAT subkey has at most two characters.’ | AEAT subkey is longer than two digits | Leave the two digits |
| There is no button to delete a type | It is deliberate: documents refer to it | Untick Active |
| A type doesn’t appear when choosing a withholding | It is marked as Inactive | Mark it Active again |
See also: Where do I change my company’s details · Add a supplier · File Form 303 (in Spanish)
More about Taxes
- How do I record the adjustments, losses and deductions for corporation tax?
- Filing your taxes
- How do I prepare the withholding return for a quarter?
- What is the Tax dashboard and what is it for?
- How do I record a payment without an invoice?
- How do I produce the balance sheet and the profit and loss account for corporation tax?
- How do I check all my forms in one go before a filing season?