projekt kivitendo

Upgrade auf v3.5.1

* Neue Perlabhängigkeiten

  * LWP::Authen::Digest für WebshopApi

  * LWP::UserAgent für WebshopApi

* Verwendung der WebshopApi

  * Bestehende Datenbanken, die die WebshopApi verwenden sollen benötigen die

    Postgres Erweiterung pg_trgm

    Diese kann wie folgt installiert werden:

    su - postgres

    psql <DATENBANK>

    CREATE EXTENSION IF NOT EXISTS pg_trgm;

    \q

große Features

- WebshopApi

	WebshopApi mit bisher einem Konnektor für Shopware.

	Damit ist es möglich Bestellungen aus dem Shop abzuholen und Artikel

	abzugleichen.

        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>

            <listitem>

              <para>Sollversteuerung</para>

            </listitem>

              <para>Aufwandsmethode</para>

              <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>Analog stehen die benutzerdefinierten Variablen für

          Ansprechpersonen mit dem Namenspräfix <varname>cp_cvar_</varname>

          zur Verfügung.</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>Die Klassifizierung von Artikeln dient einer weiteren

        Gliederung, um zum Beispiel den Einkauf vom Verkauf zu trennen,

        gekennzeichnet durch eine Beschreibung (z.B. "Einkauf") und ein Kürzel

        (z.B. "E"). Für jede Klassifizierung besteht eine Beschreibung und

        eine Abkürzung die normalerweise aus einem Zeichen besteht, kann aber

        auf mehrere Zeichen erweitert werden, falls zur Unterscheidung

        notwendig. Sinnvoll sind jedoch nur maximal 2 Zeichen.</para>

        <para>Für das Attribut "separat ausweisen" stehen in den

        LaTeX-Vorlagen die Variable <emphasis

        role="bold">&lt;%non_separate_subtotal%&gt; </emphasis>zur Verfügung,

        die alle nicht separat auszuweisenden Artikelkosten saldiert, sowie

        pro separat auszuweisenden Klassifizierungen die Variable<emphasis

        role="bold">&lt; %separate_X_subtotal%&gt;</emphasis>, wobei X das

        Kürzel der Klassifizierung ist.</para>

        <para>Parallel zum alten WebDAV gibt es ein Datei-Management-System,

        das Dateien verschiedenen Typs verwaltet. Dies können</para>

            <para>aus ERP-Daten per LaTeX Template erzeugte

            PDF-Dokumente,</para>

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

            unterschiedlichen Formats,</para>

            <para>per E-Mail empfangene Dateianhänge 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>

            <para>Schnittstelle zu externen

            Dokumenten-Management-Systemen</para>

        <para>Es gibt unterschiedliche Typen von Dateien. Jedem Typ läßt sich

        in der Mandantenkonfiguration ein bestimmtes Backend zuordnen.</para>

            <para>"document": Das sind entweder generierte, eingescannte oder

            hochgeladene PDF-Dateien, die zu bestimmten ERP-Daten

            (ERP-Objekte, wie z.B. Rechnung, Lieferschein) gehören.</para>

            <para>"attachment": zusätzlich hochgeladene Dokumente, die an

            bestimmte ERP-Objekte angehängt werden, z.B. technische

            Zeichnungen, Aufmaße. Diese können auch für Artikel, Lieferanten

            und Kunden hinterlegt sein.</para>

            <para>"image": Bilder für Artikel. Diese können auch verkleinert

            in einer Vorschau (Thumbnail) angezeigt werden.</para>

        <para>Zusätzlich werden in der Datenbank zu den Dateien neben der

        Zuordnung zu ERP-Objekten, Dateityp Dateinamen und Backend, in dem die

        Datei gespeichert ist, auch die Quelle der Datei notiert:</para>

            <para>"created": vom System erzeugte Dokumente"</para>

            <para>"uploaded": hochgeladene Dokumente</para>

            <para>"email": vom Mail-System empfangene Dateien</para>

            <para>"scanner[1]": von einem oder mehreren Scannern erzeugte

            Dateien. Existieren mehrere Scanner, so sind diese durch

            unterschiedliche Quellennamen zu definieren.</para>

        <para>Je nach Dateityp sind nur bestimmte Quellen zulässig. So gibt es

        für "attachment" und "image" nur die Quelle "uploaded". Für "document"

        gibt es auf jeden Fall die Quelle "created". Die Quellen "scanner" und

        "email" müssen derzeit in der Datenbank konfiguriert werden (siehe

        <xref linkend="file_management.dbconfig"/>).</para>

        <para>Die Daten werden bei den ERP-Objekten als extra Reiter

        dargestellt. Eine Verkaufsrechnung z.B. hat die Reiter "Dokumente" und

        "Dateianhänge".</para>

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

        <para>Bei den Dateianhängen wird immer nur die aktuelle Version einer

        Datei angezeigt. Wird eine Datei mit gleichem Namen hochgeladen, so

        wird eine neue Version der Datei erstellt. Vorher wird der Anwender

        durch einen Dialog gefragt, ob er eine neue Version anlegen will oder

        ob er die Datei umbenennen will, falls es eine neue Datei sein

        soll.</para>

              <imagedata contentwidth="40"

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

                         width="100"/>

        solange in Summe die maximale Größe nicht überschritten wird (siehe

        <xref linkend="file_management.clientconfig"/>).</para>

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

        <para>Sind keine weiteren Quellen für Dokumente konfiguriert, so gibt

        es nur "erzeugte Dokumente". Es werden alle Versionen der generierten

        Datei angezeigt. Für Verkaufsrechnungen kommen keine anderen Quellen

        zur Geltung. Werden entsprechend der <xref

        linkend="file_management.dbconfig"/> zusätzliche Quellen konfiguriert,

        so sind diese z.B. bei Einkaufsrechnungen sichtbar:</para>

              <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.clientconfig"

               xreflabel="Mandantenkonfigurierung">

            <para>Unter dem Reiter <emphasis role="bold">Features</emphasis>

            im Abschnitt Dateimanagement ist neben dem "alten" WebDAV das

            Dateimangement generell zu- und abschaltbar, sowie die Zuordnung

            der Dateitypen zu Backends. Die Löschbarkeit von Dateien, sowie

            die maximale Uploadgröße sind Backend-unabhängig</para>

            <screenshot>

              <screeninfo>Mandantenkonfig Reiter "Features"</screeninfo>

              <mediaobject>

                <imageobject>

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

                </imageobject>

              </mediaobject>

            </screenshot>

            <para>Die einzelnen Backends sind einzeln einschaltbar.

            Spezifische Backend-Konfigurierungen sind hier noch

            ergänzbar.</para>

          </sect4>

            <para>Unter dem Reiter <emphasis role="bold">Allgemeine

            Dokumentenanhänge</emphasis> kann für alle ERP-Dokumente (

            Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und

            Einkauf ) allgemeingültige Anhänge hochgeladen werden.</para>

            <screenshot>

              <screeninfo>Mandantenkonfig Reiter "Allgemeine

              Dokumentenanhänge"</screeninfo>

              <mediaobject>

                <imageobject>

                  <imagedata fileref="images/DMS-Allgemeine-Dokumentenanhaenge.png"

                             width="500"/>

                </imageobject>

              </mediaobject>

            </screenshot>

            <para>Diese Anhänge werden beim Generieren von PDF-Dateien an die

            ERP-Dokumente angehängt, z.B. AGBs oder aktuelle Angebote. Es

            werden in dem Fall die Daten kopiert, sodass an den ERP-Dokumenten

            immer die Anhänge zum Generierungszeitpunkt eingebettet

            sind.</para>

          </sect4>

        <sect3 id="file_management.dbconfig"

               xreflabel="Datenbank-Konfigurierung">

          <para>Die zusätzlichen Quellen für "email" oder ein oder mehrere

          Scanner sind derzeit vom Administrator direkt in der

          Datenbanktabelle "user_preferences" einzurichten. Die "value" ist im

          JSON-Format mit den jeweiligen Werten des Verzeichnisses und der

          Beschreibung der Quelle.</para>

          <para>Es ist daran gedacht, statt dem Default-Eintrag später für

          bestimmte Benutzer ('login') bestimmte Quellen zuzulassen. Dies wird

          nach Bedarf implementiert.</para>

        <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>

          <para>Unter diesem Wurzelverzeichnis wird pro Mandant automatisch

          ein Unterverzeichnis mit der ID des Mandanten angelegt.</para>

        </sect3>

      </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>Rechte für die Webshopapi</title>

        <para>In der Administration können folgende Rechte vergeben

        werden</para>

        <itemizedlist>

          <listitem>

            <para>Webshopartikel anlegen und bearbeiten</para>

          </listitem>

          <listitem>

            <para>Shopbestellungen holen und bearbeiten</para>

          </listitem>

          <listitem>

            <para>Shopbestellungen holen und bearbeiten</para>

          </listitem>

        </itemizedlist>

      </sect2>

      <sect2>

        <title>Konfiguration</title>

        <para>Unter System-&gt;Webshops können Shops angelegt und konfiguriert

        werden</para>

        <mediaobject>

          <imageobject>

            <imagedata contentdepth="500" contentwidth="700"

                       fileref="images/Shop_Listing.png"/>

          </imageobject>

        </mediaobject>

      </sect2>

      <sect2>

        <title>Webshopartikel</title>

        <sect3>

          <title>Shopvariablenreiter in Artikelstammdaten</title>