Revision a19c4575
Von Jan Büren vor mehr als 1 Jahr hinzugefügt
doc/html/ch02s14.html | ||
---|---|---|
1 | 1 |
<html><head> |
2 | 2 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
3 |
<title>2.14. Nomenklatur</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.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s13.html" title="2.13. OpenDocument-Vorlagen"><link rel="next" href="ch02s15.html" title="2.15. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung: EUR"></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.14. Nomenklatur</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s13.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="ch02s15.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.14. Nomenklatur"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="nomenclature"></a>2.14. Nomenklatur</h2></div></div></div><div class="sect2" title="2.14.1. Datum bei Buchungen"><div class="titlepage"><div><div><h3 class="title"><a name="booking.dates"></a>2.14.1. Datum bei Buchungen</h3></div></div></div><p>Seit der Version 3.5 werden für Buchungen in kivitendo |
|
4 |
einheitlich folgende Bezeichnungen verwendet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> |
|
5 |
<code class="option">Erfassungsdatum</code> (en: <code class="option">Entry |
|
6 |
Date</code>, code: <code class="option">Gldate</code>)</p><p>bezeichnet das Datum, an dem die Buchung in kivitendo |
|
7 |
erfasst wurde.</p></li><li class="listitem"><p> |
|
8 |
<code class="option">Buchungsdatum</code> (en: <code class="option">Booking |
|
9 |
Date</code>, code: <code class="option">Transdate</code>)</p><p>bezeichnet das buchhaltungstechnisch für eine Buchung |
|
10 |
relevante Datum</p><p>Das <code class="option">Rechnungsdatum</code> bei Verkaufs- und |
|
11 |
Einkaufsrechnungen entspricht dem Buchungsdatum. Das heisst, in |
|
12 |
Berichten wie dem Buchungsjournal, in denen eine Spalte |
|
13 |
<code class="option">Buchungsdatum</code> angezeigt werden kann, erscheint |
|
14 |
hier im Fall von Rechnungen das Rechnungsdatum.</p></li><li class="listitem"><p>Bezieht sich ein verbuchter Beleg auf einen Zeitpunkt, der |
|
15 |
nicht mit dem Buchungsdatum übereinstimmt, so kann dieses Datum |
|
16 |
momentan in kivitendo nur unter Bemerkungen erfasst werden.</p><p>Möglicherweise wird für solche Fälle in einer späteren |
|
17 |
Version von kivitendo ein dritter Datumswert für Buchungen |
|
18 |
erstellt. (Beispiel: Einkaufsbeleg stammt aus einem früheren Jahr, |
|
19 |
das bereits buchhaltungstechnisch abgeschlossen wurde, und muss |
|
20 |
deshalb später verbucht werden.)</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s13.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="ch02s15.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.13. OpenDocument-Vorlagen </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.15. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung: |
|
21 |
EUR</td></tr></table></div></body></html> |
|
3 |
<title>2.14. 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.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s13.html" title="2.13. Drucken mit kivitendo"><link rel="next" href="ch02s15.html" title="2.15. 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.14. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s13.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="ch02s15.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.14. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.14. 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.14.1. Grundeinstellung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2409"></a>2.14.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.14.2. Direkte Erzeugung von PDF-Dateien"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2426"></a>2.14.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.14.2.1. Variante 1)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2443"></a>2.14.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.14.2.2. Variante 2)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2448"></a>2.14.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.14.3. Vorbereitungen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2477"></a>2.14.3. Vorbereitungen</h3></div></div></div><div class="sect3" title="2.14.3.1. Adminbereich"><div class="titlepage"><div><div><h4 class="title"><a name="opendocument-druckvorlagen-mit-makros.vorbereitungen"></a>2.14.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.14.3.2. Benutzereinstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2504"></a>2.14.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.14.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="d0e2528"></a>2.14.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.14.4. Schweizer QR-Rechnung mit OpenDocument Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2533"></a>2.14.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.14.4.1. Einstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2554"></a>2.14.4.1. Einstellungen</h4></div></div></div><div class="sect4" title="2.14.4.1.1. Mandantenkonfiguration"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2557"></a>2.14.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.14.4.1.2. Konfiguration der Bankkonten"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2571"></a>2.14.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 IBAN 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.14.4.1.3. Rechnungen ohne Betrag"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2605"></a>2.14.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.14.4.2. Adressdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2615"></a>2.14.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.14.4.3. Referenznummer"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2636"></a>2.14.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.14.4.4. Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2656"></a>2.14.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="ch02s14.html#opendocument-druckvorlagen-mit-makros.vorbereitungen" title="2.14.3.1. Adminbereich">Abschnitt 2.14.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.14.4.4.1. Zusätzliche Variablen für Vorlage"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2686"></a>2.14.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="ch02s13.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="ch02s15.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.13. 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.15. Nomenklatur</td></tr></table></div></body></html> |
Auch abrufbar als: Unified diff
Anleitung für installation mit Ansible hinzugefüegt