Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision cabf507c

Von Bernd Bleßmann vor 29 Tagen hinzugefügt

  • ID cabf507c187b4d02c0b56910e14ce3b9a9342391
  • Vorgänger be483b2c
  • Nachfolger 2259d609

Doku neu gebaut

Unterschiede anzeigen:

doc/html/ch02s15.html
1 1
<html><head>
2 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.0: 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>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<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
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.1: 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>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<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 4
      OpenDocument-Format, wie es LibreOffice oder OpenOffice (ab Version 2)
5 5
      erzeugen. kivitendo kann dabei sowohl neue OpenDocument-Dokumente als
6 6
      auch aus diesen direkt PDF-Dateien erzeugen. Nachfolgend ist die
7 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="d0e3081"></a>2.15.1. Grundeinstellung</h3></div></div></div><p>Um die Unterstützung von OpenDocument-Vorlagen zu aktivieren,
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="d0e3083"></a>2.15.1. Grundeinstellung</h3></div></div></div><p>Um die Unterstützung von OpenDocument-Vorlagen zu aktivieren,
9 9
        muss in der Datei <code class="filename">config/kivitendo.conf</code> die
10 10
        Variable <code class="literal">opendocument</code>, im Abschnitt
11 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="d0e3098"></a>2.15.2. Direkte Erzeugung von PDF-Dateien</h3></div></div></div><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
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="d0e3100"></a>2.15.2. Direkte Erzeugung von PDF-Dateien</h3></div></div></div><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
13 13
        weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
14 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 15
        <code class="filename">config/kivitendo.conf</code>, im Abschnitt
16 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="d0e3115"></a>2.15.2.1. Variante 1)</h4></div></div></div><p>In der Standardeinstellung wird LibreOffice für jedes Dokument
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="d0e3117"></a>2.15.2.1. Variante 1)</h4></div></div></div><p>In der Standardeinstellung wird LibreOffice für jedes Dokument
18 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="d0e3120"></a>2.15.2.2. Variante 2)</h4></div></div></div><p>Die zweite Variante startet ein LibreOffice, das auch nach der
19
          erforderlich.</p></div><div class="sect3" title="2.15.2.2. Variante 2)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3122"></a>2.15.2.2. Variante 2)</h4></div></div></div><p>Die zweite Variante startet ein LibreOffice, das auch nach der
20 20
          Umwandlung des Dokumentes gestartet bleibt. Bei weiteren
21 21
          Umwandlungen wird dann diese laufende Instanz benutzt. Der Vorteil
22 22
          ist, dass die Zeit zur Umwandlung möglicherweise reduziert wird,
......
29 29
          <code class="literal">python_uno_path</code> in der Konfigurationsdatei
30 30
          <code class="filename">config/kivitendo.conf</code> dienen zur Anpassung der
31 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="d0e3149"></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
32
          sein.</p></div></div><div class="sect2" title="2.15.3. Vorbereitungen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e3151"></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 33
          Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit
34 34
          Einzahlungsschein) auswählbar sind, muss für jedes Vorlagen-Suffix
35 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
......
38 38
              Aufträgen oder Rechnungen als odt-Datei keine Bedeutung, darf
39 39
              aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel → besr bzw. selbst gewähltes Vorlagensuffix
40 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="d0e3176"></a>2.15.3.2. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
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="d0e3178"></a>2.15.3.2. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
42 42
          im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann
43 43
          dies persönlich für sich bei den Benutzereinstellungen
44 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="d0e3200"></a>2.15.3.3. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer
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="d0e3202"></a>2.15.3.3. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer
46 46
          odt-Rechnung (analog bei Auftrag)</h4></div></div></div><p>Im Fussbereich der Rechnungsmaske muss neben Rechnung,
47 47
          OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte
48 48
          Druckerbeschreibung ausgewählt werden, falls diese nicht bereits bei
49 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="d0e3205"></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
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="d0e3207"></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 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 52
        Payment Standards, Version 2.2</a>. Implementiert sind hierbei die
53 53
        Varianten:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
......
55 55
            QR-Referenz</strong></span>
56 56
                  </p></li><li class="listitem"><p>
57 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="d0e3226"></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="d0e3229"></a>2.15.4.1.1. Mandantenkonfiguration</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Mandantenkonfiguration →
58
                  </p></li></ul></div><div class="sect3" title="2.15.4.1. Einstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e3228"></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="d0e3231"></a>2.15.4.1.1. Mandantenkonfiguration</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Mandantenkonfiguration →
59 59
            Features</em></span>. Im Abschnitt <span class="emphasis"><em>Einkauf und
60 60
            Verkauf</em></span>, beim Punkt <span class="emphasis"><em>Verkaufsrechnungen mit
61 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="d0e3243"></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
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="d0e3245"></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 63
            mindestens einem Bankkonto die Option <span class="emphasis"><em>Nutzung mit
64 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 65
              QR-Referenz</strong></span> muss dieses Konto unter IBAN eine gültige
......
67 67
              unterscheidet sich von der regulären IBAN.</p><p>Zusätzlich muss eine gültige <span class="bold"><strong>Bankkonto
68 68
              Identifikationsnummer</strong></span> angegeben werden
69 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="d0e3277"></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
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="d0e3279"></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 71
            jeweiligen Rechnung, die Checkbox <span class="emphasis"><em>QR-Rechnung ohne
72 72
            Betrag</em></span> aktiviert werden. Diese Checkbox erscheint nur,
73 73
            wenn QR-Rechnungen in der Mandantenkonfiguration aktiviert sind
74 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="d0e3287"></a>2.15.4.2. Adressdaten</h4></div></div></div><p>Die Adressdaten zum Zahlungsempfänger werden aus der
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="d0e3289"></a>2.15.4.2. Adressdaten</h4></div></div></div><p>Die Adressdaten zum Zahlungsempfänger werden aus der
76 76
          Mandantenkonfiguration entnommen. Unter <span class="emphasis"><em>System →
77 77
          Mandantenkonfiguration → Verschiedenes</em></span>, Abschnitt
78 78
          <span class="emphasis"><em>Firmenname und -adresse.</em></span>
......
82 82
          z.B. "Schweiz" oder "CH".</p><p>Die Adressdaten können in der Vorlage mit den jeweiligen
83 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 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="d0e3308"></a>2.15.4.3. Referenznummer</h4></div></div></div><p>Die Referenznummer wird in Kivitendo erzeugt und setzt sich
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="d0e3310"></a>2.15.4.3. Referenznummer</h4></div></div></div><p>Die Referenznummer wird in Kivitendo erzeugt und setzt sich
86 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 87
              aufgefüllt)</p></li><li class="listitem"><p>Rechnungsnummer (14-stellig, mit führenden Nullen
88 88
              aufgefüllt)</p></li><li class="listitem"><p>Prüfziffer (1-stellig, berechnet mittels modulo 10,
89 89
              rekursiv)</p></li></ul></div><p>Es sind lediglich Ziffern erlaubt. Allfällige Buchstaben und
90 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="d0e3328"></a>2.15.4.4. Vorlage</h4></div></div></div><p>Der Vorlagensatz "rev-odt" enthält die Vorlage
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="d0e3330"></a>2.15.4.4. Vorlage</h4></div></div></div><p>Der Vorlagensatz "rev-odt" enthält die Vorlage
92 92
          <code class="literal">invoice_qr.odt</code>, welche für die Erstellung von
93 93
          QR-Rechnungen vorgesehen ist. Damit diese verwendet werden kann muss
94 94
          wie obenstehend beschrieben ein Drucker hinzugefügt werden, allerdings
......
103 103
          <span class="emphasis"><em>Bild-Kontextmenü → </em></span>
104 104
                  <span class="emphasis"><em>Einstellungen →
105 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="d0e3358"></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
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="d0e3360"></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 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 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 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,

Auch abrufbar als: Unified diff