Check a Portuguese invoice QR code
Beta This tool is in beta. It is tested on sample files, and details may still change. Review the result before relying on it.
Read the QR code on a Portuguese invoice and check its fields, its ATCUD and its totals against the AT specification, on your device. Free, no upload.
In short
Check a payment or receipt QR code from a photo, a screenshot, a PDF or its text, on your device. Each finding says what to correct, and the result says what the check cannot show. Free.
How to check a QR code
- Drop a photo, a screenshot or a PDF with the code, or paste the code's text.
- Klarbon reads the code on your device and checks it against the rules for its kind.
- Read each finding, and open the authority's own link where the code has one.
You can check the QR code on a Portuguese invoice or receipt by dropping a photo, a screenshot or the PDF, or pasting the code's text. Klarbon reads it on your device and checks it against the AT's specification: the NIFs and their check digits, the type and date, the ATCUD, the tax regions, and whether the VAT and the totals add up. Each finding says what to correct.
What does the check cover?
The code holds the document's data as fields separated by asterisks, each a letter, a colon and a value, in the order the AT sets out (AT specification, archived copy in Portuguese). Klarbon checks:
- the fields: none missing, repeated, empty or out of order, and no spaces around values;
- the issuer's and buyer's NIF, 9 digits with a correct check digit, and the buyer's country;
- the document type, status and date, and the document identifier;
- the ATCUD: the series validation code and the document number, and not 0;
- the VAT blocks for mainland Portugal, the Azores and Madeira, the tax total and the document total, added up again;
- the hash characters, the software certificate number and the code itself: level M and version 9 or larger.
What the check does not show
A code that passes is well formed and its totals add up. It does not show that the AT holds the document or that the issuer reported it. The code carries no link to ask the AT; if the invoice carries your NIF, look for it in your area of the AT's e-Fatura portal (in Portuguese).
Is my file uploaded?
No. Finding the code, reading it and checking it all happen in your browser. See what happens to your files.
What next?
- Open a CIUS-PT e-invoice from a Portuguese supplier.
- What is the ATCUD? and e-invoicing in Portugal.
Frequently asked questions
What is the QR code on a Portuguese invoice?
Invoices and receipts from certified billing software in Portugal carry a QR code with the document's main data: the issuer's and buyer's NIF, the document type and date, its ATCUD, the VAT by tax region and the totals, set out by the AT, the Portuguese tax authority.
What is the ATCUD?
The document's unique code: the validation code the AT gave the document series, a hyphen and the document's number. An ATCUD of 0 shows that the series has no validation code from the AT.
Does Klarbon tell me whether the AT has the document?
No. The QR code holds no link and only the AT knows which documents were reported to it. Klarbon checks that the code is well formed and that its totals add up. If the invoice carries your NIF, look for it in your area of the AT's e-Fatura portal.
Is the file uploaded?
No. The code is found, read and checked in your browser. Nothing is sent to Klarbon.
Sources
- AT, technical specifications of the QR code, version 1.1, archived copy (in Portuguese) web.archive.org
- AT, the QR code on invoices (in Portuguese) info.portaldasfinancas.gov.pt