Foundation
Money, currencies and tax codes
This manual is a draft and may change.
What it does
Money and Tax holds amounts exactly, knows the standard currencies, and keeps your sales tax codes with rates that can never be quietly changed. Other apps use it so totals and tax always add up.
Who uses it
Nobody uses it directly day to day. Owners and accountants decide which tax codes the site needs, and managers can look at the list in the admin.
Setup
- Ask your platform team to install Money, currencies and tax codes. There is no install button in the admin yet.
- Nothing to install beyond the app itself.
- Decide with your accountant which tax codes you need, for example one per region, and whether prices include tax.
- Ask your platform team to add them. There is no form for adding codes yet.
Admin tasks
Currencies & tax
- Open Currencies & tax (managers). The Tax codes table shows each code with its name, rate, region and whether the price includes tax.
- Under Currencies, click Show currencies and decimal places to see the supported currencies.
- The screen is for reading only; adding or retiring a code is done by your platform team.
Tax codes
- A tax code has a short name (1-32 letters, numbers, dash, dot or underscore), a label, a rate, an optional region and whether prices include tax.
- Once a code is added, its rate cannot change. To change a rate, add a new code and retire the old one.
- Retired codes stay on past records but cannot be used again.
Member view
Members do not see this app directly. They see prices and tax figures calculated by it in other apps.
Styling it to your brand
Every app takes its colours, fonts and corners from the brand profile you enter once in the Brand intake on 1vsm.com. It applies to every app automatically, so there is nothing to set up for this one.
Troubleshooting
- A tax rate was refused: it must be between 0% and 100%.
- A tax code was refused: use 1-32 letters, numbers, dash, dot or underscore.
- A code already exists with different terms: rates are locked; create a new code.
- A code is refused as retired: define a new one.
- An amount was refused: it has more decimal places than the currency allows.
- Two amounts could not be added: they are in different currencies.
FAQ
Can I change a tax rate? No. Add a new code with the new rate.
Why are amounts stored without decimals? To avoid rounding errors; cents are stored as whole numbers.
Does tax round correctly? Yes. It rounds each line, and net plus tax always equals the total.
Does it convert currencies? No.
What to connect
Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.