Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision a19c4575

Von Jan Büren vor mehr als 1 Jahr hinzugefügt

  • ID a19c4575fead9a132dad241f6dda619442266f31
  • Vorgänger 18ad9bd4
  • Nachfolger 84ea0924

Anleitung für installation mit Ansible hinzugefüegt

Unterschiede anzeigen:

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>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<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>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s15.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.13. OpenDocument-Vorlagen&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;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>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<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&nbsp;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&nbsp;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&nbsp;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>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s15.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.13. Drucken mit kivitendo&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.15. Nomenklatur</td></tr></table></div></body></html>

Auch abrufbar als: Unified diff