eFaModul Schnittstelle (Versionsstand: 4.00 ab 2008)

Die eFaModul-Schnittstelle besteht ausschließlich aus ASCII Zeichen und kann daher mit jedem handelsüblichen Texteditor erstellt, betrachtet oder geändert werden. Grundlage bildet die ELSTER ®-Schnittstelle der Finanzbehörden. Für weitergehende Informationen steht Ihnen natürlich auch unsere Hotline zur Verfügung. Wie einfach die Datenübergabe im Normalfall sein kann, lesen Sie bitte weiter unten.

Die Schnittstellendatei (Endungsvorgabe csv) besteht immer aus lediglich zwei Zeilen, die mit einem Wagenrücklauf (CR) abgeschlossen werden müssen. Die erste Zeile beinhaltet die Feldnamen, die zweite Zeile die Feldinhalte - also die eigentlichen Buchhaltungsdaten. Jeder Feldname und -inhalt wird von dem darauf folgenden durch ein ";" (Semikolon) getrennt.

• Die jeweils untereinander stehenden Paare aus Feldname und Feldinhalt gehören zusammen. "untereinander stehend" bedeutet, das an der jeweils gleichen Zählposition oben die Feldbezeichnung für den "darunter liegenden" Feldinhalt aufgeführt sind.
• Feldname und -inhalte dürfen kein ";" (Semikolon) enthalten.
• Gibt es für ein Feld keinen Inhalt, wird es entweder ausgelassen, oder es folgen zwei ";" (Semikolon) aufeinander.
• Die Reihenfolge der zusammengehörigen Paare aus Feldbezeichnung und Feldinhalt ist beliebig.
• Variablentypen werden automatisch erkannt, es sind keine "" (Anführungsstriche) z.B. für Zeichenketten erforderlich.
• Logische Felder erhalten ein T für wahr und ein F für falsch
• Es ist unerheblich, ob Sie ein einziges oder alle möglichen Felder übergeben. Wenn die Übergabedatei nicht vollständig ist, müssen die fehlenden Eingaben manuell in den dazugehörigen Masken erfolgen.
• Achtung! Beim Importvorgang werden zu Ihrer Sicherheit alle früheren Eingaben überschrieben, auch wenn die Importdatei entsprechende Angaben nicht enthält.

Folgende Felder - deren Namen exakt wie unten beschrieben zu verwenden sind - stehen zur Bestückung zur Verfügung:
 

ABSNAME ABSSTR ABSPLZ ABSORT	Alle Angaben zum Steuerpflichtigen einfach als Klartext übergeben
EMPFNAME EMPFSTR EMPFPLZ EMPFORT EMPFTEL EMPFEMAIL	Alle Angaben zum Finanzamt einfach als Klartext übergeben
FINANZAMT	Achtung! Hiermit ist die offizielle Finanzamtsnummer gemeint, die in der Regel dem Nutzer der Schnittstelle nicht bekannt ist. Sie wird bei gültigem EMPFNAME automatisch vom eFaModul eingesetzt
BERATER BERATERBER BERATERTEL BERATERVOR	Alle Angaben zum Steuerberater einfach als Klartext übergeben. Die Gesamtlänge aller Angabe zum Steuerberater ist beschränkt auf 80 Zeichen.
DSART LAUFNUMMER FALLART UNTERFALL JAHRSTEUER  LSACHBER	Wird in der Regel vom eFaModul bestückt.
SONDERVOR	Bitte ein "T" (wahr), wenn eine Sondervorauszahlung beantragt wird
ERSTELLDAT	Datum der Erstellung des Formulars - Format: YYYYMMTT ohne Zwischenzeichen
ZEITRAUMST	Die UVA Periode, entweder für die Monate von 1 bis 12 jeweils 2 Stellen, bei den einstelligen Monaten bitte ein führendes Leerzeichen oder 41-44 für quartalsweise Abgabe
STEUERNR	Die Steuernummer incl. der "/"-Zeichen
EINZUGSER	Bitte ein "T" (wahr), wenn eine Einzugsermächtigung vorliegt
VERRECHN	Bitte ein "T" (wahr), wenn Verrechnung erwünscht
BERICHTGTA	Bitte ein "T" (wahr), wenn eine berichtigte Anmeldung erfolgt
KZ41; KZ44; KZ49; KZ43; KZ48; KZ81; KZ86; KZ35; KZ36; KZ77; KZ76; KZ80; KZ91; KZ89; KZ93; KZ95; KZ98; KZ94; KZ96; KZ42; KZ60; KZ45; KZ52; KZ53; KZ73; KZ74; KZ84; KZ85; KZ65; KZ66; KZ61; KZ62; KZ67; KZ63; KZ64; KZ59; KZ69; KZ39; KZ83; KZ38	...und die Kennziffern laut Formular. Sie sind ohne Tausendertrennzeichen, aber mit Dezimal "," anzugeben, sofern das Formular Dezimalstellen zulässt. Negative Beträge bitte mit einem führenden Minuszeichen versehen

Für wen dies alles etwas kompliziert erscheint hier das Beispiel für eine vollständig bestückte Importdatei: Achtung: Da wir hier keine "echte" Steuernummer verwenden können, wird zwangsläufig bei dem Versuch, die Beispieldatei innerhalb des eFaModuls zu ändern, oder eine Vorschau zu erzeugen, eine Fehlermeldung kommen, die besagt, dass die Steuernummer und das Finanzamt nicht zusammenpassen. Ersetzen Sie also zum tiefergehenden Testen die Steuernummer und das Finanzamt durch real existierende Werte.

Eine rechnerische Validierung erfolgt ausdrücklich nicht. Sie sind also selbst dafür verantwortlich, dass die übergebenen Zahlen korrekt sind. Dies ist zumindest dann sichergestellt, wenn Sie die Daten über unsere Buchhaltung fibuman übergeben.
 

ABSNAME;ABSSTR;ABSPLZ;ABSORT;EMPFNAME;EMPFSTR;EMPFPLZ;EMPFORT;EMPFTEL;EMPFEMAIL;DSART;ERSTELLDAT;LAUFNUMMER;FINANZAMT;FALLART;UNTERFALL;JAHRSTEUER;ZEITRAUMST;LSACHBER;STEUERNR;BERATER;BERATERBER;BERATERTEL;BERATERVOR;SONDERVOR;EINZUGSER;VERRECHN;BELEGE;BERICHTGTA;KZ41;KZ44;KZ49;KZ43;KZ48;KZ81;KZ86;KZ35;KZ36;KZ77;KZ76;KZ80;KZ91;KZ89;KZ93;KZ95;KZ98;KZ94;KZ96;KZ42;KZ60;KZ45;KZ52;KZ53;KZ73;KZ74;KZ84;KZ85;KZ65;KZ66;KZ61;KZ62;KZ67;KZ63;KZ64;KZ59;KZ69;KZ39;KZ83;KZ38;BERATER;BERATERBER;BERATERVOR;BERATERTEL Mustermann-Sanitäreinrichtungen;Musterstr. 1a;80686;München;München I;Feldweg 33;88888;München 77;089/123456789;Maier@MustermannSani.de;;20081104;;9198;;;;2;;198/100/10256;;;;;T;T;T;T;T;209629;224968;250533;219855;245420;560758;439711;178952;8947,61;393694;388581;27200,73;465275;595953;475501;500660;75099,00;480614;33643,01;214742;453;112330;52123;53456,78;731;74,98;842;85,64;128200,45;337452,64;311888,05;317000,97;118450,22;301622,21;322113,89;301662,21;69,42;39,51;-1428696,47;99;Fritz Müller, Feldweg 0, 1234 Müllheim, fm@fmSTB.de;Steuerberater;02952;8080

Probieren Sie's einfach aus: Kopieren Sie die beiden Zeilen aus den obigen Beispielen in einen Texteditor, speichern Sie sie ab als *.CSV Datei (ohne Umbruch und als reine Textdatei!) und importieren Sie sie.

Diese Datei ergibt folgende Druckvorschau. In der Eingabemaske Seite 1 erhalten Sie folgendes Bild:
 

Wenn Sie die obige Textdatei und die daraus resultierende Vorschau sorgfältig vergleichen, werden Sie schnell erkennen, welche Inhalte wie abgelegt werden müssen. Im obigen Beispiel ist das erste Wort ABSNAME. Dies ist der erste Feldname. Darunter sehen Sie vor dem ersten Semikolon Mustermann-Sanitäreinrichtungen. Dies stellt den ersten Feldinhalt dar. Sie finden diesen Feldinhalt unter der Firmenbezeichnung in der Eingabemaske wieder. Der Feldinhalt wird nun in Ihrem Fall sicher anders lauten, der Feldname für die Firmenbezeichnung hingegen muss genau ABSNAME bleiben, damit das eFaModul weiß, was es mit Mustermann-Sanitäreinrichtungen anfangen soll. Um etwa das Finanzamt zu übergeben suchen wir im Beispieltext nach München I. Wir finden es vor dem fünften Semikolon. In der darüber liegenden Zeile steht vor dem fünften Semikolon EMPFNAME. Dies ist also der zugehörige Feldname für das Finanzamt. Achtung! Ist das Finanzamt nicht in der eingebauten offiziellen Finanzamtsliste für Deutschland enthalten oder unterscheidet sich die Schreibweise wird es als nicht übergeben behandelt.  TIP: Das betreffende Finanzamt einmal aus der Liste heraussuchen und dann genau diese Bezeichnung verwenden. Ein anderes Beispiel: Sie möchten 82489 € steuerpflichtiger Umsatz 7% (KZ 86) übergeben: Fügen Sie in Ihre CSV-Datei in der ersten Zeile einfach KZ86 und in der zweiten Zeile die 82489 nach der gleichen Anzahl von ";" ein.

So sieht eine Minimaldatei aus für obigen Fall:
 

ABSNAME;ABSSTR;ABSORT;EMPFNAME;ERSTELLDAT;ZEITRAUMST;STEUERNR;KZ81;KZ83 Meier GmbH;Feldweg 3;Soest;München I;20081104;10;198/100/10256;1000;190,00