projekt kivitendo

        <para>Anfang 2012 sind das folgende Systeme, von denen bekannt ist,

        dass Lx-Office auf ihnen läuft:</para>

            <para>Ubuntu 8.04 LTS Hardy Heron, 10.04 LTS Lucid Lynx bis 11.10

            Oneiric Ocelot</para>

        linkend="Manuelle-Installation-des-Programmpaketes" />), wenn vorher

        linkend="Pakete" />) die enthaltenen Pakete erkennen.</para>

      <title>Lx-Office-Konfigurationsdatei</title>

      <sect2 id="config.config-file.introduction"

             xreflabel="Einführung in die Konfigurationsdatei">

        <title>Einführung</title>

        <para>Seit Lx-Office 2.6.3. gibt es nur noch eine Konfigurationsdatei

        die benötigt wird: <filename>config/lx_office.conf</filename> (kurz:

        "die Hauptkonfigurationsdatei"). Diese muss bei der Erstinstallation

        von Lx-Office bzw. der Migration von älteren Versionen angelegt

        werden.</para>

        <para>Als Vorlage dient die Datei

        <filename>config/lx_office.conf.default</filename> (kurz: "die

        Default-Datei"):</para>

        <programlisting>$ cp config/lx_office.conf.default config/lx_office.conf</programlisting>

        <para>Die Default-Datei wird immer zuerst eingelesen. Werte, die in

        der Hauptkonfigurationsdatei stehen, überschreiben die Werte aus der

        Default-Datei. Die Hauptkonfigurationsdatei muss also nur die

        Abschintte und Werte enthalten, die von denen der Default-Datei

        abweichen.</para>

        <para>Diese Hauptkonfigurationsdatei ist dann eine

        installationsspezifische Datei, d.h. sie enthält bspw. lokale

        Passwörter und wird auch nicht im Versionsmanagement (git)

        verwaltet.</para>

        <para>Die Konfiguration ist ferner serverabhängig, d.h. für alle

        Mandaten, bzw. Datenbanken gleich.</para>

      </sect2>

      <sect2 id="config.config-file.sections-parameters">

        <title>Abschnitte und Parameter</title>

        <para>Die Konfigurationsdatei besteht aus mehreren Teilen, die

        entsprechend kommentiert sind:</para>

        <itemizedlist>

          <listitem>

            <para><literal>authentication</literal></para>

          </listitem>

          <listitem>

            <para><literal>authentication/database</literal></para>

          </listitem>

          <listitem>

            <para><literal>authentication/ldap</literal></para>

          </listitem>

          <listitem>

            <para><literal>system</literal></para>

          </listitem>

          <listitem>

            <para><literal>features</literal></para>

          </listitem>

          <listitem>

            <para><literal>paths</literal></para>

          </listitem>

          <listitem>

            <para><literal>applications</literal></para>

          </listitem>

          <listitem>

            <para><literal>environment</literal></para>

          </listitem>

          <listitem>

            <para><literal>print_templates</literal></para>

          </listitem>

          <listitem>

            <para><literal>task_server</literal></para>

          </listitem>

          <listitem>

            <para><literal>periodic_invoices</literal></para>

          </listitem>

          <listitem>

            <para><literal>console</literal></para>

          </listitem>

          <listitem>

            <para><literal>debug</literal></para>

          </listitem>

        </itemizedlist>

        <para>Die üblicherweise wichtigsten Parameter, die am Anfang

        einzustellen oder zu kontrollieren sind, sind:</para>

        <programlisting>[authentication]

        <para>Nutzt man wiederkehrende Rechnungen, kann man unter

        <varname>[periodic_invoices]</varname> den Login eines Benutzers

        angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail

        mit Informationen über die erstellten Rechnungen bekommt.</para>

        <para>Nutzt man den <link

        linkend="config.task-server">Taskserver</link> für <link

        linkend="features.periodic-invoices">wiederkehrende Rechnungen</link>,

        muss unter <varname>[task_server]</varname> ein Login eines Benutzers

        angegeben werden, mit dem sich der Taskserver an Lx-Office bei der

        Datenbank anmeldet, die dem Benutzer zugewiesen ist.</para>

        <para>Für Entwickler finden sich unter <varname>[debug]</varname>

        wichtige Funktionen, um die Fehlersuche zu erleichtern.</para>

      </sect2>

      <sect2 id="config.config-file.prior-versions">

        <title>Versionen vor 2.6.3</title>

        <para>In älteren Lx-Office Versionen gab es im Verzeichnis

        <filename>config</filename> die Dateien

        <filename>authentication.pl</filename> und

        <filename>lx-erp.conf</filename>, die jeweils Perl-Dateien waren. Es

        gab auch die Möglichkeit, eine lokale Version der Konfigurationsdatei

        zu erstellen (<filename>lx-erp-local.conf</filename>). Dies ist ab

        2.6.3 nicht mehr möglich, aber auch nicht mehr nötig.</para>

        <para>Beim Update von einer Lx-Office-Version vor 2.6.3 auf 2.6.3 oder

        jünger müssen die Einstellungen aus den alten Konfigurationsdateien

        manuell übertragen und die alten Konfigurationsdateien anschließend

        gelöscht oder verschoben werden. Ansonsten zeigt Lx-Office eine

        entsprechende Fehlermeldung an.</para>

      </sect2>

        <para>Dieses ist kann überprüft werden: ist das Encoding der Datenbank

        “template1” “UTF8”, so kann auch Lx-Office mit UTF-8 betrieben werden.

        Andernfalls ist es notwendig, einen neuen Datenbankcluster mit

        UTF-8-Encoding anzulegen und diesen zu verwenden. Unter Debian und

        Ubuntu kann dies z.B. für PostgreSQL 8.2 mit dem folgenden Befehl

        getan werden:</para>

        <para>Die Datenbankversionsnummer muss an die tatsächlich verwendete

        Versionsnummer angepasst werden.</para>

        <para>Das Encoding einer Datenbank kann in <command>psql</command> mit

        <literal>\l</literal> geprüft werden.</para>

        <filename>/etc/postgresql/</filename>, muss sichergestellt werden,

        dass TCP/IP-Verbindungen aktiviert sind. Das Verhalten wird über den

        Verzeichnis wie die <filename>postgresql.conf</filename> zu finden

        sein sollte, müssen die Berichtigungen für den Zugriff geändert

        werden. Hier gibt es mehrere Möglichkeiten. Eine besteht darin, lokale

          <xref linkend="Apache-Konfiguration.FCGI" /> beschrieben.</para>

          <para>Vor den einzelnen Optionen muss bei einigen Distributionen ein

          Plus ‘<literal>+</literal>’ gesetzt werden.</para>

            <para>FCGI 0.69 und höher ist extrem strict in der Behandlung von

            Unicode, und verweigert bestimmte Eingaben von Lx-Office. Falls es

            Probleme mit Umlauten in Ihrere Installation gibt, muss auf die

            Vorgängerversion FCGI 0.68 ausgewichen werden.</para>

            <para>Mit CPAN lässt sie sich die Vorgängerversion wie folgt

            installieren:</para>

          <para>Dann ist unter <filename>/url/for/lx-office-erp/</filename>

          die normale Version erreichbar, und unter

          <constant>/url/for/lx-office-erp-fcgid/</constant> die

          FastCGI-Version.</para>

          <varlistentry>

            <term><varname>login</varname></term>

            <listitem>

              <para>gültiger Lx-Office-Benutzername, der benutzt wird, um die

              zu verwendende Datenbankverbindung auszulesen. Der Benutzer muss

              in der Administration angelegt werden. Diese Option muss

              angegeben werden.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><varname>run_as</varname></term>

            <listitem>

              <para>Wird der Server vom Systembenutzer <literal>root</literal>

              gestartet, so wechselt er auf den mit <literal>run_as</literal>

              angegebenen Systembenutzer. Der Systembenutzer muss dieselben

              Lese- und Schreibrechte haben, wie auch der Webserverbenutzer

              (siehe see <xref

              linkend="Manuelle-Installation-des-Programmpaketes" />). Daher

              ist es sinnvoll, hier denselben Systembenutzer einzutragen,

              unter dem auch der Webserver läuft.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><varname>debug</varname></term>

            <listitem>

              <para>Schaltet Debug-Informationen an und aus.</para>

            </listitem>

          </varlistentry>

          <para>Danach kann der Task-Server mit dem folgenden Befehl gestartet

          werden: <command>/etc/init.d/lx-office-task-server

          <para>Danach kann der Task-Server mit dem folgenden Befehl gestartet

          werden: <command>service lx-office-task-server

        <para>Das Passwort, das zum Zugriff auf das Aministrationsinterface

        benutzt wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch

        nur dort und nicht mehr im Administrationsinterface selber geändert

        werden. Der Parameter dazu heißt <varname>admin_password</varname> im

        Abschnitt <varname>[authentication]</varname>.</para>

        <para>Die Verbindung zur Authentifizierungsdatenbank wird mit den

        Parametern in <varname>[authentication/database]</varname>

        konfiguriert. Hier sind die folgenden Parameter anzugeben:</para>

          <varlistentry>

            <term><literal>host</literal></term>

            <listitem>

              <para>Der Rechnername oder die IP-Adresse des

              Datenbankservers</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>port</literal></term>

            <listitem>

              <para>Die Portnummer des Datenbankservers, meist 5432</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>db</literal></term>

            <listitem>

              <para>Der Name der Authentifizierungsdatenbank</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>user</literal></term>

            <listitem>

              <para>Der Benutzername, mit dem sich Lx-Office beim

              Datenbankserver anmeldet (z.B.

              "<literal>postgres</literal>")</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>password</literal></term>

            <listitem>

              <para>Das Passwort für den Datenbankbenutzer</para>

            </listitem>

          </varlistentry>

        <para>Lx-Office unterstützt Passwortüberprüfung auf zwei Arten: gegen

        die Authentifizierungsdatenbank und gegen einen externen LDAP- oder

        Active-Directory-Server. Welche davon benutzt wird, regelt der

        Parameter <varname>module</varname> im Abschnitt

        <para>Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank

        gespeichert werden, so muss der Parameter <varname>module</varname>

        den Wert <literal>DB</literal> enthalten. In diesem Fall können sowohl

        der Administrator als auch die Benutzer selber ihre Psaswörter in

        Lx-Office ändern.</para>

        <para>Soll hingegen ein externer LDAP- oder Active-Directory-Server

        benutzt werden, so muss der Parameter <varname>module</varname> auf

        <literal>LDAP</literal> gesetzt werden. In diesem Fall müssen

        zusätzliche Informationen über den LDAP-Server im Abschnitt

          <varlistentry>

            <term><literal>host</literal></term>

            <listitem>

              <para>Der Rechnername oder die IP-Adresse des LDAP- oder

              Active-Directory-Servers. Diese Angabe ist zwingend

              erforderlich.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>port</literal></term>

            <listitem>

              <para>Die Portnummer des LDAP-Servers; meist 389.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>tls</literal></term>

            <listitem>

              <para>Wenn Verbindungsverschlüsselung gewünscht ist, so diesen

              Wert auf ‘<literal>1</literal>’ setzen, andernfalls auf

              ‘<literal>0</literal>’ belassen</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>attribute</literal></term>

            <listitem>

              <para>Das LDAP-Attribut, in dem der Benutzername steht, den der

              Benutzer eingegeben hat. Für Active-Directory-Server ist dies

              meist ‘<literal>sAMAccountName</literal>’, für andere

              LDAP-Server hingegen ‘<literal>uid</literal>’. Diese Angabe ist

              zwingend erforderlich.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>base_dn</literal></term>

            <listitem>

              <para>Der Abschnitt des LDAP-Baumes, der durchsucht werden soll.

              Diese Angabe ist zwingend erforderlich.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>filter</literal></term>

            <listitem>

              <para>Ein optionaler LDAP-Filter. Enthält dieser Filter das Wort

              <literal>&lt;%login%&gt;</literal>, so wird dieses durch den vom

              Benutzer eingegebenen Benutzernamen ersetzt. Andernfalls wird

              der LDAP-Baum nach einem Element durchsucht, bei dem das oben

              angegebene Attribut mit dem Benutzernamen identisch ist.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><literal>bind_dn</literal> und

            <literal>bind_password</literal></term>

            <listitem>

              <para>Wenn der LDAP-Server eine Anmeldung erfordert, bevor er

              durchsucht werden kann (z.B. ist dies bei

              Active-Directory-Servern der Fall), so kann diese hier angegeben

              werden. Für Active-Directory-Server kann als

              ‘<literal>bind_dn</literal>’ entweder eine komplette LDAP-DN wie

              z.B. ‘<literal>cn=Martin

              Mustermann,cn=Users,dc=firmendomain</literal>’ auch nur der

              volle Name des Benutzers eingegeben werden; in diesem Beispiel

              also ‘<literal>Martin Mustermann</literal>’.</para>

            </listitem>

          </varlistentry>

        <para>Sollen auf einem Server mehrere Lx-Office-Installationen

        aufgesetzt werden, so müssen die Namen der Session-Cookies für alle

        Installationen unterschiedlich sein. Der Name des Cookies wird mit dem

        Parameter <varname>cookie_name</varname> im Abschnitt

      linkend="Manuelle-Installation-des-Programmpaketes" />), kann aber

      erneut überprüft werden, wenn die Konvertierung nach PDF

      fehlschlägt.</para>

      <title>Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:

      EUR</title>

      <sect2 id="config.eur.introduction"

             xreflabel="Einführung in die Konfiguration zur EUR">

        <title>Einführung</title>

        <para>Lx-Office besaß bis inklusive Version 2.6.3 einen

        Konfigurationsparameter namens <varname>eur</varname>, der sich in der

        Konfigurationsdatei <filename>config/lx_office.conf</filename>

        befindet. Somit galt er für alle Mandanten, die in dieser Installation

        benutzt wurden.</para>

        <para>Mit der nachfolgenden Version wurde der Parameter zum Einen in

        die Mandantendatenbank verschoben und dabei auch gleich in drei

        Einzelparameter aufgeteilt, mit denen sich das Verhalten genauer

        steuern lässt.</para>

      <sect2 id="config.eur.parameters"

             xreflabel="Konfigurationsparameter für EUR">

        <title>Konfigurationsparameter</title>

        <para>Es gibt drei Parameter, die die Gewinnermittlungsart,

        Versteuerungsart und die Warenbuchungsmethode regeln:</para>

        <variablelist>

          <varlistentry>

            <term><varname>profit_determination</varname></term>

            <listitem>

              <para>Dieser Parameter legt die Berechnungsmethode für die

              Gewinnermittlung fest. Er enthält entweder

              <literal>balance</literal> für

              Betriebsvermögensvergleich/Bilanzierung oder

              <literal>income</literal> für die

              Einnahmen-Überschuss-Rechnung.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><varname>accounting_method</varname></term>

            <listitem>

              <para>Dieser Parameter steuert die Buchungs- und

              Berechnungsmethoden für die Versteuerungsart. Er enthält

              entweder <literal>accrual</literal> für die Soll-Versteuerung

              oder <literal>cash</literal> für die Ist-Versteuerung.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term><varname>inventory_system</varname></term>

            <listitem>

              <para>Dieser Parameter legt die Warenbuchungsmethode fest. Er

              enthält entweder <literal>perpetual</literal> für die

              Bestandsmethode oder <literal>periodic</literal> für die

              Aufwandsmethode.</para>

            </listitem>

          </varlistentry>

        </variablelist>

        <para>Zum Vergleich der Funktionalität bis und nach 2.6.3:

        <varname>eur</varname> = 1 bedeutete Einnahmen-Überschuss-Rechnung,

        Ist-Versteuerung und Aufwandsmethode. <varname>eur</varname> = 0

        bedeutete hingegen Bilanzierung, Soll-Versteuerung und

        Bestandsmethode.</para>

        <para>Die Konfiguration "<varname>eur</varname>" unter

        <varname>[system]</varname> in der <link

        linkend="config.config-file">Konfigurationsdatei</link>

        <filename>config/lx_office.conf</filename> wird nun nicht mehr

        benötigt und kann entfernt werden. Dies muss manuell geschehen.</para>

        <title>Festlegen der Parameter</title>

        <para>Beim Anlegen eines neuen Mandanten bzw. einer neuen Datenbank in

        der Admininstration können diese Optionen nun unabhängig voneinander

        eingestellt werden.</para>

        <para>Beim Upgrade bestehender Mandanten wird eur ausgelesen und die

        Variablen werden so gesetzt, daß sich an der Funktionalität nichts

        ändert.</para>

        <para>Die aktuelle Konfiguration wird unter Nummernkreise und

        Standardkonten unter dem neuen Punkt "Einstellungen" angezeigt

        (read-only). Eine spätere Änderung ist für einen bestehenden Mandanten

        nicht mehr möglich. Dies war auch vorher nicht möglich, bzw.

        vorhandene Daten wurden so belassen und haben damit die Ergebnisse

        verfälscht.</para>

        <title>Bemerkungen zu Bestandsmethode</title>

        <para>Die Bestandsmethode ist eigentlich eine sehr elegante Methode,

        funktioniert in Lx-Office aber nur unter bestimmten Bedingungen:

        Voraussetzung ist, daß auch immer alle Einkaufsrechnungen gepflegt

        werden, und man beim Jahreswechsel nicht mit einer leeren Datenbank

        anfängt, da bei jedem Verkauf anhand der gesamten Rechnungshistorie

        der Einkaufswert der Ware nach dem FIFO-Prinzip aus den

        Einkaufsrechnungen berechnet wird.</para>

        <para>Die Bestandsmethode kann vom Prinzip her also nur funktioneren,

        wenn man mit den Buchungen bei Null anfängt, und man kann auch nicht

        im laufenden Betrieb von der Aufwandsmethode zur Bestandsmethode

        wechseln.</para>

        <title>Bekannte Probleme</title>

        <para>Bei bestimmten Berichten kann man derzeit noch inviduell

        einstellen, ob man nach Ist- oder Sollversteuerung auswertet, und es

        werden im Code Variablen wie $accrual oder $cash gesetzt. Diese

        Codestellen wurden noch nicht angepasst, sondern nur die, wo bisher

        die Konfigurationsvariable

        <varname>$::lx_office_conf{system}-&gt;{eur}</varname> ausgewertet

        wurde.</para>

        <para>Es fehlen Hilfetext beim Neuanlegen eines Mandanten, was die

        Optionen bewirken, z.B. mit zwei Standardfällen.</para>

      </sect2>

    </sect1>

    <sect1 id="config.skr04-update-3804">

      <title>SKR04 19% Umstellung für innergemeinschaftlichen Erwerb</title>

      <sect2 id="config.skr04-update-3804.introduction">

        <title>Einführung</title>

        <para>Die Umsatzsteuerumstellung auf 19% für SKR04 für die

        Steuerschlüssel "EU ohne USt-ID Nummer" ist erst 2010 erfolgt.

        Lx-Office beinhaltet ein Upgradeskript, das das Konto 3804 automatisch

        erstellt und die Steuereinstellungen korrekt einstellt. Hat der

        Benutzer aber schon selber das Konto 3804 angelegt, oder gab es schon

        Buchungen im Zeitraum nach dem 01.01.2007 auf das Konto 3803, wird das

        Upgradeskript vorsichtshalber nicht ausgeführt, da der Benutzer sich

        vielleicht schon selbst geholfen hat und mit seinen Änderungen

        zufrieden ist. Die korrekten Einstellungen kann man aber auch per Hand

        ausführen. Nachfolgend werden die entsprechenden Schritte anhand von

        Screenshots dargestellt.</para>

        <para>Für den Fall, daß Buchungen mit der Steuerschlüssel "EU ohne

        USt.-IdNr." nach dem 01.01.2007 erfolgt sind, ist davon auszugehen,

        dass diese mit dem alten Umsatzsteuersatz von 16% gebucht worden sind,

        und diese Buchungen sollten entsprechend kontrolliert werden.</para>

      </sect2>

      <sect2 id="config.skr04-update-3804.create-chart">

        <title>Konto 3804 manuell anlegen</title>

        <para>Die folgenden Schritte sind notwendig, um das Konto manuell

        anzulegen und zu konfigurieren. Zuerst wird in

        <guimenu>System</guimenu> -&gt;

        <guisubmenu>Kontenübersicht</guisubmenu> -&gt; <guimenuitem>Konto

        erfassen</guimenuitem> das Konto angelegt.</para>

        <screenshot>

          <screeninfo>Konto 3804 erfassen</screeninfo>

          <mediaobject>

            <imageobject>

              <imagedata fileref="images/skr04-update-3804/konto3804.png" />

            </imageobject>

          </mediaobject>

        </screenshot>

        <para>

         Als Zweites muss Steuergruppe 13 für Konto 3803 angepasst werden. Dazu unter <guimenu>System</guimenu> -&gt;

         <guisubmenu>Steuern</guisubmenu> -&gt; <guimenuitem>Bearbeiten</guimenuitem> den Eintrag mit Steuerschlüssel 13 auswählen und ihn

         wie im folgenden Screenshot angezeigt anpassen.

        </para>

        <screenshot>

          <screeninfo>Steuerschlüssel 13 für 3803 (16%) anpassen</screeninfo>

          <mediaobject>

            <imageobject>

              <imagedata fileref="images/skr04-update-3804/steuer3803.png" />

            </imageobject>

          </mediaobject>

        </screenshot>

        <para>

         Als Drittes wird ein neuer Eintrag mit Steuerschlüssel 13 für Konto 3804 (19%) angelegt. Dazu unter <guimenu>System</guimenu> -&gt;

         <guisubmenu>Steuern</guisubmenu> -&gt; <guimenuitem>Erfassen</guimenuitem> auswählen und die Werte aus dem Screenshot übernehmen.

        </para>

        <screenshot>

          <screeninfo>Steuerschlüssel 13 für 3804 (19%) anlegen</screeninfo>

          <mediaobject>

            <imageobject>

              <imagedata fileref="images/skr04-update-3804/steuer3804.png" />

            </imageobject>

          </mediaobject>

        </screenshot>

        <para>

         Als Nächstes sind alle Konten anzupassen, die als Steuerautomatikkonto die 3803 haben, sodass sie ab dem 1.1.2007 auch

         Steuerautomatik auf 3804 bekommen. Dies betrifft in der Standardkonfiguration die Konten 4315 und 4726. Als Beispiel für 4315

         müssen Sie dazu unter <guimenu>System</guimenu> -&gt; <guisubmenu>Kontenübersicht</guisubmenu> -&gt; <guimenuitem>Konten

         anzeigen</guimenuitem> das Konto 4315 anklicken und die Einstellungen wie im Screenshot gezeigt vornehmen.

        </para>

        <screenshot>

          <screeninfo>Konto 4315 anpassen</screeninfo>

          <mediaobject>

            <imageobject>

              <imagedata fileref="images/skr04-update-3804/konto4315.png" />

            </imageobject>

          </mediaobject>

        </screenshot>

        <para>

         Als Letztes sollte die Steuerliste unter <guimenu>System</guimenu> -&gt; <guisubmenu>Steuern</guisubmenu> -&gt;

         <guimenuitem>Bearbeiten</guimenuitem> kontrolliert werden. Zum Vergleich der Screenshot.

        </para>

        <screenshot>

          <screeninfo>Steuerliste vergleichen</screeninfo>

          <mediaobject>

            <imageobject>

              <imagedata fileref="images/skr04-update-3804/steuerliste.png" />

            </imageobject>

          </mediaobject>

        </screenshot>

    <sect1 id="features.periodic-invoices"

           xreflabel="Wiedekehrende Rechnungen">

      <title>Wiederkehrende Rechnungen</title>

      <sect2 id="features.periodic-invoices.introduction"

             xreflabel="Einführung in wiederkehrende Rechnungen">

        <title>Einführung</title>

        <para>Wiederkehrende Rechnungen werden als normale Aufträge definiert

        und konfiguriert, mit allen dazugehörigen Kunden- und Artikelangaben.

        Die konfigurierten Aufträge werden später automatisch in Rechnungen

        umgewandelt, so als ob man den Workflow benutzen würde, und auch die

        Auftragsnummer wird übernommen, sodass alle wiederkehrenden

        Rechnungen, die aus einem Auftrag erstellt wurden, später leicht

        wiederzufinden sind.</para>

      </sect2>

      <sect2 id="features.periodic-invoices.configuration"

             xreflabel="Konfiguration von wiederkehrenden Rechnungen">

        <title>Konfiguration</title>

        <para>Um einen Auftrag für wiederkehrende Rechnung zu konfigurieren,

        findet sich beim Bearbeiten des Auftrags ein neuer Knopf

        "Konfigurieren", der ein neues Fenster öffnet, in dem man die nötigen

        Parameter einstellen kann. Hinter dem Knopf wird außerdem noch

        angezeigt, ob der Auftrag als wiederkehrende Rechnung konfiguriert ist

        oder nicht.</para>

        <para>Folgende Parameter kann man konfigurieren:</para>

        <variablelist>

          <varlistentry>

            <term>Status</term>

            <listitem>

              <para>Bei aktiven Rechnungen wird automatisch eine Rechnung

              erstellt, wenn die Periodizität erreicht ist (z.B. Anfang eines

              neuen Monats).</para>

              <para>Ist ein Auftrag nicht aktiv, so werden für ihn auch keine

              wiederkehrenden Rechnungen erzeugt. Stellt man nach längerer

              nicht-aktiver Zeit einen Auftrag wieder auf aktiv, wird beim

              nächsten Periodenwechsel für alle Perioden, seit der letzten

              aktiven Periode, jeweils eine Rechnung erstellt. Möchte man dies

              verhindern, muss man vorher das Startdatum neu setzen.</para>

              <para>Für gekündigte Aufträge werden nie mehr Rechnungen

              erstellt. Man kann sich diese Aufträge aber gesondert in den

              Berichten anzeigen lassen.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>Periodizität</term>

            <listitem>

              <para>Ob monatlich, quartalsweise oder jährlich auf neue

              Rechnungen überprüft werden soll. Für jede Periode seit dem

              Startdatum wird überprüft, ob für die Periode (beginnend immer

              mit dem ersten Tag der Periode) schon eine Rechnung erstellt

              wurde. Unter Umständen können bei einem Startdatum in der

              Vergangenheit gleich mehrere Rechnungen erstellt werden.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>Buchen auf</term>

            <listitem>

              <para>Das Forderungskonto, in der Regel "Forderungen aus

              Lieferungen und Leistungen". Das Gegenkonto ergibt sich aus den

              Buchungsgruppen der betreffenden Waren.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>Startdatum</term>

            <listitem>

              <para>ab welchem Datum auf Rechnungserstellung geprüft werden

              soll</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>Enddatum</term>

            <listitem>

              <para>ab wann keine Rechnungen mehr erstellt werden

              sollen</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>Automatische Verlängerung um x Monate</term>

            <listitem>

              <para>Sollen die wiederkehrenden Rechnungen bei Erreichen des

              eingetragenen Enddatums weiterhin erstellt werden, so kann man

              hier die Anzahl der Monate eingeben, um die das Enddatum

              automatisch nach hinten geschoben wird.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>Drucken</term>

            <listitem>

              <para>Sind Drucker konfiguriert, so kann man sich die erstellten

              Rechnungen auch gleich ausdrucken lassen.</para>

            </listitem>

          </varlistentry>

        </variablelist>

        <para>Nach Erstellung der Rechnungen kann eine E-Mail mit

        Informationen zu den erstellten Rechnungen verschickt werden.

        Konfiguriert wird dies in der <link

        linkend="config.config-file.sections-parameters">Konfigurationsdatei</link>

        <filename>config/lx_office.conf</filename> im Abschnitt

        <varname>[periodic_invoices]</varname>.</para>

      </sect2>

      <sect2 id="features.periodic-invoices.reports">

        <title>Auflisten</title>

        <para>Unter Verkauf-&gt;Berichte-&gt;Aufträge finden sich zwei neue

        Checkboxen, "Wiederkehrende Rechnungen aktiv" und "Wiederkehrende

        Rechnungen inaktiv", mit denen man sich einen Überglick über die

        wiederkehrenden Rechnungen verschaffen kann.</para>

      </sect2>

      <sect2 id="features.periodic-invoices.task-server">

        <title>Erzeugung der eigentlichen Rechnungen</title>

        <para>Die zeitliche und periodische Überprüfung, ob eine

        wiederkehrende Rechnung automatisch erstellt werden soll, geschieht

        durch den <link linkend="config.task-server">Taskserver</link>, einen

        externen Dienst, der automatisch beim Start des Servers gestartet

        werden sollte.</para>

      </sect2>

      <sect2 id="features.periodic-invoices.create-for-current-month">

        <title>Erste Rechnung für aktuellen Monat erstellen</title>

        <para>Will man im laufenden Monat eine monatlich wiederkehrende

        Rechnung inkl. des laufenden Monats starten, stellt man das Startdatum

        auf den Monatsanfang und wartet ein paar Minuten, bis der Taskserver

        den neu konfigurieren Auftrag erkennt und daraus eine Rechnung

        generiert hat. Alternativ setzt man das Startdatum auf den

        Monatsersten des Folgemonats und erstellt die erste Rechnung direkt

        manuell über den Workflow.</para>

      </sect2>

        linkend="dokumentenvorlagen-und-variablen.tag-style" />).</para>

        linkend="dokumentenvorlagen-und-variablen.allgemeine-variablen.meta" />.</para>

        dies hat, seit der Einführung, u.a. schon so manche langwierige

        Bug-Suche verkürzt. Da globale Variablen aber implizit mit Package

        angegeben werden, werden die nicht geprüft, und somit kann sich

        schnell ein Tippfehler einschleichen.</para>

        globale Variablen, die kanonisch sind, d.h. sie haben bestimmte

        vorgegebenen Eigenschaften, und alles andere sollte anderweitig

        umhergereicht werden.</para>

        <para>Damit diese nicht erneut als Müllhalde missbraucht werden, im

        Folgenden eine kurze Erläuterung der bestimmten vorgegebenen

        Eigenschaften (Konventionen):</para>

          gewachsen sind), sollte man vor einem Aufruf (!) von zum Beispiel

          <function>IS-&gt;retrieve_customer()</function> in Sicherheit

          bringen.</para>

          <para>Z.B. das vom Benutzer eingestellte Zahlenformat, bevor man

          Berechnung in einem bestimmten Format durchführt (SL/Form.pm Zeile

          3552, Stand version 2.7beta), um dies hinterher wieder auf den

          richtigen Wert zu setzen:</para>

          <para>Das Objekt der Klasse Form hat leider im Moment noch viele

          zentrale Funktionen die vom internen Zustand abhängen, deshalb bitte

          nie einfach zerstören oder überschreiben (zumindestens nicht kurz

          vor einem Release oder in Absprache über bspw. die devel-Liste ;-).

          Es geht ziemlich sicher etwas kaputt.</para>

          <para><varname>$::form</varname> ist gleichzeitig der Standard Scope

          in den <productname>Template::Toolkit</productname> Templates

          außerhalb der Controller: der Ausdruck <function>[% var

          %]</function> greift auf <varname>$::form-&gt;{var}</varname> zu.

          Unter Controllern ist der Standard Scope anders, da lautet der

          Zugriff <function>[% FORM.var %]</function>. In Druckvorlagen sind

          normale Variablen ebenfall im <varname>$::form</varname> Scope, d.h.

          <function>&lt;%var%&gt;</function> zeigt auf

          <varname>$::form-&gt;{var}</varname>. Nochmal von der anderen Seite

          erläutert, innerhalb von (Web-)Templates sieht man häufiger solche

          Konstrukte:</para>

          <para>Entweder wird hier dann $::form-&gt;{business} ausgewertet