import { vatRate } from "#fune/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-22T21:07:06.057Z.
1. VAT
Work out VAT from the dated rates HMRC publishes.
import { addVat } from "#fune/finance.tax.add-vat@^1";
import { removeVat } from "#fune/finance.tax.remove-vat@^1";
import { vatReturn } from "#fune/finance.tax.vat-return@^1";
import { flatRateVat } from "#fune/finance.tax.vat-flat-rate@^1";
2. Tax periods
Put dates into the UK periods tax is worked out over.
import { ukTaxYear } from "#fune/dates.uk-tax-year@^1";
3. Tax identifiers
Check the numbers HMRC and Companies House issue before storing them.
import { isUkVatNumber } from "#fune/validation.uk-vat-number@^1";
import { validateUkUtr } from "#fune/validation.uk-utr@^2";
import { validateUkCompanyNumber } from "#fune/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.