Skip to content
RhinvoiceDocs

What's new in Rhinvoice

1 min read

This page lists what every version of Rhinvoice brought, newest first. Features added after the first public version are marked “Since version …” in the docs and lead here. How to update: Updating.

Version 0.5.6

Added

  • Legal notice and privacy notice on rhinvoice.com, linked from the website, the docs and the login page of the public demo. Installations of your own do not show them.

Version 0.5.5

Added

  • The logo on the login page leads to rhinvoice.com, and the strip on every page of the public demo links it too.

Version 0.5.4

Added

  • The user documentation at rhinvoice.com/docs, in English and German: getting started, the rules of each country, invoices, moving over from another program, running it, questions, and these release notes. Features newer than the first public release are marked "Since version …".
  • How more company countries come in: one country profile per country, with the Netherlands as the example (docs and landing page).

Changed

  • The interface links its guides (backup, installation, imports) to the docs in its own language instead of Markdown files on GitHub.

Version 0.5.3

Fixed

  • PDF footer: a long commercial register entry ran past the page edge. It now takes one line per comma-separated part ("Amtsgericht Kempten, HRB 12345"), and the label "Commercial register" is left out when the entry already names it ("Handelsregister des Kantons Zürich, …").

Version 0.5.2

Fixed

  • A session that ends while the app is open (expired, logged out elsewhere, or the hourly reset of the demo) now leads straight to the login, which says why. Before, pages showed "E-mail address or password is incorrect". The API answers such requests with the codes session_expired and not_logged_in instead of authentication_failed, which is now kept for wrong credentials.

Version 0.5.1

Changed

  • The public demo takes no uploads any more: importing customers, articles and invoices is switched off there, and the import page says how to try it on an own installation. Request bodies in the demo may have at most 2 MB.

Version 0.5.0

Added

  • Old invoices come over from the program used before, with their original PDFs: a list (CSV or Excel) and the folder of PDF files, single files or ZIP files. Each becomes a locked invoice with its number, date, customer and amounts, and its PDF as the invoice; reminders, corrections and copies of the same number are kept as attachments. Customers are found by number or name, unknown ones are created and archived. Imported invoices appear in lists (marked "Taken over"), search, the customer's history and the revenue, and open ones can be paid. The invoice sequence continues behind the imported numbers. See docs/import.md and ADR 0019.
  • An imported invoice without PDF takes its PDF later on its page; further files become attachments.
  • Uninstalling: how to remove the containers, data and images (docs/install.md), and the installation's name in .env (COMPOSE_PROJECT_NAME).

Version 0.4.3

Added

  • Customers keep the date they became customers: the import reads it from a column such as "Kunde seit", "Angelegt am" or "Created" (14.03.2019, 2019-03-14, also with a time), also when updating customers already imported. The customer page shows it next to the number.
  • The Swiss VAT rates of 2011 to 2017 (8 / 2.5 / 3.8 %): article lists of older programs with "8" as their rate import, so do documents with a supply in those years.
  • Article units such as "monatlich", "pro Monat", "jährlich" or "wöchentlich".

Version 0.4.2

Changed

  • A new logo: an invoice page with the Rhine and its four countries. It is the favicon and the home-screen icon on phones, and appears in the app, on rhinvoice.com and in the previews.

Version 0.4.1

Changed

  • The public demo takes imports of at most 200 KB and 200 rows, so it cannot be filled with junk; the import page says so. Installations of your own keep their limits (5 MB, 10'000 rows).

Version 0.4.0

Added

  • PDF output through Gotenberg with a live paper preview in the editor; issued documents keep their first PDF (SHA-256).

  • Swiss QR-bill (QR reference or creditor reference) for Switzerland and Liechtenstein, EPC QR code (GiroCode) for Germany and Austria and for euro invoices from Switzerland and Liechtenstein to customers in the EEA; mandatory invoice details checked before issuing.

  • Print templates (classic, modern, plain) with logo position and size, font, sender line, contact details, position numbers and all bank accounts in the footer; issued documents keep the layout of the day they were issued.

  • Payment reminders and dunning letters in three levels with new deadlines, optional fees and texts per language; the PDF asks for the open amount plus the fee.

  • Import of customers and articles from CSV, XLSX and XLS with column mapping, test run, duplicate handling and saved templates.

  • Backups with restic in their own container: daily and after issuing, to S3, SFTP, a local folder or Dropbox, Google Drive and others through rclone; state on the dashboard and in the settings, restore with make restore.

  • First-start wizard (country, company) and a setup checklist on the dashboard.

  • A hint in the editor when an EU business customer lacks the VAT number for reverse charge.

  • E-invoices: every issued invoice and cancellation embeds a ZUGFeRD / Factur-X invoice (EN 16931) in its PDF, for all countries and switchable in the print template; XRechnung 3.0 download for German authorities; the invoice tells what is missing for either. Validated in CI with the KoSIT validator and Mustang.

  • Demo data for a test installation: rhinvoice demo (or make demo) adds customers, articles and about 21 months of invoices, payments and quotes.

  • The app refuses to start (and to migrate) on a database set up by a newer version, with a message that says what to do, instead of failing later on single actions.

  • Recurring invoices: plans that write an invoice every month, quarter, half-year or year, as a draft, issued, or issued and sent by e-mail, with the covered period as service period. The web server writes them by itself (each period once, missed periods caught up); rhinvoice recurring does it at once. An issued invoice can be made recurring.

  • Sending by e-mail: invoices, quotes, credit notes and reminders go out from Rhinvoice with their PDF (and the XRechnung on request) through the company's own mail server (SMTP), set up with a test mail under Settings → E-mail. Templates per kind and language with placeholders (new: {firma}); every mail is noted in the document's history. A refused mail shows the server's answer.

  • Goods and services: articles and positions say what they supply. Goods to EU businesses with a VAT number are tax-free intra-Community supplies (e-invoice category K with the place of delivery), goods leaving the VAT area are tax-free export deliveries, also to private customers; each with its own notice, also on mixed invoices. The editor reminds of the proof of export or arrival.

  • A language menu at the top right (also on the login page): Deutsch (Schweiz, Deutschland, Österreich) or English, kept per browser. Version, licence and links under "About Rhinvoice" in the account menu and at the foot of the sidebar.

  • Country profiles: everything that differs between Switzerland, Liechtenstein, Germany and Austria (VAT law, rates, notices, mandatory details, payment codes, terms) lives in one profile per country, which the interface reads from the API. Adding a country is described in docs/adding-a-country.md.

  • Demo mode (RHINVOICE_DEMO) for a public demo: the data is reset every hour, the login page logs in with one click, what would lock visitors out or send mail is refused, and logins and changes are rate-limited. deploy/demo/ runs Switzerland, Germany and Austria side by side behind Caddy, isolated from the internet.

  • At most two password checks (argon2, 64 MiB each) run at the same time; a burst of logins waits instead of exhausting the memory.

Fixed

  • The overview kept an empty gap at the top once the setup checklist was hidden.
  • The import read a rate of 13 % as Austria's 10 % rate; rates are now read from the company's country (13 % is Austria's own rate, 16 % and 5 % German ones of 2020). A rate the country never had (e.g. 19 % for a Swiss company) is reported instead of being taken as the standard rate.
  • German documents print "Ihre USt-IdNr." instead of "Ihre UID"; the tax name is "USt." everywhere.
  • The first-start wizard shows the VAT rates of the day instead of fixed text.
  • The 5-centime rounding and the QR-IBAN are only offered where they apply (Switzerland, Liechtenstein).
  • Paying or cancelling invoices issued by an earlier version failed with a conflict.
  • Cancellations without VAT wrote a tax total of "-0.00" into their e-invoice, which Mustang rejects (BR-CO-14).
  • The article list's button said "Neuer Kunde".

Changed

  • Rhinvoice is licensed under the GNU Affero General Public License v3.0 or later; contributions come under a contributor licence agreement. The project lives at github.com/rhinvoice/rhinvoice and its images at ghcr.io/rhinvoice/rhinvoice.
  • The overview is a cockpit: revenue this year against last year with a trend line, open and overdue amounts, open quotes with the acceptance rate, open invoices by age, the longest overdue ones, the best customers, the payments to expect per week and the latest activity, per currency.
  • The architecture decision records are written in English.
  • All PDFs are PDF/A-3b, made from Chromium's output without changing pages, fonts or tags.

Version 0.3.0

Added

  • Quotes, invoices and cancellation invoices: create, edit, issue, mark as paid (also partially), remove payments, cancel, duplicate, turn a quote into an invoice.
  • Calculation with line and document discounts, net or gross prices, VAT per rate and Swiss 5-cent rounding; dated VAT rates for Switzerland, Liechtenstein, Germany and Austria; automatic tax treatment (domestic, reverse charge, export, small business, exempt) with a logged manual override.
  • Numbers are assigned when issuing, without gaps; issued documents are immutable (also enforced by the database), corrections only by cancellation.
  • Invoice and quote lists with views (open, overdue, paid …) and full-text search; dashboard with open, overdue and paid amounts, monthly revenue and recent activity.
  • Customers and articles with search, archive and document history; company, logo, bank accounts (IBAN/QR-IBAN) and number sequences in the settings.
  • Login with optional two-factor authentication, keyboard shortcuts, command palette, light and dark mode, German (CH/DE/AT) and English.

Not yet included

  • PDF output, Swiss QR-bill and EPC-QR, e-invoices, import, backup, onboarding assistant.

Questions

Section titled “Questions”

How often are there new versions of Rhinvoice?

Rhinvoice is in beta (0.x) and is released often, sometimes several times a week. Every version is listed with its date on this page and on GitHub.

Which version do I have?

The version is shown in the app at the bottom of the sidebar and in the "About Rhinvoice" window, for example "v0.5.6". The login page shows it below the form.

How do I update to the newest version?

Set the new version in .env and run docker compose pull and docker compose up -d. The database is updated automatically at the start. Make a backup first.