Zu Content springen
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Hinterlegungen für die BAMF-Stammdatensynchronisation in KuferSQL prüfen

Lehrwerke (Auto-Import), Staatsangehörigkeiten als ISO-Codes und Standorte für Liefer-/Rechnungsadressen der LiD-Prüfungen

Bevor Teilnehmer- und Kursmeldungen erfolgreich an das BAMF übertragen werden können, müssen drei zentrale Hinterlegungen in KuferSQL aktuell sein: die Lehrwerke, die Staatsangehörigkeiten als dreistellige ISO-Codes und die Standorte für Liefer- und Rechnungsadressen bei den LiD-Prüfungen. KuferSQL pflegt diese Listen weitgehend automatisch beim Update — der Anwender muss aber nach jedem Update prüfen, ob die Übernahme erfolgt ist.

ℹ️ Voraussetzung: Aktuelle KuferSQL-Version mit erfolgreich eingespieltem Update, aktiviertes Modul BAMF InGe Online, gepflegte Trägerkennung und DeBeV-Zugangsdaten je Benutzer. Siehe Vorgänger-Artikel zur Modul-Aktivierung.
⚠️ Achtung: Für die Übertragung der Teilnehmerdaten ist unter anderem auch die Nationalität in Form eines dreistelligen ISO-Codes relevant. Lässt sich ein im Teilnehmerstamm erfasster Eintrag keinem Code zuordnen, erhalten Sie einen Hinweis, dass die Eingabe dort korrigiert werden muss.

Lehrwerke für Integrationskurse

Die vom BAMF zugelassenen Lehrwerke werden bei jedem KuferSQL-Update automatisch importiert. Prüfen Sie nach dem Update, ob die Hinterlegung Einstellungen → Hinterlegungen Kurse → Lehrwerke für Integrationskurse gefüllt ist.

Übersicht „Hinterlegung der BAMF-Lehrwerke” in KuferSQL mit den Spalten Schl., Bezeichnung, Gültig bis, Verlag, Art, zugel. für Kursarten, Ausgabe und Vorschlag sowie Einträgen wie „Berliner Platz”, „Delfin” und „Tangram AKTUELL”

Übersichtsliste „Hinterlegung der BAMF-Lehrwerke” — Bezeichnung, Gültigkeitsdatum, Verlag, Art und Vorschlag-Markierung je Lehrwerk

In der Hinterlegung der Lehrwerke gibt es je Lehrwerk eine Einstellung „Vorschlag”, die das entsprechende Lehrwerk für die Anzeige im Auswahl-Dialog im Kursstamm markiert. Das Verhalten:

  • Kein Lehrwerk extra markiert — alle Einträge erscheinen im Auswahl-Dialog (Standardverhalten nach Auslieferung).
  • Mindestens ein Lehrwerk markiert — nur noch die markierten Lehrwerke erscheinen im Auswahl-Dialog im Kursstamm. Damit blenden Sie nicht eingesetzte Lehrwerke aus.

Dialog „Lehrwerk bearbeiten” mit den Feldern Schlüssel, Bezeichnung, Ausgabe, Verlag, Art, zugel. für Kursarten und Gültig bis sowie der grün umrandeten Checkbox „Vorschlag (im Auswahl-Dialog anzeigen)”

Dialog „Lehrwerk bearbeiten” — über den Haken „Vorschlag” steuern Sie die Sichtbarkeit im Kursstamm-Auswahl-Dialog

Zusätzlich gibt es das Feld „gültig bis”, das ein Ablauf-Datum für ein Lehrwerk darstellt. Lehrwerke, deren Gültigkeit abgelaufen ist, erscheinen im Auswahl-Dialog generell nicht mehr — auch nicht, wenn sie als Vorschlag markiert sind.

💡 Vorschlag-Einstellung bleibt erhalten: Die komplette Lehrwerks-Liste wird vom BAMF zur Verfügung gestellt und beim KuferSQL-Update automatisch gepflegt. Die Träger-individuelle Einstellung im Datenfeld „Vorschlag” wird beim Update nicht überschrieben.

Staatsangehörigkeiten / Nationalitäten als ISO-Codes

Für die Übertragung der Teilnehmerdaten ist die Nationalität in Form eines dreistelligen ISO-Codes (ISO 3166-1 alpha-3) relevant. Die entsprechende Liste wird beim Update automatisch unter Einstellungen → Hinterlegungen Adressen → Staatsangehörigkeiten importiert.

Übersicht „Nationalitäten” mit den Spalten Text, Code, ISO 3166-2, ISO 3166-3, ISO Nation, Erfasst am und Geändert am sowie Einträgen wie „afghanisch / 423 / AF / AFG / Afghanistan”

Hinterlegung „Nationalitäten” mit dreistelligem ISO-3166-Code je Eintrag — Pflicht für die Online-Übertragung an das BAMF

Für die Online-Übertragung versucht KuferSQL, die bei den Teilnehmern bereits erfassten Einträge der Staatsangehörigkeit den ISO-Codes automatisch zuzuordnen. Sollte diese Zuordnung aufgrund von Tippfehlern oder ähnlichen Problemen nicht möglich sein, weist KuferSQL beim Aufruf der Schnittstelle darauf hin, dass die Eingabe im Teilnehmerstamm korrigiert werden muss.

Die Werteliste selbst — inklusive ISO 3166-2/3-Spalten und Einlesen-Funktion — pflegen Sie unter „Stammdaten-Zusatzfelder: Muttersprachen, Konfessionen, Berufe”.

Standorte für Liefer- und Rechnungsadressen (LiD-Prüfungen)

Für die Liefer- und Rechnungsadressen im Rahmen der LiD-Prüfungsnachrichten (Prüfung „Leben in Deutschland”) müssen Standorte mit einer beim Bundesamt gültigen Standortkennung hinterlegt sein. Die Pflege erfolgt unter Einstellungen → Hinterlegungen Kurse → Standorte für BAMF.

Übersicht „Standorte für BAMF” mit den Spalten Bezeichnung, Straße, Ort, Kennung, Typ, Geändert am und von sowie den zwei Einträgen „Lieferadresse” und „Rechnungsadresse”

Hinterlegung „Standorte für BAMF” mit BAMF-Zulassungskennung je Standort — erforderlich für LiD-Prüfungsnachrichten

Wenn für alle LiD-Kurse die gleiche Liefer- und Rechnungsadresse verwendet wird, ist es ausreichend, in dieser Hinterlegung jeweils nur einen Eintrag zu erfassen. Sind mehrere Standorte für Liefer- und Rechnungsadressen vorhanden, müssen diese hier alle hinterlegt und eine genaue Zuordnung muss in den jeweiligen Kursstammdaten erfolgen.

ℹ️ Wichtige Hinweise des BAMF: Die Kennung der zugelassenen Kursorte wurde bislang nur über kursbezogene Nachrichten kommuniziert. Aufgrund der fachlichen Anforderung, dass für Liefer- bzw. Rechnungsorte im Rahmen der LiD-Prüfungsnachrichten auch Standorte verwendet werden, die nicht oder nicht nur Kursorte sind, stellt das Bundesamt den Trägern vor Einführung der LiD-Prüfungsnachrichten eine Liste der zugelassenen Kurs- bzw. Standorte mit der jeweils vom Bundesamt vergebenen Kurs- bzw. Standort-Kennung bereit.
⚠️ Was wird tatsächlich übertragen? An das BAMF wird im Rahmen der LiD-Prüfungen nur die Kennung des Standortes übermittelt — anhand dieser Angabe verwendet das BAMF die intern hinterlegte Anschrift. Die in KuferSQL angegebenen Informationen zu Bezeichnung, Straße und Ort des Standortes werden nur innerhalb von KuferSQL angezeigt und nicht an das BAMF übertragen.

Vergeben Sie je Standort eine eindeutige Bezeichnung (z. B. „VHS-Lieferadresse” und „VHS-Rechnungsadresse”). Sie dient allein der Unterscheidung innerhalb von KuferSQL.

Was passiert beim KuferSQL-Update?

Die folgenden Hinterlegungen werden bei jedem KuferSQL-Update automatisch aktualisiert:

  • Lehrwerke — vollständige Liste vom BAMF, inkl. Gültigkeitsdaten.
  • Staatsangehörigkeiten — komplette ISO-Code-Liste (ISO 3166-1 alpha-3).

Folgende Einstellung bleibt erhalten und wird nicht überschrieben:

  • Bei Lehrwerken: der Vorschlag-Marker je Eintrag.

Folgende Hinterlegung wird nicht automatisch gepflegt und muss vom Träger manuell aufgesetzt werden:

  • Standorte für BAMF — wird vom Träger nach Erhalt der BAMF-Standort-Kennungen einmalig manuell angelegt; spätere Erweiterungen (neue Standorte) ebenfalls manuell.

Ergebnis

Mit aktuell gepflegten Lehrwerken, ISO-codierten Staatsangehörigkeiten und BAMF-zugelassenen Standorten sind die drei zentralen Stammdaten-Quellen für jede InGe-Online-Übertragung vorbereitet. Im nächsten Schritt sind die teilnehmerbezogenen Daten im Teilnehmerstamm zu prüfen — insbesondere das BAMF-Aktenzeichen und die Anmeldedaten auf der Registerseite BAMF.

✅ Geschafft: Alle Stammdaten-Hinterlegungen sind aktuell. KuferSQL kann beim Aufruf der Webservices saubere Codes statt fehleranfälliger Klartext-Eingaben senden.