Using Annuva
Concepts
Amounts and taxes, customers, recurring charges, the billing run, invoices and the customer rating.
Amounts and taxes
All amounts are entered and shown in the currency of your instance. Annuva supports two tax modes, chosen in the settings:
- Small business (§ 19 UStG) – invoices carry no VAT and the required note.
- Regular taxation – every invoice line has its own tax rate (default from the settings).
The tax estimate on the dashboard multiplies the yearly profit (plus manual adjustments) with the marginal tax rate you store per tax year. It helps you put money aside – it is an estimate, not tax advice.
Customers and partners
A customer has a channel:
| Channel | Meaning |
|---|---|
direct |
Your own customer, invoiced directly. |
partner |
End customer of a partner agency – invoiced to the partner. |
own_project |
Your own projects, shown separately in the rating. |
internal |
Internal entries that are not real customers. |
and a status: active, paused, inactive or in_preparation. Customers can be archived once they have no recurring charges left.
Partners are agencies that resell your services. They receive one combined invoice for all of their end customers.
Recurring charges and fixed costs
Recurring charges are what your customers pay regularly – hosting, domains, maintenance contracts. Each charge has an interval (monthly, quarterly, half-yearly, yearly) and its next invoice date.
Fixed costs are what you pay regularly – servers, licences, subscriptions – with renewal dates. They can be assigned to a customer or shared. Expenses are one-off costs with a category and an optional receipt.
Resources document what runs for a customer: domains, containers, proxy hosts, databases and more.
The billing run
The billing run collects all recurring charges that are due until a date, creates one draft per recipient (per customer, or per partner for partner customers) and moves each charge to its next invoice date. Running it twice does not create duplicates. Use the dry run to preview the result.
Invoice lifecycle
to_issue → open → paid
(draft) (issued)- to_issue – a draft, freely editable and deletable.
- open – issued: number, date, PDF and a snapshot of all data are fixed. Can be sent by e-mail and reminded.
- paid – payment received.
Issued invoices are immutable. An open or paid invoice can only be cancelled: the cancellation is a new invoice with negative amounts that references the original. Invoice numbers are gapless per year and follow your pattern ({YYYY} year, {NNN} counter).
Customer rating
For every customer Annuva computes the recurring surplus per year: recurring charges minus domains and packages that are passed through, minus the customer's share of the server costs. By default the server costs are split equally among all customers with hosting (configurable in the settings).
Customers with a positive surplus are worth it; own projects and internal entries are shown separately.
Cash flow and plan year
The cash flow shows income and expenses per month with planned values from recurring charges and fixed costs, plus the cumulative balance. The plan year extends the yearly overview with what your current contracts will bring in and cost.
Files
Uploads (receipts, offers, profile pictures) and generated invoice PDFs are stored in the data folder under files/ and only delivered to users of the owning tenant.