X-Git-Url: http://wagnertech.de/git?p=kivitendo-erp.git;a=blobdiff_plain;f=doc%2Fdokumentation.xml;fp=doc%2Fdokumentation.xml;h=1da27983b12cdbf1cc12e63ec918bc55776ea45f;hp=014bd63824cab0622a41aadd4eef5117b1d1fdf2;hb=b293ff8ad52fc76ba0c44783e3982418114d6b08;hpb=d4925a8b60f04674885e30d9316dc0263f8b9a84 diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml index 014bd6382..1da27983b 100644 --- a/doc/dokumentation.xml +++ b/doc/dokumentation.xml @@ -2,7 +2,7 @@ - kivitendo 3.5.8: Installation, Konfiguration, + <title>kivitendo 3.6.1: Installation, Konfiguration, Entwicklung @@ -261,6 +261,18 @@ Image::Info + + Imager + + + + Imager::QRCode + + + + IPC::Run + + JSON @@ -313,6 +325,10 @@ Regexp::IPv6 + + Rest::Client + + Rose::Object @@ -376,6 +392,11 @@ + Seit Version größer v3.6.0 sind die folgenden Pakete hinzugekommen: IPC::Run + + Seit Version größer v3.5.8 sind die folgenden Pakete hinzugekommen: Imager, Imager::QRCode +Rest::ClientTerm::ReadLine::Gnu + Seit Version größer v3.5.6 sind die folgenden Pakete hinzugekommen: Try::Tiny, Math::Round 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 @@ -442,15 +463,17 @@ libtext-iconv-perl liburi-perl libxml-writer-perl libyaml-perl \ libimage-info-perl libgd-gd2-perl libapache2-mod-fcgid \ libfile-copy-recursive-perl postgresql libalgorithm-checkdigits-perl \ - libcrypt-pbkdf2-perl git libcgi-pm-perl libtext-unidecode-perl libwww-perl\ - postgresql-contrib poppler-utils libhtml-restrict-perl\ - libdatetime-set-perl libset-infinite-perl liblist-utilsby-perl\ - libdaemon-generic-perl libfile-flock-perl libfile-slurp-perl\ + libcrypt-pbkdf2-perl git libcgi-pm-perl libtext-unidecode-perl libwww-perl \ + postgresql-contrib poppler-utils libhtml-restrict-perl \ + 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 libcam-pdf-perl \ - libxml-libxml-perl libtry-tiny-perl libmath-round-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). + libxml-libxml-perl libtry-tiny-perl libmath-round-perl \ + libimager-perl libimager-qrcode-perl librest-client-perl libipc-run-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 @@ -1319,7 +1342,7 @@ Alias /url/for/kivitendo-erp-fcgid/ /path/to/kivitendo-erp/ SSL-Konfigurations-Generator. - + Aktivierung von Apache2 modsecurity Aufgrund des OpenSource Charakters ist kivitendo nicht "out of the box" sicher. @@ -1330,7 +1353,7 @@ XSS und SQL-Injections verhindert werden. Als Idee hierfür sei dieser Blog-Eintrag genannt: Test Apache2 modsecurity for SQL Injection. - + @@ -1537,7 +1560,7 @@ systemctl enable kivitendo-task-server.service status berichtet, ob der Task-Server läuft. - yy + Der Task-Server wechselt beim Starten automatisch in das @@ -1550,7 +1573,7 @@ systemctl enable kivitendo-task-server.service so startet dieser nach Beendigung automatisch erneut. - + Exemplarische Konfiguration eines Hintergrund-Jobs, der die Jahreszahl in allen Nummernkreisen zum Jahreswechsel erhöht Hintergrund-Jobs werden über System -> Hintergrund-Jobs und Task-Server -> Aktuelle Hintergrund-Jobs anzeigen -> Aktions-Knopf 'erfassen' angelegt. @@ -1597,7 +1620,7 @@ multiplier Nummernkreis 2020 1000 -> 2020000 Wir gehen jetzt beispielhaft von einer letzten Rechnungsnummer von RE2019456 aus. Demnach sollte ab Januar 2020 die erste Nummer RE2020001 sein. Da der Task auch Präfixe berücksichtigt, kann dies mit folgenden JSON-kodierten Werten umgesetzt werden: -Daten:multiplier: 100 +Daten:multiplier: 100 digits_year: 4 @@ -2199,7 +2222,7 @@ digits_year: 4 texlive-collection-latexrecommended texlive-collection-langgerman \ texlive-collection-langenglish - kivitendo erwartet eine aktuelle TeX Live Umgebung, um PDF/A zu erzeugen. Aktuelle Distributionen von 2020 erfüllen diese. Überprüfbar ist dies mit dem Aufruf des installation_check.pl mit Parameter -l: scripts/installations_check.pl -l + kivitendo erwartet eine aktuelle TeX Live Umgebung, um PDF/A zu erzeugen. Aktuelle Distributionen von 2020 erfüllen diese. Überprüfbar ist dies mit dem Aufruf des installation_check.pl mit Parameter -l:scripts/installations_check.pl -l kivitendo bringt drei alternative Vorlagensätze mit: @@ -2215,7 +2238,7 @@ digits_year: 4 Der ehemalige Druckvorlagensatz "f-tex" wurde mit der Version - 3.6 entfernt, da er nicht mehr gepflegt wird. + 3.5.6 entfernt, da er nicht mehr gepflegt wird. @@ -2555,7 +2578,7 @@ digits_year: 4 sales_order_besr.odt - + Vorbereitungen im Adminbereich Damit beim Erstellen von Rechnungen und Aufträgen neben der @@ -2768,6 +2791,193 @@ digits_year: 4 + + + Schweizer QR-Rechnung mit OpenDocument Vorlagen + + + Übersicht + + Mit der Version 3.6.0 unterstützt Kivitendo die Erstellung von + Schweizer QR-Rechnungen gemäss Swiss + Payment Standards, Version 2.2. Implementiert sind hierbei die + Varianten: + + + + QR-IBAN mit + QR-Referenz + + + + IBAN ohne Referenz + + + + Der Vorlagensatz "rev-odt" enthält die Vorlage + invoice_qr.odt, welche für die Erstellung von + QR-Rechnungen vorgesehen ist. Damit diese verwendet werden kann muss + wie obenstehend beschrieben ein Drucker hinzugefügt werden (siehe + + ). Alternativ kann die Vorlage umbenannt werden in + invoice.odt. + + Die Vorlage invoice_qr.odt kann beliebig + angepasst werden. Zwingend muss diese jedoch das QR-Code Platzhalter + Bild, als eingebettetes Bild, enthalten. Da dieses beim + Ausdrucken/Erzeugen der Rechnung durch das neu generierte QR-Code + Bild ersetzt wird. + + + + Einstellungen + + + Mandantenkonfiguration + + Unter System → Mandantenkonfiguration → + Features. Im Abschnitt Einkauf und + Verkauf, beim Punkt Verkaufsrechnungen mit + Schweizer QR-Rechnung erzeugen, die gewünschte Variante + wählen. + + + + Konfiguration der Bankkonten + + Unter System → Bankkonten muss bei + mindestens einem Bankkonto die Option Nutzung mit + Schweizer QR-Rechnung auf Ja gestellt werden. + + + Für die Variante QR-IBAN mit + QR-Referenz muss dieses Konto unter IBAN eine gültige + QR-IBAN Nummer enthalten. Diese + unterscheidet sich von der regulären IBAN. + + Zusätzlich muss eine gültige Bankkonto + Identifikationsnummer angegeben werden + (6-stellig). + + Diese werden von der jeweiligen Bank vergeben. + + + Sind mehrere Konten ausgewählt wird das erste + verwendet. + + + + Rechnungen ohne Betrag + + Für Rechnungen ohne Betrag (z.B. Spenden) kann, in der + jeweiligen Rechnung, die Checkbox QR-Rechnung ohne + Betrag aktiviert werden. Diese Checkbox erscheint nur, + wenn QR-Rechnungen in der Mandantenkonfiguration aktiviert sind + (variante ausgewählt). + + Dies wirkt sich lediglich auf den erzeugten QR-Code aus. Die + Vorlage muss separat angepasst und ausgewählt werden. + + + + + Adressdaten + + Die Adressdaten zum Zahlungsempfänger werden aus der + Mandantenkonfiguration entnommen. Unter System → + Mandantenkonfiguration → Verschiedenes, Abschnitt + Firmenname und -adresse. + + Die Adressdaten zum Zahlungspflichtigen stammen aus den + Kundendaten der jeweiligen Rechnung. + + Die Adressen müssen inklusive Land angegeben werden. Akzeptiert + werden Ländername oder Ländercode, also z.B. "Schweiz" oder "CH". + + + Diese können in der Vorlage mit den jeweiligen Variablen + eingetragen werden. Siehe auch: + + Der erzeugte QR-Code verwendet Adress-Typ "K" (Kombinierte + Adressfelder, 2 Zeilen). + + + + Referenznummer + + Die Referenznummer wird in Kivitendo erzeugt und setzt sich + wiefolgt zusammen: + + + + Bankkonto Identifikationsnummer (6-stellig) + + + + Kundennummer (6-stellig, mit führenden Nullen + aufgefüllt) + + + + Auftragsnummer (7-stellig, mit führenden Nullen + aufgefüllt) + + + + Rechnungsnummer (7-stellig, mit führenden Nullen + aufgefüllt) + + + + Prüfziffer (1-stellig, berechnet mittels modulo 10, + rekursiv) + + + + Es sind lediglich Ziffern erlaubt. Allfällige Prefixe mit + Buchstaben werden entfernt und fehlende Stellen werden mit führenden + Nullen aufgefüllt. + + + + Zusätzliche Variablen für Vorlage + + Zusätzlich zu den in der Vorlage standardmässig verfügbaren + Variablen (siehe ), + werden die folgenden Variablen erzeugt: + + + + ref_number_formatted + + + Referenznummer formatiert mit Leerzeichen, z.B.: 21 00000 + 00003 13947 14300 09017 + + + + + iban_formatted + + + IBAN formatiert mit Leerzeichen + + + + + amount_formatted + + + Betrag formatiert mit Tausendertrennzeichen Leerschlag, + z.B.: 1 005.55 + + + + + @@ -4895,6 +5105,32 @@ digits_year: 4 + + + Informationen über abweichende Rechnungsadressen (nur Verkaufsbelege) + + + Abweichende Rechnungsadressen gibt es nur in Verkaufsbelegen. Die entsprechenden Variablen sind nur dann mit Inhalt gefüllt, + wenn im Beleg eine abweichende Rechnungsadresse ausgewählt wurde. Ob eine Adresse überhaupt ausgewählt wurde, kann über die + Variable billing_address_id getestet werden, die die Datenbank-ID der abweichenden Rechnungsadresse enthält, + wenn eine ausgewählt ist. + + + + Die Variablennamen starten alle mit dem Präfix billing_address_ und heißen anschließend so, wie ihre Pendants + aus der Standard-Rechnungsadresse des Kunden. Beispiel: die Postleitzahl, die in der normalen Rechnungsadresse in + zipcode steht, steht für die abweichende Rechnungsadresse in billing_address_zipcode. + + + + Die folgenden Variablen stehen so zur Verfügung: billing_address_name, + billing_address_department_1, billing_address_department_2, + billing_address_contact, billing_address_street, + billing_address_zipcode, billing_address_city, billing_address_country, + billing_address_gln, billing_address_email, billing_address_phone und + billing_address_fax. + + @@ -7189,7 +7425,7 @@ document_path = /var/local/kivi_documents 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 + https://www.ferd-net.de/standards/was-ist-zugferd/index.html