Trasmissione diretta HESTA
CampOne aggrega già i dati che servono all’UST per la statistica federale degli alloggi (HESTA). Questo adapter li trasmette direttamente tramite l’API eHESTA ogni mese, sostituendo il flusso manuale di upload del CSV. Il download CSV resta disponibile come fallback.
Vedi anche: HESTA e conformità → Panoramica per il contenuto della statistica e il modo in cui i dati vengono raccolti.
Cosa Le offre
Sezione intitolata “Cosa Le offre”- Auto-invio il 5 di ogni mese (configurabile per tenant)
- Tiene traccia di ogni invio con il suo ID di acknowledgement UST e lo stato corrente
- Re-poll dello stato degli invii pendenti ogni 4 ore
- Download della ricevuta archiviato nel log di integrazione
- Il fallback CSV in
/admin/meldescheine/export/hesta-csv/resta disponibile
Prerequisiti
Sezione intitolata “Prerequisiti”La registrazione HESTA è per campeggio — ogni alloggio ha il proprio BUR-Nummer (codice azienda) rilasciato dall’UST. CampOne non può pre-registrare per Suo conto.
Cosa chiedere all’UST:
- La specifica tecnica XML eHESTA in vigore (PDF — non disponibile sul sito pubblico)
- La procedura di registrazione del Suo BUR-Nummer
- Username / password API per gli invii
- L’URL dell’endpoint di invio (test + produzione)
- Se può registrare CampOne come mittente tecnico centralizzato per più BUR-Nummern
Un template di e-mail in tedesco pronto da inviare si trova in docs-internal/handoffs/integrations-outreach-emails.md. Oppure contatti direttamente l’UST:
- E-mail: hotelstatistik@bfs.admin.ch
- Telefono: +41 58 461 12 55
Cosa incollerà in CampOne
Sezione intitolata “Cosa incollerà in CampOne”Impostazioni → Integrazioni → Vendor Adapters → HESTA direct:
| Campo | Descrizione |
|---|---|
| Hotel code | Override del meldeschein_hotel_code per tenant se necessario (di norma lasciare vuoto) |
| Submission endpoint | URL fornito dall’UST |
| API username / API password | Credenziali per tenant rilasciate dall’UST |
| Submission format version | Default 2024 — confermi con l’UST |
| Auto-submit | Spunti per attivare l’invio automatico mensile |
| Submission day of month | Default 5; l’auto-submit parte questo giorno per il mese precedente |
| Environment | Test finché l’UST non conferma la produzione |
Clicchi Save, poi Test connection. La verifica interroga un ID di ack chiaramente inesistente e tratta il 404 risultante come successo (credenziali valide, ID solo non trovato).
Cosa viene trasmesso
Sezione intitolata “Cosa viene trasmesso”Per ogni mese il dataset è identico al percorso CSV: conteggi per paese degli arrivi (entro il mese) e dei pernottamenti (giorni di sovrapposizione), aggregati a partire dai record Meldeschein. L’XML è strutturato secondo la specifica tecnica UST; la struttura delle colonne CSV equivalente è preservata per il cross-check.
Può inviare un mese manualmente dalla scheda delle impostazioni (Submit month…) — utile per i test o per reinviare dopo una correzione.
Stati di invio
Sezione intitolata “Stati di invio”Ogni invio attraversa:
- Pending — inviato all’UST, in attesa di elaborazione
- Accepted — l’UST ha confermato che i dati sono validi
- Rejected — l’UST ha respinto; la ricevuta spiega il motivo
La scheda delle impostazioni mostra ogni invio con il suo stato e un pulsante Refresh per interrogare l’UST sullo stato più aggiornato.
Contatti di supporto
Sezione intitolata “Contatti di supporto”- UST Hotelstatistik: hotelstatistik@bfs.admin.ch · +41 58 461 12 55
- Portale di login eHESTA: https://www.esurvey.bfs.admin.ch/eHESTA/LoginPage.aspx?langCD=1
- Finché l’UST non fornirà un handshake sandbox, la forma dell’envelope XML è best-effort e potrà richiedere un aggiustamento di un solo file quando confermeranno la specifica esatta.
- L’unità di invio è il mese; reinviare un mese sostituisce l’invio precedente per quel periodo.
- Gli invii aggregatori multi-azienda (un’unica istanza CampOne che invia per più BUR-Nummern) richiedono conferma dall’UST — chieda nella Sua e-mail iniziale.