projekt kivitendo

        Apache) und ein Datenbankserver (PostgreSQL) in einer aktuellen

        Version (s.a. Liste der unterstützten Betriebssysteme)

        benötigt.</para>

          <listitem>

        <para>Seit Version größer v3.5.0 sind die folgenden Pakete

        hinzugekommen: <literal>Text::Unidecode</literal></para>

        Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag

        -l listet alle Tags auf, das egrep schmeisst alle Einträge mit beta

        oder rc raus und das tail gibt davon den obersten Treffer zurück).

        <para>Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von

        3.4.1 nach 3.5: <programlisting>

        <para>Für kivitendo Installationen in der Schweiz sollte hier

        <varname>german</varname> durch <varname>swiss</varname> ersetzt

        werden.</para>

        <para>Die Einstellung <varname>default_manager = swiss</varname>

        bewirkt:</para>

        <itemizedlist>

          <listitem>

            <para>Beim Erstellen einer neuen Datenbank in der kivitendo

            Administration werden automatisch die Standard-Werte für die

            Schweiz voreingestellt: Währung CHF, 5er-Rundung, Schweizer

            KMU-Kontenplan, Sollversteuerung, Aufwandsmethode, Bilanzierung

            (die Werte können aber manuell angepasst werden).</para>

          </listitem>

          <listitem>

            <para>Einstellen der Standardkonten für Rundungserträge und

            -aufwendungen (unter Mandantenkonfiguration → Standardkonten

            veränderbar)</para>

          </listitem>

          <listitem>

            <para>das verwendete Zahlenformat wird auf

            <varname>1'000.00</varname> eingestellt (unter Programm →

            Benutzereinstellungen veränderbar)</para>

          </listitem>

          <listitem>

            <para>DATEV-Automatik und UStVA werden nicht angezeigt,

            Erfolgsrechnung ersetzt GUV ( unter Mandantenkonfiguration →

            Features veränderbar)</para>

          </listitem>

        </itemizedlist>

        (Stand Sept. 2015)</ulink> und einen aktuellen (Stand Mai 2017) <ulink

        url="https://mozilla.github.io/server-side-tls/ssl-config-generator/">

      <para>Da der Taskserver als Perlscript läuft, wird Arbeitsspeicher, der

      einmal benötigt wurde, nicht mehr an das Betriebssystem zurückgegeben,

      beansprucht. Es ist deshalb sinnvoll, dass der Taskserver in

      regelmässigen Abständen neu gestartet wird.</para>

          <title>SystemV-basierende Systeme (z.B. ältere Debian, ältere

          OpenSUSE, ältere Fedora)</title>

          <para>Kopieren Sie die Datei

          <filename>scripts/boot/systemd/kivitendo-task-server.service</filename>

          nach <filename>/etc/systemd/system/</filename>. Passen Sie in der

          kopierten Datei den Pfad zum Task-Server an (Zeilen

          <literal>ExecStart=....</literal> und

          <literal>ExecStop=...</literal>).</para>

          <para>Machen Sie anschließend das Script systemd bekannt, und binden

          Sie es in den Boot-Prozess ein. Dazu führen Sie die folgenden Befehl

          aus:</para>

          <para>Wenn Sie den Task-Server jetzt sofort starten möchten, anstatt

          den Server neu zu starten, so können Sie das mit dem folgenden

          Befehl tun:</para>

        <para>Mahnungen können unter folgenden Einschränkungen mit den

        odt-Vorlagen im Vorlagensatz rev-odt erzeugt werden:</para>

            Verfügung, das heisst, die Mahnungen werden als PDF-Datei

            ausgegeben.</para>

        <para>Die Vorlagen zahlungserinnerung.odt sowie mahnung.odt sind für

        das Erstellen einer Zahlungserinnerung bzw. Mahnung selbst vorgesehen,

        die Vorlage mahnung_invoice.odt für das Erstellen einer Rechnung über

        die verrechneten Mahngebühren und Verzugszinsen.</para>

      OpenDocument-Format, wie es LibreOffice oder OpenOffice (ab Version 2)

      erzeugen. kivitendo kann dabei sowohl neue OpenDocument-Dokumente als

      auch aus diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von

      LibreOffice oder OpenOffice benötigt. Soll dieses Feature genutzt

      werden, so muss neben LibreOffice oder OpenOffice auch der “X virtual

      frame buffer” (xvfb) installiert werden. Bei Debian ist er im Paket

      “xvfb” enthalten. Andere Distributionen enthalten ihn in anderen

      Paketen.</para>

      <literal>applications</literal> zwei weitere Variablen angepasst

      werden:</para>

      <para><literal>openofficeorg_writer</literal> muss den vollständigen

      Pfad zu LibreOffice oder OpenOffice enthalten. Dabei dürfen keine

      Anführungszeichen eingesetzt werden.</para>

      LibreOffice bzw. OpenOffice kommuniziert. Die erste Variante, die

      benutzt wird, wenn die Variable <literal>$openofficeorg_daemon</literal>

      gesetzt ist, startet ein LibreOffice oder OpenOffice, das auch nach der

      Umwandlung des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen

      wird dann diese laufende Instanz benutzt. Der Vorteil ist, dass die Zeit

      zur Umwandlung deutlich reduziert wird, weil nicht für jedes Dokument

      ein LibreOffice bzw. OpenOffice gestartet werden muss. Der Nachteil ist,

      dass diese Methode Python und die Python-UNO-Bindings benötigt, die

      Bestandteil von LibreOffice bzw. OpenOffice sind.</para>

        <filename>/usr/bin/python</filename> benutzt. Sollte dies nicht der

        richtige sein, so kann man mit zwei Konfigurationsvariablen

        entscheiden, welcher Python-Interpreter genutzt wird. Mit der Option

        <literal>python_uno</literal> aus dem Abschnitt

        <literal>applications</literal> wird der Interpreter selber

      wird für jedes Dokument LibreOffice bzw. OpenOffice neu gestartet und

      die Konvertierung mit Hilfe eines Makros durchgeführt. Dieses Makro muss

      in der Dokumentenvorlage enthalten sein und

      ‘<literal>templates/print/rev-odt/invoice.odt</literal>’ enthält ein

      solches Makro, das in jeder anderen Dokumentenvorlage ebenfalls

      enthalten sein muss.</para>

      <para>Als letztes muss herausgefunden werden, welchen Namen OpenOffice

      bzw. LibreOffice dem Verzeichnis mit den Benutzereinstellungen gibt.

      Unter Debian ist dies momentan <literal>~/.config/libreoffice</literal>.

      kivitendo verwendet das Verzeichnis

      <literal>users/.openoffice.org2</literal>. Eventuell muss dieses

      Verzeichnis umbenannt werden.</para>

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

      überprüft werden, wenn die Konvertierung nach PDF fehlschlägt.</para>

              <para>Druckerbeschreibung → aussagekräftiger Text: wird in der

              Auftrags- bzw. Rechnungsmaske als Auswahl angezeigt (z.B. mit

              Einzahlungsschein Bank xy)</para>

              <para>Druckbefehl → beliebiger Text (hat für das Erzeugen von

              Aufträgen oder Rechnungen als odt-Datei keine Bedeutung, darf

              aber nicht leer sein)</para>

              <para>Vorlagenkürzel → besr bzw. selbst gewähltes Vorlagensuffix

              (muss genau der Zeichenfolge entsprechen, die zwischen

              "invoice_" bzw. "sales_order_" und ".odt" steht.)</para>

              <para>Programm → Benutzereinstellungen → Druckoptionen</para>

              <para>Standarddrucker → gewünschte Druckerbeschreibung auswählen

              (z.B. mit Einzahlungsschein Bank xy)</para>

                    <para>DDDEND: muss am Ende der Zeile vorhanden sein</para>

                  </listitem>

              <para>Extras → Optionen → Sicherheit → Makrosicherheit</para>

              der entsprechenden Nachfrage "Makros ausführen"

              auswählen.</para>

        <para>Seit der Version 3.5 werden für Buchungen in kivitendo

        einheitlich folgende Bezeichnungen verwendet:</para>

            <para><option>Erfassungsdatum</option> (en: <option>Entry

            Date</option>, code: <option>Gldate</option>)</para>

            <para>bezeichnet das Datum, an dem die Buchung in kivitendo

            erfasst wurde.</para>

            <para><option>Buchungsdatum</option> (en: <option>Booking

            Date</option>, code: <option>Transdate</option>)</para>

            <para>bezeichnet das buchhaltungstechnisch für eine Buchung

            relevante Datum</para>

            <option>Buchungsdatum</option> angezeigt werden kann, erscheint

            hier im Fall von Rechnungen das Rechnungsdatum.</para>

            <para>Bezieht sich ein verbuchter Beleg auf einen Zeitpunkt, der

            nicht mit dem Buchungsdatum übereinstimmt, so kann dieses Datum

            momentan in kivitendo nur unter Bemerkungen erfasst werden.</para>

            <para>Möglicherweise wird für solche Fälle in einer späteren

            Version von kivitendo ein dritter Datumswert für Buchungen

            erstellt. (Beispiel: Einkaufsbeleg stammt aus einem früheren Jahr,

            das bereits buchhaltungstechnisch abgeschlossen wurde, und muss

            deshalb später verbucht werden.)</para>

        <itemizedlist>

              <para>Sollversteuerung</para>

              <para>Aufwandsmethode</para>

            </listitem>

            <listitem>

              <para>Bilanzierung</para>

            </listitem>

          </itemizedlist> Diese Einstellungen werden automatisch beim

        Erstellen einer neuen Datenbank vorausgewählt, wenn in

        <filename>config/kivitendo.conf</filename> unter

        <varname>[system]</varname> <literal>default_manager = swiss</literal>

        eingestellt ist.</para>

        <guimenu>System</guimenu> → <guisubmenu>Kontenübersicht</guisubmenu> →

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

        <guisubmenu>Steuern</guisubmenu> → <guimenuitem>Erfassen</guimenuitem>

        auswählen und die Werte aus dem Screenshot übernehmen.</para>

      <title>Erfolgsrechnung</title>

      <para>Seit der Version 3.4.1 existiert in kivitendo der Bericht

      <emphasis role="bold"> Erfolgsrechnung</emphasis>.</para>

      <para>Die Erfolgsrechnung kann in der Mandantenkonfiguration unter

      Features an- oder abgeschaltet werden. Mit der Einstellung

      <varname>default_manager = swiss </varname> in der

      <filename>config/kivitendo.conf</filename> wird beim neu Erstellen einer

      Datenbank automatisch die Anzeige der Erfolgsrechnung im Menü

      <guimenu>Berichte </guimenu> ausgewählt und ersetzt dort die GUV.</para>

      <para>Im Gegensatz zur GUV werden bei der Erfolgsrechnung sämtliche

      Aufwands- und Erlöskonten einzeln aufgelistet (analog zur Bilanz),

      sortiert nach ERTRAG und AUFWAND.</para>

      <para>Bei den Konteneinstellungen muss bei jedem Konto, das in der

      Erfolgsrechnung erscheinen soll, unter <varname>Sonstige

      Einstellungen/Erfolgsrechnung</varname> entweder

      <literal>01.Ertrag</literal> oder <literal>06.Aufwand</literal>

      ausgewählt werden.</para>

      <para>Wird bei einem Erlöskonto <literal>06.Aufwand</literal>

      ausgewählt, so wird dieses Konto als Aufwandsminderung unter AUFWAND

      aufgelistet.</para>

      <para>Wird bei einem Aufwandskonto <literal>01.Ertrag</literal>

      ausgewählt, so wird dieses Konto als Ertragsminderung unter ERTRAG

      aufgelistet.</para>

      <para>Soll bei einer bereits bestehenden Buchhaltung in Zukunft

      zusätzlich die Erfolgsrechnung als Bericht verwendet werden, so müssen

      die Einstellungen zu allen Erlös- und Aufwandskonten unter

      <varname>Sonstige Einstellungen/Erfolgsrechnung</varname> überprüft und

      allenfalls neu gesetzt werden.</para>

      <title>Rundung in Verkaufsbelegen</title>

      <para>In der Schweiz hat die kleinste aktuell benutzte Münze den Wert

      von 5 Rappen (0.05 CHF).</para>

      <para>Auch wenn im elektronischen Zahlungsverkehr Beträge mit einer

      Genauigkeit von 0.01 CHF verwendet werden können, ist es trotzdem nach

      wie vor üblich, Rechnungen mit auf 0.05 CHF gerundeten Beträgen

      auszustellen.</para>

      <para>In kivitendo kann seit der Version 3.4.1 die Einstellung für eine

      solche Rundung pro Mandant / Datenbank festgelegt werden.</para>

      <para>Die Einstellung wird beim Erstellen der Datenbank bei

      <literal>Genauigkeit</literal> festgelegt. Sie kann anschliessend über

      das Webinterface von kivitendo nicht mehr verändert werden.</para>

      <para>Abhängig vom Wert für <varname>default_manager</varname> in

      <filename>config/kivitendo.conf</filename> werden dabei folgende Werte

      voreingestellt:</para>

      <itemizedlist>

      und Verkaufsgutschriften wird der Endbetrag inkl. MWST gerundet, wenn

      dieser nicht der eingestellten Genauigkeit entspricht.</para>

      Standardkonten für Rundungserträge bzw. Rundungsaufwendungen

      gebucht.</para>

      <para>(Die berechnete MWST wird durch den Rundungsbetrag nicht mehr

      verändert.)</para>

      <para><emphasis role="bold">Achtung:</emphasis> Werden Verkaufsbelege in

      anderen Währungen als der Standardwährung erstellt, so muss in kivitendo

      ab Version 3.4.1 die Genauigkeit 0.01 verwendet werden.</para>

      <para>Das heisst, Firmen in der Schweiz, die teilweise

      Verkaufsrechnungen in Euro oder anderen Währungen erstellen wollen,

      müssen beim Erstellen der Datenbank als Genauigkeit 0.01 wählen und

      können zur Zeit die 5er Rundung noch nicht nutzen.</para>

        Sofern es nicht ausdrücklich eingeschränkt wird, gilt das im Folgenden

        gesagte für alle Vorlagenarten.</para>

                <para>Betrag, um den <varname>invtotal</varname> gerundet

                wurde (kann positiv oder negativ sein)</para>

          <para>Die Variablen des Bearbeiters, bzw. Verkäufers stehen wie

          gewohnt als <varname>employee_...</varname> bzw.

          <varname>salesman_...</varname> zur Verfügung. Werden mehrere

          Rechnungen in einer Mahnung zusammengefasst, so werden die Metadaten

          (Bearbeiter, Abteilung, etc) der ersten angemahnten Rechnung im

          Ausdruck genommen.</para>

          <para>Die Adressdaten des Kunden stehen als Variablen

          <varname>name</varname>, <varname>street</varname>,

          <varname>zipcode</varname>, <varname>city</varname>,

          <varname>country</varname>, <varname>department_1</varname>,

          <varname>department_2</varname>, und <varname>email</varname> zur

          Verfügung. Der Ansprechpartner <varname>cp_...</varname> steht auch

          zu Verfügung, wird allerdings auch nur von der ersten angemahnten

          Rechnung (s.o.) genommen.</para>

      <para>Die Lagerverwaltung in kivitendo funktioniert standardmässig wie

      folgt: Wird ein Lager mit einem Lagerplatz angelegt, so gibt es die

      Möglichkeit hier über den Menüpunkt Lager entsprechende Warenbewegungen

      durchzuführen. Ferner kann jede Position eines Lieferscheins ein-, bzw.

      ausgelagert werden (Einkauf-, bzw. Verkauf). Es können beliebig viele

      Lager mit beliebig vielen Lagerplätzen abgebildet werden. Die

      Lagerbewegungen über einen Lieferschein erfolgt durch Anklicken jeder

      Einzelposition und das Auswählen dieser Position zu einem Lager mit

      Lagerplatz. Dieses Verfahren lässt sich schrittweise vereinfachen, je

      nachdem wie die Einstellungen in der Mandatenkonfiguration gesetzt

      werden.</para>

      <para>Zusätzliche Funktionshinweise:</para>

      <title>Schweizer Kontenpläne</title>

      <para>Seit der Version 3.5 stehen in kivitendo 3 Kontenpläne für den

      Einsatz in der Schweiz zur Verfügung, einer für Firmen und

      Organisationen, die nicht mehrwertsteuerpflichtig sind, einer für

      Firmen, die mehrwertsteuerpflichtig sind und einer speziell für

      Vereine.</para>

      <para>Die Kontenpläne orientieren sich am in der Schweiz üblicherweise

      verwendeten KMU-Kontenrahmen und sind mit der Revision des

      Schweizerischen Obligationenrechts (OR) vom 1.1.2013 kompatibel,

      insbesondere <literal>Art.957a Abs.2</literal>.</para>

      <para>Beim Vereinskontenplan sind standardmässig nur die Konten 1100

      (Debitoren CHF) und 1101 (Debitoren EUR) als Buchungskonten im Verkauf

      sowie die Konten 2000 (Kreditoren CHF) und 2001 (Kreditoren EUR) als

      Buchungskonten im Einkauf vorgesehen. Weitere Konten können bei Bedarf

      in den Konto-Detaileinstellungen als Einkaufs- oder Verkaufskonten

      konfiguriert werden.</para>

      <para>Die Möglichkeit, Saldosteuersätze zu verwenden ist in der

      aktuellen Version von kivitendo noch nicht integriert.</para>

      <para>Trotzdem können auch Firmen, die per Saldosteuersatz mit der

      Eidgenössischen Steuerverwaltung abrechnen, kivitendo bereits nutzen.

      Dazu wird der Kontenplan mit MWST ausgewählt. Anschliessend müssen alle

      Aufwandskonten editiert werden und dort der Steuersatz auf 0% gesetzt

      werden.</para>

      <para>So werden bei Kreditorenbuchungen keine Vorsteuern

      verbucht.</para>

      <para>Bezugssteuern für aus dem Ausland bezogene Dienstleistungen müssen

      manuell verbucht werden.</para>

      <para>Wünsche für Anpassungen an den Schweizer Kontenplänen sowie

      Vorschläge für weitere (z.B. branchenspezifische) Kontenpläne bitte an

      <literal>empfang@revamp-it.ch</literal> senden.</para>

            <para>aus ERP-Daten per LaTeX Template erzeugte

            PDF-Dokumente,</para>

            <para>zu bestimmten ERP-Daten gehörende Anhangdateien

            unterschiedlichen Formats,</para>

        <para>Über eine vom Speichermedium unabhängige Zwischenschicht werden

        die Dateien und ihre Versionen in der Datenbank verwaltet. Darunter

        können verschiedene Implementierungen (Backends) gleichzeitig

        existieren:</para>

              <imagedata fileref="images/DMS-Anhaenge.png" scale="50"/>

              <imagedata contentwidth="40"

                         fileref="images/DMS-Anhaenge-hochladen.png"

                         width="100"/>

              <imagedata fileref="images/DMS-Dokumente.png" width="500"/>

              <imagedata contentwidth="600"

                         fileref="images/DMS-Dokumente-Scanner.png"/>

        <para>Statt des Löschens wird hier die Datei zurück zur Quelle

        verschoben. Somit kann die Datei anschließend an ein anderes

        ERP-Objekt angehängt werden.</para>

        <para>Derzeit sind "Titel" und "Beschreibung" noch nicht genutzt. Sie

        sind bisher nur bei Bildern relevant.</para>

        <sect3 id="file_management.dbconfig"

               xreflabel="Datenbank-Konfigurierung">

        <sect3 id="file_management.kiviconfig"

               xreflabel="kivitendo-Konfigurationsdatei">

          <para>Dort ist im Abschnitt [paths] der relative oder absolute Pfad

          zum Dokumentenwurzelverzeichnis einzutragen. Dieser muss für den

          Webserver schreib- und lesbar sein, jedoch nicht ausführbar.</para>

      </sect2>

    </sect1>

    <sect1>

      <title>Webshop-Api</title>

      <para>Das Shopmodul bietet die Möglichkeit Onlineshopartikel und

      Onlineshopbestellungen zu verwalten und zu bearbeiten. </para>

      <para>Es ist Multishopfähig, d.h. Artikel können mehreren oder

      unterschiedlichen Shops zugeordnet werden. Bestellungen können aus

      mehreren Shops geholt werden.</para>

      <para>Zur Zeit bietet das Modul nur einen Connector zur REST-Api von

      Shopware. Weitere Connectoren können dazu programmiert und eingerichtet

      werden.</para>

      <sect2>

        <title>Installationvorraussetzungen</title>

        <para>In der Datenbank <literal>template1</literal> muss die

        Unterstützung für die trigram-Extension eingerichet werden. Melden Sie

        sich dafür als Benutzer “postgres” an der Datenbank an:

        <programlisting>su - postgres

psql template1</programlisting></para>

        <para>führen Sie die folgenden Kommandos aus:</para>

        <programlisting>CREATE EXTENSION IF NOT EXISTS pg_trgm;

\q</programlisting>

      </sect2>

      <sect2>

        <title>Konfiguration</title>

        <para/>

      </sect2>

              <para>Enthält unter anderem Datumsformat dateformat und

              Nummernformat numberformat</para>

            <para><literal>Sys::CPU</literal> (Debian-Panetname:

            <literal>libsys-cpu-perl</literal>; Fedora und openSUSE: nicht

            <para><literal>Thread::Pool::Simple</literal> (Debian-Panetname:

            <literal>libthread-pool-simple-perl</literal>; Fedora und