HESTA Direkt-Übermittlung

CampOne aggregiert ohnehin schon die Daten, die das BFS für die Bundesstatistik der Beherbergung (HESTA) benötigt. Dieser Adapter übermittelt sie monatlich direkt über die eHESTA-API und ersetzt damit den manuellen CSV-Upload. Der CSV-Download bleibt als Rückfallweg verfügbar.

Siehe auch: HESTA & Compliance → Überblick zum Inhalt der Statistik und zur Datenerhebung.

Was Sie damit erhalten

Automatische Übermittlung am 5. jedes Monats (pro Mandant konfigurierbar)
Verfolgung jeder Übermittlung mit BFS-Bestätigungs-ID und aktuellem Status
Status-Nachfrage für offene Übermittlungen alle 4 Stunden
Quittungsdokument im Integrationsprotokoll abgelegt
CSV-Rückfallweg unter /admin/meldescheine/export/hesta-csv/ weiterhin verfügbar

Voraussetzungen

Die HESTA-Registrierung erfolgt pro Campingplatz — jeder Beherbergungsbetrieb hat eine eigene BUR-Nummer (Betriebsidentifikator), die das BFS ausgibt. CampOne kann diese nicht für Sie beantragen.

Was Sie beim BFS anfragen sollten:

Die aktuelle technische eHESTA-XML-Spezifikation (PDF — nicht öffentlich zugänglich)
Das Verfahren zur Registrierung Ihrer BUR-Nummer
API-Benutzername und -Passwort für Übermittlungen
Die URL des Übermittlungs-Endpoints (Test und Produktion)
Die Möglichkeit, CampOne als zentralen technischen Absender für mehrere BUR-Nummern zu registrieren

Eine vorgefertigte deutsche E-Mail-Vorlage liegt unter docs-internal/handoffs/integrations-outreach-emails.md. Alternativ wenden Sie sich direkt ans BFS:

E-Mail: hotelstatistik@bfs.admin.ch
Telefon: +41 58 461 12 55

Was Sie in CampOne eintragen

Einstellungen → Integrationen → Anbieter-Adapter → HESTA Direkt:

Feld	Beschreibung
Hotel-Code	Übersteuert bei Bedarf den `meldeschein_hotel_code` des Mandanten (üblicherweise leer lassen)
Übermittlungs-Endpoint	Vom BFS gelieferte URL
API-Benutzername / API-Passwort	Pro Mandant vom BFS ausgestellte Zugangsdaten
Format-Version	Standard `2024` — beim BFS bestätigen
Auto-Übermittlung	Setzen, um die monatliche automatische Übermittlung zu aktivieren
Übermittlungstag des Monats	Standard 5; die automatische Übermittlung erfolgt an diesem Tag für den Vormonat
Umgebung	`Test`, bis das BFS die Produktion freigibt

Klicken Sie auf Speichern und dann auf Verbindung prüfen. Der Test fragt eine offensichtlich nicht existierende Bestätigungs-ID ab; das daraus folgende 404 wird als Erfolg gewertet (Zugangsdaten gültig, ID nur nicht auffindbar).

Was übermittelt wird

Die übergebenen Daten entsprechen pro Monat genau dem CSV-Inhalt: Anzahl Ankünfte (innerhalb des Monats) und Übernachtungen (Überlappungstage) je Herkunftsland, aggregiert aus den Meldeschein-Datensätzen. Das XML folgt der technischen BFS-Spezifikation; die Spaltenstruktur des CSV ist parallel erhalten, um Quervergleiche zu erlauben.

Sie können einen Monat auch manuell übermitteln (Monat einreichen… auf der Einstellungskarte) — nützlich für Tests oder zur Nachreichung nach einer Korrektur.

Übermittlungs-Status

Jede Übermittlung durchläuft folgende Zustände:

Pending — beim BFS eingereicht, wartet auf Verarbeitung
Accepted — BFS bestätigt die Daten als gültig
Rejected — BFS lehnt ab; die Quittung erläutert den Grund

Die Einstellungskarte listet jede Übermittlung mit ihrem Status und einer Schaltfläche Aktualisieren, um den Status beim BFS abzufragen.

Support-Kontakte

BFS-Hotelstatistik: hotelstatistik@bfs.admin.ch · +41 58 461 12 55
eHESTA-Login-Portal des BFS: https://www.esurvey.bfs.admin.ch/eHESTA/LoginPage.aspx?langCD=1

Einschränkungen

Solange das BFS keinen Sandbox-Handshake bereitstellt, ist die Form des XML-Umschlags eine Annäherung; sie erfordert ggf. eine kleine Anpassung in einer Datei, sobald das BFS die genaue Spezifikation bestätigt.
Die Übermittlungseinheit ist ein Monat; eine erneute Übermittlung ersetzt die vorherige für denselben Zeitraum.
Sammelübermittlungen für mehrere Betriebe (eine CampOne-Instanz übermittelt für mehrere BUR-Nummern) müssen mit dem BFS abgeklärt werden — fragen Sie das in Ihrer ersten Anfrage mit ab.