| 1 | --- |
| 2 | name: saudi-arabia-vat |
| 3 | description: Use this skill whenever asked to prepare, review, or classify transactions for a Saudi Arabia VAT return for any client. Trigger on phrases like "prepare VAT return", "Saudi VAT", "ZATCA return", "KSA VAT", "fill in VAT return", "Fatoorah", "e-invoicing Saudi", or any request involving Saudi Arabia VAT filing. Also trigger when classifying transactions for VAT purposes from bank statements, invoices, or other source data. This skill covers KSA only and only standard VAT-registered persons. VAT groups, profit margin schemes, partial exemption with significant exempt supplies, oil & gas sector special rules, and designated zone goods movement classifications are all in the refusal catalogue. MUST be loaded alongside vat-workflow-base v0.1 or later (for workflow architecture). ALWAYS read this skill before touching any KSA VAT work. |
| 4 | version: 2.0 |
| 5 | --- |
| 6 | |
| 7 | # Saudi Arabia VAT Return Skill v2.0 |
| 8 | |
| 9 | ## Section 1 — Quick reference |
| 10 | |
| 11 | **Read this whole section before classifying anything. The workflow runbook is in `vat-workflow-base` Section 1 — follow that runbook with this skill providing the country-specific content.** |
| 12 | |
| 13 | | Field | Value | |
| 14 | |---|---| |
| 15 | | Country | Kingdom of Saudi Arabia (KSA) | |
| 16 | | Standard rate | 15% (from 1 July 2020; previously 5% from 1 January 2018) | |
| 17 | | Zero rate | 0% (exports outside GCC, international transport, qualifying medicines, investment metals 99%+ purity, first residential property up to SAR 1,000,000 cap) | |
| 18 | | Exempt supplies | Financial services (interest/margin-based, Islamic finance equivalents), residential rental, life insurance | |
| 19 | | Return form | VAT return filed electronically via ZATCA portal | |
| 20 | | Filing portal | https://zatca.gov.sa (ZATCA portal) | |
| 21 | | Authority | Zakat, Tax and Customs Authority (ZATCA, formerly GAZT) | |
| 22 | | Currency | SAR only | |
| 23 | | Filing frequency | Monthly (annual taxable supplies > SAR 40,000,000); Quarterly (SAR 40,000,000 or less) | |
| 24 | | Deadline | Last day of the month following end of tax period | |
| 25 | | TIN format | 15-digit number starting with 3 and ending with 3 | |
| 26 | | E-invoicing | Phase 1 (generation) mandatory since 4 Dec 2021; Phase 2 (integration) rolling waves from 1 Jan 2023 | |
| 27 | | Companion skill (Tier 1, workflow) | **vat-workflow-base v0.1 or later — MUST be loaded** | |
| 28 | | Contributor | Open Accounting Skills Community | |
| 29 | | Validated by | Deep research verification, April 2026 | |
| 30 | | Validation date | April 2026 | |
| 31 | |
| 32 | **Key VAT return fields (the fields you will use most):** |
| 33 | |
| 34 | | Field | Meaning | |
| 35 | |---|---| |
| 36 | | 1 | Standard-rated sales (15%) — VAT-exclusive amount | |
| 37 | | 2 | VAT on standard-rated sales (Field 1 x 15%) | |
| 38 | | 3 | Sales to GCC implementing states — VAT-exclusive amount | |
| 39 | | 4 | VAT on GCC sales | |
| 40 | | 5 | Zero-rated domestic sales — VAT-exclusive amount | |
| 41 | | 6 | Exports — VAT-exclusive amount | |
| 42 | | 7 | Exempt sales — VAT-exclusive amount | |
| 43 | | 8 | Standard-rated purchases (15%) — VAT-exclusive amount | |
| 44 | | 9 | VAT on standard-rated purchases (Field 8 x 15%) | |
| 45 | | 10 | Imports subject to VAT paid at Customs — VAT-exclusive amount | |
| 46 | | 11 | VAT paid at Customs | |
| 47 | | 12 | Imports via reverse charge — VAT-exclusive amount | |
| 48 | | 13 | VAT on reverse charge imports (Field 12 x 15%) | |
| 49 | | 14 | Zero-rated purchases — VAT-exclusive amount | |
| 50 | | 15 | Exempt purchases — VAT-exclusive amount | |
| 51 | | 16 | Adjustments to output VAT (credit notes, corrections) | |
| 52 | | 17 | Adjustments to input VAT (credit notes received, corrections) | |
| 53 | | 18 | Total output VAT (derived: Field 2 + Field 4 + Field 13 + Field 16) | |
| 54 | | 19 | Total input VAT (derived: Field 9 + Field 11 + Field 17) | |
| 55 | | 20 | Net VAT due (derived: Field 18 − Field 19) | |
| 56 | |
| 57 | **E-invoicing phases summary:** |
| 58 | |
| 59 | | Phase | Requirement | Status | |
| 60 | |---|---|---| |
| 61 | | Phase 1 (Generation) | All VAT-registered taxpayers must generate, store, and share e-invoices. XML or PDF/A-3 with embedded XML. QR code mandatory on simplified (B2C) invoices. Handwritten invoices prohibited. | Mandatory since 4 December 2021 | |
| 62 | | Phase 2 (Integration) | E-invoices reported to and validated by ZATCA platform (FATOORA) in near-real-time. ZATCA applies cryptographic stamp and UUID. QR code mandatory on ALL invoices. | Rolling waves from 1 January 2023. As of April 2026: Wave 24 (revenue > SAR 375K, deadline 30 Jun 2026). | |
| 63 | |
| 64 | **Conservative defaults — KSA-specific values for the universal categories in `vat-workflow-base` Section 2:** |
| 65 | |
| 66 | | Ambiguity | Default | |
| 67 | |---|---| |
| 68 | | Unknown rate on a sale | 15% (standard rate) | |
| 69 | | Unknown VAT status of a purchase | Not recoverable | |
| 70 | | Unknown counterparty location | Domestic KSA | |
| 71 | | Unknown business-use proportion (vehicle, phone) | 0% recovery | |
| 72 | | Unknown SaaS billing entity | Reverse charge (non-resident supplier) | |
| 73 | | Unknown blocked-input status (entertainment, motor vehicle, personal benefit) | Blocked | |
| 74 | | Unknown whether transaction is in scope | In scope | |
| 75 | | Unknown GCC implementing state treatment | Treat as domestic 15% (transitional rules) | |
| 76 | |
| 77 | **Red flag thresholds — country slot values for the reviewer brief in `vat-workflow-base` Section 3:** |
| 78 | |
| 79 | | Threshold | Value | |
| 80 | |---|---| |
| 81 | | HIGH single-transaction size | SAR 20,000 | |
| 82 | | HIGH tax-delta on a single conservative default | SAR 2,000 | |
| 83 | | MEDIUM counterparty concentration | >40% of output OR input | |
| 84 | | MEDIUM conservative-default count | >4 across the return | |
| 85 | | LOW absolute net VAT position | SAR 50,000 | |
| 86 | |
| 87 | --- |
| 88 | |
| 89 | ## Section 2 — Required inputs and refusal catalogue |
| 90 | |
| 91 | ### Required inputs |
| 92 | |
| 93 | **Minimum viable** — bank statement for the period in CSV, PDF, or pasted text. Must cover the full filing period. Acceptable from any Saudi business bank: Al Rajhi Bank, Saudi National Bank (SNB/NCB), Riyad Bank, Saudi British Bank (SABB), Banque Saudi Fransi (BSF), Arab National Bank (ANB), Alinma Bank, Bank AlJazira, Bank Albilad, or any other. |
| 94 | |
| 95 | **Recommended** — sales invoices for the period (especially for zero-rated exports and international services), purchase invoices for any input tax claim above SAR 2,000, the client's TIN (15-digit, starting and ending with 3) in writing, Commercial Registration (CR) number. |
| 96 | |
| 97 | **Ideal** — complete e-invoice register (from FATOORA system), VAT registration certificate, prior period VAT return, reconciliation of any excess input tax. |
| 98 | |
| 99 | **Refusal policy if minimum is missing — SOFT WARN.** If no bank statement is available at all, hard stop. If bank statement only without invoices, proceed but record in the reviewer brief: "This VAT return was produced from bank statement alone. The reviewer must verify, before approval, that input tax claims above SAR 2,000 are supported by compliant e-invoices and that all reverse charge and zero-rating classifications match the supplier's/customer's documentation." |
| 100 | |
| 101 | ### KSA-specific refusal catalogue |
| 102 | |
| 103 | If any trigger fires, stop, output the refusal message verbatim, end the conversation. |
| 104 | |
| 105 | **R-SA-1 — Partial exemption with significant exempt supplies.** *Trigger:* client makes both taxable and exempt supplies and the exempt proportion is not trivial (more than incidental bank charges/interest). *Message:* "You make both taxable and exempt supplies. Your input tax must be apportioned under Article 50 of the VAT Law and IR Article 50. This skill cannot compute the apportionment ratio. Please engage a qualified tax consultant to determine and confirm the recovery rate before input tax is claimed." |
| 106 | |
| 107 | **R-SA-2 — VAT group registration.** *Trigger:* client is part of a VAT group. *Message:* "VAT group registrations require consolidation across all group members. This skill covers single-entity VAT returns only. Please engage a qualified tax consultant." |
| 108 | |
| 109 | **R-SA-3 — Oil and gas sector special rules.** *Trigger:* client operates in the oil and gas sector with specific VAT treatments for crude oil, refined products, or hydrocarbons. *Message:* "Oil and gas sector transactions have specific VAT rules including zero-rating conditions and reverse charge requirements that are highly fact-sensitive. Out of scope for this skill." |
| 110 | |
| 111 | **R-SA-4 — Designated zone goods movement.** *Trigger:* client operates in a qualifying economic zone / designated zone and the transaction involves goods movement between zones or between a zone and the mainland. *Message:* "Designated zone goods movements have specific treatment under IR Article 39. Not all free zones are designated zones. This skill applies standard rules only. Please engage a qualified tax consultant to confirm zone treatment." |
| 112 | |
| 113 | **R-SA-5 — Capital assets scheme adjustment.** *Trigger:* the period contains an adjustment to previously deducted input tax on a capital asset where input VAT exceeded SAR 250,000 (5-year adjustment for movable, 10-year for immovable). *Message:* "Capital assets scheme adjustments under IR Article 51 require tracking the original deduction, current and intended use, and computing the annual fraction. Out of scope for this skill." |
| 114 | |
| 115 | **R-SA-6 — First supply of residential property (housing relief).** *Trigger:* client is selling residential property and claiming zero-rating under the SAR 1,000,000 housing relief cap. *Message:* "First supply of residential property with the SAR 1,000,000 housing VAT/RETT relief cap requires determining first-supply status, buyer eligibility (Saudi citizen, first home), and computing the relief. This is Tier 2 — flag for reviewer confirmation. If the transaction is straightforward, proceed with zero-rating in Field 5 up to SAR 1,000,000 and 15% on any excess, but the reviewer must verify eligibility." |
| 116 | |
| 117 | **R-SA-7 — Deemed supplier for electronic marketplaces.** *Trigger:* client operates a digital platform facilitating sales by non-resident or unregistered suppliers (deemed supplier rules effective 1 January 2026 under amended IR Article 47 Para 3). *Message:* "Deemed supplier obligations for electronic marketplace operators require specific assessment. Out of scope." |
| 118 | |
| 119 | --- |
| 120 | |
| 121 | ## Section 3 — Supplier pattern library (the lookup table) |
| 122 | |
| 123 | This is the deterministic pre-classifier. When a transaction's counterparty matches a pattern in this table, apply the treatment from the table directly. Do not second-guess. If none match, fall through to Tier 1 rules in Section 5. |
| 124 | |
| 125 | **How to read this table.** Match by case-insensitive substring on the counterparty name as it appears in the bank statement. If multiple patterns match, use the most specific. |
| 126 | |
| 127 | ### 3.1 Saudi banks (fees exempt — exclude) |
| 128 | |
| 129 | | Pattern | Treatment | Notes | |
| 130 | |---|---|---| |
| 131 | | AL RAJHI, ALRAJHI, مصرف الراجحي | EXCLUDE for bank charges/fees | Financial service, exempt | |
| 132 | | SNB, SAUDI NATIONAL BANK, NCB, البنك الأهلي | EXCLUDE for bank charges/fees | Same | |
| 133 | | RIYAD BANK, بنك الرياض | EXCLUDE for bank charges/fees | Same | |
| 134 | | SABB, SAUDI BRITISH BANK | EXCLUDE for bank charges/fees | Same | |
| 135 | | BSF, BANQUE SAUDI FRANSI | EXCLUDE for bank charges/fees | Same | |
| 136 | | ANB, ARAB NATIONAL BANK | EXCLUDE for bank charges/fees | Same | |
| 137 | | ALINMA, مصرف الإنماء | EXCLUDE for bank charges/fees | Same | |
| 138 | | BANK ALJAZIRA, بنك الجزيرة | EXCLUDE for bank charges/fees | Same | |
| 139 | | BANK ALBILAD, بنك البلاد | EXCLUDE for bank charges/fees | Same | |
| 140 | | REVOLUT, WISE (fee lines) | EXCLUDE for transaction fees | Check for separate taxable subscription invoices | |
| 141 | | INTEREST, PROFIT, MURABAHA (margin) | EXCLUDE | Exempt financial service income/expense | |
| 142 | | LOAN, TAMWEEL, FINANCING (principal) | EXCLUDE | Loan/financing principal, out of scope | |
| 143 | |
| 144 | ### 3.2 Saudi government, regulators, and statutory bodies (exclude entirely) |
| 145 | |
| 146 | | Pattern | Treatment | Notes | |
| 147 | |---|---|---| |
| 148 | | ZATCA, GAZT, هيئة الزكاة والضريبة والجمارك | EXCLUDE | Tax/zakat payment, not a supply | |
| 149 | | VAT PAYMENT, ضريبة القيمة المضافة | EXCLUDE | VAT payment | |
| 150 | | ZAKAT PAYMENT, زكاة | EXCLUDE | Zakat payment | |
| 151 | | CUSTOMS, جمارك | EXCLUDE for duty | Customs duty (but check for import VAT in Field 10/11) | |
| 152 | | GOSI, GENERAL ORGANIZATION FOR SOCIAL INSURANCE, التأمينات الاجتماعية | EXCLUDE | Social insurance, out of scope | |
| 153 | | MOC, MINISTRY OF COMMERCE, وزارة التجارة | EXCLUDE | Government fees, sovereign act | |
| 154 | | MOL, MINISTRY OF LABOR, HRSD | EXCLUDE | Government fees | |
| 155 | | MUNICIPALITY, BALADIYA, أمانة | EXCLUDE | Government fees | |
| 156 | | CITC, COMMUNICATIONS AND IT COMMISSION | EXCLUDE | Government licence fees | |
| 157 | | CMA, CAPITAL MARKET AUTHORITY | EXCLUDE | Regulatory fees | |
| 158 | | SADAD | EXCLUDE (payment channel) | Sadad is a bill payment system, not a supplier | |
| 159 | | ABSHER, MUQEEM, QIWA, MUDAD | EXCLUDE | Government digital platforms | |
| 160 | |
| 161 | ### 3.3 Saudi utilities |
| 162 | |
| 163 | | Pattern | Treatment | Field | Notes | |
| 164 | |---|---|---|---| |
| 165 | | SEC, SAUDI ELECTRICITY COMPANY, الشركة السعودية للكهرباء | Domestic 15% | 8/9 | Electricity — overhead, input tax claimable | |
| 166 | | SWCC, SALINE WATER CONVERSION, المؤسسة العامة لتحلية المياه المالحة | Domestic 15% | 8/9 | Desalinated water | |
| 167 | | NATIONAL WATER COMPANY, NWC, شركة المياه الوطنية | Domestic 15% | 8/9 | Water services | |
| 168 | | MARAFIQ | Domestic 15% | 8/9 | Utilities (Jubail/Yanbu) | |
| 169 | |
| 170 | ### 3.4 Saudi telecoms |
| 171 | |
| 172 | | Pattern | Treatment | Field | Notes | |
| 173 | |---|---|---|---| |
| 174 | | STC, SAUDI TELECOM, الاتصالات السعودية | Domestic 15% | 8/9 | Telecoms — overhead | |
| 175 | | MOBILY, ETIHAD ETISALAT, اتحاد اتصالات | Domestic 15% | 8/9 | Same | |
| 176 | | ZAIN, زين | Domestic 15% | 8/9 | Same | |
| 177 | | VIRGIN MOBILE KSA | Domestic 15% | 8/9 | MVNO | |
| 178 | |
| 179 | ### 3.5 Insurance (check type) |
| 180 | |
| 181 | | Pattern | Treatment | Notes | |
| 182 | |---|---|---| |
| 183 | | TAWUNIYA, التعاونية | Check invoice | Life insurance/family takaful: exempt. General/motor/health: domestic 15% | |
| 184 | | BUPA ARABIA | Domestic 15% | Health insurance, standard rated | |
| 185 | | MEDGULF | Check invoice | Life: exempt. General: domestic 15% | |
| 186 | | MALATH, WALAA, AL RAJHI TAKAFUL | Check invoice | Life/family: exempt. General: domestic 15% | |
| 187 | | MOTOR INSURANCE, VEHICLE INSURANCE | Domestic 15% | General insurance standard rated (but input blocked if for blocked motor vehicle) | |
| 188 | | HEALTH INSURANCE, MEDICAL INSURANCE | Domestic 15% | Standard rated; input claimable unless employee personal benefit | |
| 189 | |
| 190 | ### 3.6 Transport |
| 191 | |
| 192 | | Pattern | Treatment | Field | Notes | |
| 193 | |---|---|---|---| |
| 194 | | UBER SA, CAREEM KSA | Domestic 15% | 8/9 | Ride-hailing, standard rated | |
| 195 | | SAUDIA, SAUDI ARABIAN AIRLINES, الخطوط السعودية (international) | Zero-rated / EXCLUDE | 6 | International passenger transport | |
| 196 | | SAUDIA (domestic flights) | Domestic 15% | 8/9 or 1/2 | Domestic flights standard rated | |
| 197 | | FLYNAS, طيران ناس (international) | Zero-rated / EXCLUDE | 6 | International flights | |
| 198 | | FLYNAS (domestic) | Domestic 15% | 8/9 | Domestic flights standard rated | |
| 199 | | SAR, SAUDI RAILWAY, سار | Domestic 15% | 8/9 | Rail transport, standard rated | |
| 200 | | DHL KSA, ARAMEX KSA | Domestic 15% | 8/9 | Courier/express, standard rated | |
| 201 | |
| 202 | ### 3.7 Food retail and supermarkets |
| 203 | |
| 204 | | Pattern | Treatment | Notes | |
| 205 | |---|---|---| |
| 206 | | PANDA, بنده | Default BLOCK input tax | Personal provisioning. Claimable only if F&B business purchasing stock-in-trade | |
| 207 | | CARREFOUR KSA, كارفور | Default BLOCK | Same | |
| 208 | | DANUBE, الدانوب | Default BLOCK | Same | |
| 209 | | TAMIMI MARKETS, التميمي | Default BLOCK | Same | |
| 210 | | OTHAIM, العثيم | Default BLOCK | Same | |
| 211 | | BIN DAWOOD, بن داود | Default BLOCK | Same | |
| 212 | | RESTAURANTS, CAFES (any named restaurant) | Default BLOCK | Entertainment blocked under IR Art. 49(4) | |
| 213 | |
| 214 | ### 3.8 SaaS — non-resident suppliers (reverse charge) |
| 215 | |
| 216 | When the client receives services from a non-resident supplier not registered for KSA VAT: self-assess output VAT at 15% in Field 12/13 (reverse charge), claim input VAT (if entitled) in Field 9 or aggregated into Field 19. Net effect zero for fully taxable business. |
| 217 | |
| 218 | | Pattern | Billing entity | Field | Notes | |
| 219 | |---|---|---|---| |
| 220 | | GOOGLE (Ads, Workspace, Cloud) | Google Ireland Ltd (IE) or Google LLC (US) | 12/13 | Non-resident, reverse charge | |
| 221 | | MICROSOFT (365, Azure) | Microsoft Ireland Operations Ltd (IE) | 12/13 | Non-resident, reverse charge | |
| 222 | | ADOBE | Adobe Systems Software Ireland Ltd (IE) | 12/13 | Non-resident, reverse charge | |
| 223 | | META, FACEBOOK ADS | Meta Platforms Ireland Ltd (IE) | 12/13 | Non-resident, reverse charge | |
| 224 | | LINKEDIN (paid) | LinkedIn Ireland Unlimited (IE) | 12/13 | Non-resident, reverse charge | |
| 225 | | AWS, AMAZON WEB SERVICES | AWS Inc (US) or AWS EMEA SARL (LU) | 12/13 | Non-resident, reverse charge | |
| 226 | | NOTION | Notion Labs Inc (US) | 12/13 | Non-resident, reverse charge | |
| 227 | | ANTHROPIC, CLAUDE | Anthropic PBC (US) | 12/13 | Non-resident, reverse charge | |
| 228 | | OPENAI, CHATGPT | OpenAI Inc (US) | 12/13 | Non-resident, reverse charge | |
| 229 | | GITHUB | GitHub Inc (US) | 12/13 | Non-resident, reverse charge | |
| 230 | | FIGMA | Figma Inc (US) | 12/13 | Non-resident, reverse charge | |
| 231 | | CANVA | Canva Pty Ltd (AU) | 12/13 | Non-resident, reverse charge | |
| 232 | | SLACK | Slack Technologies LLC (US) | 12/13 | Non-resident, reverse charge | |
| 233 | | ATLASSIAN (Jira, Confluence) | Atlassian Pty Ltd (AU) | 12/13 | Non-resident, reverse charge | |
| 234 | | ZOOM | Zoom Video Communications Inc (US) | 12/13 | Non-resident, reverse charge | |
| 235 | | HUBSPOT | HubSpot Inc (US) | 12/13 | Non-resident, reverse charge | |
| 236 | | STRIPE (subscription) | Stripe Inc (US) | 12/13 | Non-resident, reverse charge | |
| 237 | | SHOPIFY | Shopify Inc (CA) | 12/13 | Non-resident, reverse charge | |
| 238 | | TWILIO | Twilio Inc (US) | 12/13 | Non-resident, reverse charge | |
| 239 | |
| 240 | ### 3.9 Payment processors |
| 241 | |
| 242 | | Pattern | Treatment | Notes | |
| 243 | |---|---|---| |
| 244 | | STRIPE (transaction fees) | EXCLUDE (exempt) | Payment processing fees, exempt financial service | |
| 245 | | PAYPAL (transaction fees) | EXCLUDE (exempt) | Same | |
| 246 | | MADA, MADA PAYMENT | EXCLUDE | Debit card payment network fees — exempt financial service | |
| 247 | | HYPERPAY, MOYASAR, PAYFORT | Check invoice | If KSA entity: domestic 15%. If not: reverse charge | |
| 248 | |
| 249 | ### 3.10 Retail and office supplies (Saudi) |
| 250 | |
| 251 | | Pattern | Treatment | Field | Notes | |
| 252 | |---|---|---|---| |
| 253 | | JARIR, مكتبة جرير | Domestic 15% | 8/9 | Office supplies, electronics — input claimable if business purpose | |
| 254 | | EXTRA, اكسترا | Domestic 15% | 8/9 | Electronics retail | |
| 255 | | IKEA KSA | Domestic 15% | 8/9 | Furniture/office | |
| 256 | | SACO, ساكو | Domestic 15% | 8/9 | Hardware/office supplies | |
| 257 | |
| 258 | ### 3.11 Professional services (Saudi) |
| 259 | |
| 260 | | Pattern | Treatment | Field | Notes | |
| 261 | |---|---|---|---| |
| 262 | | LAW FIRM names, محاماة, LEGAL | Domestic 15% | 8/9 | Legal fees, input claimable if business purpose | |
| 263 | | ACCOUNTANT, AUDIT FIRM, محاسبة | Domestic 15% | 8/9 | Accounting/audit, always claimable | |
| 264 | | DELOITTE KSA, PwC KSA, KPMG KSA, EY KSA | Domestic 15% | 8/9 | Big 4 KSA entities, domestic | |
| 265 | | PRO SERVICES, TASHEEL, MUQEEM SERVICES | Domestic 15% | 8/9 | Government liaison services | |
| 266 | |
| 267 | ### 3.12 Payroll and statutory contributions (exclude entirely) |
| 268 | |
| 269 | | Pattern | Treatment | Notes | |
| 270 | |---|---|---| |
| 271 | | GOSI, SOCIAL INSURANCE | EXCLUDE | Social insurance contributions, out of scope | |
| 272 | | SALARY, WAGES, PAYROLL, WPS, رواتب | EXCLUDE | Employment, out of scope | |
| 273 | | IQAMA RENEWAL, VISA FEES | EXCLUDE | Government fees | |
| 274 | | END OF SERVICE, مكافأة نهاية الخدمة | EXCLUDE | Employment termination benefit | |
| 275 | |
| 276 | ### 3.13 Property and rent |
| 277 | |
| 278 | | Pattern | Treatment | Notes | |
| 279 | |---|---|---| |
| 280 | | COMMERCIAL RENT, OFFICE RENT (with VAT invoice) | Domestic 15%, Field 8/9 | Commercial lease, input claimable | |
| 281 | | RESIDENTIAL RENT, APARTMENT RENT, إيجار سكني | EXCLUDE | Residential lease, exempt | |
| 282 | | EJAR, إيجار (residential) | EXCLUDE | Residential tenancy platform | |
| 283 | | WAREHOUSE, INDUSTRIAL RENT | Domestic 15%, Field 8/9 | Commercial/industrial lease | |
| 284 | | WAFI (residential off-plan sales platform) | See R-SA-6 | May involve first-supply housing relief | |
| 285 | |
| 286 | ### 3.14 Internal transfers and exclusions |
| 287 | |
| 288 | | Pattern | Treatment | Notes | |
| 289 | |---|---|---| |
| 290 | | OWN TRANSFER, INTERNAL, BETWEEN ACCOUNTS | EXCLUDE | Internal movement | |
| 291 | | DIVIDEND, توزيعات | EXCLUDE | Dividend, out of scope | |
| 292 | | LOAN REPAYMENT, FINANCING REPAYMENT | EXCLUDE | Principal, out of scope | |
| 293 | | CASH WITHDRAWAL, ATM, سحب نقدي | TIER 2 — ask | Default exclude; ask what cash was spent on | |
| 294 | | PARTNER DRAWING, OWNER DRAWING | EXCLUDE | Drawing, out of scope | |
| 295 | | ZAKAT PAYMENT | EXCLUDE | Zakat, separate obligation from VAT | |
| 296 | |
| 297 | --- |
| 298 | |
| 299 | ## Section 4 — Worked examples |
| 300 | |
| 301 | These are six fully worked classifications drawn from a hypothetical bank statement of a KSA-based self-employed IT consultant operating from Riyadh. |
| 302 | |
| 303 | ### Example 1 — Non-resident SaaS reverse charge (Notion) |
| 304 | |
| 305 | **Input line:** |
| 306 | `03.04.2026 ; NOTION LABS INC ; DEBIT ; Monthly subscription ; USD 16.00 ; SAR 60.00` |
| 307 | |
| 308 | **Reasoning:** |
| 309 | Notion Labs Inc is a US entity (Section 3.8). No VAT on the invoice. This is a service received from a non-resident supplier not registered for KSA VAT. The client must self-assess reverse charge under Article 47: output VAT at 15% in Field 12/13, claim input VAT in Field 19 (via Field 9). Net effect zero for a fully taxable client. Both sides must appear on the return. |
| 310 | |
| 311 | **Output:** |
| 312 | |
| 313 | | Date | Counterparty | Gross | Net | VAT | Rate | Field (output) | Field (input) | Default? | Question? | Excluded? | |
| 314 | |---|---|---|---|---|---|---|---|---|---|---| |
| 315 | | 03.04.2026 | NOTION LABS INC | -60.00 | -60.00 | 9.00 | 15% | 12/13 | 9 (via 19) | N | — | — | |
| 316 | |
| 317 | ### Example 2 — Zero-rated export of services |
| 318 | |
| 319 | **Input line:** |
| 320 | `10.04.2026 ; TECHCORP INC DELAWARE ; CREDIT ; Invoice SA-2026-018 IT consultancy March ; +25,000.00 ; SAR` |
| 321 | |
| 322 | **Reasoning:** |
| 323 | Incoming SAR 25,000 from a US company. The client provides IT consulting services to a non-resident with no KSA establishment. Under Article 33(2) and IR Article 33, this is a zero-rated export of services. Report in Field 6. No output VAT. Confirm: the customer has no establishment in KSA, the service is not related to goods or real estate in KSA. |
| 324 | |
| 325 | **Output:** |
| 326 | |
| 327 | | Date | Counterparty | Gross | Net | VAT | Rate | Field | Default? | Question? | Excluded? | |
| 328 | |---|---|---|---|---|---|---|---|---|---| |
| 329 | | 10.04.2026 | TECHCORP INC DELAWARE | +25,000.00 | +25,000.00 | 0 | 0% | 6 | Y | Q1 (HIGH) | "Verify customer has no KSA establishment" | |
| 330 | |
| 331 | ### Example 3 — Entertainment, blocked |
| 332 | |
| 333 | **Input line:** |
| 334 | `15.04.2026 ; THE GLOBE RESTAURANT RIYADH ; DEBIT ; Client dinner ; -1,800.00 ; SAR` |
| 335 | |
| 336 | **Reasoning:** |
| 337 | Restaurant transaction. Entertainment and hospitality expenses for non-business purposes are blocked under IR Article 49(4). Client entertainment is a hard block — the input VAT is irrecoverable. Default: full block. |
| 338 | |
| 339 | **Output:** |
| 340 | |
| 341 | | Date | Counterparty | Gross | Net | VAT | Rate | Field | Default? | Question? | Excluded? | |
| 342 | |---|---|---|---|---|---|---|---|---|---| |
| 343 | | 15.04.2026 | THE GLOBE RESTAURANT | -1,800.00 | -1,800.00 | 0 | — | — | Y | Q2 | "Entertainment: blocked under IR Art. 49(4)" | |
| 344 | |
| 345 | ### Example 4 — Domestic standard-rated purchase (office equipment) |
| 346 | |
| 347 | **Input line:** |
| 348 | `18.04.2026 ; JARIR BOOKSTORE ; DEBIT ; Invoice JR-2026-441 Laptop HP ; -5,750.00 ; SAR` |
| 349 | |
| 350 | **Reasoning:** |
| 351 | Jarir is a local retailer (Section 3.10). The gross amount is SAR 5,750 inclusive of 15% VAT. Net = 5,750 x (100/115) = SAR 5,000. VAT = SAR 750. Standard-rated domestic purchase used for business. Input tax claimable. Goes to Field 8 (purchases) and Field 9 (input tax). |
| 352 | |
| 353 | **Output:** |
| 354 | |
| 355 | | Date | Counterparty | Gross | Net | VAT | Rate | Field (purchase) | Field (input) | Default? | Question? | Excluded? | |
| 356 | |---|---|---|---|---|---|---|---|---|---|---| |
| 357 | | 18.04.2026 | JARIR BOOKSTORE | -5,750.00 | -5,000.00 | -750.00 | 15% | 8 | 9 | N | — | — | |
| 358 | |
| 359 | ### Example 5 — Motor vehicle expense, blocked |
| 360 | |
| 361 | **Input line:** |
| 362 | `22.04.2026 ; AL JAZIRAH VEHICLES ; DEBIT ; Monthly car lease ; -4,500.00 ; SAR` |
| 363 | |
| 364 | **Reasoning:** |
| 365 | Car lease payment. Input VAT on motor vehicles (purchase, lease, running costs) is blocked under IR Article 49(3) unless the vehicle is essential to the business (taxi, delivery, car rental, transportation business). An IT consultant does not qualify. Default: full block. |
| 366 | |
| 367 | **Output:** |
| 368 | |
| 369 | | Date | Counterparty | Gross | Net | VAT | Rate | Field | Default? | Question? | Excluded? | |
| 370 | |---|---|---|---|---|---|---|---|---|---| |
| 371 | | 22.04.2026 | AL JAZIRAH VEHICLES | -4,500.00 | -4,500.00 | 0 | — | — | Y | Q3 | "Motor vehicle: blocked under IR Art. 49(3)" | |
| 372 | |
| 373 | ### Example 6 — Exempt financial service (bank charges) |
| 374 | |
| 375 | **Input line:** |
| 376 | `28.04.2026 ; AL RAJHI BANK ; DEBIT ; Monthly account maintenance ; -50.00 ; SAR` |
| 377 | |
| 378 | **Reasoning:** |
| 379 | Bank maintenance fee. Financial services based on interest or implicit margin are exempt under Article 29. No VAT is charged. No input tax to claim. Exclude from the return. |
| 380 | |
| 381 | **Output:** |
| 382 | |
| 383 | | Date | Counterparty | Gross | Net | VAT | Rate | Field | Default? | Question? | Excluded? | |
| 384 | |---|---|---|---|---|---|---|---|---|---| |
| 385 | | 28.04.2026 | AL RAJHI BANK | -50.00 | — | — | — | — | N | — | "Exempt financial service" | |
| 386 | |
| 387 | --- |
| 388 | |
| 389 | ## Section 5 — Tier 1 classification rules (compressed) |
| 390 | |
| 391 | Each rule states the legal source and the field mapping. Apply silently if the data is unambiguous. |
| 392 | |
| 393 | ### 5.1 Standard rate 15% (VAT Law Art. 2; Royal Decree A/638) |
| 394 | |
| 395 | Default rate for any taxable supply in KSA unless zero-rated or exempt. Sales go to Field 1/2. Purchases go to Field 8/9. The rate has been 15% since 1 July 2020. Do not apply the former 5% rate to supplies after that date (subject to transitional rules for pre-existing contracts entered before 11 May 2020). |
| 396 | |
| 397 | ### 5.2 Zero-rated supplies (Art. 33-37) |
| 398 | |
| 399 | Exports of goods outside GCC implementing states with proof of export (customs declaration, bill of lading). Report in Field 6. Exports of services to non-resident outside KSA (no KSA establishment, service not related to goods/real estate in KSA). Report in Field 6. International transport of goods and passengers. Report in Field 6. Zero-rated domestic sales (qualifying medicines per SFDA list, investment metals 99%+ purity, supplies to diplomats). Report in Field 5. First supply of residential property within 3 years up to SAR 1,000,000 cap. Report in Field 5. No output VAT. Full input tax recovery on related costs. |
| 400 | |
| 401 | ### 5.3 Exempt supplies (Art. 29-30) |
| 402 | |
| 403 | Financial services based on interest or implicit margin (lending, deposits, Islamic finance equivalents like murabaha profit margin). Residential rental. Life insurance premiums. Report in Field 7. No output VAT. No input tax recovery on directly attributable costs. |
| 404 | |
| 405 | ### 5.4 Out of scope |
| 406 | |
| 407 | Salaries, wages, GOSI contributions, zakat, government fines/fees, dividends, loan principal, TOGC, government sovereign activities. Not reported on VAT return. Exclude entirely. |
| 408 | |
| 409 | ### 5.5 Reverse charge — services from non-resident (Art. 47) |
| 410 | |
| 411 | When the client receives services or intangibles from a non-resident not registered for KSA VAT: self-assess output VAT at 15% in Field 12/13, claim input VAT in Field 19 (if entitled). Net effect zero for a fully taxable client. Both sides must appear. |
| 412 | |
| 413 | ### 5.6 Import of goods via Customs (Art. 47-49) |
| 414 | |
| 415 | Goods imported and cleared at Customs. VAT paid at border. Report in Field 10 (value) and Field 11 (VAT). Input tax claimable in Field 19. Customs declaration is the supporting document. |
| 416 | |
| 417 | ### 5.7 Domestic purchases — standard rated |
| 418 | |
| 419 | Input tax on a valid e-invoice from a KSA VAT-registered supplier is recoverable for purchases used in taxable business activity. Subject to blocked-input rules (5.9). Map to Field 8 (value) and Field 9 (input tax). |
| 420 | |
| 421 | ### 5.8 GCC implementing state supplies (Field 3/4) |
| 422 | |
| 423 | Sales to customers in GCC implementing states (UAE, Bahrain, Oman) during transitional period: Field 3/4 at 15%. The GCC electronic service system for customs union is not yet fully operational — treat as domestic supply during transitional period. |
| 424 | |
| 425 | ### 5.9 Blocked input tax (IR Art. 49) |
| 426 | |
| 427 | The following categories have zero VAT recovery: |
| 428 | - Motor vehicles: purchase, lease, running costs — IR Art. 49(3). Exception: vehicle is essential to the business (taxi, delivery fleet, car rental, transportation business). |
| 429 | - Entertainment, hospitality, recreation for non-business purposes — IR Art. 49(4). Exception: staff meals at workplace may be claimable. |
| 430 | - Employee personal benefits: housing, childcare (unless legally required) — IR Art. 49(5). |
| 431 | - Costs related to exempt supplies — Art. 46(1). |
| 432 | |
| 433 | Blocked categories override any other recovery rule. Check blocked status before applying recovery. |
| 434 | |
| 435 | ### 5.10 E-invoicing compliance |
| 436 | |
| 437 | All invoices must be electronic since 4 December 2021 (Phase 1). Phase 2 integration with FATOORA platform is rolling out in waves based on revenue thresholds. QR code is mandatory on all invoices in Phase 2 (and on simplified B2C invoices since Phase 1). A non-compliant invoice is still a valid invoice for VAT purposes but triggers penalties. |
| 438 | |
| 439 | ### 5.11 Credit notes and adjustments |
| 440 | |
| 441 | Credit notes issued reduce output tax. Credit notes received reduce input tax. Enter in Field 16 (output adjustments) and Field 17 (input adjustments). For errors in prior returns: if VAT difference exceeds SAR 5,000, mandatory voluntary disclosure via ZATCA portal. If SAR 5,000 or less, correct in next return. |
| 442 | |
| 443 | ### 5.12 Penalty amnesty |
| 444 | |
| 445 | ZATCA penalty cancellation initiative extended to 30 June 2026. Covers late registration, late filing, late payment, and correction penalties. Requires: taxpayer registered, all returns submitted, full principal tax paid. |
| 446 | |
| 447 | ### 5.13 Sales — domestic standard |
| 448 | |
| 449 | Charge 15% on all local sales. Map to Field 1 (net) and Field 2 (output VAT). |
| 450 | |
| 451 | ### 5.14 Calculating VAT from gross amounts |
| 452 | |
| 453 | ``` |
| 454 | Net = Gross / 1.15 |
| 455 | VAT = Gross - Net (or equivalently, Gross x 15/115) |
| 456 | ``` |
| 457 | |
| 458 | --- |
| 459 | |
| 460 | ## Section 6 — Tier 2 catalogue (compressed) |
| 461 | |
| 462 | ### 6.1 Motor vehicle vs commercial vehicle |
| 463 | |
| 464 | *Pattern:* petrol station, parking, car rental, vehicle maintenance. *Why insufficient:* vehicle type unknown. Motor car expenses are blocked; vehicles essential to business (delivery fleet, taxi) may be claimable. *Default:* 0% recovery. *Question:* "Is this for a passenger car (blocked) or a vehicle essential to the business (delivery, transport)?" |
| 465 | |
| 466 | ### 6.2 Entertainment vs staff welfare |
| 467 | |
| 468 | *Pattern:* restaurant, cafe, catering, event. *Why insufficient:* client entertainment is blocked; staff meals at workplace may be claimable. *Default:* block. *Question:* "Was this client entertainment (blocked) or a staff meal at the workplace?" |
| 469 | |
| 470 | ### 6.3 Ambiguous SaaS billing entities |
| 471 | |
| 472 | *Pattern:* Google, Microsoft, AWS where the billing entity may be a KSA-registered entity or non-resident. *Default:* reverse charge (non-resident). *Question:* "Could you check the invoice for the legal entity name and TIN? If the supplier has a KSA TIN, this is domestic 15%; if not, reverse charge applies." |
| 473 | |
| 474 | ### 6.4 Round-number incoming transfers from owner-named counterparties |
| 475 | |
| 476 | *Pattern:* large round credit from a name matching the client's name. *Default:* exclude as owner injection. *Question:* "The SAR X transfer from [name] — is this a customer payment, your own money, or a loan?" |
| 477 | |
| 478 | ### 6.5 Incoming transfers from foreign counterparties |
| 479 | |
| 480 | *Pattern:* foreign bank, foreign currency, international SWIFT. *Default:* domestic 15%. *Question:* "Was this a service to an overseas customer (potentially zero-rated)? Does the customer have a KSA establishment?" |
| 481 | |
| 482 | ### 6.6 Insurance type determination |
| 483 | |
| 484 | *Pattern:* insurance premium payment to Tawuniya, MedGulf, etc. *Default:* exclude (exempt — life insurance default). *Question:* "Is this life/family takaful (exempt) or general/motor/health insurance (standard rated, input claimable)?" |
| 485 | |
| 486 | ### 6.7 Residential vs commercial property |
| 487 | |
| 488 | *Pattern:* rent payment, Ejar platform. *Default:* residential (exempt). *Question:* "Is this a commercial property (VAT claimable with e-invoice) or residential (exempt)?" |
| 489 | |
| 490 | ### 6.8 Mixed-use phone, internet |
| 491 | |
| 492 | *Pattern:* STC, Mobily, Zain personal lines. *Default:* 0% if mixed. *Question:* "Is this a dedicated business line or mixed-use? What business percentage?" |
| 493 | |
| 494 | ### 6.9 Cash withdrawals |
| 495 | |
| 496 | *Pattern:* ATM, cash withdrawal. *Default:* exclude as owner drawing. *Question:* "What was the cash used for?" |
| 497 | |
| 498 | ### 6.10 Outgoing transfers to individuals |
| 499 | |
| 500 | *Pattern:* outgoing to private-looking names. *Default:* exclude as salary/drawings. *Question:* "Was this a contractor payment (with e-invoice), salary, or personal transfer?" |
| 501 | |
| 502 | ### 6.11 GOSI deductions |
| 503 | |
| 504 | *Pattern:* GOSI debit. *Default:* exclude (statutory, out of scope). No question needed. |
| 505 | |
| 506 | ### 6.12 Zakat vs VAT |
| 507 | |
| 508 | *Pattern:* ZATCA payment that could be zakat or VAT. *Default:* exclude both — neither is a supply. *Question:* "Was this a VAT payment, a zakat payment, or both?" |
| 509 | |
| 510 | --- |
| 511 | |
| 512 | ## Section 7 — Excel working paper template (KSA-specific) |
| 513 | |
| 514 | The base specification is in `vat-workflow-base` Section 3. This section provides the KSA-specific overlay. |
| 515 | |
| 516 | ### Sheet "Transactions" |
| 517 | |
| 518 | Columns A–L per the base. Column H ("Field code") accepts: 1, 5, 6, 7, 8, 10, 12, 14, 15, RC. Use blank for excluded transactions. For reverse-charge transactions, enter "RC" in column H. |
| 519 | |
| 520 | ### Sheet "Field Summary" |
| 521 | |
| 522 | One row per field. Column A is the field number, column B is the description, column C is the value computed via formula. |
| 523 | |
| 524 | ``` |
| 525 | Output: |
| 526 | | 1 | Standard-rated sales | =SUMIFS(Transactions!E:E, Transactions!H:H, "1") | |
| 527 | | 2 | VAT on standard-rated sales | =C[1_row]*0.15 | |
| 528 | | 5 | Zero-rated domestic sales | =SUMIFS(Transactions!E:E, Transactions!H:H, "5") | |
| 529 | | 6 | Exports | =SUMIFS(Transactions!E:E, Transactions!H:H, "6") | |
| 530 | | 7 | Exempt sales | =SUMIFS(Transactions!E:E, Transactions!H:H, "7") | |
| 531 | | 12 | Reverse charge imports | =SUMIFS(Transactions!E:E, Transactions!H:H, "RC") | |
| 532 | | 13 | VAT on reverse charge | =C[12_row]*0.15 | |
| 533 | |
| 534 | Input: |
| 535 | | 8 | Standard-rated purchases | =SUMIFS(Transactions!E:E, Transactions!H:H, "8") | |
| 536 | | 9 | VAT on standard-rated purchases | =C[8_row]*0.15 | |
| 537 | | 10 | Imports at Customs | =SUMIFS(Transactions!E:E, Transactions!H:H, "10") | |
| 538 | | 11 | VAT paid at Customs | =C[10_row]*0.15 | |
| 539 | | 14 | Zero-rated purchases | =SUMIFS(Transactions!E:E, Transactions!H:H, "14") | |
| 540 | | 15 | Exempt purchases | =SUMIFS(Transactions!E:E, Transactions!H:H, "15") | |
| 541 | |
| 542 | Totals: |
| 543 | | 18 | Total output VAT | =C[2_row]+C[13_row] | |
| 544 | | 19 | Total input VAT | =C[9_row]+C[11_row] | |
| 545 | | 20 | Net VAT due | =C[18_row]-C[19_row] | |
| 546 | ``` |
| 547 | |
| 548 | ### Sheet "Return Form" |
| 549 | |
| 550 | ``` |
| 551 | Field 20 = Field 18 - Field 19 |
| 552 | |
| 553 | IF Field 20 > 0: |
| 554 | VAT payable to ZATCA |
| 555 | ELSE: |
| 556 | Excess input tax (refundable or carry forward) |
| 557 | ``` |
| 558 | |
| 559 | ### Color and formatting conventions |
| 560 | |
| 561 | Per the xlsx skill: blue for hardcoded values, black for formulas, green for cross-sheet references, yellow background for rows where Default? = "Y". |
| 562 | |
| 563 | ### Mandatory recalc step |
| 564 | |
| 565 | After building the workbook, run: |
| 566 | |
| 567 | ```bash |
| 568 | python /mnt/skills/public/xlsx/scripts/recalc.py /mnt/user-data/outputs/saudi-vat-<period>-working-paper.xlsx |
| 569 | ``` |
| 570 | |
| 571 | --- |
| 572 | |
| 573 | ## Section 8 — Saudi bank statement reading guide |
| 574 | |
| 575 | Follow the universal exclusion rules in `vat-workflow-base` Step 6, plus these KSA-specific patterns. |
| 576 | |
| 577 | **Al Rajhi Bank statement format.** Al Rajhi online banking exports use CSV or Excel with DD/MM/YYYY (Gregorian) dates. Some statements also show Hijri dates. Common columns: Transaction Date, Description, Debit, Credit, Balance. The description field contains the counterparty name, sometimes in Arabic. SADAD bill payments show the biller name (e.g., "SADAD-STC", "SADAD-SEC"). SWIFT transfers show the beneficiary name separately. |
| 578 | |
| 579 | **Saudi National Bank (SNB/NCB) statement format.** SNB exports use CSV with columns: Date, Description, Reference, Debit, Credit, Balance. Card purchases show the merchant name. Mada debit card payments show "MADA POS" followed by the merchant name. SWIFT transfers show the beneficiary bank and name. |
| 580 | |
| 581 | **Riyad Bank statement format.** Riyad Bank online exports: Date, Narrative, Reference, Debit, Credit, Balance. The narrative field is the primary source for counterparty identification. |
| 582 | |
| 583 | **Revolut / Wise Business.** ISO date format. Clear counterparty names. Separate fee lines — exclude fee lines (exempt financial service). |
| 584 | |
| 585 | **Internal transfers and exclusions.** Own-account transfers between the client's banks. Labelled "transfer between accounts", "internal", "حوالة داخلية". Always exclude. |
| 586 | |
| 587 | **WPS (Wage Protection System) entries.** Salary payments via WPS appear as "WPS", "SALARY TRANSFER", "رواتب", or individual employee names. Always exclude — employment, out of scope. |
| 588 | |
| 589 | **SADAD entries.** SADAD is the national bill payment system. SADAD debits show the biller name (e.g., "SADAD-STC" = STC telecom bill, "SADAD-SEC" = electricity bill). Map to the appropriate category using Section 3 based on the biller name after the "SADAD-" prefix. |
| 590 | |
| 591 | **Mada entries.** Mada is the national debit card network. Entries show "MADA" or "MADA POS" followed by the merchant name and city. The merchant name is the key for counterparty identification. |
| 592 | |
| 593 | **Arabic language descriptions.** Some bank statement descriptions appear in Arabic. Common terms: مشتريات (purchases), مبيعات (sales), رواتب (salaries), إيجار (rent), كهرباء (electricity), مياه (water), اتصالات (telecom). Treat as the English equivalent. |
| 594 | |
| 595 | **Foreign currency transactions.** Convert to SAR at the Saudi Central Bank (SAMA) exchange rate on the transaction date. Note the rate in column L (Notes). SAR is pegged to USD at approximately 3.75. |
| 596 | |
| 597 | **GOSI entries.** GOSI (General Organization for Social Insurance) debits are statutory employer/employee contributions. Always out of scope. Exclude immediately. |
| 598 | |
| 599 | **Zakat and tax entries.** ZATCA debits may be VAT payments, zakat payments, or both. Both are government payments, not supplies. Exclude. Do not confuse a VAT payment with a VAT-inclusive purchase. |
| 600 | |
| 601 | --- |
| 602 | |
| 603 | ## Section 9 — Onboarding fallback (only when inference fails) |
| 604 | |
| 605 | ### 9.1 Entity type and trading name |
| 606 | *Inference rule:* "مؤسسة" (mu'assasa) = sole establishment; "شركة ذات مسؤولية محدودة" or "LLC" = limited liability company. *Fallback question:* "Are you a sole establishment, LLC, or other entity type?" |
| 607 | |
| 608 | ### 9.2 TIN and CR number |
| 609 | *Inference rule:* TIN may appear on e-invoices. CR number may appear on bank statement header. *Fallback question:* "What is your VAT TIN (15-digit, starts and ends with 3)? What is your CR number?" |
| 610 | |
| 611 | ### 9.3 Filing period and frequency |
| 612 | *Inference rule:* first and last transaction dates. Monthly if revenue > SAR 40M, otherwise quarterly. *Fallback question:* "Which period does this cover? Monthly (which month) or quarterly (Q1/Q2/Q3/Q4)?" |
| 613 | |
| 614 | ### 9.4 Industry and sector |
| 615 | *Inference rule:* counterparty mix, sales patterns. *Fallback question:* "In one sentence, what does the business do?" |
| 616 | |
| 617 | ### 9.5 Employees |
| 618 | *Inference rule:* WPS, GOSI, salary transfers. *Fallback question:* "Do you have employees?" |
| 619 | |
| 620 | ### 9.6 Exempt supplies |
| 621 | *Inference rule:* residential rental income, financial service income. *Fallback question:* "Do you make any VAT-exempt sales (residential rental, financial services, life insurance)?" *If yes and significant, R-SA-1 may fire.* |
| 622 | |
| 623 | ### 9.7 International customers |
| 624 | *Inference rule:* foreign bank credits, SWIFT inflows. *Fallback question:* "Do you have customers outside KSA? Are they businesses? Do any have a KSA establishment?" |
| 625 | |
| 626 | ### 9.8 E-invoicing phase |
| 627 | *Inference rule:* ZATCA wave notifications based on revenue. *Fallback question:* "Are you in Phase 2 of e-invoicing (integrated with FATOORA)? If not, which wave are you assigned to?" |
| 628 | |
| 629 | ### 9.9 Carried-forward excess input tax |
| 630 | *Inference rule:* not inferable from a single period. Always ask. *Question:* "Do you have any excess input tax carried forward from the previous period?" |
| 631 | |
| 632 | --- |
| 633 | |
| 634 | ## Section 10 — Reference material |
| 635 | |
| 636 | ### Validation status |
| 637 | |
| 638 | This skill is v2.0, rewritten in April 2026 to align with the Malta v2.0 structure. It supersedes v1.0/v1.1. |
| 639 | |
| 640 | ### Sources |
| 641 | |
| 642 | **Primary legislation:** |
| 643 | 1. VAT Law (Royal Decree No. A/113, dated 2/11/1438H) — Articles 2, 9, 29-37, 46-51, 59-60, 62, 64 |
| 644 | 2. VAT Implementing Regulations (Board of Directors Resolution No. 3839) — Articles 7-10, 29-37, 39, 46-51, 53-54, 59, 62-63 |
| 645 | 3. E-Invoicing Regulation (issued 4/12/1442H) |
| 646 | 4. Royal Decree A/638 (rate increase to 15%) |
| 647 | 5. Royal Decree A/84 (housing VAT/RETT relief) |
| 648 | 6. Unified VAT Agreement for the GCC States |
| 649 | 7. Board Resolution No. 01-06-24 (April 2025 IR amendments) |
| 650 | |
| 651 | **ZATCA guidance:** |
| 652 | 8. ZATCA VAT return completion guide |
| 653 | 9. ZATCA e-invoicing implementation guides (Phase 1, Phase 2) |
| 654 | 10. ZATCA penalty waiver initiative guidance |
| 655 | |
| 656 | **Other:** |
| 657 | 11. ZATCA portal — https://zatca.gov.sa |
| 658 | 12. FATOORA e-invoicing platform |
| 659 | 13. SAMA exchange rates |
| 660 | |
| 661 | ### Known gaps |
| 662 | |
| 663 | 1. The supplier pattern library covers the most common Saudi and international counterparties but does not cover every local business. |
| 664 | 2. The worked examples are drawn from a hypothetical IT consultant in Riyadh. They do not cover construction, oil & gas, real estate, or F&B specifically. |
| 665 | 3. GCC inter-state supply rules (transitional provisions) are simplified — the GCC electronic service system is not yet fully operational. |
| 666 | 4. The housing relief (first residential property, SAR 1,000,000 cap) is referred to R-SA-6 for reviewer confirmation rather than fully deterministic. |
| 667 | 5. Real Estate Transaction Tax (RETT) at 5% for exempt real estate is referenced but not computed. |
| 668 | 6. The deemed supplier rules for electronic marketplaces (effective 1 January 2026) are refused (R-SA-7) rather than handled. |
| 669 | 7. Arabic-language patterns in the supplier library are limited to major brands — more Arabic variants should be added. |
| 670 | |
| 671 | ### Change log |
| 672 | |
| 673 | - **v2.0 (April 2026):** Full rewrite to align with Malta v2.0 structure. Quick reference with field table, e-invoicing phases summary, and conservative defaults at top (Section 1). Supplier pattern library with Saudi vendors (Al Rajhi, SNB, Riyad Bank, STC, Mobily, SEC, SWCC, Panda/Carrefour, Jarir, SAUDIA, ZATCA) in Section 3. Six worked examples (Section 4). Compressed Tier 1 rules (Section 5). Tier 2 catalogue (Section 6). Excel working paper (Section 7). Saudi bank statement guide with Al Rajhi/SNB formats, SADAD/Mada patterns, Arabic descriptions (Section 8). Onboarding fallback (Section 9). References (Section 10). |
| 674 | - **v1.1 (April 2026):** Updated with April 2025 IR amendments, penalty amnesty extension, e-invoicing wave 24. |
| 675 | - **v1.0 (April 2026):** Initial standalone skill covering VAT Law, field mappings, reverse charge, blocked categories, e-invoicing, registration, penalties. |
| 676 | |
| 677 | ### Self-check (v2.0 of this document) |
| 678 | |
| 679 | 1. Quick reference at top with field table and conservative defaults: yes (Section 1). |
| 680 | 2. E-invoicing phases summary in quick reference: yes (Section 1). |
| 681 | 3. Supplier library as literal lookup tables: yes (Section 3, 14 sub-tables). |
| 682 | 4. Worked examples: yes (Section 4, 6 examples). |
| 683 | 5. Tier 1 rules compressed: yes (Section 5, 14 rules). |
| 684 | 6. Tier 2 catalogue compressed: yes (Section 6, 12 items). |
| 685 | 7. Excel template specification with mandatory recalc: yes (Section 7). |
| 686 | 8. Onboarding as fallback only: yes (Section 9, 9 items). |
| 687 | 9. All 7 KSA-specific refusals present: yes (Section 2, R-SA-1 through R-SA-7). |
| 688 | 10. Reference material at bottom: yes (Section 10). |
| 689 | 11. Entertainment block explicit: yes (Section 5.9 + Example 3). |
| 690 | 12. Motor vehicle block explicit: yes (Section 5.9 + Example 5). |
| 691 | 13. Reverse charge for non-resident services explicit: yes (Example 1 + Section 5.5). |
| 692 | 14. Zero-rated export and "no KSA establishment" test explicit: yes (Example 2 + Section 5.2). |
| 693 | 15. Al Rajhi/SNB bank statement format guide with SADAD/Mada patterns: yes (Section 8). |
| 694 | 16. Arabic language descriptions covered: yes (Section 8). |
| 695 | 17. Penalty amnesty referenced: yes (Section 5.12). |
| 696 | |
| 697 | ## End of Saudi Arabia VAT Return Skill v2.0 |
| 698 | |
| 699 | This skill is incomplete without the companion file loaded alongside it: `vat-workflow-base` v0.1 or later (Tier 1, workflow architecture). Do not attempt to produce a VAT return without both files loaded. |
| 700 | |
| 701 | |
| 702 | --- |
| 703 | |
| 704 | ## Disclaimer |
| 705 | |
| 706 | This skill and its outputs are provided for informational and computational purposes only and do not constitute tax, legal, or financial advice. Open Accountants and its contributors accept no liability for any errors, omissions, or outcomes arising from the use of this skill. All outputs must be reviewed and signed off by a qualified professional (such as a licensed tax consultant, CPA, or equivalent practitioner in your jurisdiction) before filing or acting upon. |
| 707 | |
| 708 | The most up-to-date, verified version of this skill is maintained at [openaccountants.com](https://openaccountants.com). Log in to access the latest version, request a professional review from a licensed accountant, and track updates as tax law changes. |
| 709 |
Run this skill, then get an accountant to check it
After running the full skill pack in Claude, sign up and upload your worksheet. We'll connect you with a trusted accountant in our network who can review your numbers before you file.
Depends on
Quality
Q2: Research-verified
Deep research against tax authority sources. Not yet tested on real data.
Needs real client data + practitioner sign-off to reach Q1.
Accountant Review
About
Use this skill whenever asked to prepare, review, or classify transactions for a Saudi Arabia VAT return for any client. Trigger on phrases like "prepare VAT return", "Saudi VAT", "ZATCA return", "KSA VAT", "fill in VAT return", "Fatoorah", "e-invoicing Saudi", or any request involving Saudi Arabia VAT filing. Also trigger when classifying transactions for VAT purposes from bank statements, invoices, or other source data. This skill covers KSA only and only standard VAT-registered persons. VAT groups, profit margin schemes, partial exemption with significant exempt supplies, oil & gas sector special rules, and designated zone goods movement classifications are all in the refusal catalogue. MUST be loaded alongside vat-workflow-base v0.1 or later (for workflow architecture). ALWAYS read this skill before touching any KSA VAT work.