Zum Hauptinhalt springen

AT New York & Company: Wiederverkäufer-Verbindung

Verbinden Sie AT New York & Company mit Ventrata, um Verfügbarkeit und Preise zu synchronisieren und Buchungen sofort zu erhalten. Betreut seit 1999 japanischsprachige Besucher.

AT New York & Company logo

 

AT New York & Company ist ein Reiseunternehmen mit Sitz in New York, das seit 1999 japanischsprachige Besucher betreut, eigene Stadtrundfahrten und Nachttouren durchführt und Tickets für Broadway, Aussichtsplattformen, Museen und Sportveranstaltungen sowie Flughafentransfers, Guides und Hotelbuchungen verkauft. Betreibern bringt es japanische Reisende – Einzelreisende, Gruppen, Firmenkunden und japanische Reisebüros –, die auf Japanisch buchen; Kernprodukte sind Sightseeing-Touren sowie Broadway- und Aussichtsplattform-Tickets.

 

Wenn Sie AT New York & Company 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 AT New York & Company finden Sie unter www.at-newyork.com.

 

Hauptwebsite

Tags

Travel Agent

Zielmärkte

🌎 Weltweit

Quellmärkte

🌎 Weltweit

Schwerpunkte

Japanischsprachige Besucher in New York

Verbindungsfunktionen

Availability Sync · Pricing Sync · Bookings Sync

Entwickelt von

AT New York & Company (über die OCTO API von Ventrata)

 

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

  • Availability Sync – AT New York & Company prüft Ihre aktuelle Verfügbarkeit in Ventrata.

  • Pricing Sync – AT New York & Company erhält Ihre Preise aus Ihrer Wiederverkäufer-Preisgestaltung in Ventrata.

  • Bookings Sync – Buchungen, Änderungen und Stornierungen von AT New York & Company werden sofort in Ventrata angelegt, und Kunden erhalten Ventrata-Tickets.

 

Verbindung mit AT New York & Company erstellen

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

Bevor Sie beginnen:

  • Sie benötigen eine Handelsvereinbarung mit AT New York & Company, damit Ihre Produkte dort verkauft werden. Wenn Sie an einer Partnerschaft interessiert sind, kontaktieren Sie den Partner über www.at-newyork.com.

  • Sie müssen AT New York & Company 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 AT New York & Company aus der Partnerliste aus.

  2. Wählen Sie Wiederverkäufer AT New York & Company 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 Verbindungen mit AT New York & Company 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 AT New York & Company zuordnen

Teilen Sie den OCTO-API-Schlüssel, der in der erstellten Verbindung angezeigt wird, auf sicherem Weg mit Ihrem Ansprechpartner bei AT New York & Company 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 AT New York & Company-Team dies erledigt hat.

 

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

 

📗 TIPP

AT New York & Company 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.

 

Verbindung mit AT New York & Company verwalten

  • Produkte zulassen oder ausschließen: Legen Sie fest, auf welche Destinationen, Produkte und Optionen AT New York & Company zugreifen kann. Siehe Produkte zulassen oder ausschließen.

  • Benennen Sie die Verbindung um, um mehrere Verbindungen mit AT New York & Company auseinanderzuhalten.

 

Verbindungsfunktionen im Detail

Dieser Abschnitt richtet sich an alle, die genau wissen möchten, wie die Verbindung mit AT New York & Company funktioniert: welche Aufrufe AT New York & Company 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: AT New York & Company 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 AT New York & Company; alles, was Sie in Ventrata ändern, erreicht AT New York & Company also bei der nächsten Abfrage.

 

Product Mapping

❌

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

Das funktioniert wie folgt:

  • Get Products (GET /products) – Wenn AT New York & Company 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}) – AT New York & Company liest ein einzelnes Produkt erneut ein, um Änderungen an Optionen, Einheiten, Buchungsschlusszeiten und Einstellungen zu übernehmen.

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

 

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

Content Sync

❌

AT New York & Company liest Ihre Produktinhalte nicht aus Ventrata.

AT New York & Company verwendet die Beschreibungen, Bilder und sonstigen Inhalte, die auf seiner eigenen Seite eingerichtet sind. Aktualisieren Sie Ihre Inhalte daher direkt bei AT New York & Company.

Availability Sync

✅

AT New York & Company prüft Ihre aktuelle Verfügbarkeit in Ventrata. Ventrata überträgt Verfügbarkeitsänderungen nicht aktiv an AT New York & Company.

Das funktioniert wie folgt:

  • Availability Check (POST /availability) – AT New York & Company 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 AT New York & Company 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 AT New York & Company 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 AT New York & Company 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 AT New York & Company sie mit der Capability octo/pricing anfordert.

Das funktioniert wie folgt:

  • octo/pricing-Capability – AT New York & Company 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 AT New York & Company in Rechnung stellen, beide aus der Wiederverkäufer-Preisgestaltung in Ventrata (Verkaufspreis und Großhandel/Provision).

  • Gruppenpreise – Wenn AT New York & Company 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 AT New York & Company bitten, Ihre Produkte zuzuordnen, bitten Sie auch darum, die Preise (octo/pricing) zu aktivieren, oder aktivieren Sie sie selbst, wenn Sie im Portal von AT New York & Company zuordnen. Andernfalls sind sie möglicherweise deaktiviert, und AT New York & Company erhält Ihre Ventrata-Preise nicht.

Promotions Sync

❌

Ihre Werbeaktionen in Ventrata gelten nicht bei AT New York & Company.

Die Preise bei AT New York & Company enthalten keine Werbeaktionen, die Sie in Ventrata anlegen. Richten Sie Werbeaktionen direkt mit AT New York & Company ein.

Bookings Sync

✅

Buchungen und Stornierungen auf AT New York & Company werden sofort in Ventrata angelegt, und Kunden erhalten Ventrata-Tickets.

Das funktioniert wie folgt:

  1. Reservieren: Booking Reservation (POST /bookings) – Wenn ein Kunde auf AT New York & Company den Checkout beginnt, sendet AT New York & Company 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 AT New York & Company 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. AT New York & Company 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 AT New York & Company 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 AT New York & Company storniert, storniert AT New York & Company 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 AT New York & Company muss sich an Sie wenden.

  5. Ändern: Booking Update (PATCH /bookings/{uuid}) – Damit kann AT New York & Company 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 AT New York & Company zu Ventrata. Wenn Sie eine Buchung von AT New York & Company in Ventrata stornieren, ändern oder neu buchen, zum Beispiel im Dashboard, wird AT New York & Company nicht benachrichtigt. Wenden Sie sich an AT New York & Company, damit die Buchung auch dort storniert oder geändert wird, oder bitten Sie den Kunden, über AT New York & Company zu stornieren.

Pickups/Dropoff Sync

❌

AT New York & Company sendet mit seinen Buchungen keine Abhol- oder Absetzdetails.

Wenn Ihre Produkte Abholungen beinhalten, klären Sie mit AT New York & Company, wie Abholdetails erfasst werden, oder vereinbaren Sie diese mit dem Kunden.

Custom Questions Sync

❌

AT New York & Company sendet keine Antworten auf Ihre Buchungsfragen.

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

Extras Sync

❌

Extras und Zusatzleistungen können nicht über AT New York & Company gebucht werden.

Kunden können auf AT New York & Company nur Ihre Hauptprodukte und -optionen buchen. Verkaufen Sie Extras separat, zum Beispiel bei der Ankunft.

Redemption Sync

❌

Einlösungen werden nicht an AT New York & Company gemeldet.

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

Pass Walkup Scanning Sync

❌

Pass-Inhaber von AT New York & Company können ohne Buchung nicht an Ihrem Eingang gescannt werden.

Kunden von AT New York & Company benötigen vor ihrem Besuch eine über AT New York & Company getätigte Buchung.

Gift Card Sync

❌

Ventrata-Geschenkkarten können nicht über AT New York & Company verkauft oder eingelöst werden.

In Ventrata gekaufte Geschenkkarten können nicht auf AT New York & Company verwendet werden, und AT New York & Company kann keine Ventrata-Geschenkkarten verkaufen.

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit AT New York & Company

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

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

  • Was AT New York & Company sehen kann: nur die Destinationen, 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: AT New York & Company 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: AT New York & Company 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 AT New York & Company 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

AT New York & Company

 

Ventrata-Partner-ID: 01a16881-2948-7db1-a93d-91a2156bf5ab

Hat dies deine Frage beantwortet?