from fune.finance.tax.vat_rate import vat_rate # finance.tax.vat-rate@^1
Suites · uk-tax
UK VAT and tax basics
UK VAT by the rate in force on the date of supply: add, remove, the nine-box return and the flat rate scheme, plus the tax year and HMRC identifiers.
9 capabilities (5 core, 4 optional) and 3 gaps, in build order. Put each line in the file that calls it, then fune build.
Calculates tax from published rules; it is not tax advice. Have an accountant check how the app uses it before anyone files a return.
Core coverage: 62.5%
5 of 8 needs met by verified capabilities. The needs are this suite's 5 core members and its 3 named gaps; a core member counts when a version of it is verified (by the sandbox, or the registry's seed) and not yanked, and a gap never counts. Optional members are not needs.
Baseline: a hand-written app with no suite meets 0 of the same 8. Method fune-coverage/1, computed 2026-11-22T20:51:03.193Z.
1. VAT
Work out VAT from the dated rates HMRC publishes.
from fune.finance.tax.add_vat import add_vat # finance.tax.add-vat@^1
from fune.finance.tax.remove_vat import remove_vat # finance.tax.remove-vat@^1
from fune.finance.tax.vat_return import vat_return # finance.tax.vat-return@^1
from fune.finance.tax.vat_flat_rate import flat_rate_vat # finance.tax.vat-flat-rate@^1
2. Tax periods
Put dates into the UK periods tax is worked out over.
from fune.dates.uk_tax_year import uk_tax_year # dates.uk-tax-year@^1
3. Tax identifiers
Check the numbers HMRC and Companies House issue before storing them.
from fune.validation.uk_vat_number import is_uk_vat_number # validation.uk-vat-number@^1
from fune.validation.uk_utr import validate_uk_utr # validation.uk-utr@^2
from fune.validation.uk_company_number import validate_uk_company_number # validation.uk-company-number@^2
Gaps
What this kind of app usually needs that Functional Weave does not have yet: write these yourself, or use a service.
- mtd-submission Making Tax Digital: submitting the return to HMRC's VAT API (OAuth, fraud-prevention headers, obligations) is yours; caps gives the nine boxes.
- corporation-tax Corporation tax and self-assessment income tax computations are not in caps.
- vat-number-lookup Checking that a VAT number is registered (HMRC's lookup API) is network work; caps checks the checksum only.