Webservice

Information für Drittanbieter:

Weiter unten finden Sie die aktuellen Informationen bezüglich der Schnittstelle zu Kita-Data-Webhouse (KDW).

Aus Sicherheitsgründen kann keine direkte Verbindung zu KDW zur Verfügung gestellt werden. Die Datenübertragung erfolgt ausschließlich per Ex-/Importdatei. Entweder über den Webservice oder über den Zugang des Trägers bzw. der Einrichtung, mittels Dateien in den Formaten „xml“ oder „csv“.

Für die von Ihnen für Ihre Anwender programmierte Exportdatei, müssen Sie sich exakt an unsere Beschreibungsdatei halten. Als KVJS nehmen wir prinzipiell keine Anpassungen unserer Schnittstellen auf Grund von Softwarelösungen durch Drittanbieter vor.

BITTE BEACHTEN:

Die Stichtagsmeldung findet immer zum 01.03. des aktuellen Jahres statt.

Kurzfristige Änderungen an der Schnittstelle behält sich der KVJS vor.

Durch den KVJS wird nicht über Änderungen an der Schnittstelle separat informiert.

Als Drittanbieter sind Sie angehalten sich eigenständig über Änderungen bzw. der Aktualität der Schnittstelle zu Informieren.


Per Webservice können die Daten von Einrichtung, Gruppen, Matrix (oder Kindern) und Personal per XML-Datei exportiert und importiert werden.

Benutzername und Kennwort werden über Basic Authentication abgefragt, die Daten sind in einer XML-Datei enthalten

Für den Inhalt einer XML-Datei gibt es die folgenden Varianten

Daten-Abfrage:

(Beispiel für Einrichtungsnummer 123456 und Stichtagsjahr 2023)
https://www.kitaweb-bw.de/kita/Einrichtung.xml?einrichtungsnummer=123456&stichtagsjahr=2023

Daten hochladen:

Über einen Aufruf analog der im unten angegebenen Upload-Feld (siehe Quelltext dieser Datei) kann eine Datei hochgeladen werden, ohne sich vorher manuell anzumelden.

Die Daten werden importiert und falls das fehlerfrei war, wird ein Meldungsabschluss erzeugt.

Die Rückgabe ist eine PDF-Datei, die entweder die Fehlermeldungen oder im Erfolgsfall das Bestätigungsdokument enthält. Bei Fehlern werden zusätzlich StatusCode 400 und als Response-Header die Fehlermeldungen im Header "fehler" und die Hinweise im Header "hinweise" zurückgegeben.