Zum Hauptinhalt springen

Kplus: Wiederverkäufer-Verbindung

Verbinden Sie Kplus mit Ventrata, um Verfügbarkeit und Preise zu synchronisieren und Buchungen sofort zu erhalten. Reisebüros, die Touren zusammen mit Flügen und Hotels verkaufen.

Kplus logo

 

Kplus ist ein 2013 gegründetes türkisches Reisetechnologie-Unternehmen, dessen Plattform Travelrobot Reservierungen für Flüge, Hotels, Transfers, Mietwagen, Touren und dynamische Pakete für B2B-Konsolidatoren, Firmenreisemanager, Unteragenturen und Endkunden-Websites abwickelt. Nach eigenen Angaben hat es mehr als 300 Kunden und über 100.000 Transaktionen pro Tag. Betreibern bringt es Nachfrage aus der türkischen Reisebranche – Agenturen, Reiseveranstalter und Firmenreise-Einkäufer, die Touren und Tickets neben Flügen und Hotels verkaufen – sowie Endkunden-Ticketseiten wie Parkbileti.

 

Wenn Sie Kplus mit Ventrata verbinden, werden Ihre Verfügbarkeit und Preise synchronisiert, und Buchungen, Änderungen und Stornierungen werden übermittelt, wobei Tickets automatisch ausgestellt werden.

 

Weitere Informationen zu einer Partnerschaft mit Kplus finden Sie unter kplus.com.tr.

 

Hauptwebsite

Tags

B2B Marketplace

Zielmärkte

🇹🇷 Türkei

Quellmärkte

🌎 Weltweit

Schwerpunkte

Agenturen, die Touren neben Flügen und Hotels verkaufen

Verbindungsfunktionen

Availability Sync · Pricing Sync · Bookings Sync

Entwickelt von

 

Mit dieser Wiederverkäufer-Verbindung verkaufen Sie Ihre Produkte über Kplus, ohne Verfügbarkeit, Preise und Buchungen manuell verwalten zu müssen. Zu den Funktionen dieser Verbindung gehören:

  • Availability Sync – Kplus prüft Ihre aktuelle Verfügbarkeit in Ventrata.

  • Pricing Sync – Kplus erhält Ihre Preise aus Ihrer Wiederverkäufer-Preisgestaltung in Ventrata.

  • Bookings Sync – Buchungen, Änderungen und Stornierungen von Kplus werden sofort in Ventrata angelegt, und Kunden erhalten Ventrata-Tickets.

 

Kplus-Verbindung erstellen

🔐 Erforderliche Rollenberechtigungen: See Connections, Modify Connections, See Connection Key

Bevor Sie beginnen:

  • Sie benötigen eine Handelsvereinbarung mit Kplus, damit Ihre Produkte dort verkauft werden. Wenn Sie an einer Partnerschaft interessiert sind, kontaktieren Sie den Partner über kplus.com.tr.

  • Sie müssen Kplus als Wiederverkäufer in Ventrata angelegt haben, mit korrekt definierten Preisen (Verkaufspreis, Großhandel/Provision). Beachten Sie, dass diese API-Verbindung voraussetzt, dass für den Wiederverkäufer die Abrechnungsmethode „Rechnung auf mein Konto“ (Bill to my account) eingestellt ist.

 

  1. Gehen Sie im Ventrata Dashboard zu Verbindungen → Verbindungen (Connections → Connections), klicken Sie auf + Neue Verbindung (+ New Connection) und wählen Sie Kplus aus der Partnerliste aus.

  2. Wählen Sie Wiederverkäufer Kplus aus der Liste Ihrer Wiederverkäufer aus (muss vor dem Erstellen der Verbindung angelegt sein). Die Verbindung übernimmt die Konfiguration des Wiederverkäufers, etwa Preise, zugelassene Destinationen, Produkte usw.

  3. (Optional) Sie können der Verbindung auch einen Namen Ihrer Wahl geben. Das ist hilfreich, wenn Sie mehrere Kplus-Verbindungen planen und diese später leichter unterscheiden möchten.

  4. Klicken Sie auf die Schaltfläche Octo-Verbindung erstellen (Create Octo Connection).

 

📗 TIPP

Bei Bedarf können Sie zusätzlich zu den Einstellungen beim Wiederverkäufer auch auf Verbindungsebene Produkte oder Destinationen zulassen oder ausschließen.

 

Produkte Kplus zuordnen

Teilen Sie den OCTO-API-Schlüssel, der in der erstellten Verbindung angezeigt wird, auf sicherem Weg mit Ihrem Ansprechpartner bei Kplus und bitten Sie ihn, Ihre Produkte über die OCTO API von Ventrata mit aktivierten Preisen (octo/pricing) zuzuordnen. In der Regel dauert es nicht länger als einige Werktage, bis das Kplus-Team dies erledigt hat.

 

Ihre Konfiguration in Ventrata ist abgeschlossen. Weitere Schritte sind nicht erforderlich.

 

📗 TIPP

Kplus kann auf alle in der Verbindung aktivierten Produkte zugreifen. Sie können bei der Kontaktaufnahme aber auch die Produkt- und Options-IDs von der Verbindungsseite angeben, um festzulegen, was zugeordnet werden soll.

 

 

Kplus-Verbindung verwalten

  • Produkte zulassen oder ausschließen: Legen Sie fest, auf welche Destinationen, Produkte und Optionen Kplus zugreifen kann. Siehe Produkte zulassen oder ausschließen.

  • Benennen Sie die Verbindung um, um mehrere Kplus-Verbindungen auseinanderzuhalten.

 

Verbindungsfunktionen im Detail

Dieser Abschnitt richtet sich an alle, die genau wissen möchten, wie die Kplus-Verbindung funktioniert: welche Aufrufe Kplus an die Ventrata OCTO API sendet, wann diese erfolgen und was das für Sie bedeutet. Jeder Aufruf ist mit der API-Dokumentation von Ventrata verlinkt.

 

Kurz gesagt: Kplus ruft alles, was es benötigt, aus Ventrata ab. Es liest Ihre Produkte, prüft Ihre Verfügbarkeit und Preise und sendet Buchungen und Stornierungen. Ventrata überträgt Änderungen nicht aktiv an Kplus; alles, was Sie in Ventrata ändern, erreicht Kplus also bei der nächsten Abfrage.

 

Product Mapping

❌

Sie können Produkte nicht in Ventrata zuordnen. Kplus ordnet sie auf seiner Seite zu, über Ihren Account Manager oder das Portal von Kplus.

Das funktioniert wie folgt:

  • Get Products (GET /products) – Wenn Kplus Ihre Verbindung einrichtet und immer dann, wenn es seine Angebote aktualisiert, liest es jedes in der Verbindung aktivierte Produkt mit seinen Optionen und Einheiten (Tickettypen wie Erwachsener oder Kind).

  • Get Product (GET /products/{productId}) – Kplus liest ein einzelnes Produkt erneut ein, um Änderungen an Optionen, Einheiten, Buchungsschlusszeiten und Einstellungen zu übernehmen.

  • Zuordnung auf der Seite von Kplus – Kplus verknüpft jede Ventrata-Option und -Einheit mit seinem eigenen Angebot und seinen Tickettypen. Ihr Account Manager bei Kplus erledigt das für Sie, oder Sie tun es im eigenen Portal von Kplus, falls Kplus eines anbietet. Sie teilen nur den API-Schlüssel der Verbindung.

 

Was das für Sie bedeutet: Kplus kann nur verkaufen, was zugeordnet ist. Wenn Sie in Ventrata ein Produkt, eine Option oder eine Einheit hinzufügen, sieht Kplus dies möglicherweise bei der nächsten Aktualisierung, verkauft es aber erst nach der Zuordnung. Informieren Sie daher Ihren Account Manager bei Kplus, wann immer Sie etwas hinzufügen.

Content Sync

❌

Kplus liest Ihre Produktinhalte nicht aus Ventrata.

Kplus verwendet die Beschreibungen, Bilder und sonstigen Inhalte, die auf seiner eigenen Seite eingerichtet sind. Aktualisieren Sie Ihre Inhalte daher direkt bei Kplus.

Availability Sync

✅

Kplus prüft Ihre aktuelle Verfügbarkeit in Ventrata. Ventrata überträgt Verfügbarkeitsänderungen nicht aktiv an Kplus.

Das funktioniert wie folgt:

  • Availability Check (POST /availability) – Kplus sendet ein Produkt, eine Option und ein Datum oder einen Datumsbereich. Ventrata antwortet mit jedem buchbaren Tag oder Zeitfenster, dessen Status (AVAILABLE, LIMITED, SOLD_OUT, CLOSED oder FREESALE), den verbleibenden freien Plätzen, dem Buchungsschluss und einer availabilityId, die Kplus zum Buchen dieses Zeitfensters benötigt.

  • Availability Calendar (POST /availability/calendar) – liefert eine Zusammenfassung pro Tag statt jedes einzelnen Zeitfensters, typischerweise um in einer Datumsauswahl anzuzeigen, welche Termine offen sind.

  • Prüfung bei der Buchung – Wenn ein Kunde bucht, prüft Ventrata die Kapazität erneut, bevor die Buchung angelegt wird. So kann Kplus ein gerade ausverkauftes Zeitfenster nicht überbuchen, selbst wenn die gespeicherte Verfügbarkeit leicht veraltet ist.

 

Was das für Sie bedeutet: Wenn Sie in Ventrata ein Datum schließen, die Kapazität ändern oder ausverkauft sind, zeigt Kplus dies erst nach der nächsten Abfrage an, sodass es eine kurze Verzögerung geben kann. Die Prüfung bei der Buchung durch Ventrata verhindert dennoch Überbuchungen.

Pricing Sync

✅

Ihre Preise werden bei jeder Verfügbarkeitsabfrage mitgeliefert, sobald Kplus sie mit der Capability octo/pricing anfordert.

Das funktioniert wie folgt:

  • octo/pricing-Capability – Kplus fordert Preise an, indem es octo/pricing in den Header Octo-Capabilities seiner Anfragen aufnimmt. Ohne diese Angabe sendet Ventrata die Verfügbarkeit ganz ohne Preise.

  • Availability Check (POST /availability) – Bei aktivierten Preisen wird jeder Tag bzw. jedes Zeitfenster mit Ihrem Preis pro Einheit (Tickettyp) zurückgegeben: dem Verkaufspreis (retail), den der Kunde zahlt, und dem Nettopreis (net), den Sie Kplus in Rechnung stellen, beide aus der Wiederverkäufer-Preisgestaltung in Ventrata (Verkaufspreis und Großhandel/Provision).

  • Gruppenpreise – Wenn Kplus zusätzlich mitteilt, wie viele Personen pro Einheitstyp buchen, berechnet Ventrata den Preis für genau diese Gruppe. Das ist für Booking-Size-Tarife und andere Gruppenpreise wichtig.

  • Booking Reservation (POST /bookings) und Booking Confirmation (POST /bookings/{uuid}/confirm) – die Buchung wird mit ihrem endgültigen Verkaufs- und Nettopreis zurückgegeben, sodass die Buchung in Ventrata immer den Preis enthält, zu dem sie verkauft wurde.

 

‼️ WICHTIG – Bitten Sie darum, die Preise zu aktivieren. Wenn Sie Kplus bitten, Ihre Produkte zuzuordnen, bitten Sie auch darum, die Preise (octo/pricing) zu aktivieren, oder aktivieren Sie sie selbst, wenn Sie im Portal von Kplus zuordnen. Andernfalls sind sie möglicherweise deaktiviert, und Kplus erhält Ihre Ventrata-Preise nicht.

Promotions Sync

❌

Ihre Werbeaktionen in Ventrata gelten nicht bei Kplus.

Die Preise bei Kplus enthalten keine Werbeaktionen, die Sie in Ventrata anlegen. Richten Sie Werbeaktionen direkt mit Kplus ein.

Bookings Sync

✅

Buchungen und Stornierungen auf Kplus werden sofort in Ventrata angelegt, und Kunden erhalten Ventrata-Tickets.

Das funktioniert wie folgt:

  1. Reservieren: Booking Reservation (POST /bookings) – Wenn ein Kunde auf Kplus den Checkout beginnt, sendet Kplus das Produkt, die Option, das gewählte Zeitfenster (availabilityId) und einen Einheitenposten pro Person. Ventrata prüft die Kapazität erneut und legt eine Buchung mit dem Status ON_HOLD an, die die Plätze reserviert, während der Kunde bezahlt. Ist kein Platz mehr frei, lehnt Ventrata die Reservierung ab.

  2. Bestätigen: Booking Confirmation (POST /bookings/{uuid}/confirm) – Sobald die Zahlung erfolgt ist, bestätigt Kplus die Reservierung. Die Buchung erhält in Ventrata den Status CONFIRMED, und Ventrata sendet Ihre Buchungsreferenz und – je nach Einrichtung Ihres Produkts – die Tickets (eines pro Person) oder einen Voucher (einen pro Buchung) zurück, jeweils mit QR-Code und PDF-Link. Kplus gibt diese an den Kunden weiter, der sie wie jedes Ventrata-Ticket an Ihrem Eingang vorzeigt.

  3. Ablaufen: Schließt der Kunde die Zahlung nicht ab, bestätigt Kplus die Reservierung nie; sie läuft von selbst ab und gibt die Plätze wieder frei.

  4. Stornieren: Booking Cancellation (POST /bookings/{uuid}/cancel) – Wenn ein Kunde auf Kplus storniert, storniert Kplus die Buchung in Ventrata. Ventrata akzeptiert dies nur, wenn die Buchung noch stornierbar ist und der Stornierungsschluss der Option noch nicht erreicht ist. Andernfalls lehnt Ventrata die Anfrage ab, und Kplus muss sich an Sie wenden.

  5. Ändern: Booking Update (PATCH /bookings/{uuid}) – Damit kann Kplus eine Buchung direkt ändern, zum Beispiel Datum, Uhrzeit oder Personenzahl. Manche Wiederverkäufer stornieren stattdessen und buchen neu.

 

‼️ WICHTIG – Buchungen werden nur in eine Richtung synchronisiert, von Kplus zu Ventrata. Wenn Sie eine Buchung von Kplus in Ventrata stornieren, ändern oder neu buchen, zum Beispiel im Dashboard, wird Kplus nicht benachrichtigt. Wenden Sie sich an Kplus, damit die Buchung auch dort storniert oder geändert wird, oder bitten Sie den Kunden, über Kplus zu stornieren.

Pickups/Dropoff Sync

❌

Kplus sendet mit seinen Buchungen keine Abhol- oder Absetzdetails.

Wenn Ihre Produkte Abholungen beinhalten, klären Sie mit Kplus, wie Abholdetails erfasst werden, oder vereinbaren Sie diese mit dem Kunden.

Custom Questions Sync

❌

Kplus sendet keine Antworten auf Ihre Buchungsfragen.

Wenn Sie auf Buchungsfragen angewiesen sind, zum Beispiel Namen oder Ernährungsbedürfnisse, klären Sie mit Kplus, wie diese Informationen erfasst werden.

Extras Sync

❌

Extras und Zusatzleistungen können nicht über Kplus gebucht werden.

Kunden können auf Kplus nur Ihre Hauptprodukte und -optionen buchen. Verkaufen Sie Extras separat, zum Beispiel bei der Ankunft.

Redemption Sync

❌

Einlösungen werden nicht an Kplus gemeldet.

Ventrata benachrichtigt Kplus nicht, wenn ein Ticket gescannt oder eingelöst wird. Kplus sieht eine Einlösung nur, wenn es die Buchung erneut aus Ventrata abruft.

Pass Walkup Scanning Sync

❌

Pass-Inhaber von Kplus können ohne Buchung nicht an Ihrem Eingang gescannt werden.

Kunden von Kplus benötigen vor ihrem Besuch eine über Kplus getätigte Buchung.

Gift Card Sync

❌

Ventrata-Geschenkkarten können nicht über Kplus verkauft oder eingelöst werden.

In Ventrata gekaufte Geschenkkarten können nicht auf Kplus verwendet werden, und Kplus kann keine Ventrata-Geschenkkarten verkaufen.

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Kplus-Verbindung

  • Verzögerungen: Verfügbarkeit und Preise erreichen Kplus erst bei der nächsten Abfrage, daher gibt es nach einer Änderung in Ventrata immer eine kurze Verzögerung.

  • Stornierungsschluss: Kplus kann über die API nur vor dem Stornierungsschluss Ihrer Option stornieren. Spätere Stornierungen müssen mit Ihnen abgestimmt werden.

  • Was Kplus sehen kann: nur die Reiseziele, Produkte und Optionen, die beim Wiederverkäufer und in der Verbindung zugelassen und für den Verkauf über die Quelle „Direkte API“ (Direct API) aktiviert sind. Siehe Produkte zulassen oder ausschließen.

  • Tickets: Kplus stellt die Ventrata-Tickets oder den Voucher aus, die es bei der Bestätigung erhält, sodass Ihr übliches Scannen und Einlösen wie gewohnt funktioniert.

  • Testbuchungen: Kplus kann während der Einrichtung der Verbindung Testbuchungen senden. Testbuchungen verbrauchen keine Verfügbarkeit und werden nicht in Rechnung gestellt.

 

FAQ

Auf der Verbindungsseite werden keine Produkte angezeigt.

Prüfen Sie, welche Destinationen, Produkte und Optionen bei Ihrem Wiederverkäufer und Ihrer Verbindung zugelassen sind. Prüfen Sie anschließend, ob Ihre Produkte und Optionen für den Verkauf über die Quelle „Direkte API“ (Direct API) aktiviert sind. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Meine Ventrata-Produkte verwenden Booking-Size-Tarife, und die Preise funktionieren auf Kplus nicht korrekt.

Aktualisieren Sie nach jeder Tarifänderung die Produktzuordnung, damit die Stufenanzahlen des Partners mit Ventrata synchronisiert sind. Stellen Sie sicher, dass der Tarif für den Verkauf über die Direkte API (Direct API) aktiviert ist.

 

 

Partnerinformationen

KPlus Bilişim Teknolojileri ve Sağlık Hizmetleri Anonim Şirketi

Muratpaşa Mahallesi, Uluyol Caddesi No:17-19 Kat:4 Daire:18, Bayrampaşa, İstanbul

Türkiye

 

Ventrata-Partner-ID: f63ce6c4-dc72-4955-954d-72ddda47cded

Hat dies deine Frage beantwortet?