Novità È disponibile GajaCms 2026.11 — regioni del sito, privacy e consensi, pubblicazione multipla. Leggi il changelog

Guida di GajaCms Guida di GajaCms v. 2026.11
ADD-ON

Alpitour

L'add-on Alpitour collega il sito all'API Alpitour World: importa il calendario delle partenze con i prezzi «a partire da», calcola preventivi in tempo reale sul sito e nel CMS e, a richiesta, aggiorna i contenuti delle strutture.

Requisiti

  • Modello di vendita Travel attivo sul sito.

  • Una tipologia di prodotto con modello Pacchetti a partenze fisse.

  • Credenziali dell'API Alpitour World (AW Exchange) rilasciate da Alpitour all'agenzia di viaggi.

  • Prodotti del sito con il codice struttura Alpitour: sigla del marchio seguita dal codice hotel, per esempio AL12921. I prodotti si possono creare anche dal report del task, come descritto in «Creare i prodotti dal report».

Il funzionamento comune a tutti gli add-on è descritto in Add-on. La prenotazione presso Alpitour non è inclusa: la soluzione quotata diventa una richiesta o una proposta di preventivo.

Credenziali

Nella finestra Credenziali il valore di autorizzazione rilasciato da Alpitour si inserisce in Chiave segreta; Chiave accoglie il codice agenzia Alpitour, quando previsto. L'add-on lavora solo sull'ambiente di produzione di Alpitour: l'opzione Ambiente di test non ha effetto.

Calendario e prezzi

Il task Calendario e prezzi importa partenze, aeroporti di partenza e prezzo «a partire da» per persona. Oltre alle tipologie e allo stato del task, la scheda Task comprende:

Gruppo

Impostazioni

Ricerca

Modalità: Per destinazione, una ricerca per ogni codice destinazione (keyd), conveniente quando il sito vende buona parte del catalogo; Per struttura, una ricerca per ogni prodotto della tipologia, conveniente con poche strutture.

Destinazioni

Nome e codici keyd di ogni destinazione. Carica predefinite aggiunge le destinazioni standard; i codici non più presenti nel feed Alpitour sono segnalati.

Marchi

Marchi Alpitour da interrogare; nessun marchio scelto equivale a tutti.

Filtri

Mesi in avanti, Adulti e Notti da / Notti a. Il prezzo «a partire da» è per persona, calcolato sul numero di adulti.

Prestazioni

Concorrenza e Righe per pagina, riservati al developer.

Il calendario è indicativo: il prezzo reale di una soluzione arriva dal preventivo in tempo reale. Ogni prezzo mostrato applica il ricarico o lo sconto della tipologia di prodotto.

Creare i prodotti dal report

Il report di ogni esecuzione del task Calendario e prezzi, nella scheda Esecuzioni, elenca in Prodotti non collegati le strutture presenti nel listino Alpitour per le destinazioni del task che non hanno ancora un prodotto sul sito. Per ogni struttura, Crea prodotto apre la finestra di creazione.

Campo

Descrizione

Codice fornitore

Codice della struttura Alpitour, non modificabile.

Nome

Proposto dal listino del fornitore; si può cambiare anche in seguito nella scheda prodotto.

Categoria

Categoria del sito in cui compare il prodotto. Se esiste una categoria con il nome della località del fornitore, viene proposta con l'indicazione Località del fornitore.

Tipologia

Solo le tipologie gestite dal task. Il campo compare quando il task ne gestisce più di una.

Contenuti dal fornitore

Sezioni della scheda Alpitour da importare subito, con Massimo foto. La sezione compare se il sito usa il task Contenuti delle strutture.

Scarica subito partenze e prezzi

Attiva di default. Alla creazione parte un'esecuzione del task limitata alla struttura, che crea sistemazioni, partenze e prezzi in pochi minuti. Non conta nelle esecuzioni manuali del giorno.

Dopo la creazione la riga indica Creato con il comando Apri prodotto. Durante lo scaricamento compare Scaricamento partenze in corso…; al termine, il numero di partenze scaricate. L'esecuzione è visibile anche nella scheda Esecuzioni, indicata come Struttura seguito dal codice.

  • Il prodotto nasce offline: si pubblica dopo aver controllato contenuti, sistemazioni e partenze.

  • Con l'opzione disattivata, o se il task è già in esecuzione, partenze e prezzi arrivano con la prossima esecuzione del task.

  • Se il codice ha già un prodotto sul sito non se ne crea un secondo: la riga indica Creato con il collegamento al prodotto esistente.

  • La tipologia del prodotto si può cambiare in seguito scegliendo un'altra tipologia gestita dal task, così il prodotto continua a ricevere gli aggiornamenti.

Crea prodotto

Esito delle esecuzioni

Ogni esecuzione termina con uno degli stati seguenti, visibili nel riepilogo in Ultima esecuzione e nella scheda Esecuzioni.

Stato

Significato

Completata

Listino scaricato per tutte le destinazioni del task. Le partenze non più in vendita vengono chiuse.

Completata con avvisi

Esecuzione conclusa con segnalazioni nel report, per esempio destinazioni non scaricate.

Non riuscita

Esecuzione interrotta: credenziali rifiutate, fornitore non raggiungibile o nessuna destinazione scaricata. Il motivo è indicato nel report e nella scheda Diagnostica.

Destinazioni non scaricate

Se il fornitore non restituisce una destinazione neanche dopo tre tentativi, la destinazione viene saltata e le altre vengono importate regolarmente. L'esecuzione termina come Completata con avvisi e il riepilogo indica il numero di destinazioni non scaricate.

Il report riporta in Destinazioni non scaricate il codice di ogni destinazione, il motivo e il numero di strutture non aggiornate, che mantengono le partenze dell'ultima importazione riuscita. In quell'esecuzione nessuna partenza viene tolta dal sito: le partenze non più disponibili si chiudono alla prossima esecuzione completa. Nella scheda Diagnostica il giorno risulta come anomalia del fornitore.

Una destinazione senza partenze nella stagione, per esempio una meta estiva nei mesi invernali, non è un errore e non compare tra le destinazioni non scaricate. Se l'errore sulla stessa destinazione si ripete ogni giorno, va verificato il codice della destinazione nelle impostazioni del task.

Partenze non più in vendita

Con il listino completo, le partenze future che Alpitour non propone più vengono chiuse, comprese quelle delle strutture assenti dal listino del giorno. Le partenze chiuse non compaiono sul sito e non si possono prenotare; restano collegate al prodotto e si riaprono quando il fornitore le propone di nuovo.

Preventivo in tempo reale

Per una partenza, un aeroporto e una composizione delle camere, il preventivo interroga Alpitour e restituisce le soluzioni disponibili con camera, trattamento, voli e prezzo di vendita.

Sul sito. Quando il sito lo prevede, il cliente richiede le soluzioni dalla pagina del pacchetto; la soluzione scelta arriva nel CMS insieme alla richiesta di preventivo.

Nel CMS. Nella proposta di preventivo, per un prodotto Alpitour, il comando Richiedi al fornitore sostituisce il calcolo dal listino:

  • la richiesta copre tutte le camere, con un massimo di 4 ospiti per camera;

  • si sceglie una soluzione per ogni camera; le soluzioni scelte devono avere gli stessi voli;

  • le soluzioni restano valide 15 minuti: scadute, si aggiornano con Richiedi di nuovo;

  • se il fornitore non risponde, il calendario resta disponibile come prezzo indicativo.

Preventivo Alpitour

Contenuti delle strutture

Il task Contenuti delle strutture aggiorna i prodotti con i dati della scheda Alpitour. È Solo a richiesta: si avvia con Importa contenuti ora e lavora sulle stesse tipologie di Calendario e prezzi.

In Sezioni da aggiornare si scelgono le parti da importare: nome, testi brevi, classificazione, posizione, foto, sistemazioni, caratteristiche, FAQ e programma. Massimo per struttura limita le foto importate per struttura e per sistemazione.

  • I campi modificati dall'operatore non vengono sovrascritti.

  • Le foto caricate dall'operatore non vengono toccate; quelle del fornitore sono copiate nello storage del sito.

  • I contenuti si scrivono nella lingua italiana del sito.

  • Il task non crea prodotti e non modifica codici, prezzi, partenze né indirizzi delle pagine.

Caratteristiche

La scheda Caratteristiche elenca le caratteristiche del fornitore lette dall'ultima importazione dei contenuti. Per ognuna, Collegata a indica la destinazione nel sito:

  • un servizio del sito, per indicare la presenza del servizio (per esempio Wi-Fi o piscina);

  • una caratteristica del tipo, con un valore sì/no, testo, numero o scelta;

  • Ignora, per escluderla.

Crea aggiunge il servizio o la caratteristica con il nome del fornitore. Il collegamento vale per tutti i prodotti della tipologia; finché una caratteristica non è collegata, il dato corrispondente dei prodotti non si aggiorna.

Codici dei prodotti

Il report segnala i codici da verificare:

Sezione

Significato

Codici cambiati presso il fornitore

La struttura è nel catalogo Alpitour con un codice diverso. Usa questo codice aggiorna il codice del singolo prodotto.

Codici non validi

Prodotti con un codice che non appartiene ad Alpitour: il task li ignora.

Strutture del sito non nel catalogo

Prodotti assenti dal catalogo del giorno, per esempio stagionali o non più in vendita: le partenze future vengono chiuse e si riaprono quando la struttura torna nel catalogo.