2.14. SKR04 19% Umstellung fÃ¼r innergemeinschaftlichen Erwerb

2.14. SKR04 19% Umstellung fÃ¼r innergemeinschaftlichen Erwerb
ZurÃ¼ck	Kapitel 2. Installation und Grundkonfiguration	Weiter

2.14. Drucken mit kivitendo
ZurÃ¼ck	Kapitel 2. Installation und Grundkonfiguration	Weiter

2.14. Drucken mit kivitendo

Das Drucksystem von kivitendo benutzt von Haus aus LaTeX-Vorlagen. + Um drucken zu kÃ¶nnen, braucht der Server ein geeignetes LaTeX System. Am + einfachsten ist dazu eine texlive Installation. Unter + debianoiden Betriebssystemen installiert man die Pakete mit:

apt install texlive-base-bin texlive-latex-recommended texlive-fonts-recommended \
+  texlive-latex-extra texlive-lang-german ghostscript latexmk

FÃ¼r Fedora benÃ¶tigen Sie die folgenden Pakete:

dnf install texlive-collection-latex texlive-collection-latexextra \
+  texlive-collection-latexrecommended texlive-collection-langgerman \
+  texlive-collection-langenglish

FÃ¼r openSUSE benÃ¶tigen Sie die folgenden Pakete:

zypper install texlive-collection-latex texlive-collection-latexextra \
+  texlive-collection-latexrecommended texlive-collection-langgerman \
+  texlive-collection-langenglish

Anmerkung

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:

RB
marei
rev-odt

Der ehemalige Druckvorlagensatz "f-tex" wurde mit der Version + 3.5.6 entfernt, da er nicht mehr gepflegt wird.

2.14.1. Vorlagenverzeichnis anlegen

Es lÃ¤sst sich ein initialer Vorlagensatz erstellen. Die + LaTeX-System-AbhÃ¤ngigkeiten hierfÃ¼r kann man prÃ¼fen mit:

./scripts/installation_check.pl -lv

Der Angemeldete Benutzer muss in einer Gruppe sein, die Ã¼ber das + Recht "Konfiguration -> Mandantenverwaltung" verfÃ¼gt. Siehe auch + Abschnitt 2.11.4, âGruppen anlegenâ.

Im Userbereich lÃ¤sst sich unter: "System + -> Mandantenverwaltung -> + Verschiedenes" die Option "Neue + Druckvorlagen aus Vorlagensatz erstellen" auswÃ¤hlen.

+ Vorlagen auswÃ¤hlen: WÃ¤hlen Sie hier den + Vorlagensatz aus, der kopiert werden soll + (RB, marei oder + odt-rev.)
+ Neuer Name: Der Verzeichnisname fÃ¼r den + neuen Vorlagensatz. Dieser kann im Rahmen der Ã¼blichen Bedingungen + fÃ¼r Verzeichnisnamen frei gewÃ¤hlt werden.

Nach dem Speichern wird das Vorlagenverzeichnis angelegt und ist + fÃ¼r den aktuellen Mandanten ausgewÃ¤hlt. Der gleiche Vorlagensatz kann, + wenn er mal angelegt ist, bei mehreren Mandanten verwendet werden. + Eventuell mÃ¼ssen Anpassungen (Logo, Erscheinungsbild, etc) noch + vorgenommen werden. Den Ordner findet man im Dateisystem unter + ./templates/[Neuer Name] +

2.14.2. Der Druckvorlagensatz marei

	Anmerkung
	Die aktuelle Dokumentation inkl. dem Foliensatz vom kivi-Treffen im August 2023 befindet sich hier: + https://peitex.de/materialien/2023-08-04_kivitendo/ + +

2.14.2.1. Quickstart â Wo kann was angepasst werden?

	Anmerkung
	In keinem Fall sollten Dateien mit der Endung `.cls` oder `.sty` geÃ¤ndert werden. Durch Ãnderungen an diesen Dateien verhindert man Updates auf neuer Versionen. + Zwar kopiert kivitendo die Datei und bearbeitet diese beim Update nicht. Allerdings sind sÃ¤mtliche Ãnderungen Ã¼ber die Konfigurationsdateien mÃ¶glich und erhÃ¶hen die Wartbarkeit.

Pfad zu Angaben Ã¼ber Mandant*innen (default: firma)
Logo/Briefpapier, falls fÃ¼r alle Mandant*innen in gleicher Struktur. Sonst in der ident.tex.
Layout der Kopf/FuÃzeile
innerhalb dieser Datei werden auch die folgenden Dateien geladen:
+ firma/ident.tex Mandant*innenspezifische Konfiguration, Adressdaten
+ firma/$wÃ¤hrungskÃ¼rzel_account.tex +

+ insettings.tex :

Sprache/Ãbersetzungen.\\Es muss mindestens eine Sprache angelegt werden!

+        \item[deutsch.tex] Textschnipsel fÃ¼r Deutsch\\
+                              DafÃ¼r eine Sprache mit VorlagenkÃ¼rzel DE anlegen
+        \item[english.tex] Textschnipsel fÃ¼r Englisch\\
+                              DafÃ¼r eine Sprache mit VorlagenkÃ¼rzel EN anlegen
+

Alle dokumententypspezifischen Einstellungen mÃ¼ssen in der jeweiligen Template-Datei modifiziert werden.

2.14.2.2. Aufbau

Die Grundstruktur besteht je Dokumententyp aus einer Basisdatei und verschiedenen Setup-Dateien.

Die Basis wurde so Ã¼berarbeitet, dass Dokumente nun generell auf + der Dokumentenklasse scrartcl.cls basieren und + das Paket kiviletter.sty benutzen.

Mandant*innenspezifische Konfiguration findet sich in der Datei insettings.tex und + dem Ordner eines spezifischen Mandant*innen (default=*firma/*).

2.14.2.3. Mandant*innen / Firma

Um gleiche Vorlagen fÃ¼r verschiedene Firmen verwenden zu kÃ¶nnen, wird je + nach dem Wert der Kivitendo-Variablen \kivivar{kivicompany} ein + Firmenverzeichnis ausgewÃ¤hlt (siehe insettings.tex), in dem Briefkopf, + IdentitÃ¤ten und WÃ¤hrungs-/Kontoeinstellungen hinterlegt sind. + \kivivar{kivicompany} enthÃ¤lt den Namen des verwendeten Mandant*innendaten. + Ist kein Firmenname eingetragen, so wird das + generische Unterverzeichnis *firma* verwendet.

2.14.2.4. IdentitÃ¤ten

In jedem Firmen-Unterverzeichnis soll eine Datei ident.tex + vorhanden sein, die mit |\newcommand| Werte fÃ¼r |\telefon|, |\fax|, + |\firma|, |\strasse|, |\ort|, |\ustid|, |\email| und |\homepage| definiert.

2.14.2.5. WÃ¤hrungen/Konten

Als Fallback (falls kivitendo keine WÃ¤hrung an das Druckvorlagen-System Ã¼bergibt) + ist Euro eingestellt. Dies lÃ¤sst sich in der insettings.tex Ã¼ber das optionale Argument + von |\setupCurrencyConfig| anpassen, z.B.

+    \setupCurrencyConfig[chf]{\identpath}{\lxcurrency}

fÃ¼r Schweizer Franken als StandardwÃ¤hrung.

2.14.2.6. Briefbogen/Logos

Eine Hintergrundgrafik oder ein Logo kann in AbhÃ¤ngigkeit vom + Medium (z.B. nur beim Verschicken mit E-Mail) eingebunden + werden.

Desweiteren sind (auskommentierte) Beispiele enthalten fÃ¼r eine + Grafik als Briefkopf, nur ein Logo, oder ein komplettes A4-PDF + als Briefpapier.

Absolute Positionierung innerhalb des Brief-Layouts ist Ã¼ber die entsprechende Dokumentation des scrlayer-Paketes mÃ¶glich. + Da die Voreinstellungen bereits einige SonderfÃ¤lle automatisch berÃ¼cksichtigen ist mit den Anpassungen Vorsicht geboten. + SÃ¤mtliche Einstellungen sollten jedoch auÃerhalb der *.sty-Dateien vorgenommen werden. + Anpassungen der insettings.tex betreffen hierbei alle Mandant*innen. Spezifischere Einstellungen sind Ã¼ber die zugehÃ¶rige Konfigurationsdatei (ident.tex) mÃ¶glich. + In diesem Fall kann zum Ende der insettings eine weitere Konfigurationsdatei Ã¼ber die Verwendung von |\identpath| geladen werden. Ein Beispiel ist in der insettings.tex enthalten.

2.14.2.7. FuÃzeile

Die Tabelle im FuÃ verwendet die Angaben aus firma/ident.tex und + *firma/\_account.tex. Ihre Struktur wird in der insettings.tex definiert. + Sie kann anschlieÃend auch Mandant*innenspezifisch Ã¼berschrieben werden.

2.14.2.8. Seitenstil/Basislayout

Das Seitenlayout wird Ã¼ber \pck{scrlayer-scrpage} bestimmt. Die ausfÃ¼hrliche Dokumentation findet sich in \cite{scrguide}. + Es existieren in der Datei insettings.tex einige Hinweise zu den Anpassungen. Die Basiskonfiguration ist ebenfalls dort eingetragen.

Neben den in Abschnitt \ref{sec:options} beschriebenen Optionen zum Abschalten der FuÃzeile kann + der Inhalt der FuÃzeile Ã¼ber die \pck{scrlayer-scrpage} Makros, wie

+      \cfoot[|\meta{Inhalt auf der ersten Briefseite}|]{|\meta{Inhalt auf folgenden Briefseiten}|}

geÃ¤ndert werden.

Die Kopfzeile unterscheidet sich von Dokumententyp zu Dokumententyp leicht, da diese Ã¼ber Datenbankvariablen befÃ¼llt wird. + HierfÃ¼r wird das Makro |\ourhead| in der insettings.tex definiert.

+      \DescribeMacro{\ourhead}\marg{Bezeichner}\marg{Eintrag}\marg{Titel}\marg{Nummer}\marg{Datum}

Diese Definition kann ebenfalls Ã¼ber die insettings.tex angepasst oder auch nachtrÃ¤glich Ã¼berschrieben werden:

+      \newcommand{\ourhead}[5] {%
+        \chead{%
+          \makebox[\textwidth]{%
+            \Ifstr{#1}{}{}{#1: #2 \hspace{0.7cm}}%
+            #3%
+            \Ifstr{#4}{}{}{~\nr: #4}%
+            \Ifstr{#5}{}{}{\vom ~ #5}%
+            \hspace{0.7cm} - \seite ~ \thepage/\letterlastpage  ~-%
+          }%
+        }%
+      }
+

In der Standard-Einstellung sieht eine Kopfzeile mit obigen Aufruf dann folgendermaÃen aus:

+      \newcommand{\ourhead}[5] {%
+          \makebox[\textwidth]{%
+            \Ifstr{#1}{}{}{#1: #2 \hspace{0.7cm}}%
+            #3%
+            \Ifstr{#4}{}{}{~\nr: #4}%
+            \Ifstr{#5}{}{}{\vom ~ #5}%
+            \hspace{0.7cm} - \seite ~ \thepage/\letterlastpage  ~-%
+          }%
+      }
+
+      \begingroup
+      \def\letterlastpage{50}
+
+      \ourhead{arg1}{arg2}{arg3}{arg4}{arg5}
+
+      \smallskip
+      Erzeugt mit dem Aufruf
+      \ourhead{arg1}{arg2}{arg3}{arg4}{arg5}
+      \endgroup

2.14.2.9. AbsenderergÃ¤nzung

Die AbsenderergÃ¤nzung wird Ã¼ber die Variable |location| in der |kiviletter.sty| folgendermaÃen belegt:

+      \setkomavar{location}{
+        \Ifkomavarempty{transaction}{}{{
+              \usekomafont{transaction}
+              \usekomavar{transaction}
+            }
+        }
+        \par
+        \medskip
+        \parbox{\useplength{locwidth}}{
+          \locationentry{date}
+          \locationentry{myref}
+          \locationentry{customer}
+          \locationentry{yourref}
+          \locationentry{delivery}
+          \locationentry{quote}
+          \locationentry{orderID}
+          \locationentry{projectID}
+          \locationentry{taxpoint}
+          \locationentry[\ansprechpartner]{fromname}
+          \locationentry{fromphone}
+          \locationentry*{fromemail}
+        }
+      }

Um die Reihenfolge der Variablenausgabe zu verÃ¤ndern, kann diese Definition als Basis in + die insettings.tex oder ident.tex (Falls nur fÃ¼r eine Firma) kopiert und dort entsprechend modifiziert werden.

Das Vorgehen geht fÃ¼r alle vorbelegten Variablen analog.

2.14.2.10. Allgemeine TeXnische Hinweise

2.14.2.10.1. Ãnderung der Basisschriftart

\LaTeX{} kann grundsÃ¤tzlich beliebige Schriftarten verwenden. HierfÃ¼r sollte allerdings immer darauf geachtet werden, + dass die Lizenz der Schriftart das einbetten von Glyphen erlaubt. Dies liegt in der Verantwortung der Anwender*innen. + DarÃ¼ber hinaus ist wichtig, welches Kompilierungsprogramm verwendet werden muss. Um TrueType oder OpenType Schriftarten + zu nutzen sollte |lualatex| verwendet werden. Bei Type1 Schriftarten, die speziell fÃ¼r \LaTeX{} installiert wurden, ist pdfLaTeX mÃ¶glich. + Da man heutzutage nur noch moderne Schriftformate Verwenden sollte, wird hier lediglich die Variante fÃ¼r |lualatex| aufgelistet.

Die Konfiguration lÃ¤uft hierbei Ã¼ber das \pck{fontspec} Paket (Doku siehe \cite{fontspec}). + Dann hÃ¤ngt es davon ab, ob die Basisschriftart eine Serifenschriftart ist oder nicht. + In jedem Fall wird die Ãnderung entweder in der insettings.tex, sofern sie fÃ¼r alle + Mandant*innen gelten soll oder in der Mantant*innenspezifischen Konfigurationsdatei gsesetzt.

2.14.2.10.1.1. Ãnderung, falls es ein Schriftpaket gibt

Wenn mÃ¶glich sollte die Schriftart Ã¼ber ein entsprechendes Konfigurationspaket gesetzt werden. + Ob ein solches existiert kann man sehr leicht Ã¼ber eine Suche nach dem Namen unter \url{ctan.org} herausfinden.

2.14.2.10.1.2. Ãnderung der Basisschriftart auf eine Schriftart mit Serifen

+      \setmainfont{|\meta{Name der Schriftart, z.B. SourceSerifPro}|}

2.14.2.10.1.3. Ãnderung der Basisschriftart auf eine Schriftart ohne Serifen

+      \setsansfont{|\meta{Name der Schriftart, z.B. SourceSansPro}|}
+      \renewcommand*{\familydefault}{\sfdefault}

2.14.2.10.2. Unterscheidungen durch String-Vergleich

+    \Ifstr{\lxmedia}{printer}{Falls gedruckt werden soll} {sonst}

2.14.3. Der Druckvorlagensatz RB

Hierbei handelt es sich um einen vollstÃ¤ndigen LaTeX + Dokumentensatz mit alternativem Design. Die odt oder html-Varianten + sind nicht gepflegt.

Die konzeptionelle Idee der Vorlagen wird hier + auf Folie 5 bis 10 vorgestellt. Informationen zur Anpassung an die + eigenen Firmendaten finden sich in der Datei Readme.tex im + Vorlagenverzeichnis.

Eine kurze Ãbersicht der Features:

MehrsprachenfÃ¤hig, mit Deutscher und Englischer + Ãbersetzung
Zentrale Konfigurationsdateien, die fÃ¼r alle Belege benutzt + werden, z.B. fÃ¼r Kopf- und FuÃzeilen, und Infos wie + Bankdaten
mehrere vordefinierte Varianten fÃ¼r + Logos/Hintergrundbilder
BerÃ¼cksichtigung fÃ¼r Steuerzonen "EU mit USt-ID Nummer" oder + "AuÃerhalb EU"

2.14.4. Der Druckvorlagensatz rev-odt

Hierbei handelt es sich um einen Dokumentensatz der mit + odt-Vorlagen erstellt wurde. Es gibt in dem Verzeichnis eine + Readme-Datei, die eventuell aktueller als die Dokumentation hier ist. + Die odt-Vorlagen in diesem Verzeichnis "rev-odt" wurden von revamp-it, + ZÃ¼rich erstellt und werden laufend aktualisiert. Ein paar der + Formulierungen in den Druckvorlagen entsprechen dem Schweizer + Sprachgebrauch, z.B. "Offerte" oder "allfÃ¤llig".

Hinweis zum Einsatz des Feldes "Land" bei den Stammdaten fÃ¼r + KundInnen und LieferantInnen, sowie bei Lieferadressen: Die in diesem + Vorlagensatz vorhandenen Vorlagen erwarten fÃ¼r "Land" das + entsprechende KÃ¼rzel, das in Adressen vor die Postleitzahl gesetzt + wird. Das Feld kann auch komplett leer bleiben. Wer dies anders + handhaben mÃ¶chte, muss die Vorlagen entsprechend anpassen.

odt-Vorlagen kÃ¶nnen mit LibreOffice oder OpenOffice editiert und + den eigenen BedÃ¼rfnissen angepasst werden. Wichtig beim Editieren von + if-BlÃ¶cken ist, dass immer der gesamte Block Ã¼berschrieben werden muss + und nicht nur Teile davon, da dies sonst oft zu einer odt-Datei fÃ¼hrt, + die vom Parser nicht korrekt gelesen werden kann.

Mahnungen kÃ¶nnen unter folgenden EinschrÃ¤nkungen mit den + odt-Vorlagen im Vorlagensatz rev-odt erzeugt werden:

als Druckoption steht nur 'PDF(OpenDocument/OASIS)' zur + VerfÃ¼gung, das heisst, die Mahnungen werden als PDF-Datei + ausgegeben.
fÃ¼r jede Rechnung muss eine eigene Mahnung erzeugt werden + (auch wenn bei einzelnen KundInnen mehrere Ã¼berfÃ¤llige Rechnungen + vorhanden sind).

Mehrere Mahnungen fÃ¼r eine Kundin / einen Kunden werden zu einer + PDF-Datei zusammengefasst

Die Vorlagen zahlungserinnerung.odt sowie mahnung.odt sind fÃ¼r + das Erstellen einer Zahlungserinnerung bzw. Mahnung selbst vorgesehen, + die Vorlage mahnung_invoice.odt fÃ¼r das Erstellen einer Rechnung Ã¼ber + die verrechneten MahngebÃ¼hren und Verzugszinsen.

Zur Zeit gibt es in kivitendo noch keine MÃ¶glichkeit, + odt-Vorlagen bei Briefen und Pflichtenheften einzusetzen. + Entsprechende Vorlagen sind deshalb nicht vorhanden.

Fehlermeldungen, Anregungen und WÃ¼nsche bitte senden an: + empfang@revamp-it.ch

2.14.5. Allgemeine Hinweise zu LaTeX Vorlagen

In den allermeisten Installationen sollte das Drucken jetzt + schon funktionieren. Sollte ein Fehler auftreten, wirft TeX sehr lange + Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste + Zeile, die mit einem Ausrufezeichen anfÃ¤ngt. HÃ¤ufig auftretende Fehler + sind zum Beispiel:

! LaTeX Error: File `eurosym.sty' not found. Die + entsprechende LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor + allem bei Vorlagen aus der Community auf. Installieren Sie die + entsprechenden Pakete.
! Package inputenc Error: Unicode char \u8:... set up for + use with LaTeX. Dieser Fehler tritt auf, wenn sie versuchen mit + einer Standardinstallation exotische utf8 Zeichen zu drucken. + TeXLive unterstÃ¼tzt von Haus nur romanische Schriften und muss mit + diversen Tricks dazu gebracht werden andere Zeichen zu + akzeptieren. Adere TeX Systeme wie XeTeX schaffen hier + Abhilfe.

Wird gar kein Fehler angezeigt, sondern nur der Name des + Templates, heiÃt das normalerweise, dass das LaTeX Binary nicht + gefunden wurde. PrÃ¼fen Sie den Namen in der Konfiguration (Standard: + latexmk --pdflatex), und stellen Sie sicher, dass + latexmk (oder das von Ihnen verwendete System) vom Webserver ausgefÃ¼hrt + werden darf.

Wenn sich das Problem nicht auf Grund der Ausgabe im Webbrowser + verifizieren lÃ¤sst:

editiere [kivitendo-home]/config/kivitendo.conf und Ã¤ndere + "keep_temp_files" auf 1
+
```
keep_temp_files = 1;
```
+
bei fastcgi oder mod_perl den Webserver neu Starten
Nochmal einen Druckversuch im Webfrontend auslÃ¶sen
wechsel in das users Verzeichnis von kivitendo
+
```
cd [kivitendo-home]/users
```
+

LaTeX Suchpfad anpassen:

export TEXINPUTS=".:[kivitendo-home]/templates/[aktuelles_template_verzeichniss]:"

Finde heraus, welche Datei kivitendo beim letzten Durchlauf + erstellt hat
+
```
ls -lahtr ./1*.tex
```
+
Es sollte die letzte Datei ganz unten sein
fÃ¼r besseren Hinweis auf Fehler texdatei nochmals + Ã¼bersetzen
+
```
pdflatex ./1*.tex
```
+
in der *.tex datei nach dem Fehler suchen.

ZurÃ¼ck	Nach oben	Weiter
2.13. Konfiguration zur EinnahmenÃ¼berschussrechnung/Bilanzierung: - EUR	Zum Anfang	2.15. Einstellungen pro Mandant

ZurÃ¼ck	Nach oben	Weiter
2.13. E-Mail	Zum Anfang	2.15. OpenDocument-Vorlagen