VAT Basis: Invoice and Cash
The VAT basis decides when the VAT return counts tax. It doesn’t change how much VAT you charge, how invoices are issued, or what is sent to ZATCA.
| Basis | Arabic | VAT counts |
|---|---|---|
| Invoice basis (default) | أساس الاستحقاق | In the period of the invoice or bill, paid or not. |
| Cash basis | الأساس النقدي | In the period it’s paid, and only for the part that was paid. |
Cash basis follows Article 46 of ZATCA’s VAT Implementing Regulations. It needs ZATCA’s approval before you use it, and it’s only for businesses with taxable sales of SAR 5,000,000 or less.
An example
Section titled “An example”An invoice for 11,500 SAR (1,500 SAR of it VAT) is issued in Q1. The customer pays half in Q2 and the rest in Q3.
| Quarter | What happened | Invoice basis | Cash basis |
|---|---|---|---|
| Q1 | Invoice issued | 1,500 | 0 |
| Q2 | 5,750 paid | 0 | 750 |
| Q3 | 5,750 paid | 0 | 750 |
| Total | 1,500 | 1,500 |
The total VAT is the same. Only the timing changes, so a business on cash basis doesn’t pay ZATCA VAT on money it hasn’t collected yet.
What stays the same
Section titled “What stays the same”- Invoices and ZATCA. Tax invoices are issued under the normal rules, and the e-invoicing connection sends the same invoices either way. ZATCA has no field for the basis in the invoice and no endpoint for payments. You report it through your VAT return.
- The ledger. VAT still posts to Tax Payable and Input VAT on the invoice or bill date. The VAT return reads those postings differently. Nothing is reposted when you change basis.
- Payment method. Being paid in cash doesn’t make a business “cash basis”. The payment method belongs to each invoice; the basis belongs to the company.
Set the basis
Section titled “Set the basis”Open Accounting settings → Taxes. The VAT basis section belongs to the company selected in the header.
The VAT basis is a Saudi VAT setting, so it only appears for companies in Saudi Arabia: the company’s country, or its base currency (SAR) when no country is set. It doesn’t depend on the ZATCA e-invoicing connection. A business that isn’t connected yet, or reports through another route, still files VAT returns and can use cash basis. The ZATCA app page shows the current basis with a link back to this setting.
- In use today shows the current basis and, on cash basis, the earliest date you can return to invoice basis voluntarily.
- VAT filing frequency is Monthly or Quarterly (default). It sets the tax periods a change must start on. Quarterly periods start on 1 January, 1 April, 1 July and 1 October.
- Cash basis limit compares sales on your income accounts for last year and this year with SAR 5,000,000. It’s a guide, not ZATCA’s exact measure. It only appears for companies kept in SAR, and only to people who can see accounting reports (
accounting.reports_view,accounting.vieworaccounting.manage). - History lists every change. Only the most recent change can be removed, and only while its start date isn’t in locked books.
Click Switch to cash basis or Return to invoice basis, then fill in:
- Reason: chosen at VAT registration, ZATCA approved an application, voluntary return after 2 years, or no longer qualifies.
- ZATCA approval date (or Registration date).
- Starts on, filled in with the earliest date allowed. You can choose a later period start.
- ZATCA reference and Note, both optional.
The dialog checks ZATCA’s rules as you type and explains any problem before you save:
| Rule | Article |
|---|---|
| A change starts on the first day of the tax period after approval. | 46(5), 46(10) |
| Cash basis chosen at registration applies from the registration date. | 46(4) |
| A voluntary return to invoice basis needs at least 2 years on cash basis. | 46(9) |
| A business that no longer qualifies returns without waiting, and must tell ZATCA within 20 days. | 46(8) |
| A change can’t start inside locked books. |
Changes need the accounting.manage permission and are recorded in the audit log.
The VAT return on cash basis
Section titled “The VAT return on cash basis”When cash basis applies to any part of the report’s dates, the VAT return adds a Cash basis summary:
- Net VAT on this return, Net VAT in the ledger, and the Difference, which is VAT on documents that aren’t paid yet or were paid in another period.
- Each account shows Documents, In the ledger, and On the return. Click the amount on the return, or Paid documents, to see each document with its total, the amount paid in the period, the share paid, and the VAT counted.
- If the dates cross a basis change, the report says which days use which basis and works out each part on its own basis.
What counts as paid
Section titled “What counts as paid”| Event | VAT on the return |
|---|---|
| Customer payment or supplier payment, in full or in part | Counted on the payment date, in proportion. |
| Payment entry, including an advance applied to an invoice later | Counted when it’s applied to the invoice. |
| Deduction on a payment entry (bad debt, discount, bank charge) | Not counted: only the part the money covered counts. A 575 receipt plus a 575 bad-debt deduction on a 1,150 invoice counts half its VAT. |
| Manual journal that settles a document | Counted only as far as it moves a bank or cash account. |
| Credit note or vendor credit offset against an invoice or bill | Nothing on its own: the reduction and the credit cancel out. Only the money actually paid or refunded counts. |
| Refund, or a payment that’s deleted later | Counted as a negative amount on that date. Earlier periods don’t change. |
| Invoice voided or edited later | Earlier returns keep the VAT they counted. Any payment undone with it counts as a negative amount on the day it’s undone. |
| Write-off | Never counted, because nothing was paid. |
| Expense paid on the spot, manual VAT journal | Counted on its date. |
| Invoice in a foreign currency | Counted at the invoice’s own exchange rate. |
| Invoice from before the accounting start date | Counted when paid, using the VAT on the invoice. |
Switching basis
Section titled “Switching basis”Article 46(6) and 46(11) require an adjustment in the first return after a change. Workstation adds it automatically as a Switch-over adjustment section, with View documents listing every document behind it.
- Invoice → cash. VAT on anything still unpaid on the change date is taken out, because it was already declared. It’s counted again when paid.
- Cash → invoice. VAT on anything still unpaid on the change date is added, because payments no longer move VAT.
For example, an 1,150 SAR invoice (150 VAT) is declared in Q1 on invoice basis and half is paid in Q1. Cash basis starts on 1 April. The Q2 return takes out 75 for the unpaid half and adds 75 when it’s paid in Q2, so the VAT is declared exactly once.
Warnings
Section titled “Warnings”- Advances not applied. ZATCA counts VAT on an advance payment when it’s received. An advance that isn’t linked to an invoice has no VAT amount in Workstation, so the return can’t count it. Issue an invoice for the advance, or apply it to an invoice in the same period.
- Over the limit. Sales passed SAR 5,000,000. Tell ZATCA within 20 days and return to invoice basis.
From the CLI or an AI assistant
Section titled “From the CLI or an AI assistant”The VAT basis, the filing frequency and the documents behind a cash-basis return are also in the public API and the Repzo CLI, and in the MCP server for Claude and ChatGPT. They follow the same rules and permissions as the settings screen:
repzo accounting vat-basis getrepzo accounting vat-basis set-filing-frequency --data '{"vatFilingFrequency":"monthly"}' --dry-runrepzo accounting vat-basis change --data '{"basis":"cash","reason":"approved_application","approvalDate":"2026-11-10","effectiveFrom":"2027-01-01"}' --dry-runrepzo accounting vat-basis remove-change CHANGE_ID --yesrepzo accounting reports vat-return documents --query from=2026-10-01 --query to=2026-12-31A change that breaks one of ZATCA’s rules is refused with the same message the dialog shows.