Skip to content

What a simplified tax invoice must show: the fields on the receipt, in the XML and in the QR code

Customers see a receipt; ZATCA sees an XML file and a QR code. Both must carry the right data. This guide lists what belongs on the paper, what lives in the XML and what is inside the QR, so you can check your own invoices in five minutes.

By Wameed compliance teamZATCA and e-invoicing

6 min read

In short: a simplified tax invoice (issued to consumers) carriesthree layers. On theprinted receipt: the seller’s name, address andVAT number, thedate and time, aninvoice number, theitems with quantity and price, theVAT and thetotals, and theQR code. In theXML (UBL 2.1) sent to ZATCA: all of that in structured form plus the invoicetype, UUID, hash, previous invoice hash, line-level VAT and thecryptographic stamp. In theQR code: a Base64 TLV structure with the seller name, VAT number, timestamp, total, VAT amount and, in Phase 2, the invoice hash, the stamp and the public key. Your POS builds all of it; your job is tocheck it. The exact required fields are set by ZATCA’s specifications, which change, so confirm against the current version.

A receipt can look perfect and still be non-compliant if the QR is wrong. Check all three layers.

Layer 1: the printed receipt

For a consumer sale, a receipt should show at least:

FieldNotes
Seller nameThe legal name, in Arabic (and English if you wish)
Seller addressAs registered
Seller VAT registration numberFifteen digits
Date and time of issueThe invoice’s own timestamp
Invoice numberSequential; never reused
Description of goods or servicesItem names
Quantity and unit pricePer line
DiscountsShown correctly
VAT rate and amountPer line or per category
Total excluding VAT, VAT amount, total including VATClear
Invoice type label“Simplified Tax Invoice” / “فاتورة ضريبية مبسطة”
QR codeScannable

Also helpful: payment method, cashier, branch, return policy and a thank-you. Buyer details arenot required on a simplified invoice. If the customer is a business that wants a VAT-reclaimable invoice, it should be astandard invoice. Seesimplified vs standard invoice.

Layer 2: the XML

The XML is the legal invoice. It contains the same information in structured fields, plus technical elements:

  • Invoice type code (simplified, standard, credit note, debit note).
  • UUID: a unique identifier for the invoice.
  • Invoice counter value (ICV) andprevious invoice hash (PIH): these chain invoices.
  • Issue date and time.
  • Seller party and, if present,buyer party.
  • Document-level allowances/charges (discounts).
  • Tax totals andline items with quantity, unit code, price, line extension amount, tax category and rate.
  • Payment means.
  • Digital signature (XAdES-BES) with the certificate.
  • QR code as an embedded reference.

You do not read it by eye, but your POS should let youdownload it and confirm that ZATCA accepted it.

Layer 3: the QR code

The QR code is not a link. It is a Base64-encodedTLV (tag-length-value) structure. In Phase 2 it hasnine tags:

TagContent
1Seller name
2Seller VAT registration number
3Timestamp
4Invoice total (including VAT)
5VAT total
6Hash of the XML invoice
7ECDSA signature
8Public key
9Signature of the certificate stamp (for simplified invoices)

Anyone can scan the QR with a verification app and compare the values to the printed total. A QR that does not match the receipt is a red flag.

SeeZATCA QR code explained.

A five-minute self-check

  1. Print a sample receipt from each terminal.
  2. Check the header: legal name, address, VAT number correct.
  3. Check the date/time and invoice number.
  4. Check the lines: names, quantities, prices, VAT.
  5. Check the totals: the arithmetic, including rounding.
  6. Scan the QR with a phone or a ZATCA-approved reader; compare seller, VAT number, total and VAT with the receipt.
  7. Download the XML and check it was accepted by ZATCA in your back office.
  8. Repeat for a discounted sale, a mixed-VAT basket and a refund (credit note).

Common field problems

ProblemCauseFix
Wrong VAT numberTypo in settingsCorrect master data; reissue as needed
Arabic name garbledFont or code pageUse image-based printing; test
QR does not scanToo small, low contrastLarger, darker; check printer width
Totals off by a halalaRounding ruleRound at line level consistently
Missing timeDevice clock not setFix time zone and sync
Duplicate numberTwo devices sharing a sequenceOne sequence per device or per rules
Wrong VAT categoryProduct master dataCorrect the item tax category
Discount shown incorrectlyDiscount on gross vs netVerify with your POS vendor

Receipts, e-invoices and digital copies

The e-invoice is the XML. The printed receipt and the PDF are renderings. You can also send the invoice to the customer by WhatsApp or e-mail with consent. Seedigital receipts on WhatsApp.

Credit notes

A refund creates acredit note carrying a reference to the original invoice, its own number, and its own QR. Never edit the original. SeeZATCA credit and debit notes.

Languages

Seller names and items should appear inArabic; English can accompany. Make sure fonts support the full character set and the Riyal symbol where used.

Mistakes to avoid

  • Printing a receipt that looks fine but has a wrong QR.
  • Using a trade name instead of the registered name.
  • Editing the template without testing.
  • Not testing on each printer model.
  • Ignoring rounding.

Frequently asked questions

Does a simplified invoice need the buyer’s name?

No; buyer details are required on standard invoices.

What is inside the QR code?

Seller name, VAT number, timestamp, total, VAT amount and, in Phase 2, the hash, signature, public key and stamp.

Can I design my own receipt layout?

Yes, as long as the required data and the QR are present and correct.

How do I know ZATCA accepted an invoice?

Your system should show the invoice’s status: accepted, accepted with warnings or rejected.

  • #حقول الفاتورة المبسطة
  • #محتوى الفاتورة الضريبية
  • #رمز QR الفاتورة
  • #بيانات الفاتورة الإلكترونية
  • #simplified tax invoice fields
  • #ZATCA invoice content
  • #QR code TLV tags

Share this article

Ask about your own shop

Thirty minutes on your products, your tax setup and your hardware — not a slide deck.

Keep reading

ZATCA and e-invoicing

7 min read

ZATCA Phase 2: the complete guide for Saudi merchants

What Phase 2 actually requires of your till, in plain language: the XML, the cryptographic stamp, the hash chain, clearance versus reporting, and the eight things to check before your wave arrives.