Schnittstelle zum Import der Prüfungsergebnisse für Leben in Deutschland (PrüfungLiDImport-Schnittstelle)
Mit Hilfe der Schnittstelle können Sie Prüfungen für Leben in Deutschland mit der PrüfungLiDImport-Schnittstelle importieren.
Durch den Import werden für jeden Prüfling folgende Daten automatisch im BAMF Kontakt hinterlegt, anstatt diese manuell bei jedem einzeln einzutragen:
- verbrauchte Orientierungskursstunden
- LiD Prüfung am
- LiD Prüfung bestanden
Verwendung der Schnittstelle
Gehen Sie über die Zentrale Suche in das Objekt “Schnittstellen” und wählen Sie die Schnittstelle “PrüfungLiDImport” aus.
Ziehen Sie mit der Maus die Datei, die Sie importieren möchten, auf die Fläche die mit “Import Datei(en) hier hineinziehen!” beschriftet ist.
Alle Daten aus Ihrer Datei werden nun verarbeitet und die Prüfungsergebnisse in die BAMF-Applikation bestehender Kontakte eingetragen.
Die Zuordnung der Informationen zu den einzelnen Teilnehmern erfolgt anhand der BAMF-Kennziffer (Aktenzeichen / Wiederholer-Aktenzeichen).
Aufbau der Quelldatei
Für den Import können sowohl Excel (.xlsx) als auch CSV-Dateien verwendet werden. Beim Import werden die folgenden vier Spalten in der Tabelle ausfindig gemacht und eingelesen:
| Aktenzeichen | verbrauchte Orientierungskursstunden | LiD Prüfung am | LiD Prüfung bestanden |
| 12345 | ja | 08.08.2025 | ja |
| 12346 | nein | 08.08.2025 | nein |
Für den Import gelten folgende Regeln:
- Die Spalten sind verpflichtend
- Bei unvollständigen Daten wird eine Fehlermeldung ausgegeben und nichts importiert
- Lässt sich eine BAMF-Kennziffer / ein Aktenzeichen keinem Teilnehmerkontakt zuordnen, wird die jeweilige Zeile übersprungen und nichts importiert
- Die Reihenfolge der Spalten innerhalb der Datei ist beliebig
- Die Daten werden anhand des Spaltennamens zugeordnet
- Zusätzliche Spalten und Informationen der Quelldatei werden ignoriert
Einrichten der Schnittstelle
Die Schnittstelle ist bereits ausgeliefert, muss allerdings einmal in Ihrem System aktiviert bzw. eingerichtet werden.
Gehen Sie dazu bitte wie folgt vor:
- Öffnen Sie einen Report für das Objekt "Schnittstellen", am besten in dem Sie das Suchwort "Schnittstellen" in die Zentrale Suche eingeben und den ersten Eintrag wählen
- Klicken Sie auf "Schnittstelle erstellen"
- Wählen Sie nun aus der Auswahlliste den Eintrag "PrüfungLiDImport" aus (der Suchbegriff "LiD" ist hier hilfreich)
- Blättern Sie im Browser eine Seite zurück und kontrollieren Sie, ob die Schnittstelle nun im Report mit angezeigt wird