X-Git-Url: http://wagnertech.de/gitweb/gitweb.cgi/mfinanz.git/blobdiff_plain/80cda5e67647bb46cacd3cbbfe5237b3de693b45..eab277a411:/doc/dokumentation.xml diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml index c0da68bc1..d7f04f410 100644 --- a/doc/dokumentation.xml +++ b/doc/dokumentation.xml @@ -106,8 +106,7 @@ ohne große Probleme auf den derzeit aktuellen verbreiteten Distributionen läuft. - Anfang 2019 sind das folgende Systeme, von denen bekannt ist, - dass kivitendo auf ihnen läuft: + Mitte 2020 (ab Version 3.5.6) empfehlen wir: @@ -115,19 +114,16 @@ - 8.0 "Jessie" + 10.0 "Buster" - 9.0 "Stretch" - - - 10.0 "Buster" + 11.0 "Bullseye" - 16.04 "Xenial Xerus" LTS und 18.04 "Bionic Beaver" LTS + 20.04 "Focal Fossa" LTS @@ -167,6 +163,10 @@ Archive::Zip + + CAM::PDF + + CGI @@ -354,11 +354,17 @@ XML::Writer + + XML::LibXML + + YAML::XS oder YAML + + Seit Version größer v3.5.6 sind die folgenden Pakete hinzugekommen: XML::LibXML, CAM::PDF Seit Version größer v3.5.3 sind die folgenden Pakete hinzugekommen: Exception::Class Seit Version größer v3.5.1 sind die folgenden Pakete hinzugekommen: Set::Infinite, @@ -436,12 +442,6 @@ Die Perl Pakete für Ubuntu befinden sich im "Universe" Repository. Falls dies nicht aktiv ist, kann dies mit folgendem Aufruf aktiviert werden: add-apt-repository universe - - Für ältere Ubuntu/Debians müßen einige Pakete per CPAN installiert werden. - Das geht bspw. für das benötige Paket HTML::Restrict mit: - apt-get install build-essential -cpan HTML::Restrict - @@ -555,7 +555,7 @@ cpan HTML::Restrict - aqbanking-tools Für das Parsen des MT940 Bankformats + aqbanking-tools Für das Parsen des MT940 Bankformats (Version 6 oder höher) poppler-utils 'pdfinfo' zum Erkennen der Seitenanzahl bei der PDF-Generierung @@ -645,24 +645,30 @@ git checkout `git tag -l | egrep -ve "(alpha|beta|rc)" | tail -1` $ git clone https://github.com/kivitendo/kivitendo-erp.git $ cd kivitendo-erp/ -$ git checkout release-3.4.1 # das ist der aktuelle release, den wir wollen -$ git add templates/fullhouse # das sind unsere druckvorlagen inkl. produktbilder -$ git commit -m "juhu tolle ändernungen" +$ git checkout release-3.4.1 # das ist ein alter release aus dem wir starten ... +$ git checkout -b meine_eigene_änderungen # unser lokaler branch - unabhängig von allen anderen +$ git add templates/mein_druck # das sind unsere druckvorlagen inkl. produktbilder +$ git commit -m "juhu tolle änderungen" + [meine_aenderungen 1d89e41] juhu tolle ändernungen 4 files changed, 380 insertions(+) - create mode 100644 templates/fullhouse/img/webdav/tesla.png - create mode 100644 templates/fullhouse/mahnung.tex - create mode 100644 templates/fullhouse/zahlungserinnerung_zwei.tex - create mode 100644 templates/fullhouse/zahlungserinnerung_zwei_invoice.tex + create mode 100644 templates/mein_druck/img/webdav/tesla.png + create mode 100644 templates/mein_druck/mahnung.tex + create mode 100644 templates/mein_druck/zahlungserinnerung_zwei.tex + create mode 100644 templates/mein_druck/zahlungserinnerung_zwei_invoice.tex # 5 Jahre später ... +# webserver abschalten! + +$ git checkout master +$ git pull # oder git fetch und danach ein stable release tag auswählen (s.o.) +$ git checkout meine_eigenen_änderungen +$ git rebase master -$ git fetch -$ git rebase --onto release-3.5.0 release-3.4.1 meine_aenderungen Zunächst wird der Branch zurückgespult, um Ihre Änderungen darauf neu anzuwenden ... -Wende an: juhu tolle ändernungen -$ service apache2 restart +Wende an: juhu tolle änderungen +$ service apache2 restart # webserver starten! @@ -1122,6 +1128,10 @@ Alias /kivitendo-erp/ /var/www/kivitendo-erp/ Apache 2.4.29 (Ubuntu 18.04 LTS) und mod_fcgid + + Apache 2.4.41 (Ubuntu 20.04 LTS) und mod_fcgid + + Als Perl Backend wird das Modul FCGI.pm @@ -1262,6 +1272,26 @@ Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1 + + Aktivierung von mod_rewrite/directory_match für git basierte Installationen + + + Aufgrund von aktuellen (Mitte 2020) Sicherheitswarnungen für git basierte Webanwendungen ist die mitausgelieferte .htaccess + restriktiver geworden und verhindert somit das Auslesen von git basierten Daten. + Für debian/ubuntu muss das Modul mod_rewrite einmalig so aktiviert werden: + a2enmod rewrite + Alternativ und für Installationen ohne Apache ist folgender Artikel interessant: + git-lücke. + Anstelle des dort beschriebenen DirectoryMatch für Apache2 würden wir etwas weitergehend auch noch das Verzeichnis config miteinbeziehen + sowie ferner auch die Möglichkeit nicht ausschließen, dass es in Unterverzeichnissen auch noch .git Repositories geben kann. + Die Empfehlung für Apache 2.4 wäre damit: + + <DirectoryMatch "(\.git|config)/"> + Require all denied + </DirectoryMatch> + + + Weitergehende Konfiguration @@ -4592,6 +4622,15 @@ digits_year: 4 + + natural_person + + + Flag "natürliche Person"; Siehe auch + + + + payment_description @@ -5372,7 +5411,7 @@ digits_year: 4 longdescription - Langtext + Langtext, vorbelegt mit dem Feld Bemerkungen der entsprechenden Ware @@ -6491,6 +6530,21 @@ Beschreibung: <%description%> Der Befehl <bullet> funktioniert momentan auch nur in Latex-Vorlagen. + + + Hinweise zur Anrede + + Das Flag "natürliche Person" + (natural_person) aus den Kunden- oder + Lieferantenstammdaten kann in den Druckvorlagen zusammen mit + dem Feld "Anrede" (greeting) z.B. dafür + verwendet werden, die Anrede zwischen einer allgemeinen und + einer persönlichen Anrede zu unterscheiden. + <%if natural_person%><%greeting%> <%name%><%else%>Sehr geehrte Damen und Herren<%end if%> + + + @@ -7298,6 +7352,148 @@ document_path = /var/local/kivi_documents url="https://developers.shopware.com/developers-guide/rest-api/">https://developers.shopware.com/developers-guide/rest-api/ + + ZUGFeRD Rechnungen + + Vorbedingung + + Für die Erstellung von ZUGFeRD PDFs wird TexLive2018 oder höher benötigt. + + + + Wer kein TexLive2018 oder höher installieren kann, kann eine lokale Umgebung nur für kivitendo wie folgt erzeugen: + + + 1. Download des offiziellen Installers von https://www.tug.org/texlive/quickinstall.html + + 2. Installer ausführen, Standard-Ort für Installation belassen, evtl. ein paar Pakete abwählen, installieren lassen + + 3. Ein kleine Script »run_pdflatex.sh« anlegen, das den PATH auf das Installationsverezichnis setzt und pdflatex ausführt: + + ------------------------------------------------------------ + #!/bin/bash + + export PATH=/usr/local/texlive/2020/bin/x86_64-linux:$PATH + hash -r + + exec pdflatex "$@" + ------------------------------------------------------------ + + 4. In config/kivitendo.conf den Parameter »latex« auf den Pfad zu »run_pdflatex.sh« setzen + + 5. Webserver neu starten + + + + + Übersicht + + Mit der Version 3.5.6 bietet kivitendo die Möglichkeit ZUGFeRD + Rechnungen zu erstellen, sowie auch ZUGFeRD Rechnungen direkt in + kivitendo einzulesen. + + Bei ZUGFeRD Rechnungen handelt es sich um eine PDF Datei in + der eine XML-Datei eingebettet ist. Der Aufbau der XML-Datei ist + standardisiert und ermöglicht so den Austausch zwischen + den verschiedenen Softwareprodukten. Kivitendo setzt mit der + Version 3.5.6 den ZUGFeRD 2.1 Standard um. + + Weiter Details zu ZUGFeRD sind unter diesem Link zu finden: + https://www.ferd-net.de/standards/was-ist-zugferd/index.html + + + + + + Erstellen von ZUGFeRD Rechnungen in Kivitendo + Für die Erstellung von ZUGFeRD Rechnungen bedarf es in + kivitendo zwei Dinge: + + + + + Die Erstellung muss in der Mandantenkonfiguration + aktiviert sein + + + + Beim mindestens einem Bankkonto muss die Option + „Nutzung von ZUGFeRD“ aktiviert sein + + + + + Mandantenkonfiguration + + Die Einstellung für die Erstellung von ZUGFeRD Rechnungen + erfolgt unter „System“ → „Mandatenkonfiguration“ → „Features“. + Im Abschnitt „Einkauf und Verkauf“ finden Sie die Einstellung + „Verkaufsrechnungen mit ZUGFeRD-Daten erzeugen“. + Hier besteht die Auswahl zwischen: + + + + ZUGFeRD-Rechnungen erzeugen + + + + ZUGFeRD-Rechnungen im Testmodus erzeugen + + + + Keine ZUGFeRD Rechnungen erzeugen + + + + + Rechnungen die als PDF erzeugt werden, werden je nach + Einstellung nun im ZUGFeRD Format ausgegeben. + + + + + Konfiguration der Bankkonten + + Unter „System → Bankonten“ muss bei mindestens einem + Bankkonto die Option „Nutzung mit ZUGFeRD“ auf „Ja“ gestellt + werden. + + + + + + + Einlesen von ZUGFeRD Rechnungen in Kivitendo + + Es lassen sich auch Rechnungen von Kreditoren, die im + ZUGFeRD Format erstellt wurden im Kivitendo importieren. + Hierfür müssen auch zwei Voraussetzungen erfüllt werden: + + + + + + Beim Lieferanten muss die Umsatzsteuer-ID und das + Bankkonto hinterlegt sein + + + + Für den Kreditoren muss eine Buchungsvorlage existieren. + + + + + Wenn diese Voraussetzungen erfüllt sind, kann die Rechnung + über „Finanzbuchhaltung“ → „ZUGFeRD Import“ über die „Durchsuchen“ + Schaltfläche ausgewählt werden und über die Schaltfläche „Import“ + eingeladen werden. Es öffnet sich daraufhin die Kreditorenbuchung. + Die auslesbaren Daten aus dem eingebetteten XML der PDF Datei + werden in der Kreditorenbuchung ergänzt. + + + + + @@ -8486,7 +8682,7 @@ Template/LaTeX Template/OpenDocument filenames - The last of which is very machine dependant. Remember that + The last of which is very machine dependent. Remember that a lot of characters are forbidden by some filesystems, for example MS Windows doesn't like ':' in its files where Linux doesn't mind that. If you want the files created with your