Vai al contenuto principale

Pax365: backend operatore

Collega Pax365 a Ventrata per rivendere i prodotti degli operatori Pax365 con disponibilità, prezzi e prenotazioni in tempo reale.

Pax365 logo

 

Pax365 è un sistema di prenotazione e gestione flotte per operatori di tour e attività, sviluppato dalla software house di Dublino Odin Consultants e usato soprattutto da titolari-operatori irlandesi e piccole flotte di pullman e tour. Gestisce la programmazione dei tour, l'assegnazione di autisti e guide, la documentazione di conformità dei veicoli, i pagamenti e l'accesso dei rivenditori da un unico back office.

 

Collegare Pax365 a Ventrata ti permette di rivendere i prodotti di operatori che usano Pax365 come sistema di prenotazione. Ventrata legge da Pax365 la loro disponibilità e i loro prezzi in tempo reale e ogni prenotazione che ricevi viene creata direttamente nell'account Pax365 dell'operatore.

 

Per saperne di più su Pax365, visita pax365.com.

 

Sito web principale

Tag

Custom / Proprietary Operator System

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

Ventrata (tramite Pax365 OCTO API)

 

Questa connessione operatore (detta anche backend) ti permette di rivendere i prodotti di operatori che usano Pax365 come sistema di prenotazione principale, e ogni prenotazione viene creata direttamente in Pax365. Le funzionalità di questa connessione includono:

  • Availability Sync – la disponibilità in tempo reale proviene dall'account Pax365 dell'operatore.

  • Pricing Sync – i prezzi arrivano da Pax365, oppure li imposti tu in Ventrata.

  • Bookings Sync – prenotazioni, modifiche e cancellazioni vengono inviate da Ventrata a Pax365 e Pax365 emette i biglietti o i voucher.

 

Creare la connessione con Pax365

🔐 Autorizzazioni di ruolo richieste: See Operators, Modify Operators, See Products, Modify Products

Prima di iniziare:

  • Devi avere un accordo commerciale con l'operatore per le sue tariffe e condizioni.

  • Devi avere la OCTO API Key per l'operatore. Vedi i passaggi seguenti.

  • Devi ricreare i prodotti dell'operatore in Ventrata. Scopri come creare i prodotti. La connessione sincronizza disponibilità, prezzi e prenotazioni, ma non crea i prodotti in Ventrata.

 

Passaggio 1: configurare l'operatore in Ventrata

Il tuo operatore la ottiene dal proprio referente di Pax365. Al momento si tratta di una procedura manuale che richiede l'aiuto del team di Pax365.

 

  1. Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.

  2. Nella sezione Backend Partner, seleziona Pax365 e inserisci la OCTO API Key. Lascia l'endpoint predefinito, a meno che Pax365 o il tuo operatore non indichino diversamente.

  3. Lascia il campo OCTO Endpoint con il valore predefinito precompilato, a meno che il tuo operatore non ti indichi diversamente.

  4. Press Update Operator.

 

 

 

📒 NOTA – Ogni chiave API OCTO ti collega a un solo operatore. Configura ciascun operatore Pax365 separatamente.

 

Passaggio 2: collega ogni prodotto

  1. Apri il prodotto dell'operatore in Products → Products e modificalo. Verifica che Operator sia impostato su questo operatore.

  2. Seleziona Backend Connected. Seleziona Backend Availability per usare la disponibilità di Pax365 e Backend Pricing per usare i prezzi di Pax365.

  3. Press Update Product.

📒 NOTA

Pax365 invia solo i prezzi al pubblico. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico e calcola il tuo prezzo netto (di costo) usando la percentuale di costo impostata sull'operatore nella Ventrata Dashboard.

 

Seleziona Backend Connected, poi Backend Availability per recuperare la disponibilità e Backend Pricing per recuperare i prezzi.

 

Senza Backend Availability e/o Backend Pricing, il prodotto usa la disponibilità e/o i prezzi impostati in Ventrata, ma invia comunque le prenotazioni a Pax365.

 

 

Mappare i prodotti su Pax365

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di Pax365 verificare la disponibilità e prenotare. Se un prodotto collegato al backend non è mappato correttamente, le sue prenotazioni non vanno a buon fine. Un'evidenziazione rossa sull'intera riga del prodotto indica un prodotto mappato in modo errato.

 

  1. Nella Ventrata Dashboard, vai su Products → Products e apri il prodotto.

  2. Apri la scheda Mappings. Compare dopo che il prodotto è stato impostato come Backend Connected.

  3. Per ogni opzione e unità Ventrata, seleziona dai menu a tendina, che Ventrata carica da Pax365, il prodotto, l'opzione e le unità corrispondenti di Pax365. Non lasciare nessun campo vuoto.

  4. Press Save Changes.

 

 

📗 SUGGERIMENTO

Dopo la mappatura effettua una prenotazione di test e chiedi all'operatore di confermare che sia arrivata nel suo account Pax365.

 

Gestire la connessione con Pax365

  • Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in Pax365.

  • Sostituisci la chiave sull'operatore se Pax365 o l'operatore ne emettono una nuova.

  • Disattiva Backend Availability o Backend Pricing su un prodotto per usare invece la disponibilità o i prezzi di Ventrata. Le prenotazioni vengono comunque inviate a Pax365.

 

Funzionalità della connessione in dettaglio

Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Pax365. Qui la direzione è opposta a quella di una connessione rivenditore: è Ventrata a chiamare Pax365, tramite Pax365 OCTO API. Per ogni funzionalità spiega quali chiamate effettua Ventrata, quando e cosa significa per te.

 

In breve: Ventrata chiede a Pax365 disponibilità e prezzi ogni volta che qualcuno visualizza un prodotto collegato al backend e crea ogni prenotazione nell'account Pax365 dell'operatore. Pax365 non rinvia modifiche a Ventrata.

 

Le tempistiche sono quelle tipiche di Pax365, arrotondate, e possono cambiare.

 

Product Mapping

✅

Mappi ogni prodotto, opzione e unità Ventrata al prodotto Pax365 dell'operatore nella Ventrata Dashboard.

Il funzionamento è il seguente:

  • Get Products (GET /products) – Ventrata legge prodotti, opzioni e unità dell'operatore in Pax365 per popolare i menu a tendina della scheda Mappings.

 

Cosa significa per te: se qualcosa manca nel menu a tendina, l'operatore non te l'ha reso disponibile in Pax365. Chiedigli di farlo.

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da Pax365.

Ventrata non importa i contenuti dei prodotti da Pax365. Crei e descrivi tu stesso i prodotti in Ventrata.

Availability Sync

✅

Con Backend Availability attivo, Ventrata verifica la disponibilità in tempo reale dell'operatore in Pax365.

Il funzionamento è il seguente:

  • Availability Check (POST /availability) – quando qualcuno usa il calendario della disponibilità in Ventrata, ad esempio nella Dashboard, nel tuo web checkout o su un terminale, Ventrata interroga Pax365 in tempo reale per le date visualizzate.

  • Ventrata invia una richiesta in tempo reale a Pax365 quando un utente interagisce con il calendario della disponibilità, di solito per intervalli di 7 giorni o per un giorno specifico. Il calendario può mostrare dati in cache, non in tempo reale, dell'ultima richiesta.

 

Di solito con Pax365:

  • Le richieste coprono 7 giorni alla volta, da oggi fino a circa un anno in avanti, mentre gli utenti navigano e mentre Ventrata carica il calendario.

 

Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in Pax365, quindi non puoi vendere in eccesso una fascia oraria che l'operatore ha già venduto altrove.

Pricing Sync

✅

Con Backend Pricing attivo, Ventrata prende i prezzi da Pax365.

Il funzionamento è il seguente:

  • Availability Check con la capability octo/pricing – Ventrata chiede a Pax365 i prezzi a ogni richiesta di disponibilità.

  • Con Backend Pricing, Ventrata recupera sia i prezzi al pubblico sia i prezzi netti (all'ingrosso) insieme alla disponibilità, memorizzati in cache/salvati in Ventrata come tariffe generate dall'API. I prezzi netti di Pax365 vengono registrati come prezzi di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

  • Con Backend Pricing disattivato, il prodotto usa i prezzi che imposti in Ventrata e le prenotazioni vengono comunque inviate a Pax365.

Pax365 invia solo i prezzi al pubblico. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico e calcola il tuo prezzo netto (di costo) usando la percentuale di costo impostata sull'operatore nella Ventrata Dashboard.

Promotions Sync

❌

Le promozioni non vengono inviate a Pax365.

Le promozioni non vengono inviate a Pax365. Le tue promozioni Ventrata si applicano comunque al prezzo che il cliente paga in Ventrata.

Bookings Sync

✅

Le prenotazioni effettuate in Ventrata per un prodotto collegato al backend vengono create nell'account Pax365 dell'operatore.

Il funzionamento è il seguente:

  1. Blocco: Booking Reservation (POST /bookings) – quando il prodotto viene aggiunto al carrello in Ventrata, Ventrata riserva i posti in Pax365.

  2. Conferma: Booking Confirmation (POST /bookings/{uuid}/confirm) – dopo il pagamento, Ventrata conferma la prenotazione in Pax365 con i dati di contatto del cliente, e il biglietto o voucher restituito da Pax365 diventa il biglietto o voucher Ventrata.

  3. Modifica: Booking Update (PATCH /bookings/{uuid}) – le modifiche effettuate in Ventrata vengono inviate a Pax365.

  4. Cancellazione: Booking Cancellation (POST /bookings/{uuid}/cancel) – le cancellazioni effettuate in Ventrata vengono inviate a Pax365.

Blocco quando un prodotto viene aggiunto al carrello. Conferma dopo il pagamento, con i dati di contatto del cliente. Pax365 non restituisce alcun voucher/biglietto a Ventrata, quindi per la prenotazione vengono usati valori generati da Ventrata. Modifiche e cancellazioni vengono inviate a Pax365 tramite API.

 

‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Pax365. Se l'operatore modifica o cancella una prenotazione in Pax365, Ventrata non riceve alcuna notifica. Chiedi all'operatore di informarti di eventuali modifiche.

Pickups/Dropoff Sync

❌

I dettagli di pickup e drop-off non vengono trasmessi a Pax365.

I dettagli di pickup e drop-off non vengono trasmessi a Pax365. Se un prodotto li richiede, comunicali all'operatore in un altro modo.

Custom Questions Sync

❌

Le risposte alle tue domande di prenotazione non vengono trasmesse a Pax365.

Le risposte alle tue domande di prenotazione non vengono trasmesse a Pax365. Se l'operatore ne ha bisogno, comunicagliele in un altro modo.

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in Pax365.

Extra e componenti aggiuntivi non vengono prenotati in Pax365. Vengono prenotati solo prodotto, opzione e unità principali.

Redemption Sync

❌

I riscatti e le altre modifiche di stato in Pax365 non vengono rinviati a Ventrata dopo la conferma di una prenotazione.

I riscatti e le altre modifiche di stato in Pax365 non vengono rinviati a Ventrata dopo la conferma di una prenotazione.

Non supportato. Lo stato della prenotazione in Pax365 (ad esempio Redeemed) non viene comunicato a Ventrata.

Pass Walkup Scanning Sync

❌

La scansione dei pass walk-up non è disponibile con Pax365.

La scansione dei pass walk-up non è disponibile con Pax365.

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a Pax365.

Le carte regalo Ventrata non vengono trasmesse a Pax365. I pagamenti con carta regalo restano in Ventrata.

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Pax365

  • Disponibilità in tempo reale: la disponibilità arriva da Pax365 mentre gli utenti navigano.

  • Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in Pax365 non arrivano a Ventrata.

 

FAQ

Ricevo un errore quando salvo la configurazione del backend dell'operatore.

Molto probabilmente la OCTO API Key o l'endpoint non sono corretti. Verificali con il tuo operatore. Se il problema persiste, contatta il nostro supporto tecnico.

Nelle impostazioni del prodotto non c'è la casella Backend Connected.

Molto probabilmente l'operatore impostato sul prodotto non ha un backend configurato. Controlla le impostazioni Backend Partner dell'operatore e riprova. Se il problema persiste, contatta il nostro supporto tecnico.

Il prodotto, l'opzione o l'unità che voglio mappare non compare nel menu a tendina.

I menu a tendina elencano ciò che l'operatore ti ha reso disponibile in Pax365. Chiedi all'operatore. Se il problema persiste, contatta il nostro supporto tecnico.

Le prenotazioni non vanno a buon fine per un prodotto collegato al backend.

Controlla prima la mappatura del prodotto: ogni opzione e unità deve essere mappata. Poi verifica che la fascia oraria sia ancora disponibile in Pax365. Se il problema persiste, contatta il nostro supporto tecnico.

Errore durante l'aggiornamento dell'operatore per salvare la configurazione del backend.

Probabilmente la OCTO API Key o l'OCTO Endpoint non sono corretti. Ricontrollali con il tuo operatore. Se il problema persiste, contatta l'assistenza.

Il prodotto/l'opzione/l'unità che voglio mappare non è nel menu a tendina.

Il menu a tendina viene recuperato da Pax365 in base a prodotti, opzioni e unità che il tuo operatore ti ha reso disponibili. Verifica con il tuo operatore. Se il problema persiste, contatta il supporto.

 

Risorse utili

 

 

Informazioni sul partner

The Digital Depot (Odin)

Thomas Street West, The Digital Hub

Dublin D08 TCV4, Ireland

 

Ventrata Partner ID: ee8bb38c-1dcd-4703-a24e-1d1ce781cbd5

Hai ricevuto la risposta alla tua domanda?