forked from stesie/geierlein
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
143 lines (92 loc) · 5.14 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
Geierlein is a free (AGPL'ed) Elster client, i.e. an application that
allows to send VAT declaration to Germany's fiscal authorities.
Since this application is to be considered useful only for people living
in Germany, the rest of this README file is written in German language.
=============================================================================
Geierlein ist ein freier Elster-Client und letztlich eine vollständige
Neuentwicklung der beiden Vorgängerkomponenten libgeier & Taxbird. Im
Gegensatz zu ebendiesen ist Geierlein vollständig in JavaScript und HTML5
entwickelt, sodass es weitestgehend plattformunabhängig sein sollte.
Hieraus resultiert ebenfalls, dass kein Kompilieren erforderlich ist.
Geierlein kann direkt ausgeführt werden.
Geierlein ist Teil des Taxbird Projekts.
Die Übermittlung der Jahreserklärungen (hauptsächlich Einkommen-
steuererklärungen) ist gegenwärtig noch nicht möglich, da die
Möglichkeit seitens der Finanzverwaltung bisher nicht eingeräumt
wurde. Wann und ob dies irgendwann mit freier Software zulässig sein
wird, ist momentan leider nicht abschätzbar.
=============================================================================
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
=============================================================================
Geierlein kann momentan in Form zweier verschiedener Oberflächen verwendet
werden
a) Mozilla XUL-basierte grafische Desktop-Anwendung
b) Kommandozeilenanwendung auf Basis von Node.js
Geierlein ist momentan noch in der Beta-Phase. Die Übermittlung von
signierten bzw. authentifizierten Umsatzsteuervoranmeldungen ist momentan
noch NICHT möglich.
Mozilla XUL-Anwendung
------------------------
Um Geierlein als XUL-Anwendung starten zu können, ist der XUL-Runner von
Mozilla erforderlich. XUL-Runner kann direkt bei Mozilla unter
https://developer.mozilla.org/de/xulrunner heruntergeladen werden und
ist auch Teil der meisten GNU/Linux Distributionen.
Neuere Firefox-Versionen (alle ab Version 3) sind mit einem XUL-Runner
Paket ausgestattet, soll heißen, wer Firefox installiert hat kann
Geierlein direkt ausführen:
$ firefox -app application.ini
Wer XUL-Runner installiert hat, kann beim Aufruf das Argument "-app" weg
lassen.
Mit Geierlein abgespeicherte Dateien können auch direkt von der
Kommandozeile aus aufgerufen werden:
$ firefox -app application.ini -load pfad/zur/datei
Kommandozeilenanwendung
--------------------------
Mit Node.js kann Geierlein auch direkt von der Kommandozeile genutzt
werden. Erforderlich ist eine Node.js Installation mit den Zusatzpaketen
"iconv" und "optimist". Diese sind nicht Teil der Geierlein Distribution,
können jedoch mit folgendem Aufruf installiert werden:
$ npm install .
Sobald die Node.js Umgebung installiert ist, kann Geierlein wie folgt
verwendet werden:
Um eine Testübertragung einer Umsatzsteuervoranmeldung durchzuführen:
$ bin/geierlein -t -f doc/examples/ustva
Um einen Echtfall zu übertragen (Achtung, ohne weitere Rückfrage!):
$ bin/geierlein -f doc/examples/ustva
Das Übertragungsprotokoll wird direkt auf die Standardausgabe geschrieben.
Wenn das Protokoll gespeichert werden soll (also eigentlich immer), sollte
die Ausgabe umgeleitet werden:
$ bin/geierlein -f doc/examples/ustva > protokoll/2012-04.xml
Das XML-Dokument referenziert ein Stylesheet, das Teil von Geierlein ist,
sodass moderne Browser dieses in einer druckbaren Form darstellen.
Google Chrome bzw. Chromium hat standardmäßig ein sehr, sehr, sehr
restriktives Sicherheitsmodell, das untersagt, dass eine Datei sich auf
eine Datei in einem Ordner (auf dem gleichen System) beziehen darf.
Heißt, dass Chrome in Standardeinstellung das Laden des Stylesheets
verhindert. Dies kann mit der Option --allow-file-access-from-files
beim Start umgangen werden.
Die Kommandozeilenanwendung kann die von der GUI-Anwendung gespeicherten
Dateien öffnen. Im Übrigen findet sich unter doc/examples/ustva eine
Beispiel-Datei.
Installation der Git-Version
-------------------------------
Der Quellcode von Geierlein ist unter https://github.com/stesie/geierlein
verfügbar. Wenn du Verbesserungen am Programm vornehmen möchtest, kannst
du dort auch einen eigenen Fork anlegen und anschließend über einen Pull
Request zur Verfügung stellen.
Geierlein verwendet momentan zwei Module, die zusätzlich zu installieren
sind:
$ git clone git://github.com/stesie/geierlein.git
$ git submodule init
$ git submodule update
=============================================================================
Vielen Dank, dass Du Geierlein verwendest!