FAQ

Häufig gestellte Fragen und Antworten

Auf dieser Seite beantworten wir häufig gestellte Fragen zu unseren Schnittstellen der Infodienste und zur Zertifizierung, die Voraussetzung zur Nutzung der Schnittstellen ist. Wenn Ihre Frage hier nicht beantwortet wird, können Sie sich natürlich gern an unseren Support unter support@teleport.de wenden.

Muss jeder Punkt auf der Checkliste der Zertifizierung umgesetzt werden?

Nein. Wir werden nur dass zertifizieren, was Sie auch umgesetzt haben. Wir werden auch keine Kontrolle von Code oder internen Umsetzungen bei Ihnen machen. 

Sind neue Schnittstellen geplant?

ID SOAP XZuFi 2.3.1

  • lesend Q4 2025
  • schreibend Q1 2026

ID REST ZUFI V5

  • In Konzeption
  • Richtet sich zum Teil nach XZuFi 2.3.1 Fertigstellung
  • Planung geht gegen Mitte 2026

ID REST SUE

  • In Konzeption
  • Kein genaues Ziel

Wann werden welche Schnittstellen abgeschaltet?

Abschaltung ID REST ZUFI V3

  • 31.01.2024 (teilweise in einigen Ländern bis 31.03.2024 verlängert)
  • Weitere Informationen gab es bereits via E-Mail

Abschaltung SOAP WS V6_30

  • 30.06.2024 Ende des Supports
  • Weitere Informationen gab es bereits via E-Mail

Welchen Schnittstellenversionen sind aktiv im Einsatz?

Lesend

  • ID SOAP XZuFi 2.2.0
  • ID SOAP XZuFi 2.3.1
  • ID REST ZUFI V4
  • ID REST GD (Gebietsverwaltung)
  • ID REST KR V2 (Kommunales Recht)
  • ID REST VHK (Vorhabensklärung)
  • ID REST Open311 (Sag's uns einfach)

Schreibend

  • ID SOAP XZUFI 2.2.0
  • ID REST Open311 (Sag's uns einfach)

Warum haben die Schnittstellen unterschiedliche IDs für Gebiete?

Vor einigen Jahren wurde in den Infodiensten der Linie6Plus ein zentraler Gebietsservice eingeführt. Da jedes Bundesland seine eigenen Gebiete gepflegt hat, konnten wir bestehende Gebiete nicht einfach in die zentrale Verwaltung aufnehmen, da es zu doppelten IDs kommen könnte. Um dies zu verhindern wurde in der Gebietsdatenverwaltung jedes Gebiet neu angelegt, um so die Eindeutigkeit zu gewährleisten.
 

Die neuen Schnittstellen (ID REST ZUFI V4, ID REST GD, ID SOAP XZuFi) verwenden nur noch die neuen IDs. Der XZuFi-Webservices zum Beispiel, arbeitet mit den neuen Gebiet-IDs (primäre ID laut XZuFi Standard) und gibt im Element idSekundaer aus dem alten Gebietsservice noch die alten ID aus, damit zukünftig die Hersteller bei der Umstellung vom SOAP V6_30 auf XZuFi-WS sich selbst ein Matching mit Ihren Gebieten vornehmen können.
 

Der dynmaische Gebiet-ID-Parameter bei Onlinedienst ist standardmäßig die neue Gebiet-ID.

Wie lange dauert es bis Daten in den Schnittstellen sichtbar sind?

In der Regel haben wir maximal einen Zeitverzug von 15 Minuten, bis ein Objekt nach dem Veröffentlichen oder Schreiben bei lesenden Anfragen/Methoden sichtbar ist. In manchen Systemen kann es, je nach Zeitpunkt, zu leichten Verzögerungen kommen, wenn gerade viele Objekte zur gleichen Zeit veröffentlicht werden.

Ist der XZuFi-Standard zu 100% umgesetzt?

Das Redaktionssystem der IDv5 richtet sich zwar nach dem XZuFi-Standard, kann aber nicht alles erfüllen und bietet zum Teil noch mehr Objekte und Funktionen an, die es in XZuFi nicht gibt. Beispielweise gibt es in der Redaktion Pflichtfelder, welche in XZuFi optional sind. Diese müssen bei einer Übertragung trotzdem gesetzt werden. Der Standard muss nicht zu 100% inhaltlich erfüllt werden. Austauschende Systeme können ebenfalls noch weitere Dinge definieren. Einige dazu finden Sie hier in der XZuFi-Schnittstellenbeschreibung unter dem 5. Punkt.

Das Redaktionssystem wird im Laufe von 2024 weiter Richtung XZuFi-Konformität angepasst, kann aber nie zu 100% alle Klassen und Objekte aus XZuFi unterstützen. Einige Dinge sind nicht für die Landesredaktionen der Linie6Plus möglich oder relevant. 

Ich kann keine funktionierenden Anfragen in SoapUI starten. Woran liegt das?

Seit der Einführung des ID SOAP XZuFi haben wir festgestellt, dass es im Umgang mit SoapUI folgende Probleme gibt:

- Beim Service Endpoint steht "http" statt "https".

- Beim Service Endpoint sind Leerzeichen nach dem API-Key.

- Beim Service Endpoint ist kein Passwort hinterlegt. Auch wenn Sie keines brauchen, muss bei SoapUI irgendwas dort ausgefüllt werden.

- Beim Service Endpoint ist beim WSS-Type nicht "PasswordText" angegeben.

- Bei der Anfrage sind Pflichtfelder nicht ausgefüllt, wie zum Beispiel: produktbezeichnung="XZuFi Beispiel"; produkthersteller="Teleport"; xzufiVersion="2.2.0".

Werden meine Daten automatisch übersetzt?

Alle Länder der Linie6Plus übersetzen ihre Daten über DeepL. Die Sprachen hängen vom jeweiligen Bundesland ab und können über Anfrage.Sprachen abgerufen werden. Sollten Sie nicht wünschen, dass Ihre Daten übersetzt werden, wenden Sie sich bitte an unseren Support. Das können wir pro API-Key und Objekt steuern.

Wie ist die ID REST ZUFI V4 an den PVOG angebunden?

Es gibt 3 Fälle, wenn Sie Daten mit Gebieten anfragen:

  1. Ihr Gebiet liegt innerhalb das eigenen Bundeslandes, dann werden die Daten direkt aus dem Landessystem von dem Sie aus angefragt haben, ausgegeben. 
    Zum Beispiel: ID REST ZUFI V4 in Hessen wurde mit dem Gebiet Kassel angefragt und dann werden Objekte aus dem Redaktionssystem Infodienste Hessen übertragen.
  2. Ihr Gebiet liegt außerhalb das eigenen Bundeslandes, aber innerhalb vom Verbund der Linie6Plus, dann werden die Daten direkt aus den Landessystemen der anderen Länder und deren ID REST ZUFIs ausgegeben. 
    Zum Beispiel: ID REST ZUFI V4 in Hessen wurde mit dem Gebiet Halle (Saale) angefragt und dann werden Objekte aus dem Redaktionssystem Infodienste Sachsen-Anhalt über die ID REST ZUFI V4 in Sachsen-Anhalt an die ID REST ZUFI V4 in Hessen übertragen.
  3. Ihr Gebiet liegt außerhalb das eigenen Bundeslandes und außerhalb vom Verbund der Linie6Plus, dann werden die Daten aus dem PVOG über die Suchdienst-API abgefragt.
    Zum Beispiel: ID REST ZUFI V4 in Hessen wurde mit dem Gebiet Leipzig angefragt und dann werden Objekte aus dem Datenbestand des PVOG von Sachsen/Leipzig an die ID REST ZUFI V4 in Hessen durch den PVOG Suchdienst übertragen. 

Gibt es Matching-Übersicht der Daten aus den verschiedenen TSA-Quellen?

Ja, diese können Sie hier herunterladen: Klick

Wie ist die Struktur der Versionsnummer von neuen APIs?

In den neuen Schnittstellen der TSA verwenden wir ab sofort eine neue Struktur für die Versionen. Dies sieht wie folgt aus: 1.2.3.4

1. Major-Version, die nur erhöht wird, wenn die API von Grund auf oder im Datenmodell geändert wird.

2. Minor-Version für Feature-Releases.

3. Bug-Fix-Version für Wartungen und Fehlerbehebung.

4. Hotfix-Version für Hotfixes, die bei kritischen Fehlern sofort und ohne Release Notes in Systemen behoben werden müssen und im Live-Betrieb schnell aktualisiert werden.