X-Git-Url: http://wagnertech.de/gitweb/gitweb.cgi/mfinanz.git/blobdiff_plain/7c1afbcf2ae4e8246e405af918160da9f4a836c2..eab277a411:/doc/dokumentation.xml diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml index 14d809bd5..d7f04f410 100644 --- a/doc/dokumentation.xml +++ b/doc/dokumentation.xml @@ -13,7 +13,7 @@ im Community-Forum: https://forum.kivitendo.de:32443 + url="https://forum.kivitendo.de">https://forum.kivitendo.de @@ -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, @@ -428,19 +434,14 @@ libdatetime-set-perl libset-infinite-perl liblist-utilsby-perl\ libdaemon-generic-perl libfile-flock-perl libfile-slurp-perl\ libfile-mimeinfo-perl libpbkdf2-tiny-perl libregexp-ipv6-perl \ - libdatetime-event-cron-perl libexception-class-perl + libdatetime-event-cron-perl libexception-class-perl libcam-pdf-perl \ + libxml-libxml-perl Sollten Pakete nicht zu Verfügung stehen, so können diese auch mittels CPAN installiert werden. Ferner muss für Ubuntu das Repository "Universe" aktiv sein (s.a. Anmerkungen). 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 - @@ -554,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 @@ -644,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! @@ -1121,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 @@ -1261,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 @@ -4591,6 +4622,15 @@ digits_year: 4 + + natural_person + + + Flag "natürliche Person"; Siehe auch + + + + payment_description @@ -5371,7 +5411,7 @@ digits_year: 4 longdescription - Langtext + Langtext, vorbelegt mit dem Feld Bemerkungen der entsprechenden Ware @@ -6490,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%> + + + @@ -7297,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. + + + + + @@ -8485,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