From 853991311bc6804da985219eb28d86114e359cc6 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Jan=20B=C3=BCren?=
Date: Wed, 8 Jul 2020 10:54:19 +0200
Subject: [PATCH] =?utf8?q?Doku:=20ZUGFeRD=20Feature=20Vorbedingung=20und?=
=?utf8?q?=20Erl=C3=A4uterung?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit
---
doc/dokumentation.xml | 142 ++++++++++++++++++++++++++++++++
doc/html/ch03s09.html | 4 +-
doc/html/ch03s10.html | 54 ++++++++++++
doc/html/ch04.html | 34 ++++----
doc/html/index.html | 2 +-
doc/kivitendo-Dokumentation.pdf | Bin 1369779 -> 1379916 bytes
6 files changed, 216 insertions(+), 20 deletions(-)
create mode 100644 doc/html/ch03s10.html
diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml
index cbe01b9ea..1a22f0c54 100644
--- a/doc/dokumentation.xml
+++ b/doc/dokumentation.xml
@@ -7328,6 +7328,148 @@ document_path = /var/local/kivi_documents
url="https://developers.shopware.com/developers-guide/rest-api/">https://developers.shopware.com/developers-guide/rest-api/
+
+ ZUGFeRD Rechnungen
+
+ Vorbedingung
+
+ Für die Erstellung von ZUGFeRD PDFs wird TexLive2018 oder höher benötigt.
+
+
+
+ Wer kein TexLive2018 oder höher installieren kann, kann eine lokale Umgebung nur für kivitendo wie folgt erzeugen:
+
+
+ 1. Download des offiziellen Installers von https://www.tug.org/texlive/quickinstall.html
+
+ 2. Installer ausführen, Standard-Ort für Installation belassen, evtl. ein paar Pakete abwählen, installieren lassen
+
+ 3. Ein kleine Script »run_pdflatex.sh« anlegen, das den PATH auf das Installationsverezichnis setzt und pdflatex ausführt:
+
+ ------------------------------------------------------------
+ #!/bin/bash
+
+ export PATH=/usr/local/texlive/2020/bin/x86_64-linux:$PATH
+ hash -r
+
+ exec pdflatex $@
+ ------------------------------------------------------------
+
+ 4. In config/kivitendo.conf den Parameter »latex« auf den Pfad zu »run_pdflatex.sh« setzen
+
+ 5. Webserver neu starten
+
+
+
+
+ Ãbersicht
+
+ Mit der Version 3.5.6 bietet kivitendo die Möglichkeit ZUGFeRD
+ Rechnungen zu erstellen, sowie auch ZUGFeRD Rechnungen direkt in
+ kivitendo einzulesen.
+
+ Bei ZUGFeRD Rechnungen handelt es sich um eine PDF Datei in
+ der eine XML-Datei eingebettet ist. Der Aufbau der XML-Datei ist
+ standardisiert und ermöglicht so den Austausch zwischen
+ den verschiedenen Softwareprodukten. Kivitendo setzt mit der
+ Version 3.5.6 den ZUGFeRD 2.1 Standard um.
+
+ Weiter Details zu ZUGFeRD sind unter diesem Link zu finden:
+ https://www.ferd-net.de/standards/was-ist-zugferd/index.html
+
+
+
+
+
+ Erstellen von ZUGFeRD Rechnungen in Kivitendo
+ Für die Erstellung von ZUGFeRD Rechnungen bedarf es in
+ kivitendo zwei Dinge:
+
+
+
+
+ Die Erstellung muss in der Mandantenkonfiguration
+ aktiviert sein
+
+
+
+ Beim mindestens einem Bankkonto muss die Option
+ âNutzung von ZUGFeRDâ aktiviert sein
+
+
+
+
+ Mandantenkonfiguration
+
+ Die Einstellung für die Erstellung von ZUGFeRD Rechnungen
+ erfolgt unter âSystemâ â âMandatenkonfigurationâ â âFeaturesâ.
+ Im Abschnitt âEinkauf und Verkaufâ finden Sie die Einstellung
+ âVerkaufsrechnungen mit ZUGFeRD-Daten erzeugenâ.
+ Hier besteht die Auswahl zwischen:
+
+
+
+ ZUGFeRD-Rechnungen erzeugen
+
+
+
+ ZUGFeRD-Rechnungen im Testmodus erzeugen
+
+
+
+ Keine ZUGFeRD Rechnungen erzeugen
+
+
+
+
+ Rechnungen die als PDF erzeugt werden, werden je nach
+ Einstellung nun im ZUGFeRD Format ausgegeben.
+
+
+
+
+ Konfiguration der Bankkonten
+
+ Unter âSystem â Bankontenâ muss bei mindestens einem
+ Bankkonto die Option âNutzung mit ZUGFeRDâ auf âJaâ gestellt
+ werden.
+
+
+
+
+
+
+ Einlesen von ZUGFeRD Rechnungen in Kivitendo
+
+ Es lassen sich auch Rechnungen von Kreditoren, die im
+ ZUGFeRD Format erstellt wurden im Kivitendo importieren.
+ Hierfür müssen auch zwei Voraussetzungen erfüllt werden:
+
+
+
+
+
+ Beim Lieferanten muss die Umsatzsteuer-ID und das
+ Bankkonto hinterlegt sein
+
+
+
+ Für den Kreditoren muss eine Buchungsvorlage existieren.
+
+
+
+
+ Wenn diese Voraussetzungen erfüllt sind, kann die Rechnung
+ über âFinanzbuchhaltungâ â âZUGFeRD Importâ über die âDurchsuchenâ
+ Schaltfläche ausgewählt werden und über die Schaltfläche âImportâ
+ eingeladen werden. Es öffnet sich daraufhin die Kreditorenbuchung.
+ Die auslesbaren Daten aus dem eingebetteten XML der PDF Datei
+ werden in der Kreditorenbuchung ergänzt.
+
+
+
+
+
diff --git a/doc/html/ch03s09.html b/doc/html/ch03s09.html
index e2541d3ff..97aab4212 100644
--- a/doc/html/ch03s09.html
+++ b/doc/html/ch03s09.html
@@ -1,6 +1,6 @@
- 3.9. Webshop-Api
Das Shopmodul bietet die Möglichkeit Onlineshopartikel und
Onlineshopbestellungen zu verwalten und zu bearbeiten.
Es ist Multishopfähig, d.h. Artikel können mehreren oder
unterschiedlichen Shops zugeordnet werden. Bestellungen können aus
mehreren Shops geholt werden.
Zur Zeit bietet das Modul nur einen Connector zur REST-Api von
@@ -58,4 +58,4 @@
die Bestellkopfdaten und die Artikeldaten gemapt werden. In dieser
Datei kann ein individelles Mapping dann gemacht werden. Zu Shopware
gibt es hier eine sehr gute Dokumentation: https://developers.shopware.com/developers-guide/rest-api/
-