Revision 4fa4290e
Von Cem Aydin vor mehr als 2 Jahren hinzugefügt
| doc/html/ch02s13.html | ||
|---|---|---|
|
<title>2.13. 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.7.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s12.html" title="2.12. Drucken mit kivitendo"><link rel="next" href="ch02s14.html" title="2.14. 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.13. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s12.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="ch02s14.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.13. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.13. OpenDocument-Vorlagen</h2></div></div></div><p>kivitendo unterstützt die Verwendung von Vorlagen im
|
||
|
OpenDocument-Format, wie es LibreOffice oder OpenOffice (ab Version 2)
|
||
|
erzeugen. kivitendo kann dabei sowohl neue OpenDocument-Dokumente als
|
||
|
auch aus diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von
|
||
|
OpenDocument-Vorlagen zu aktivieren muss in der Datei
|
||
|
<code class="filename">config/kivitendo.conf</code> die Variable
|
||
|
<code class="literal">opendocument</code> im Abschnitt
|
||
|
<code class="literal">print_templates</code> auf ‘<code class="literal">1</code>’ stehen.
|
||
|
Dieses ist die Standardeinstellung.</p><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
|
||
|
weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
|
||
|
LibreOffice oder OpenOffice benötigt. Soll dieses Feature genutzt
|
||
|
werden, so muss neben LibreOffice oder OpenOffice auch der “X virtual
|
||
|
frame buffer” (xvfb) installiert werden. Bei Debian ist er im Paket
|
||
|
“xvfb” enthalten. Andere Distributionen enthalten ihn in anderen
|
||
|
Paketen.</p><p>Nach der Installation müssen in der Datei
|
||
|
<code class="filename">config/kivitendo.conf</code> im Abschnitt
|
||
|
<code class="literal">applications</code> zwei weitere Variablen angepasst
|
||
|
werden:</p><p>
|
||
|
<code class="literal">openofficeorg_writer</code> muss den vollständigen
|
||
|
Pfad zu LibreOffice oder OpenOffice enthalten. Dabei dürfen keine
|
||
|
Anführungszeichen eingesetzt werden.</p><p>Beispiel für Debian oder Ubuntu:</p><pre class="programlisting">openofficeorg_writer = /usr/bin/libreoffice</pre><p>
|
||
|
<code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer”
|
||
|
enthalten.</p><p>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit
|
||
|
LibreOffice bzw. OpenOffice kommuniziert. Die erste Variante, die
|
||
|
benutzt wird, wenn die Variable <code class="literal">$openofficeorg_daemon</code>
|
||
|
gesetzt ist, startet ein LibreOffice oder OpenOffice, das auch nach der
|
||
|
Umwandlung des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen
|
||
|
wird dann diese laufende Instanz benutzt. Der Vorteil ist, dass die Zeit
|
||
|
zur Umwandlung deutlich reduziert wird, weil nicht für jedes Dokument
|
||
|
ein LibreOffice bzw. OpenOffice gestartet werden muss. Der Nachteil ist,
|
||
|
dass diese Methode Python und die Python-UNO-Bindings benötigt, die
|
||
|
Bestandteil von LibreOffice bzw. OpenOffice sind.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Für die Verbindung zu LibreOffice bzw. OpenOffice wird
|
||
|
normalerweise der Python-Interpreter
|
||
|
<code class="filename">/usr/bin/python</code> benutzt. Sollte dies nicht der
|
||
|
richtige sein, so kann man mit zwei Konfigurationsvariablen
|
||
|
entscheiden, welcher Python-Interpreter genutzt wird. Mit der Option
|
||
|
<code class="literal">python_uno</code> aus dem Abschnitt
|
||
|
<code class="literal">applications</code> wird der Interpreter selber
|
||
|
festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert
|
||
|
<code class="literal">/usr/bin/python</code>.</p><p>Zusätzlich ist es möglich, Pfade anzugeben, in denen Python
|
||
|
neben seinen normalen Suchpfaden ebenfalls nach Modulen gesucht wird,
|
||
|
z.B. falls sich diese in einem gesonderten LibreOffice- bzw.
|
||
|
OpenOffice-Verzeichnis befinden. Diese zweite Variable heißt
|
||
|
<code class="literal">python_uno_path</code> und befindet sich im Abschnitt
|
||
|
<code class="literal">environment</code>. Sie ist standardmäßig leer. Werden
|
||
|
hier mehrere Pfade angegeben, so müssen diese durch Doppelpunkte
|
||
|
voneinander getrennt werden. Der Inhalt wird an den Python-Interpreter
|
||
|
über die Umgebungsvariable <code class="literal">PYTHONPATH</code>
|
||
|
übergeben.</p></td></tr></table></div><p>Ist <code class="literal">$openofficeorg_daemon</code> nicht gesetzt, so
|
||
|
wird für jedes Dokument LibreOffice bzw. OpenOffice neu gestartet und
|
||
|
die Konvertierung mit Hilfe eines Makros durchgeführt. Dieses Makro muss
|
||
|
in der Dokumentenvorlage enthalten sein und
|
||
|
“Standard.Conversion.ConvertSelfToPDF()” heißen. Die Beispielvorlage
|
||
|
‘<code class="literal">templates/print/rev-odt/invoice.odt</code>’ enthält ein
|
||
|
solches Makro, das in jeder anderen Dokumentenvorlage ebenfalls
|
||
|
enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen OpenOffice
|
||
|
bzw. LibreOffice dem Verzeichnis mit den Benutzereinstellungen gibt.
|
||
|
Unter Debian ist dies momentan <code class="literal">~/.config/libreoffice</code>.
|
||
|
kivitendo verwendet das Verzeichnis
|
||
|
<code class="literal">users/.openoffice.org2</code>. Eventuell muss dieses
|
||
|
Verzeichnis umbenannt werden.</p><p>Dieses Verzeichnis, wie auch das komplette
|
||
|
<code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar
|
||
|
sein. Dieses wurde bereits erledigt (siehe <a class="xref" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber erneut
|
||
|
überprüft werden, wenn die Konvertierung nach PDF fehlschlägt.</p><div class="sect2" title="2.13.1. OpenDocument (odt) Druckvorlagen mit Makros"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2491"></a>2.13.1. OpenDocument (odt) Druckvorlagen mit Makros</h3></div></div></div><p>OpenDocument Vorlagen können Makros enthalten, welche komplexere
|
||
|
Aufgaben erfüllen.</p><p>Der Vorlagensatz "rev-odt" enthält solche Vorlagen mit <span class="bold"><strong>Schweizer Bank-Einzahlungsscheinen (BESR)</strong></span>.
|
||
|
Diese Makros haben die Aufgabe, die in den Einzahlungsscheinen
|
||
|
benötigte Referenznummer und Kodierzeile zu erzeugen. Hier eine kurze
|
||
|
Beschreibung, wie die Makros aufgebaut sind, und was bei ihrer Nutzung
|
||
|
zu beachten ist (<span class="bold"><strong>in fett sind nötige einmalige
|
||
|
Anpassungen aufgeführt</strong></span>):</p><div class="sect3" title="2.13.1.1. Bezeichnung der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2504"></a>2.13.1.1. Bezeichnung der Vorlagen</h4></div></div></div><p>Rechnung: invoice_besr.odt, Auftrag:
|
||
|
sales_order_besr.odt</p></div><div class="sect3" title="2.13.1.2. Vorbereitungen im Adminbereich"><div class="titlepage"><div><div><h4 class="title"><a name="opendocument-druckvorlagen-mit-makros.vorbereitungen"></a>2.13.1.2. Vorbereitungen im Adminbereich</h4></div></div></div><p>Damit beim Erstellen von Rechnungen und Aufträgen neben der
|
||
|
auch aus diesen direkt PDF-Dateien erzeugen. Nachfolgend ist die
|
||
|
Verwendung mit LibreOffice beschrieben. Für die Verwendung mit
|
||
|
OpenOffice müssen die Einstellungen allenfalls angepasst werden.</p><div class="sect2" title="2.13.1. Grundeinstellung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2401"></a>2.13.1. Grundeinstellung</h3></div></div></div><p>Um die Unterstützung von OpenDocument-Vorlagen zu aktivieren,
|
||
|
muss in der Datei <code class="filename">config/kivitendo.conf</code> die
|
||
|
Variable <code class="literal">opendocument</code>, im Abschnitt
|
||
|
<code class="literal">print_templates</code>, auf <code class="literal">1</code> stehen.
|
||
|
Dies ist die Standardeinstellung.</p></div><div class="sect2" title="2.13.2. Direkte Erzeugung von PDF-Dateien"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2418"></a>2.13.2. Direkte Erzeugung von PDF-Dateien</h3></div></div></div><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
|
||
|
weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
|
||
|
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
|
||
|
<code class="filename">config/kivitendo.conf</code>, im Abschnitt
|
||
|
<code class="literal">applications</code>, angepasst werden. Unter Debian sollte
|
||
|
dies nicht notwendig sein.</p><div class="sect3" title="2.13.2.1. Variante 1)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2435"></a>2.13.2.1. Variante 1)</h4></div></div></div><p>In der Standardeinstellung wird LibreOffice für jedes Dokument
|
||
|
neu gestartet. Es ist keine weitere Konfiguration
|
||
|
erforderlich.</p></div><div class="sect3" title="2.13.2.2. Variante 2)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2440"></a>2.13.2.2. Variante 2)</h4></div></div></div><p>Die zweite Variante startet ein LibreOffice, das auch nach der
|
||
|
Umwandlung des Dokumentes gestartet bleibt. Bei weiteren
|
||
|
Umwandlungen wird dann diese laufende Instanz benutzt. Der Vorteil
|
||
|
ist, dass die Zeit zur Umwandlung möglicherweise reduziert wird,
|
||
|
weil nicht für jedes Dokument eine neue Instanz gestartet werden
|
||
|
muss.</p><p>Dazu muss in der Konfigurationsdatei
|
||
|
<code class="filename">config/kivitendo.conf</code>, im Abschnitt
|
||
|
<code class="literal">print_templates</code>, <code class="literal">openofficeorg_daemon =
|
||
|
1</code> gesetzt werden.</p><p>Diese Methode verwendet Python und die Python uno bindings.
|
||
|
Unter Debian werden diese mit LibreOffice mitgeliefert.</p><p>Die Optionen <code class="literal">python_uno</code> und
|
||
|
<code class="literal">python_uno_path</code> in der Konfigurationsdatei
|
||
|
<code class="filename">config/kivitendo.conf</code> dienen zur Anpassung der
|
||
|
Python uno Pfade. Unter Debian sollte keine Anpassung notwendig
|
||
|
sein.</p></div></div><div class="sect2" title="2.13.3. Vorbereitungen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2469"></a>2.13.3. Vorbereitungen</h3></div></div></div><div class="sect3" title="2.13.3.1. Adminbereich"><div class="titlepage"><div><div><h4 class="title"><a name="opendocument-druckvorlagen-mit-makros.vorbereitungen"></a>2.13.3.1. Adminbereich</h4></div></div></div><p>Damit beim Erstellen von Rechnungen und Aufträgen neben der
|
||
|
Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit
|
||
|
Einzahlungsschein) auswählbar sind, muss für jedes Vorlagen-Suffix
|
||
|
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
|
||
| ... | ... | |
|
Aufträgen oder Rechnungen als odt-Datei keine Bedeutung, darf
|
||
|
aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel → besr bzw. selbst gewähltes Vorlagensuffix
|
||
|
(muss genau der Zeichenfolge entsprechen, die zwischen
|
||
|
"invoice_" bzw. "sales_order_" und ".odt" steht.)</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.3. Benutzereinstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2533"></a>2.13.1.3. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
|
||
|
"invoice_" bzw. "sales_order_" und ".odt" steht.)</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.3.2. Benutzereinstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2496"></a>2.13.3.2. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
|
||
|
im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann
|
||
|
dies persönlich für sich bei den Benutzereinstellungen
|
||
|
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
|
||
|
(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.13.1.4. Aufbau und nötige Anpassungen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2557"></a>2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen</h4></div></div></div><p>In der Vorlage sind als Modul "BESR" 4 Makros gespeichert, die
|
||
|
aus dem von kivitendo erzeugten odt-Dokument die korrekte
|
||
|
Referenznummer inklusive Prüfziffer sowie die Kodierzeile in
|
||
|
OCRB-Schrift erzeugen und am richtigen Ort ins Dokument
|
||
|
schreiben.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Für den Einzahlungsschein ist die letzte Seite des
|
||
|
Dokuments reserviert</p></li><li class="listitem"><p>Direkt über dem Einzahlungsschein enthält die Vorlage eine
|
||
|
Zeile mit folgenden Angaben (<span class="bold"><strong>Bank-Konto-Identifikationsnummer und
|
||
|
Postkonto-Nummer der Bank müssen gemäss Angaben der jeweiligen
|
||
|
Bank angepasst werden</strong></span>):</p><div class="itemizedlist"><ul class="itemizedlist" type="circle"><li class="listitem"><p>DDDREF: 4 Werte zum Bilden der Referenznummer
|
||
|
(jeweils durch einen Leerschlag getrennt): </p><div class="itemizedlist"><ul class="itemizedlist" type="square"><li class="listitem"><p>erster Wert: <span class="bold"><strong>Bank-Konto-Identifikation</strong></span>
|
||
|
(nur Ziffern, maximal 6), <span class="bold"><strong>muss
|
||
|
angepasst werden</strong></span>.</p></li><li class="listitem"><p>zweiter Wert: <%customernumber%>
|
||
|
(Kundennummer: nur Ziffern, maximal 6)</p></li><li class="listitem"><p>dritter Wert: <%ordnumber%>
|
||
|
(Auftragsnummer bei Auftragsvorlage
|
||
|
sales_oder_besr.odt, sonst 0) maximal 7 Ziffern,
|
||
|
führende Buchstaben werden vom Makro entfernt</p></li><li class="listitem"><p>vierter Wert: <%invnumber%>
|
||
|
(Rechnungsnummer bei Rechnungsvorlage
|
||
|
invoice_besr.odt, sonst 0) maximal 7 Ziffern,
|
||
|
führende Buchstaben werden vom Makro entfernt</p></li></ul></div><p>
|
||
|
</p></li><li class="listitem"><p>DDDKONTO: <span class="bold"><strong>Postkonto-Nummer der
|
||
|
Bank, muss angepasst werden</strong></span>.</p></li><li class="listitem"><p>DDDBETRAG: <%total%> Einzahlungsbetrag oder 0,
|
||
|
falls Einzahlungsschein ohne Betrag</p></li><li class="listitem"><p>DDDEND: muss am Ende der Zeile vorhanden sein</p></li></ul></div><p>
|
||
|
</p></li><li class="listitem"><p>
|
||
|
<span class="bold"><strong>Im Einzahlungsschein selbst müssen
|
||
|
der Name und die Adresse der Bank, die Postkonto-Nummer der
|
||
|
Bank, sowie der eigene Firmenname und die Firmenadresse
|
||
|
angepasst werden.</strong></span> Dabei ist darauf zu achten, dass
|
||
|
sich die Positionen der Postkonto-Nummern der Bank, sowie der
|
||
|
Zeichenfolgen dddfr, DDDREF1, DDDREF2, 609, DDDKODIERZEILE nicht
|
||
|
verschieben.</p></li></ul></div><div class="screenshot"><div class="mediaobject"><img src="images/Einzahlungsschein_Makro.png"></div></div></div><div class="sect3" title="2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer odt-Rechnung (analog bei Auftrag)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2621"></a>2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer
|
||
|
(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.13.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="d0e2520"></a>2.13.3.3. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer
|
||
|
odt-Rechnung (analog bei Auftrag)</h4></div></div></div><p>Im Fussbereich der Rechnungsmaske muss neben Rechnung,
|
||
|
OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte
|
||
|
Druckerbeschreibung ausgewählt werden, falls diese nicht bereits bei
|
||
|
den Benutzereinstellungen als persönlicher Standard gewählt
|
||
|
wurde.</p></div><div class="sect3" title="2.13.1.6. Makroeinstellungen in LibreOffice anpassen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2626"></a>2.13.1.6. Makroeinstellungen in LibreOffice anpassen</h4></div></div></div><p>Falls beim Öffnen einer von kivitendo erzeugten odt-Rechnung
|
||
|
die Meldung kommt, dass Makros aus Sicherheitsgründen nicht
|
||
|
ausgeführt werden, so müssen folgende Einstellungen in LibreOffice
|
||
|
angepasst werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Extras → Optionen → Sicherheit → Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese
|
||
|
Einstellung muss auf jedem Computer durchgeführt werden, mit dem
|
||
|
von kivitendo erzeugte odt-Rechnungen oder Aufträge geöffnet
|
||
|
werden.)</p></li><li class="listitem"><p>Beim Öffnen einer odt-Rechnung oder eines odt-Auftrags bei
|
||
|
der entsprechenden Nachfrage "Makros ausführen"
|
||
|
auswählen.</p><p>
|
||
|
<span class="bold"><strong>Wichtig</strong></span>: die Makros sind
|
||
|
so eingestellt, dass sie beim Öffnen der Vorlagen selbst nicht
|
||
|
ausgeführt werden. Das heisst für das Ansehen und Bearbeiten der
|
||
|
Vorlagen sind keine speziellen Einstellungen in LibreOffice
|
||
|
nötig.</p></li></ul></div></div></div><div class="sect2" title="2.13.2. Schweizer QR-Rechnung mit OpenDocument Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2646"></a>2.13.2. Schweizer QR-Rechnung mit OpenDocument Vorlagen</h3></div></div></div><p>Mit der Version 3.6.0 unterstützt Kivitendo die Erstellung von
|
||
|
wurde.</p></div></div><div class="sect2" title="2.13.4. Schweizer QR-Rechnung mit OpenDocument Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2525"></a>2.13.4. Schweizer QR-Rechnung mit OpenDocument Vorlagen</h3></div></div></div><p>Mit der Version 3.6.0 unterstützt Kivitendo die Erstellung von
|
||
|
Schweizer QR-Rechnungen gemäss <a class="ulink" href="https://www.paymentstandards.ch/dam/downloads/ig-qr-bill-de.pdf" target="_top">Swiss
|
||
|
Payment Standards, Version 2.2</a>. Implementiert sind hierbei die
|
||
|
Varianten:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
|
||
| ... | ... | |
|
QR-Referenz</strong></span>
|
||
|
</p></li><li class="listitem"><p>
|
||
|
<span class="bold"><strong>IBAN ohne Referenz</strong></span>
|
||
|
</p></li></ul></div><div class="sect3" title="2.13.2.1. Einstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2667"></a>2.13.2.1. Einstellungen</h4></div></div></div><div class="sect4" title="2.13.2.1.1. Mandantenkonfiguration"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2670"></a>2.13.2.1.1. Mandantenkonfiguration</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Mandantenkonfiguration →
|
||
|
</p></li></ul></div><div class="sect3" title="2.13.4.1. Einstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2546"></a>2.13.4.1. Einstellungen</h4></div></div></div><div class="sect4" title="2.13.4.1.1. Mandantenkonfiguration"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2549"></a>2.13.4.1.1. Mandantenkonfiguration</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Mandantenkonfiguration →
|
||
|
Features</em></span>. Im Abschnitt <span class="emphasis"><em>Einkauf und
|
||
|
Verkauf</em></span>, beim Punkt <span class="emphasis"><em>Verkaufsrechnungen mit
|
||
|
Schweizer QR-Rechnung erzeugen</em></span>, die gewünschte Variante
|
||
|
wählen.</p></div><div class="sect4" title="2.13.2.1.2. Konfiguration der Bankkonten"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2684"></a>2.13.2.1.2. Konfiguration der Bankkonten</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Bankkonten</em></span> muss bei
|
||
|
wählen.</p></div><div class="sect4" title="2.13.4.1.2. Konfiguration der Bankkonten"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2563"></a>2.13.4.1.2. Konfiguration der Bankkonten</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Bankkonten</em></span> muss bei
|
||
|
mindestens einem Bankkonto die Option <span class="emphasis"><em>Nutzung mit
|
||
|
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
|
||
|
QR-Referenz</strong></span> muss dieses Konto unter IBAN eine gültige
|
||
| ... | ... | |
|
unterscheidet sich von der regulären IBAN.</p><p>Zusätzlich muss eine gültige <span class="bold"><strong>Bankkonto
|
||
|
Identifikationsnummer</strong></span> angegeben werden
|
||
|
(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
|
||
|
verwendet.</p></div><div class="sect4" title="2.13.2.1.3. Rechnungen ohne Betrag"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2718"></a>2.13.2.1.3. Rechnungen ohne Betrag</h5></div></div></div><p>Für Rechnungen ohne Betrag (z.B. Spenden) kann, in der
|
||
|
verwendet.</p></div><div class="sect4" title="2.13.4.1.3. Rechnungen ohne Betrag"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2597"></a>2.13.4.1.3. Rechnungen ohne Betrag</h5></div></div></div><p>Für Rechnungen ohne Betrag (z.B. Spenden) kann, in der
|
||
|
jeweiligen Rechnung, die Checkbox <span class="emphasis"><em>QR-Rechnung ohne
|
||
|
Betrag</em></span> aktiviert werden. Diese Checkbox erscheint nur,
|
||
|
wenn QR-Rechnungen in der Mandantenkonfiguration aktiviert sind
|
||
|
(variante ausgewählt).</p><p>Dies wirkt sich lediglich auf den erzeugten QR-Code aus. Die
|
||
|
Vorlage muss separat angepasst und ausgewählt werden.</p></div></div><div class="sect3" title="2.13.2.2. Adressdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2728"></a>2.13.2.2. Adressdaten</h4></div></div></div><p>Die Adressdaten zum Zahlungsempfänger werden aus der
|
||
|
Vorlage muss separat angepasst und ausgewählt werden.</p></div></div><div class="sect3" title="2.13.4.2. Adressdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2607"></a>2.13.4.2. Adressdaten</h4></div></div></div><p>Die Adressdaten zum Zahlungsempfänger werden aus der
|
||
|
Mandantenkonfiguration entnommen. Unter <span class="emphasis"><em>System →
|
||
|
Mandantenkonfiguration → Verschiedenes</em></span>, Abschnitt
|
||
|
<span class="emphasis"><em>Firmenname und -adresse.</em></span>
|
||
| ... | ... | |
|
z.B. "Schweiz" oder "CH".</p><p>Die Adressdaten können in der Vorlage mit den jeweiligen
|
||
|
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>
|
||
|
</p><p>Der erzeugte QR-Code verwendet Adress-Typ "K" (Kombinierte
|
||
|
Adressfelder, 2 Zeilen).</p></div><div class="sect3" title="2.13.2.3. Referenznummer"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2749"></a>2.13.2.3. Referenznummer</h4></div></div></div><p>Die Referenznummer wird in Kivitendo erzeugt und setzt sich
|
||
|
Adressfelder, 2 Zeilen).</p></div><div class="sect3" title="2.13.4.3. Referenznummer"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2628"></a>2.13.4.3. Referenznummer</h4></div></div></div><p>Die Referenznummer wird in Kivitendo erzeugt und setzt sich
|
||
|
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
|
||
|
aufgefüllt)</p></li><li class="listitem"><p>Rechnungsnummer (14-stellig, mit führenden Nullen
|
||
|
aufgefüllt)</p></li><li class="listitem"><p>Prüfziffer (1-stellig, berechnet mittels modulo 10,
|
||
|
rekursiv)</p></li></ul></div><p>Es sind lediglich Ziffern erlaubt. Allfällige Buchstaben und
|
||
|
Sonderzeichen werden entfernt und fehlende Stellen werden mit
|
||
|
führenden Nullen aufgefüllt.</p></div><div class="sect3" title="2.13.2.4. Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2769"></a>2.13.2.4. Vorlage</h4></div></div></div><p>Der Vorlagensatz "rev-odt" enthält die Vorlage
|
||
|
führenden Nullen aufgefüllt.</p></div><div class="sect3" title="2.13.4.4. Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2648"></a>2.13.4.4. Vorlage</h4></div></div></div><p>Der Vorlagensatz "rev-odt" enthält die Vorlage
|
||
|
<code class="literal">invoice_qr.odt</code>, welche für die Erstellung von
|
||
|
QR-Rechnungen vorgesehen ist. Damit diese verwendet werden kann muss
|
||
|
wie obenstehend beschrieben ein Drucker hinzugefügt werden, allerdings
|
||
|
mit dem Vorlagenkürzel <code class="literal">qr</code> (siehe <a class="xref" href="ch02s13.html#opendocument-druckvorlagen-mit-makros.vorbereitungen" title="2.13.1.2. Vorbereitungen im Adminbereich">Abschnitt 2.13.1.2, „Vorbereitungen im Adminbereich“</a>).
|
||
|
mit dem Vorlagenkürzel <code class="literal">qr</code> (siehe <a class="xref" href="ch02s13.html#opendocument-druckvorlagen-mit-makros.vorbereitungen" title="2.13.3.1. Adminbereich">Abschnitt 2.13.3.1, „Adminbereich“</a>).
|
||
|
Weitere Vorlagen für die QR-Rechnung müssen im Dateinamen, bzw.
|
||
|
Vorlagenkürzel, ebenfalls die Zeichenfolge <code class="literal">qr</code>
|
||
|
enthalten, also z.b. <code class="literal">invoice_qr2.odt</code> etc.</p><p>Die Vorlagen können beliebig angepasst werden. Zwingend müssen
|
||
| ... | ... | |
|
<span class="emphasis"><em>Bild-Kontextmenü → </em></span>
|
||
|
<span class="emphasis"><em>Einstellungen →
|
||
|
Optionen → Name</em></span> einstellbar. Siehe dazu auch die
|
||
|
Beispielvorlage.</p><div class="sect4" title="2.13.2.4.1. Zusätzliche Variablen für Vorlage"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2799"></a>2.13.2.4.1. Zusätzliche Variablen für Vorlage</h5></div></div></div><p>Zusätzlich zu den in der Vorlage standardmässig verfügbaren
|
||
|
Beispielvorlage.</p><div class="sect4" title="2.13.4.4.1. Zusätzliche Variablen für Vorlage"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2678"></a>2.13.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
|
||
|
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>),
|
||
|
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
|
||
|
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,
|
||
Auch abrufbar als: Unified diff
Dokumentation: Abschnitt zu OpenDocument-Vorlagen aktualisiert