Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision 8477e06f

Von Werner Hahn vor mehr als 6 Jahren hinzugefügt

  • ID 8477e06f3586df128d2234fb82ebfd7884ff1945
  • Vorgänger 0dfb7b73
  • Nachfolger 12194786

Shopmodul: Entwickler/Anwenderdokumentation

Unterschiede anzeigen:

doc/dokumentation.xml
5422 5422
          unter einem ähnlichen Namensschema zur Verfügung. Hier lautet der
5423 5423
          Präfix <varname>shiptocvar_</varname>.</para>
5424 5424

  
5425
          <para>Analog stehen die benutzerdefinierten Variablen für Ansprechpersonen mit dem Namenspräfix <varname>cp_cvar_</varname> zur Verfügung.</para>
5425
          <para>Analog stehen die benutzerdefinierten Variablen für
5426
          Ansprechpersonen mit dem Namenspräfix <varname>cp_cvar_</varname>
5427
          zur Verfügung.</para>
5426 5428
        </sect3>
5427 5429
      </sect2>
5428 5430

  
......
6415 6417
      <sect2>
6416 6418
        <title>Übersicht</title>
6417 6419

  
6418
        <para>Die Klassifizierung von Artikeln dient einer weiteren Gliederung,
6419
        um zum Beispiel den Einkauf vom Verkauf zu trennen, gekennzeichnet
6420
        durch eine Beschreibung (z.B. "Einkauf") und ein Kürzel (z.B. "E").
6421
        Für jede Klassifizierung besteht eine Beschreibung und eine Abkürzung
6422
        die normalerweise aus einem Zeichen besteht, kann aber auf mehrere
6423
        Zeichen erweitert werden, falls zur Unterscheidung notwendig. Sinnvoll
6424
        sind jedoch nur maximal 2 Zeichen.</para>
6420
        <para>Die Klassifizierung von Artikeln dient einer weiteren
6421
        Gliederung, um zum Beispiel den Einkauf vom Verkauf zu trennen,
6422
        gekennzeichnet durch eine Beschreibung (z.B. "Einkauf") und ein Kürzel
6423
        (z.B. "E"). Für jede Klassifizierung besteht eine Beschreibung und
6424
        eine Abkürzung die normalerweise aus einem Zeichen besteht, kann aber
6425
        auf mehrere Zeichen erweitert werden, falls zur Unterscheidung
6426
        notwendig. Sinnvoll sind jedoch nur maximal 2 Zeichen.</para>
6425 6427
      </sect2>
6426 6428

  
6427 6429
      <sect2>
......
6490 6492
          </listitem>
6491 6493
        </itemizedlist>
6492 6494

  
6493
        <para>Für das Attribut "separat ausweisen" stehen in den LaTeX-Vorlagen
6494
        die Variable <emphasis role="bold">&lt;%non_separate_subtotal%&gt;
6495
        </emphasis>zur Verfügung, die alle nicht separat auszuweisenden
6496
        Artikelkosten saldiert, sowie pro separat auszuweisenden
6497
        Klassifizierungen die Variable<emphasis role="bold">&lt;
6498
        %separate_X_subtotal%&gt;</emphasis>, wobei X das Kürzel der
6499
        Klassifizierung ist.</para>
6495
        <para>Für das Attribut "separat ausweisen" stehen in den
6496
        LaTeX-Vorlagen die Variable <emphasis
6497
        role="bold">&lt;%non_separate_subtotal%&gt; </emphasis>zur Verfügung,
6498
        die alle nicht separat auszuweisenden Artikelkosten saldiert, sowie
6499
        pro separat auszuweisenden Klassifizierungen die Variable<emphasis
6500
        role="bold">&lt; %separate_X_subtotal%&gt;</emphasis>, wobei X das
6501
        Kürzel der Klassifizierung ist.</para>
6500 6502

  
6501 6503
        <para>Im obigen Beispiel wäre das für Lieferkosten <emphasis
6502 6504
        role="bold">&lt;%separate_L_subtotal%&gt;</emphasis> und für
......
6525 6527

  
6526 6528
      <sect2>
6527 6529
        <title>Übersicht</title>
6528
        <para>Parallel zum alten WebDAV gibt es ein Datei-Management-System, das Dateien
6529
        verschiedenen Typs verwaltet. Dies können</para>
6530

  
6531
        <para>Parallel zum alten WebDAV gibt es ein Datei-Management-System,
6532
        das Dateien verschiedenen Typs verwaltet. Dies können</para>
6533

  
6530 6534
        <orderedlist>
6531 6535
          <listitem>
6532 6536
            <para>aus ERP-Daten per LaTeX Template erzeugte
......
6543 6547
          </listitem>
6544 6548

  
6545 6549
          <listitem>
6546
            <para>per E-Mail empfangene Dateianhänge unterschiedlichen Formats,</para>
6550
            <para>per E-Mail empfangene Dateianhänge unterschiedlichen
6551
            Formats,</para>
6547 6552
          </listitem>
6548 6553

  
6549 6554
          <listitem>
......
6580 6585
          </listitem>
6581 6586

  
6582 6587
          <listitem>
6583
            <para>Schnittstelle zu externen Dokumenten-Management-Systemen</para>
6588
            <para>Schnittstelle zu externen
6589
            Dokumenten-Management-Systemen</para>
6584 6590
          </listitem>
6585 6591

  
6586 6592
          <listitem>
......
6591 6597
            <para>etc ...</para>
6592 6598
          </listitem>
6593 6599
        </itemizedlist>
6594
        <para>Es gibt unterschiedliche Typen von Dateien. Jedem Typ läßt sich in der
6595
              Mandantenkonfiguration ein bestimmtes Backend zuordnen.
6596
        </para>
6600

  
6601
        <para>Es gibt unterschiedliche Typen von Dateien. Jedem Typ läßt sich
6602
        in der Mandantenkonfiguration ein bestimmtes Backend zuordnen.</para>
6603

  
6597 6604
        <itemizedlist>
6598 6605
          <listitem>
6599
            <para>"document": Das sind entweder generierte, eingescannte oder hochgeladene PDF-Dateien,
6600
                  die zu bestimmten ERP-Daten (ERP-Objekte, wie z.B. Rechnung, Lieferschein) gehören.</para>
6606
            <para>"document": Das sind entweder generierte, eingescannte oder
6607
            hochgeladene PDF-Dateien, die zu bestimmten ERP-Daten
6608
            (ERP-Objekte, wie z.B. Rechnung, Lieferschein) gehören.</para>
6601 6609
          </listitem>
6602 6610

  
6603 6611
          <listitem>
6604
            <para>"attachment": zusätzlich hochgeladene Dokumente, die an bestimmte ERP-Objekte angehängt werden,
6605
            z.B. technische Zeichnungen, Aufmaße. Diese können auch für Artikel,
6606
            Lieferanten und Kunden hinterlegt sein.</para>
6612
            <para>"attachment": zusätzlich hochgeladene Dokumente, die an
6613
            bestimmte ERP-Objekte angehängt werden, z.B. technische
6614
            Zeichnungen, Aufmaße. Diese können auch für Artikel, Lieferanten
6615
            und Kunden hinterlegt sein.</para>
6607 6616
          </listitem>
6608 6617

  
6609 6618
          <listitem>
6610
            <para>"image": Bilder für Artikel. Diese können auch verkleinert in einer Vorschau (Thumbnail)
6611
            angezeigt werden.</para>
6619
            <para>"image": Bilder für Artikel. Diese können auch verkleinert
6620
            in einer Vorschau (Thumbnail) angezeigt werden.</para>
6612 6621
          </listitem>
6613 6622
        </itemizedlist>
6614
        <para>Zusätzlich werden in der Datenbank zu den Dateien neben der Zuordnung zu ERP-Objekten, Dateityp
6615
        Dateinamen und Backend, in dem die Datei gespeichert ist, auch die Quelle der Datei notiert:
6616
        </para>
6623

  
6624
        <para>Zusätzlich werden in der Datenbank zu den Dateien neben der
6625
        Zuordnung zu ERP-Objekten, Dateityp Dateinamen und Backend, in dem die
6626
        Datei gespeichert ist, auch die Quelle der Datei notiert:</para>
6627

  
6617 6628
        <itemizedlist>
6618 6629
          <listitem>
6619
            <para> "created": vom System erzeugte Dokumente"</para>
6630
            <para>"created": vom System erzeugte Dokumente"</para>
6620 6631
          </listitem>
6621 6632

  
6622 6633
          <listitem>
6623
            <para> "uploaded": hochgeladene Dokumente</para>
6634
            <para>"uploaded": hochgeladene Dokumente</para>
6624 6635
          </listitem>
6625 6636

  
6626 6637
          <listitem>
6627
            <para> "email": vom Mail-System empfangene Dateien</para>
6638
            <para>"email": vom Mail-System empfangene Dateien</para>
6628 6639
          </listitem>
6629 6640

  
6630 6641
          <listitem>
6631
            <para> "scanner[1]": von einem oder mehreren Scannern erzeugte Dateien. Existieren mehrere Scanner,
6632
            so sind diese durch unterschiedliche Quellennamen zu definieren.</para>
6642
            <para>"scanner[1]": von einem oder mehreren Scannern erzeugte
6643
            Dateien. Existieren mehrere Scanner, so sind diese durch
6644
            unterschiedliche Quellennamen zu definieren.</para>
6633 6645
          </listitem>
6634 6646
        </itemizedlist>
6635
        <para>Je nach Dateityp sind nur bestimmte Quellen zulässig. So gibt es für "attachment" und "image" nur
6636
        die Quelle "uploaded". Für "document" gibt es auf jeden Fall die Quelle "created".
6637
        Die Quellen "scanner" und "email" müssen derzeit in der Datenbank konfiguriert werden
6638
        (siehe <xref linkend="file_management.dbconfig"/>).</para>
6647

  
6648
        <para>Je nach Dateityp sind nur bestimmte Quellen zulässig. So gibt es
6649
        für "attachment" und "image" nur die Quelle "uploaded". Für "document"
6650
        gibt es auf jeden Fall die Quelle "created". Die Quellen "scanner" und
6651
        "email" müssen derzeit in der Datenbank konfiguriert werden (siehe
6652
        <xref linkend="file_management.dbconfig"/>).</para>
6639 6653
      </sect2>
6640 6654

  
6641 6655
      <sect2>
6642 6656
        <title>Anwendung</title>
6643
        <para>Die Daten werden bei den ERP-Objekten als extra Reiter dargestellt.
6644
        Eine Verkaufsrechnung z.B. hat die
6645
        Reiter "Dokumente" und "Dateianhänge".</para>
6657

  
6658
        <para>Die Daten werden bei den ERP-Objekten als extra Reiter
6659
        dargestellt. Eine Verkaufsrechnung z.B. hat die Reiter "Dokumente" und
6660
        "Dateianhänge".</para>
6661

  
6646 6662
        <screenshot>
6647 6663
          <screeninfo>Reiter "Dateianhänge"</screeninfo>
6648 6664

  
......
6652 6668
            </imageobject>
6653 6669
          </mediaobject>
6654 6670
        </screenshot>
6655
        <para>Bei den Dateianhängen wird immer nur die aktuelle Version einer Datei angezeigt.
6656
        Wird eine Datei mit gleichem Namen hochgeladen, so wird eine neue Version der Datei erstellt.
6657
        Vorher wird der Anwender durch einen Dialog gefragt, ob er eine neue Version anlegen will oder
6658
        ob er die Datei umbenennen will, falls es eine neue Datei sein soll.</para>
6671

  
6672
        <para>Bei den Dateianhängen wird immer nur die aktuelle Version einer
6673
        Datei angezeigt. Wird eine Datei mit gleichem Namen hochgeladen, so
6674
        wird eine neue Version der Datei erstellt. Vorher wird der Anwender
6675
        durch einen Dialog gefragt, ob er eine neue Version anlegen will oder
6676
        ob er die Datei umbenennen will, falls es eine neue Datei sein
6677
        soll.</para>
6678

  
6659 6679
        <screenshot>
6660 6680
          <screeninfo>Reiter "Dateianhänge"</screeninfo>
6661 6681

  
......
6669 6689
        </screenshot>
6670 6690

  
6671 6691
        <para>Es können mehrere Dateien gleichzeitig hochgeladen werden,
6672
        solange in Summe die maximale Größe nicht überschritten wird
6673
        (siehe <xref linkend="file_management.clientconfig"/>).</para>
6692
        solange in Summe die maximale Größe nicht überschritten wird (siehe
6693
        <xref linkend="file_management.clientconfig"/>).</para>
6694

  
6674 6695
        <screenshot>
6675 6696
          <screeninfo>Reiter "Dokumente"</screeninfo>
6676 6697

  
......
6680 6701
            </imageobject>
6681 6702
          </mediaobject>
6682 6703
        </screenshot>
6683
        <para>Sind keine weiteren Quellen für Dokumente konfiguriert, so gibt es nur "erzeugte Dokumente".
6684
        Es werden alle Versionen der generierten Datei angezeigt. Für Verkaufsrechnungen kommen keine
6685
        anderen Quellen zur Geltung. Werden entsprechend der
6686
        <xref linkend="file_management.dbconfig"/> zusätzliche Quellen konfiguriert, so sind diese z.B. bei
6687
        Einkaufsrechnungen sichtbar:</para>
6704

  
6705
        <para>Sind keine weiteren Quellen für Dokumente konfiguriert, so gibt
6706
        es nur "erzeugte Dokumente". Es werden alle Versionen der generierten
6707
        Datei angezeigt. Für Verkaufsrechnungen kommen keine anderen Quellen
6708
        zur Geltung. Werden entsprechend der <xref
6709
        linkend="file_management.dbconfig"/> zusätzliche Quellen konfiguriert,
6710
        so sind diese z.B. bei Einkaufsrechnungen sichtbar:</para>
6711

  
6688 6712
        <screenshot>
6689 6713
          <screeninfo>Reiter "Dokumente"</screeninfo>
6690 6714

  
......
6706 6730

  
6707 6731
      <sect2>
6708 6732
        <title>Konfigurierung</title>
6709
        <sect3 id="file_management.clientconfig" xreflabel="Mandantenkonfigurierung">
6733

  
6734
        <sect3 id="file_management.clientconfig"
6735
               xreflabel="Mandantenkonfigurierung">
6710 6736
          <title>Mandantenkonfiguration</title>
6737

  
6711 6738
          <sect4>
6712 6739
            <title>Reiter "Features"</title>
6713
            <para>Unter dem Reiter <emphasis role="bold">Features</emphasis> im Abschnitt Dateimanagement ist
6714
            neben dem "alten" WebDAV das Dateimangement generell zu- und abschaltbar, sowie die Zuordnung der
6715
          Dateitypen zu Backends. Die Löschbarkeit von Dateien, sowie die maximale Uploadgröße sind Backend-unabhängig</para>
6716
        <screenshot>
6717
          <screeninfo>Mandantenkonfig Reiter "Features"</screeninfo>
6718
          <mediaobject>
6719
            <imageobject>
6720
              <imagedata  width="500" fileref="images/DMS-ClientConfig.png"/>
6721
            </imageobject>
6722
          </mediaobject>
6723
        </screenshot>
6724
        <para>Die einzelnen Backends sind einzeln einschaltbar. Spezifische Backend-Konfigurierungen sind hier
6725
        noch ergänzbar.</para>
6726
        </sect4>
6740

  
6741
            <para>Unter dem Reiter <emphasis role="bold">Features</emphasis>
6742
            im Abschnitt Dateimanagement ist neben dem "alten" WebDAV das
6743
            Dateimangement generell zu- und abschaltbar, sowie die Zuordnung
6744
            der Dateitypen zu Backends. Die Löschbarkeit von Dateien, sowie
6745
            die maximale Uploadgröße sind Backend-unabhängig</para>
6746

  
6747
            <screenshot>
6748
              <screeninfo>Mandantenkonfig Reiter "Features"</screeninfo>
6749

  
6750
              <mediaobject>
6751
                <imageobject>
6752
                  <imagedata fileref="images/DMS-ClientConfig.png" width="500"/>
6753
                </imageobject>
6754
              </mediaobject>
6755
            </screenshot>
6756

  
6757
            <para>Die einzelnen Backends sind einzeln einschaltbar.
6758
            Spezifische Backend-Konfigurierungen sind hier noch
6759
            ergänzbar.</para>
6760
          </sect4>
6761

  
6727 6762
          <sect4>
6728 6763
            <title>Reiter "Allgemeine Dokumentenanhänge"</title>
6729
            <para>Unter dem Reiter <emphasis role="bold">Allgemeine Dokumentenanhänge</emphasis>
6730
            kann für alle ERP-Dokumente ( Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und Einkauf )
6731
            allgemeingültige Anhänge hochgeladen werden.</para>
6732
        <screenshot>
6733
          <screeninfo>Mandantenkonfig Reiter "Allgemeine Dokumentenanhänge"</screeninfo>
6734
          <mediaobject>
6735
            <imageobject>
6736
              <imagedata  width="500" fileref="images/DMS-Allgemeine-Dokumentenanhaenge.png"/>
6737
            </imageobject>
6738
          </mediaobject>
6739
        </screenshot>
6740
        <para>Diese Anhänge werden beim Generieren von PDF-Dateien an die ERP-Dokumente angehängt,
6741
        z.B. AGBs oder aktuelle Angebote. Es werden in dem Fall die Daten kopiert, sodass an den ERP-Dokumenten immer
6742
        die Anhänge zum Generierungszeitpunkt eingebettet sind.
6743
        </para>
6744
        </sect4>
6764

  
6765
            <para>Unter dem Reiter <emphasis role="bold">Allgemeine
6766
            Dokumentenanhänge</emphasis> kann für alle ERP-Dokumente (
6767
            Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und
6768
            Einkauf ) allgemeingültige Anhänge hochgeladen werden.</para>
6769

  
6770
            <screenshot>
6771
              <screeninfo>Mandantenkonfig Reiter "Allgemeine
6772
              Dokumentenanhänge"</screeninfo>
6773

  
6774
              <mediaobject>
6775
                <imageobject>
6776
                  <imagedata fileref="images/DMS-Allgemeine-Dokumentenanhaenge.png"
6777
                             width="500"/>
6778
                </imageobject>
6779
              </mediaobject>
6780
            </screenshot>
6781

  
6782
            <para>Diese Anhänge werden beim Generieren von PDF-Dateien an die
6783
            ERP-Dokumente angehängt, z.B. AGBs oder aktuelle Angebote. Es
6784
            werden in dem Fall die Daten kopiert, sodass an den ERP-Dokumenten
6785
            immer die Anhänge zum Generierungszeitpunkt eingebettet
6786
            sind.</para>
6787
          </sect4>
6745 6788
        </sect3>
6746 6789

  
6747 6790
        <sect3 id="file_management.dbconfig"
6748 6791
               xreflabel="Datenbank-Konfigurierung">
6749 6792
          <title>Datenbank-Konfigurierung</title>
6750
          <para>Die zusätzlichen Quellen für "email" oder ein oder mehrere Scanner sind derzeit vom Administrator
6751
          direkt in der Datenbanktabelle "user_preferences" einzurichten. Die "value" ist im JSON-Format
6752
          mit den jeweiligen Werten des Verzeichnisses und der Beschreibung der Quelle.</para>
6793

  
6794
          <para>Die zusätzlichen Quellen für "email" oder ein oder mehrere
6795
          Scanner sind derzeit vom Administrator direkt in der
6796
          Datenbanktabelle "user_preferences" einzurichten. Die "value" ist im
6797
          JSON-Format mit den jeweiligen Werten des Verzeichnisses und der
6798
          Beschreibung der Quelle.</para>
6799

  
6753 6800
          <programlisting>
6754 6801
 id |  login    |  namespace   | version |   key    |          value
6755 6802
----+-----------+--------------+---------+----------+---------------------------
......
6760 6807
  3 | #default# | file_sources | 0.00000 | emails   |
6761 6808
                             {"dir":"/var/tmp/emails","desc":"Empfangene Mails" }
6762 6809
          </programlisting>
6763
          <para>Es ist daran gedacht, statt dem Default-Eintrag später für bestimmte Benutzer ('login') bestimmte Quellen zuzulassen.
6764
          Dies wird nach Bedarf implementiert.</para>
6810

  
6811
          <para>Es ist daran gedacht, statt dem Default-Eintrag später für
6812
          bestimmte Benutzer ('login') bestimmte Quellen zuzulassen. Dies wird
6813
          nach Bedarf implementiert.</para>
6765 6814
        </sect3>
6766 6815

  
6767 6816
        <sect3 id="file_management.kiviconfig"
......
6776 6825
[paths]
6777 6826
document_path = /var/local/kivi_documents
6778 6827
          </programlisting>
6779
          <para>Unter diesem Wurzelverzeichnis wird pro Mandant automatisch ein Unterverzeichnis mit der ID des Mandanten angelegt.</para>
6828

  
6829
          <para>Unter diesem Wurzelverzeichnis wird pro Mandant automatisch
6830
          ein Unterverzeichnis mit der ID des Mandanten angelegt.</para>
6780 6831
        </sect3>
6781 6832
      </sect2>
6782 6833
    </sect1>
......
6785 6836
      <title>Webshop-Api</title>
6786 6837

  
6787 6838
      <para>Das Shopmodul bietet die Möglichkeit Onlineshopartikel und
6788
      Onlineshopbestellungen zu verwalten und zu bearbeiten. </para>
6839
      Onlineshopbestellungen zu verwalten und zu bearbeiten.</para>
6789 6840

  
6790 6841
      <para>Es ist Multishopfähig, d.h. Artikel können mehreren oder
6791 6842
      unterschiedlichen Shops zugeordnet werden. Bestellungen können aus
......
6810 6861
\q</programlisting>
6811 6862
      </sect2>
6812 6863

  
6864
      <sect2>
6865
        <title>Rechte für die Webshopapi</title>
6866

  
6867
        <para>In der Administration können folgende Rechte vergeben
6868
        werden</para>
6869

  
6870
        <itemizedlist>
6871
          <listitem>
6872
            <para>Webshopartikel anlegen und bearbeiten</para>
6873
          </listitem>
6874

  
6875
          <listitem>
6876
            <para>Shopbestellungen holen und bearbeiten</para>
6877
          </listitem>
6878

  
6879
          <listitem>
6880
            <para>Shopbestellungen holen und bearbeiten</para>
6881
          </listitem>
6882
        </itemizedlist>
6883
      </sect2>
6884

  
6813 6885
      <sect2>
6814 6886
        <title>Konfiguration</title>
6815 6887

  
6816
        <para/>
6888
        <para>Unter System-&gt;Webshops können Shops angelegt und konfiguriert
6889
        werden</para>
6890

  
6891
        <mediaobject>
6892
          <imageobject>
6893
            <imagedata contentdepth="500" contentwidth="700"
6894
                       fileref="images/Shop_Listing.png"/>
6895
          </imageobject>
6896
        </mediaobject>
6897
      </sect2>
6898

  
6899
      <sect2>
6900
        <title>Webshopartikel</title>
6901

  
6902
        <sect3>
6903
          <title>Shopvariablenreiter in Artikelstammdaten</title>
6904

  
6905
          <para>Mit dem Recht "Shopartikel anlegen und bearbeiten" öffnet sich
6906
          der Reiter "Shopvariablen" in den Artikelstammdaten. Hier können
6907
          jetzt die Artikel mit unterschiedlichen Beschreibung und/oder
6908
          Preisen für die konfigutierten Shops angelegt und bearbeitet werden.
6909
          An dieser Stelle können auch beliebig viele Bilder dem Shopartikel
6910
          zugeordnet werden. Artikelbilder gelten für alle Shops.</para>
6911

  
6912
          <mediaobject>
6913
            <imageobject>
6914
              <imagedata contentdepth="500" contentwidth="600"
6915
                         fileref="images/Shop_Artikel.png"/>
6916
            </imageobject>
6917
          </mediaobject>
6918

  
6919
          <para>Die Artikelgruppen werden direkt vom Shopsystem geholt somit
6920
          ist es möglich einen Artikel auch mehreren Gruppen
6921
          zuzuordenen</para>
6922
        </sect3>
6923

  
6924
        <sect3>
6925
          <title>Shopartikelliste</title>
6926

  
6927
          <para>Unter dem Menu Webshop-&gt;Webshop Artikel hat man nochmal
6928
          eine Gesamtübersicht. Von hier aus ist es möglich Artikel im Stapel
6929
          unter verschiedenen Kriterien &lt;alles&gt;&lt;nur Preis&gt;&lt;nur
6930
          Bestand&gt;&lt;Preis und Bestand&gt; an die jeweiligen Shops
6931
          hochzuladen.</para>
6932

  
6933
          <mediaobject>
6934
            <imageobject>
6935
              <imagedata fileref="images/Shop_Artikel_Listing.png"/>
6936
            </imageobject>
6937
          </mediaobject>
6938
        </sect3>
6939
      </sect2>
6940

  
6941
      <sect2>
6942
        <title>Bestellimport</title>
6943

  
6944
        <para>Unter dem Menupunkt Webshop-&gt;Webshop Import öffnet sich die
6945
        Bestellimportsliste. Hier ist sind Möglichkeiten gegeben Neue
6946
        Bestellungen vom Shop abzuholen, geholte Bestellungen im Stapel oder
6947
        einzeln als Auftrag zu transferieren. Die Liste kann nach
6948
        verschiedenen Kriterien gefiltert werden.</para>
6949

  
6950
        <mediaobject>
6951
          <imageobject>
6952
            <imagedata fileref="images/Shop_Bestell.png"/>
6953
          </imageobject>
6954
        </mediaobject>
6955

  
6956
        <para>Bei Einträgen in der Liste.</para>
6957

  
6958
        <itemizedlist>
6959
          <listitem>
6960
            <para>keine Kundennummer: Es gibt ähnliche Kundendatensätze und
6961
            der Datensatz konnte nicht eindeutig zugewiesen werden.</para>
6962
          </listitem>
6963

  
6964
          <listitem>
6965
            <para>Kundennummer und Rechnungen rot hinterlegt: Der Kunde hat
6966
            offene Posten und kann deswegen nicht im Stapel übernommen
6967
            werden.</para>
6968
          </listitem>
6969

  
6970
          <listitem>
6971
            <para>Rechnungsadresse grün hinterlegt: Der Kunde konnte eindeutig
6972
            einem Datensatz zugeordnet werden. Die Shopbestellung kann im
6973
            Stapel mit dem Button "Anwenden" und wenn markiert als Auftrag
6974
            übernommen werden.</para>
6975
          </listitem>
6976

  
6977
          <listitem>
6978
            <para>Kundennummer vorhanden, aber die Checkbox "Auftrag
6979
            erstellen" fehlt. Der Kunde hat vermutlich eine
6980
            Shopauftragssperre.</para>
6981
          </listitem>
6982

  
6983
          <listitem>
6984
            <para>Lieferadresse grau hinterlegt: Optische Anzeige, dass es
6985
            sich um eine unterschiedliche Lieferadresse handelt.
6986
            Lieferadressen werden aber grundsätzlich beim Transferieren zu
6987
            Aufträgen mit übernommen.</para>
6988
          </listitem>
6989

  
6990
          <listitem>
6991
            <para>In der Spalte Positionen/Betrag/Versandkosten zeigt sich ein
6992
            tooltip zu den Positionen.</para>
6993
          </listitem>
6994
        </itemizedlist>
6995

  
6996
        <para>Maske Auftrag erstellen</para>
6997

  
6998
        <para>Viele Shopsysteme haben drei verschieden Adresstypen Kunden-,
6999
        Rechnungs-, und Lieferadresse, die sich auch alle unterscheiden
7000
        können. Diese werden im oberen Bereich angezeigt. Es ist möglich jede
7001
        dieser Adresse einzeln in kivitendo als Kunde zu übernehmen. Es werden
7002
        die Werte Formulareingabe übernommen. Es wird bei einer Änderung
7003
        allerdings nur diese in die kivitendo Kundenstammdaten übernommen, die
7004
        Shopbestellung bleibt bestehen.</para>
7005

  
7006
        <para>Mit der mittleren Adresse(Rechnungsadresse) im oberen Bereich,
7007
        kann ich den ausgewählten kivitendodatensatz des mittleren Bereich
7008
        überschreiben. Das ist sinnvoll, wenn ich erkenne, das der Kunde z.B.
7009
        umgezogen ist.</para>
7010

  
7011
        <para>Im mittleren Bereich das Adresslisting zeigt:</para>
7012

  
7013
        <itemizedlist>
7014
          <listitem>
7015
            <para>Rot hinterlegt: Kunde hat eine Shopauftragssperre, diese
7016
            muss zuerst deaktiviert werden bevor ich diesem Kunden eine
7017
            Shopbestellung zuordnen kann.</para>
7018
          </listitem>
7019

  
7020
          <listitem>
7021
            <para>Kundenname fett und rot: Hier hat der Kunde eine Bemerkung
7022
            in den Stammdaten. Ein Tooltip zeigt diese Bemerkung. Das kann dan
7023
            auch der Grund für die Auftragssperre sein.</para>
7024
          </listitem>
7025

  
7026
          <listitem>
7027
            <para>Die Buttons "Auftrag erstellen" und "Kunde mit
7028
            Rechnungsadresse überschreiben" zeigen sich erst, wenn ein Kunde
7029
            aus dem Listing ausgewählt ist.</para>
7030
          </listitem>
7031

  
7032
          <listitem>
7033
            <para>Es ist aber möglich die Shopbestellung zu löschen.</para>
7034
          </listitem>
7035

  
7036
          <listitem>
7037
            <para>Ist eine Bestellung schon übernommen, zeigen sich an dieser
7038
            Stelle, die dazugehörigen Belegverknüpfungen.</para>
7039
          </listitem>
7040
        </itemizedlist>
7041
      </sect2>
7042

  
7043
      <sect2>
7044
        <title>Mapping der Daten</title>
7045

  
7046
        <para>Das Mapping der kivitendo Daten mit den Shopdaten geschieht in
7047
        der Datei SL/ShopConnector/&lt;SHOPCONNECTORNAME&gt;.pm
7048
        z.B.:SL/ShopConnector/Shopware.pm</para>
7049

  
7050
        <para>In dieser Datei gibt es einen Bereich wo die Bestellpostionen,
7051
        die Bestellkopfdaten und die Artikeldaten gemapt werden. In dieser
7052
        Datei kann ein individelles Mapping dann gemacht werden. Zu Shopware
7053
        gibt es hier eine sehr gute Dokumentation: <ulink
7054
        url="https://developers.shopware.com/developers-guide/rest-api/">https://developers.shopware.com/developers-guide/rest-api/</ulink></para>
6817 7055
      </sect2>
6818 7056
    </sect1>
6819 7057
  </chapter>
doc/html/ch02s02.html
9 9
        dass kivitendo auf ihnen läuft:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Debian</p><div class="itemizedlist"><ul class="itemizedlist" type="circle"><li class="listitem"><p>7.0 "Wheezy"</p></li><li class="listitem"><p>8.0 "Jessie"</p></li></ul></div></li><li class="listitem"><p>Ubuntu 12.04 LTS "Precise Pangolin", 14.04 "Trusty Tahr"
10 10
            LTS, 15.10 "Wily Werewolf" und 16.04 "Xenial Xerus" LTS
11 11
            Alpha</p></li><li class="listitem"><p>openSUSE LEAP 42.1</p></li><li class="listitem"><p>Fedora 22</p></li></ul></div></div><div class="sect2" title="2.2.2. Benötigte Perl-Pakete installieren"><div class="titlepage"><div><div><h3 class="title"><a name="Pakete"></a>2.2.2. Benötigte Perl-Pakete installieren</h3></div></div></div><p>Zum Betrieb von kivitendo werden zwingend ein Webserver (meist
12
        Apache) und ein Datenbankserver (PostgreSQL) in einer aktuellen Version
13
        (s.a. Liste der unterstützten Betriebssysteme) benötigt.</p><p>Zusätzlich benötigt kivitendo einige Perl-Pakete, die nicht
12
        Apache) und ein Datenbankserver (PostgreSQL) in einer aktuellen
13
        Version (s.a. Liste der unterstützten Betriebssysteme)
14
        benötigt.</p><p>Zusätzlich benötigt kivitendo einige Perl-Pakete, die nicht
14 15
        Bestandteil einer Standard-Perl-Installation sind. Um zu überprüfen,
15 16
        ob die erforderlichen Pakete installiert und aktuell genug sind, wird
16 17
        ein Script mitgeliefert, das wie folgt aufgerufen wird:</p><pre class="programlisting">./scripts/installation_check.pl</pre><p>Die vollständige Liste der benötigten Perl-Module lautet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
......
90 91
                     <code class="literal">XML::Writer</code>
91 92
                  </p></li><li class="listitem"><p>
92 93
                     <code class="literal">YAML</code>
93
                  </p></li></ul></div><p>Seit Version größer v3.5.0 sind die folgenden Pakete hinzugekommen:
94
        <code class="literal">Text::Unidecode</code>
94
                  </p></li></ul></div><p>Seit Version größer v3.5.0 sind die folgenden Pakete
95
        hinzugekommen: <code class="literal">Text::Unidecode</code>
95 96
            </p><p>Seit Version v3.4.0 sind die folgenden Pakete hinzugekommen:
96 97
        <code class="literal">Algorithm::CheckDigits</code>
97 98
               <code class="literal">PBKDF2::Tiny</code>
doc/html/ch02s03.html
29 29
git clone https://github.com/kivitendo/kivitendo-erp.git
30 30
cd kivitendo-erp/
31 31
git checkout `git tag -l | egrep -ve "(beta|rc)" | tail -1`</pre><p>
32
        Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag -l listet
33
       alle Tags auf, das egrep schmeisst alle Einträge mit beta oder rc raus und
34
       das tail gibt davon den obersten Treffer zurück).
35

  
32
        Erläuterung: Der Befehl wechselt zur letzten Stable-Version (git tag
33
        -l listet alle Tags auf, das egrep schmeisst alle Einträge mit beta
34
        oder rc raus und das tail gibt davon den obersten Treffer zurück).
36 35
        Sehr sinnvoll ist es, direkt im Anschluss einen eigenen Branch zu
37 36
        erzeugen, um bspw. seine eigenen Druckvorlagen-Anpassungen damit zu
38 37
        verwalten. Hierfür reicht ein simples </p><pre class="programlisting">  git checkout -b meine_eigenen_änderungen</pre><p>
39 38
        nach dem letzten Kommando (weiterführende Informationen <a class="ulink" href="http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html" target="_top">
40
        Git Magic</a>).</p><p>
41
        Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von 3.4.1 nach 3.5:
42
        </p><pre class="programlisting">
39
        Git Magic</a>).</p><p>Ein beispielhafter Workflow für Druckvorlagen-Anpassungen von
40
        3.4.1 nach 3.5: </p><pre class="programlisting">
43 41
$ git clone https://github.com/kivitendo/kivitendo-erp.git
44 42
$ cd kivitendo-erp/
45 43
$ git checkout release-3.4.1     # das ist der aktuelle release, den wir wollen
doc/html/ch02s04.html
61 61
password =
62 62

  
63 63
[system]
64
default_manager = german</pre><p>Für kivitendo Installationen in der Schweiz sollte hier <code class="varname">german</code>
65
		durch <code class="varname">swiss</code> ersetzt werden.</p><p>Die Einstellung <code class="varname">default_manager = swiss</code> bewirkt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Beim Erstellen einer neuen Datenbank in der kivitendo Administration
66
              werden automatisch die Standard-Werte für die Schweiz voreingestellt:
67
              Währung CHF, 5er-Rundung, Schweizer KMU-Kontenplan, Sollversteuerung,
68
              Aufwandsmethode, Bilanzierung (die Werte können aber manuell angepasst werden).</p></li><li class="listitem"><p>Einstellen der Standardkonten für Rundungserträge und -aufwendungen
69
			(unter Mandantenkonfiguration → Standardkonten veränderbar)</p></li><li class="listitem"><p>das verwendete Zahlenformat wird auf <code class="varname">1'000.00</code> eingestellt
70
				 (unter Programm → Benutzereinstellungen veränderbar)</p></li><li class="listitem"><p>DATEV-Automatik und UStVA werden nicht angezeigt, Erfolgsrechnung
71
				ersetzt GUV ( unter Mandantenkonfiguration → Features veränderbar)</p></li></ul></div><p>Nutzt man wiederkehrende Rechnungen, kann man unter
64
default_manager = german</pre><p>Für kivitendo Installationen in der Schweiz sollte hier
65
        <code class="varname">german</code> durch <code class="varname">swiss</code> ersetzt
66
        werden.</p><p>Die Einstellung <code class="varname">default_manager = swiss</code>
67
        bewirkt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Beim Erstellen einer neuen Datenbank in der kivitendo
68
            Administration werden automatisch die Standard-Werte für die
69
            Schweiz voreingestellt: Währung CHF, 5er-Rundung, Schweizer
70
            KMU-Kontenplan, Sollversteuerung, Aufwandsmethode, Bilanzierung
71
            (die Werte können aber manuell angepasst werden).</p></li><li class="listitem"><p>Einstellen der Standardkonten für Rundungserträge und
72
            -aufwendungen (unter Mandantenkonfiguration → Standardkonten
73
            veränderbar)</p></li><li class="listitem"><p>das verwendete Zahlenformat wird auf
74
            <code class="varname">1'000.00</code> eingestellt (unter Programm →
75
            Benutzereinstellungen veränderbar)</p></li><li class="listitem"><p>DATEV-Automatik und UStVA werden nicht angezeigt,
76
            Erfolgsrechnung ersetzt GUV ( unter Mandantenkonfiguration →
77
            Features veränderbar)</p></li></ul></div><p>Nutzt man wiederkehrende Rechnungen, kann man unter
72 78
        <code class="varname">[periodic_invoices]</code> den Login eines Benutzers
73 79
        angeben, der nach Erstellung der Rechnungen eine entsprechende E-Mail
74 80
        mit Informationen über die erstellten Rechnungen bekommt.</p><p>kivitendo bringt eine eigene Komponente zur zeitgesteuerten
doc/html/ch02s06.html
113 113
        weiteren Zusatzmassnahmen, wie beispielsweise Basic Authenticate. Die
114 114
        Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser
115 115
        Anleitung, hier ein Hinweis auf einen entsprechenden <a class="ulink" href="http://redmine.kivitendo-premium.de/boards/1/topics/142" target="_top">Foreneintrag
116
        (Stand Sept. 2015)</a> und einen aktuellen (Stand Mai 2017)
117
        <a class="ulink" href="https://mozilla.github.io/server-side-tls/ssl-config-generator/" target="_top">
116
        (Stand Sept. 2015)</a> und einen aktuellen (Stand Mai 2017) <a class="ulink" href="https://mozilla.github.io/server-side-tls/ssl-config-generator/" target="_top">
118 117
        SSL-Konfigurations-Generator</a>.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s05.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s07.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.5. Anpassung der PostgreSQL-Konfiguration&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.7. Der Task-Server</td></tr></table></div></body></html>
doc/html/ch02s07.html
8 8
      konfiguriert werden. Danach wird er für jeden Mandanten, für den er
9 9
      laufen soll, in der Adminsitrationsmaske eingeschaltet.</p><p>Beachten Sie, dass der Task-Server in den Boot-Vorgang Ihres
10 10
      Servers integriert werden muss, damit er automatisch gestartet wird.
11
      Dies kann kivitendo nicht für Sie erledigen.</p><p>Da der Taskserver als Perlscript läuft, wird Arbeitsspeicher,
12
      der einmal benötigt wurde, nicht mehr an das Betriebssystem zurückgegeben,
11
      Dies kann kivitendo nicht für Sie erledigen.</p><p>Da der Taskserver als Perlscript läuft, wird Arbeitsspeicher, der
12
      einmal benötigt wurde, nicht mehr an das Betriebssystem zurückgegeben,
13 13
      solange der Taskserver läuft. Dies kann dazu führen, dass ein länger
14 14
      laufender Taskserver mit der Zeit immer mehr Arbeitsspeicher für sich
15
      beansprucht. Es ist deshalb sinnvoll, dass der Taskserver in regelmässigen
16
      Abständen neu gestartet wird.</p><div class="sect2" title="2.7.1. Verfügbare und notwendige Konfigurationsoptionen"><div class="titlepage"><div><div><h3 class="title"><a name="Konfiguration-des-Task-Servers"></a>2.7.1. Verfügbare und notwendige Konfigurationsoptionen</h3></div></div></div><p>Die Konfiguration erfolgt über den Abschnitt
15
      beansprucht. Es ist deshalb sinnvoll, dass der Taskserver in
16
      regelmässigen Abständen neu gestartet wird.</p><div class="sect2" title="2.7.1. Verfügbare und notwendige Konfigurationsoptionen"><div class="titlepage"><div><div><h3 class="title"><a name="Konfiguration-des-Task-Servers"></a>2.7.1. Verfügbare und notwendige Konfigurationsoptionen</h3></div></div></div><p>Die Konfiguration erfolgt über den Abschnitt
17 17
        <code class="literal">[task_server]</code> in der Datei
18 18
        <code class="filename">config/kivitendo.conf</code>. Die dort verfügbaren
19 19
        Optionen sind:</p><div class="variablelist"><dl><dt><span class="term">
......
39 39
        Links aus einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess
40 40
        einzubinden. Da das bei neueren Linux-Distributionen aber nicht
41 41
        zwangsläufig funktioniert, werden auch Start-Scripte mitgeliefert, die
42
        anstelle eines symbolischen Links verwendet werden können.</p><div class="sect3" title="2.7.3.1. SystemV-basierende Systeme (z.B. ältere Debian, ältere OpenSUSE, ältere Fedora)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1142"></a>2.7.3.1. SystemV-basierende Systeme (z.B. ältere Debian, ältere OpenSUSE,
43
          ältere Fedora)</h4></div></div></div><p>Kopieren Sie die Datei
42
        anstelle eines symbolischen Links verwendet werden können.</p><div class="sect3" title="2.7.3.1. SystemV-basierende Systeme (z.B. ältere Debian, ältere OpenSUSE, ältere Fedora)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1142"></a>2.7.3.1. SystemV-basierende Systeme (z.B. ältere Debian, ältere
43
          OpenSUSE, ältere Fedora)</h4></div></div></div><p>Kopieren Sie die Datei
44 44
          <code class="filename">scripts/boot/system-v/kivitendo-task-server</code>
45 45
          nach <code class="filename">/etc/init.d/kivitendo-task-server</code>. Passen
46 46
          Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile
......
53 53
          Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile
54 54
          <code class="literal">exec ....</code>).</p><p>Danach kann der Task-Server mit dem folgenden Befehl gestartet
55 55
          werden:</p><pre class="programlisting">service kivitendo-task-server start</pre></div><div class="sect3" title="2.7.3.3. systemd-basierende Systeme (z.B. neure openSUSE, neuere Fedora, neuere Ubuntu und neuere Debians)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1189"></a>2.7.3.3. systemd-basierende Systeme (z.B. neure openSUSE, neuere
56
          Fedora, neuere Ubuntu und neuere Debians)</h4></div></div></div><p>Kopieren Sie die Datei <code class="filename">scripts/boot/systemd/kivitendo-task-server.service</code> nach
57
          <code class="filename">/etc/systemd/system/</code>. Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeilen
58
          <code class="literal">ExecStart=....</code> und <code class="literal">ExecStop=...</code>).</p><p>Machen Sie anschließend das Script systemd bekannt, und binden Sie es in den Boot-Prozess ein. Dazu führen Sie die folgenden
59
          Befehl aus:</p><pre class="programlisting">systemctl daemon-reload
60
systemctl enable kivitendo-task-server.service</pre><p>Wenn Sie den Task-Server jetzt sofort starten möchten, anstatt den Server neu zu starten, so können Sie das mit dem
61
          folgenden Befehl tun:</p><pre class="programlisting">systemctl start kivitendo-task-server.service</pre></div></div><div class="sect2" title="2.7.4. Wie der Task-Server gestartet und beendet wird"><div class="titlepage"><div><div><h3 class="title"><a name="Prozesskontrolle"></a>2.7.4. Wie der Task-Server gestartet und beendet wird</h3></div></div></div><p>Der Task-Server wird wie folgt kontrolliert:</p><pre class="programlisting">./scripts/task_server.pl Befehl</pre><p>
56
          Fedora, neuere Ubuntu und neuere Debians)</h4></div></div></div><p>Kopieren Sie die Datei
57
          <code class="filename">scripts/boot/systemd/kivitendo-task-server.service</code>
58
          nach <code class="filename">/etc/systemd/system/</code>. Passen Sie in der
59
          kopierten Datei den Pfad zum Task-Server an (Zeilen
60
          <code class="literal">ExecStart=....</code> und
61
          <code class="literal">ExecStop=...</code>).</p><p>Machen Sie anschließend das Script systemd bekannt, und binden
62
          Sie es in den Boot-Prozess ein. Dazu führen Sie die folgenden Befehl
63
          aus:</p><pre class="programlisting">systemctl daemon-reload
64
systemctl enable kivitendo-task-server.service</pre><p>Wenn Sie den Task-Server jetzt sofort starten möchten, anstatt
65
          den Server neu zu starten, so können Sie das mit dem folgenden
66
          Befehl tun:</p><pre class="programlisting">systemctl start kivitendo-task-server.service</pre></div></div><div class="sect2" title="2.7.4. Wie der Task-Server gestartet und beendet wird"><div class="titlepage"><div><div><h3 class="title"><a name="Prozesskontrolle"></a>2.7.4. Wie der Task-Server gestartet und beendet wird</h3></div></div></div><p>Der Task-Server wird wie folgt kontrolliert:</p><pre class="programlisting">./scripts/task_server.pl Befehl</pre><p>
62 67
               <code class="literal">Befehl</code> ist dabei eine der folgenden
63 68
        Optionen:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
64 69
                     <code class="literal">start</code> startet eine neue Instanz des
doc/html/ch02s12.html
154 154
        den eigenen Bedürfnissen angepasst werden. Wichtig beim Editieren von
155 155
        if-Blöcken ist, dass immer der gesamte Block überschrieben werden muss
156 156
        und nicht nur Teile davon, da dies sonst oft zu einer odt-Datei führt,
157
        die vom Parser nicht korrekt gelesen werden kann.</p><p>Mahnungen können unter folgenden Einschränkungen mit den odt-Vorlagen
158
        im Vorlagensatz rev-odt erzeugt werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>als Druckoption steht nur 'PDF(OpenDocument/OASIS)' zur
159
            Verfügung, das heisst, die Mahnungen werden als PDF-Datei ausgegeben.
160
            </p></li><li class="listitem"><p>für jede Rechnung muss eine eigene Mahnung erzeugt werden
157
        die vom Parser nicht korrekt gelesen werden kann.</p><p>Mahnungen können unter folgenden Einschränkungen mit den
158
        odt-Vorlagen im Vorlagensatz rev-odt erzeugt werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>als Druckoption steht nur 'PDF(OpenDocument/OASIS)' zur
159
            Verfügung, das heisst, die Mahnungen werden als PDF-Datei
160
            ausgegeben.</p></li><li class="listitem"><p>für jede Rechnung muss eine eigene Mahnung erzeugt werden
161 161
            (auch wenn bei einzelnen KundInnen mehrere überfällige Rechnungen
162 162
            vorhanden sind).</p></li></ul></div><p>Mehrere Mahnungen für eine Kundin / einen Kunden werden zu einer
163
        PDF-Datei zusammengefasst</p><p>Die Vorlagen zahlungserinnerung.odt sowie mahnung.odt sind für das
164
        Erstellen einer Zahlungserinnerung bzw. Mahnung selbst vorgesehen, die
165
        Vorlage mahnung_invoice.odt für das Erstellen einer Rechnung über die
166
        verrechneten Mahngebühren und Verzugszinsen.</p><p>Zur Zeit gibt es in kivitendo noch keine Möglichkeit,
163
        PDF-Datei zusammengefasst</p><p>Die Vorlagen zahlungserinnerung.odt sowie mahnung.odt sind für
164
        das Erstellen einer Zahlungserinnerung bzw. Mahnung selbst vorgesehen,
165
        die Vorlage mahnung_invoice.odt für das Erstellen einer Rechnung über
166
        die verrechneten Mahngebühren und Verzugszinsen.</p><p>Zur Zeit gibt es in kivitendo noch keine Möglichkeit,
167 167
        odt-Vorlagen bei Briefen und Pflichtenheften einzusetzen.
168 168
        Entsprechende Vorlagen sind deshalb nicht vorhanden.</p><p>Fehlermeldungen, Anregungen und Wünsche bitte senden an:
169 169
        empfang@revamp-it.ch</p></div><div class="sect2" title="2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="allgemeine-hinweise-zu-latex"></a>2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen</h3></div></div></div><p>In den allermeisten Installationen sollte das Drucken jetzt
doc/html/ch02s13.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3 3
   <title>2.13. OpenDocument-Vorlagen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s12.html" title="2.12. Drucken mit kivitendo"><link rel="next" href="ch02s14.html" title="2.14. Nomenklatur"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.13. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s12.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s14.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.13. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.13. OpenDocument-Vorlagen</h2></div></div></div><p>kivitendo unterstützt die Verwendung von Vorlagen im
4
      OpenDocument-Format, wie es LibreOffice oder OpenOffice (ab Version 2) erzeugen.
5
      kivitendo kann dabei sowohl neue OpenDocument-Dokumente als auch aus
6
      diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von
4
      OpenDocument-Format, wie es LibreOffice oder OpenOffice (ab Version 2)
5
      erzeugen. kivitendo kann dabei sowohl neue OpenDocument-Dokumente als
6
      auch aus diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von
7 7
      OpenDocument-Vorlagen zu aktivieren muss in der Datei
8 8
      <code class="filename">config/kivitendo.conf</code> die Variable
9 9
      <code class="literal">opendocument</code> im Abschnitt
10 10
      <code class="literal">print_templates</code> auf ‘<code class="literal">1</code>’ stehen.
11 11
      Dieses ist die Standardeinstellung.</p><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
12 12
      weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
13
      LibreOffice oder OpenOffice benötigt. Soll dieses Feature genutzt werden, so muss
14
      neben LibreOffice oder OpenOffice auch der “X virtual frame buffer”
15
      (xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten.
16
      Andere Distributionen enthalten ihn in anderen Paketen.</p><p>Nach der Installation müssen in der Datei
13
      LibreOffice oder OpenOffice benötigt. Soll dieses Feature genutzt
14
      werden, so muss neben LibreOffice oder OpenOffice auch der “X virtual
15
      frame buffer” (xvfb) installiert werden. Bei Debian ist er im Paket
16
      “xvfb” enthalten. Andere Distributionen enthalten ihn in anderen
17
      Paketen.</p><p>Nach der Installation müssen in der Datei
17 18
      <code class="filename">config/kivitendo.conf</code> im Abschnitt
18
      <code class="literal">applications</code> zwei weitere Variablen
19
      angepasst werden:</p><p>
20
            <code class="literal">openofficeorg_writer</code> muss den
21
      vollständigen Pfad zu LibreOffice oder OpenOffice enthalten.
22
      Dabei dürfen keine Anführungszeichen eingesetzt werden.</p><p>Beispiel für Debian oder Ubuntu:</p><pre class="programlisting">openofficeorg_writer = /usr/bin/libreoffice</pre><p>
19
      <code class="literal">applications</code> zwei weitere Variablen angepasst
20
      werden:</p><p>
21
            <code class="literal">openofficeorg_writer</code> muss den vollständigen
22
      Pfad zu LibreOffice oder OpenOffice enthalten. Dabei dürfen keine
23
      Anführungszeichen eingesetzt werden.</p><p>Beispiel für Debian oder Ubuntu:</p><pre class="programlisting">openofficeorg_writer = /usr/bin/libreoffice</pre><p>
23 24
            <code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer”
24 25
      enthalten.</p><p>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit
25
      LibreOffice bzw. OpenOffice kommuniziert. Die erste Variante, die benutzt
26
      wird, wenn die Variable <code class="literal">$openofficeorg_daemon</code> gesetzt
27
      ist, startet ein LibreOffice oder OpenOffice, das auch nach der Umwandlung
28
      des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen wird dann diese
29
      laufende Instanz benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung
30
      deutlich reduziert wird, weil nicht für jedes Dokument ein LibreOffice bzw.
31
      OpenOffice gestartet werden muss. Der Nachteil ist, dass diese Methode
32
      Python und die Python-UNO-Bindings benötigt, die Bestandteil von LibreOffice
33
      bzw. OpenOffice sind.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Für die Verbindung zu LibreOffice bzw. OpenOffice wird
26
      LibreOffice bzw. OpenOffice kommuniziert. Die erste Variante, die
27
      benutzt wird, wenn die Variable <code class="literal">$openofficeorg_daemon</code>
28
      gesetzt ist, startet ein LibreOffice oder OpenOffice, das auch nach der
29
      Umwandlung des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen
30
      wird dann diese laufende Instanz benutzt. Der Vorteil ist, dass die Zeit
31
      zur Umwandlung deutlich reduziert wird, weil nicht für jedes Dokument
32
      ein LibreOffice bzw. OpenOffice gestartet werden muss. Der Nachteil ist,
33
      dass diese Methode Python und die Python-UNO-Bindings benötigt, die
34
      Bestandteil von LibreOffice bzw. OpenOffice sind.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Für die Verbindung zu LibreOffice bzw. OpenOffice wird
34 35
        normalerweise der Python-Interpreter
35
        <code class="filename">/usr/bin/python</code> benutzt.
36
        Sollte dies nicht der richtige sein, so kann man mit zwei
37
        Konfigurationsvariablen entscheiden, welcher Python-Interpreter
38
        genutzt wird. Mit der Option <code class="literal">python_uno</code> aus dem
39
        Abschnitt <code class="literal">applications</code> wird der Interpreter selber
36
        <code class="filename">/usr/bin/python</code> benutzt. Sollte dies nicht der
37
        richtige sein, so kann man mit zwei Konfigurationsvariablen
38
        entscheiden, welcher Python-Interpreter genutzt wird. Mit der Option
39
        <code class="literal">python_uno</code> aus dem Abschnitt
40
        <code class="literal">applications</code> wird der Interpreter selber
40 41
        festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert
41 42
        <code class="literal">/usr/bin/python</code>.</p><p>Zusätzlich ist es möglich, Pfade anzugeben, in denen Python
42 43
        neben seinen normalen Suchpfaden ebenfalls nach Modulen gesucht wird,
......
48 49
        voneinander getrennt werden. Der Inhalt wird an den Python-Interpreter
49 50
        über die Umgebungsvariable <code class="literal">PYTHONPATH</code>
50 51
        übergeben.</p></td></tr></table></div><p>Ist <code class="literal">$openofficeorg_daemon</code> nicht gesetzt, so
51
      wird für jedes Dokument LibreOffice bzw. OpenOffice neu gestartet
52
      und die Konvertierung mit Hilfe eines Makros durchgeführt. Dieses
53
      Makro muss in der Dokumentenvorlage enthalten sein und
52
      wird für jedes Dokument LibreOffice bzw. OpenOffice neu gestartet und
53
      die Konvertierung mit Hilfe eines Makros durchgeführt. Dieses Makro muss
54
      in der Dokumentenvorlage enthalten sein und
54 55
      “Standard.Conversion.ConvertSelfToPDF()” heißen. Die Beispielvorlage
55
      ‘<code class="literal">templates/print/rev-odt/invoice.odt</code>’
56
      enthält ein solches Makro, das in jeder anderen Dokumentenvorlage
57
      ebenfalls enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen
58
      OpenOffice bzw. LibreOffice dem Verzeichnis mit den Benutzereinstellungen
59
      gibt. Unter Debian ist dies momentan
60
      <code class="literal">~/.config/libreoffice</code>. kivitendo verwendet das
61
      Verzeichnis <code class="literal">users/.openoffice.org2</code>.
62
      Eventuell muss dieses Verzeichnis umbenannt werden.</p><p>Dieses Verzeichnis, wie auch das komplette
56
      ‘<code class="literal">templates/print/rev-odt/invoice.odt</code>’ enthält ein
57
      solches Makro, das in jeder anderen Dokumentenvorlage ebenfalls
58
      enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen OpenOffice
59
      bzw. LibreOffice dem Verzeichnis mit den Benutzereinstellungen gibt.
60
      Unter Debian ist dies momentan <code class="literal">~/.config/libreoffice</code>.
61
      kivitendo verwendet das Verzeichnis
62
      <code class="literal">users/.openoffice.org2</code>. Eventuell muss dieses
63
      Verzeichnis umbenannt werden.</p><p>Dieses Verzeichnis, wie auch das komplette
63 64
      <code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar
64
      sein. Dieses wurde bereits erledigt (siehe <a class="xref" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber
65
      erneut überprüft werden, wenn die Konvertierung nach PDF
66
      fehlschlägt.</p><div class="sect2" title="2.13.1. OpenDocument (odt) Druckvorlagen mit Makros"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2233"></a>2.13.1. OpenDocument (odt) Druckvorlagen mit Makros</h3></div></div></div><p>OpenDocument Vorlagen können Makros enthalten, welche komplexere
65
      sein. Dieses wurde bereits erledigt (siehe <a class="xref" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber erneut
66
      überprüft werden, wenn die Konvertierung nach PDF fehlschlägt.</p><div class="sect2" title="2.13.1. OpenDocument (odt) Druckvorlagen mit Makros"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2233"></a>2.13.1. OpenDocument (odt) Druckvorlagen mit Makros</h3></div></div></div><p>OpenDocument Vorlagen können Makros enthalten, welche komplexere
67 67
        Aufgaben erfüllen.</p><p>Der Vorlagensatz "rev-odt" enthält solche Vorlagen mit <span class="bold"><strong>Schweizer Bank-Einzahlungsscheinen (BESR)</strong></span>.
68 68
        Diese Makros haben die Aufgabe, die in den Einzahlungsscheinen
69 69
        benötigte Referenznummer und Kodierzeile zu erzeugen. Hier eine kurze
......
73 73
          sales_order_besr.odt</p></div><div class="sect3" title="2.13.1.2. Vorbereitungen im Adminbereich"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2251"></a>2.13.1.2. Vorbereitungen im Adminbereich</h4></div></div></div><p>Damit beim Erstellen von Rechnungen und Aufträgen neben der
74 74
          Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit
75 75
          Einzahlungsschein) auswählbar sind, muss für jedes Vorlagen-Suffix
76
          ein Drucker eingerichtet werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Druckeradministration → Drucker hinzufügen</p></li><li class="listitem"><p>Mandant wählen</p></li><li class="listitem"><p>Druckerbeschreibung → aussagekräftiger Text: wird in
77
              der Auftrags- bzw. Rechnungsmaske als Auswahl angezeigt (z.B.
78
              mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Druckbefehl → beliebiger Text (hat für das Erzeugen
79
              von Aufträgen oder Rechnungen als odt-Datei keine Bedeutung,
80
              darf aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel → besr bzw. selbst gewähltes
81
              Vorlagensuffix (muss genau der Zeichenfolge entsprechen, die
82
              zwischen "invoice_" bzw. "sales_order_" und ".odt"
83
              steht.)</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.3. Benutzereinstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2275"></a>2.13.1.3. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
76
          ein Drucker eingerichtet werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Druckeradministration → Drucker hinzufügen</p></li><li class="listitem"><p>Mandant wählen</p></li><li class="listitem"><p>Druckerbeschreibung → aussagekräftiger Text: wird in der
77
              Auftrags- bzw. Rechnungsmaske als Auswahl angezeigt (z.B. mit
78
              Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Druckbefehl → beliebiger Text (hat für das Erzeugen von
79
              Aufträgen oder Rechnungen als odt-Datei keine Bedeutung, darf
80
              aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel → besr bzw. selbst gewähltes Vorlagensuffix
81
              (muss genau der Zeichenfolge entsprechen, die zwischen
82
              "invoice_" bzw. "sales_order_" und ".odt" steht.)</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.3. Benutzereinstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2275"></a>2.13.1.3. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
84 83
          im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann
85 84
          dies persönlich für sich bei den Benutzereinstellungen
86
          konfigurieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Programm → Benutzereinstellungen →
87
              Druckoptionen</p></li><li class="listitem"><p>Standardvorlagenformat → OpenDocument/OASIS</p></li><li class="listitem"><p>Standardausgabekanal → Bildschirm</p></li><li class="listitem"><p>Standarddrucker → gewünschte Druckerbeschreibung
88
              auswählen (z.B. mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Anzahl Kopien → leer</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2299"></a>2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen</h4></div></div></div><p>In der Vorlage sind als Modul "BESR" 4 Makros gespeichert, die
85
          konfigurieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Programm → Benutzereinstellungen → Druckoptionen</p></li><li class="listitem"><p>Standardvorlagenformat → OpenDocument/OASIS</p></li><li class="listitem"><p>Standardausgabekanal → Bildschirm</p></li><li class="listitem"><p>Standarddrucker → gewünschte Druckerbeschreibung auswählen
86
              (z.B. mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Anzahl Kopien → leer</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2299"></a>2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen</h4></div></div></div><p>In der Vorlage sind als Modul "BESR" 4 Makros gespeichert, die
89 87
          aus dem von kivitendo erzeugten odt-Dokument die korrekte
90 88
          Referenznummer inklusive Prüfziffer sowie die Kodierzeile in
91 89
          OCRB-Schrift erzeugen und am richtigen Ort ins Dokument
......
122 120
          wurde.</p></div><div class="sect3" title="2.13.1.6. Makroeinstellungen in LibreOffice anpassen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2368"></a>2.13.1.6. Makroeinstellungen in LibreOffice anpassen</h4></div></div></div><p>Falls beim Öffnen einer von kivitendo erzeugten odt-Rechnung
123 121
          die Meldung kommt, dass Makros aus Sicherheitsgründen nicht
124 122
          ausgeführt werden, so müssen folgende Einstellungen in LibreOffice
125
          angepasst werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Extras → Optionen → Sicherheit →
126
              Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese
123
          angepasst werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Extras → Optionen → Sicherheit → Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese
127 124
              Einstellung muss auf jedem Computer durchgeführt werden, mit dem
128 125
              von kivitendo erzeugte odt-Rechnungen oder Aufträge geöffnet
129 126
              werden.)</p></li><li class="listitem"><p>Beim Öffnen einer odt-Rechnung oder eines odt-Auftrags bei
130
              der entsprechenden Nachfrage "Makros ausführen" auswählen.
131
              </p><p>
127
              der entsprechenden Nachfrage "Makros ausführen"
128
              auswählen.</p><p>
132 129
                        <span class="bold"><strong>Wichtig</strong></span>: die Makros sind
133 130
              so eingestellt, dass sie beim Öffnen der Vorlagen selbst nicht
134 131
              ausgeführt werden. Das heisst für das Ansehen und Bearbeiten der
doc/html/ch02s14.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>2.14. Nomenklatur</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s13.html" title="2.13. OpenDocument-Vorlagen"><link rel="next" href="ch02s15.html" title="2.15. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung: EUR"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.14. Nomenklatur</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s13.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s15.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.14. Nomenklatur"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="nomenclature"></a>2.14. Nomenklatur</h2></div></div></div><div class="sect2" title="2.14.1. Datum bei Buchungen"><div class="titlepage"><div><div><h3 class="title"><a name="booking.dates"></a>2.14.1. Datum bei Buchungen</h3></div></div></div><p>Seit der Version 3.5 werden für Buchungen in kivitendo einheitlich
4
        folgende Bezeichnungen verwendet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
5
                     <code class="option">Erfassungsdatum</code> (en: <code class="option">Entry Date</code>,
6
            code: <code class="option">Gldate</code>)</p><p>bezeichnet das Datum, an dem die Buchung in kivitendo erfasst wurde.
7
            </p></li><li class="listitem"><p>
8
                     <code class="option">Buchungsdatum</code> (en: <code class="option">Booking Date</code>,
9
            code: <code class="option">Transdate</code>)</p><p>bezeichnet das buchhaltungstechnisch für eine Buchung relevante
10
            Datum</p><p>Das <code class="option">Rechnungsdatum</code> bei Verkaufs- und
3
   <title>2.14. Nomenklatur</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s13.html" title="2.13. OpenDocument-Vorlagen"><link rel="next" href="ch02s15.html" title="2.15. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung: EUR"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.14. Nomenklatur</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s13.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s15.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.14. Nomenklatur"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="nomenclature"></a>2.14. Nomenklatur</h2></div></div></div><div class="sect2" title="2.14.1. Datum bei Buchungen"><div class="titlepage"><div><div><h3 class="title"><a name="booking.dates"></a>2.14.1. Datum bei Buchungen</h3></div></div></div><p>Seit der Version 3.5 werden für Buchungen in kivitendo
4
        einheitlich folgende Bezeichnungen verwendet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
5
                     <code class="option">Erfassungsdatum</code> (en: <code class="option">Entry
6
            Date</code>, code: <code class="option">Gldate</code>)</p><p>bezeichnet das Datum, an dem die Buchung in kivitendo
7
            erfasst wurde.</p></li><li class="listitem"><p>
8
                     <code class="option">Buchungsdatum</code> (en: <code class="option">Booking
9
            Date</code>, code: <code class="option">Transdate</code>)</p><p>bezeichnet das buchhaltungstechnisch für eine Buchung
10
            relevante Datum</p><p>Das <code class="option">Rechnungsdatum</code> bei Verkaufs- und
11 11
            Einkaufsrechnungen entspricht dem Buchungsdatum. Das heisst, in
12 12
            Berichten wie dem Buchungsjournal, in denen eine Spalte
13
            <code class="option">Buchungsdatum</code> angezeigt werden kann, erscheint hier
14
            im Fall von Rechnungen das Rechnungsdatum.</p></li><li class="listitem"><p>Bezieht sich ein verbuchter Beleg auf einen Zeitpunkt, der nicht mit
15
            dem Buchungsdatum übereinstimmt, so kann dieses Datum momentan in kivitendo
16
            nur unter Bemerkungen erfasst werden.</p><p>Möglicherweise wird für solche Fälle in einer späteren Version von
17
            kivitendo ein dritter Datumswert für Buchungen erstellt. (Beispiel:
18
            Einkaufsbeleg stammt aus einem früheren Jahr, das bereits
19
            buchhaltungstechnisch abgeschlossen wurde, und muss deshalb später
20
            verbucht werden.)</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s13.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s15.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.13. OpenDocument-Vorlagen&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.15. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:
13
            <code class="option">Buchungsdatum</code> angezeigt werden kann, erscheint
14
            hier im Fall von Rechnungen das Rechnungsdatum.</p></li><li class="listitem"><p>Bezieht sich ein verbuchter Beleg auf einen Zeitpunkt, der
15
            nicht mit dem Buchungsdatum übereinstimmt, so kann dieses Datum
16
            momentan in kivitendo nur unter Bemerkungen erfasst werden.</p><p>Möglicherweise wird für solche Fälle in einer späteren
17
            Version von kivitendo ein dritter Datumswert für Buchungen
18
            erstellt. (Beispiel: Einkaufsbeleg stammt aus einem früheren Jahr,
19
            das bereits buchhaltungstechnisch abgeschlossen wurde, und muss
20
            deshalb später verbucht werden.)</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s13.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s15.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.13. OpenDocument-Vorlagen&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.15. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:
21 21
      EUR</td></tr></table></div></body></html>
doc/html/ch02s15.html
38 38
        benötigt und kann entfernt werden. Dies muss manuell geschehen.</p></div><div class="sect2" title="2.15.3. Festlegen der Parameter"><div class="titlepage"><div><div><h3 class="title"><a name="config.eur.setting-parameters"></a>2.15.3. Festlegen der Parameter</h3></div></div></div><p>Beim Anlegen eines neuen Mandanten bzw. einer neuen Datenbank in
39 39
        der Admininstration können diese Optionen nun unabhängig voneinander
40 40
        eingestellt werden.</p><p>Für die Schweiz sind folgende Einstellungen üblich:
41
		</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Sollversteuerung</p></li><li class="listitem"><p>Aufwandsmethode</p></li><li class="listitem"><p>Bilanzierung</p></li></ul></div><p>
42
		Diese Einstellungen werden automatisch beim Erstellen einer neuen
43
		Datenbank vorausgewählt, wenn in <code class="filename">config/kivitendo.conf</code> unter
44
		<code class="varname">[system]</code> 
45
               <code class="literal">default_manager = swiss</code> eingestellt ist.
46
        </p><p>Beim Upgrade bestehender Mandanten wird eur ausgelesen und die
41
        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Sollversteuerung</p></li><li class="listitem"><p>Aufwandsmethode</p></li><li class="listitem"><p>Bilanzierung</p></li></ul></div><p> Diese Einstellungen werden automatisch beim
42
        Erstellen einer neuen Datenbank vorausgewählt, wenn in
43
        <code class="filename">config/kivitendo.conf</code> unter
44
        <code class="varname">[system]</code> 
45
               <code class="literal">default_manager = swiss</code>
46
        eingestellt ist.</p><p>Beim Upgrade bestehender Mandanten wird eur ausgelesen und die
47 47
        Variablen werden so gesetzt, daß sich an der Funktionalität nichts
48 48
        ändert.</p><p>Die aktuelle Konfiguration wird unter Nummernkreise und
49 49
        Standardkonten unter dem neuen Punkt "Einstellungen" (read-only)
doc/html/ch02s16.html
15 15
        dass diese mit dem alten Umsatzsteuersatz von 16% gebucht worden sind,
16 16
        und diese Buchungen sollten entsprechend kontrolliert werden.</p></div><div class="sect2" title="2.16.2. Konto 3804 manuell anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="config.skr04-update-3804.create-chart"></a>2.16.2. Konto 3804 manuell anlegen</h3></div></div></div><p>Die folgenden Schritte sind notwendig, um das Konto manuell
17 17
        anzulegen und zu konfigurieren. Zuerst wird in
18
        <span class="guimenu">System</span> →
19
        <span class="guisubmenu">Kontenübersicht</span> → <span class="guimenuitem">Konto
20
        erfassen</span> das Konto angelegt.</p><div class="screenshot"><div class="mediaobject"><img src="images/skr04-update-3804/konto3804.png"></div></div><p>Als Zweites muss Steuergruppe 13 für Konto 3803 angepasst
18
        <span class="guimenu">System</span> → <span class="guisubmenu">Kontenübersicht</span> →
19
        <span class="guimenuitem">Konto erfassen</span> das Konto angelegt.</p><div class="screenshot"><div class="mediaobject"><img src="images/skr04-update-3804/konto3804.png"></div></div><p>Als Zweites muss Steuergruppe 13 für Konto 3803 angepasst
21 20
        werden. Dazu unter <span class="guimenu">System</span> →
22 21
        <span class="guisubmenu">Steuern</span> →
23 22
        <span class="guimenuitem">Bearbeiten</span> den Eintrag mit Steuerschlüssel
24 23
        13 auswählen und ihn wie im folgenden Screenshot angezeigt
25 24
        anpassen.</p><div class="screenshot"><div class="mediaobject"><img src="images/skr04-update-3804/steuer3803.png"></div></div><p>Als Drittes wird ein neuer Eintrag mit Steuerschlüssel 13 für
26 25
        Konto 3804 (19%) angelegt. Dazu unter <span class="guimenu">System</span> →
27
        <span class="guisubmenu">Steuern</span> →
28
        <span class="guimenuitem">Erfassen</span> auswählen und die Werte aus dem
29
        Screenshot übernehmen.</p><div class="screenshot"><div class="mediaobject"><img src="images/skr04-update-3804/steuer3804.png"></div></div><p>Als Nächstes sind alle Konten anzupassen, die als
26
        <span class="guisubmenu">Steuern</span> → <span class="guimenuitem">Erfassen</span>
27
        auswählen und die Werte aus dem Screenshot übernehmen.</p><div class="screenshot"><div class="mediaobject"><img src="images/skr04-update-3804/steuer3804.png"></div></div><p>Als Nächstes sind alle Konten anzupassen, die als
30 28
        Steuerautomatikkonto die 3803 haben, sodass sie ab dem 1.1.2007 auch
31 29
        Steuerautomatik auf 3804 bekommen. Dies betrifft in der
32 30
        Standardkonfiguration die Konten 4315 und 4726. Als Beispiel für 4315
doc/html/ch02s18.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>2.18. Erfolgsrechnung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s17.html" title="2.17. Verhalten des Bilanzberichts"><link rel="next" href="ch02s19.html" title="2.19. Rundung in Verkaufsbelegen"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.18. Erfolgsrechnung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s17.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s19.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.18. Erfolgsrechnung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.erfolgsrechnung"></a>2.18. Erfolgsrechnung</h2></div></div></div><p>Seit der Version 3.4.1 existiert in kivitendo der Bericht <span class="bold"><strong>
4
	  Erfolgsrechnung</strong></span>.</p><p>Die Erfolgsrechnung kann in der Mandantenkonfiguration unter Features
5
	  an- oder abgeschaltet werden. Mit der Einstellung <code class="varname">default_manager = swiss
6
	  </code> in der <code class="filename">config/kivitendo.conf</code> wird beim neu Erstellen
7
	  einer Datenbank automatisch die Anzeige der Erfolgsrechnung im Menü <span class="guimenu">Berichte
8
	  </span> ausgewählt und ersetzt dort die GUV.</p><p>Im Gegensatz zur GUV werden bei der Erfolgsrechnung sämtliche Aufwands- und
9
	  Erlöskonten einzeln aufgelistet (analog zur Bilanz), sortiert nach ERTRAG und AUFWAND.</p><p>Bei den Konteneinstellungen muss bei jedem Konto, das in der Erfolgsrechnung
10
	  erscheinen soll, unter <code class="varname">Sonstige Einstellungen/Erfolgsrechnung</code>
11
	  entweder <code class="literal">01.Ertrag</code> oder <code class="literal">06.Aufwand</code>  ausgewählt
12
	  werden.</p><p>Wird bei einem Erlöskonto <code class="literal">06.Aufwand</code> ausgewählt,
13
	  so wird dieses Konto als Aufwandsminderung unter AUFWAND aufgelistet.</p><p>Wird bei einem Aufwandskonto <code class="literal">01.Ertrag</code> ausgewählt,
14
	  so wird dieses Konto als Ertragsminderung unter ERTRAG aufgelistet.</p><p>Soll bei einer bereits bestehenden Buchhaltung in Zukunft zusätzlich
15
	  die Erfolgsrechnung als Bericht verwendet werden, so müssen die Einstellungen
16
	  zu allen Erlös- und Aufwandskonten unter <code class="varname">Sonstige
17
	  Einstellungen/Erfolgsrechnung</code> überprüft und allenfalls neu gesetzt werden.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s17.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s19.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.17. Verhalten des Bilanzberichts&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.19. Rundung in Verkaufsbelegen</td></tr></table></div></body></html>
3
   <title>2.18. Erfolgsrechnung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s17.html" title="2.17. Verhalten des Bilanzberichts"><link rel="next" href="ch02s19.html" title="2.19. Rundung in Verkaufsbelegen"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.18. Erfolgsrechnung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s17.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s19.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.18. Erfolgsrechnung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.erfolgsrechnung"></a>2.18. Erfolgsrechnung</h2></div></div></div><p>Seit der Version 3.4.1 existiert in kivitendo der Bericht
4
      <span class="bold"><strong> Erfolgsrechnung</strong></span>.</p><p>Die Erfolgsrechnung kann in der Mandantenkonfiguration unter
5
      Features an- oder abgeschaltet werden. Mit der Einstellung
6
      <code class="varname">default_manager = swiss </code> in der
7
      <code class="filename">config/kivitendo.conf</code> wird beim neu Erstellen einer
8
      Datenbank automatisch die Anzeige der Erfolgsrechnung im Menü
9
      <span class="guimenu">Berichte </span> ausgewählt und ersetzt dort die GUV.</p><p>Im Gegensatz zur GUV werden bei der Erfolgsrechnung sämtliche
10
      Aufwands- und Erlöskonten einzeln aufgelistet (analog zur Bilanz),
11
      sortiert nach ERTRAG und AUFWAND.</p><p>Bei den Konteneinstellungen muss bei jedem Konto, das in der
12
      Erfolgsrechnung erscheinen soll, unter <code class="varname">Sonstige
13
      Einstellungen/Erfolgsrechnung</code> entweder
14
      <code class="literal">01.Ertrag</code> oder <code class="literal">06.Aufwand</code>
15
      ausgewählt werden.</p><p>Wird bei einem Erlöskonto <code class="literal">06.Aufwand</code>
16
      ausgewählt, so wird dieses Konto als Aufwandsminderung unter AUFWAND
17
      aufgelistet.</p><p>Wird bei einem Aufwandskonto <code class="literal">01.Ertrag</code>
18
      ausgewählt, so wird dieses Konto als Ertragsminderung unter ERTRAG
19
      aufgelistet.</p><p>Soll bei einer bereits bestehenden Buchhaltung in Zukunft
20
      zusätzlich die Erfolgsrechnung als Bericht verwendet werden, so müssen
21
      die Einstellungen zu allen Erlös- und Aufwandskonten unter
22
      <code class="varname">Sonstige Einstellungen/Erfolgsrechnung</code> überprüft und
23
      allenfalls neu gesetzt werden.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s17.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s19.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.17. Verhalten des Bilanzberichts&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.19. Rundung in Verkaufsbelegen</td></tr></table></div></body></html>
doc/html/ch02s19.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>2.19. Rundung in Verkaufsbelegen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s18.html" title="2.18. Erfolgsrechnung"><link rel="next" href="ch02s20.html" title="2.20. Einstellungen pro Mandant"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.19. Rundung in Verkaufsbelegen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s18.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s20.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.19. Rundung in Verkaufsbelegen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.rounding"></a>2.19. Rundung in Verkaufsbelegen</h2></div></div></div><p>In der Schweiz hat die kleinste aktuell benutzte Münze den Wert von 5 Rappen (0.05 CHF).</p><p>Auch wenn im elektronischen Zahlungsverkehr Beträge mit einer Genauigkeit
4
	  von 0.01 CHF verwendet werden können, ist es trotzdem nach wie vor üblich,
5
	  Rechnungen mit auf 0.05 CHF gerundeten Beträgen auszustellen.</p><p>In kivitendo kann seit der Version 3.4.1 die Einstellung für eine solche
6
	  Rundung pro Mandant / Datenbank festgelegt werden.</p><p>Die Einstellung wird beim Erstellen der Datenbank bei <code class="literal">Genauigkeit</code>
7
	  festgelegt. Sie kann anschliessend über das Webinterface von kivitendo nicht mehr
8
	  verändert werden.</p><p>Abhängig vom Wert für <code class="varname">default_manager</code> in
9
	  <code class="filename">config/kivitendo.conf</code> werden dabei folgende
10
	  Werte voreingestellt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>0.05 (default_manager = swiss)</p></li><li class="listitem"><p>0.01 (default_manager = german)</p></li></ul></div><p>Der Wert wird in der Datenbank in der Tabelle <code class="varname">defaults
3
   <title>2.19. Rundung in Verkaufsbelegen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s18.html" title="2.18. Erfolgsrechnung"><link rel="next" href="ch02s20.html" title="2.20. Einstellungen pro Mandant"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.19. Rundung in Verkaufsbelegen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s18.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s20.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.19. Rundung in Verkaufsbelegen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.rounding"></a>2.19. Rundung in Verkaufsbelegen</h2></div></div></div><p>In der Schweiz hat die kleinste aktuell benutzte Münze den Wert
4
      von 5 Rappen (0.05 CHF).</p><p>Auch wenn im elektronischen Zahlungsverkehr Beträge mit einer
5
      Genauigkeit von 0.01 CHF verwendet werden können, ist es trotzdem nach
6
      wie vor üblich, Rechnungen mit auf 0.05 CHF gerundeten Beträgen
7
      auszustellen.</p><p>In kivitendo kann seit der Version 3.4.1 die Einstellung für eine
8
      solche Rundung pro Mandant / Datenbank festgelegt werden.</p><p>Die Einstellung wird beim Erstellen der Datenbank bei
9
      <code class="literal">Genauigkeit</code> festgelegt. Sie kann anschliessend über
10
      das Webinterface von kivitendo nicht mehr verändert werden.</p><p>Abhängig vom Wert für <code class="varname">default_manager</code> in
11
      <code class="filename">config/kivitendo.conf</code> werden dabei folgende Werte
12
      voreingestellt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>0.05 (default_manager = swiss)</p></li><li class="listitem"><p>0.01 (default_manager = german)</p></li></ul></div><p>Der Wert wird in der Datenbank in der Tabelle <code class="varname">defaults
11 13
      </code>in der Spalte <code class="varname">precision</code> gespeichert.</p><p>In allen Verkaufsangeboten, Verkaufsaufträgen, Verkaufsrechnungen
12
      und Verkaufsgutschriften wird der Endbetrag inkl. MWST gerundet,
13
      wenn dieser nicht der eingestellten Genauigkeit entspricht.</p><p>Beim Buchen einer Verkaufsrechnung wird der Rundungsbetrag
14
      und Verkaufsgutschriften wird der Endbetrag inkl. MWST gerundet, wenn
15
      dieser nicht der eingestellten Genauigkeit entspricht.</p><p>Beim Buchen einer Verkaufsrechnung wird der Rundungsbetrag
14 16
      automatisch auf die in der Mandantenkonfiguration festgelegten
15
      Standardkonten für Rundungserträge bzw. Rundungsaufwendungen gebucht.</p><p>(Die berechnete MWST wird durch den Rundungsbetrag nicht mehr verändert.)</p><p>Die in den Druckvorlagen zur Verfügung stehenden Variablen
17
      Standardkonten für Rundungserträge bzw. Rundungsaufwendungen
18
      gebucht.</p><p>(Die berechnete MWST wird durch den Rundungsbetrag nicht mehr
19
      verändert.)</p><p>Die in den Druckvorlagen zur Verfügung stehenden Variablen
16 20
      <code class="varname">quototal</code>, <code class="varname">ordtotal</code> bzw.
17 21
      <code class="varname">invtotal</code> enthalten den gerundeten Betrag.</p><p>
18
            <span class="bold"><strong>Achtung:</strong></span> Werden Verkaufsbelege
19
      in anderen Währungen als der Standardwährung erstellt, so muss in
20
      kivitendo ab Version 3.4.1 die Genauigkeit 0.01 verwendet werden.</p><p>Das heisst, Firmen in der Schweiz, die teilweise Verkaufsrechnungen
21
      in Euro oder anderen Währungen erstellen wollen, müssen beim Erstellen
22
      der Datenbank als Genauigkeit 0.01 wählen und können zur Zeit die
23
      5er Rundung noch nicht nutzen.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s18.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s20.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.18. Erfolgsrechnung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.20. Einstellungen pro Mandant</td></tr></table></div></body></html>
22
            <span class="bold"><strong>Achtung:</strong></span> Werden Verkaufsbelege in
23
      anderen Währungen als der Standardwährung erstellt, so muss in kivitendo
24
      ab Version 3.4.1 die Genauigkeit 0.01 verwendet werden.</p><p>Das heisst, Firmen in der Schweiz, die teilweise
25
      Verkaufsrechnungen in Euro oder anderen Währungen erstellen wollen,
26
      müssen beim Erstellen der Datenbank als Genauigkeit 0.01 wählen und
27
      können zur Zeit die 5er Rundung noch nicht nutzen.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s18.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s20.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.18. Erfolgsrechnung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.20. Einstellungen pro Mandant</td></tr></table></div></body></html>
doc/html/ch03s03.html
6 6
        <code class="function">&lt;%variablenname%&gt;</code> verwendet wird. Für
7 7
        LaTeX- und HTML-Vorlagen kann man die Form dieser Tags auch verändern
8 8
        (siehe <a class="xref" href="ch03s03.html#dokumentenvorlagen-und-variablen.tag-style" title="3.3.4. Anfang und Ende der Tags verändern">Anfang und Ende der Tags verändern</a>).</p><p>kivitendo unterstützt LaTeX-, HTML- und OpenDocument-Vorlagen.
9
        Sofern es nicht ausdrücklich eingeschränkt wird, gilt das im
10
        Folgenden gesagte für alle Vorlagenarten.</p><p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
9
        Sofern es nicht ausdrücklich eingeschränkt wird, gilt das im Folgenden
10
        gesagte für alle Vorlagenarten.</p><p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
11 11
        verfügbar als hier aufgelistet werden. Die meisten davon können
12 12
        allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
13 13
        werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann
......
386 386
                        <code class="varname">quonumber</code>
387 387
                     </span></dt><dd><p>Angebotsnummer</p></dd><dt><span class="term">
388 388
                        <code class="varname">rounding</code>
389
                     </span></dt><dd><p>Betrag, um den <code class="varname">invtotal</code> gerundet wurde
390
                (kann positiv oder negativ sein)</p></dd><dt><span class="term">
389
                     </span></dt><dd><p>Betrag, um den <code class="varname">invtotal</code> gerundet
390
                wurde (kann positiv oder negativ sein)</p></dd><dt><span class="term">
391 391
                        <code class="varname">shippingpoint</code>
392 392
                     </span></dt><dd><p>Versandort</p></dd><dt><span class="term">
393 393
                        <code class="varname">shipvia</code>
......
522 522
          unter dem Namen <code class="varname">vc_cvar_number_of_employees</code> zur
523 523
          Verfügung.</p><p>Die benutzerdefinierten Variablen der Lieferadressen stehen
524 524
          unter einem ähnlichen Namensschema zur Verfügung. Hier lautet der
525
          Präfix <code class="varname">shiptocvar_</code>.</p></div></div><div class="sect2" title="3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dunning"></a>3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren</h3></div></div></div><div class="sect3" title="3.3.9.1. Namen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-vorlagennamen"></a>3.3.9.1. Namen der Vorlagen</h4></div></div></div><p>Die Namen der Vorlagen werden im System-Menü vom Benutzer
525
          Präfix <code class="varname">shiptocvar_</code>.</p><p>Analog stehen die benutzerdefinierten Variablen für
526
          Ansprechpersonen mit dem Namenspräfix <code class="varname">cp_cvar_</code>
527
          zur Verfügung.</p></div></div><div class="sect2" title="3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dunning"></a>3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren</h3></div></div></div><div class="sect3" title="3.3.9.1. Namen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-vorlagennamen"></a>3.3.9.1. Namen der Vorlagen</h4></div></div></div><p>Die Namen der Vorlagen werden im System-Menü vom Benutzer
526 528
          eingegeben. Wird für ein Mahnlevel die Option zur automatischen
527 529
          Erstellung einer Rechnung über die Mahngebühren und Zinsen
528 530
          aktiviert, so wird der Name der Vorlage für diese Rechnung aus dem
529 531
          Vorlagenname für diese Mahnstufe mit dem Zusatz
530 532
          <code class="constant">_invoice</code> gebildet. Weiterhin werden die Kürzel
531 533
          für die ausgewählte Sprache und den ausgewählten Drucker
532
          angehängt.</p></div><div class="sect3" title="3.3.9.2. Allgemeine Variablen in Mahnungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-allgemein"></a>3.3.9.2. Allgemeine Variablen in Mahnungen</h4></div></div></div><p>Die Variablen des Bearbeiters, bzw. Verkäufers stehen wie gewohnt als
533
          <code class="varname">employee_...</code> bzw. <code class="varname">salesman_...</code> zur Verfügung.
534
          Werden mehrere Rechnungen in einer Mahnung zusammengefasst, so werden
535
          die Metadaten (Bearbeiter, Abteilung, etc) der ersten angemahnten Rechnung
536
          im Ausdruck genommen.</p><p>Die Adressdaten des Kunden stehen als Variablen <code class="varname">name</code>,
537
          <code class="varname">street</code>, <code class="varname">zipcode</code>,
538
          <code class="varname">city</code>, <code class="varname">country</code>,
539
          <code class="varname">department_1</code>, <code class="varname">department_2</code>,
540
          und <code class="varname">email</code> zur Verfügung. Der Ansprechpartner <code class="varname">cp_...</code>
541
          steht auch zu Verfügung, wird allerdings auch nur von der ersten angemahnten Rechnung (s.o.)
542
          genommen.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">
534
          angehängt.</p></div><div class="sect3" title="3.3.9.2. Allgemeine Variablen in Mahnungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-allgemein"></a>3.3.9.2. Allgemeine Variablen in Mahnungen</h4></div></div></div><p>Die Variablen des Bearbeiters, bzw. Verkäufers stehen wie
535
          gewohnt als <code class="varname">employee_...</code> bzw.
536
          <code class="varname">salesman_...</code> zur Verfügung. Werden mehrere
537
          Rechnungen in einer Mahnung zusammengefasst, so werden die Metadaten
538
          (Bearbeiter, Abteilung, etc) der ersten angemahnten Rechnung im
539
          Ausdruck genommen.</p><p>Die Adressdaten des Kunden stehen als Variablen
540
          <code class="varname">name</code>, <code class="varname">street</code>,
541
          <code class="varname">zipcode</code>, <code class="varname">city</code>,
542
          <code class="varname">country</code>, <code class="varname">department_1</code>,
543
          <code class="varname">department_2</code>, und <code class="varname">email</code> zur
544
          Verfügung. Der Ansprechpartner <code class="varname">cp_...</code> steht auch
545
          zu Verfügung, wird allerdings auch nur von der ersten angemahnten
546
          Rechnung (s.o.) genommen.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">
543 547
                        <code class="varname">dunning_date</code>
544 548
                     </span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term">
545 549
                        <code class="varname">dunning_duedate</code>
......
609 613
                        <code class="varname">invdate</code>
610 614
                     </span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
611 615
                        <code class="varname">invnumber</code>
612
                     </span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.3.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.3.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.3.10.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5630"></a>3.3.10.1. Einführung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ähnlich wie in der
616
                     </span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.3.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.3.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.3.10.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5635"></a>3.3.10.1. Einführung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ähnlich wie in der
613 617
          Rechnung. Allerdings heißen die Variablen, die mit
614 618
          <code class="varname">inv</code> beginnen, jetzt anders. Bei den Angeboten
615 619
          fangen sie mit <code class="varname">quo</code> für "quotation" an:
doc/html/ch03s05.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>3.5. Mandantenkonfiguration Lager</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s04.html" title="3.4. Excel-Vorlagen"><link rel="next" href="ch03s06.html" title="3.6. Schweizer Kontenpläne"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.5. Mandantenkonfiguration Lager</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s04.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s06.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.5. Mandantenkonfiguration Lager"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.warehouse"></a>3.5. Mandantenkonfiguration Lager</h2></div></div></div><p>
4
       Die Lagerverwaltung in kivitendo funktioniert standardmässig wie folgt: Wird ein Lager mit einem Lagerplatz angelegt, so gibt es die
5
       Möglichkeit hier über den Menüpunkt Lager entsprechende Warenbewegungen durchzuführen.  Ferner kann jede Position eines Lieferscheins
6
       ein-, bzw. ausgelagert werden (Einkauf-, bzw. Verkauf). Es können beliebig viele Lager mit beliebig vielen Lagerplätzen abgebildet
7
       werden. Die Lagerbewegungen über einen Lieferschein erfolgt durch Anklicken jeder Einzelposition und das Auswählen dieser Position zu
8
       einem Lager mit Lagerplatz. Dieses Verfahren lässt sich schrittweise vereinfachen, je nachdem wie die Einstellungen in der
9
       Mandatenkonfiguration gesetzt werden.
10
      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
3
   <title>3.5. Mandantenkonfiguration Lager</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s04.html" title="3.4. Excel-Vorlagen"><link rel="next" href="ch03s06.html" title="3.6. Schweizer Kontenpläne"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.5. Mandantenkonfiguration Lager</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s04.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s06.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.5. Mandantenkonfiguration Lager"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.warehouse"></a>3.5. Mandantenkonfiguration Lager</h2></div></div></div><p>Die Lagerverwaltung in kivitendo funktioniert standardmässig wie
4
      folgt: Wird ein Lager mit einem Lagerplatz angelegt, so gibt es die
5
      Möglichkeit hier über den Menüpunkt Lager entsprechende Warenbewegungen
6
      durchzuführen. Ferner kann jede Position eines Lieferscheins ein-, bzw.
7
      ausgelagert werden (Einkauf-, bzw. Verkauf). Es können beliebig viele
8
      Lager mit beliebig vielen Lagerplätzen abgebildet werden. Die
9
      Lagerbewegungen über einen Lieferschein erfolgt durch Anklicken jeder
10
      Einzelposition und das Auswählen dieser Position zu einem Lager mit
11
      Lagerplatz. Dieses Verfahren lässt sich schrittweise vereinfachen, je
12
      nachdem wie die Einstellungen in der Mandatenkonfiguration gesetzt
13
      werden.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
11 14
                  <code class="option">Auslagern über Standardlagerplatz</code> Hier wird
12 15
          ein zusätzlicher Knopf (Auslagern über Standard-Lagerplatz) in dem
13 16
          Lieferschein-Beleg hinzugefügt, der dann alle Lagerbewegungen über
......
17 20
          Lagerbewegung nicht vorhanden ist, möchte man dies auch ignorieren
18 21
          und ggf. dann nachpflegen, so kann man eine Negativ-Warenmenge mit
19 22
          dieser Option erlauben. Hierfür muss ein entsprechender Lagerplatz
20
          (Fehlbestand, o.ä.) konfiguriert sein.</p></li></ul></div><p>
21
       Zusätzliche Funktionshinweise:
22
      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
23
          (Fehlbestand, o.ä.) konfiguriert sein.</p></li></ul></div><p>Zusätzliche Funktionshinweise:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
23 24
                  <code class="option">Standard-Lagerplatz</code> Ist dieser konfiguriert,
24 25
          wird dies auch als Standard-Voreinstellung bei der Neuerfassung von
25 26
          Stammdaten → Waren / Dienstleistung / Erzeugnis verwendet.</p></li><li class="listitem"><p>
doc/html/ch03s06.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>3.6. Schweizer Kontenpläne</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s05.html" title="3.5. Mandantenkonfiguration Lager"><link rel="next" href="ch03s07.html" title="3.7. Artikelklassifizierung"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.6. Schweizer Kontenpläne</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s07.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.6. Schweizer Kontenpläne"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.swiss-charts-of-accounts"></a>3.6. Schweizer Kontenpläne</h2></div></div></div><p>Seit der Version 3.5 stehen in kivitendo 3 Kontenpläne für
4
	  den Einsatz in der Schweiz zur Verfügung, einer für Firmen und
5
	  Organisationen, die nicht mehrwertsteuerpflichtig sind, einer
6
	  für Firmen, die mehrwertsteuerpflichtig sind und einer speziell
7
          für Vereine.</p><p>Die Kontenpläne orientieren sich am in der Schweiz üblicherweise
8
	  verwendeten KMU-Kontenrahmen und sind mit der Revision des Schweizerischen
9
	  Obligationenrechts (OR) vom 1.1.2013 kompatibel, insbesondere
10
	  <code class="literal">Art.957a Abs.2</code>.</p><p>Beim Vereinskontenplan sind standardmässig nur die Konten 1100
11
          (Debitoren CHF) und 1101 (Debitoren EUR) als Buchungskonten im Verkauf
12
          sowie die Konten 2000 (Kreditoren CHF) und 2001 (Kreditoren EUR) als
13
          Buchungskonten im Einkauf vorgesehen. Weitere Konten können bei Bedarf
14
          in den Konto-Detaileinstellungen als Einkaufs- oder Verkaufskonten
15
          konfiguriert werden.</p><p>Die Möglichkeit, Saldosteuersätze zu verwenden ist in der aktuellen
16
	  Version von kivitendo noch nicht integriert.</p><p>Trotzdem können auch Firmen, die per Saldosteuersatz mit der
17
	  Eidgenössischen Steuerverwaltung abrechnen, kivitendo bereits nutzen.
18
	  Dazu wird der Kontenplan mit MWST ausgewählt. Anschliessend müssen
19
	  alle Aufwandskonten editiert werden und dort der Steuersatz auf 0%
20
	  gesetzt werden.</p><p>So werden bei Kreditorenbuchungen keine Vorsteuern verbucht.</p><p>Bezugssteuern für aus dem Ausland bezogene Dienstleistungen müssen
21
          manuell verbucht werden.</p><p>Wünsche für Anpassungen an den Schweizer Kontenplänen sowie
22
	  Vorschläge für weitere (z.B. branchenspezifische) Kontenpläne
23
	  bitte an <code class="literal">empfang@revamp-it.ch</code> senden.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s07.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.5. Mandantenkonfiguration Lager&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;3.7. Artikelklassifizierung</td></tr></table></div></body></html>
3
   <title>3.6. Schweizer Kontenpläne</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s05.html" title="3.5. Mandantenkonfiguration Lager"><link rel="next" href="ch03s07.html" title="3.7. Artikelklassifizierung"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.6. Schweizer Kontenpläne</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s07.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.6. Schweizer Kontenpläne"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.swiss-charts-of-accounts"></a>3.6. Schweizer Kontenpläne</h2></div></div></div><p>Seit der Version 3.5 stehen in kivitendo 3 Kontenpläne für den
4
      Einsatz in der Schweiz zur Verfügung, einer für Firmen und
5
      Organisationen, die nicht mehrwertsteuerpflichtig sind, einer für
6
      Firmen, die mehrwertsteuerpflichtig sind und einer speziell für
7
      Vereine.</p><p>Die Kontenpläne orientieren sich am in der Schweiz üblicherweise
8
      verwendeten KMU-Kontenrahmen und sind mit der Revision des
9
      Schweizerischen Obligationenrechts (OR) vom 1.1.2013 kompatibel,
10
      insbesondere <code class="literal">Art.957a Abs.2</code>.</p><p>Beim Vereinskontenplan sind standardmässig nur die Konten 1100
11
      (Debitoren CHF) und 1101 (Debitoren EUR) als Buchungskonten im Verkauf
12
      sowie die Konten 2000 (Kreditoren CHF) und 2001 (Kreditoren EUR) als
13
      Buchungskonten im Einkauf vorgesehen. Weitere Konten können bei Bedarf
14
      in den Konto-Detaileinstellungen als Einkaufs- oder Verkaufskonten
15
      konfiguriert werden.</p><p>Die Möglichkeit, Saldosteuersätze zu verwenden ist in der
16
      aktuellen Version von kivitendo noch nicht integriert.</p><p>Trotzdem können auch Firmen, die per Saldosteuersatz mit der
17
      Eidgenössischen Steuerverwaltung abrechnen, kivitendo bereits nutzen.
18
      Dazu wird der Kontenplan mit MWST ausgewählt. Anschliessend müssen alle
19
      Aufwandskonten editiert werden und dort der Steuersatz auf 0% gesetzt
20
      werden.</p><p>So werden bei Kreditorenbuchungen keine Vorsteuern
21
      verbucht.</p><p>Bezugssteuern für aus dem Ausland bezogene Dienstleistungen müssen
22
      manuell verbucht werden.</p><p>Wünsche für Anpassungen an den Schweizer Kontenplänen sowie
23
      Vorschläge für weitere (z.B. branchenspezifische) Kontenpläne bitte an
24
      <code class="literal">empfang@revamp-it.ch</code> senden.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s05.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s07.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.5. Mandantenkonfiguration Lager&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;3.7. Artikelklassifizierung</td></tr></table></div></body></html>
doc/html/ch03s07.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>3.7. Artikelklassifizierung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s06.html" title="3.6. Schweizer Kontenpläne"><link rel="next" href="ch03s08.html" title="3.8. Dateiverwaltung (Mini-DMS)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.7. Artikelklassifizierung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s06.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.7. Artikelklassifizierung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.part_classification"></a>3.7. Artikelklassifizierung</h2></div></div></div><div class="sect2" title="3.7.1. Übersicht"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6298"></a>3.7.1. Übersicht</h3></div></div></div><p>Die Klassifizierung von Artikeln dient einer weiteren Gliederung,
4
        um zum Beispiel den Einkauf vom Verkauf zu trennen, gekennzeichnet
5
        durch eine Beschreibung (z.B. "Einkauf") und ein Kürzel (z.B. "E").
6
        Für jede Klassifizierung besteht eine Beschreibung und eine Abkürzung
7
        die normalerweise aus einem Zeichen besteht, kann aber auf mehrere
8
        Zeichen erweitert werden, falls zur Unterscheidung notwendig. Sinnvoll
9
        sind jedoch nur maximal 2 Zeichen.</p></div><div class="sect2" title="3.7.2. Basisklassifizierung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6303"></a>3.7.2. Basisklassifizierung</h3></div></div></div><p>Als Basisklassifizierungen gibt es</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Einkauf</p></li><li class="listitem"><p>Verkauf</p></li><li class="listitem"><p>Handelsware</p></li><li class="listitem"><p>Produktion</p></li><li class="listitem"><p>- keine - (diese wird bei einer Aktualisierung für alle
3
   <title>3.7. Artikelklassifizierung</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s06.html" title="3.6. Schweizer Kontenpläne"><link rel="next" href="ch03s08.html" title="3.8. Dateiverwaltung (Mini-DMS)"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.7. Artikelklassifizierung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s06.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.7. Artikelklassifizierung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.part_classification"></a>3.7. Artikelklassifizierung</h2></div></div></div><div class="sect2" title="3.7.1. Übersicht"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6303"></a>3.7.1. Übersicht</h3></div></div></div><p>Die Klassifizierung von Artikeln dient einer weiteren
4
        Gliederung, um zum Beispiel den Einkauf vom Verkauf zu trennen,
5
        gekennzeichnet durch eine Beschreibung (z.B. "Einkauf") und ein Kürzel
6
        (z.B. "E"). Für jede Klassifizierung besteht eine Beschreibung und
7
        eine Abkürzung die normalerweise aus einem Zeichen besteht, kann aber
8
        auf mehrere Zeichen erweitert werden, falls zur Unterscheidung
9
        notwendig. Sinnvoll sind jedoch nur maximal 2 Zeichen.</p></div><div class="sect2" title="3.7.2. Basisklassifizierung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6308"></a>3.7.2. Basisklassifizierung</h3></div></div></div><p>Als Basisklassifizierungen gibt es</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Einkauf</p></li><li class="listitem"><p>Verkauf</p></li><li class="listitem"><p>Handelsware</p></li><li class="listitem"><p>Produktion</p></li><li class="listitem"><p>- keine - (diese wird bei einer Aktualisierung für alle
10 10
            existierenden Artikel verwendet und ist gültig für Verkauf und
11 11
            Einkauf)</p></li></ul></div><p>Es können weitere Klassifizierungen angelegt werden. So kann es
12
        z.B. für separat auszuweisende Artikel folgende Klassen geben:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Lieferung (Logistik, Transport) mit Kürzel L</p></li><li class="listitem"><p>Material (Verpackungsmaterial) mit Kürzel M</p></li></ul></div></div><div class="sect2" title="3.7.3. Attribute"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6333"></a>3.7.3. Attribute</h3></div></div></div><p>Bisher haben die Klassifizierungen folgende Attribute, die auch
12
        z.B. für separat auszuweisende Artikel folgende Klassen geben:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Lieferung (Logistik, Transport) mit Kürzel L</p></li><li class="listitem"><p>Material (Verpackungsmaterial) mit Kürzel M</p></li></ul></div></div><div class="sect2" title="3.7.3. Attribute"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6338"></a>3.7.3. Attribute</h3></div></div></div><p>Bisher haben die Klassifizierungen folgende Attribute, die auch
13 13
        alle gleichzeitg gültig sein können</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>gültig für Verkauf - dieser Artikel kann im Verkauf genutzt
14 14
            werden</p></li><li class="listitem"><p>gültig für Einkauf - dieser Artikel kann im Einkauf genutzt
15 15
            werden</p></li><li class="listitem"><p>separat ausweisen - hierzu gibt es zur Dokumentengenerierung
16
            (LaTeX) eine zusätzliche Variable</p></li></ul></div><p>Für das Attribut "separat ausweisen" stehen in den LaTeX-Vorlagen
17
        die Variable <span class="bold"><strong>&lt;%non_separate_subtotal%&gt;
18
        </strong></span>zur Verfügung, die alle nicht separat auszuweisenden
19
        Artikelkosten saldiert, sowie pro separat auszuweisenden
20
        Klassifizierungen die Variable<span class="bold"><strong>&lt;
21
        %separate_X_subtotal%&gt;</strong></span>, wobei X das Kürzel der
22
        Klassifizierung ist.</p><p>Im obigen Beispiel wäre das für Lieferkosten <span class="bold"><strong>&lt;%separate_L_subtotal%&gt;</strong></span> und für
16
            (LaTeX) eine zusätzliche Variable</p></li></ul></div><p>Für das Attribut "separat ausweisen" stehen in den
17
        LaTeX-Vorlagen die Variable <span class="bold"><strong>&lt;%non_separate_subtotal%&gt; </strong></span>zur Verfügung,
18
        die alle nicht separat auszuweisenden Artikelkosten saldiert, sowie
19
        pro separat auszuweisenden Klassifizierungen die Variable<span class="bold"><strong>&lt; %separate_X_subtotal%&gt;</strong></span>, wobei X das
20
        Kürzel der Klassifizierung ist.</p><p>Im obigen Beispiel wäre das für Lieferkosten <span class="bold"><strong>&lt;%separate_L_subtotal%&gt;</strong></span> und für
23 21
        Verpackungsmaterial <span class="bold"><strong>
24
        &lt;%separate_M_subtotal%&gt;</strong></span>.</p></div><div class="sect2" title="3.7.4. Zwei-Zeichen Abkürzung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6364"></a>3.7.4. Zwei-Zeichen Abkürzung</h3></div></div></div><p>Der Typ des Artikels und die Klassifizierung werden durch zwei
22
        &lt;%separate_M_subtotal%&gt;</strong></span>.</p></div><div class="sect2" title="3.7.4. Zwei-Zeichen Abkürzung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6369"></a>3.7.4. Zwei-Zeichen Abkürzung</h3></div></div></div><p>Der Typ des Artikels und die Klassifizierung werden durch zwei
25 23
        Buchstaben dargestellt. Der erste Buchstabe ist eine Lokalisierung des
26 24
        Artikel-Typs ('P','A','S'), deutsch 'W', 'E', und 'D' für Ware
27 25
        Erzeugnis oder Dienstleistung und ggf. weiterer Typen.</p><p>Der zweite Buchstabe (und ggf. auch ein dritter, falls nötig)
doc/html/ch03s08.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>3.8. Dateiverwaltung (Mini-DMS)</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s07.html" title="3.7. Artikelklassifizierung"><link rel="next" href="ch04.html" title="Kapitel 4. Entwicklerdokumentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.8. Dateiverwaltung (Mini-DMS)</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s07.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.8. Dateiverwaltung (Mini-DMS)"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.file_managment"></a>3.8. Dateiverwaltung (Mini-DMS)</h2></div></div></div><div class="sect2" title="3.8.1. Übersicht"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6376"></a>3.8.1. Übersicht</h3></div></div></div><p>Parallel zum alten WebDAV gibt es ein Datei-Management-System, das Dateien
4
        verschiedenen Typs verwaltet. Dies können</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>aus ERP-Daten per LaTeX Template erzeugte PDF-Dokumente,</p></li><li class="listitem"><p>zu bestimmten ERP-Daten gehörende Anhangdateien unterschiedlichen Formats,</p></li><li class="listitem"><p>per Scanner eingelesene PDF-Dateien,</p></li><li class="listitem"><p>per E-Mail empfangene Dateianhänge unterschiedlichen Formats,</p></li><li class="listitem"><p>sowie speziel für Artikel hochgeladene Bilder sein.</p></li></ol></div><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Overview.png"></div></div></div><div class="sect2" title="3.8.2. Struktur"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6403"></a>3.8.2. Struktur</h3></div></div></div><p>Ü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:
5
      </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Dateisystem</p></li><li class="listitem"><p>WebDAV</p></li><li class="listitem"><p>Schnittstelle zu externen Dokumenten-Management-Systemen</p></li><li class="listitem"><p>andere Datenbank</p></li><li class="listitem"><p>etc ...</p></li></ul></div><p>Es gibt unterschiedliche Typen von Dateien. Jedem Typ läßt sich in der
6
              Mandantenkonfiguration ein bestimmtes Backend zuordnen.
7
        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>"document": Das sind entweder generierte, eingescannte oder hochgeladene PDF-Dateien,
8
                  die zu bestimmten ERP-Daten (ERP-Objekte, wie z.B. Rechnung, Lieferschein) gehören.</p></li><li class="listitem"><p>"attachment": zusätzlich hochgeladene Dokumente, die an bestimmte ERP-Objekte angehängt werden,
9
            z.B. technische Zeichnungen, Aufmaße. Diese können auch für Artikel,
10
            Lieferanten und Kunden hinterlegt sein.</p></li><li class="listitem"><p>"image": Bilder für Artikel. Diese können auch verkleinert in einer Vorschau (Thumbnail)
11
            angezeigt werden.</p></li></ul></div><p>Zusätzlich werden in der Datenbank zu den Dateien neben der Zuordnung zu ERP-Objekten, Dateityp
12
        Dateinamen und Backend, in dem die Datei gespeichert ist, auch die Quelle der Datei notiert:
13
        </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> "created": vom System erzeugte Dokumente"</p></li><li class="listitem"><p> "uploaded": hochgeladene Dokumente</p></li><li class="listitem"><p> "email": vom Mail-System empfangene Dateien</p></li><li class="listitem"><p> "scanner[1]": von einem oder mehreren Scannern erzeugte Dateien. Existieren mehrere Scanner,
14
            so sind diese durch unterschiedliche Quellennamen zu definieren.</p></li></ul></div><p>Je nach Dateityp sind nur bestimmte Quellen zulässig. So gibt es für "attachment" und "image" nur
15
        die Quelle "uploaded". Für "document" gibt es auf jeden Fall die Quelle "created".
16
        Die Quellen "scanner" und "email" müssen derzeit in der Datenbank konfiguriert werden
17
        (siehe <a class="xref" href="ch03s08.html#file_management.dbconfig" title="3.8.4.2. Datenbank-Konfigurierung">Datenbank-Konfigurierung</a>).</p></div><div class="sect2" title="3.8.3. Anwendung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6455"></a>3.8.3. Anwendung</h3></div></div></div><p>Die Daten werden bei den ERP-Objekten als extra Reiter dargestellt.
18
        Eine Verkaufsrechnung z.B. hat die
19
        Reiter "Dokumente" und "Dateianhänge".</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Anhaenge.png"></div></div><p>Bei den Dateianhängen wird immer nur die aktuelle Version einer Datei angezeigt.
20
        Wird eine Datei mit gleichem Namen hochgeladen, so wird eine neue Version der Datei erstellt.
21
        Vorher wird der Anwender durch einen Dialog gefragt, ob er eine neue Version anlegen will oder
22
        ob er die Datei umbenennen will, falls es eine neue Datei sein soll.</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Anhaenge-hochladen.png"></div></div><p>Es können mehrere Dateien gleichzeitig hochgeladen werden,
23
        solange in Summe die maximale Größe nicht überschritten wird
24
        (siehe <a class="xref" href="ch03s08.html#file_management.clientconfig" title="3.8.4.1. Mandantenkonfiguration">Mandantenkonfigurierung</a>).</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Dokumente.png"></div></div><p>Sind keine weiteren Quellen für Dokumente konfiguriert, so gibt es nur "erzeugte Dokumente".
25
        Es werden alle Versionen der generierten Datei angezeigt. Für Verkaufsrechnungen kommen keine
26
        anderen Quellen zur Geltung. Werden entsprechend der
27
        <a class="xref" href="ch03s08.html#file_management.dbconfig" title="3.8.4.2. Datenbank-Konfigurierung">Datenbank-Konfigurierung</a> zusätzliche Quellen konfiguriert, so sind diese z.B. bei
28
        Einkaufsrechnungen sichtbar:</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Dokumente-Scanner.png"></div></div><p>Statt des Löschens wird hier die Datei zurück zur Quelle verschoben. Somit kann die Datei anschließend
29
        an ein anderes ERP-Objekt angehängt werden.</p><p>Derzeit sind "Titel" und "Beschreibung" noch nicht genutzt. Sie sind bisher nur bei Bildern relevant.</p></div><div class="sect2" title="3.8.4. Konfigurierung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6498"></a>3.8.4. Konfigurierung</h3></div></div></div><div class="sect3" title="3.8.4.1. Mandantenkonfiguration"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.clientconfig"></a>3.8.4.1. Mandantenkonfiguration</h4></div></div></div><div class="sect4" title="3.8.4.1.1. Reiter &#34;Features&#34;"><div class="titlepage"><div><div><h5 class="title"><a name="d0e6504"></a>3.8.4.1.1. Reiter "Features"</h5></div></div></div><p>Unter dem Reiter <span class="bold"><strong>Features</strong></span> im Abschnitt Dateimanagement ist
30
            neben dem "alten" WebDAV das Dateimangement generell zu- und abschaltbar, sowie die Zuordnung der
31
          Dateitypen zu Backends. Die Löschbarkeit von Dateien, sowie die maximale Uploadgröße sind Backend-unabhängig</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-ClientConfig.png"></div></div><p>Die einzelnen Backends sind einzeln einschaltbar. Spezifische Backend-Konfigurierungen sind hier
32
        noch ergänzbar.</p></div><div class="sect4" title="3.8.4.1.2. Reiter &#34;Allgemeine Dokumentenanhänge&#34;"><div class="titlepage"><div><div><h5 class="title"><a name="d0e6520"></a>3.8.4.1.2. Reiter "Allgemeine Dokumentenanhänge"</h5></div></div></div><p>Unter dem Reiter <span class="bold"><strong>Allgemeine Dokumentenanhänge</strong></span>
33
            kann für alle ERP-Dokumente ( Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und Einkauf )
34
            allgemeingültige Anhänge hochgeladen werden.</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Allgemeine-Dokumentenanhaenge.png"></div></div><p>Diese Anhänge werden beim Generieren von PDF-Dateien an die ERP-Dokumente angehängt,
35
        z.B. AGBs oder aktuelle Angebote. Es werden in dem Fall die Daten kopiert, sodass an den ERP-Dokumenten immer
36
        die Anhänge zum Generierungszeitpunkt eingebettet sind.
37
        </p></div></div><div class="sect3" title="3.8.4.2. Datenbank-Konfigurierung"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.dbconfig"></a>3.8.4.2. Datenbank-Konfigurierung</h4></div></div></div><p>Die zusätzlichen Quellen für "email" oder ein oder mehrere Scanner sind derzeit vom Administrator
38
          direkt in der Datenbanktabelle "user_preferences" einzurichten. Die "value" ist im JSON-Format
39
          mit den jeweiligen Werten des Verzeichnisses und der Beschreibung der Quelle.</p><pre class="programlisting">
3
   <title>3.8. Dateiverwaltung (Mini-DMS)</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s07.html" title="3.7. Artikelklassifizierung"><link rel="next" href="ch03s09.html" title="3.9. Webshop-Api"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.8. Dateiverwaltung (Mini-DMS)</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s07.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s09.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.8. Dateiverwaltung (Mini-DMS)"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.file_managment"></a>3.8. Dateiverwaltung (Mini-DMS)</h2></div></div></div><div class="sect2" title="3.8.1. Übersicht"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6381"></a>3.8.1. Übersicht</h3></div></div></div><p>Parallel zum alten WebDAV gibt es ein Datei-Management-System,
4
        das Dateien verschiedenen Typs verwaltet. Dies können</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>aus ERP-Daten per LaTeX Template erzeugte
5
            PDF-Dokumente,</p></li><li class="listitem"><p>zu bestimmten ERP-Daten gehörende Anhangdateien
6
            unterschiedlichen Formats,</p></li><li class="listitem"><p>per Scanner eingelesene PDF-Dateien,</p></li><li class="listitem"><p>per E-Mail empfangene Dateianhänge unterschiedlichen
7
            Formats,</p></li><li class="listitem"><p>sowie speziel für Artikel hochgeladene Bilder sein.</p></li></ol></div><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Overview.png"></div></div></div><div class="sect2" title="3.8.2. Struktur"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6408"></a>3.8.2. Struktur</h3></div></div></div><p>Über eine vom Speichermedium unabhängige Zwischenschicht werden
8
        die Dateien und ihre Versionen in der Datenbank verwaltet. Darunter
9
        können verschiedene Implementierungen (Backends) gleichzeitig
10
        existieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Dateisystem</p></li><li class="listitem"><p>WebDAV</p></li><li class="listitem"><p>Schnittstelle zu externen
11
            Dokumenten-Management-Systemen</p></li><li class="listitem"><p>andere Datenbank</p></li><li class="listitem"><p>etc ...</p></li></ul></div><p>Es gibt unterschiedliche Typen von Dateien. Jedem Typ läßt sich
12
        in der Mandantenkonfiguration ein bestimmtes Backend zuordnen.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>"document": Das sind entweder generierte, eingescannte oder
13
            hochgeladene PDF-Dateien, die zu bestimmten ERP-Daten
14
            (ERP-Objekte, wie z.B. Rechnung, Lieferschein) gehören.</p></li><li class="listitem"><p>"attachment": zusätzlich hochgeladene Dokumente, die an
15
            bestimmte ERP-Objekte angehängt werden, z.B. technische
16
            Zeichnungen, Aufmaße. Diese können auch für Artikel, Lieferanten
17
            und Kunden hinterlegt sein.</p></li><li class="listitem"><p>"image": Bilder für Artikel. Diese können auch verkleinert
18
            in einer Vorschau (Thumbnail) angezeigt werden.</p></li></ul></div><p>Zusätzlich werden in der Datenbank zu den Dateien neben der
19
        Zuordnung zu ERP-Objekten, Dateityp Dateinamen und Backend, in dem die
20
        Datei gespeichert ist, auch die Quelle der Datei notiert:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>"created": vom System erzeugte Dokumente"</p></li><li class="listitem"><p>"uploaded": hochgeladene Dokumente</p></li><li class="listitem"><p>"email": vom Mail-System empfangene Dateien</p></li><li class="listitem"><p>"scanner[1]": von einem oder mehreren Scannern erzeugte
21
            Dateien. Existieren mehrere Scanner, so sind diese durch
22
            unterschiedliche Quellennamen zu definieren.</p></li></ul></div><p>Je nach Dateityp sind nur bestimmte Quellen zulässig. So gibt es
23
        für "attachment" und "image" nur die Quelle "uploaded". Für "document"
24
        gibt es auf jeden Fall die Quelle "created". Die Quellen "scanner" und
25
        "email" müssen derzeit in der Datenbank konfiguriert werden (siehe
26
        <a class="xref" href="ch03s08.html#file_management.dbconfig" title="3.8.4.2. Datenbank-Konfigurierung">Datenbank-Konfigurierung</a>).</p></div><div class="sect2" title="3.8.3. Anwendung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6460"></a>3.8.3. Anwendung</h3></div></div></div><p>Die Daten werden bei den ERP-Objekten als extra Reiter
27
        dargestellt. Eine Verkaufsrechnung z.B. hat die Reiter "Dokumente" und
28
        "Dateianhänge".</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Anhaenge.png"></div></div><p>Bei den Dateianhängen wird immer nur die aktuelle Version einer
29
        Datei angezeigt. Wird eine Datei mit gleichem Namen hochgeladen, so
30
        wird eine neue Version der Datei erstellt. Vorher wird der Anwender
31
        durch einen Dialog gefragt, ob er eine neue Version anlegen will oder
32
        ob er die Datei umbenennen will, falls es eine neue Datei sein
33
        soll.</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Anhaenge-hochladen.png"></div></div><p>Es können mehrere Dateien gleichzeitig hochgeladen werden,
34
        solange in Summe die maximale Größe nicht überschritten wird (siehe
35
        <a class="xref" href="ch03s08.html#file_management.clientconfig" title="3.8.4.1. Mandantenkonfiguration">Mandantenkonfigurierung</a>).</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Dokumente.png"></div></div><p>Sind keine weiteren Quellen für Dokumente konfiguriert, so gibt
36
        es nur "erzeugte Dokumente". Es werden alle Versionen der generierten
37
        Datei angezeigt. Für Verkaufsrechnungen kommen keine anderen Quellen
38
        zur Geltung. Werden entsprechend der <a class="xref" href="ch03s08.html#file_management.dbconfig" title="3.8.4.2. Datenbank-Konfigurierung">Datenbank-Konfigurierung</a> zusätzliche Quellen konfiguriert,
39
        so sind diese z.B. bei Einkaufsrechnungen sichtbar:</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Dokumente-Scanner.png"></div></div><p>Statt des Löschens wird hier die Datei zurück zur Quelle
40
        verschoben. Somit kann die Datei anschließend an ein anderes
41
        ERP-Objekt angehängt werden.</p><p>Derzeit sind "Titel" und "Beschreibung" noch nicht genutzt. Sie
42
        sind bisher nur bei Bildern relevant.</p></div><div class="sect2" title="3.8.4. Konfigurierung"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6503"></a>3.8.4. Konfigurierung</h3></div></div></div><div class="sect3" title="3.8.4.1. Mandantenkonfiguration"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.clientconfig"></a>3.8.4.1. Mandantenkonfiguration</h4></div></div></div><div class="sect4" title="3.8.4.1.1. Reiter &#34;Features&#34;"><div class="titlepage"><div><div><h5 class="title"><a name="d0e6509"></a>3.8.4.1.1. Reiter "Features"</h5></div></div></div><p>Unter dem Reiter <span class="bold"><strong>Features</strong></span>
43
            im Abschnitt Dateimanagement ist neben dem "alten" WebDAV das
44
            Dateimangement generell zu- und abschaltbar, sowie die Zuordnung
45
            der Dateitypen zu Backends. Die Löschbarkeit von Dateien, sowie
46
            die maximale Uploadgröße sind Backend-unabhängig</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-ClientConfig.png"></div></div><p>Die einzelnen Backends sind einzeln einschaltbar.
47
            Spezifische Backend-Konfigurierungen sind hier noch
48
            ergänzbar.</p></div><div class="sect4" title="3.8.4.1.2. Reiter &#34;Allgemeine Dokumentenanhänge&#34;"><div class="titlepage"><div><div><h5 class="title"><a name="d0e6525"></a>3.8.4.1.2. Reiter "Allgemeine Dokumentenanhänge"</h5></div></div></div><p>Unter dem Reiter <span class="bold"><strong>Allgemeine
49
            Dokumentenanhänge</strong></span> kann für alle ERP-Dokumente (
50
            Angebote, Aufträge, Lieferscheine, Rechnungen im Verkauf und
51
            Einkauf ) allgemeingültige Anhänge hochgeladen werden.</p><div class="screenshot"><div class="mediaobject"><img src="images/DMS-Allgemeine-Dokumentenanhaenge.png"></div></div><p>Diese Anhänge werden beim Generieren von PDF-Dateien an die
52
            ERP-Dokumente angehängt, z.B. AGBs oder aktuelle Angebote. Es
53
            werden in dem Fall die Daten kopiert, sodass an den ERP-Dokumenten
54
            immer die Anhänge zum Generierungszeitpunkt eingebettet
55
            sind.</p></div></div><div class="sect3" title="3.8.4.2. Datenbank-Konfigurierung"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.dbconfig"></a>3.8.4.2. Datenbank-Konfigurierung</h4></div></div></div><p>Die zusätzlichen Quellen für "email" oder ein oder mehrere
56
          Scanner sind derzeit vom Administrator direkt in der
57
          Datenbanktabelle "user_preferences" einzurichten. Die "value" ist im
58
          JSON-Format mit den jeweiligen Werten des Verzeichnisses und der
59
          Beschreibung der Quelle.</p><pre class="programlisting">
40 60
 id |  login    |  namespace   | version |   key    |          value
41 61
----+-----------+--------------+---------+----------+---------------------------
42 62
  1 | #default# | file_sources | 0.00000 | scanner1 |
......
45 65
                             {"dir":"/var/tmp/scanner2","desc":"Scanner Verkauf"}
46 66
  3 | #default# | file_sources | 0.00000 | emails   |
47 67
                             {"dir":"/var/tmp/emails","desc":"Empfangene Mails" }
48
          </pre><p>Es ist daran gedacht, statt dem Default-Eintrag später für bestimmte Benutzer ('login') bestimmte Quellen zuzulassen.
49
          Dies wird nach Bedarf implementiert.</p></div><div class="sect3" title="3.8.4.3. kivitendo-Konfigurationsdatei"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.kiviconfig"></a>3.8.4.3. kivitendo-Konfigurationsdatei</h4></div></div></div><p>Dort ist im Abschnitt [paths] der relative oder absolute Pfad zum Dokumentenwurzelverzeichnis einzutragen.
50
          Dieser muss für den Webserver schreib- und lesbar sein, jedoch nicht ausführbar.</p><pre class="programlisting">
68
          </pre><p>Es ist daran gedacht, statt dem Default-Eintrag später für
69
          bestimmte Benutzer ('login') bestimmte Quellen zuzulassen. Dies wird
70
          nach Bedarf implementiert.</p></div><div class="sect3" title="3.8.4.3. kivitendo-Konfigurationsdatei"><div class="titlepage"><div><div><h4 class="title"><a name="file_management.kiviconfig"></a>3.8.4.3. kivitendo-Konfigurationsdatei</h4></div></div></div><p>Dort ist im Abschnitt [paths] der relative oder absolute Pfad
71
          zum Dokumentenwurzelverzeichnis einzutragen. Dieser muss für den
72
          Webserver schreib- und lesbar sein, jedoch nicht ausführbar.</p><pre class="programlisting">
51 73
[paths]
52 74
document_path = /var/local/kivi_documents
53
          </pre><p>Unter diesem Wurzelverzeichnis wird pro Mandant automatisch ein Unterverzeichnis mit der ID des Mandanten angelegt.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s07.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.7. Artikelklassifizierung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;Kapitel 4. Entwicklerdokumentation</td></tr></table></div></body></html>
75
          </pre><p>Unter diesem Wurzelverzeichnis wird pro Mandant automatisch
76
          ein Unterverzeichnis mit der ID des Mandanten angelegt.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s07.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s09.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.7. Artikelklassifizierung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;3.9. Webshop-Api</td></tr></table></div></body></html>
doc/html/ch03s09.html
1
<html><head>
2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>3.9. Webshop-Api</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.5.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s08.html" title="3.8. Dateiverwaltung (Mini-DMS)"><link rel="next" href="ch04.html" title="Kapitel 4. Entwicklerdokumentation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.9. Webshop-Api</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s08.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.9. Webshop-Api"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e6559"></a>3.9. Webshop-Api</h2></div></div></div><p>Das Shopmodul bietet die Möglichkeit Onlineshopartikel und
4
      Onlineshopbestellungen zu verwalten und zu bearbeiten.</p><p>Es ist Multishopfähig, d.h. Artikel können mehreren oder
5
      unterschiedlichen Shops zugeordnet werden. Bestellungen können aus
6
      mehreren Shops geholt werden.</p><p>Zur Zeit bietet das Modul nur einen Connector zur REST-Api von
7
      Shopware. Weitere Connectoren können dazu programmiert und eingerichtet
8
      werden.</p><div class="sect2" title="3.9.1. Installationvorraussetzungen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6568"></a>3.9.1. Installationvorraussetzungen</h3></div></div></div><p>In der Datenbank <code class="literal">template1</code> muss die
9
        Unterstützung für die trigram-Extension eingerichet werden. Melden Sie
10
        sich dafür als Benutzer “postgres” an der Datenbank an:
11
        </p><pre class="programlisting">su - postgres
12
psql template1</pre><p>
13
            </p><p>führen Sie die folgenden Kommandos aus:</p><pre class="programlisting">CREATE EXTENSION IF NOT EXISTS pg_trgm;
14
\q</pre></div><div class="sect2" title="3.9.2. Rechte für die Webshopapi"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6583"></a>3.9.2. Rechte für die Webshopapi</h3></div></div></div><p>In der Administration können folgende Rechte vergeben
15
        werden</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Webshopartikel anlegen und bearbeiten</p></li><li class="listitem"><p>Shopbestellungen holen und bearbeiten</p></li><li class="listitem"><p>Shopbestellungen holen und bearbeiten</p></li></ul></div></div><div class="sect2" title="3.9.3. Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6598"></a>3.9.3. Konfiguration</h3></div></div></div><p>Unter System-&gt;Webshops können Shops angelegt und konfiguriert
16
        werden</p><div class="mediaobject"><img src="images/Shop_Listing.png"></div></div><div class="sect2" title="3.9.4. Webshopartikel"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6606"></a>3.9.4. Webshopartikel</h3></div></div></div><div class="sect3" title="3.9.4.1. Shopvariablenreiter in Artikelstammdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6609"></a>3.9.4.1. Shopvariablenreiter in Artikelstammdaten</h4></div></div></div><p>Mit dem Recht "Shopartikel anlegen und bearbeiten" öffnet sich
17
          der Reiter "Shopvariablen" in den Artikelstammdaten. Hier können
18
          jetzt die Artikel mit unterschiedlichen Beschreibung und/oder
19
          Preisen für die konfigutierten Shops angelegt und bearbeitet werden.
20
          An dieser Stelle können auch beliebig viele Bilder dem Shopartikel
21
          zugeordnet werden. Artikelbilder gelten für alle Shops.</p><div class="mediaobject"><img src="images/Shop_Artikel.png"></div><p>Die Artikelgruppen werden direkt vom Shopsystem geholt somit
22
          ist es möglich einen Artikel auch mehreren Gruppen
23
          zuzuordenen</p></div><div class="sect3" title="3.9.4.2. Shopartikelliste"><div class="titlepage"><div><div><h4 class="title"><a name="d0e6619"></a>3.9.4.2. Shopartikelliste</h4></div></div></div><p>Unter dem Menu Webshop-&gt;Webshop Artikel hat man nochmal
24
          eine Gesamtübersicht. Von hier aus ist es möglich Artikel im Stapel
25
          unter verschiedenen Kriterien &lt;alles&gt;&lt;nur Preis&gt;&lt;nur
26
          Bestand&gt;&lt;Preis und Bestand&gt; an die jeweiligen Shops
27
          hochzuladen.</p><div class="mediaobject"><img src="images/Shop_Artikel_Listing.png"></div></div></div><div class="sect2" title="3.9.5. Bestellimport"><div class="titlepage"><div><div><h3 class="title"><a name="d0e6627"></a>3.9.5. Bestellimport</h3></div></div></div><p>Unter dem Menupunkt Webshop-&gt;Webshop Import öffnet sich die
28
        Bestellimportsliste. Hier ist sind Möglichkeiten gegeben Neue
29
        Bestellungen vom Shop abzuholen, geholte Bestellungen im Stapel oder
30
        einzeln als Auftrag zu transferieren. Die Liste kann nach
31
        verschiedenen Kriterien gefiltert werden.</p><div class="mediaobject"><img src="images/Shop_Bestell.png"></div><p>Bei Einträgen in der Liste.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>keine Kundennummer: Es gibt ähnliche Kundendatensätze und
32
            der Datensatz konnte nicht eindeutig zugewiesen werden.</p></li><li class="listitem"><p>Kundennummer und Rechnungen rot hinterlegt: Der Kunde hat
33
            offene Posten und kann deswegen nicht im Stapel übernommen
34
            werden.</p></li><li class="listitem"><p>Rechnungsadresse grün hinterlegt: Der Kunde konnte eindeutig
35
            einem Datensatz zugeordnet werden. Die Shopbestellung kann im
36
            Stapel mit dem Button "Anwenden" und wenn markiert als Auftrag
37
            übernommen werden.</p></li><li class="listitem"><p>Kundennummer vorhanden, aber die Checkbox "Auftrag
38
            erstellen" fehlt. Der Kunde hat vermutlich eine
39
            Shopauftragssperre.</p></li><li class="listitem"><p>Lieferadresse grau hinterlegt: Optische Anzeige, dass es
40
            sich um eine unterschiedliche Lieferadresse handelt.
41
            Lieferadressen werden aber grundsätzlich beim Transferieren zu
42
            Aufträgen mit übernommen.</p></li><li class="listitem"><p>In der Spalte Positionen/Betrag/Versandkosten zeigt sich ein
43
            tooltip zu den Positionen.</p></li></ul></div><p>Maske Auftrag erstellen</p><p>Viele Shopsysteme haben drei verschieden Adresstypen Kunden-,
44
        Rechnungs-, und Lieferadresse, die sich auch alle unterscheiden
45
        können. Diese werden im oberen Bereich angezeigt. Es ist möglich jede
46
        dieser Adresse einzeln in kivitendo als Kunde zu übernehmen. Es werden
47
        die Werte Formulareingabe übernommen. Es wird bei einer Änderung
... Dieser Diff wurde abgeschnitten, weil er die maximale Anzahl anzuzeigender Zeilen überschreitet.

Auch abrufbar als: Unified diff