Invoice

Invoice
Käyttöliittymä	GTK4, CLI
Lisenssi	GPLv3
Lähdekoodi	codeberg.org/lahtis/invoice

Invoice eli lasku on avoimen lähdekoodin laskutusohjelma suomalaisille yhdistyksille ja pk-yrityksille. Ohjelma on suunniteltu yksinkertaiseksi, nopeaksi ja täysin käyttäjän omaan hallintaan perustuvaksi. Kaikki data säilytetään paikallisesti SQLite-tietokannassa, eikä pilvipalveluita tarvita.

Ominaisuudet

• Laskutus — asiakkaat, tuotteet ja ALV-erittely (Decimal + ROUND_HALF_UP)
• Viitenumerot — suomalainen (7-3-1), kansainvälinen (RF) ja vapaa viesti
• EPC QR-koodi — SEPA-virtuaalisiirto, skannattavissa verkkopankilla
• Laskujen tila — luonnos, lähetetty, maksettu, peruttu, hyvitetty
• Maksusuoritukset — kirjaa maksut, status päivittyy automaattisesti
• PDF-tulostus — WeasyPrint, A4 yhdelle sivulle
• SQLite — kaikki data omalla koneella, ei pilvipalveluita
• Lokitus — ~/.invoice/logs/lasku.log
• Kaksi käyttöliittymää* — graafinen GTK4-käyttöliittymä (`lasku gui`) ja komentoriviliittymä (`lasku`), mukaan lukien `--json`-tuloste skriptikäyttöön

Asennus

Vaatimukset

Ohjelma käyttää GTK4- ja WebKitGTK-käyttöliittymäkirjastoja sekä Pythonin PyGObject-sidoksia. PDF-tulostus hoidetaan WeasyPrint-kirjastolla.

1. Lataa ZIP

https://codeberg.org/lahtis/invoice/archive/main.zip

2. Asenna järjestelmäpaketit (Debian/Ubuntu)

sudo apt install python3-gi python3-venv \
                gir1.2-gtk-4.0 gir1.2-webkit-6.0 \
                libpango-1.0-0 libpangoft2-1.0-0 \
                libharfbuzz0b libcairo2 libgdk-pixbuf-2.0-0

3. Asenna

cd ~/invoice
python3 -m venv venv --system-site-packages
source venv/bin/activate
pip install .

4. Käynnistä graafinen käyttöliittymä

lasku gui

tai käytä komentoriviliittymää

lasku --help
lasku invoice --help

Komennon käyttöönotto ilman venv-activointia

pip install . asentaa lasku-komennon venvin sisään (venv/bin/lasku). Se löytyy vain, kun venv on aktivoitu. Jotta komento toimii mistä tahansa hakemistosta ilman aktivointia, luo symlinkki ~/.local/bin-hakemistoon:

ln -s ~/lasku/venv/bin/lasku ~/.local/bin/lasku