55a83d9ceb
Rationale in UPGRADING.md It's a big change technically, but converting the format won't be hard for admins. There's a compatibility mode with loud warnings in case the file isn't converted.
61 lines
2.2 KiB
Text
61 lines
2.2 KiB
Text
=head1 NAME
|
|
|
|
vat - RevBank plugin for keeping a VAT administration
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
C<revbank.vat>
|
|
|
|
+sales/products +btw/laag 9
|
|
+sales/products/hoogbtw +btw/hoog 21
|
|
+sales/market +btw/hoog 21
|
|
lasercutter +btw/hoog 21
|
|
|
|
C<revbank.products>
|
|
|
|
123123123 1.00 "Example product that gets the default contra"
|
|
42424242 1.00@+sales/products/hoogbtw "Example with high VAT rate"
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
With this plugin, and a properly configured C<revbank.vat> file, RevBank will
|
|
subtract the appropriate VAT amount from the revenue account and collect that
|
|
in the indicated VAT accounts.
|
|
|
|
C<revbank.vat> is a whitespace separated file with three columns. The first
|
|
column is the account to match, the second column is the account to collect VAT
|
|
in, the third is the VAT rate (percentage).
|
|
|
|
VAT is hidden from the user interface, and only recorded internally, except
|
|
when the matched account is a regular account (does not begin with C<-> or
|
|
C<+>).
|
|
|
|
Note that in The Netherlands, hackerspaces will generally be able to use the
|
|
I<vrijstelling voor kantines> and I<vrijstelling voor fondsenwervende
|
|
activiteiten>. If you pick what you sell carefully, you may not need a BTW/VAT
|
|
administration at all.
|
|
|
|
=head1 CAVEATS
|
|
|
|
You should test extensively before using this plugin in production. Please let
|
|
me know how well it works, because you are probably the first to actually use
|
|
this plugin.
|
|
|
|
There is no configuration for a default VAT rate, so you have to carefully look
|
|
for every sales account that requires it and list each one.
|
|
|
|
Only the contras are matched, e.g. in the example from the synopsis, a C<give>
|
|
to C<lasercutter> will incur VAT, but when someone impersonates C<lasercutter>
|
|
and does a C<take> from a user from the perspective from C<lasercutter>, no VAT
|
|
is counted. This is a feature, and no regular actual user should ever use it
|
|
like that, but you should be aware of this subtlety and monitor the log file
|
|
for mistakes.
|
|
|
|
Negative amounts will get negative VAT (e.g. a C<take> from C<lasercutter> in
|
|
the example from the synopsis).
|
|
|
|
=head1 DISCLAIMER
|
|
|
|
RevBank is not certified or audited tax administration software. You need to
|
|
configure it according to local tax laws; don't just copy the example
|
|
configuration. Use at your own risk.
|