Dokumentation: Hinweis auf neues Perl-Paket
[kivitendo-erp.git] / doc / dokumentation.xml
index c89a7fa..a2df2f6 100644 (file)
@@ -2,7 +2,7 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 <book id="kivitendo-documentation" lang="de">
-  <title>kivitendo 3.5.8: Installation, Konfiguration,
+  <title>kivitendo 3.6.0: Installation, Konfiguration,
   Entwicklung</title>
 
   <chapter id="Aktuelle-Hinweise">
             <para><literal>Imager::QRCode</literal></para>
           </listitem>
 
+          <listitem>
+            <para><literal>IPC::Run</literal></para>
+          </listitem>
+
           <listitem>
             <para><literal>JSON</literal></para>
           </listitem>
             <para><literal>Regexp::IPv6</literal></para>
           </listitem>
 
+          <listitem>
+            <para><literal>Rest::Client</literal></para>
+          </listitem>
+
           <listitem>
             <para><literal>Rose::Object</literal></para>
           </listitem>
         </itemizedlist>
 
 
-        <para>Seit Version größer v3.5.9 sind die folgenden Pakete
-        hinzugekommen: <literal>Imager</literal>,
-        <literal>Imager::QRCode</literal></para>
+        <para>Seit Version größer v3.6.0 sind die folgenden Pakete hinzugekommen: <literal>IPC::Run</literal></para>
+
+        <para>Seit Version größer v3.5.8 sind die folgenden Pakete hinzugekommen: <literal>Imager</literal>, <literal>Imager::QRCode</literal>
+<literal>Rest::Client</literal><literal>Term::ReadLine::Gnu</literal></para>
 
         <para>Seit Version größer v3.5.6 sind die folgenden Pakete hinzugekommen: <literal>Try::Tiny</literal>, <literal>Math::Round</literal></para>
         <para>Seit Version größer v3.5.6 sind die folgenden Pakete hinzugekommen: <literal>XML::LibXML</literal>, <literal>CAM::PDF</literal></para>
   libfile-mimeinfo-perl libpbkdf2-tiny-perl libregexp-ipv6-perl \
   libdatetime-event-cron-perl libexception-class-perl libcam-pdf-perl \
   libxml-libxml-perl libtry-tiny-perl libmath-round-perl \
-  libimager-perl libimager-qrcode-perl
-</programlisting>
-<para>Sollten Pakete nicht zu Verfügung stehen, so können diese auch mittels CPAN installiert werden. Ferner muss für Ubuntu das Repository "Universe" aktiv sein (s.a. Anmerkungen).</para>
+  libimager-perl libimager-qrcode-perl librest-client-perl libipc-run-perl
+          </programlisting>
+
+          <para>Sollten Pakete nicht zu Verfügung stehen, so können diese auch mittels CPAN installiert werden. Ferner muss für Ubuntu das Repository "Universe" aktiv sein (s.a. Anmerkungen).</para>
           <note id="ubuntu-universe">
             <para>Die Perl Pakete für Ubuntu befinden sich im "Universe" Repository. Falls dies nicht aktiv ist, kann dies mit folgendem Aufruf aktiviert werden:
 <programlisting>add-apt-repository universe</programlisting></para>
@@ -2228,7 +2238,7 @@ digits_year: 4</programlisting>
       </itemizedlist>
 
       <para>Der ehemalige Druckvorlagensatz "f-tex" wurde mit der Version
-      3.6 entfernt, da er nicht mehr gepflegt wird.</para>
+      3.5.6 entfernt, da er nicht mehr gepflegt wird.</para>
 
       <sect2 id="Vorlagenverzeichnis-anlegen"
              xreflabel="Vorlagenverzeichnis anlegen">
@@ -2788,17 +2798,27 @@ digits_year: 4</programlisting>
         <sect3>
           <title>Übersicht</title>
 
-          <para>Mit der Version 3.5.9 unterstützt Kivitendo die Erstellung von
+          <para>Mit der Version 3.6.0 unterstützt Kivitendo die Erstellung von
           Schweizer QR-Rechnungen gemäss <ulink
           url="https://www.paymentstandards.ch/dam/downloads/ig-qr-bill-de.pdf">Swiss
-          Payment Standards, Version 2.2</ulink>. Implementiert ist hierbei die
-          Variante: <emphasis role="bold">QR-IBAN mit
-          QR-Referenz</emphasis>.</para>
+          Payment Standards, Version 2.2</ulink>. Implementiert sind hierbei die
+          Varianten:</para>
+
+          <itemizedlist>
+            <listitem>
+              <para><emphasis role="bold">QR-IBAN mit
+              QR-Referenz</emphasis></para>
+            </listitem>
+
+            <listitem>
+              <para><emphasis role="bold">IBAN ohne Referenz</emphasis></para>
+            </listitem>
+          </itemizedlist>
 
           <para>Der Vorlagensatz "rev-odt" enthält die Vorlage
           <literal>invoice_qr.odt</literal>, welche für die Erstellung von
           QR-Rechnungen vorgesehen ist. Damit diese verwendet werden kann muss
-          wie obenstehend Beschrieben ein Drucker hinzugefügt werden (siehe
+          wie obenstehend beschrieben ein Drucker hinzugefügt werden (siehe
           <xref linkend="opendocument-druckvorlagen-mit-makros.vorbereitungen"/>
           ). Alternativ kann die Vorlage umbenannt werden in
           <literal>invoice.odt</literal>.</para>
@@ -2806,7 +2826,7 @@ digits_year: 4</programlisting>
           <para>Die Vorlage <literal>invoice_qr.odt</literal> kann beliebig
           angepasst werden. Zwingend muss diese jedoch das QR-Code Platzhalter
           Bild, als eingebettetes Bild, enthalten. Da dieses beim
-          Ausdrucken/Erzeugen der Rechnung, durch das neu generierte QR-Code
+          Ausdrucken/Erzeugen der Rechnung durch das neu generierte QR-Code
           Bild ersetzt wird.</para>
         </sect3>
 
@@ -2816,10 +2836,11 @@ digits_year: 4</programlisting>
           <sect4>
             <title>Mandantenkonfiguration</title>
 
-            <para>Unter <emphasis>System → Mandatenkonfiguration →
+            <para>Unter <emphasis>System → Mandantenkonfiguration →
             Features</emphasis>. Im Abschnitt <emphasis>Einkauf und
-            Verkauf</emphasis> muss der Punkt <emphasis>Verkaufsrechnungen mit
-            Schweizer QR-Rechnung erzeugen</emphasis> aktiviert werden.</para>
+            Verkauf</emphasis>, beim Punkt <emphasis>Verkaufsrechnungen mit
+            Schweizer QR-Rechnung erzeugen</emphasis>, die gewünschte Variante
+            wählen.</para>
           </sect4>
 
           <sect4>
@@ -2831,8 +2852,9 @@ digits_year: 4</programlisting>
             role="bold">Ja</emphasis> gestellt werden.</para>
 
             <tip>
-              <para>Dieses Konto muss unter IBAN eine gültige <emphasis
-              role="bold">QR-IBAN Nummer</emphasis> enthalten. Diese
+              <para>Für die Variante <emphasis role="bold">QR-IBAN mit
+              QR-Referenz</emphasis> muss dieses Konto unter IBAN eine gültige
+              <emphasis role="bold">QR-IBAN Nummer</emphasis> enthalten. Diese
               unterscheidet sich von der regulären IBAN.</para>
 
               <para>Zusätzlich muss eine gültige <emphasis role="bold">Bankkonto
@@ -2842,9 +2864,22 @@ digits_year: 4</programlisting>
               <para>Diese werden von der jeweiligen Bank vergeben.</para>
             </tip>
 
-            <para>Sind mehrere Konten ausgewählt, wird das erste
+            <para>Sind mehrere Konten ausgewählt wird das erste
             verwendet.</para>
           </sect4>
+
+          <sect4>
+            <title>Rechnungen ohne Betrag</title>
+
+            <para>Für Rechnungen ohne Betrag (z.B. Spenden) kann, in der
+            jeweiligen Rechnung, die Checkbox <emphasis>QR-Rechnung ohne
+            Betrag</emphasis> aktiviert werden. Diese Checkbox erscheint nur,
+            wenn QR-Rechnungen in der Mandantenkonfiguration aktiviert sind
+            (variante ausgewählt).</para>
+
+            <para>Dies wirkt sich lediglich auf den erzeugten QR-Code aus. Die
+            Vorlage muss separat angepasst und ausgewählt werden.</para>
+          </sect4>
         </sect3>
 
         <sect3>
@@ -2852,12 +2887,16 @@ digits_year: 4</programlisting>
 
           <para>Die Adressdaten zum Zahlungsempfänger werden aus der
           Mandantenkonfiguration entnommen. Unter <emphasis>System →
-          Mandatenkonfiguration → Verschiedenes</emphasis>, Abschnitt
+          Mandantenkonfiguration → Verschiedenes</emphasis>, Abschnitt
           <emphasis>Firmenname und -adresse.</emphasis></para>
 
-          <para>Die Adressdaten zum Zahlungspflichtigen, stammen aus den
+          <para>Die Adressdaten zum Zahlungspflichtigen stammen aus den
           Kundendaten der jeweiligen Rechnung.</para>
 
+          <para>Die Adressen müssen inklusive Land angegeben werden. Akzeptiert
+          werden Ländername oder Ländercode, also z.B. "Schweiz" oder "CH".
+          </para>
+
           <para>Diese können in der Vorlage mit den jeweiligen Variablen
           eingetragen werden. Siehe auch: <xref
           linkend="dokumentenvorlagen-und-variablen"/></para>