# VAT Basis: Invoice and Cash

> Choose whether the VAT return counts tax on the invoice date (أساس الاستحقاق) or when it's paid (الأساس النقدي), following ZATCA's cash accounting rules.

The VAT basis decides **when** the [VAT return](https://workstation.repzo.com/docs/commerce/accounting/reports#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

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

- **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

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.view` or `accounting.manage`).
- **History** lists every change. Only the most recent change can be removed, and only while its start date isn't in [locked books](https://workstation.repzo.com/docs/commerce/accounting/closing#period-lock).

Click **Switch to cash basis** or **Return to invoice basis**, then fill in:

1. **Reason**: chosen at VAT registration, ZATCA approved an application, voluntary return after 2 years, or no longer qualifies.
2. **ZATCA approval date** (or **Registration date**).
3. **Starts on**, filled in with the earliest date allowed. You can choose a later period start.
4. **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

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

| 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

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

- **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

The VAT basis, the filing frequency and the documents behind a cash-basis return are also in the [public API and the Repzo CLI](https://workstation.repzo.com/docs/configuration/developer-api/), and in the [MCP server](https://workstation.repzo.com/docs/developers/mcp/) for Claude and ChatGPT. They follow the same rules and permissions as the settings screen:

```bash
repzo accounting vat-basis get
repzo accounting vat-basis set-filing-frequency --data '{"vatFilingFrequency":"monthly"}' --dry-run
repzo accounting vat-basis change --data '{"basis":"cash","reason":"approved_application","approvalDate":"2026-11-10","effectiveFrom":"2027-01-01"}' --dry-run
repzo accounting vat-basis remove-change CHANGE_ID --yes
repzo accounting reports vat-return documents --query from=2026-10-01 --query to=2026-12-31
```

A change that breaks one of ZATCA's rules is refused with the same message the dialog shows.

## Related pages

- [Reports](https://workstation.repzo.com/docs/commerce/accounting/reports)
- [Payments](https://workstation.repzo.com/docs/commerce/accounting/payments)
- [Closing the books](https://workstation.repzo.com/docs/commerce/accounting/closing)
- [Setting up Accounting](https://workstation.repzo.com/docs/commerce/accounting/setup)
