2 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3 <title>2.15. OpenDocument-Vorlagen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.9.2: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s14.html" title="2.14. Drucken mit kivitendo"><link rel="next" href="ch02s16.html" title="2.16. Nomenklatur"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.15. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s14.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s16.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.15. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.15. OpenDocument-Vorlagen</h2></div></div></div><p>kivitendo unterstützt die Verwendung von Vorlagen im
4 OpenDocument-Format, wie es LibreOffice oder OpenOffice (ab Version 2)
5 erzeugen. kivitendo kann dabei sowohl neue OpenDocument-Dokumente als
6 auch aus diesen direkt PDF-Dateien erzeugen. Nachfolgend ist die
7 Verwendung mit LibreOffice beschrieben. Für die Verwendung mit
8 OpenOffice müssen die Einstellungen allenfalls angepasst werden.</p><div class="sect2" title="2.15.1. Grundeinstellung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e3228"></a>2.15.1. Grundeinstellung</h3></div></div></div><p>Um die Unterstützung von OpenDocument-Vorlagen zu aktivieren,
9 muss in der Datei <code class="filename">config/kivitendo.conf</code> die
10 Variable <code class="literal">opendocument</code>, im Abschnitt
11 <code class="literal">print_templates</code>, auf <code class="literal">1</code> stehen.
12 Dies ist die Standardeinstellung.</p></div><div class="sect2" title="2.15.2. Direkte Erzeugung von PDF-Dateien"><div class="titlepage"><div><div><h3 class="title"><a name="d0e3245"></a>2.15.2. Direkte Erzeugung von PDF-Dateien</h3></div></div></div><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
13 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
14 LibreOffice oder OpenOffice benötigt.</p><p>Unter Debian kann dieses installiert werden mit:</p><pre class="programlisting">apt install libreoffice</pre><p>Der Pfad zu LibreOffice kann in der Datei
15 <code class="filename">config/kivitendo.conf</code>, im Abschnitt
16 <code class="literal">applications</code>, angepasst werden. Unter Debian sollte
17 dies nicht notwendig sein.</p><div class="sect3" title="2.15.2.1. Variante 1)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3262"></a>2.15.2.1. Variante 1)</h4></div></div></div><p>In der Standardeinstellung wird LibreOffice für jedes Dokument
18 neu gestartet. Es ist keine weitere Konfiguration
19 erforderlich.</p></div><div class="sect3" title="2.15.2.2. Variante 2)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3267"></a>2.15.2.2. Variante 2)</h4></div></div></div><p>Die zweite Variante startet ein LibreOffice, das auch nach der
20 Umwandlung des Dokumentes gestartet bleibt. Bei weiteren
21 Umwandlungen wird dann diese laufende Instanz benutzt. Der Vorteil
22 ist, dass die Zeit zur Umwandlung möglicherweise reduziert wird,
23 weil nicht für jedes Dokument eine neue Instanz gestartet werden
24 muss.</p><p>Dazu muss in der Konfigurationsdatei
25 <code class="filename">config/kivitendo.conf</code>, im Abschnitt
26 <code class="literal">print_templates</code>, <code class="literal">openofficeorg_daemon =
27 1</code> gesetzt werden.</p><p>Diese Methode verwendet Python und die Python uno bindings.
28 Unter Debian werden diese mit LibreOffice mitgeliefert.</p><p>Die Optionen <code class="literal">python_uno</code> und
29 <code class="literal">python_uno_path</code> in der Konfigurationsdatei
30 <code class="filename">config/kivitendo.conf</code> dienen zur Anpassung der
31 Python uno Pfade. Unter Debian sollte keine Anpassung notwendig
32 sein.</p></div></div><div class="sect2" title="2.15.3. Vorbereitungen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e3296"></a>2.15.3. Vorbereitungen</h3></div></div></div><div class="sect3" title="2.15.3.1. Adminbereich"><div class="titlepage"><div><div><h4 class="title"><a name="opendocument-druckvorlagen-mit-makros.vorbereitungen"></a>2.15.3.1. Adminbereich</h4></div></div></div><p>Damit beim Erstellen von Rechnungen und Aufträgen neben der
33 Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit
34 Einzahlungsschein) auswählbar sind, muss für jedes Vorlagen-Suffix
35 ein Drucker eingerichtet werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Druckeradministration → Drucker hinzufügen</p></li><li class="listitem"><p>Mandant wählen</p></li><li class="listitem"><p>Druckerbeschreibung → aussagekräftiger Text: wird in der
36 Auftrags- bzw. Rechnungsmaske als Auswahl angezeigt (z.B. mit
37 Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Druckbefehl → beliebiger Text (hat für das Erzeugen von
38 Aufträgen oder Rechnungen als odt-Datei keine Bedeutung, darf
39 aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel → besr bzw. selbst gewähltes Vorlagensuffix
40 (muss genau der Zeichenfolge entsprechen, die zwischen
41 "invoice_" bzw. "sales_order_" und ".odt" steht.)</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.15.3.2. Benutzereinstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3323"></a>2.15.3.2. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
42 im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann
43 dies persönlich für sich bei den Benutzereinstellungen
44 konfigurieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Programm → Benutzereinstellungen → Druckoptionen</p></li><li class="listitem"><p>Standardvorlagenformat → OpenDocument/OASIS</p></li><li class="listitem"><p>Standardausgabekanal → Bildschirm</p></li><li class="listitem"><p>Standarddrucker → gewünschte Druckerbeschreibung auswählen
45 (z.B. mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Anzahl Kopien → leer</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.15.3.3. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer odt-Rechnung (analog bei Auftrag)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3347"></a>2.15.3.3. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer
46 odt-Rechnung (analog bei Auftrag)</h4></div></div></div><p>Im Fussbereich der Rechnungsmaske muss neben Rechnung,
47 OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte
48 Druckerbeschreibung ausgewählt werden, falls diese nicht bereits bei
49 den Benutzereinstellungen als persönlicher Standard gewählt
50 wurde.</p></div></div><div class="sect2" title="2.15.4. Schweizer QR-Rechnung mit OpenDocument Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e3352"></a>2.15.4. Schweizer QR-Rechnung mit OpenDocument Vorlagen</h3></div></div></div><p>Mit der Version 3.6.0 unterstützt Kivitendo die Erstellung von
51 Schweizer QR-Rechnungen gemäss <a class="ulink" href="https://www.paymentstandards.ch/dam/downloads/ig-qr-bill-de.pdf" target="_top">Swiss
52 Payment Standards, Version 2.2</a>. Implementiert sind hierbei die
53 Varianten:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
54 <span class="bold"><strong>QR-IBAN mit
55 QR-Referenz</strong></span>
56 </p></li><li class="listitem"><p>
57 <span class="bold"><strong>IBAN ohne Referenz</strong></span>
58 </p></li></ul></div><div class="sect3" title="2.15.4.1. Einstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3373"></a>2.15.4.1. Einstellungen</h4></div></div></div><div class="sect4" title="2.15.4.1.1. Mandantenkonfiguration"><div class="titlepage"><div><div><h5 class="title"><a name="d0e3376"></a>2.15.4.1.1. Mandantenkonfiguration</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Mandantenkonfiguration →
59 Features</em></span>. Im Abschnitt <span class="emphasis"><em>Einkauf und
60 Verkauf</em></span>, beim Punkt <span class="emphasis"><em>Verkaufsrechnungen mit
61 Schweizer QR-Rechnung erzeugen</em></span>, die gewünschte Variante
62 wählen.</p></div><div class="sect4" title="2.15.4.1.2. Konfiguration der Bankkonten"><div class="titlepage"><div><div><h5 class="title"><a name="d0e3390"></a>2.15.4.1.2. Konfiguration der Bankkonten</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Bankkonten</em></span> muss bei
63 mindestens einem Bankkonto die Option <span class="emphasis"><em>Nutzung mit
64 Schweizer QR-Rechnung</em></span> auf <span class="bold"><strong>Ja</strong></span> gestellt werden.</p><p>Die IBAN muss ohne Leerzeichen angegeben werden.</p><div class="tip" title="Tipp" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Tip"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Tipp]" src="system/docbook-xsl/images/tip.png"></td><th align="left">Tipp</th></tr><tr><td align="left" valign="top"><p>Für die Variante <span class="bold"><strong>QR-IBAN mit
65 QR-Referenz</strong></span> muss dieses Konto unter QR-IBAN (Schweiz) eine gültige
66 <span class="bold"><strong>QR-IBAN Nummer</strong></span> enthalten. Diese
67 unterscheidet sich von der regulären IBAN.</p><p>Zusätzlich muss eine gültige <span class="bold"><strong>Bankkonto
68 Identifikationsnummer</strong></span> angegeben werden
69 (6-stellig).</p><p>Diese werden von der jeweiligen Bank vergeben.</p></td></tr></table></div><p>Sind mehrere Konten ausgewählt wird das erste
70 verwendet.</p></div><div class="sect4" title="2.15.4.1.3. Rechnungen ohne Betrag"><div class="titlepage"><div><div><h5 class="title"><a name="d0e3424"></a>2.15.4.1.3. Rechnungen ohne Betrag</h5></div></div></div><p>Für Rechnungen ohne Betrag (z.B. Spenden) kann, in der
71 jeweiligen Rechnung, die Checkbox <span class="emphasis"><em>QR-Rechnung ohne
72 Betrag</em></span> aktiviert werden. Diese Checkbox erscheint nur,
73 wenn QR-Rechnungen in der Mandantenkonfiguration aktiviert sind
74 (variante ausgewählt).</p><p>Dies wirkt sich lediglich auf den erzeugten QR-Code aus. Die
75 Vorlage muss separat angepasst und ausgewählt werden.</p></div></div><div class="sect3" title="2.15.4.2. Adressdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3434"></a>2.15.4.2. Adressdaten</h4></div></div></div><p>Die Adressdaten zum Zahlungsempfänger werden aus der
76 Mandantenkonfiguration entnommen. Unter <span class="emphasis"><em>System →
77 Mandantenkonfiguration → Verschiedenes</em></span>, Abschnitt
78 <span class="emphasis"><em>Firmenname und -adresse.</em></span>
79 </p><p>Die Adressdaten zum Zahlungspflichtigen stammen aus den
80 Kundendaten der jeweiligen Rechnung.</p><p>Ist bei den Adressdaten kein Land angegeben, wird standardmässig
81 Schweiz verwendet. Akzeptiert werden Ländername oder Ländercode, also
82 z.B. "Schweiz" oder "CH".</p><p>Die Adressdaten können in der Vorlage mit den jeweiligen
83 Variablen eingetragen werden. Siehe auch: <a class="xref" href="ch03s03.html" title="3.3. Dokumentenvorlagen und verfügbare Variablen">Abschnitt 3.3, „Dokumentenvorlagen und verfügbare Variablen“</a>
84 </p><p>Der erzeugte QR-Code verwendet Adress-Typ "K" (Kombinierte
85 Adressfelder, 2 Zeilen).</p></div><div class="sect3" title="2.15.4.3. Referenznummer"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3455"></a>2.15.4.3. Referenznummer</h4></div></div></div><p>Die Referenznummer wird in Kivitendo erzeugt und setzt sich
86 wiefolgt zusammen:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Bankkonto Identifikationsnummer (6-stellig)</p></li><li class="listitem"><p>Kundennummer (6-stellig, mit führenden Nullen
87 aufgefüllt)</p></li><li class="listitem"><p>Rechnungsnummer (14-stellig, mit führenden Nullen
88 aufgefüllt)</p></li><li class="listitem"><p>Prüfziffer (1-stellig, berechnet mittels modulo 10,
89 rekursiv)</p></li></ul></div><p>Es sind lediglich Ziffern erlaubt. Allfällige Buchstaben und
90 Sonderzeichen werden entfernt und fehlende Stellen werden mit
91 führenden Nullen aufgefüllt.</p></div><div class="sect3" title="2.15.4.4. Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3475"></a>2.15.4.4. Vorlage</h4></div></div></div><p>Der Vorlagensatz "rev-odt" enthält die Vorlage
92 <code class="literal">invoice_qr.odt</code>, welche für die Erstellung von
93 QR-Rechnungen vorgesehen ist. Damit diese verwendet werden kann muss
94 wie obenstehend beschrieben ein Drucker hinzugefügt werden, allerdings
95 mit dem Vorlagenkürzel <code class="literal">qr</code> (siehe <a class="xref" href="ch02s15.html#opendocument-druckvorlagen-mit-makros.vorbereitungen" title="2.15.3.1. Adminbereich">Abschnitt 2.15.3.1, „Adminbereich“</a>).
96 Weitere Vorlagen für die QR-Rechnung müssen im Dateinamen, bzw.
97 Vorlagenkürzel, ebenfalls die Zeichenfolge <code class="literal">qr</code>
98 enthalten, also z.b. <code class="literal">invoice_qr2.odt</code> etc.</p><p>Die Vorlagen können beliebig angepasst werden. Zwingend müssen
99 diese jedoch das QR-Code Platzhalter Bild, als eingebettetes Bild,
100 enthalten. Da dieses beim Ausdrucken/Erzeugen der Rechnung durch das
101 neu generierte QR-Code Bild ersetzt wird. Das Bild muss den Namen
102 <code class="literal">QRCodePlaceholder</code> tragen. In Libreoffice unter
103 <span class="emphasis"><em>Bild-Kontextmenü → </em></span>
104 <span class="emphasis"><em>Einstellungen →
105 Optionen → Name</em></span> einstellbar. Siehe dazu auch die
106 Beispielvorlage.</p><div class="sect4" title="2.15.4.4.1. Zusätzliche Variablen für Vorlage"><div class="titlepage"><div><div><h5 class="title"><a name="d0e3505"></a>2.15.4.4.1. Zusätzliche Variablen für Vorlage</h5></div></div></div><p>Zusätzlich zu den in der Vorlage standardmässig verfügbaren
107 Variablen (siehe <a class="xref" href="ch03s03.html" title="3.3. Dokumentenvorlagen und verfügbare Variablen">Abschnitt 3.3, „Dokumentenvorlagen und verfügbare Variablen“</a>),
108 werden die folgenden Variablen erzeugt:</p><div class="variablelist"><dl><dt><span class="term">ref_number_formatted</span></dt><dd><p>Referenznummer formatiert mit Leerzeichen, z.B.: 21 00000
109 00003 13947 14300 09017</p></dd><dt><span class="term">iban_formatted</span></dt><dd><p>IBAN formatiert mit Leerzeichen</p></dd><dt><span class="term">amount_formatted</span></dt><dd><p>Betrag formatiert mit Tausendertrennzeichen Leerschlag,
110 z.B.: 1 005.55</p></dd></dl></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s14.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s16.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.14. Drucken mit kivitendo </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.16. Nomenklatur</td></tr></table></div></body></html>
projects / mfinanz.git / blob