Soumission HESTA directe

CampOne agrège déjà les données dont l’OFS a besoin pour la statistique fédérale de l’hébergement (HESTA). Cet adaptateur la soumet directement chaque mois via l’API eHESTA, en remplacement du flux de téléversement CSV manuel. Le téléchargement CSV reste disponible en repli.

Voir aussi : HESTA & Conformité → Aperçu pour ce que couvre la statistique et la façon dont les données sont collectées.

Ce que vous y gagnez

Soumission automatique le 5 de chaque mois (configurable par tenant)
Suivi de chaque soumission, avec son identifiant d’accusé de réception OFS et son statut courant
Re-interrogation du statut des soumissions en attente toutes les 4 heures
Téléchargement de l’accusé conservé dans le journal d’intégration
Repli CSV disponible sur /admin/meldescheine/export/hesta-csv/

Prérequis

L’inscription HESTA est par camping — chaque hébergement a son propre BUR-Nummer (code d’établissement) délivré par l’OFS. CampOne ne peut pas s’enregistrer pour vous.

À demander à l’OFS :

La spécification technique XML eHESTA en vigueur (PDF — non publiée sur le site public)
La procédure d’enregistrement de votre BUR-Nummer
Les identifiants API (nom d’utilisateur / mot de passe) pour les soumissions
L’URL de l’endpoint de soumission (test + production)
La possibilité d’enregistrer CampOne comme expéditeur technique centralisé pour le compte de plusieurs BUR-Nummern

Un modèle d’e-mail prêt à envoyer en allemand se trouve dans docs-internal/handoffs/integrations-outreach-emails.md. Ou contactez l’OFS directement :

E-mail : hotelstatistik@bfs.admin.ch
Téléphone : +41 58 461 12 55

Ce que vous collerez dans CampOne

Réglages → Intégrations → Adaptateurs fournisseurs → HESTA direct :

Champ	Description
Hotel code	Surcharge du `meldeschein_hotel_code` du tenant si nécessaire (à laisser vide en règle générale)
Submission endpoint	URL fournie par l’OFS
API username / API password	Identifiants par tenant fournis par l’OFS
Submission format version	Par défaut `2024` — à confirmer auprès de l’OFS
Auto-submit	Cochez pour activer la soumission mensuelle automatique
Submission day of month	Par défaut 5 ; la soumission automatique part ce jour-là, pour le mois précédent
Environment	`Test` jusqu’à confirmation par l’OFS

Cliquez sur Save, puis sur Test connection. La sonde interroge un identifiant d’accusé manifestement inexistant et traite le 404 comme un succès (identifiants valides, identifiant simplement introuvable).

Ce qui est soumis

Pour chaque mois, le jeu de données est identique à celui du flux CSV : le nombre d’arrivées par pays (sur le mois) et le nombre de nuitées (jours de chevauchement), agrégés à partir des Meldeschein. Le XML est mis en forme selon la spécification technique de l’OFS ; la structure de colonnes équivalente du CSV est préservée pour permettre les recoupements.

Vous pouvez soumettre un mois manuellement depuis la carte de réglages (Submit month…) — utile pour des tests ou pour resoumettre après une correction.

États de soumission

Chaque soumission passe par :

Pending — envoyée à l’OFS, en attente de traitement
Accepted — l’OFS a confirmé la validité des données
Rejected — l’OFS a rejeté ; l’accusé en explique la raison

La carte de réglages affiche chaque soumission avec son état et un bouton Refresh permettant d’interroger l’OFS pour le dernier statut.

Contacts de support

OFS Hotelstatistik : hotelstatistik@bfs.admin.ch · +41 58 461 12 55
Portail de connexion eHESTA : https://www.esurvey.bfs.admin.ch/eHESTA/LoginPage.aspx?langCD=1

Limites

En attendant que l’OFS fournisse une poignée de main bac à sable, la forme de l’enveloppe XML est best-effort et pourra nécessiter un ajustement d’un seul fichier lorsque l’OFS confirmera la spécification exacte.
L’unité de soumission est le mois ; resoumettre un mois remplace la soumission précédente pour cette période.
Les soumissions agrégées multi-établissements (une instance CampOne soumettant pour le compte de plusieurs BUR-Nummern) demandent une confirmation de l’OFS — à demander dans votre premier e-mail.