Wiki-Quellcode von iKFZ Stufe III

Zuletzt geändert von MACH formsolutions am 08.10.2025

Zeige letzte Bearbeiter
1 ## iKfz Stufe III
2
3 ### Allgemeine Voraussetzungen
4
5 * Einrichtung KBA-Schnittstelle
6 * Fachverfahrensschnittstellen
7 * Kennzeichenverwaltungssystem
8 * Gebührenrückstandsprüfung
9 * Konfigurationlisten
10 * Relevante Konfigurationsparameter
11 * Liste für mandantenspezifische Verwendungszwecke
12 * Liste für mandantenspezifische Gebühren
13 * Liste für mandantenspezifische Gemeindeschlüssel der einzelnen Orte des Zuständigkeitsbereichs
14 * Veröffentlichung des Assistenten
15
16 #### Einrichtung KBA-Schnittstelle
17
18 Um eine korrekte Verbindung zu den iKfz-Schnittstellen vom Kraftfahrbundesamt (KBA) aufbauen zu können, wird die sogenannte **K-Kennung** mit dem zugehörigen Passwort benötigt. Diese Daten werden der Zulassungsbehörde direkt vom KBA ausgestellt. Die Zugangsdaten werden der Webservice-Konfiguration des entsprechenden Mandanten hinterlegt.
19
20 ![[Mandanten- und Gruppenverwaltung|@MandantenGruppenverwaltung.jpg]]
21
22 Hierzu wird über die "Mandanten- und Gruppenverwaltung" der entsprechende Mandant per Linksklick ausgewählt:
23
24 ![[In Mandanten einloggen|@MandantEinloggen.jpg]]
25
26 Anschließend kann über "Module":
27
28 ![[Module|@Module.jpg]]
29
30 in die erweiterten Modulkonfigurationen navigiert werden:
31
32 ![[Erweiterte Modulkonfiguration|@ErweiterteModulkonfiguration.jpg]]
33
34 Dort wird der Webservice **iKfz**, mit der **WebServiceOrganisationsID** "22222222-2222" und der derzeitig aktuelle **Schnittstellen-Version** "5.1" ausgewählt. Unter _Webservice-Url_ ist die Webservice-Url der iKfz-Schnittstelle des KBA's einzutragen. Derzeit ist dazu folgende URL vorgeschrieben: _<https://www.kba-online.de/i-kfz/ikfzSOAP>_ Die _K-Kennung_ sowie das zugehörige _Passwort_ ist in den Textfeldern für **Werte für HTTP-Basic Authentifikation** zu hinterlegen.
35
36 ![[Erweiterte Modulkonfiguration|@Webservice-Konfiguration-iKfz.jpg]]
37
38 Anschließend wird die Konfiguration mittels der Schaltfläche **Speichern** übernommen.
39
40 > **Hinweis:**
41 >
42 > Damit eine korrekte Verbindung zur KBA-Schnittstelle aufgebaut werden kann, muss eine VPN-Verbindung zum KBA aufgebaut werden. Hierzu ist das KBA zu kontaktieren!
43
44 #### Fachverfahrensschnittstellen
45
46 ##### RabbitMQ und SecureConnector
47
48 Mittels der RabbitMQ wird beispielsweise, mit Hilfe einer Messaging Queue, eine asynchrone Gebührenrückstandsprüfung ausgeführt. Sobald die Messaging Queue eine Anfrage erhält, wird diese mit dem SecureConnector von MACH formsolutions an das entsprechende Fachverfahren weitergeleitet. Die RabbitMQ sowie der SecureConnector und das Fachverfahren befinden sich bei der entsprechenden Behörde.
49
50 Sollten bei der Kommunikation mit dem Fachverfahren Fehler auftreten, werden diese behandelt wie Negativmeldungen der Gebührenrückstandsprüfung. Sollte die Gebührenrückstandsprüfung fehlschlagen, weil z.B. keine Daten zum Fahrzeug bzw. zur antragstellenden Person vorhanden sind, wird der SecureConnector eine Negativantwort übermitteln. Aufgrund der negativen Antwort vom Fachverfahren werden im Assistenten die weiteren Panels dem Bürger ausgeblendet. Zusätzlich wird dem Bürger ein entsprechender Hinweis eingeblendet, in dem ihm mitgeteilt wird, dass dieser sich bei seiner Zulassungsstelle vor Ort melden muss. Nach der Bestätigung des eingeblendeten Hinweises kann der Bürger über die Schaltfläche Einreichen seine bereits erfassten Daten an die Zulassungsstelle übermitteln.
51
52 Im Erfolgsfall wird vom SecureConnector eine Positivantwort an den Formularserver übermittelt. Dem Bürger werden im Assistenten die entsprechenden weiteren Panels eingeblendet und er kann den Assistenten fertig ausfüllen sowie einreichen.
53
54 Folgende Kommunikationsstruktur muss eingerichtet werden:
55
56 ![[Sequenz|@sequenz.jpg]]
57
58 ##### Kennzeichenverwaltungssystem
59
60 Analog zur KBA-Schnittstelle müssen in der Webservice-Konfiguration verschiedene Schnittstellen konfiguriert werden. Diese beziehen sich derzeit auf:
61
62 * XTA XÖV - xKfz - 0601 - Anfrage Kennzeichensuche
63 * XTA XÖV - xKfz - 0603 - Anfrage nächstes freies Kennzeichen
64 * XTA XÖV - xKfz - 0605 - Anfrage Kennzeichen zur Bearbeitung sperren
65 * XTA XÖV - xKfz - 0606 - Anfrage Kennzeichen freigeben
66 * XTA XÖV - xKfz - 0607 - Anfrage Kennzeichenreservierung
67 * XTA XÖV - xKfz - 0611 - Anfrage Kennzeichenreservierung prüfen
68 * XTA XÖV - xKfz - 0612 - Anfrage Kennzeichen für Zulassung verwenden
69
70 ![[XTAXOEV|@XTAXOEV.jpg]]
71
72 * Die _Webservice-Url_ ist mit der URL des Fachverfahrens zu befüllen, der Pfad sollte hierbei auf die XTA Schnittstelle verweisen. Ebenfalls kann hier eine lokale IP-Adresse eingetragen werden.
73 * Die _SOAP-Version_ ist mit "1.1" zu befüllen.
74 * Eine HTTP-Basic-Authentifikation ist nicht zu verwenden.
75 * Unter _Werte für Zertifikatsauthentifizierung_ ist eine JavaKeyStore (.jks) hochzuladen, um sich gegenüber dem Fachverfahren mittels Client Zertifikat authentifizieren zu können.
76
77 > **Hinweis:**
78 >
79 > Die Keystores müssen im Vorfeld ausgetauscht und hinterlegt werden. Hierbei sollte der Betreiber des Fachverfahrens miteinbezogen werden, da gegebenenfalls Anpassungen an dem entsprechenden System vorgenommen werden muss.
80
81 * Die weiteren relevanten Daten sind abhängig von der Konfiguration der RabbitMQ. Diese erhalten Sie von dem Administrator der RabbitMQ.
82
83 > **Hinweis:**
84 >
85 > Es ist empfehlenswert ebenfalls eine Zertifikatsauthentifizierung gegenüber der RabbitMQ zu verwenden.
86
87 Zusätzlich muss eine entsprechende Webservice-Aktion definiert werden:
88
89 ![[KVS|@KVS.jpg]]
90
91 Folgendes Beispiel bezieht sich auf die _Anfrage nächstes freies Kennzeichen_, muss jedoch **jeweils** für alle obigen erwähnten separat konfiguriert werden.
92
93 ![[Nächstes Freies Kennzeichen|@NaechstesFreiesKennzeichen.jpg]]
94
95 Die endgültige Konfiguration der Webservice-Aktion der Schnittstelle _XTA XÖV - xKfz - 0603 - Anfrage nächstes freies Kennzeichen_ sollte wie folgt aussehen:
96
97 ![[Nächstes freies Kennzeichen Übersicht|@NaechstesFreiesKennzeichenUebersicht.jpg]]
98
99 ##### Gebührenrückstandsprüfung
100
101 Die Gebührenrückstandsprüfung ist analog zur Webservice-Konfiguration des Kennezeichenverwaltungssystems zu konfigurieren, mit der Ausnahme, dass **keine** Webservice-Aktion hinterlegt werden darf.
102
103 Die zu verwendende Schnittstelle bezieht sich auf:
104
105 * XTA XÖV
106
107 #### Konfigurationslisten
108
109 ##### Relevante Konfigurationsparameter
110
111 Neben der Webservice-Konfiguration sind weitere Daten in Form einer CSV-Liste am Formularserver zu hinterlegen, welche für eine Inbetriebnahme des Prozesses unabdinglich sind. Folgende Werte sind als separierte Spaltenköpfe zu hinterlegen:
112
113 ![[Konfigurationsliste|@Konfigurationsliste.jpg]]
114
115 * Die Spalte _Zulassungsbehörde_ repräsentiert die statistische Kennziffer der Zulassungsbehörde inklusive vorangestelltem "Z". Dieser Wert wird im Prozess als Kommunikationspartner mit an das KBA und den entsprechenden weiteren Schnittstellen übergeben.
116 * Die Spalte _Kommunikationspartner_ repräsentiert ebenfalls die entsprechende Behörde, wird jedoch für die Anbindung der externen Fachverfahren für die Gebührenrückstandsprüfung oder für das Kennzeichenverwaltungssystem benötigt.
117 * Die Spalte _Benutzerkennung_ repräsentiert die _K-Kennung_, welche bereits in der Webservice-Konfiguration hinterlegt wurde. Diese Information ist explizit nochmals im Prozess selbst zu verwenden.
118 * Die Spalte _OrganizationID_ repräsentiert den amtlichen Gemeindeschlüssel bzw. die Mandantennummer des Kunden. Diese kann in der _Mandanten- und Gruppenverwaltung_ eingesehen werden.
119
120 ![[In Mandanten einloggen|@MandantEinloggen.jpg]]
121
122 * Die Spalte _GBR_ kann dafür verwendet werden, um die Seite _Gebührenrückstandsprüfung_ im Antragsprozess zu deaktivieren, sofern noch kein entsprechendes Fachverfahren konfiguriert wurde.
123 * Mögliche Werte: ja/nein
124
125 > **Hinweis:**
126 >
127 > Dieser Parameter sollte immer auf "ja" gesetzt werden, da ansonsten die Anforderungen des KBA's nicht eingehalten werden!
128
129 * Die Spalte _KVS_ kann dafür verwendet werden, um die Optionen des _Kennzeichenverwaltungssystems_ im Antragsprozess einzuschränken, sodass kein externes Fachverfahren benötigt wird, oder nur einzelne Verfahren aktiviert werden. Standardmäßig ist das Feld leer zu lassen, sodass die Anfrage auf das nächste freie Kennzeichen und dessen Sperrung erfolgen kann. Wird **nein** in die Listenspalte eingetragen, wird das KVS deaktiviert.
130 * Mögliche Werte: 0603/nein
131 * Die Spalte _Systemkennung_ repräsentiert eine 16-stellige Zahlen und Buchstabenkombination. Diese Kombination muss für die Abfrage von Steuerrückstände, sowie der Validierung von Bankdaten mit übergeben werden
132 * Die Spalte _Anwendernummer_ repräsentiert die Anwendernummer der Zulassungsbehörde für das zentrale Fahrzeugregister. Diese Kennung wird üblicherweise mit der _K-Kennung_ ausgeliefert und wird benötigt, um Prozesse vollautomatisiert durchlaufen zu können.
133 * Die Spalte _Vorgang_ kann dafür verwendet werden, um nur einzelne Vorgänge der Antragsassistenten zu aktivieren.
134 * Sind mehrere Vorgänge vorhanden, sind diese per Semikolon zu trennen
135 * Wird das Listenfeld nicht befüllt, werden standardmäßig alle Vorgänge zugelassen.
136 * Mögliche Werte:
137 * AB=Außerbetriebsetzung
138 * NZ=Neuzulassung
139 * UM=Umschreibung
140 * WZ=Wiederzulassung
141 * Beispiel:
142 * AB,UM,WZ - dies führt zu einer Deaktivierung der Neuzulassung in Form einer Fehlermeldung, sollte der Vorgang ausgewählt werden.
143 * Die Spalte _MandantBezeichnung_ repräsentiert die offizielle Bezeichnung der Zulassungsbehörde
144
145 Die Liste ist als **durch Trennzeichen getrennte** CSV-Liste in **UTF-8** gespeichert werden. In Excel kann per _Speichern unter_ folgende Konfiguration ausgewählt werden:
146
147 ![[Excel CSV Trennzeichen getrennt|@ExcelCSVTrennzeichenGetrennt.jpg]]
148
149 Alternativ kann die Liste mit jedem anderen beliebigen Texteditor erstellt werden.
150
151 Beispiel Notepad:
152
153 ![[Notepad CSV Trennzeichen getrennt Ansicht|@NotepadCSVTrennzeichenGetrenntAnsicht.jpg]]
154
155 Auch hier lässt sich per _Speichern unter_ das Kodierungsformat **UTF-8** einstellen
156
157 ![[Notepad CSV Trennzeichen getrennt|@NotepadCSVTrennzeichenGetrennt.jpg]]
158
159 Anschließend kann die Konfigurationsliste per _Listenverwaltung_ auf den Formularserver hochgeladen werden. Die Liste **muss** im Hauptmandanten, in diesem Fall "22222222-2222" hinterlegt werden, niemals bei einem Kunden selbst. Hierzu muss über "Assistent erstellen/bearbeiten" zuerst in die Assistentenbauoberfläche gewechselt werden.
160
161 ![[Sprung in Metaform|@SprungInMetaform.jpg]]
162
163 Anschließend kann über das Symbol der Listenverwaltung in diese übergegangen werden:
164
165 ![[Sprung in die Listenverwaltung|@SprungInListenverwaltung.jpg]]
166
167 In der Listenverwaltung **muss** es bereits eine existierende Liste mit dem Namen "iKFZ" geben. Auf keinen Fall sollte hier eine neue Liste angelegt werden, da diese sonst standardmäßig nicht im Antragsassistent verwendet wird.
168
169 Die existente Liste ist mittels zu bearbeiten:
170
171 ![[iKfz Liste bearbeiten|@iKfzListe.jpg]]
172
173 Sollte bei dem "Datenquellentyp" der Wert "Manuelle Liste ausgewählt sein", muss dieser auf "Lokaler CSV-Import" abgeändert werden. Der Listenname "iKFZ" ist zwingend beizubehalten. Unter _CSV-Datei_ wird die soeben erstellte CSV-Datei ausgewählt und mittels _Speichern_ hochgeladen. Um zu überprüfen, dass es keine Probleme hinsichtlich Umlauten gibt, demnach die Liste korrekt im UTF-8 Kodierungsschema gespeichert wurde, kann die Spaltennummer _Zulassungsbehörde_ überprüft werden. Wird hier "ö" korrekt dargestellt, ist die Listenkonfiguration abgeschlossen.
174
175 ![[iKfz Liste hochgeladen UTF8|@iKfzListeHochgeladenUTF8.jpg]]
176
177 > **Hinweis:**
178 >
179 > Sollten nachträglich weitere Änderungen an der Liste relevant sein, ist das obige beschriebene Prozedere erneut zu durchlaufen!
180
181 ##### Liste für mandantenspezifische Verwendungszwecke
182
183 Da der Verwendungszweck von Mandant zu Mandant unterschiedlich aufbereitet werden muss, haben wir diesen konfigurierbar gehalten. Um diese Dynamik abzubilden, wird eine Konfigurationsliste gepflegt, welche die Daten für den Verwendungszweck je Arbeitsgang speichert. Der Aufbau der Liste ist wie folgt:
184
185 * **Listenname:** Verwendungszweck
186
187 | Spaltenbezeichnung | Beschreibung |
188 | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
189 | OrganizationId | Mandantennummer |
190 | CounterPrefix | Angabe darüber, wann die fortlaufende Nummer zurückgesetzt werden soll. Mögliche Werte: Jahr (Zurücksetzen bei Jahreswechsel), Monat (Zurücksetzen bei Monatswechsel), Tag (Zurücksetzen bei Tageswechsel). |
191 | VerwendungszweckPattern | Angabe darüber, in welchem Format das Datum in den Verwendungszweck geschrieben werden soll. Hierbei gelten alle möglichen "Pattern", welche von Java unterstützt werden. |
192 | VZ_AB | Verwendungszweck Außerbetriebsetzung |
193 | fortlNummer_AB | Fortlaufende Nummer Außerbetriebsetzung |
194 | VZ_EZ | Verwendungszweck Erstzulassung |
195 | fortlNummer_EZ | Fortlaufende Nummer Erstzulassung |
196 | VF_AÄ | Verwendungszweck Anschriftenänderung |
197 | fortlNummer_AÄ | Fortlaufende Nummer Anschriftenänderung |
198 | VZ_WZ-ZulB-H-K | Verwendungszweck Wiederzulassung ohne Zulassungsbezirkswechsel ohne Halterwechsel ohne Kennzeichenwechsel |
199 | fortlNummer_WZ-ZulB-H-K | Fortlaufende Nummer Wiederzulassung ohne Zulassungsbezirkswechsel ohne Halterwechsel ohne Kennzeichenwechsel |
200 | VZ_WZ-ZulB-H+K | Verwendungszweck Wiederzulassung ohne Zulassungsbezirkswechsel ohne Halterwechsel mit Kennzeichenwechsel |
201 | fortlNummer_WZ-ZulB-H+K | Fortlaufende Nummer Wiederzulassung ohne Zulassungsbezirkswechsel ohne Halterwechsel mit Kennzeichenwechsel |
202 | VZ_WZ-ZulB+H+K | Verwendungszweck Wiederzulassung ohne Zulassungsbezirkswechsel mit Halterwechsel mit Kennzeichenwechsel |
203 | fortlNummer_WZ-ZulB+H+K | Fortlaufende Nummer Wiederzulassung ohne Zulassungsbezirkswechsel mit Halterwechsel mit Kennzeichenwechsel |
204 | VZ_WZ+ZulB-H-K | Verwendungszweck Wiederzulassung mit Zulassungsbezirkswechsel ohne Halterwechsel ohne Kennzeichenwechsel |
205 | fortlNummer_WZ+ZulB-H-K | Fortlaufende Nummer Wiederzulassung mit Zulassungsbezirkswechsel ohne Halterwechsel ohne Kennzeichenwechsel |
206 | VZ_WZ+ZulB-H+K | Verwendungszweck Wiederzulassung mit Zulassungsbezirkswechsel ohne Halterwechsel mit Kennzeichenwechsel |
207 | fortlNummer_WZ+ZulB-H+K | Fortlaufende Nummer Wiederzulassung mit Zulassungsbezirkswechsel ohne Halterwechsel mit Kennzeichenwechsel |
208 | VZ_WZ_+ZulB+H+K | Verwendungszweck Wiederzulassung mit Zulassungsbezirkswechsel mit Halterwechsel mit Kennzeichenwechsel |
209 | fortlNummer_WZ_+ZulB+H+K | Fortlaufende Nummer Wiederzulassung mit Zulassungsbezirkswechsel mit Halterwechsel mit Kennzeichenwechsel |
210 | VZ_UM-ZulB+H-K | Verwendungszweck Umschreibung ohne Zulassungsbezirkswechsel mit Halterwechsel ohne Kennzeichenwechsel |
211 | fortlNummer_UM-ZulB+H-K | Fortlaufende Nummer Umschreibung ohne Zulassungsbezirkswechsel mit Halterwechsel ohne Kennzeichenwechsel |
212 | VZ_UM-ZulB+H+K | Verwendungszweck Umschreibung ohne Zulassungsbezirkswechsel mit Halterwechsel mit Kennzeichenwechsel |
213 | fortlNummer_UM-ZulB+H+K | Fortlaufende Nummer Umschreibung ohne Zulassungsbezirkswechsel mit Halterwechsel mit Kennzeichenwechsel |
214 | VZ_UM+ZulB-H-K | Verwendungszweck Umschreibung mit Zulassungsbezirkswechsel ohne Halterwechsel ohne Kennzeichenwechsel |
215 | fortlNummer_UM+ZulB-H-K | Fortlaufende Nummer Umschreibung mit Zulassungsbezirkswechsel ohne Halterwechsel ohne Kennzeichenwechsel |
216 | VZ_UM+ZulB-H+K | Verwendungszweck Umschreibung mit Zulassungsbezirkswechsel ohne Halterwechsel mit Kennzeichenwechsel |
217 | fortlNummer_UM+ZulB-H+K | Fortlaufende Nummer Umschreibung mit Zulassungsbezirkswechsel ohne Halterwechsel mit Kennzeichenwechsel |
218 | VZ_UM+ZulB+H-K | Verwendungszweck Umschreibung mit Zulassungsbezirkswechsel mit Halterwechsel ohne Kennzeichenwechsel |
219 | fortlNummer_UM+ZulB+H-K | Fortlaufende Nummer Umschreibung mit Zulassungsbezirkswechsel mit Halterwechsel ohne Kennzeichenwechsel |
220 | VZ_UM+ZulB+H+K | Verwendungszweck Umschreibung mit Zulassungsbezirkswechsel mit Halterwechsel mit Kennzeichenwechsel |
221 | fortlNummer_UM+ZulB+H+K | Fortlaufende Nummer Umschreibung mit Zulassungsbezirkswechsel mit Halterwechsel mit Kennzeichenwechsel |
222 | Kennzeichen | Ist der Wert "ja" eingetragen, wird das Kennzeichen des Vorgangs in den Verwendungszweck hinein generiert. |
223
224 **Wichtig:** Aktuell wird der Verwendungszweck standardmäßig nach folgendem Schema aufgebaut:
225
226 * Verwendungszweck aus Liste + Datum + „.“ + fortlaufende Nummer
227 * Beispiel: Test18.09.2019.000001
228
229 In einem einzelnen Fall (Stadt Dortmund) wird der Verwendungszweck aktuell nach einem anderen Schema aufbereitet. Ob dieser Fall eintreten soll oder nicht wird im Assistenten, nicht in der Konfigurationsliste bestimmt.
230
231 * Verwendungszweck + Leerzeichen + Tagebuchnummer + fortlaufende Nummer + Leerzeichen + Kundentext
232 * Beispiel: 369000013 201909240036 IKFZ
233
234 ##### Liste für mandantenspezifische Gebühren
235
236 Um während des Ausfüllprozesses des Assistenten eine individuelle Gebührenberechnung je Vorgang gewährleisten zu können, müssen die Gebührenpositionen für die einzelnen Mandanten konfigurierbar gemacht werden. Um dies zu realisieren wird pro Arbeitsgang eine Konfigurationsliste gepflegt, welche im Einzelnen wie folgt aussehen:
237
238 ###### Außerbetriebsetzung
239
240 * **Listenname:** iKFZ Gebühren Außerbetriebsetzung
241
242 | Spaltenbezeichnung | Beschreibung |
243 | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
244 | OrganizationId | Mandantennummer |
245 | Gebühr | Grundgebühr |
246 | ZFZR125 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
247 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
248 | Vorgang der Gebührenberechnung | Angabe, ob die Reservierungsgebühr bei einer Außerbetriebsetzung oder bei einer Wiederzulassung berechnet werden soll. Mögliche Werte: AB, WZ |
249
250 ###### Erstzulassung
251
252 * **Listenname:** iKFZ Gebühren Erstzulassung
253
254 | Spaltenbezeichnung | Beschreibung |
255 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
256 | OrganizationId | Mandantennummer |
257 | Gebühr | Grundgebühr |
258 | ZFZR125 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
259 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
260 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
261 | Feinstaubplakette | Zu erhebende Gebühr für eine Feinstaubplakette. Diese Gebühr wird dann berechnet, wenn der Bürger eine Feinstaubplakette aus dem Assistenten heraus wünscht. |
262 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
263 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
264 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
265 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
266
267 ###### Wiederzulassung
268
269 * **Listenname:** iKFZ Gebühren Wiederzulassung ohne Wechsel Zulassungsbezirk ohne Halterwechsel ohne Kennzeichenwechsel
270
271 | Spaltenbezeichnung | Beschreibung |
272 | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
273 | OrganizationId | Mandantennummer |
274 | Gebühr | Grundgebühr |
275 | ZFZR125 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
276 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
277 | Vorgang der Gebührenberechnung | Angabe, ob die Reservierungsgebühr bei einer Außerbetriebsetzung oder bei einer Wiederzulassung berechnet werden soll. Mögliche Werte: AB, WZ |
278 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
279 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
280 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
281
282 * **Listenname:** iKFZ Gebühren Wiederzulassung ohne Wechsel Zulassungsbezirk ohne Halterwechsel mit Kennzeichenwechsel
283
284 | Spaltenbezeichnung | Beschreibung |
285 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
286 | OrganizationId | Mandantennummer |
287 | Gebühr | Grundgebühr |
288 | ZFZR125 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
289 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
290 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
291 | Feinstaubplakette | Zu erhebende Gebühr für eine Feinstaubplakette. Diese Gebühr wird dann berechnet, wenn der Bürger eine Feinstaubplakette aus dem Assistenten heraus wünscht. |
292 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
293 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
294 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
295 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
296
297 * **Listenname:** iKFZ Gebühren Wiederzulassung ohne Wechsel Zulassungsbezirk mit Halterwechsel mit Kennzeichenwechsel
298
299 | Spaltenbezeichnung | Beschreibung |
300 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
301 | OrganizationId | Mandantennummer |
302 | Gebühr | Grundgebühr |
303 | ZFZR124 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
304 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
305 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
306 | ZFZR124 J/N | Angabe, ob die Gebühr für das zentrale Fahrzeugregister zu den Gebühren der ZB2 aufsummiert werden soll oder nicht. Mögliche Werte: J, N |
307 | Feinstaubplakette | Zu erhebende Gebühr für eine Feinstaubplakette. Diese Gebühr wird dann berechnet, wenn der Bürger eine Feinstaubplakette aus dem Assistenten heraus wünscht. |
308 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
309 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
310 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
311 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
312
313 * **Listenname:** iKFZ Gebühren Wiederzulassung mit Wechsel Zulassungsbezirk ohne Halterwechsel ohne Kennzeichenwechsel
314
315 | Spaltenbezeichnung | Beschreibung |
316 | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
317 | OrganizationId | Mandantennummer |
318 | Gebühr | Grundgebühr |
319 | ZFZR125 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
320 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
321 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
322 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
323 | Vorgang der Gebührenberechnung | Angabe, ob die Reservierungsgebühr bei einer Außerbetriebsetzung oder bei einer Wiederzulassung berechnet werden soll. Mögliche Werte: AB, WZ |
324 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
325 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
326
327 * **Listenname:** iKFZ Gebühren Wiederzulassung mit Wechsel Zulassungsbezirk mit Halterwechsel mit Kennzeichenwechsel
328
329 | Spaltenbezeichnung | Beschreibung |
330 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
331 | OrganizationId | Mandantennummer |
332 | Gebühren | Grundgebühr |
333 | ZFZR124 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
334 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
335 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
336 | ZFZR124 J/N | Angabe, ob die Gebühr für das zentrale Fahrzeugregister zu den Gebühren der ZB2 aufsummiert werden soll oder nicht. Mögliche Werte: J, N |
337 | Feinstaubplakette | Zu erhebende Gebühr für eine Feinstaubplakette. Diese Gebühr wird dann berechnet, wenn der Bürger eine Feinstaubplakette aus dem Assistenten heraus wünscht. |
338 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
339 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
340 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
341 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
342
343 ###### Anschriftenänderung
344
345 * **Listenname:** iKFZ Gebühren Anschriftenänderung
346
347 | Spaltenbezeichnung | Beschreibung |
348 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
349 | OrganizationID | Mandantennummer |
350 | Gebühren | Grundgebühr |
351 | ZFZR125 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
352 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
353 | Postzustellung | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
354 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
355
356 ###### Umschreibung
357
358 * **Listenname:** iKFZ Gebühren Umschreibung mit Wechsel Zulassungsbezirk mit Halterwechsel ohne Kennzeichenwechsel
359
360 | Spaltenbezeichnung | Beschreibung |
361 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
362 | OrganizationId | Mandantennummer |
363 | Gebühr | Grundgebühr |
364 | ZFZR124 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
365 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
366 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
367 | ZFZR124 J/N | Angabe, ob die Gebühr für das zentrale Fahrzeugregister zu den Gebühren der ZB2 aufsummiert werden soll oder nicht. Mögliche Werte: J, N |
368 | Feinstaubplakette | Zu erhebende Gebühr für eine Feinstaubplakette. Diese Gebühr wird dann berechnet, wenn der Bürger eine Feinstaubplakette aus dem Assistenten heraus wünscht. |
369 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
370 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
371 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
372 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
373
374 * **Listenname:** iKFZ Gebühren Umschreibung ohne Wechsel Zulassungsbezirk ohne Kennzeichenwechsel mit Halterwechsel
375
376 | Spaltenbezeichnung | Beschreibung |
377 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
378 | OrganizationId | Mandantennummer |
379 | Gebühr | Grundgebühr |
380 | ZFZR124 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
381 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
382 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
383 | ZFZR124 J/N | Angabe, ob die Gebühr für das zentrale Fahrzeugregister zu den Gebühren der ZB2 aufsummiert werden soll oder nicht. Mögliche Werte: J, N |
384 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
385 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
386
387 * **Listenname:** iKFZ Gebühren Umschreibung ohne Wechsel Zulassungsbezirk mit Halterwechsel mit Kennzeichenwechsel
388
389 | Spaltenbezeichnung | Beschreibung |
390 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
391 | OrganizationId | Mandantennummer |
392 | Gebühr | Grundgebühr |
393 | ZFZR124 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
394 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
395 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
396 | ZFZR124 J/N | Angabe, ob die Gebühr für das zentrale Fahrzeugregister zu den Gebühren der ZB2 aufsummiert werden soll oder nicht. Mögliche Werte: J, N |
397 | Feinstaubplakette | Zu erhebende Gebühr für eine Feinstaubplakette. Diese Gebühr wird dann berechnet, wenn der Bürger eine Feinstaubplakette aus dem Assistenten heraus wünscht. |
398 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
399 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
400 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
401 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
402
403 * **Listenname:** iKFZ Gebühren Umschreibung mit Wechsel Zulassungsbezirk ohne Halterwechsel ohne Kennzeichenwechsel
404
405 | Spaltenbezeichnung | Beschreibung |
406 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
407 | OrganizationId | Mandantennummer |
408 | Gebühr | Grundgebühr |
409 | ZFZR125 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
410 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
411
412 * **Listenname:** iKFZ Gebühren Umschreibung mit Wechsel Zulassungsbezirk mit Kennzeichenwechsel ohne Halterwechsel
413
414 | Spaltenbezeichnung | Beschreibung |
415 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
416 | OrganizationId | Mandantennummer |
417 | Gebühr | Grundgebühr |
418 | ZFZR125 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
419 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
420 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
421 | Feinstaubplakette | Zu erhebende Gebühr für eine Feinstaubplakette. Diese Gebühr wird dann berechnet, wenn der Bürger eine Feinstaubplakette aus dem Assistenten heraus wünscht. |
422 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
423 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
424 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
425 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
426
427 * **Listenname:** iKFZ Gebühren Umschreibung mit Wechsel Zulassungsbezirk mit Halterwechsel mit Kennzeichenwechsel
428
429 | Spaltenbezeichnung | Beschreibung |
430 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
431 | OrganizationId | Mandantennummer |
432 | Gebühr | Grundgebühr |
433 | ZFZR124 | Zu erhebende Gebühr für den ZFZR-Eintrag. |
434 | Klebesiegel | Zu erhebende Gebühr für die Klebesiegel. Hierbei ist immer nur der Wert für ein Klebesiegel zu hinterlegen, da der Assistent automatisch bestimmt, wie viele Klebesiegel berechnet werden müssen. |
435 | ZB2 | Zu erhebende Gebühr für die Zulassungsbescheinigung Teil 2. |
436 | ZFZR124 J/N | Angabe, ob die Gebühr für das zentrale Fahrzeugregister zu den Gebühren der ZB2 aufsummiert werden soll oder nicht. Mögliche Werte: J, N |
437 | Feinstaubplakette | Zu erhebende Gebühr für eine Feinstaubplakette. Diese Gebühr wird dann berechnet, wenn der Bürger eine Feinstaubplakette aus dem Assistenten heraus wünscht. |
438 | Reservierung | Zu erhebende Gebühr für ein reserviertes Kennzeichen. |
439 | Wunschkennzeichen | Zu erhebende Gebühr für ein Wunschkennzeichen. |
440 | PostzustellungZB2 | Zu erhebende Gebühr für eine Postzustellung. Dieser Wert muss immer gepflegt sein. Wenn keine Postzustellung erfolgt, muss der Wert 0.0 eingetragen werden. |
441 | Porto | Zu erhebende Portogebühren. Dieser Wert muss immer gepflegt sein. Wenn kein Porto berechnet wird, muss der Wert 0.0 gepflegt sein. |
442
443 > **Wichtig:**
444 >
445 > Die hinterlegten Beträge müssen statt mit einem Komma (,) mit einem Punkt (.) getrennt werden, da es sonst zu einer Fehlermeldung bei der Gebührenberechnung kommt.
446 >
447 > Falsch: 20,20
448 >
449 > Richtig: 20.20
450
451 #### Liste für den Zuständigkeitsbereich einer Zulassungsbehörde
452
453 Da eine Zulassungsbehörde mehrere Orte umfasst, müssen diese in einer Konfigurationsliste gepflegt werden. Die Pflege obliegt hierbei dem BSI-zertifizierten Rechenzentrum.
454
455 Im Folgenden wird der Aufbau der Liste beschrieben:
456
457 * **Listenname:** iKFZ Zuständigkeitsbereich
458
459 | Spaltenbezeichnung | Beschreibung |
460 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
461 | OrganizationID | Bildet die Mandantennummer des Mandanten ab, über welchen die Anwendung betrieben wird. |
462 | Ort | Bildet die für den Zuständigkeitsbereich einer Zulassungsbehörde unterliegenden Orte ab. Diese können ";"-getrennt eingetragen werden. Beispiel: "TestortA; TestortB; TestortC" |
463
464 #### Liste für mandantenspezifische Gemeindeschlüssel der einzelnen Orte des Zuständigkeitsbereichs
465
466 Bei einer Umschreibung von außerhalb muss der Gemeindeschlüssel des neuen Wohnortes an das KBA übermittelt werden. Da dieser nicht anhand einer Schnittstelle ausgelesen werden kann, muss für jeden Mandanten eine eigene Konfigurationsliste gepflegt werden, wobei die einzelnen Orte des Zuständigkeitsbereichs mit ihrem zugehörigen Gemeindeschlüssel aufgelistet werden.
467
468 Im Folgenden wird der Aufbau der Liste beschrieben:
469
470 * **Listenname:** iKFZ - AGS
471
472 | Spaltenbezeichnung | Beschreibung |
473 | ------------------ | ---------------------------------------------------------------------------------- |
474 | Bezeichnung | Enthält die Bezeichnung des Ortes, wie er aus dem Personalausweis ausgelesen wird. |
475 | Schluessel | Enthält den Gemeindeschlüssel des Ortes. |
476
477 > **Wichtig:**
478 >
479 > Die Liste kann entweder wie die Gebührenlisten auch als Verlagsliste gepflegt werden, kann jedoch auch pro Mandant als eigene Liste erstellt werden. Welches Verfahren verwendet wird obligt der Entscheidung des BSI-zertifizierten Rechenzentrums. Ohne das Hinterlegen der Liste sind keine vollautomatisierten Umschreibungen von außerhalb möglich!
480
481 #### Veröffentlichung
482
483 Die Veröffentlichung muss für **jeden** Mandanten separat durchgeführt werden! Um den Antragsassistenten zu veröffentlichen, kann in der Suche nach "122683" gesucht werden.
484
485 ![[Schnellsuche iKfz|@SchnellsucheiKfz.jpg]]
486
487 Anschließend sollte in der Detailsuche der Antragsassistent für iKfz der Stufe 3 gefunden werden.
488
489 ![[Sprung in Veröffentlichung|@SprungInVeroeffentlichung.jpg]]
490
491 Über diesen Suchtreffer wird nun in die Veröffentlichungsmaske des Assistenten navigiert. In der folgenden Maske **muss** zu Beginn das _serverseitige Zwischenspeichern_ aktiviert werden.
492
493 ![[Serverseitiges Zwischenspeichern|@ServerseitigesZwischenspeichern.jpg]]
494
495 Dadurch speichert der Antragsassistent beim jedem Klick auf _Weiter_ den aktuellen Zustand. Kommt es beispielsweise zu einem Absturz des Browsers oder ähnlichen Ursachen, die den Antrag verwerfen könnten, wird dem Bürger die Möglichkeit geboten innerhalb von 30 Minuten seit der letzten Eingabe den Prozess wiederherzustellen. Der Antragsassistent muss hierzu lediglich neu gestartet werden. Zusätzlich werden in dieser Maske die Bescheide für vollautomatisierte Vorgänge hinterlegt.
496
497 ![[Assistentenantwortgenerierung|@AssistentenantwortGenerierung.jpg]]
498
499 _Spezielle Einreichung_ wird demnach auf den Wert **Automatische Assistentenantwortgenerierung** gesetzt. Mittels Klick auf den Button _Konfigurieren_ können bis zu zehn unterschiedliche Bescheide hinzugefügt werden.
500
501 ![[Assistentenantwortgenerierung Hinzufügen|@AssistentenAntwortgenerierungHinzufuegen.jpg]]
502
503 Für den iKfz Prozess werden lediglich zwei Bescheide eingebunden, die Texte werden je nach dynamisch ermittelten Vorgang entsprechend ausgetauscht. Der Bescheid für eine Außerbetriebsetzung wird wie folgt konfiguriert:
504
505 ![[Konfiguration Außerbetriebsetzung Assistentenantwortgenerierung|@KonfigurationAusserbetriebsetzungAssistentenantwortgenerierung.jpg]]
506
507 Die _Bezeichnung_ kann hierbei frei gewählt werden. Die Formularnummer sowie Version wird von der Firma MACH bereitgestellt, nachdem der Kunde sein PDF entsprechend an uns übermittelt hat. Durch die Konfiguration _PDF-Download erzwingen_ wird beispielsweise bei Portalkunden gewährleistet, dass der Bürger nicht vor Download des Bescheids zurück ins Portal geleitet wird. Ebenfalls wird eine Fehlermeldung angezeigt, wenn der Bürger den Prozess beenden möchte. Das Formularmapping ist nicht zu beachten.
508
509 Zusätzlich muss eine Webservice-Einreichung an dem Bescheid hinterlegt werden. Wird der Bescheid demnach von einem Bürger angeklickt, findet eine endgültige Einreichung an das KBA statt, bevor der Bescheid angezeigt wird. Bei der _Außerbetriebsetzung_ **sowie** der _Umschreibung_ ist **jeweils** folgende Konfiguration vorzunehmen.
510
511 ![[KonfigurationAusserbetriebsetzung Assistentenantwortgenerierung Webservice Einreichung|@KonfigurationAusserbetriebsetzungAssistentenantwortgenerierungWebserviceEinreichung.jpg]]
512
513 Nach dem Bestätigen der Dialoge wird die Außerbetriebsetzung wie folgt aufgelistet:
514
515 ![[Konfiguration Außerbetriebsetzung Assistentenantwortgenerierung Übersicht|@KonfigurationAusserbetriebsetzungAssistentenantwortgenerierungUebersicht.jpg]]
516
517 Analog zu dem obigen beschriebenen Prozess ist ein PDF für die _Umschreibung_ zu hinterlegen. Folgende Konfigurationen sind hierfür relevant:
518
519 ![[Konfiguration Umschreibung Assistentenantwortgenerierung|@KonfigurationUmschreibungAssistentenantwortgenerierung.jpg]]
520
521 Neben den Webservice-Konfigurationen an den Bescheiden müssen zusätzlich die Schnittstellen hinterlegt werden, welche beim Klick auf den Button "Einreichen" angestoßen werden.
522
523 ![[Veröffentlichung Webservice Einreichung|@VeroefftlichungWSEinreichung.jpg]]
524
525 Für vollautomatisierte Prozesse ist es relevant die Schnittstelle "mitteilungZFZR" einzubinden, sodass eine Übermittlung des Antrags an das zentrale Fahrzeugregister erfolgen und somit eine vollautomatisierte Verarbeitung erfolgen kann.
526
527 > **Hinweis:**
528 >
529 > Durch das Öffnen des Bescheids wird der Antrag im Anschluss an das KBA überführt!
530
531 Für teilautomatisierte Prozesse ist es relevant die Schnittstelle "uebermittleAntrag" einzubinden, sodass eine Übermittlung des Antrags lediglich an das KBA erfolgen kann.
532
533 ![[Webservice Einreichung Hinzufügen|@WSEinreichungHinzufuegen.jpg]]
534
535 Für vollautomatisierte Prozesse muss folgende Konfiguration hinzugefügt werden:
536
537 ![[Webservice Einreichung Mitteilung ZFZR|@WSEinreichungMitteilungZFZR.jpg]]
538
539 Für teilautomatisierte Prozesse muss folgende Konfiguration hinzugefügt werden:
540
541 ![[Webservice Einreichung übermittle Antrag|@WSEinreichungUebermittleAntrag.jpg]]
542
543 Anschließend kann das Dialogfenster für die Definition von Webservice-Anfragen geschlossen werden. Um einen Link zu generieren, über welchen der Antragsassistent erreichbar ist, muss die Formularkonfiguration durchlaufen werden:
544
545 ![[Formularkonfiguration Öffnen|@FormularkonfigurationOeffnen.jpg]]
546
547 Auf der ersten Seite muss zum einen eingestellt werden, dass der Antragsassistent elektronisch versendet werden soll. Hierzu **muss** ein Haken bei "Senden per E-Mail/Webservice" gesetzt werden. Zusätzlich **muss** das entsprechend konfigurierte, gewünschte Bezahlverfahren auszuwählen.
548
549 ![[Alter Kundenbereich Seite 1|@AKBS1.jpg]]
550
551 Mittels Klick auf "Weiter" wird zur nächsten Konfigurationsseite navigiert. Auf dieser **muss** die Option _Senden mit Webservice_ ausgewählt und eine URL hinterlegt werden. Der Wert ist hierbei momentan unerheblich und muss lediglich einer gültigen URL entsprechen. Je nach ausgewähltem elektronischem Bezahlverfahren sind entsprechende Parameter zu setzen. Wichtig ist hierbei, dass der Betrag immer auf "0" gesetzt werden **muss**. Der Verwendungszweck kann einen beliebigen Platzhalter beinhalten, da dieser durch den Antragsprozess überschrieben wird.
552
553 ![[Alter Kundenbereich Seite 2 Erste Konfiguration|@AKBS21.jpg]]
554
555 Im weiteren Verlauf der Seite muss die _NPA-Nutzung_ mit der Auswahl _ja_ aktiviert werden. Wird diese auf _Optional_ gestellt, so benötigt der Antragsteller keine Authentifizierung mit dem Personalausweis, jedoch steht dann lediglich der Arbeitsgang der Außerbetriebsetzung zur Verfügung.
556
557 ![[Alter Kundenbereich Seite 2 Zweite Konfiguration|@AKBS22.jpg]]
558
559 Am Ende der Seite werden die Einstellungen mittels _Weiter >>_ übernommen.
560
561 ![[Alter Kundenbereich Seite 2 Dritte Konfiguration|@AKBS23.jpg]]
562
563 Abschließend muss ein eindeutiger Link generiert werden:
564
565 ![[Link Generieren|@LinkGenerieren.jpg]]
566
567 Daraufhin wird der endgültige Link angezeigt, welcher auf der Webseite platziert werden kann.
568
569 ![[Link|@Link.jpg]]
570
571 Sollte bereits ein Link vorhanden sein muss lediglich der Button _Einstellungen speichern_ betätigt werden.
572
573 #### Passwort-Updater
574
575 Um die Passwörter für alle iKfz-Mandanten eines Formularservers updaten zu können, stellt MACH Java-Applikation bereit. Diese Applikation ist eine eigenständige ".jar"-Datei und ist nicht im Umfang des Formularservers enthalten.
576
577 ##### Voraussetzungen
578
579 * Java Version 8
580
581 ##### Verwendung
582
583 Nachdem die ".jar"-Datei von MACH ausgehändigt wurde, kann diese über die Kommandozeile mit dem Befehl
584
585 ```console
586 java -jar <NAME_OF_APPLICATION>.jar
587 ```
588
589 ausgeführt werden. Hierbei kann die Konfiguration der Anwendung über eine Datei mit der Bezeichnung "application.yml" vorgenommen werden, welche wie folgt aufgebaut ist:
590
591 ```console
592 webservice:
593 organizationId: 22222222-2222
594 name: iKfz
595 version: 5.2
596 url: https://test.kba-online.de/pass_test/passSOAP
597 # url: https://www.kba-online.de/pass/passSOAP
598 spring:
599 data:
600 mongodb:
601 host: mongo
602 username: <USERNAME>
603 password: <PASSWORD>
604 authentication-database: <AUTHENTICATION-DATABASE>
605 logging.level.root: INFO
606 ```
607
608 Um die Konfiguration zu verwenden, kann der Aufruf der ".jar"-Datei wie folgt erweitert werden:
609
610 ```console
611 java -jar <NAME_OF_APPLICATION>.jar --spring.config.additional-location=application.yml
612 ```
613
614 Folgende Operationen werden von der Java-Applikation unterstützt:
615
616 _**status**_
617
618 Gibt den aktuellen Gültigkeitsstatus aller im Formularserver hinterlegten Benutzerkennungen zurück.
619
620 Beispielaufruf:
621
622 ```console
623 java -jar <NAME_OF_APPLICATION>.jar --spring.config.additional-location=application.yml status
624 ```
625
626 _**update <New_Password>**_
627
628 Ändert den Status aller im Formularserver hinterlegter Benutzerkennungen auf das angegebene Passwort.
629
630 > **Achtung:**
631 >
632 > Die angegebenen Passwörter unterliegen den Restriktionen des KBA's*
633
634 Beispielaufruf:
635
636 ```console
637 java -jar <NAME_OF_APPLICATION>.jar --spring.config.additional-location=application.yml update 'shRkT!loeG'
638 ```