# Plugin Invoice Bundle

# Installation invoiceBundle

### Beschreibung:

Ein Plugin mit dem Gleichzeitig Stundenzettel generiert und Rechnungen erstellt werden können.  
Mich Persönlich interessieren nur die Stundenzettel

Da ich Kimai im Docker betreibe ist die Installation an dem Docker setup Angelehnt

### Vorrausetzungen:

```
apt install unzip
```

### Installation bei Kimai Docker:

In Das Verzeichnis Plugins die Zip Datei exhtrahieren. [InvoiceBundle-2.2.0.zip](https://wiki.hacker-net.de/attachments/94)  
Dazu per scp die Datei auf den Server kopieren, versionsnummer kann natürlich varieren

```
scp InvoiceBundle-2.2.0.zip root@zeit.example.tld:/root/kimai
```

Nun entpacken

```
cd root/kimai
unzip InvoiceBundle-2.2.0.zip
```

ls Ausgabe:

Nun haben Wir ein verzeichnis InvoiceBundle-2.2.0

```
ls
caddy_config  caddy_data  Caddyfile  certbot-etc  certbot-log  certbot-www  data  docker-compose.yml  InvoiceBundle-2.2.0  InvoiceBundle-2.2.0.zip  mariadb  plugins

```

Dieses umbenennen und verschieben

```
mv InvoiceBundle-2.2.0 plugins/InvoiceBundle
```

Nun muss im InvoiceBundle Verzeichnis der inhsalt so aussehen

ls Ausgabe:

```
ls
CHANGELOG.md  composer.json  Controller  DependencyInjection  EventSubscriber  Form  Invoice  InvoiceBundle.php  LICENSE  phpstan.neon	README.md  Resources  Tests

```

Nun nur noch den Cache leeren, dazu im kima Container einloggen

```
docker-compose exec kimai /opt/kimai/bin/console kimai:reload --env=prod
```

Ausgabe bei mir mit Fehler zu alt. :

```
root@debian-kimai-4gb-nbg1-2:~/kimai# docker-compose exec kimai /opt/kimai/bin/console kimai:reload --env=prod

In Kernel.php line 115:
                                                                                                                                                       
  Bundle "InvoiceBundle" requires minimum Kimai version 22700, but yours is lower: 2.18.0 (21800). Please update Kimai or use a lower Plugin version.
```

##### Also kimai aktualiseren

```
docker pull kimai/kimai2:apache
docker-compose up -d
docker-compose exec kimai /opt/kimai/bin/console kimai:reload --env=prod
docker-compose down
docker-compose up -d
docker-compose exec kimai /opt/kimai/bin/console assets:install
docker-compose exec kimai /opt/kimai/bin/console kimai:reload --env=prod

```

Nun Verzeichnis Berechtigungen setzten, Dazu in den Container einloggen

```
docker-compose exec kimai /bin/bash
```

Nun ausführen

```
cd /opt/kimai/var
chown -R :www-data .
chmod -R g+r .
chmod -R g+rw /opt/kimai/var/
```

#### Nun Einstellungen in Kimai:

Unter System -> Einstellungen

[![grafik.png](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/scaled-1680-/S8qQRVfeYIr7m8kG-grafik.png)](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/S8qQRVfeYIr7m8kG-grafik.png)

Nun runter scrollen bis Invoice  
Dort Rechungsnummerformat Sprache und template für den Stundenzettel Rechung einstellen

[![grafik.png](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/scaled-1680-/woBxMSuRoI0U9H6I-grafik.png)](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/woBxMSuRoI0U9H6I-grafik.png)

# Einrichtung Invoice Bundle

Beschreibung:  
  
nach dem das Plugin installiert.  
Das format eingerichtet ist.  
  
geht nun weiter

Eigene Firmenvorlage einrichten:  
  
Unter Rechnungen -> Rechungsvorlagen -> Auf erstellen klicken

[![grafik.png](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/scaled-1680-/cftkZde2ASxCprlg-grafik.png)](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/cftkZde2ASxCprlg-grafik.png)

Rechnung / Stundenzettel erstellen:

Nun Auf Rechnungen -> Rechnung erstellen klicken und Zeitraum Kunde Projekt auswählen. Will man alle projekte, das Projekt wieder entfernen.  
Exportier nein und auf suchen klicken

[![grafik.png](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/scaled-1680-/sQjFROhZ0n1VmZKw-grafik.png)](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/sQjFROhZ0n1VmZKw-grafik.png)

Nun erscheint eine Liste mit den gefunden Einträgen.  
Durch klick auf Speichern werden alle Eintrage auf eien Rechung / Leistungsnachweis gepackt.  
Möchte man das getrennt haben. Einfach nach mehren Datumsbereichen suchen und mehrere Rechungen abspeichern.  
Über die Buttons Vorschau kann man sich die Rechnung anschauen und speichern dann absenden.

[![grafik.png](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/scaled-1680-/440dNy2UOPhW5jlY-grafik.png)](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/440dNy2UOPhW5jlY-grafik.png)  
Nun kann Unter Rechnungen -> rechnungshistorie dier Stundenzettel downgeloaded werden

[![grafik.png](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/scaled-1680-/zGyArwvCXo6eyFNO-grafik.png)](https://wiki.hacker-net.de/uploads/images/gallery/2025-06/zGyArwvCXo6eyFNO-grafik.png)

Fertig