Vai al contenuto principale

Connessione Inntopia Commerce

Collega Inntopia Commerce a Ventrata per vendere i tuoi prodotti nel motore di prenotazione a carrello unico di un resort, insieme all'alloggio. Il pagamento è gestito da Inntopia.

Inntopia Commerce

 

Inntopia Commerce è un motore di prenotazione a carrello unico per destinazioni montane e resort, che permette a un ospite di prenotare alloggio, skipass, attività, ristorazione e spa da sistemi diversi in un'unica transazione. Con sede a Stowe, nel Vermont, e parte di Outside Inc., Inntopia serve stazioni sciistiche, strutture golfistiche e balneari, parchi acquatici e organizzazioni di destinazione, soprattutto in Nord America. È una delle due connessioni Inntopia; l'altra è Inntopia Marketing Cloud.

 

Collegando Inntopia Commerce a Ventrata, un resort o una destinazione che usa Inntopia Commerce può vendere i tuoi prodotti Ventrata nel proprio motore di prenotazione, insieme all'alloggio e ad altri servizi di viaggio.

 

Per saperne di più su Inntopia Commerce, visita corp.inntopia.com/commerce.

 

Sito web principale

Tag

Custom Checkout

Sviluppato da

Inntopia (tramite l'API OCTO di Ventrata)

 

Questa connessione app collega il tuo account Ventrata a Inntopia Commerce, così i resort possono vendere le tue attività e attrazioni nello stesso acquisto di un soggiorno. Le funzionalità di questa connessione includono:

  • Sincronizza contenuti, disponibilità e prezzi – nel carrello di Inntopia.

  • Vende insieme all'alloggio – e ad altri servizi in un'unica transazione dell'ospite.

  • Invia le prenotazioni a Ventrata – nuove prenotazioni, modifiche e cancellazioni.

  • Consegna i biglietti – voucher o biglietti vengono emessi da Ventrata all'ospite tramite Inntopia.

 

‼️ IMPORTANTE

Questa è una connessione in modalità checkout, non una connessione rivenditore. L'ospite completa l'intero acquisto nel carrello di Inntopia. Ventrata resta la fonte di riferimento per disponibilità, prezzi e offerte, e il pagamento viene incassato dal gateway di pagamento gestito di Inntopia e registrato in Ventrata come pagamento esterno. Per questo motivo la configurazione è diversa da quella di una connessione rivenditore standard.

 

‼️ IMPORTANTE

Le autorizzazioni di ruolo richieste vanno oltre quelle standard: See Checkouts, Modify Checkouts, See Connections, Modify Connections.

 

‼️ IMPORTANTE

Inntopia Commerce tratterà i dati personali dei tuoi ospiti. Verifica la tua informativa sulla privacy e i tuoi termini e condizioni prima di attivare la connessione.

 

Creare la connessione con Inntopia Commerce

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

Prima di iniziare:

  • Devi avere un accordo commerciale con Inntopia per utilizzare le sue soluzioni. Per iniziare, scrivi a [email protected].

  • Devi decidere come gestire il pagamento. Di norma Inntopia Commerce regola le prenotazioni con il metodo del gateway esterno: la carta viene addebitata dal lato di Inntopia e la transazione viene registrata sulla prenotazione in Ventrata come gateway esterno.

 

  1. Nella Ventrata Dashboard, vai su Connections → Connections, fai clic su + New Connection e seleziona Inntopia Commerce dall'elenco dei partner.

  2. Crea un nuovo Checkout dedicato a questa connessione API. Non integrare questo Checkout nel tuo sito web. Inntopia lo carica nel proprio carrello per acquisire la selezione di prodotto, opzione, disponibilità e unità.

  3. Salvo accordi separati per elaborare il pagamento tramite il tuo gateway Ventrata, verifica che il Checkout usi il metodo di pagamento con carta External Gateway.

  4. Nell'elenco degli allowed hosts di quel Checkout, aggiungi tutti i domini da cui Inntopia caricherà il widget. Le richieste da domini non elencati restituiscono HOSTNAME_NOT_ALLOWED, quindi prima dei test chiedi al tuo referente di Inntopia l'elenco completo dei domini di staging e produzione.

  5. Quando crei la connessione, seleziona Inntopia Commerce dall'elenco dei partner, poi seleziona il Checkout che hai creato.

  6. Facoltativo: consenti/escludi prodotti o destinazioni sulla connessione per esporre solo l'inventario previsto dal tuo accordo.

  7. (Facoltativo) Puoi anche impostare un Name a tua scelta per la connessione: può essere utile se prevedi di avere più connessioni con Inntopia Commerce e vuoi distinguerle più facilmente in futuro.

  8. Fai clic sul pulsante Create Octo Connection.

 

 

📗 SUGGERIMENTO

Se necessario, puoi anche consentire o escludere prodotti o destinazioni a livello di connessione per limitare ciò a cui Inntopia Commerce può accedere.

 

Condividere l'accesso con Inntopia Commerce

Condividi in modo sicuro la chiave API OCTO mostrata sulla connessione che hai creato con il tuo referente di Inntopia per completare la configurazione.

 

La configurazione in Ventrata è completa. Puoi revocare l'accesso in qualsiasi momento disattivando la connessione.

 

Gestire la connessione con Inntopia Commerce

  • Revoca l'accesso disattivando la connessione.

  • Consenti o non consentire prodotti: limita le destinazioni, i prodotti e le opzioni a cui Inntopia Commerce può accedere. Scopri come consentire o non consentire prodotti.

  • Rinomina la connessione per distinguere più connessioni con Inntopia Commerce.

 

Come funzionano il pagamento e il Checkout

L'ospite completa l'intero acquisto nel carrello di Inntopia. Ventrata resta la fonte di riferimento per disponibilità, prezzi e offerte. Il pagamento viene incassato dal gateway di pagamento gestito di Inntopia e registrato in Ventrata come pagamento esterno, associato alla prenotazione come gateway esterno.

Il Checkout dedicato viene caricato da Inntopia nel proprio carrello per acquisire la selezione di prodotto, opzione, disponibilità e unità. Non deve essere integrato nel tuo sito web.

 

Funzionalità della connessione in dettaglio

Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Inntopia Commerce: cosa fa Inntopia Commerce con i tuoi dati Ventrata e quali chiamate all'API OCTO di Ventrata effettua.

 

Legge i prodotti

✅

Inntopia Commerce legge i prodotti abilitati sulla connessione.

Il funzionamento è il seguente:

  • Get Product (GET /products/{productId}) – Inntopia Commerce rilegge un singolo prodotto per recepire le modifiche.

 

Di solito con Inntopia Commerce: lo fa durante tutta la giornata.

Verifica la disponibilità

✅

Inntopia Commerce controlla la disponibilità dei prodotti abilitati sulla connessione.

Il funzionamento è il seguente:

  • Availability Check (POST /availability) – Inntopia Commerce invia un prodotto, un'opzione e delle date, e Ventrata risponde con ogni giorno o fascia oraria prenotabile e il relativo stato.

 

Di solito con Inntopia Commerce: lo fa durante tutta la giornata.

Sincronizza contenuti, disponibilità e prezzi

✅

I tuoi prodotti, la disponibilità e i prezzi arrivano nel carrello di Inntopia.

Contenuti, disponibilità, prezzi e offerte provengono da Ventrata.

Ventrata resta la fonte di riferimento.

 

Il funzionamento è il seguente:

  • Capability octo/pricing: Inntopia Commerce richiede i prezzi aggiungendola all'header Octo-Capabilities delle sue richieste. Senza di essa, Ventrata invia la disponibilità senza prezzi.

 

Di solito con Inntopia Commerce: lo fa durante tutta la giornata.

 

Cosa significa per te: i resort vendono ciò che hai effettivamente a disposizione.

Riceve le prenotazioni

✅

Nuove prenotazioni, modifiche e cancellazioni da Inntopia arrivano in Ventrata.

L'ospite acquista nel carrello di Inntopia.

Modifiche e cancellazioni vengono inviate a Ventrata.

 

Il funzionamento è il seguente:

  • Get Booking (GET /bookings/{uuid}) – Inntopia Commerce legge una singola prenotazione per recepirne i dettagli e lo stato più recenti.

  • Get Order (GET /orders/{id}): Inntopia Commerce legge l'ordine a cui appartiene una prenotazione.

 

Di solito con Inntopia Commerce: lo fa di tanto in tanto.

 

Cosa significa per te: gli ordini compaiono come normali prenotazioni.

Crea e modifica prenotazioni

✅

Inntopia Commerce crea o modifica prenotazioni in Ventrata.

Il funzionamento è il seguente:

  • Booking Reservation (POST /bookings) – Inntopia Commerce blocca i posti per una prenotazione.

  • Booking Confirmation (POST /bookings/{uuid}/confirm) – Inntopia Commerce conferma la prenotazione e Ventrata restituisce il tuo riferimento di prenotazione e i biglietti.

  • Booking Update (PATCH /bookings/{uuid}) – Inntopia Commerce modifica una prenotazione.

  • Booking Cancellation (POST /bookings/{uuid}/cancel) – Inntopia Commerce cancella una prenotazione. Ventrata lo accetta solo prima del termine di cancellazione.

Emette i biglietti

✅

Voucher o biglietti vengono emessi da Ventrata all'ospite tramite Inntopia.

L'emissione dei biglietti passa attraverso Ventrata.

Incassa il pagamento dal lato di Inntopia

✅

Il gateway di pagamento gestito di Inntopia addebita l'ospite.

Il pagamento viene registrato in Ventrata come pagamento esterno, con gateway esterno.

 

Cosa significa per te: non elabori questo pagamento tramite Ventrata, salvo accordi separati.

✅ supportato

 

FAQ

Inntopia Commerce non è nell'elenco quando creo una nuova connessione.

Questa integrazione viene attivata per singolo account. Contatta [email protected] per richiedere l'accesso.

Nella pagina della connessione non viene mostrato alcun prodotto.

Verifica quali destinazioni, prodotti e opzioni sono consentiti o esclusi sulla connessione. Se non basta, verifica che i tuoi prodotti e le tue opzioni siano disponibili alla vendita sulla fonte Direct API. Se il problema persiste, contatta il nostro team di assistenza.

Vedo HOSTNAME_NOT_ALLOWED quando si carica il widget di Inntopia.

Il dominio che carica il widget non è nell'elenco degli allowed hosts del Checkout. Raccogli dal tuo referente di Inntopia tutti i domini di staging e produzione e falli aggiungere.

All'ospite è stato addebitato il pagamento ma in Ventrata non compare alcuna prenotazione.

L'ordine non è stato confermato in Ventrata dopo l'incasso del pagamento dal lato di Inntopia. Chiedi al tuo referente di Inntopia l'x-request-id della richiesta di conferma, così possiamo rintracciarla, e contatta il nostro team di assistenza.

 

Risorse utili

 

 

Informazioni sul partner

Sterling Valley Systems, Inc.

PO Box 309, Stowe, VT 05672, United States

 

Ventrata Partner ID: 46209491-a755-4039-9370-8c92c0cdbafc

Hai ricevuto la risposta alla tua domanda?