Anleitung · fahrschuldaten.de

So erfassen, veröffentlichen und melden Sie Ihre Daten auf fahrschuldaten.de

fahrschuldaten.de ist der Datenhub für Fahrschulen. Diese Anleitung führt durch den kompletten Ablauf im Cockpit: Konto und Einrichtung, Standorte pflegen, Preise erfassen, Aushang freigeben, Registermeldung vorbereiten und an die Stelle übermitteln.

1Empfohlener Ablauf

Ein veröffentlichter Preisstand speist Website-Widget, Partner-API und Registerdatei. Deshalb gilt: erst vollständig erfassen, dann freigeben, dann melden.

  1. 1

    Konto anlegen und E-Mail-Adresse bestätigen.

  2. 2

    Die Einrichtung durchlaufen: Betreiber, Tarif, Standorte, Klassen, Preise, Öffnungszeiten, Prüfen.

  3. 3

    Standorte im Standort-Hub nachpflegen (Stammdaten, Klassen, Kontakt, Öffnungszeiten).

  4. 4

    Preise als Entwurf erfassen — je Zelle Betrag oder Status, nicht 0 €.

  5. 5

    Den Preisaushang prüfen und veröffentlichen. Erst danach sind Widget, API und Register betroffen.

  6. 6

    Unter Registermeldungen die Standortliste prüfen und die Registermeldung vorbereiten.

  7. 7

    An die Stelle übermitteln, die Registerdatei laden und den Meldelauf als übermittelt dokumentieren.

Änderungen nach einer Veröffentlichung laufen immer über einen neuen Entwurf und eine neue Version — der live Aushang bleibt bis zur nächsten Freigabe unverändert.

2Einrichtung

Nach der Registrierung landen Sie in der Einrichtung. Das restliche Cockpit (Standorte, Register, Import) öffnet sich erst, wenn Sie die Einrichtung abschließen. Support und Einstellungen bleiben erreichbar.

  1. 1

    Konto und Fahrschule

    Registrieren Sie sich unter Registrieren, bestätigen Sie die E-Mail und legen Sie Ihre Fahrschule an. Ohne bestätigte E-Mail können Sie später nicht veröffentlichen oder API-Schlüssel erzeugen.

  2. 2

    Betreiber

    Legen Sie mindestens eine Betreibergesellschaft (Erlaubnisinhaber) an. Für den Status „Vollständig“ brauchen Sie Name, Rechtsform und Adresse. Jeder Standort muss später einem Betreiber zugeordnet sein — sonst ist keine Registermeldung möglich.

  3. 3

    Tarif

    Wählen Sie das passende Paket. Die Zahl veröffentlichbarer Standorte hängt vom Tarif ab. Ohne gebuchtes Paket können Freigabe und Registermeldung gesperrt sein.

  4. 4

    Standorte

    Legen Sie Betriebsstätten per Adresse an (Straße, PLZ, Ort) — einzeln oder per Datei. Ordnen Sie jedem Standort eine Betreibergesellschaft zu. Koordinaten werden in der Regel automatisch ermittelt.

  5. 5

    Klassen

    Geben Sie das Klassenangebot an (Pkw, Motorrad, Lkw …). In der Einrichtung gelten die Klassen zunächst für alle Standorte. Abweichungen einzelner Standorte richten Sie danach im Standort-Hub ein.

  6. 6

    Preise

    Erfassen Sie den Preisaushang einmal — er gilt zunächst für alle Standorte. Jede Zelle braucht einen Betrag oder einen Status (Nicht angeboten, Kostenfrei, Im Grundbetrag enthalten). Enter oder Tab speichert und springt weiter.

  7. 7

    Öffnungszeiten

    Öffnungszeiten sind optional, aber sinnvoll für den öffentlichen Aushang. Sie können zentral für alle Standorte gelten und später je Standort angepasst werden.

  8. 8

    Prüfen und abschließen

    Die letzte Seite zeigt, was vollständig ist und was noch fehlt. Pflichtangaben müssen stehen, bevor „Einrichtung abschließen“ greift. Danach werden Entwurfsstandorte aktiv und Sie landen im Dashboard.

Nach dem Abschluss bleiben Klassen, Preise und Öffnungszeiten je Standort änderbar. Die Einrichtung selbst erscheint nicht mehr im Kontomenü, die Datenpflege läuft über Standorte.

BeispielCockpit · Einrichtung
BeispielCockpit · Einrichtung prüfen

3Standortpflege

Unter Standorte sehen Sie alle Betriebsstätten mit Zustand, Preisstand und Meldestelle. Öffnen Sie einen Standort, um im Hub zu arbeiten — das ist der zentrale Ort für Stammdaten, Klassen, Preise und Meldungen.

BeispielCockpit · Standorte

3.1Standort-Hub

Jeder Standort hat dieselben Bereiche. Die Kopfzeile zeigt Lifecycle, Öffentlichkeit und Meldestelle getrennt — nicht vermischen.

BeispielCockpit · Standort-Hub
BereichInhalt
ÜbersichtDatenqualität, nächster Schritt, Kurzstatus
StammdatenName, Adresse, Kontakt, Öffnungszeiten, Betreiber
KlassenAngebotene Führerscheinklassen an diesem Standort
PreisaushangVeröffentlichter Stand und offener Entwurf
EinbettungWidget, öffentlicher Aushang, Einbettungscode
MeldungenRegistermeldungen dieses Standorts
VerlaufFachliche Historie der Änderungen

3.2Zustände eines Standorts

  • Entwurf — noch nicht aktiv, typisch während der Einrichtung.

  • Aktiv — der Standort wird betrieben und kann veröffentlicht und gemeldet werden.

  • Geschlossen — nicht mehr im Widget oder in der API-Liste; eine zuvor gemeldete Betriebsstätte wird als Stilllegung vorbereitet. Löschen nur bei nie genutzten Entwürfen.

  • Ersetzt — nach einem Zusammenführen bleibt der alte Datensatz lesbar, mit Verweis auf den Zielstandort.

Viele Standorte auf einmal: unter Import & Export Excel, CSV oder JSON übernehmen. Konflikte und Duplikate prüfen Sie vor der Übernahme. Eine Standortmatrix hilft, Klassen und Preise über viele Filialen hinweg anzugleichen.

4Preise erfassen

Jeder Standort hat höchstens einen live Aushang und optional einen Entwurf. Der Entwurf ist nur intern; Partner, Widget und Register sehen ausschließlich den veröffentlichten Stand.

BeispielCockpit · Preise erfassen (Klasse B)
  • Änderungen erzeugen oder aktualisieren den Entwurf. Der öffentliche Aushang ändert sich erst mit „Prüfen und veröffentlichen“.

  • Preispositionen werden beim Bearbeiten automatisch gespeichert — kein Extra-Speichern-Schritt.

  • Jede Zelle braucht einen Betrag oder einen Status: Nicht angeboten, Kostenfrei oder Im Grundbetrag enthalten.

  • 0 € ist kein gültiger Betrag. Nutzen Sie den passenden Status oder entfernen Sie die Angabe.

  • Im Aushang stehen Entgelte der Fahrschule. TÜV-, DEKRA- und Behördengebühren sind externe Gebühren und werden gesondert ausgewiesen, nicht als eigene Schulpreise.

4.1Aufbau des Aushangs

  1. 1

    Grundpreise — Grundbetrag, Theorie-Nachprüfung, Lernmittel

  2. 2

    Fahrstunden & Unterweisung — Fahrstunde, Unterweisung am Fahrzeug, Simulator; Varianten z. B. Automatik, Abend, Wochenende

  3. 3

    Besondere Ausbildungsfahrten — Sonderfahrten, wo die Klasse sie vorsieht

  4. 4

    Prüfungsvorstellungen — Theorie und Praxis bei TÜV/DEKRA

  5. 5

    Zusatzentgelte — Gebühren und Zuschläge der Fahrschule

  6. 6

    Pakete & Kurse — Festpreis-Pakete, Intensivkurse

  7. 7

    Aktionen & Rabatte — nicht im Standardvergleich

  8. 8

    Externe & amtliche Gebühren — nur Anzeige (TÜV, Behörde)

Nach der Einrichtung pflegen Sie Preise im Standort-Hub unter Preisaushang. Für viele Filialen mit gleichen Preisen nutzen Sie die Preismatrix. Bezeichnungen der Positionen sind vorgegeben, damit Aushänge vergleichbar bleiben.

BeispielÖffentlicher Aushang · Musterfahrschule

5Prüfen und veröffentlichen

Freigabe heißt: den Entwurf gegen Pflichtregeln prüfen, die Änderungen gegenüber dem live Aushang ansehen und den Preisstand festschreiben. Danach ist diese Version schreibgeschützt.

BeispielCockpit · Prüfen & veröffentlichen
  1. 1

    Im Standort-Hub unter Preisaushang den Entwurf öffnen und fehlende Pflichtpreise ergänzen.

  2. 2

    „Prüfen“ bzw. „Prüfen und veröffentlichen“ wählen.

  3. 3

    Datenprüfung, Preisprüfung und Vorschau durchgehen. Blocker (fehlende Pflichtpreise, fehlender Betreiber, leere Klassen) müssen weg.

  4. 4

    Die Auswirkungen ansehen: neuer öffentlicher Aushang, Widget und API ziehen den neuen Stand, eine Registermeldung wird vorbereitet.

  5. 5

    Veröffentlichung bestätigen. Der Entwurf wird zur live Version; weitere Änderungen brauchen einen neuen Entwurf.

Nach einer erfolgreichen Freigabe gilt:

  • Der öffentliche Preisaushang zeigt die neue Version.

  • Das Website-Widget kann aktiviert werden und bleibt mit dem Aushang synchron.

  • Die Partner-API liefert nur diesen veröffentlichten Stand — keine Entwürfe.

  • Der Standort erscheint unter Registermeldungen als prüf- und meldebereit, sobald kein offener Entwurf mehr vorliegt.

Mehrere Standorte auf einmal: über Sammelveröffentlichung. Tariflimits, fehlende Zahlung oder unvollständige Betreiberdaten können die Freigabe blockieren — dann zuerst unter Abrechnung bzw. Betreiber klären.

6Meldungsvorbereitung

Registermeldungen sind das Kontrollzentrum vor der Übermittlung an die Stelle. Erst prüfen, dann vorbereiten — nicht umgekehrt.

BeispielCockpit · Registermeldungen
  1. 1

    Öffnen Sie Registermeldungen. Die Übersicht zeigt, welche Standorte bereit sind, welche Entwürfe noch offen sind und ob Blocker existieren.

  2. 2

    Wählen Sie „Vor der Meldung prüfen“. Sie sehen Erstmeldungen, Änderungen und Stilllegungen mit Version und Preisdiff.

  3. 3

    Kontrollieren Sie die Liste. Standorte mit offenen Preisentwürfen sind in diesem Lauf nicht enthalten — zuerst freigeben.

  4. 4

    „Registermeldung vorbereiten“ erzeugt einen Meldelauf mit allen aktuell registerbereiten Standorten. Es darf nur eine offene Übermittlung gleichzeitig geben.

6.1Was einen Standort zurückhält

  • Offener Preisentwurf — erst prüfen und veröffentlichen.

  • Kein oder unvollständiger Erlaubnisinhaber am Standort.

  • Noch kein veröffentlichter Preisaushang.

  • Es existiert bereits eine offene Übermittlung — diese zuerst abschließen oder verwerfen.

BeispielCockpit · Standorte prüfen

7Meldung an die Stelle

Im Meldelauf übermitteln Sie die geprüften Standorte, laden die Registerdatei und dokumentieren, dass die Meldung erfolgt ist. So bleiben Versionen und Aktenzeichen nachvollziehbar.

Aktuell werden Registermeldungen nur simuliert. Es geht keine echte Meldung an eine Registerstelle, Behörde oder vergleichbare Stelle. Die Oberfläche, Referenzen (VORG-/MELD-) und die Registerdatei entsprechen dem späteren Ablauf.
  1. 1

    Im Meldelauf „An Register übermitteln“ wählen. Pro Standort entsteht eine Meldungs-ID.

  2. 2

    Nach der Übermittlung die Registerdatei herunterladen (Schema fahrschuldaten.register-batch.v1). Das ist die Datei für die Stelle — nicht dasselbe Format wie Widget oder Partner-API.

  3. 3

    „Meldelauf als übermittelt dokumentieren“. Damit ist der Lauf abgeschlossen; Versionen und Referenzen bleiben im Protokoll.

  4. 4

    Optional die Gesamt-Registerdatei laden: sie enthält den zuletzt gemeldeten Stand aller Standorte, nicht nur den letzten Lauf.

Die Registerdatei enthält Betreiber, Standortadresse, Klassen, Angebote und kanonische Preiszeilen. Widget und Partner-API nutzen fahrschuldaten.public-prices.v1, nicht diese Batch-Datei.

BeispielRegisterdatei · fahrschuldaten.register-batch.v1

Wenn Sie einen zuvor gemeldeten Standort schließen, erscheint er im nächsten Lauf als Stilllegung (DEACTIVATE). Zusammengeführte Standorte werden ersetzt; der Quellstandort wird stillgelegt, der Zielstandort bleibt die gültige Identität.

8Hinweise

  • Öffentlichkeit, Widget, API und Register sehen nur veröffentlichte Stände — niemals Entwürfe.

  • Jede Freigabe erzeugt eine nachvollziehbare Version. Der live Aushang ist schreibgeschützt.

  • E-Mail bestätigen, bevor Sie veröffentlichen oder API-Schlüssel anlegen.

  • Paket, Standortlimit und Zahlungsmethode müssen passen, sonst sind Freigabe und Meldung gesperrt.

  • Mitglieder und Rollen verwalten Sie unter Team. Integrationen (Widget, Partner-API) liegen unter Integrationen.

Fragen zum Ablauf oder ein technisches Problem: Support-Ticket im Cockpit · Partner-API für Integratoren