Zum Hauptinhalt springen

FNDatevXML – DATEV-XML-Schnittstelle

Dateien im Format DATEV XML-Schnittstelle online V5.0/6.0 in FibuNet-Übernahmedateien konvertieren und Belegbilder in die interne Belegablage übernehmen.

Gestern aktualisiert

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:

  1. Kommandozeilenschalter (/Datenverzeichnis=D:\FibuNet\Daten)

  2. Registryzweig der Komponente: HKLM\SOFTWARE\FibuNet GmbH\FibuNet\v5\FNDatevXML

  3. Registryzweig des Client: HKLM\SOFTWARE\FibuNet GmbH\FibuNet\v5\Client

  4. Aktuelles Verzeichnis in dem das Programm steht (= Arbeitsverzeichnis), wenn man dort Schreibrechte (Anlegen, Ändern, Lesen, Löschen) hat, ansonsten

  5. 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:

  1. Protokoll (http:// oder https://)

  2. Servername

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

Hat dies deine Frage beantwortet?