| 1 | --- |
| 2 | name: spain-vat-return |
| 3 | description: Use this skill whenever asked to prepare, review, or classify transactions for a Spanish VAT return (Modelo 303 / IVA autoliquidacion) for a self-employed individual or small business in peninsular Spain or the Balearic Islands. Trigger on phrases like "prepare VAT return", "do the Spanish VAT", "fill in Modelo 303", "IVA", "Modelo 390", or any request involving Spanish VAT filing. Also trigger when classifying transactions for VAT purposes from bank statements, invoices, or other source data. This skill covers peninsular Spain and Balearic Islands only under the regimen general. Canary Islands (IGIC), Ceuta/Melilla (IPSI), regimen simplificado, recargo de equivalencia, RECC cash-basis, VAT groups, and partial exemption (prorrata) are in the refusal catalogue. MUST be loaded alongside BOTH vat-workflow-base v0.1 or later (for workflow architecture) AND eu-vat-directive v0.1 or later (for EU directive content). ALWAYS read this skill before touching any Spain VAT work. |
| 4 | version: 2.0 |
| 5 | --- |
| 6 | |
| 7 | # Spain VAT Return Skill (Modelo 303 / IVA) 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 and `eu-vat-directive` providing the EU directive content.** |
| 12 | |
| 13 | | Field | Value | |
| 14 | |---|---| |
| 15 | | Country | Spain (Peninsula + Balearic Islands) | |
| 16 | | Standard rate | 21% (tipo general) | |
| 17 | | Reduced rates | 10% (tipo reducido), 4% (tipo superreducido) | |
| 18 | | Zero rate | 0% (exports, intra-EU B2B supplies of goods/services) | |
| 19 | | Return form | Modelo 303 (periodic self-assessment); Modelo 390 (annual summary) | |
| 20 | | Filing portal | Sede Electronica AEAT (sede.agenciatributaria.gob.es) | |
| 21 | | Authority | Agencia Estatal de Administracion Tributaria (AEAT) | |
| 22 | | Currency | EUR only | |
| 23 | | Filing frequencies | Quarterly (standard); Monthly (mandatory for SII-obliged / REDEME registrants / turnover > EUR 6,010,121.04) | |
| 24 | | Deadline | Quarterly: 1st–20th of month after quarter end (April, July, October, January — January deadline is 30th); Monthly: 1st–20th of following month | |
| 25 | | SII obligation | Suministro Inmediato de Informacion (RD 596/2016): real-time invoice reporting within 4 calendar days; mandatory for monthly filers | |
| 26 | | Companion skill (Tier 1, workflow) | **vat-workflow-base v0.1 or later — MUST be loaded** | |
| 27 | | Companion skill (Tier 2, EU directive) | **eu-vat-directive v0.1 or later — MUST be loaded** | |
| 28 | | Contributor | Open Accounting Skills Community | |
| 29 | | Validation date | April 2026 | |
| 30 | |
| 31 | **Key Modelo 303 casillas (boxes):** |
| 32 | |
| 33 | | Casilla | Meaning | |
| 34 | |---|---| |
| 35 | | 01 | Output base — standard rate 21% | |
| 36 | | 02 | Output VAT — standard rate 21% | |
| 37 | | 03 | Output base — reduced rate 10% | |
| 38 | | 04 | Output VAT — reduced rate 10% | |
| 39 | | 05 | Output base — super-reduced rate 4% | |
| 40 | | 06 | Output VAT — super-reduced rate 4% | |
| 41 | | 07 | Output base — recargo de equivalencia (surcharge) | |
| 42 | | 08–14 | Output VAT recargo at various rates | |
| 43 | | 15 | Output base — intra-EU acquisitions of goods | |
| 44 | | 16 | Output VAT on intra-EU acquisitions of goods | |
| 45 | | 17 | Output base — intra-EU acquisitions of services | |
| 46 | | 18 | Output VAT on intra-EU acquisitions of services | |
| 47 | | 19 | Output base — other reverse charge (Art. 84.Uno.2 LIVA) | |
| 48 | | 20 | Output VAT on other reverse charge | |
| 49 | | 21 | Output base — modification of bases and cuotas | |
| 50 | | 22 | Output VAT modification | |
| 51 | | 23 | Output base — recargo modification | |
| 52 | | 24 | Output VAT recargo modification | |
| 53 | | 25 | Total output cuotas (derived) | |
| 54 | | 26 | Total output cuotas inc. recargo (derived) | |
| 55 | | 27 | Total output VAT (derived: sum of output VAT lines) | |
| 56 | | 28 | Input base — domestic purchases (cuotas soportadas en operaciones interiores corrientes) | |
| 57 | | 29 | Input VAT — domestic purchases | |
| 58 | | 30 | Input base — investment goods (bienes de inversion) | |
| 59 | | 31 | Input VAT — investment goods | |
| 60 | | 32 | Input base — intra-EU acquisitions (corrientes) | |
| 61 | | 33 | Input VAT — intra-EU acquisitions | |
| 62 | | 34 | Input base — intra-EU investment goods | |
| 63 | | 35 | Input VAT — intra-EU investment goods | |
| 64 | | 36 | Input base — imports (corrientes) | |
| 65 | | 37 | Input VAT — imports | |
| 66 | | 38 | Input base — imports investment goods | |
| 67 | | 39 | Input VAT — imports investment goods | |
| 68 | | 40 | Rectification of input deductions | |
| 69 | | 41 | Rectification amount | |
| 70 | | 45 | Total input VAT deductible (derived: 29+31+33+35+37+39+41) | |
| 71 | | 46 | Difference (derived: 27 − 45) | |
| 72 | | 59 | Exclusive state-level output base | |
| 73 | | 60 | Exclusive state-level cuotas | |
| 74 | | 61 | Exclusive state-level cuotas devengadas | |
| 75 | | 64 | Result of the periodic self-assessment | |
| 76 | | 65 | Attributable to state administration (for regional split) | |
| 77 | | 66 | Resultado (derived) | |
| 78 | | 67 | Cuotas a compensar de periodos anteriores (credit brought forward) | |
| 79 | | 69 | Resultado de la autoliquidacion (final result: casilla 46 − casilla 67 adjustments) | |
| 80 | | 71 | Result payable or refundable (final line) | |
| 81 | |
| 82 | **Conservative defaults — Spain-specific values for the universal categories in `vat-workflow-base` Section 2:** |
| 83 | |
| 84 | | Ambiguity | Default | |
| 85 | |---|---| |
| 86 | | Unknown rate on a sale | 21% | |
| 87 | | Unknown VAT status of a purchase | Not deductible | |
| 88 | | Unknown counterparty country | Domestic Spain | |
| 89 | | Unknown B2B vs B2C status for EU customer | B2C, charge 21% | |
| 90 | | Unknown business-use proportion (vehicle, phone, home office) | 0% recovery (except vehicles — see 50% presumption in Section 5.11) | |
| 91 | | Unknown SaaS billing entity | Reverse charge from non-EU (casilla 36/37) | |
| 92 | | Unknown blocked-input status (entertainment, personal use) | Blocked | |
| 93 | | Unknown whether transaction is in scope | In scope | |
| 94 | |
| 95 | **Red flag thresholds — country slot values for the reviewer brief in `vat-workflow-base` Section 3:** |
| 96 | |
| 97 | | Threshold | Value | |
| 98 | |---|---| |
| 99 | | HIGH single-transaction size | EUR 5,000 | |
| 100 | | HIGH tax-delta on a single conservative default | EUR 300 | |
| 101 | | MEDIUM counterparty concentration | >40% of output OR input | |
| 102 | | MEDIUM conservative-default count | >4 across the return | |
| 103 | | LOW absolute net VAT position | EUR 8,000 | |
| 104 | |
| 105 | --- |
| 106 | |
| 107 | ## Section 2 — Required inputs and refusal catalogue |
| 108 | |
| 109 | ### Required inputs |
| 110 | |
| 111 | **Minimum viable** — bank statement for the period in CSV, PDF, or pasted text. Must cover the full period. Acceptable from any Spanish or international business bank: CaixaBank, Santander, BBVA, Bankinter, Sabadell, ING Direct, Revolut Business, Wise Business, N26 Business, or any other. |
| 112 | |
| 113 | **Recommended** — sales invoices for the period (especially for intra-EU B2B services and zero-rated supplies), purchase invoices (facturas) for any input VAT claim above EUR 300, the client's NIF-IVA in writing (ES + letter/digits). |
| 114 | |
| 115 | **Ideal** — complete invoice register (libro registro de facturas emitidas y recibidas), Modelo 303 from prior period showing casilla 67 credit carried forward, SII submission confirmations. |
| 116 | |
| 117 | **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 Modelo 303 was produced from bank statement alone. The reviewer must verify, before approval, that input VAT claims above EUR 300 are supported by compliant facturas and that all reverse-charge classifications match the supplier's invoice." |
| 118 | |
| 119 | ### Spain-specific refusal catalogue |
| 120 | |
| 121 | These refusals apply on top of the EU-wide refusals in `eu-vat-directive` Section 13 (R-EU-1 through R-EU-12). If any trigger fires, stop, output the refusal message verbatim, end the conversation. |
| 122 | |
| 123 | **R-ES-1 — Canary Islands (IGIC).** *Trigger:* client is located in the Canary Islands or asks about IGIC. *Message:* "The Canary Islands use IGIC (Impuesto General Indirecto Canario), not IVA. This skill covers IVA only (peninsular Spain + Balearic Islands). Please use an Asesor Fiscal familiar with IGIC." |
| 124 | |
| 125 | **R-ES-2 — Ceuta or Melilla (IPSI).** *Trigger:* client is in Ceuta or Melilla or asks about IPSI. *Message:* "Ceuta and Melilla use IPSI (Impuesto sobre la Produccion, los Servicios y la Importacion), not IVA. Out of scope for this skill." |
| 126 | |
| 127 | **R-ES-3 — Regimen simplificado (simplified modules).** *Trigger:* client files under the regimen simplificado with module-based calculations. *Message:* "The regimen simplificado uses activity-specific modules (modulos) to compute VAT, not actual transaction classification. This skill covers the regimen general only. Please use an Asesor Fiscal for module-based returns." |
| 128 | |
| 129 | **R-ES-4 — Recargo de equivalencia.** *Trigger:* client is a retailer subject to recargo de equivalencia. *Message:* "Recargo de equivalencia is a special surcharge regime for retailers (personas fisicas) who sell goods without transformation. Suppliers charge the recargo surcharge (5.2%/1.4%/0.5%) and the retailer has no filing obligation or input VAT recovery. This skill covers the regimen general only." |
| 130 | |
| 131 | **R-ES-5 — RECC cash-basis regime.** *Trigger:* client uses the regimen especial de criterio de caja. *Message:* "The RECC regime defers VAT to the payment date rather than the invoice date. This changes the timing of both output and input VAT reporting. This skill assumes the standard accrual basis (devengo). Please use an Asesor Fiscal for RECC returns." |
| 132 | |
| 133 | **R-ES-6 — Prorrata de deduccion (partial exemption).** *Trigger:* client makes both taxable and exempt supplies (Art. 20 LIVA) and the exempt proportion is not de minimis. *Message:* "Your business makes both taxable and exempt supplies. Input VAT must be apportioned under the prorrata rules (Art. 102–106 LIVA). This requires the annual definitive prorrata ratio. Please use an Asesor Fiscal to determine the prorrata percentage before input VAT is claimed." |
| 134 | |
| 135 | **R-ES-7 — VAT groups (grupos de entidades).** *Trigger:* client is part of a VAT group under Art. 163 quinquies–nonies LIVA. *Message:* "VAT group consolidation is out of scope. Please use an Asesor Fiscal." |
| 136 | |
| 137 | **R-ES-8 — Used goods / travel agencies / art margin schemes.** *Trigger:* client deals in second-hand goods, travel agency packages, or art/antiques under margin scheme. *Message:* "Special margin scheme regimes (bienes usados, agencias de viaje, objetos de arte) require transaction-level margin computation. Out of scope." |
| 138 | |
| 139 | --- |
| 140 | |
| 141 | ## Section 3 — Supplier pattern library (the lookup table) |
| 142 | |
| 143 | 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. Do not consult Tier 1 rules — the table is authoritative for patterns it covers. |
| 144 | |
| 145 | **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. If none match, fall through to Tier 1 rules in Section 5. |
| 146 | |
| 147 | ### 3.1 Spanish banks (fees exempt — exclude) |
| 148 | |
| 149 | | Pattern | Treatment | Notes | |
| 150 | |---|---|---| |
| 151 | | CAIXABANK, LA CAIXA | EXCLUDE for bank charges/fees | Art. 20.Uno.18 LIVA: financial service, exempt | |
| 152 | | SANTANDER, BANCO SANTANDER | EXCLUDE for bank charges/fees | Same | |
| 153 | | BBVA, BANCO BILBAO | EXCLUDE for bank charges/fees | Same | |
| 154 | | BANKINTER | EXCLUDE for bank charges/fees | Same | |
| 155 | | SABADELL, BANCO SABADELL | EXCLUDE for bank charges/fees | Same | |
| 156 | | ING DIRECT, ING BANK | EXCLUDE for bank charges/fees | Same | |
| 157 | | UNICAJA, KUTXABANK, IBERCAJA, ABANCA | EXCLUDE for bank charges/fees | Same | |
| 158 | | REVOLUT, WISE, N26 (fee lines) | EXCLUDE for transaction/maintenance fees | Check for separate taxable subscription invoices | |
| 159 | | INTERESES, INTEREST | EXCLUDE | Interest income/expense, exempt | |
| 160 | | PRESTAMO, HIPOTECA, LOAN | EXCLUDE | Loan principal movement, out of scope | |
| 161 | |
| 162 | ### 3.2 Spanish government, regulators, and statutory bodies (exclude entirely) |
| 163 | |
| 164 | | Pattern | Treatment | Notes | |
| 165 | |---|---|---| |
| 166 | | AEAT, AGENCIA TRIBUTARIA, HACIENDA | EXCLUDE | Tax payment, not a supply | |
| 167 | | TGSS, TESORERIA GENERAL DE LA SEGURIDAD SOCIAL | EXCLUDE | Social security contribution | |
| 168 | | SEGURIDAD SOCIAL, SEG. SOCIAL | EXCLUDE | Social security contribution | |
| 169 | | IRPF, RETENCION | EXCLUDE | Income tax withholding payment | |
| 170 | | AYUNTAMIENTO | EXCLUDE | Municipal tax/fee, sovereign act | |
| 171 | | REGISTRO MERCANTIL | EXCLUDE | Registry fee, sovereign act | |
| 172 | | IMPUESTO, IAE, IBI | EXCLUDE | Tax payments | |
| 173 | | TRAFICO, DGT | EXCLUDE | Vehicle registration/fines, sovereign act | |
| 174 | |
| 175 | ### 3.3 Spanish utilities |
| 176 | |
| 177 | | Pattern | Treatment | Casilla | Notes | |
| 178 | |---|---|---|---| |
| 179 | | IBERDROLA | Domestic 21% | 28/29 | Electricity — overhead | |
| 180 | | ENDESA, NATURGY, GAS NATURAL | Domestic 21% | 28/29 | Electricity/gas — overhead | |
| 181 | | REPSOL (energy bills) | Domestic 21% | 28/29 | Energy/heating — overhead | |
| 182 | | TELEFONICA, MOVISTAR | Domestic 21% | 28/29 | Telecoms — overhead | |
| 183 | | VODAFONE SPAIN, VODAFONE ES | Domestic 21% | 28/29 | Telecoms — overhead | |
| 184 | | ORANGE, MASMOVIL, YOIGO, DIGI | Domestic 21% | 28/29 | Telecoms — overhead | |
| 185 | | AGUA, CANAL DE ISABEL II, AGUAS | Domestic 10% | 28/29 | Water supply — reduced rate | |
| 186 | |
| 187 | ### 3.4 Insurance (exempt — exclude) |
| 188 | |
| 189 | | Pattern | Treatment | Notes | |
| 190 | |---|---|---| |
| 191 | | MAPFRE, MUTUA MADRILENA, MUTUALIA | EXCLUDE | Insurance, exempt Art. 20.Uno.16 LIVA | |
| 192 | | AXA SEGUROS, ALLIANZ, ZURICH | EXCLUDE | Same | |
| 193 | | GENERALI, SANTALUCIA, PELAYO | EXCLUDE | Same | |
| 194 | | SEGURO, POLIZA, PRIMA | EXCLUDE | Insurance premium, exempt | |
| 195 | |
| 196 | ### 3.5 Post and logistics |
| 197 | |
| 198 | | Pattern | Treatment | Casilla | Notes | |
| 199 | |---|---|---|---| |
| 200 | | CORREOS, SOCIEDAD ESTATAL CORREOS | EXCLUDE for standard postage | | Universal postal service, exempt | |
| 201 | | CORREOS EXPRESS | Domestic 21% | 28/29 | Express/courier is taxable | |
| 202 | | SEUR, MRW, NACEX, GLS SPAIN | Domestic 21% | 28/29 | Courier services, taxable | |
| 203 | | DHL EXPRESS SPAIN | Domestic 21% | 28/29 | Express courier | |
| 204 | | DHL INTERNATIONAL | EU reverse charge (DE entity) | 32/33 | Check invoice — European billing entity | |
| 205 | |
| 206 | ### 3.6 Transport |
| 207 | |
| 208 | | Pattern | Treatment | Casilla | Notes | |
| 209 | |---|---|---|---| |
| 210 | | RENFE | Domestic 10% | 28/29 | Passenger rail — reduced rate (Art. 91 LIVA) | |
| 211 | | METRO, EMT, TMB, TUSSAM | EXCLUDE or 10% | | Public urban transport — reduced rate | |
| 212 | | CABIFY | Domestic 21% | 28/29 | Ride-hailing platform fee | |
| 213 | | UBER SPAIN | Domestic 21% | 28/29 | Ride-hailing | |
| 214 | | IBERIA, VUELING, AIR EUROPA (international) | EXCLUDE / 0% | | International flights exempt Art. 22 LIVA | |
| 215 | | IBERIA, VUELING (domestic) | Domestic 10% | | Domestic passenger flights — reduced rate | |
| 216 | | BLABLACAR | EXCLUDE | | Peer-to-peer, no VAT supply | |
| 217 | |
| 218 | ### 3.7 Food retail (blocked unless hospitality business) |
| 219 | |
| 220 | | Pattern | Treatment | Notes | |
| 221 | |---|---|---| |
| 222 | | MERCADONA, DIA, LIDL, ALDI, CARREFOUR | Default BLOCK input VAT | Personal provisioning. Deductible only if hospitality/catering. Rate mix: 4% staples, 10% prepared food, 21% non-food | |
| 223 | | EL CORTE INGLES (food hall) | Default BLOCK | Same | |
| 224 | | SUPERMERCADO, ALIMENTACION | Default BLOCK | Same | |
| 225 | | RESTAURANTS, CAFES, BARS (any named) | Default BLOCK | Entertainment — see Section 5.12 | |
| 226 | |
| 227 | ### 3.8 SaaS — EU suppliers (reverse charge, casilla 17/18) |
| 228 | |
| 229 | These are billed from EU entities (typically Ireland or Luxembourg) and trigger inversion del sujeto pasivo (reverse charge) under Art. 84.Uno.2 LIVA for services. |
| 230 | |
| 231 | | Pattern | Billing entity | Casilla | Notes | |
| 232 | |---|---|---|---| |
| 233 | | GOOGLE (Ads, Workspace, Cloud) | Google Ireland Ltd (IE) | 17/18 + 32/33 | Reverse charge services | |
| 234 | | MICROSOFT (365, Azure) | Microsoft Ireland Operations Ltd (IE) | 17/18 + 32/33 | Reverse charge | |
| 235 | | ADOBE | Adobe Systems Software Ireland Ltd (IE) | 17/18 + 32/33 | Reverse charge | |
| 236 | | META, FACEBOOK ADS | Meta Platforms Ireland Ltd (IE) | 17/18 + 32/33 | Reverse charge | |
| 237 | | LINKEDIN (paid) | LinkedIn Ireland Unlimited (IE) | 17/18 + 32/33 | Reverse charge | |
| 238 | | SPOTIFY TECHNOLOGY | Spotify AB (SE) | 17/18 + 32/33 | EU, reverse charge | |
| 239 | | DROPBOX | Dropbox International Unlimited (IE) | 17/18 + 32/33 | Reverse charge | |
| 240 | | SLACK | Slack Technologies Ireland Ltd (IE) | 17/18 + 32/33 | Reverse charge | |
| 241 | | ATLASSIAN (Jira, Confluence) | Atlassian Network Services BV (NL) | 17/18 + 32/33 | EU, reverse charge | |
| 242 | | ZOOM | Zoom Video Communications Ireland Ltd (IE) | 17/18 + 32/33 | Reverse charge | |
| 243 | | STRIPE (subscription fees) | Stripe Technology Europe Ltd (IE) | 17/18 + 32/33 | Transaction fees may be exempt — see 3.11 | |
| 244 | |
| 245 | ### 3.9 SaaS — non-EU suppliers (reverse charge, casilla 19/20 + 36/37) |
| 246 | |
| 247 | | Pattern | Billing entity | Casilla | Notes | |
| 248 | |---|---|---|---| |
| 249 | | AWS (standard) | AWS EMEA SARL (LU) — check | 17/18 + 32/33 | LU entity = EU reverse charge | |
| 250 | | NOTION | Notion Labs Inc (US) | 19/20 + 36/37 | Non-EU reverse charge | |
| 251 | | ANTHROPIC, CLAUDE | Anthropic PBC (US) | 19/20 + 36/37 | Non-EU reverse charge | |
| 252 | | OPENAI, CHATGPT | OpenAI Inc (US) | 19/20 + 36/37 | Non-EU reverse charge | |
| 253 | | GITHUB (standard plans) | GitHub Inc (US) | 19/20 + 36/37 | Check if billed by IE entity | |
| 254 | | FIGMA | Figma Inc (US) | 19/20 + 36/37 | Non-EU reverse charge | |
| 255 | | CANVA | Canva Pty Ltd (AU) | 19/20 + 36/37 | Non-EU reverse charge | |
| 256 | | HUBSPOT | HubSpot Inc (US) or HubSpot Ireland Ltd (IE) — check invoice | 19/20 or 17/18 | Depends on billing entity | |
| 257 | | TWILIO | Twilio Inc (US) | 19/20 + 36/37 | Non-EU reverse charge | |
| 258 | |
| 259 | ### 3.10 SaaS — the exception (NOT reverse charge) |
| 260 | |
| 261 | | Pattern | Treatment | Why | |
| 262 | |---|---|---| |
| 263 | | AWS EMEA SARL | EU reverse charge casilla 17/18 + 32/33 (Luxembourg entity) | Standard EU reverse charge. If invoice shows Spanish IVA charged, treat as domestic 21%. | |
| 264 | | AMAZON ES, AMAZON.ES (marketplace) | Domestic 21% | Amazon Spain retail — domestic supply with IVA on invoice | |
| 265 | |
| 266 | ### 3.11 Payment processors |
| 267 | |
| 268 | | Pattern | Treatment | Notes | |
| 269 | |---|---|---| |
| 270 | | STRIPE (transaction fees) | EXCLUDE (exempt) | Payment processing fees are exempt financial services | |
| 271 | | PAYPAL (transaction fees) | EXCLUDE (exempt) | Same | |
| 272 | | STRIPE (monthly subscription) | EU reverse charge casilla 17/18 + 32/33 | Stripe IE entity — separate from transaction fees | |
| 273 | | REDSYS, SERVIRED | EXCLUDE (exempt) | Card processing, exempt financial service | |
| 274 | | SUMUP, SQUARE, ZETTLE | Check invoice | If Spanish entity: domestic 21%; if IE/EU entity: reverse charge | |
| 275 | |
| 276 | ### 3.12 Professional services (Spain) |
| 277 | |
| 278 | | Pattern | Treatment | Casilla | Notes | |
| 279 | |---|---|---|---| |
| 280 | | NOTARIO, NOTARIA | Domestic 21% | 28/29 | Notary fees, deductible if business purpose | |
| 281 | | ASESOR, ASESORIA, GESTORIA | Domestic 21% | 28/29 | Tax advisor/accountant, always deductible | |
| 282 | | ABOGADO, BUFETE, DESPACHO | Domestic 21% | 28/29 | Legal services, deductible if business purpose | |
| 283 | | REGISTRO MERCANTIL | EXCLUDE | | Government registry fee | |
| 284 | | COLEGIO PROFESIONAL | Domestic 21% | 28/29 | Professional body membership | |
| 285 | |
| 286 | ### 3.13 Payroll and social security (exclude entirely) |
| 287 | |
| 288 | | Pattern | Treatment | Notes | |
| 289 | |---|---|---| |
| 290 | | NOMINA, SALARIO, SUELDO | EXCLUDE | Wages — outside VAT scope | |
| 291 | | TGSS, SEGURIDAD SOCIAL | EXCLUDE | Statutory SSC payment | |
| 292 | | IRPF, RETENCION, MOD 111, MOD 190 | EXCLUDE | IRPF withholding payment | |
| 293 | | AUTONOMO, RETA, CUOTA AUTONOMO | EXCLUDE | Self-employed social security quota | |
| 294 | |
| 295 | ### 3.14 Property and rent |
| 296 | |
| 297 | | Pattern | Treatment | Notes | |
| 298 | |---|---|---| |
| 299 | | ALQUILER, RENTA (commercial, with IVA) | Domestic 21% | Commercial lease where landlord charges IVA | |
| 300 | | ALQUILER, RENTA (residential, no IVA) | EXCLUDE | Residential lease exempt Art. 20.Uno.23 LIVA | |
| 301 | | COMUNIDAD DE PROPIETARIOS | EXCLUDE | Building community fees — not a taxable supply | |
| 302 | | HIPOTECA | EXCLUDE | Mortgage payment, financial service | |
| 303 | |
| 304 | ### 3.15 Internal transfers and exclusions |
| 305 | |
| 306 | | Pattern | Treatment | Notes | |
| 307 | |---|---|---| |
| 308 | | TRASPASO, TRANSFERENCIA PROPIA | EXCLUDE | Internal movement | |
| 309 | | DIVIDENDO | EXCLUDE | Dividend payment, out of scope | |
| 310 | | AMORTIZACION PRESTAMO | EXCLUDE | Loan repayment, out of scope | |
| 311 | | REINTEGRO, CAJERO, ATM | TIER 2 — ask | Default exclude; ask what cash was spent on | |
| 312 | | BIZUM (personal) | EXCLUDE | Personal transfers via Bizum | |
| 313 | |
| 314 | --- |
| 315 | |
| 316 | ## Section 4 — Worked examples |
| 317 | |
| 318 | These are six fully worked classifications drawn from a hypothetical bank statement of a Spain-based self-employed software consultant (autonomo). They illustrate the trickiest cases. |
| 319 | |
| 320 | ### Example 1 — Non-EU SaaS reverse charge (Notion) |
| 321 | |
| 322 | **Input line:** |
| 323 | `03.04.2026 ; NOTION LABS INC ; CARGO ; Monthly subscription ; USD 16.00 ; EUR 14.68` |
| 324 | |
| 325 | **Reasoning:** |
| 326 | Notion Labs Inc is a US entity (Section 3.9). No IVA on the invoice. This is a service received from a non-EU supplier. Art. 84.Uno.2 LIVA triggers inversion del sujeto pasivo. Both sides of the reverse charge must be reported: output IVA in casilla 19/20, input IVA in casilla 36/37. Net effect zero for a fully taxable registrant. |
| 327 | |
| 328 | **Output:** |
| 329 | |
| 330 | | Date | Counterparty | Gross | Net | VAT | Rate | Casilla (input) | Casilla (output) | Default? | Question? | Excluded? | |
| 331 | |---|---|---|---|---|---|---|---|---|---|---| |
| 332 | | 03.04.2026 | NOTION LABS INC | -14.68 | -14.68 | 3.08 | 21% | 36/37 | 19/20 | N | — | — | |
| 333 | |
| 334 | ### Example 2 — EU service, reverse charge (Google Ads) |
| 335 | |
| 336 | **Input line:** |
| 337 | `10.04.2026 ; GOOGLE IRELAND LIMITED ; CARGO ; Google Ads abril 2026 ; -850.00 ; EUR` |
| 338 | |
| 339 | **Reasoning:** |
| 340 | Google Ireland Limited is an IE entity — standard EU reverse charge for services. Casilla 17 for the output base, casilla 18 for output IVA, casilla 32 for input base, casilla 33 for input IVA. Net cash effect zero. |
| 341 | |
| 342 | **Output:** |
| 343 | |
| 344 | | Date | Counterparty | Gross | Net | VAT | Rate | Casilla (input) | Casilla (output) | Default? | Question? | Excluded? | |
| 345 | |---|---|---|---|---|---|---|---|---|---|---| |
| 346 | | 10.04.2026 | GOOGLE IRELAND LIMITED | -850.00 | -850.00 | 178.50 | 21% | 32/33 | 17/18 | N | — | — | |
| 347 | |
| 348 | ### Example 3 — Entertainment, no deduction right |
| 349 | |
| 350 | **Input line:** |
| 351 | `15.04.2026 ; RESTAURANTE BOTIN MADRID ; CARGO ; Cena de negocios ; -180.00 ; EUR` |
| 352 | |
| 353 | **Reasoning:** |
| 354 | Restaurant transaction. Under Spanish rules, entertainment and client meals (atenciones a clientes) are deductible for income tax purposes (IRPF) up to 1% of net turnover but the IVA deductibility is restricted: Art. 96.Uno.5 LIVA limits input IVA recovery on entertainment to expenses that are "strictly necessary" for business activity and can be justified. The conservative default is to block recovery. Flag for reviewer. |
| 355 | |
| 356 | **Output:** |
| 357 | |
| 358 | | Date | Counterparty | Gross | Net | VAT | Rate | Casilla | Default? | Question? | Excluded? | |
| 359 | |---|---|---|---|---|---|---|---|---|---| |
| 360 | | 15.04.2026 | RESTAURANTE BOTIN | -180.00 | -180.00 | 0 | — | — | Y | Q1 | "Entertainment: blocked (conservative)" | |
| 361 | |
| 362 | ### Example 4 — Investment goods (bienes de inversion) |
| 363 | |
| 364 | **Input line:** |
| 365 | `18.04.2026 ; APPLE STORE PASEO DE GRACIA ; CARGO ; MacBook Pro 16 ; -2,999.00 ; EUR` |
| 366 | |
| 367 | **Reasoning:** |
| 368 | Gross amount is EUR 2,999. Investment goods threshold in Spain: assets with useful life > 1 year and acquisition cost > EUR 3,005.06 (historical threshold). At EUR 2,999 this falls just below the bienes de inversion threshold, so it goes to casilla 28/29 (current domestic inputs), not casilla 30/31. However, if the total including accessories exceeds the threshold, reclassify. Conservative: treat as ordinary input. |
| 369 | |
| 370 | **Output:** |
| 371 | |
| 372 | | Date | Counterparty | Gross | Net | VAT | Rate | Casilla | Default? | Question? | Excluded? | |
| 373 | |---|---|---|---|---|---|---|---|---|---| |
| 374 | | 18.04.2026 | APPLE STORE | -2,999.00 | -2,478.51 | -520.49 | 21% | 28/29 | N | — | — | |
| 375 | |
| 376 | ### Example 5 — EU B2B service sale (inbound receipt) |
| 377 | |
| 378 | **Input line:** |
| 379 | `22.04.2026 ; KREBS CONSULTING GMBH ; ABONO ; Factura ES-2026-018 consultoria IT marzo ; +4,200.00 ; EUR` |
| 380 | |
| 381 | **Reasoning:** |
| 382 | Incoming EUR 4,200 from a German company. Client provides IT consulting services. B2B place of supply for services is the customer's country (Germany) under Art. 69.Uno.1 LIVA (general rule). Client invoices at 0% with a note that the customer self-assesses. Not reported in casilla 01–06 (those are domestic). Reported in Modelo 303 informative section (casilla 59 for operations with EU) and in the recapitulative declaration Modelo 349. Confirm: (a) customer has a valid DE VAT number verified on VIES; (b) the invoice shows no Spanish IVA. |
| 383 | |
| 384 | **Output:** |
| 385 | |
| 386 | | Date | Counterparty | Gross | Net | VAT | Rate | Casilla | Default? | Question? | Excluded? | |
| 387 | |---|---|---|---|---|---|---|---|---|---| |
| 388 | | 22.04.2026 | KREBS CONSULTING GMBH | +4,200.00 | +4,200.00 | 0 | 0% | 59 (informative) | Y | Q2 (HIGH) | "Verify DE USt-IdNr on VIES" | |
| 389 | |
| 390 | ### Example 6 — Vehicle costs, 50% presumption |
| 391 | |
| 392 | **Input line:** |
| 393 | `28.04.2026 ; REPSOL ESTACION DE SERVICIO ; CARGO ; Gasoleo A ; -85.00 ; EUR` |
| 394 | |
| 395 | **Reasoning:** |
| 396 | Fuel purchase. In Spain, vehicle expenses have a special rule: Art. 95.Tres.2 LIVA creates a rebuttable presumption of 50% business use for passenger vehicles. This means 50% of input IVA is deductible by default (unlike Malta where vehicles are fully blocked). The 50% can be increased if the taxpayer proves higher business use, or reduced if AEAT proves lower. Conservative default: 50% recovery. |
| 397 | |
| 398 | **Output:** |
| 399 | |
| 400 | | Date | Counterparty | Gross | Net | VAT | Rate | Casilla | Default? | Question? | Excluded? | |
| 401 | |---|---|---|---|---|---|---|---|---|---| |
| 402 | | 28.04.2026 | REPSOL | -85.00 | -70.25 | -7.38 | 21% (50%) | 28/29 | Y | Q3 | "Vehicle fuel: 50% presumption applied" | |
| 403 | |
| 404 | --- |
| 405 | |
| 406 | ## Section 5 — Tier 1 classification rules (compressed) |
| 407 | |
| 408 | Each rule states the legal source and the casilla mapping. Apply silently if the data is unambiguous. For full doctrinal context, see the source citations in Section 10. |
| 409 | |
| 410 | ### 5.1 Standard rate 21% (Art. 90 LIVA) |
| 411 | |
| 412 | Default rate for any taxable supply unless a reduced rate, zero rate, or exemption applies. Sales → casilla 01/02. Purchases → casilla 28/29. |
| 413 | |
| 414 | ### 5.2 Reduced rate 10% (Art. 91.Uno LIVA) |
| 415 | |
| 416 | Applies to: food and beverages (excluding alcohol and tobacco), water supply, passenger transport (rail, bus, taxi, domestic air), hotel accommodation, restaurant and catering services, spectacles and cinema, housing (first transfer of new housing), medical devices, agricultural inputs. Sales → casilla 03/04. Purchases → casilla 28/29 (input base is aggregated). |
| 417 | |
| 418 | ### 5.3 Super-reduced rate 4% (Art. 91.Dos LIVA) |
| 419 | |
| 420 | Applies to: bread, milk, eggs, fruit, vegetables, cereals, cheese, books, newspapers, periodicals, pharmaceutical products for human use, vehicles for disabled persons, social housing (VPO), prosthetics and implants. Sales → casilla 05/06. Purchases → casilla 28/29. |
| 421 | |
| 422 | ### 5.4 Zero rate and exempt with credit |
| 423 | |
| 424 | Exports outside EU → exempt with right of deduction (Art. 21 LIVA), reported in casilla 60 informative. Intra-EU B2B supplies of goods → exempt with right of deduction (Art. 25 LIVA), reported in Modelo 349. Intra-EU B2B services → place of supply is customer's country (Art. 69 LIVA), reported in Modelo 349. |
| 425 | |
| 426 | ### 5.5 Exempt without credit (Art. 20 LIVA) |
| 427 | |
| 428 | Medical services, education, insurance, financial services, postal universal service, residential lettings, social welfare. These supplies are excluded from the return — no output VAT, no input VAT deduction on related costs. If significant → R-ES-6 prorrata refusal fires. |
| 429 | |
| 430 | ### 5.6 Local standard purchases |
| 431 | |
| 432 | Input VAT on a compliant factura from a Spanish supplier is deductible for purchases used in taxable business activity. Subject to blocked-input rules (5.12) and bienes de inversion threshold (5.9). Map to casilla 28/29 (corrientes) or 30/31 (bienes de inversion). |
| 433 | |
| 434 | ### 5.7 Reverse charge — intra-EU services received (Art. 84.Uno.2 LIVA) |
| 435 | |
| 436 | When the client receives a service from an EU supplier and the supplier invoices at 0% with a reverse-charge note: output base → casilla 17, output IVA → casilla 18, input base → casilla 32, input IVA → casilla 33. Net effect zero. If the EU supplier charged their local VAT (e.g. Irish 23%), that is NOT reverse charge — treat as irrecoverable foreign VAT. |
| 437 | |
| 438 | ### 5.8 Reverse charge — intra-EU goods received (Art. 13 LIVA) |
| 439 | |
| 440 | Physical goods from an EU supplier: output base → casilla 15, output IVA → casilla 16, input base → casilla 32, input IVA → casilla 33. |
| 441 | |
| 442 | ### 5.9 Reverse charge — non-EU services and imports |
| 443 | |
| 444 | Services from non-EU → Art. 84.Uno.2 LIVA: output base → casilla 19, output IVA → casilla 20, input base → casilla 36, input IVA → casilla 37. Physical goods imports: import IVA is paid at customs (DUA) and recovered via casilla 36/37. |
| 445 | |
| 446 | ### 5.10 Investment goods — bienes de inversion (Art. 108–110 LIVA) |
| 447 | |
| 448 | Assets with useful life > 1 year and net acquisition cost > EUR 3,005.06: casilla 30/31 (domestic), casilla 34/35 (intra-EU), casilla 38/39 (imports). Subject to a 4-year adjustment period (9 years for immovable property). If gross < threshold → casilla 28/29 (ordinary input). |
| 449 | |
| 450 | ### 5.11 Vehicle deduction — 50% presumption (Art. 95.Tres.2 LIVA) |
| 451 | |
| 452 | Passenger vehicles (turismos) and related expenses (fuel, maintenance, insurance premiums for the vehicle itself — but insurance is exempt anyway): rebuttable presumption of 50% business use. Apply 50% input IVA recovery by default. Vehicles used exclusively for: taxi/VTC, driving school, commercial transport, or traveling sales → 100% deduction. The 50% presumption does NOT apply to vans (furgonetas), trucks, or motorbikes used for delivery. |
| 453 | |
| 454 | ### 5.12 Restricted input VAT (Art. 96 LIVA) |
| 455 | |
| 456 | The following categories have restricted or no VAT recovery: |
| 457 | - Jewellery, precious stones, and furs (Art. 96.Uno.1) |
| 458 | - Food, drink, and tobacco (Art. 96.Uno.2) — unless hospitality/catering business |
| 459 | - Spectacles and entertainment (Art. 96.Uno.3) — for client entertainment |
| 460 | - Services related to the above (Art. 96.Uno.4) |
| 461 | - Gifts and samples above EUR 200 per recipient per year (Art. 96.Uno.5) — IVA deductible below threshold |
| 462 | |
| 463 | Unlike Malta, Spain does NOT have a hard block on entertainment. The IVA on business meals CAN be deductible if the expense is strictly necessary and directly related to the business activity. However, the conservative default is to block — the burden of proof is on the taxpayer. |
| 464 | |
| 465 | ### 5.13 SII — Suministro Inmediato de Informacion (RD 596/2016) |
| 466 | |
| 467 | SII-obliged entities must report invoices to AEAT within 4 calendar days of issue (sales) or accounting date (purchases). SII is mandatory for monthly filers. If client is SII-obliged, note in the reviewer brief that invoice data must match the SII submissions. |
| 468 | |
| 469 | ### 5.14 Modelo 390 — annual summary |
| 470 | |
| 471 | Modelo 390 is an annual informative declaration summarizing all periodic Modelo 303 filings. Due by 30 January following the tax year. SII-obliged entities are exempt from filing Modelo 390 (since 2017). |
| 472 | |
| 473 | ### 5.15 Modelo 349 — recapitulative declaration |
| 474 | |
| 475 | Quarterly (or monthly if intra-EU operations exceed EUR 50,000 in any quarter): declares all intra-EU supplies and acquisitions. Must reconcile with casillas 15–18 and informative casilla 59. |
| 476 | |
| 477 | --- |
| 478 | |
| 479 | ## Section 6 — Tier 2 catalogue (compressed) |
| 480 | |
| 481 | For each ambiguity type: pattern, why the bank statement is insufficient, conservative default, question for the structured form. |
| 482 | |
| 483 | ### 6.1 Fuel and vehicle costs |
| 484 | |
| 485 | *Pattern:* Repsol, Cepsa, BP, Shell, Galp, fuel receipts. *Why insufficient:* vehicle type and business-use proportion unknown. *Default:* 50% recovery for passenger vehicles (Art. 95.Tres.2 LIVA presumption). *Question:* "Is this fuel for a passenger car (50% presumption), a commercial vehicle (100%), or personal use (0%)?" |
| 486 | |
| 487 | ### 6.2 Restaurants and entertainment |
| 488 | |
| 489 | *Pattern:* any named restaurant, bar, cafeteria. *Why insufficient:* business necessity unclear. *Default:* block. *Question:* "Was this a business meal strictly necessary for the activity? (Note: conservative default is to block — reviewer must confirm deductibility under Art. 96 LIVA.)" |
| 490 | |
| 491 | ### 6.3 Ambiguous SaaS billing entities |
| 492 | |
| 493 | *Pattern:* Google, Microsoft, Adobe, Meta, Slack, Zoom, LinkedIn, Apple, Amazon, Dropbox, Atlassian, Stripe where the legal entity is not visible. *Why insufficient:* same brand can bill from Ireland (EU reverse charge casilla 17/18), US (non-EU reverse charge casilla 19/20), or Spain (domestic 21%). *Default:* non-EU reverse charge casilla 19/20 + 36/37. *Question:* "Could you check the most recent invoice? I need the legal entity name and country." |
| 494 | |
| 495 | ### 6.4 Round-number incoming transfers from owner-named counterparties |
| 496 | |
| 497 | *Pattern:* large round credit from a name matching the client's name. *Default:* exclude as owner injection. *Question:* "The EUR X transfer from [name] — is this a customer payment, your own funds, or a loan?" |
| 498 | |
| 499 | ### 6.5 Incoming transfers from individual names (not owner) |
| 500 | |
| 501 | *Pattern:* incoming from private-looking counterparties. *Default:* domestic B2C sale at 21%, casilla 01/02. *Question:* "Was it a sale? Business or consumer? Country?" |
| 502 | |
| 503 | ### 6.6 Incoming transfers from foreign counterparties |
| 504 | |
| 505 | *Pattern:* foreign IBAN or foreign currency. *Default:* domestic 21%. *Question:* "B2B with VAT number, B2C, goods or services, which country?" |
| 506 | |
| 507 | ### 6.7 Large one-off purchases (potential bienes de inversion) |
| 508 | |
| 509 | *Pattern:* single invoice EUR 2,500–3,500 range or labelled "ordenador", "equipo", "maquinaria". *Default:* if net > EUR 3,005.06 → casilla 30/31; if net <= EUR 3,005.06 → casilla 28/29. *Question:* "Confirm the total invoice amount including IVA." |
| 510 | |
| 511 | ### 6.8 Mixed-use phone, internet, home office |
| 512 | |
| 513 | *Pattern:* Movistar, Vodafone, Orange personal lines; home electricity. *Default:* 0% if mixed without declared %. *Question:* "Is this a dedicated business line or mixed-use? What business percentage?" |
| 514 | |
| 515 | ### 6.9 Outgoing transfers to individuals |
| 516 | |
| 517 | *Pattern:* outgoing to private-looking names. *Default:* exclude as drawings. *Question:* "Was this a contractor (with factura), salary, refund, or personal transfer?" |
| 518 | |
| 519 | ### 6.10 Cash withdrawals |
| 520 | |
| 521 | *Pattern:* ATM, cajero, reintegro. *Default:* exclude as personal drawing. *Question:* "What was the cash used for?" |
| 522 | |
| 523 | ### 6.11 Rent payments |
| 524 | |
| 525 | *Pattern:* monthly "alquiler", "renta" to a landlord name. *Default:* no IVA recovery (residential assumption). *Question:* "Is this a commercial property? Does the landlord charge IVA on the rent?" |
| 526 | |
| 527 | ### 6.12 Foreign hotel and accommodation (non-Spain) |
| 528 | |
| 529 | *Pattern:* hotel abroad. *Default:* exclude from input IVA. *Question:* "Was this a business trip?" (For IRPF, the expense may still be deductible.) |
| 530 | |
| 531 | ### 6.13 Amazon purchases |
| 532 | |
| 533 | *Pattern:* Amazon.es, Amazon EU SARL. *Why insufficient:* Amazon can sell as Amazon Spain (domestic 21%), Amazon EU SARL Luxembourg (EU reverse charge), or third-party marketplace seller. *Default:* domestic 21% for Amazon.es retail. *Question:* "Was this purchased from Amazon directly or a third-party seller? Check the factura." |
| 534 | |
| 535 | ### 6.14 IRPF withholding on professional invoices |
| 536 | |
| 537 | *Pattern:* incoming payment that is less than the invoiced amount by exactly 15% or 7%. *Why insufficient:* the payer withheld IRPF retencion. *Default:* gross up the payment to the full invoice amount for IVA base calculation. *Question:* "Confirm the invoice amount before IRPF retention." |
| 538 | |
| 539 | ### 6.15 Platform sales (Amazon, eBay, Wallapop, Etsy) |
| 540 | |
| 541 | *Pattern:* incoming from platform settlements. *Default:* if selling to EU consumers across multiple countries above EUR 10,000, R-EU-5 OSS refusal fires. For Spain-only: treat gross as casilla 01/02 base at 21%; platform fees as separate reverse charge casilla 17/18 (IE entity). *Question:* "Do you sell to buyers outside Spain? Total EU cross-border sales for the year?" |
| 542 | |
| 543 | --- |
| 544 | |
| 545 | ## Section 7 — Excel working paper template (Spain-specific) |
| 546 | |
| 547 | The base specification is in `vat-workflow-base` Section 3. This section provides the Spain-specific overlay. |
| 548 | |
| 549 | ### Sheet "Transactions" |
| 550 | |
| 551 | Columns A–L per the base. Column H ("Casilla code") accepts only valid Modelo 303 casilla codes from Section 1 of this skill. Use blank for excluded transactions. For reverse-charge transactions, enter both the output casilla (e.g. 17) and the input casilla (e.g. 32) separated by a slash in column H. |
| 552 | |
| 553 | ### Sheet "Casilla Summary" |
| 554 | |
| 555 | One row per casilla. Column A is the casilla number, column B is the description, column C is the value computed via formula. Mandatory rows: |
| 556 | |
| 557 | ``` |
| 558 | Output: |
| 559 | | 01 | Output base 21% | =SUMIFS(Transactions!E:E, Transactions!H:H, "01") | |
| 560 | | 02 | Output IVA 21% | =Casilla_Summary!C[01_row]*0.21 | |
| 561 | | 03 | Output base 10% | =SUMIFS(Transactions!E:E, Transactions!H:H, "03") | |
| 562 | | 04 | Output IVA 10% | =Casilla_Summary!C[03_row]*0.10 | |
| 563 | | 05 | Output base 4% | =SUMIFS(Transactions!E:E, Transactions!H:H, "05") | |
| 564 | | 06 | Output IVA 4% | =Casilla_Summary!C[05_row]*0.05 | |
| 565 | | 15 | Output base intra-EU goods | =SUMIFS(Transactions!E:E, Transactions!H:H, "15") | |
| 566 | | 16 | Output IVA intra-EU goods | =C[15_row]*0.21 | |
| 567 | | 17 | Output base intra-EU services | =SUMIFS(Transactions!E:E, Transactions!H:H, "17") | |
| 568 | | 18 | Output IVA intra-EU services | =C[17_row]*0.21 | |
| 569 | | 19 | Output base non-EU reverse charge | =SUMIFS(Transactions!E:E, Transactions!H:H, "19") | |
| 570 | | 20 | Output IVA non-EU reverse charge | =C[19_row]*0.21 | |
| 571 | | 27 | Total output IVA | =SUM(C[02],C[04],C[06],C[16],C[18],C[20]) | |
| 572 | |
| 573 | Input: |
| 574 | | 28 | Input base domestic current | =SUMIFS(Transactions!E:E, Transactions!H:H, "28") | |
| 575 | | 29 | Input IVA domestic current | =variable rate — use SUMIFS on VAT column | |
| 576 | | 30 | Input base investment goods | =SUMIFS(Transactions!E:E, Transactions!H:H, "30") | |
| 577 | | 31 | Input IVA investment goods | =C[30_row]*0.21 | |
| 578 | | 32 | Input base intra-EU current | =SUMIFS(Transactions!E:E, Transactions!H:H, "32") | |
| 579 | | 33 | Input IVA intra-EU current | =C[32_row]*0.21 | |
| 580 | | 36 | Input base imports/non-EU | =SUMIFS(Transactions!E:E, Transactions!H:H, "36") | |
| 581 | | 37 | Input IVA imports/non-EU | =C[36_row]*0.21 | |
| 582 | | 45 | Total input IVA | =SUM(C[29],C[31],C[33],C[35],C[37],C[39],C[41]) | |
| 583 | ``` |
| 584 | |
| 585 | ### Sheet "Return Form" |
| 586 | |
| 587 | Final Modelo 303-ready figures: |
| 588 | |
| 589 | ``` |
| 590 | Casilla 27 = Total output IVA |
| 591 | Casilla 45 = Total input IVA deductible |
| 592 | |
| 593 | Casilla 46 = Casilla 27 - Casilla 45 [difference] |
| 594 | Casilla 67 = Credit brought forward from prior period |
| 595 | Casilla 69 = Casilla 46 - Casilla 67 [final result] |
| 596 | |
| 597 | Positive Casilla 69 → payable to AEAT (ingreso) |
| 598 | Negative Casilla 69 → credit to carry forward (a compensar) or request refund (devolucion, only in Q4 annual or REDEME monthly) |
| 599 | ``` |
| 600 | |
| 601 | ### Color and formatting conventions |
| 602 | |
| 603 | Per the xlsx skill: blue for hardcoded values from the bank statement, black for formulas, green for cross-sheet references, yellow background for any row where Default? = "Y". |
| 604 | |
| 605 | ### Mandatory recalc step |
| 606 | |
| 607 | After building the workbook, run: |
| 608 | |
| 609 | ```bash |
| 610 | python /mnt/skills/public/xlsx/scripts/recalc.py /mnt/user-data/outputs/spain-vat-<period>-working-paper.xlsx |
| 611 | ``` |
| 612 | |
| 613 | --- |
| 614 | |
| 615 | ## Section 8 — Spanish bank statement reading guide |
| 616 | |
| 617 | Follow the universal exclusion rules in `vat-workflow-base` Step 6, plus these Spain-specific patterns. |
| 618 | |
| 619 | **Extracto bancario format conventions.** Spanish bank statements (extractos bancarios) vary by institution but share common fields: |
| 620 | |
| 621 | - **CaixaBank:** CSV/Excel export from CaixaBankNow. Columns: Fecha (date DD/MM/YYYY), Concepto (description), Importe (amount, negative for debits), Saldo (balance). The concepto field often includes the beneficiary name after a dash. |
| 622 | - **Santander:** Online export from Santander One. Columns: Fecha Valor, Fecha Operacion, Concepto, Importe, Saldo. Uses "ADEUDO" for debits, "ABONO" for credits. |
| 623 | - **BBVA:** Export from BBVA app/web. Columns: Fecha, Concepto, Movimiento (Cargo/Abono), Importe, Disponible. "Cargo" = debit, "Abono" = credit. |
| 624 | - **Bankinter:** Columns: Fecha, Descripcion, Debe (debit), Haber (credit), Saldo. |
| 625 | - **Revolut/Wise/N26:** ISO date format (YYYY-MM-DD), English column headers, amount in EUR with sign. |
| 626 | |
| 627 | **Key Spanish-language terms in bank descriptions:** |
| 628 | |
| 629 | | Term | Meaning | |
| 630 | |---|---| |
| 631 | | Concepto | Description/reference | |
| 632 | | Beneficiario | Payee | |
| 633 | | Ordenante | Payer (on incoming) | |
| 634 | | Cargo / Adeudo | Debit | |
| 635 | | Abono / Ingreso | Credit | |
| 636 | | Transferencia | Transfer | |
| 637 | | Domiciliacion / Recibo | Direct debit / bill payment | |
| 638 | | Bizum | Spanish instant payment (like Venmo) | |
| 639 | | Reintegro / Cajero | Cash withdrawal / ATM | |
| 640 | | Comision | Bank fee/commission | |
| 641 | | Nomina | Salary payment | |
| 642 | | Cuota autonomo | Self-employed social security payment | |
| 643 | |
| 644 | **Internal transfers and exclusions.** Own-account transfers between the client's CaixaBank, Santander, BBVA, Revolut accounts. Labelled "traspaso", "transferencia propia", "movimiento entre cuentas". Always exclude. |
| 645 | |
| 646 | **Self-employed (autonomo) draws.** A self-employed person (autonomo/persona fisica) cannot pay themselves wages — any transfer to a personal account is a drawing. Exclude. |
| 647 | |
| 648 | **IRPF retenciones.** Incoming payments from business clients may be net of 15% IRPF retention (or 7% for new autonomos in first 3 years). The bank statement shows the net amount received. The IVA base is the full invoice amount before retention. Always gross up. |
| 649 | |
| 650 | **Refunds and reversals.** Identify by "devolucion", "anulacion", "abono por devolucion". Book as a negative in the same casilla as the original transaction. |
| 651 | |
| 652 | **Foreign currency transactions.** Convert to EUR at the transaction date rate. Use the ECB reference rate. Note the rate in column L (Notes). |
| 653 | |
| 654 | **Bizum transactions.** Bizum is Spain's peer-to-peer instant payment. Business Bizum (Bizum Comercios) shows merchant names. Personal Bizum shows individual names. Default: exclude personal Bizum as non-business unless client confirms it was a customer payment. |
| 655 | |
| 656 | --- |
| 657 | |
| 658 | ## Section 9 — Onboarding fallback (only when inference fails) |
| 659 | |
| 660 | The workflow in `vat-workflow-base` Section 1 mandates inferring the client profile from the data first and only confirming in Step 4. The questionnaire below is a fallback. |
| 661 | |
| 662 | ### 9.1 Entity type and trading name |
| 663 | *Inference rule:* "autonomo" or personal name = sole trader; "SL", "SA", "SLU" = company. *Fallback:* "Are you an autonomo (persona fisica) or a company (SL/SA)?" |
| 664 | |
| 665 | ### 9.2 VAT regime |
| 666 | *Inference rule:* if asking for Modelo 303, they are regimen general. If they mention modulos or modules, R-ES-3 fires. *Fallback:* "Are you in the regimen general, regimen simplificado, or recargo de equivalencia?" |
| 667 | |
| 668 | ### 9.3 NIF-IVA |
| 669 | *Inference rule:* sometimes visible in EU customer payment descriptions. *Fallback:* "What is your NIF-IVA? (ES + 9 characters)" |
| 670 | |
| 671 | ### 9.4 Filing period |
| 672 | *Inference rule:* first and last transaction dates. Standard is quarterly. *Fallback:* "Which quarter? 1T (Jan–Mar), 2T (Apr–Jun), 3T (Jul–Sep), or 4T (Oct–Dec)?" |
| 673 | |
| 674 | ### 9.5 Industry and sector |
| 675 | *Inference rule:* counterparty mix, invoice descriptions. *Fallback:* "In one sentence, what does the business do?" |
| 676 | |
| 677 | ### 9.6 Employees |
| 678 | *Inference rule:* TGSS/nomina/IRPF outgoing. *Fallback:* "Do you have employees?" |
| 679 | |
| 680 | ### 9.7 Exempt supplies |
| 681 | *Inference rule:* medical/financial/educational income. *Fallback:* "Do you make any IVA-exempt sales?" *If yes and non-de-minimis → R-ES-6 fires.* |
| 682 | |
| 683 | ### 9.8 SII obligation |
| 684 | *Inference rule:* monthly filing frequency, turnover > EUR 6M. *Fallback:* "Are you registered in SII or REDEME?" |
| 685 | |
| 686 | ### 9.9 Credit brought forward (casilla 67) |
| 687 | *Not inferable from a single period. Always ask.* "Do you have IVA credit carried forward from the previous period (casilla 67 of prior Modelo 303)?" |
| 688 | |
| 689 | ### 9.10 Cross-border customers |
| 690 | *Inference rule:* foreign IBANs on incoming payments. *Fallback:* "Do you have customers outside Spain? EU or non-EU? Businesses or consumers?" |
| 691 | |
| 692 | --- |
| 693 | |
| 694 | ## Section 10 — Reference material |
| 695 | |
| 696 | ### Validation status |
| 697 | |
| 698 | This skill is v2.0, rewritten in April 2026 to align with the three-tier Accora architecture (vat-workflow-base + eu-vat-directive + country skill). The Spain-specific content (casilla mappings, rates, thresholds, blocked categories, SII requirements) is based on LIVA and RIVA as of April 2026. |
| 699 | |
| 700 | ### Sources |
| 701 | |
| 702 | **Primary legislation:** |
| 703 | 1. Ley 37/1992, de 28 de diciembre, del Impuesto sobre el Valor Anadido (LIVA) — Art. 3, 4, 11, 13–16, 20, 21–25, 69, 84, 90, 91, 92–96, 102–106, 108–110, 148–163 |
| 704 | 2. Real Decreto 1624/1992, de 29 de diciembre (RIVA — Reglamento del IVA) — Art. 30 (filing frequency) |
| 705 | 3. Real Decreto 596/2016 (SII — Suministro Inmediato de Informacion) |
| 706 | |
| 707 | **AEAT guidance:** |
| 708 | 4. Modelo 303 form and completion instructions — sede.agenciatributaria.gob.es |
| 709 | 5. Modelo 390 annual summary instructions |
| 710 | 6. Modelo 349 recapitulative declaration instructions |
| 711 | 7. AEAT guidance on inversion del sujeto pasivo (reverse charge) |
| 712 | 8. AEAT guidance on bienes de inversion (investment goods) |
| 713 | |
| 714 | **EU directive (loaded via companion skill):** |
| 715 | 9. Council Directive 2006/112/EC (Principal VAT Directive) — implemented via eu-vat-directive companion skill |
| 716 | 10. Council Implementing Regulation 282/2011 |
| 717 | |
| 718 | **Other:** |
| 719 | 11. VIES validation — https://ec.europa.eu/taxation_customs/vies/ |
| 720 | 12. ECB euro reference rates — https://www.ecb.europa.eu/stats/eurofxref/ |
| 721 | |
| 722 | ### Known gaps |
| 723 | |
| 724 | 1. The supplier pattern library covers common Spanish and international counterparties but not every regional supplier. |
| 725 | 2. Worked examples are for a software consultant. Hospitality, retail, construction, and agricultural sectors need v2.1 examples. |
| 726 | 3. The 50% vehicle presumption (Art. 95.Tres.2) is well-established but AEAT may challenge it — flag for reviewer if vehicle costs are significant. |
| 727 | 4. The bienes de inversion threshold (EUR 3,005.06 net) is the historical amount. Verify annually. |
| 728 | 5. Prorrata calculation (Art. 102–106) is refused entirely — a future version should add basic prorrata support. |
| 729 | 6. IGIC/IPSI for Canary Islands/Ceuta/Melilla is refused — separate skills needed. |
| 730 | 7. The entertainment deduction rule (Art. 96) is fact-sensitive — the conservative block is appropriate but a reviewer may unlock it. |
| 731 | |
| 732 | ### Change log |
| 733 | |
| 734 | - **v2.0 (April 2026):** Full rewrite to align with three-tier Accora architecture. 10-section Malta v2.0 structure adopted. Supplier pattern library restructured as literal lookup tables (Section 3). Six worked examples added (Section 4). Tier 1 rules compressed (Section 5). Tier 2 catalogue added (Section 6). Excel template added (Section 7). Bank statement guide with extracto bancario formats added (Section 8). Onboarding moved to fallback (Section 9). |
| 735 | - **v2.1-verified (April 2026):** Previous version with inline tier tags. Superseded by this rewrite. |
| 736 | |
| 737 | ### Self-check (v2.0) |
| 738 | |
| 739 | 1. Quick reference at top with casilla table and conservative defaults: yes (Section 1). |
| 740 | 2. Supplier library as literal lookup tables: yes (Section 3, 15 sub-tables). |
| 741 | 3. Worked examples (hypothetical autonomo IT consultant): yes (Section 4, 6 examples). |
| 742 | 4. Tier 1 rules compressed: yes (Section 5, 15 rules). |
| 743 | 5. Tier 2 catalogue compressed with inference rules: yes (Section 6, 15 items). |
| 744 | 6. Excel template with mandatory recalc: yes (Section 7). |
| 745 | 7. Onboarding as fallback only, inference rules first: yes (Section 9, 10 items). |
| 746 | 8. All 8 Spain-specific refusals present: yes (Section 2, R-ES-1 through R-ES-8). |
| 747 | 9. Reference material at bottom: yes (Section 10). |
| 748 | 10. Vehicle 50% presumption explicit: yes (Section 5.11 + Example 6). |
| 749 | 11. Entertainment conservative block explicit: yes (Section 5.12 + Example 3). |
| 750 | 12. SII obligation documented: yes (Section 5.13). |
| 751 | 13. IRPF retention grossing-up documented: yes (Section 6.14 + Section 8). |
| 752 | 14. Reverse charge both directions (EU + non-EU) explicit: yes (Examples 1–2 + Section 5.7–5.9). |
| 753 | 15. Canary Islands/Ceuta/Melilla refusal explicit: yes (R-ES-1, R-ES-2). |
| 754 | |
| 755 | ## End of Spain VAT Return Skill v2.0 |
| 756 | |
| 757 | This skill is incomplete without BOTH companion files loaded alongside it: `vat-workflow-base` v0.1 or later (Tier 1, workflow architecture) AND `eu-vat-directive` v0.1 or later (Tier 2, EU directive content). Do not attempt to produce a Modelo 303 without all three files loaded. |
| 758 | |
| 759 | |
| 760 | --- |
| 761 | |
| 762 | ## Disclaimer |
| 763 | |
| 764 | 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 an Asesor Fiscal, Economista, or equivalent licensed practitioner in your jurisdiction) before filing or acting upon. |
| 765 | |
| 766 | 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. |
| 767 |
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 Spanish VAT return (Modelo 303 / IVA autoliquidacion) for a self-employed individual or small business in peninsular Spain or the Balearic Islands. Trigger on phrases like "prepare VAT return", "do the Spanish VAT", "fill in Modelo 303", "IVA", "Modelo 390", or any request involving Spanish VAT filing. Also trigger when classifying transactions for VAT purposes from bank statements, invoices, or other source data. This skill covers peninsular Spain and Balearic Islands only under the regimen general. Canary Islands (IGIC), Ceuta/Melilla (IPSI), regimen simplificado, recargo de equivalencia, RECC cash-basis, VAT groups, and partial exemption (prorrata) are in the refusal catalogue. MUST be loaded alongside BOTH vat-workflow-base v0.1 or later (for workflow architecture) AND eu-vat-directive v0.1 or later (for EU directive content). ALWAYS read this skill before touching any Spain VAT work.