Vai al contenuto principale

AT New York & Company: connessione rivenditore

Collega AT New York & Company a Ventrata per sincronizzare disponibilità e prezzi e ricevere subito le prenotazioni. Al servizio dei visitatori di lingua giapponese dal 1999.

AT New York & Company logo

 

AT New York & Company è un'agenzia di viaggi con sede a New York al servizio dei visitatori di lingua giapponese dal 1999, che organizza propri tour turistici della città e tour notturni e vende biglietti per Broadway, osservatori, musei ed eventi sportivi, transfer aeroportuali, guide e prenotazioni alberghiere. Agli operatori porta viaggiatori giapponesi, privati, gruppi, clienti aziendali e agenzie di viaggio giapponesi, che prenotano in giapponese, con i tour turistici e i biglietti per Broadway e gli osservatori come prodotti principali.

 

Collegando AT New York & Company a Ventrata sincronizzerai disponibilità e prezzi e riceverai prenotazioni, modifiche e cancellazioni con biglietti emessi automaticamente.

 

Per saperne di più su come collaborare con AT New York & Company, visita www.at-newyork.com.

 

Sito web principale

Tag

Travel Agent

Mercati di destinazione

🌎 Globale

Mercati di origine

🌎 Globale

Specialità

Visitatori di lingua giapponese a New York

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

AT New York & Company (tramite l'API OCTO di Ventrata)

 

Questa connessione rivenditore ti permette di vendere i tuoi prodotti tramite AT New York & Company senza gestire manualmente disponibilità, prezzi e prenotazioni. Le funzionalità di questa connessione includono:

  • Availability Sync – AT New York & Company controlla la tua disponibilità in tempo reale in Ventrata.

  • Pricing Sync – AT New York & Company ottiene i tuoi prezzi dai prezzi rivenditore in Ventrata.

  • Bookings Sync – prenotazioni, modifiche e cancellazioni da AT New York & Company vengono create istantaneamente in Ventrata e i clienti ricevono biglietti Ventrata.

 

Creare la connessione AT New York & Company

🔐 Autorizzazioni di ruolo richieste: See Connections, Modify Connections, See Connection Key

Prima di iniziare:

  • Devi avere un accordo commerciale con AT New York & Company perché il partner possa vendere i tuoi prodotti. Per informazioni su una partnership, contatta il partner tramite www.at-newyork.com.

  • Devi aver creato AT New York & Company come Reseller in Ventrata con i relativi prezzi (al pubblico, all'ingrosso/a commissione) definiti correttamente. Tieni presente che questa connessione API richiede che il rivenditore sia impostato sul metodo di regolamento "Bill to my account".

 

  1. Nella Ventrata Dashboard, vai su Connections → Connections, fai clic su + New Connection e seleziona AT New York & Company dall'elenco dei partner.

  2. Seleziona AT New York & Company Reseller dall'elenco dei tuoi rivenditori (deve essere creato prima della connessione). La connessione eredita la configurazione del rivenditore, ad esempio prezzi, destinazioni e prodotti consentiti.

  3. (Facoltativo) Puoi anche impostare un Name a tua scelta per la connessione, utile se prevedi di avere più connessioni AT New York & Company e vuoi distinguerle più facilmente in futuro.

  4. Fai clic sul pulsante Create Octo Connection.

 

📗 SUGGERIMENTO

Se necessario, puoi anche consentire o non consentire prodotti o destinazioni a livello di connessione, oltre a quanto configurato sul rivenditore.

 

Mappare i prodotti su AT New York & Company

Condividi in modo sicuro la chiave API OCTO mostrata sulla connessione che hai creato con il tuo referente AT New York & Company e chiedigli di mappare i tuoi prodotti tramite l'API OCTO di Ventrata, con i prezzi (octo/pricing) abilitati. Di solito il team di AT New York & Company impiega al massimo qualche giorno lavorativo per completare questa operazione.

 

La configurazione in Ventrata è completa. Non devi fare altro.

 

📗 SUGGERIMENTO

AT New York & Company può accedere a tutti i prodotti abilitati sulla connessione, ma quando lo contatti puoi anche indicare gli ID di prodotto e opzione presenti nella pagina della connessione per specificare cosa mappare.

 

Gestire la connessione AT New York & Company

  • Consenti o escludi prodotti: limita le destinazioni, i prodotti e le opzioni a cui AT New York & Company può accedere. Vedi come consentire o escludere prodotti.

  • Rinomina la connessione per distinguere più connessioni AT New York & Company.

 

Funzionalità della connessione in dettaglio

Questa sezione è per chi vuole sapere esattamente come funziona la connessione AT New York & Company: quali chiamate dell'API OCTO di Ventrata effettua AT New York & Company, quando le effettua e cosa significa per te. Ogni chiamata rimanda alla documentazione API di Ventrata.

 

In breve: AT New York & Company recupera da Ventrata tutto ciò che gli serve. Legge i tuoi prodotti, controlla disponibilità e prezzi e invia prenotazioni e cancellazioni. Ventrata non invia modifiche a AT New York & Company, quindi qualsiasi cosa tu modifichi in Ventrata arriva a AT New York & Company al controllo successivo.

 

Product Mapping

❌

Non puoi mappare i prodotti da Ventrata. AT New York & Company li mappa dal proprio lato, tramite il tuo account manager o il portale di AT New York & Company.

Il funzionamento è il seguente:

  • Get Products (GET /products) – quando AT New York & Company configura la connessione, e ogni volta che aggiorna le sue offerte, legge tutti i prodotti abilitati sulla connessione, con le relative opzioni e unità (tipi di biglietto come Adult o Child).

  • Get Product (GET /products/{productId}) – AT New York & Company rilegge un singolo prodotto per recepire le modifiche a opzioni, unità, termini di prenotazione e impostazioni.

  • Mappatura dal lato di AT New York & Company – AT New York & Company collega ogni opzione e unità Ventrata alla propria offerta e ai propri tipi di biglietto. Se ne occupa il tuo account manager AT New York & Company, oppure lo fai tu nel portale di AT New York & Company, se disponibile. Tu condividi solo la chiave API della connessione.

 

Cosa significa per te: AT New York & Company può vendere solo ciò che ha mappato. Quando aggiungi un prodotto, un'opzione o un'unità in Ventrata, AT New York & Company potrebbe vederlo al successivo aggiornamento, ma non lo venderà finché non è mappato. Per questo avvisa il tuo account manager AT New York & Company ogni volta che ne aggiungi uno.

Content Sync

❌

AT New York & Company non legge i contenuti dei tuoi prodotti da Ventrata.

AT New York & Company usa le descrizioni, le immagini e gli altri contenuti configurati dal proprio lato, quindi aggiorna i contenuti direttamente con AT New York & Company.

Availability Sync

✅

AT New York & Company controlla la tua disponibilità in tempo reale in Ventrata. Ventrata non invia a AT New York & Company le modifiche alla disponibilità.

Il funzionamento è il seguente:

  • Availability Check (POST /availability) – AT New York & Company invia un prodotto, un'opzione e una data o un intervallo di date. Ventrata risponde con ogni giorno o fascia oraria prenotabile, il suo stato (AVAILABLE, LIMITED, SOLD_OUT, CLOSED o FREESALE), i posti rimanenti, il termine di prenotazione e un availabilityId, necessario a AT New York & Company per prenotare quella fascia.

  • Availability Calendar (POST /availability/calendar) – restituisce un riepilogo per giorno anziché ogni singola fascia oraria, di solito per mostrare quali date sono aperte in un selettore di date.

  • Controllo alla prenotazione – quando un cliente prenota, Ventrata ricontrolla la capienza prima di creare la prenotazione, quindi AT New York & Company non può fare overbooking su una fascia appena esaurita, anche se la disponibilità che ha memorizzato è leggermente obsoleta.

 

Cosa significa per te: quando chiudi una data, modifichi la capienza o esaurisci i posti in Ventrata, AT New York & Company lo mostra solo dopo il controllo successivo, quindi può esserci un breve ritardo. Il controllo di Ventrata alla prenotazione impedisce comunque l'overbooking.

Pricing Sync

✅

I tuoi prezzi vengono restituiti con ogni controllo della disponibilità, se AT New York & Company li richiede con la capability octo/pricing.

Il funzionamento è il seguente:

  • Capability octo/pricing: AT New York & Company richiede i prezzi aggiungendo octo/pricing all'header Octo-Capabilities delle sue richieste. Senza di essa, Ventrata invia la disponibilità senza alcun prezzo.

  • Availability Check (POST /availability) – con i prezzi attivi, ogni giorno o fascia oraria viene restituito con il tuo prezzo per unità (tipo di biglietto): il prezzo retail pagato dal cliente e il prezzo net che fatturi a AT New York & Company, entrambi derivati dai prezzi del rivenditore in Ventrata (al pubblico e all'ingrosso/a commissione).

  • Prezzi di gruppo – quando AT New York & Company invia anche quante persone di ciascun tipo di unità stanno prenotando, Ventrata calcola il prezzo esatto per quel gruppo. Questo è importante per le tariffe Booking Size e altri prezzi di gruppo.

  • Booking Reservation (POST /bookings) e Booking Confirmation (POST /bookings/{uuid}/confirm) – la prenotazione viene restituita con il prezzo al pubblico e il prezzo netto finali, quindi in Ventrata la prenotazione registra sempre il prezzo a cui è stata venduta.

 

‼️ IMPORTANTE – Chiedi di abilitare i prezzi. Quando chiedi a AT New York & Company di mappare i tuoi prodotti, chiedi anche di abilitare i prezzi (octo/pricing), oppure attivali tu se esegui la mappatura nel portale di AT New York & Company. Altrimenti potrebbero essere disattivati e AT New York & Company non riceverà i tuoi prezzi Ventrata.

Promotions Sync

❌

Le tue promozioni Ventrata non si applicano su AT New York & Company.

I prezzi su AT New York & Company non includono le promozioni che crei in Ventrata. Configura eventuali promozioni direttamente con AT New York & Company.

Bookings Sync

✅

Le prenotazioni e le cancellazioni effettuate su AT New York & Company vengono create istantaneamente in Ventrata e i clienti ricevono biglietti Ventrata.

Il funzionamento è il seguente:

  1. Blocco: Booking Reservation (POST /bookings) – quando un cliente avvia il checkout su AT New York & Company, AT New York & Company invia il prodotto, l'opzione, la fascia scelta (availabilityId) e un elemento unità per persona. Ventrata ricontrolla la capienza e crea una prenotazione ON_HOLD, che trattiene i posti mentre il cliente paga. Se non c'è più posto, Ventrata rifiuta il blocco.

  2. Conferma: Booking Confirmation (POST /bookings/{uuid}/confirm) – quando il pagamento va a buon fine, AT New York & Company conferma il blocco. La prenotazione diventa CONFIRMED in Ventrata e Ventrata restituisce il tuo riferimento di prenotazione e i biglietti (uno per persona) o un voucher (uno per prenotazione), a seconda di come è configurato il prodotto, ciascuno con un codice QR e un link al PDF. AT New York & Company li consegna al cliente, che li mostra al tuo ingresso come qualsiasi biglietto Ventrata.

  3. Scadenza: se il cliente non completa il pagamento, AT New York & Company non conferma mai e il blocco scade automaticamente, liberando i posti.

  4. Cancellazione: Booking Cancellation (POST /bookings/{uuid}/cancel) – quando un cliente cancella su AT New York & Company, AT New York & Company cancella la prenotazione in Ventrata. Ventrata lo accetta solo se la prenotazione è ancora cancellabile e il termine di cancellazione dell'opzione non è scaduto. Altrimenti rifiuta la richiesta e AT New York & Company deve contattarti.

  5. Modifica: Booking Update (PATCH /bookings/{uuid}) – permette a AT New York & Company di modificare una prenotazione direttamente, ad esempio con una nuova data, un nuovo orario o un diverso numero di persone. Alcuni rivenditori invece cancellano e prenotano di nuovo.

 

‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da AT New York & Company a Ventrata. Se cancelli, modifichi o riprenoti in Ventrata una prenotazione proveniente da AT New York & Company, ad esempio nella Dashboard, AT New York & Company non riceve alcuna notifica. Contatta AT New York & Company perché la prenotazione venga cancellata o modificata anche dal suo lato, oppure chiedi al cliente di cancellare tramite AT New York & Company.

Pickups/Dropoff Sync

❌

AT New York & Company non invia i dettagli di pick-up o drop-off con le sue prenotazioni.

Se i tuoi prodotti includono pick-up, verifica con AT New York & Company come raccoglie i dettagli di pick-up, oppure concordali con il cliente.

Custom Questions Sync

❌

AT New York & Company non invia le risposte alle tue domande sulla prenotazione.

Se ti servono le domande sulla prenotazione, ad esempio nomi o esigenze alimentari, verifica con AT New York & Company come raccoglie queste informazioni.

Extras Sync

❌

Extra e servizi aggiuntivi non si possono prenotare tramite AT New York & Company.

I clienti possono prenotare su AT New York & Company solo i tuoi prodotti e le tue opzioni principali. Vendi gli extra separatamente, ad esempio all'arrivo.

Redemption Sync

❌

I riscatti non vengono comunicati a AT New York & Company.

Ventrata non avvisa AT New York & Company quando un biglietto viene scansionato o riscattato. AT New York & Company vede un riscatto solo se rilegge la prenotazione da Ventrata.

Pass Walkup Scanning Sync

❌

I titolari di pass AT New York & Company non possono essere scansionati al tuo ingresso senza una prenotazione.

I clienti di AT New York & Company hanno bisogno di una prenotazione effettuata tramite AT New York & Company prima della visita.

Gift Card Sync

❌

Le carte regalo Ventrata non si possono vendere né riscattare tramite AT New York & Company.

Le carte regalo acquistate in Ventrata non si possono usare su AT New York & Company e AT New York & Company non può vendere carte regalo Ventrata.

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione AT New York & Company

  • Ritardi: disponibilità e prezzi arrivano a AT New York & Company solo quando effettua un controllo, quindi c'è sempre un breve ritardo dopo una modifica in Ventrata.

  • Termine di cancellazione: AT New York & Company può cancellare tramite API solo prima del termine di cancellazione della tua opzione. Le cancellazioni successive devono essere concordate con te.

  • Cosa può vedere AT New York & Company: solo le destinazioni, i prodotti e le opzioni consentiti sul rivenditore e sulla connessione e abilitati alla vendita sulla fonte Direct API. Vedi come consentire o escludere prodotti.

  • Biglietti: AT New York & Company emette i biglietti o il voucher Ventrata ricevuti alla conferma, quindi scansione e riscatto funzionano come sempre.

  • Prenotazioni di test: AT New York & Company può inviare prenotazioni di test durante la configurazione della connessione. Le prenotazioni di test non consumano la tua disponibilità e non vengono fatturate.

 

FAQ

Nella pagina della connessione non viene mostrato alcun prodotto.

Verifica quali destinazioni, prodotti e opzioni sono consentiti sul tuo rivenditore e sulla connessione. Poi conferma che i tuoi prodotti e le tue opzioni siano abilitati alla vendita sulla fonte Direct API. Se il problema persiste, contatta il nostro supporto tecnico.

I miei prodotti Ventrata usano tariffe Booking Size e i prezzi non funzionano correttamente su AT New York & Company.

Dopo ogni modifica di tariffa, aggiorna la mappatura del prodotto per assicurarti che i conteggi per fascia del partner siano sincronizzati con Ventrata. Assicurati che la tariffa sia abilitata alla vendita tramite Direct API.

 

 

Informazioni sul partner

AT New York & Company

 

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

Hai ricevuto la risposta alla tua domanda?