Skip to content
AIM PAPYRSign inMenu

Verifactu: who it applies to and from when

Verifactu errors: what each code means and what to do

When your invoicing software sends records to the Spanish Tax Agency, the response may carry an error code. Here is each one, with the official text, what it means in plain words and what to do.

AIM PAPYR does not send records: your invoicing software does. This page explains what the Agency replies to it. If you have the response file, upload it to the chain-checking tool and it explains each code in that response. Check a Verifactu chain or a response from the Agency

Find a code

How to read a response

The Agency groups its codes in three. The first thing is to know which group yours is in:

If the submission answers a request from the Agency, do not fix business errors: the records are sent as they were kept when generated.

Whole submission rejected (44)

The Agency rejects the whole submission: no invoice in that submission is recorded.

The file sent does not have the form the Agency requires

What it means: The message the software sent does not follow the official schema (a mandatory field is missing, the encoding is not UTF-8, it carries more records than allowed or a date in another format), so the Agency did not read it.

What to do: Whoever maintains your invoicing software fixes it: give them the code and the official text. The software then sends the whole batch again.

Codes (official text):

The issuer's tax ID or name is not in the register as written

What it means: The tax ID or name of the party obliged to issue the invoices, or of their representative, is misspelt or does not match what the Spanish Tax Agency's register holds.

What to do: Check in your software the tax ID and company name exactly as they appear in the register, with no spaces or hyphens, and let the software send again.

Codes (official text):

The certificate does not belong to someone allowed to send

What it means: The certificate used to send does not belong to the invoice issuer or to someone authorised by them (social collaborator, attorney or successor).

What to do: Send with the company's certificate, or register the power of attorney for that procedure on the Spanish Tax Agency's e-office.

Codes (official text):

The header does not match the type of submission

What it means: The header carries data that does not fit its mode: a voluntary Verifactu submission or the reply to a request from the Agency.

What to do: Check which mode your software works in and whether the submission answers a request. The software provider adjusts the header.

Codes (official text):

A technical fault or a service that is not available

What it means: It is a technical error in the Spanish Tax Agency's systems, or a service not available at that time or at that address. It says nothing about your invoices.

What to do: Wait a while and let the software try again. If it keeps happening, the software provider should check the service address.

Codes (official text):

Access to the system is suspended

What it means: The Spanish Tax Agency has temporarily suspended access to the system for any request.

What to do: Write to the mailbox given in the official text. Until it is resolved, submissions are not accepted.

Codes (official text):

The record clashes with what the Agency already holds

What it means: The Agency already has that record, has already cancelled it, cannot find it, it belongs to another holder, the submitter lacks permission to update it, or it was registered through a form.

What to do: Before sending again, check what the Agency holds for that invoice. If it is already recorded as correct, there is no need to send it again.

Codes (official text):

An error in a query, not in a submission

What it means: It is an error in a query to the Agency (its filters, period, flags or who is making it), not in sending an invoice.

What to do: Check the query filters in your software: period, from and to dates, and who is querying. Whoever queries must be the recipient, an attorney or a successor, authorised for the procedures needed.

Codes (official text):

Invoice record rejected (193)

The Agency rejects this record; the others in the submission carry on. If the error is in the header, the whole request is rejected.

A technical fault or a service that is not available

What it means: It is a technical error in the Spanish Tax Agency's systems, or a service not available at that time or at that address. It says nothing about your invoices.

What to do: Wait a while and let the software try again. If it keeps happening, the software provider should check the service address.

Codes (official text):

The record clashes with what the Agency already holds

What it means: The Agency already has that record, has already cancelled it, cannot find it, it belongs to another holder, the submitter lacks permission to update it, or it was registered through a form.

What to do: Before sending again, check what the Agency holds for that invoice. If it is already recorded as correct, there is no need to send it again.

Codes (official text):

The invoice number, date or type

What it means: The serial number, issue date or invoice type is empty, misspelt or outside what is allowed: for example, a future date, one more than twenty years old or one before 28 October 2024.

What to do: Correct that field in your invoicing software and send that record again.

Codes (official text):

A tax identifier is not valid

What it means: An identifier on the invoice (of the issuer, the recipient or another party) is badly formatted, is not in the register, or does not match its country or identification type.

What to do: Check each party's tax ID. If it is the tax ID of an individual who is not in the register, use the type «Not registered» (07); if it is a company, check its tax ID and company name; if foreign, use their country and document type.

Codes (official text):

The invoice type does not match its data

What it means: The type chosen (full, simplified, corrective or replacement) does not match the blocks that go with it: the type of correction, the replaced invoices, the corrected amount or the recipients.

What to do: Check that invoice's type and what it requires: a corrective invoice carries its type of correction; a simplified invoice (F2) or its corrective (R5) carries no recipients block.

Codes (official text):

The VAT or surcharge rate is not an accepted one

What it means: The tax rate or the equivalence surcharge rate is not among those accepted, or did not apply on the date of the transaction.

What to do: Check the rate applied and the transaction date: temporary rates only apply to the dates the official text gives.

Codes (official text):

The figures do not add up

What it means: The tax amount does not match the base and the rate, the total is not the sum of its parts, the signs do not match, or the very-large-amount flag (macrodato) is missing.

What to do: Recalculate base, tax, surcharge and total in your software and send the record again.

Codes (official text):

The regime, classification or tax do not match

What it means: The regime key, the classification of the transaction (subject, exempt or not subject) or the tax do not match each other or the rest of the invoice.

What to do: Check with whoever handles your taxes how that transaction is classified and correct it in the software: each regime key only accepts certain classifications and rates.

Codes (official text):

The data of a third-party issuer

What it means: The invoice says it was issued by a third party or by the recipient, and that third party's data is missing, superfluous or inconsistent.

What to do: If a third party issues the invoice on your behalf, fill in its block with its tax ID, different from yours; if not, remove that flag.

Codes (official text):

The invoicing agreement does not exist

What it means: The record cites an invoicing agreement that the Spanish Tax Agency has not registered.

What to do: Check the invoicing agreement number. If there is no registered agreement, remove that field from the record.

Codes (official text):

The invoicing software's data

What it means: The data of the software that generates the record is missing or wrong: its name, its identifier, its manufacturer or who generates the invoice.

What to do: The software manufacturer fixes this: give them the code. It does not depend on your invoices' data.

Codes (official text):

The hash or the link to the previous record

What it means: The record's hash, or the link to the previous one (its hash, number or date), has a format or length other than the specification's, or are missing or wrongly filled in.

What to do: Check the chain with the AIM PAPYR tool and pass the result to the software provider: chained records are not rebuilt by hand.

Codes (official text):

The correction flags

What it means: The correction and prior-rejection flags are wrongly combined: for example, a prior rejection is flagged without flagging the correction.

What to do: When a corrected record is sent again, the correction is flagged and, only if it was rejected before, the prior rejection. The software sets this.

Codes (official text):

A field in a format that is not accepted

What it means: A field has a length, value or characters the specification does not accept (for example <, >, quotes or =).

What to do: Correct the field the official text names and send the record again.

Codes (official text):

An error in a query, not in a submission

What it means: It is an error in a query to the Agency (its filters, period, flags or who is making it), not in sending an invoice.

What to do: Check the query filters in your software: period, from and to dates, and who is querying. Whoever queries must be the recipient, an attorney or a successor, authorised for the procedures needed.

Codes (official text):

Accepted with errors, to be corrected (10)

The Agency accepts the record, but it stays with an error and must be corrected.

The hash does not match the Agency's calculation

What it means: The hash in the record is not the one the Spanish Tax Agency calculates. The record is accepted, with an error.

What to do: Check the chain with the AIM PAPYR tool. If the recalculated hash does not match either, the software does not compute it as the specification requires: tell its provider so it can be corrected.

Codes (official text):

The recipient is not in the register

What it means: The recipient's tax ID is not identified in the Agency's register. The record is accepted, with an error.

What to do: If the recipient is an individual whose tax ID is not in the register, identify them with the type «Not registered» (07) and correct the record; if it is a company, check its tax ID and company name, because that type is not valid for it.

Codes (official text):

The previous record's hash has another length

What it means: The previous record's hash does not have the length the specification sets. The record is accepted, with an error.

What to do: Tell the software provider the code: it is a fault in how it builds the chain.

Codes (official text):

The previous record's hash is not valid

What it means: The content of the previous record's hash is not what the specification sets. The record is accepted, with an error.

What to do: Tell the software provider the code: it is a fault in how it builds the chain.

Codes (official text):

The record's time is too far from the Agency's

What it means: The date and time the record was generated is further from the Agency's time than allowed. The record is accepted, with an error.

What to do: Check the clock and time zone of the computer the software runs on.

Codes (official text):

The total amount does not add up

What it means: The total amount is not the sum of base, tax and surcharge. The record is accepted, with an error.

What to do: Recalculate the total in your software and correct the record.

Codes (official text):

The total tax does not add up

What it means: The total tax is not the sum of the tax amounts and surcharges. The record is accepted, with an error.

What to do: Recalculate the total tax in your software and correct the record.

Codes (official text):

Flagged as first record when it is not

What it means: The record says it is the first in the chain, but the Agency already has invoices from that issuer with that software. The record is accepted, with an error.

What to do: The chain continues from the last record sent: tell the software provider.

Codes (official text):

The record is chained to itself

What it means: The previous record's hash is the same as the record's own. The record is accepted, with an error.

What to do: Check the chain with the AIM PAPYR tool and tell the software provider.

Codes (official text):

The regime key is missing with IPSI

What it means: With the IPSI tax (Ceuta and Melilla) the regime key must be given. The record is accepted, with an error.

What to do: Add the regime key in the software and correct the record.

Codes (official text):

Source: Spanish Tax Agency, Verifactu «Lista de códigos de error» (file of 30 July 2026, consulted on 21 November 2026) and «Documento de validaciones y errores», version 1.2.2. sede.agenciatributaria.gob.es