Welche Fahrt- und Passagieroptionen kann ich anbieten? – Wissensdatenbank

Die ioki Platform unterscheidet drei Bausteine, mit denen Fahrgäste ihre Fahrt beschreiben: Fahrtoptionen (gelten für die gesamte Fahrt), Fahrgastoptionen (gelten je Person) und Fahrgasttypen (beschreiben, wer mitfährt, und sind einer Tarifkategorie zugeordnet). Welche davon in Ihrem Produkt angeboten werden, ist produktspezifisch konfiguriert. Möchten Sie Änderungen vornehmen, kontaktieren Sie Ihre Ansprechpartnerin bzw. Ihren Ansprechpartner bei ioki.

Wozu dienen Fahrt- und Fahrgastoptionen?

Fahrt- und Fahrgastoptionen übersetzen den Bedarf eines Fahrgasts in eine Anforderung an das Fahrzeug. Fahrgäste geben bei der Buchung zum Beispiel an, ob sie einen Rollstuhlplatz, einen Platz für ein Fahrrad oder Stauraum für großes Gepäck benötigen. Der Vermittlungsalgorithmus prüft daraufhin, ob ein Fahrzeug verfügbar ist, das diesen Bedarf tatsächlich abdecken kann. Fahrgasttypen beschreiben zusätzlich, wer mitfährt. Über ihre Tarifkategorie können sie in der Preisberechnung unterschiedliche Tarife auslösen.

Was ist der Unterschied zwischen Fahrtoption, Fahrgastoption und Fahrgasttyp?

Baustein	Gilt für	Typische Beispiele
Fahrtoption	die gesamte Fahrt und damit alle Mitfahrenden gemeinsam	Fahrt für andere buchen, zusätzlicher Stauraum, großes Gepäck
Fahrgastoption	jede einzelne Person der Fahrt separat	Rollstuhl, Rollator, ÖPNV-Ticket, BahnCard, Kinderwagen, Hund, Fahrrad, Kindersitz
Fahrgasttyp	jede einzelne Person als Kategorie	Erwachsener, Kind, Kleinkind; produktspezifisch zum Beispiel Student oder Senior

Das entscheidende Unterscheidungsmerkmal ist der Geltungsbereich: Wählt ein Fahrgast die Fahrtoption „großes Gepäck“, reservieren alle Mitfahrenden gemeinsam den entsprechenden Stauraum. Die BahnCard dagegen ist eine Fahrgastoption, weil sie sich auf eine einzelne Person bezieht.

Faustregel für die Abstimmung mit ioki: „Betrifft die Angabe die ganze Fahrt oder eine einzelne Person?“ Das beantwortet fast immer, ob eine Fahrtoption oder eine Fahrgastoption gebraucht wird.

Wie wirken Optionen auf Fahrzeuge und Vermittlung?

Jede Fahrtoption, jede Fahrgastoption und jeder Fahrgasttyp hat einen hinterlegten Ressourcenverbrauch. Fahrzeuge wiederum haben eine oder mehrere Innenraumkonfigurationen, in denen dieselben Ressourcen als verfügbare Kapazität hinterlegt sind. Der Vermittlungsalgorithmus vergleicht Ressourcenverbrauch und Innenraumkonfiguration miteinander.

Kategorie	Enthaltene Ressourcen
Sitzplätze	Sitzplätze, medizinische Sitzplätze, Spezialsitzplätze
Für Kinder	Kindersitzerhöhung, Kindersicherheitssitz
Medizinische Hilfsmittel	Rollstuhlplatz, Stauraum für Rollstuhl, Rollatorplatz, Stauraum für Rollator
Stauraum	Koffer-Stauraum, Handgepäck-Stauraum, Fahrradträger, Tiertransportplatz, Stauraumeinheiten
Ausstattung	Steckdosen, WLAN
Freie Ressourcen	Ressource 1 bis Ressource 5

Ein Fahrgasttyp verbraucht standardmäßig einen Sitzplatz. Fahrtoptionen und Fahrgastoptionen starten standardmäßig bei null und erhalten nur dort einen Wert, wo tatsächlich Kapazität belegt wird.

Beispiel: Der Fahrgasttyp „Erwachsener“ hat einen Ressourcenverbrauch von Sitzplätze = 1 und Stauraumeinheiten = 2. Die einzige aktive Fahrzeugplanung ist einem Fahrzeug zugeordnet, dessen Innenraumkonfiguration Sitzplätze = 5 und Stauraumeinheiten = 1 vorsieht. Die Buchung wird mit dem Grund „Kein Fahrzeug verfügbar“ storniert, weil der Stauraum nicht ausreicht. In den Matching-Logs erscheint der Fehler overbooked_vehicle_resources.

Eine als buchbar markierte Fahrgastoption erscheint in der Buchung auch dann, wenn kein einziges Fahrzeug der Flotte die Option bedienen kann. Bei der Fahrtanfrage erscheint dann die Meldung, dass derzeit kein Fahrzeug mit den angeforderten Ressourcen bereitgestellt werden kann. Prüfen Sie deshalb vor jeder neuen Option, ob die Fahrzeuge die passende Ressource überhaupt hinterlegt haben.

Hat ein Fahrzeug mehrere Innenraumkonfigurationen, bleibt es vermittelbar, solange mindestens eine Innenraumkonfiguration die angeforderten Ressourcen abdeckt.

Welche Eigenschaften hat eine Option außer dem Ressourcenverbrauch?

Eigenschaft	Bedeutung	Gilt für
Name und Slug	Anzeigename und eindeutiger technischer Bezeichner (Kleinbuchstaben, Ziffern, Unterstrich, Bindestrich)	alle drei Bausteine
Datentyp	`boolean` für Ja/Nein (zum Beispiel Rollstuhl), `integer` für eine Anzahl (zum Beispiel großes Gepäck), `string` für eine Texteingabe	Fahrtoptionen, Fahrgastoptionen
Buchbar	Legt fest, ob die Option beziehungsweise der Fahrgasttyp für eine Buchung verwendet werden darf	alle drei Bausteine
Tarifkategorie	Ordnet den Fahrgasttyp einer Tarifklasse zu, zum Beispiel produktspezifisch „Schüler“ auf `reduced`	Fahrgasttypen
Symbol und Sortierschlüssel	Steuern Icon und Reihenfolge in der ioki Passenger App	alle drei Bausteine
Report-Spalte	Ordnet die Option einer auswertbaren Spalte im ioki Reporting zu; je Produkt höchstens eine buchbare Fahrtoption pro Spalte	Fahrtoptionen, Fahrgastoptionen
Sichtbarkeit für das Fahrpersonal	Steuert, ob die Fahrtoption in der ioki Vehicle App angezeigt wird; standardmäßig aktiv	Fahrtoptionen
Lokalisierte Texte	Name, Kurzinfo, Beschreibung und Link je Sprache. Bei Fahrgasttypen zeigt die ioki Passenger App nur Name und Kurzinfo (zum Beispiel Altersangabe „16+“) an.	alle drei Bausteine

Was bedeutet das für Sie im Alltag?

Sie legen Fahrtoptionen, Fahrgastoptionen und Fahrgasttypen nicht selbst an, sondern beauftragen die Änderung bei ioki. Damit die Umsetzung ohne Abstimmungsschleifen gelingt, liefern Sie am besten folgende Angaben mit:

Geltungsbereich: Soll die Angabe für die gesamte Fahrt gelten (Fahrtoption) oder je Person (Fahrgastoption)?
Anzeigename in allen benötigten Sprachen sowie eine optionale Kurzinfo.
Datentyp: Ja/Nein, Anzahl oder Freitext.
Ressourcenverbrauch: Welche Kapazität belegt die Option im Fahrzeug?
Bei Fahrgasttypen zusätzlich die gewünschte Tarifkategorie.
Reporting: Soll die Option als eigene Spalte auswertbar sein?
Bei Fahrtoptionen: Soll das Fahrpersonal die Option in der ioki Vehicle App sehen?

Im laufenden Betrieb prüfen Sie außerdem regelmäßig, ob Flotte und Optionsangebot zusammenpassen – insbesondere, wenn Fahrzeuge getauscht oder Innenraumkonfigurationen geändert werden.

Häufige Fragen dazu

Kann das Fahrpersonal Optionen einer bereits gebuchten Fahrt noch ändern?

Ja, sofern das Produkt die Funktion „Fahrgastanpassung nach der Buchung (Fahrer)“ unterstützt. Das Fahrpersonal kann in der ioki Vehicle App Anzahl, Fahrgasttyp und Fahrgastoptionen ändern, solange die Fahrt vom Fahrpersonal angenommen ist, kein Ticket gekauft wurde und die Zahlungskonfiguration der Fahrt die Änderung zulässt. Fahrtoptionen lassen sich nachträglich nicht ändern.

Werden bestehende Buchungen angepasst, wenn eine Innenraumkonfiguration verkleinert wird?

Nein. Bestätigte Fahrten bleiben unverändert und werden nicht erneut geprüft. Erst die nächste Aktion, die Ressourcen neu prüft, z. B. das Hinzufügen eines Fahrgasts oder die Annahme durch das Fahrpersonal, kann abgelehnt werden.

Tauchen Fahrgastoptionen im Reporting auf?

Ja. Fahrgastoptionen mit zugeordneter Report-Spalte erscheinen im operativen Report „Fahrgäste“ als eigene Spalten. Die angezeigten Spaltennamen lassen sich auf Provider-Ebene anpassen.