Allgemeines
Aufgabe
Mit der Schnittstelle FNDatevXML können Dateien im Format Datev XML-Schnittstelle online Version 5.0/6.0 in FibuNet-Übernahmedateien konvertiert und die Belegbilder in die interne Belegablage übernommen werden.
Von den Anwendungsfällen für die DATEV XML-Schnittstelle online wird nur die Übertragung von Rechnungsdaten („accountsReceivableLedger“ und „accountsPayableLedger“) mit und ohne Belegbilder unterstützt. Hierfür muss das empfohlene Format der Belegsatzdatei (ledger, XML-Datei) verwendet werden.
Datev-Dokumentation
Die Beschreibung des Formates Datev XML Schnittstelle online finden Sie direkt im Developer-Bereich der Datev:
https://developer.datev.de/datev/platform/de/dxso
Das für den Zugriff auf die Beschreibung erforderliche Benutzerkonto können Sie kostenfrei anlegen.
Neben der Dokumentation kann man dort auch ein Prüfprogramm für die Schnittstellendateien erhalten.
Installation des Programmes
Das Programm FNDatevXML.exe wird als gepacktes ZIP-Archiv geliefert.
Entpacken Sie die ZIP-Datei und kopieren das Programm auf den FibuNet-Server in das FibuNet-Verzeichnis.
Legen Sie dann eine Verknüpfung auf dem Desktop an. Durch Doppelklick auf diese Verknüpfung wird das Programm FNDatevXML.EXE gestartet.
Beim Start überprüft das Programm, ob eine Datei „FNDatevXML.INI“ im Datenverzeichnis existiert und legt diese ggfs. an. Dazu sind Schreibrechte in dem aktuellen Datenverzeichnis notwendig.
Hinweis: Das Programm nutzt die FibuNet-REST-API, um mit dem FibuNet-Server zu kommunizieren. Der Zugriff auf die REST-API muss bei der Installation von FibuNet oder später durch Eintragungen in der Datei FibuNet.ini auf dem FibuNet-Server freigeben werden.
Kommandozeilenparameter
FNDatevXML kann mit folgenden Kommandozeilenparametern gestartet werden:
/S= Rest-URL inkl. Servername und Portnummer/B= Benutzername/P= Passwort/M= Mandantennummer/J= Wirtschaftsjahr/W= Mandantenpasswort/N= Dateiname Datev-Datei (+ autom. Start des Imports)/Datenverzeichnis= Laufwerk und Pfad
Beispiel:
FNDatevXML /S=https://localhost:9443 /B=fibunet /P=fibunet /N=D:\Test.zip
Datenverzeichnis
Durch das Setzen des Datenverzeichnisses kann der Ort bestimmt werden, an dem das Programm seine Dateien ablegt.
Das Datenverzeichnis wird wie folgt ermittelt:
Kommandozeilenschalter (
/Datenverzeichnis=D:\FibuNet\Daten)Registryzweig der Komponente:
HKLM\SOFTWARE\FibuNet GmbH\FibuNet\v5\FNDatevXMLRegistryzweig des Client:
HKLM\SOFTWARE\FibuNet GmbH\FibuNet\v5\ClientAktuelles Verzeichnis in dem das Programm steht (= Arbeitsverzeichnis), wenn man dort Schreibrechte (Anlegen, Ändern, Lesen, Löschen) hat, ansonsten
Verzeichnis in der die .EXE-Datei liegt
Start des Programmes
Starten Sie das Programm per Doppelklick auf das Desktop-Symbol. Sie sehen folgende Eingabemaske:
FibuNet-Anmeldung
Benutzer
Benutzername für die Anmeldung an FibuNet.
Passwort
Passwort für die Anmeldung an FibuNet.
REST-Url
Die Adresse (URL) des FibuNet-REST-Servers setzt sich aus 3 Komponenten zusammen:
Protokoll (
http://oderhttps://)Servername
Port
Der Port kann bei der Installation von FibuNet oder in der Datei FibuNet.ini auf dem FibuNet-Server eingestellt werden. Beim HTTP-Protokoll ist es meist 8181, bei HTTPS meist 9443.
Beispiel: https://Servername:9443
Bitte erfragen Sie die aktuellen Verbindungsparameter bei Ihrer IT-Abteilung.
Anmelden
Durch einen Klick auf den Button „Anmelden“ wird die Verbindung zum FibuNet-REST-Server hergestellt. Erst nach der Anmeldung sind die anderen Bedienungselemente freigeschaltet.
Hinweis: Jede Anmeldung über die REST-API verwendet eine FibuNet Benutzerlizenz.
Mandantenauswahl
Mandant
Wählen Sie hier den gewünschten FibuNet-Mandanten aus.
Wirtschaftsjahr
Das Wirtschaftsjahr für den Inkassoexport und die Verarbeitung der Inkasso-Abrechnungen.
Nach dem Jahreswechsel muss dieser Wert manuell angepasst werden.
Mand.-Passwort
Der Zugriff auf einen Mandanten kann in FibuNet mit einem Passwort geschützt werden. Wenn dies der Fall ist, müssen Sie hier das entsprechende Mandanten-Passwort eingeben.
Ändern
Stellen Sie dann den gewünschten Mandanten und das gewünschte Wirtschaftsjahr ein und bestätigen Sie die Einstellung durch einen Klick auf den „Ändern“-Knopf.
Einstellungen
Vor der ersten Konvertierung müssen die grundlegenden Einstellungen auf dem gleichnamigen Reiter durchgeführt werden.
Belegbilder in Belegablage importieren
Wenn diese Option aktiviert ist, werden die im Datev-Paket enthaltenen Belegbilder in die interne Belegablage von FibuNet importiert.
Andernfalls werden die Belegbilder ignoriert.
Im Standard ist die Option aktiviert.
Bei negativem Betrag die Konten drehen
Wenn diese Option aktiviert ist, werden bei einem negativen Gesamtbetrag für eine Rechnung die Konten gedreht und der Betrag positiv gebucht.
Im Standard ist die Option aktiviert.
Kontoumsetzung
Im Normalfall sollte das abgebende System so eingerichtet werden, dass direkt die benötigten FibuNet-Kontonummern übergeben werden.
Für Ausnahmefälle können Sie auf dem Reiter „Kontoumsetzung“ eine 1:1 Umsetzung der Kontonummern aus den Datev-Dateien in FibuNet Kontonummern eintragen.
Zahlungsbedingungen
Hier können die Datev-Zahlungsbedingungen in FibuNet-Zahlungskonditionen inklusive Zahlart umgesetzt werden.
Datev-Zahlbed.
Nummer der Datev-Zahlungsbedingung aus dem Feld „paymentConditionsId“ im Bereich von 9-999. Die Schnittstelle prüft diesen Bereich nicht, sondern sucht jeden Eintrag im Feld „paymentConditionsId“ in dieser Umsetzungstabelle.
Skontokondition 1
SkoTage 1 – Tage für Skonto 1
SkoProz 1 – Skontoprozentsatz
Skontokondition 2
SkoTage 2 – Tage für Skonto 2
SkoProz 2 – Skontoprozentsatz
Nettokondition
Nettotage – Tage bis zur Nettofälligkeit
Zahlart
Wenn mit einer Zahlungskondition eine FibuNet-Zahlart fest verknüpft ist, kann diese hier vorgegeben werden.
Bemerkung
Optionaler Informationstext zur Erläuterung der Zahlungsbedingung.
Datev-Dokumentenpaket konvertieren
Aufbau des Dokumentenpaketes
Das Datev-Dokumenten-Paket klammert eine Sammlung von mehreren Rechnungen in einem ZIP-Archiv.
In dem ZIP-Archiv sind folgende Dateien enthalten:
Verwaltungsdatendatei „document.xml“: Enthält die übergreifenden Informationen zu den Dokumenten innerhalb eines Dokumenten-Paketes.
Belegsatzdatendateien: In diesen XML-Dateien sind die Buchungs-Informationen zu einer Rechnung enthalten. Die Namen der Dateien werden in der Verwaltungsdatendatei „document.xml“ festgelegt.
Belegbilder: Die zur Rechnung gehörenden Dokumente. Die Zugehörigkeit zu einer Rechnung wird in der Verwaltungsdatendatei „document.xml“ festgelegt.
Dokumentenpaket auswählen
Wählen Sie im Feld „Dokumenten-Paket (zip)“ das ZIP-Archiv mit dem Datev-Dokumentenpaket aus.
Schaltfläche „Paket konvertieren“
Über diese Schaltfläche werden die Rechnungsdaten aus dem Dokumentenpaket in eine FibuNet-Übernahmedatei konvertiert und die Belegbilder optional in die interne Belegablage übernommen.
Nach Abschluss der Konvertierung wird Ihnen ein Protokoll angezeigt.
Die erzeugte Übernahmedatei kann jetzt in FibuNet im Menüpunkt 3.4. verarbeitet werden.
Die Datev-Datei, die Übernahmedateien und das Protokoll werden zusätzlich in einem Archivverzeichnis gespeichert. Dieses Archivverzeichnis liegt im Datenverzeichnis und hat die Struktur FNDatevXML\Archiv\Md#####\JJJJ\JJJJ-MM-TT\.
Das Archivverzeichnis können Sie über das Datei-Menü der Schnittstelle im Windows-Explorer öffnen.
Wichtiger Hinweis: Die Original-Datev-Datei wird nach der Konvertierung gelöscht, um doppelte Übernahmen zu vermeiden.
Feldzuordnungen
Feldzuordnung Rechnungen
Datev-Feld | Inhalt | Verwendung in FibuNet |
Rechnungsmonat | Aus Verwaltungsdatei | Buchungsdatum |
Rechnungstyp (xsi:type) | Aus Verwaltungsdatei „accountsReceivableLedger“ oder „accountsPayableLedger“ | Kontierung als Ausgangsrechnung oder als Eingangsrechnung |
consolidatedAmount | Summe über alle Positionen | Rechnungssumme in der aufteilenden Buchung |
consolidatedDate | Rechnungsdatum in der aufteilenden Buchung | |
consolidatedInvoiceId | Rechnungsnummer in der aufteilenden Buchung | |
consolidatedCurrencyCode | ISO-Währungscode | Währung |
date | Datum der Position | Belegdatum |
amount | Positionsbetrag (brutto) | Buchungsbetrag |
accountNo | Sachkonto | Sachkonto |
buCode | Datev-Steuerschlüssel | Steuerschlüssel (nur bei Vorsteuer) |
costCategoryId | Kost1 | Kostenstelle |
costCategoryId2 | Kost2 | Kostenträger |
information | weitere Informationen zum Sachverhalt | Memotext zur Buchung |
tax | Steuersatz | Steuerschlüssel (nur bei Vorsteuer, wenn „buCode“ nicht angegeben ist) |
exchangeRate | Kurs | Kurs bei Währungsrechnungen. Nur der erste Eintrag zählt. |
invoiceId | Rechnungsnummer | Belegnummer 1 |
internalInvoiceId | Interne Rechn.Nr. | Belegnummer 3 |
vatId | UStIdNr | |
bookingText | Buchungstext. Texte, die länger als 40 Zeichen sind, werden auch in den Memotext zur Buchung übernommen. | |
paymentConditionsId | Zahlungsbedingung 9-999 | Zahlungskondition und Zahlart |
discountPercentage | Skonto-Prozent | Skonto-Prozent 1 |
discountPaymentDate | Skonto-Datum | Skonto-Tage 1 |
discountPercentage2 | Skonto-Prozent 2 | Skonto-Prozent 2 |
discountPaymentDate2 | Skonto-Datum 2 | Skonto-Tage 2 |
dueDate | Fälligkeitsdatum | Nettotage |
bpAccountNo | Personenkonto | |
deliveryDate | Lieferdatum | |
orderId | Bestellnummer | Belegnummer 2 |
Feldzuordnung Belegablage
Alle Belege einer Rechnung werden in der internen Belegablage unterhalb eines Ablageknotens abgelegt. Für die Zuordnung des Ablageknotens zu einer Rechnung wird aus den Rechnungsdaten eine eindeutige Ablageknoten-Id gebildet.
Datev-Feld | Inhalt | Verwendung in FibuNet |
generator_info | Aus Belegsatzdatendatei | Ablageknoten-Id |
bpAccountNo | Personenkonto | Ablageknoten-Id |
consolidatedDate | Rechnungsdatum | Ablageknoten-Id |
consolidatedAmount | Summe über alle Positionen | Ablageknoten-Id |
consolidatedInvoiceId | Rechnungsnummer | Ablageknoten-Id |
