====== Transparenzdatenbank ======

Gemäß Transparenzdatenbankgesetz (TDBG) haben leistende Stellen Daten über den Staus
der Gewährung eines Förderfalls und der ausbezahlten Leistungen an die
Transparenzdatenbank zu übermitteln. Die Übermittlung der Leistungen hat elektronisch zu
erfolgen, der Zugang der leistenden Stellen erfolgt über das Internet, geschützt durch
Portalverbundprotokoll.\\

Zuwendungen an Studierende müssen an die Transparenzdatenbank gemeldet werden. Dies betrifft zB die Auszahlung von Leistungsstipendien oder die Übermittlung von Erasmus Zuschüssen.\\

Zu diesem Zweck wurde die Extension für die Transparenzdatenbank entwickelt um die Meldung der Daten zu automatisieren.\\

https://github.com/FH-Complete/FHC-Core-TDB

Allgemeine und Technische Informationen zur Meldung der Daten findet sich unter folgender Seite:

Technisch-organisatorisches Infopaket
https://transparenzportal.gv.at/tdb/tp/seite_technischesInfopaket

===== Voraussetzung für die Meldung der Daten =====

  * Webservice User für Zugriff auf die Transparenzdatenbank
  * Verschlüsseltes BPK des Studierenden
  * Leistungsstipendium in FH-Complete erfasst

===== Webservice User erstellen =====

Damit die Meldung der Daten möglich ist muss ein Webservice User für die Transparenzdatenbank erstellt werden. Die Anlage des Users erfolgt über das Unternehmensserviceportal.

Möchte eine Stelle Leistungen per Webservice über USP mitteilen, muss die Anwendung
Transparenzdatenbank Webservices für den USP-Teilnehmer freigegeben werden. In der
Folge kann der USP-Admin des Teilnehmers unter „meine Services“ Benutzer berechtigen.
Folgende Rollen können zugeteilen werden:\\

  * Leistungsdaten über Web Service übermitteln
  * Leistungsangebote über Web Service abfragen

Details dazu siehe:
https://transparenzportal.gv.at/tdb/resources/cms/20220901_Leitfaden_TDB_Berechtigungen_USP.pdf

===== Konfiguration der Extension ===== 

Die Extension für die Transparenzdatenbank wird installiert gemäß Anleitung für Extension installation.
Danach muss das Config File entsprechend angepasst werden.
tdb.php.ex wird als Vorlage übernommen und entsprechend befüllt.

<code>
$config['uebermittlungs_id'] = 'UEB-FHXYZ-TDB-';
$config['vkz'] = '<VKZ der Firma im Format: XZVR-123456789>';
$config['name_lst'] = '<Name der Organisation>';
$config['leistungsangebot_id'] = '1007202'; //1007202 in Prod 1047349 in Test
$config['foerdergegenstand'] = 'F2840Q1006'; //Studienerfolg - nicht zuordenbar
$config['foerderfall_status'] = 'gewaehrt';
$config['kontakt'] = '<NAME DES ANSPRECHPARTNERS>';
$config['kontakt_email'] = '';
$config['kontakt_tel'] = '';
$config['leistungsbezeichnung'] = 'Leistungsstipendium';
$config['buchungstyp'] = ['Leistungsstipendium'];
$config['szr_enabled'] = false; //false = BPKs werden aus core Tabelle geholt // true = BPKs werden aus der extension tabelle geholt

//API
$config['username'] = '<USERNAME>';
$config['password'] = '<PASSWORT';
$config['endpoint'] = 'https://txm.portal.at/at.gv.bmf/tdb/tdbFoerderfallLeistungsdatenws';
$config['buchungsdatum'] = '2024-09-01'; //alle Leistungsstipendien vor dem Buchungsdatum werden nicht übertragen
$config['test_foerderfall'] = false; //true = Förderfälle werden nicht gespeichert; false = Förderfälle werden gespeichert
$config['test_uebermittlungsid'] = 'Test-Call-05-09-2022-1';
</code>
Da wir über das USP melden gibt es keine Testumgebung, es ist jedoch möglich in der Config-Datei tdb.php den Configeintrag „test_foerderfall“ auf true zu setzen. Der Förderfall wird dann nicht gespeichert.

==== Ermittlung der VBPKs ====

Die Ermittlung der verschlüsselten BPK für die Meldung der Daten erfolgt in der Regel über den Datenverbund. (Siehe dazu DUVH Extension)

Es werden verschlüsselte BPKs für folgende Bereiche bzw. Behörden benötigt:
  * AS / BBA-STA
  * ZP-TD / BMF


Alternativ kann die Ermittlung der BPK über das Stammzahlenregister erfolgen. Hier ist jedoch eigene Zugangsdaten erforderlich und wird über srz.php Config abgewickelt. Diese Variante ist jedoch nicht mehr nötig da seit 2025 alle Daten vom Datenverbund übermittelt werden.

==== Erfassung der Leistungsstipendien innerhalb von FH-Complete ====

Die Auszahlung der Leistungsstipendien wird im FH-Complete im Karteireiter Konto erfasst. Hier wird ein Eintrag mit typ Leistungsstipendium erstellt mit entsprechendem Betrag (zB 750€), Datum und dazu passender Gegenbuchung.

==== Meldung der Daten ====

Unter Personen->Transparenzdatenbank kann eingesehen werden welche Personen melderelevante Daten haben und ob diese bereits gemeldet wurden oder nicht und ob alle nötigen Informationen vorhanden sind.

Die Meldung selbst erfolgt per Scheduler / Job.
Zum melden der Daten gibt es einen Scheduler und einen Job:

Scheduler: 
<code>php index.ci.php extensions/FHC-Core-TDB/jobs/JQMScheduler newFoerderfaelle</code>
Worker: 
<code>php index.ci.php extensions/FHC-Core-TDB/jobs/ManageFoerderfaelle newFoerderfaelle</code>

==== Sonstige Hinweise ====

Aktuell werden nur Leistungsstipendien übermittelt. Erasmusförderungen werden manuell in der TDB erfasst da die Zuordnung der Ratenzahlung derzeit noch nicht automatisiert wurde.