Einbuchen aus externen Systemen

Alle Calls der Buchungs-Api werden an xml.php gesandt.

Direkt einbuchen

Um eine Fahrt direkt einzubuchen, werden diese Parameter mit einem POST-Call übergeben

ParameterBezeichnungBemerkung
aktionGibt die Aktion anPflichtparameter. Ist fix “einbuchen”.
klasse_idBuchungsklassePflichtparameter. Erhält man vom Anbieter, z.B. 1
tarif_idID des Tarifs.Pflichtparameter. Erhält man vom Anbieter, z.B. 1
waehrung_idID der WährungPflichtparameter. 1 für EUR
aktion_idID einer SonderaktionOptional
buchungscodeBuchungsnummer, die auf dem externen System erzeugt wird.Optional. Varchar.
verkaufsstelle_idID der VerkaufsstelleOptional
user_idBenutzer-ID des Anlage-UsersOptional, z.B. die ID eines Mitarbeiters.
tokenXML-TokenWird vom Anbieter bereitgestellt. Pflichtparameter
handy_nrHandy-Nr des KundenOptional
tempAngabe ob temporäre Buchung1 für true, 0 für false
zahlart_idID der ZahlartPflichtparameter. Erhält man vom Anbieter.
linie_idID der Linie für die HinfahrtOptional wenn linie_hafen_fahrplan_id
rueckfahrt_linie_idID der ZahlartOptional wenn die Rückfahrt angelegt wurde
datum_hinfahrtDatum der HinfahrtPflichtparameter. Im Format dd.mm.yyyy
rueckfahrtAngabe ob einfache Fahrt- oder Hin-und RückfahrtPflichtparameter. 1 für nur Hinfahrt, 2 für Hin- und Rückfahrt
datum_rueckfahrtDatum der RückfahrtPflichtparameter wenn Rückfahrt gewählt. Im Format dd.mm.yyyy
datum_hinfahrt_uhrzeitUhrzeit der HinfahrtOptional. Uhrzeit der Rückfahrt mm:hh
datum_rueckfahrt_uhrzeitUhrzeit der RückfahrtOptional. Uhrzeit der Rückfahrt mm:hh
hafen_umstieg_idID der Station bei Umstiegsverbindungen.Optional. Das System sucht dann die passenden Fahrten und bucht die Verbindung entsprechend ein.
dataJSON Array mit den gewählten PositionenPflichtangabe. Als JSON-String übergeben, die API decodiert anschließend den String.

Aufbau des data JSON Arrays

In data sind die einzelnen Positionen zu der Buchung enthalten

ParameterBezeichnungBemerkung
typAngabe des Positionstyps.Pflichtangabe.Preistyp: preistypAusstattung: ausExtra / Zusatz: extra
ds_id ID des Datensatzes
anzahl Pflichtangabe. Anzahl der Positionen
bezeichnung Pflichtangabe. Bezeichnung der Position
einzelbetrag Pflichtangabe. Brutto-Einzelbetrag der Position
mwst_satz Pflichtangabe. MwSt. Satz, z.B: 19 für 19%

Der Aufruf gibt ein JSON Objekt mit FALSE zurück, wenn die Eintragung nicht erfolgreich war, beispielsweise wurden die Plätze mittlerweile andersweitig geblockt. Es wird TRUE und die Reservierung-ID zurückgegeben, wenn die Reservierung erfolgreich war.

Beispielaufruf

Der Beispielaufruf zeigt die Parameter der Buchung mit Beispielwerten.

ParameterBeispielwert
aktioneinbuchen
aktion_id0
buchungscode0815ABCDEFG
data[{“typ”:”preistyp”,”ds_id”: 1,”anzahl”:3,”bezeichnung”:”Erwachsener”,”einzelbetrag”:29.4,”mwst_satz”:0},{“typ”:”aus”,”ds_id”: 1,”anzahl”:2,”bezeichnung”:”Fahrrad”,”einzelbetrag”:0,”mwst_satz”:0},{“typ”:”gesamt”,”betrag”:88.20}]
datum_hinfahrt23.02.2015
datum_rueckfahrt23.02.2015
drucker_id1
hafen_start_id1
hafen_stop_id7
hafen_umstieg_id0
handy_nr 
klasse_id1
linie_id2
rueckfahrt_linie_id (optional)3
linie_hafen_fahrplan_id2322
preis_drucken1
rueckfahrt2
tarif_id1
user_id1
verkaufsstelle_id1
waehrung_id1
zahlart_id4
GDPR Cookie Consent with Real Cookie Banner