Skip to main content
Diese API befindet sich im Testing. Produktive Nutzung wird noch nicht empfohlen.
Über die ÖPNV-Ticket-Module von Business OS kannst du ÖPNV-Tickets (Deutschlandticket, Jobticket, etc.) programmatisch erstellen, verwalten und abrechnen. Die Anbindung erfolgt über die Mobility Box API und unterstützt Einzel- sowie Abonnement-Tickets.

Übersicht der Services

Kundenverwaltung

Unternehmen als Kunden anlegen und verwalten. Kunden sind die Grundlage für die Zuordnung von Tickets und die Sammelabrechnung.

Tickets

Tickets erstellen, aktivieren, verlängern und kündigen. Unterstützung für Apple Wallet und Google Wallet.

Rechnungen

Sammelrechnungen für alle offenen Tickets eines Kunden erstellen und als PDF herunterladen.

Unterstützte Ticket-Typen

Ticket-TypBeschreibungAbo-fähig
DeutschlandticketBundesweites 49-Euro-Ticket
JobticketArbeitgeber-subventioniertes ÖPNV-Ticket
EinzelticketsEinmalige Fahrscheine je nach Tarifgebiet

Übersicht der Module

ResourceReadCreateUpdateDelete
Produkte & Gebiete
Kunden
Tickets
Rechnungen

Ablauf

1

Produkte suchen

Durchsuche verfügbare ÖPNV-Produkte nach Tarifgebiet, Stadt oder Koordinaten über den Products-Endpoint.
2

Kunde anlegen

Erstelle einen Kunden (Unternehmen) mit Rechnungsadresse. Dieser wird für die Ticket-Zuordnung und Sammelabrechnung benötigt.
3

Ticket buchen

Erstelle ein Ticket mit der gewünschten product_id und optionaler customer_id. Das Ticket wird automatisch aktiviert.
4

Wallet hinzufügen

Lade das Ticket als Apple Wallet Pass (.pkpass) oder Google Wallet Link herunter.
5

Abrechnung

Erstelle am Monatsende eine Sammelrechnung für alle offenen Tickets eines Kunden.

Verbrauch

Für das Erstellen und Verlängern von Tickets wird jeweils 1 Credit berechnet. Alle anderen Operationen (Produkte abrufen, Kunden verwalten, Rechnungen erstellen) sind kostenfrei. Deinen detaillierten Verbrauch kannst Du in deinem Dashboard ansehen.