I Need Tours è un'agenzia di viaggi online (OTA) italiana per tour e attività, un marchio di World Experience, che vende visite turistiche, ingressi a musei, tour privati, escursioni giornaliere, transfer e city card in decine di destinazioni in Europa, Medio Oriente, Asia-Pacifico e Caraibi. Agli operatori porta viaggiatori di lingua spagnola, italiana e portoghese che prenotano nella propria lingua, oltre ad agenti di viaggio che usano il suo sistema di prenotazione per agenzie; Spagna, Italia e Portogallo sono i suoi principali mercati di origine. I Need Tours usa Doblemente come sistema di prenotazione principale.

Collegando I Need Tours a Ventrata, disponibilità e prezzi vengono sincronizzati e prenotazioni, modifiche e cancellazioni vengono trasmesse con biglietti emessi automaticamente.

Per saperne di più su come collaborare con I Need Tours, visita ineedtours.com.

Sito web principale	ineedtours.com
Tag	Multi-Attraction Pass
Mercati di destinazione	🌎 Globale
Mercati di origine	🇮🇹 Italia · 🇵🇹 Portogallo · 🇪🇸 Spagna
Specialità	Viaggiatori di lingua spagnola, italiana e portoghese
Funzionalità della connessione	Availability Sync · Pricing Sync · Bookings Sync · Pickups/Dropoff Sync
GMV prenotato tramite Ventrata (ultimi 12 mesi)	US$100k+
Fornitori con prenotazioni tramite Ventrata (ultimi 12 mesi)	25+
Sviluppato da	Doblemente (tramite l'API OCTO di Ventrata)

Questa connessione rivenditore ti permette di vendere i tuoi prodotti tramite I Need Tours senza gestire manualmente disponibilità, prezzi e prenotazioni. Le funzionalità di questa connessione includono:

Availability Sync – I Need Tours verifica in Ventrata la tua disponibilità in tempo reale.
Pricing Sync – I Need Tours riceve i tuoi prezzi dalla configurazione prezzi del rivenditore in Ventrata.
Bookings Sync – prenotazioni, modifiche e cancellazioni provenienti da I Need Tours vengono create istantaneamente in Ventrata e i clienti ricevono biglietti Ventrata.
Pickups/Dropoff Sync – i dettagli di pick-up e drop-off vengono sincronizzati tra Ventrata e I Need Tours.

Creare la connessione con I Need Tours

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

Prima di iniziare:

Devi avere un accordo commerciale con I Need Tours perché il partner possa vendere i tuoi prodotti. Per informazioni su una partnership, contatta il partner tramite ineedtours.com.
Devi avere I Need Tours creato come Reseller in Ventrata, con i relativi prezzi (al pubblico, all'ingrosso/commissioni) definiti correttamente. Tieni presente che questa connessione API richiede che il rivenditore sia impostato sul metodo di regolamento “Bill to my account”.

Nella Ventrata Dashboard, vai su Connections → Connections, fai clic su + New Connection e seleziona I Need Tours dall'elenco dei partner.
Seleziona il rivenditore I Need Tours dall'elenco dei tuoi rivenditori (deve essere creato prima di creare una connessione). La connessione erediterà la configurazione del rivenditore, come prezzi, destinazioni consentite, prodotti e così via.
(Facoltativo) Puoi anche impostare un Name a tua scelta per la connessione: può essere utile se prevedi di avere più connessioni con I Need Tours e vuoi distinguerle più facilmente in futuro.
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 I Need Tours

Condividi in modo sicuro la chiave API OCTO mostrata sulla connessione che hai creato con il tuo referente di I Need Tours e chiedigli di mappare i tuoi prodotti tramite l'API OCTO di Ventrata, con i prezzi (octo/pricing) abilitati. Di solito il team di I Need Tours completa l'operazione in pochi giorni lavorativi.

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

📗 SUGGERIMENTO

I Need Tours può accedere a tutti i prodotti abilitati sulla connessione, ma quando lo contatti puoi anche indicare gli ID di prodotto e opzione mostrati nella pagina della connessione per specificare cosa mappare.

Gestire la connessione con I Need Tours

Consenti o non consentire prodotti: limita le destinazioni, i prodotti e le opzioni a cui I Need Tours può accedere. Scopri come consentire o non consentire prodotti.
Rinomina la connessione per distinguere più connessioni con I Need Tours.

Funzionalità della connessione in dettaglio

Questa sezione è per chi vuole sapere esattamente come funziona la connessione con I Need Tours: quali chiamate all'API OCTO di Ventrata effettua I Need Tours, quando le effettua e cosa significa per te. Ogni chiamata rimanda alla documentazione API di Ventrata.

In breve: I Need Tours recupera da Ventrata tutto ciò che gli serve. Legge i tuoi prodotti, verifica la tua disponibilità e i tuoi prezzi e invia prenotazioni e cancellazioni. Ventrata non invia modifiche a I Need Tours, quindi ciò che modifichi in Ventrata arriva a I Need Tours alla sua verifica successiva.

Le tempistiche sono quelle tipiche di I Need Tours e arrotondate, e possono cambiare se I Need Tours modifica il proprio modo di sincronizzare.

Product Mapping	❌	Non puoi mappare i prodotti da Ventrata. I Need Tours li mappa dal proprio lato, tramite il tuo account manager o il portale di I Need Tours. Il funzionamento è il seguente: Get Products (`GET /products`) – quando I Need Tours configura la tua connessione, e ogni volta che aggiorna le sue inserzioni, legge tutti i prodotti abilitati sulla connessione, con le relative opzioni e unità (tipi di biglietto come Adulto o Bambino). Get Product (`GET /products/{productId}`) – I Need Tours rilegge un singolo prodotto per recepire le modifiche a opzioni, unità, limiti di prenotazione e impostazioni. Mappatura dal lato di I Need Tours – I Need Tours collega ogni opzione e unità Ventrata alle proprie inserzioni e ai propri tipi di biglietto. Se ne occupa il tuo account manager di I Need Tours, oppure lo fai tu nel portale di I Need Tours, se disponibile. Devi solo condividere la chiave API della connessione. Di solito con I Need Tours: I Need Tours legge l'elenco completo dei tuoi prodotti ogni pochi giorni. Rilegge ogni prodotto circa ogni 5 ore. Cosa significa per te: I Need Tours può vendere solo ciò che ha mappato. Quando aggiungi un prodotto, un'opzione o un'unità in Ventrata, I Need Tours potrebbe vederlo al successivo aggiornamento, ma non lo venderà finché non sarà mappato. Avvisa quindi il tuo account manager di I Need Tours ogni volta che ne aggiungi uno.
Content Sync	✅ / ❌	I Need Tours può leggere da Ventrata i contenuti dei tuoi prodotti, come descrizioni e immagini. Il funzionamento è il seguente: Capability `octo/content` – quando I Need Tours la aggiunge all'header `Octo-Capabilities`, Get Products (`GET /products`) e Get Product (`GET /products/{productId}`) restituiscono anche i contenuti dei tuoi prodotti, come descrizioni, punti salienti, inclusioni e immagini. Le modifiche ai contenuti in Ventrata arrivano a I Need Tours al successivo aggiornamento dei prodotti. Di solito con I Need Tours: I Need Tours richiede `octo/content`.
Availability Sync	✅	I Need Tours verifica in Ventrata la tua disponibilità in tempo reale. Ventrata non invia a I Need Tours le modifiche di disponibilità. Il funzionamento è il seguente: Availability Check (`POST /availability`) – I Need Tours invia un prodotto, un'opzione e una data o un intervallo di date. Ventrata risponde con ogni giorno o fascia oraria prenotabile, il relativo stato (`AVAILABLE`, `LIMITED`, `SOLD_OUT`, `CLOSED` o `FREESALE`), i posti rimanenti, il limite di prenotazione e un `availabilityId`, che I Need Tours deve usare per prenotare quella fascia. Verifica al momento della prenotazione – quando un cliente prenota, Ventrata ricontrolla la capacità prima di creare la prenotazione, quindi I Need Tours non può fare overbooking su una fascia appena esaurita, anche se la disponibilità che ha memorizzato è leggermente obsoleta. Di solito con I Need Tours: Availability Check: I Need Tours controlla i tuoi prodotti durante tutta la giornata, di solito a partire da circa 2 mesi da oggi e coprendo 4 giorni per richiesta, guarda fino a circa un anno avanti e ricontrolla lo stesso prodotto e le stesse date circa ogni 8 ore. Le verifiche sono distribuite nell'arco della giornata senza picchi marcati, il che fa pensare a un mix di sincronizzazioni programmate e ricerche dei clienti in tempo reale. Cosa significa per te: quando chiudi una data, modifichi la capienza o esaurisci i posti in Ventrata, I Need Tours lo mostra dopo il controllo successivo. Per le date che controlla regolarmente, ciò avviene entro circa 8 ore. Le date più lontane vengono di solito controllate meno spesso.
Pricing Sync	✅	I tuoi prezzi vengono restituiti con ogni verifica della disponibilità, una volta che I Need Tours li richiede con la capability octo/pricing. Il funzionamento è il seguente: Capability `octo/pricing` – I Need Tours 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 I Need Tours, entrambi presi dai prezzi del rivenditore in Ventrata (al pubblico e all'ingrosso/commissioni). Prezzi di gruppo – quando I Need Tours invia anche quante persone di ciascun tipo di unità stanno prenotando, Ventrata calcola il prezzo esatto per quel gruppo. È 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. Di solito con I Need Tours: I Need Tours richiede `octo/pricing` in tutte le sue verifiche della disponibilità, quindi vende ai tuoi prezzi Ventrata. I Need Tours invia il numero di persone per tipo di unità, così i prezzi di gruppo vengono calcolati sulla prenotazione effettiva. ‼️ IMPORTANTE – Chiedi di abilitare i prezzi. Quando chiedi a I Need Tours di mappare i tuoi prodotti, chiedi anche di abilitare i prezzi (`octo/pricing`), oppure attivali tu se mappi nel portale di I Need Tours. Altrimenti potrebbero essere disattivati e I Need Tours non riceverà i tuoi prezzi Ventrata. 📗 SUGGERIMENTO – Se i prezzi su I Need Tours sembrano errati, controlla prima i prezzi del rivenditore I Need Tours in Ventrata: sono quelli che I Need Tours legge.
Promotions Sync	❌	Le tue promozioni Ventrata non si applicano su I Need Tours. I prezzi su I Need Tours non includono le promozioni che crei in Ventrata. Configura eventuali promozioni direttamente con I Need Tours.
Bookings Sync	✅	Le prenotazioni e le cancellazioni effettuate su I Need Tours vengono create istantaneamente in Ventrata e i clienti ricevono biglietti Ventrata. Il funzionamento è il seguente: Blocco: Booking Reservation (`POST /bookings`) – quando un cliente avvia il checkout su I Need Tours, I Need Tours invia il prodotto, l'opzione, la fascia scelta (`availabilityId`) e un'unità per ogni persona. Ventrata ricontrolla la capacità e crea una prenotazione `ON_HOLD`, che blocca i posti mentre il cliente paga. Se non c'è più posto, Ventrata rifiuta il blocco. Conferma: Booking Confirmation (`POST /bookings/{uuid}/confirm`) – una volta completato il pagamento, I Need Tours conferma il blocco, con il proprio riferimento di prenotazione e i dati di contatto del cliente. 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. I Need Tours li consegna al cliente, che li mostra al tuo ingresso come qualsiasi biglietto Ventrata. Scadenza: se il cliente non completa il pagamento, I Need Tours non conferma mai e il blocco scade da solo, liberando i posti. Cancellazione: Booking Cancellation (`POST /bookings/{uuid}/cancel`) – quando un cliente cancella su I Need Tours, I Need Tours cancella la prenotazione in Ventrata. Ventrata accetta solo se la prenotazione è ancora cancellabile e il limite di cancellazione dell'opzione non è stato superato. Altrimenti rifiuta la richiesta e I Need Tours deve contattarti. Modifica: I Need Tours non usa Booking Update (`PATCH /bookings/{uuid}`), quindi una modifica arriva molto probabilmente in Ventrata come una cancellazione più una nuova prenotazione. Di solito con I Need Tours: I Need Tours non imposta un tempo di blocco, quindi si applica il tempo di blocco predefinito. Una prenotazione tipica su I Need Tours è per circa 3 persone. È normale vedere più blocchi che prenotazioni confermate: i blocchi dei clienti che non completano il pagamento semplicemente scadono. I Need Tours controlla anche le prenotazioni che ha effettuato, con List Bookings (`GET /bookings`) circa ogni 6 ore e Get Booking (`GET /bookings/{uuid}`), circa ogni 12 ore, ad esempio per riconciliare i propri dati. ‼️ IMPORTANTE – Le prenotazioni si sincronizzano in un'unica direzione, da I Need Tours a Ventrata. Se cancelli, modifichi o riprenoti in Ventrata una prenotazione proveniente da I Need Tours, ad esempio nella Dashboard, I Need Tours non riceve alcuna notifica. Contatta I Need Tours affinché la prenotazione venga cancellata o modificata anche dal suo lato, oppure chiedi al cliente di cancellare tramite I Need Tours.
Pickups/Dropoff Sync	✅	I Need Tours invia i dettagli del pick-up con le sue prenotazioni. Il funzionamento è il seguente: Capability `octo/pickups`: I Need Tours può vedere quali opzioni offrono il pick-up e i relativi punti di pick-up, e inviare con la prenotazione il punto di pick-up o l'hotel del cliente. Se un hotel non corrisponde a uno dei tuoi punti di pick-up, Ventrata lo salva con la prenotazione così puoi organizzare il pick-up. Di solito con I Need Tours: I Need Tours invia i dettagli del pick-up con le sue prenotazioni.
Custom Questions Sync	✅ / ❌	I Need Tours invia con le sue prenotazioni le risposte alle tue domande di prenotazione. Il funzionamento è il seguente: Capability `octo/questions`: I Need Tours legge le domande impostate sui tuoi prodotti e invia con la prenotazione le risposte del cliente, che vedi in Ventrata. Di solito con I Need Tours: I Need Tours invia le risposte alle tue domande di prenotazione.
Extras Sync	❌	Extra e add-on non possono essere prenotati tramite I Need Tours. Su I Need Tours i clienti possono prenotare 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 I Need Tours. Ventrata non avvisa I Need Tours quando un biglietto viene scansionato o riscattato. I Need Tours vede un riscatto solo se rilegge la prenotazione da Ventrata.
Pass Walkup Scanning Sync	❌	I titolari di pass di I Need Tours non possono essere scansionati al tuo ingresso senza una prenotazione. I clienti provenienti da I Need Tours devono avere una prenotazione effettuata tramite I Need Tours prima della visita.
Gift Card Sync	❌	Le gift card Ventrata non possono essere vendute né riscattate tramite I Need Tours. Le gift card acquistate in Ventrata non possono essere usate su I Need Tours e I Need Tours non può vendere gift card Ventrata.

✅ supportato · ✅ / ❌ limitato · ❌ non supportato

Buono a sapersi: limiti e dettagli della connessione con I Need Tours

Ritardi: disponibilità e prezzi arrivano a I Need Tours solo quando effettua una verifica, quindi c'è sempre un breve ritardo dopo una modifica in Ventrata.
Limite di cancellazione: I Need Tours può cancellare tramite API solo prima del limite di cancellazione della tua opzione. Le cancellazioni successive devono essere concordate con te.
Cosa può vedere I Need Tours: solo le destinazioni, i prodotti e le opzioni consentiti sul rivenditore e sulla connessione e abilitati alla vendita sulla fonte Direct API. Scopri come consentire o non consentire prodotti.
Biglietti: I Need Tours emette i biglietti o il voucher Ventrata che riceve alla conferma, quindi scansione e riscatto funzionano come di consueto.
Prenotazioni di test: I Need Tours può inviare prenotazioni di test mentre configura la 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 I Need Tours.

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.

📚 Altro sulle connessioni Ventrata

Informazioni sul partner

World Experience S.r.l.

Via de Pinedo 18

55041 Lido di Camaiore (LU), Italy

ineedtours.com

Ventrata Partner ID: f14c0e36-765e-47ed-99df-2130bffef5ae

I Need Tours: connessione rivenditore