
Hébergement et canaux
Location saisonnière : choisir entre API et calendrier iCal
Le mot « connecté » peut désigner un échange de calendriers ou une intégration plus complète. Choisissez selon les champs à maintenir et les opérations à reprendre. La fiabilité se vérifie sur chaque canal, pas sur la liste de logos affichée par le logiciel.
Nommer ce qui circule réellement
Airbnb distingue la liaison avec PMS ou channel manager en synchronisation complète et en synchronisation du prix et de la disponibilité. Son aide décrit aussi l’import et l’export de calendriers iCal. Ces mécanismes ne doivent pas être présentés comme un même accès fonctionnel.
Établissez une ligne par canal et champ : calendrier, prix, restriction, contenu, réservation, modification et message. Notez système de référence, sens de circulation et limite connue. L’absence d’une capacité doit rester explicite.
Rapprocher logement, annonce et unité louée
Un logement peut avoir plusieurs annonces ou configurations. Conservez les identifiants de chaque canal et documentez ce qui consomme la capacité physique. Une chambre et le logement entier ne doivent pas être traités comme deux stocks indépendants si leur vente s’exclut.
Préparez un cas de fermeture d’une unité et vérifiez toutes les annonces concernées. Validez les correspondances avant import des réservations futures ; une erreur d’identité se propage ensuite aux prix et aux messages.
Examiner les délais et la portée du calendrier
Pour iCal, vérifiez ce que le calendrier importé bloque et comment il est rafraîchi. Ne supposez ni prix, ni messages, ni synchronisation immédiate. Documentez les champs qui restent maintenus dans chaque plateforme et les contrôles quotidiens nécessaires.
Demandez comment une indisponibilité de flux est détectée. Un calendrier figé peut rester plausible à l’écran. Suivez la dernière mise à jour réussie, les écarts connus et la personne qui ferme la vente lorsqu’un doute affecte la capacité.
Séparer disponibilité et communication voyageur
Les données de réservation et les droits de messagerie peuvent varier selon le canal. Le personnel doit savoir où répondre et quelle information utiliser après une modification. Un message automatique fondé sur une ancienne date peut être plus dommageable qu’un message envoyé manuellement.
Reliez arrivée, accès, nettoyage et consignes à la bonne version du séjour. Conservez un canal de reprise lorsque l’intégration ou le compte propriétaire est indisponible.
Rejouer les changements qui consomment le stock
- Bloquer une nuit dans le système de référence et constater sa propagation.
- Modifier durée et occupation d’un séjour autorisé.
- Annuler la réservation et contrôler la capacité rendue.
- Simuler un flux interrompu et observer l’alerte.
- Vérifier deux annonces consommant la même unité physique.
Consignez les temps réellement observés ; ne les extrapolez pas à tous les canaux. Utilisez le modèle de couverture.
Basculer avec les réservations ouvertes
Avant changement de logiciel, rapprochez toutes les réservations futures, acomptes, coordonnées nécessaires et consignes. Identifiez qui peut encore modifier les dossiers provenant de l’ancien système. Une nouvelle connexion n’efface pas les obligations liées à ces séjours.
Fixez un moment de bascule et un plan de retour. Faites valider la reprise par l’équipe d’accueil et d’exploitation, puis gardez une liste des écarts jusqu’à résolution.
Distinguer mise à jour de description et blocage de dates
Scénario fictif : Un hébergement reçoit une correction de description tandis que ses calendriers sont synchronisés séparément. Faites identifier l’opération et le format de chaque flux.
| Point | Preuve | Contrôle proposé |
|---|---|---|
| Contrat à conserver | Contrat de description et contrat de calendrier | Faire préciser ce qui est fourni et ce que le traitement peut conclure. |
| Résultat à rapprocher | Objets réellement affectés | Comparer le résultat effectivement observé à celui attendu pour ce cas. |
| Décision de reprise | Une mise à jour JSON n’est pas présumée changer un calendrier iCal. | Attribuer la suite et garder l’inconnue visible tant que la preuve manque. |
Une mise à jour JSON n’est pas présumée changer un calendrier iCal.
Cadre documentaire : IETF : RFC 7396, JSON Merge Patch — référence consultée le . Transformation des valeurs JSON selon RFC 7396 ; ce mécanisme doit être explicitement supporté par l’API avant tout usage.
Approfondir le parcours : Consignes d’arrivée en location : bonne version, bon séjour et recours
La connectivité locative doit aussi permettre de revoir les consignes déjà assignées après une modification. Le calendrier mis à jour ne prouve pas que le voyageur recevra le bon lieu et la bonne instruction. Rapprochez ces sorties avec le dossier courant et son recours.
Consignes d’arrivée en location : bonne version, bon séjour et recours · Rapprocher les preuves du parcours
Un blocage propriétaire qui ne se retrouve pas partout
Cas fictif proposé pour préparer vos contrôles ; aucun résultat fournisseur n’est présumé.
Un gestionnaire fictif bloque un logement pour une intervention, mais une recherche effectuée sur un canal secondaire propose encore les mêmes dates.
- Action à préparer
- Vérifier le logement et les dates exactes, puis comparer le calendrier source, l’état de l’envoi et l’affichage du canal. Éviter de créer une réservation réelle pour diagnostiquer le problème.
- Pièces à rapprocher
- Conserver une capture datée des deux états, la référence du logement et la réponse du support. Préciser si le décalage concerne le calendrier, le contenu ou les deux.
- Décision à documenter
- Maintenir la période hors vente jusqu’à obtenir un état cohérent ou un contournement approuvé par le gestionnaire ; programmer un contrôle de retour après correction.
Airbnb : vérifier chaque calendrier importé, pas seulement la dernière réservation
La synchronisation iCal peut laisser un décalage entre deux canaux. Chaque calendrier importé a sa propre date de mise à jour.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Fréquence d’import | Airbnb annonce une récupération automatique des calendriers associés toutes les 3 heures. | Ne présentez pas cette liaison comme une mise à jour instantanée du stock. |
| Contrôle manuel | Actualiser permet de demander une mise à jour ; le nombre de demandes est limité. | Consultez l’heure du dernier import pour chaque calendrier, sans supposer qu’ils sont actualisés ensemble. |
| Nuits bloquées | Les nuits réservées ailleurs sont importées ; certains blocages de préparation ou de délai avant arrivée peuvent ne pas l’être. | Rejouez un blocage sans réservation, puis contrôlez sa présence sur Airbnb. |
| Horizon et arrêt | L’import couvre jusqu’à 2 ans. Le calendrier ne peut pas être mis en pause : il faut le désassocier puis le réassocier. | Contrôlez aussi la liaison lors d’un changement de logiciel. |
Comportement de l’import Airbnb consulté le 22 octobre 2026. Le rafraîchissement dans l’autre sens dépend du site qui reçoit le calendrier Airbnb.
Airbnb — synchroniser le calendrier d’hôte avec d’autres sites · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Guesty Open API : séparer quota de jetons et appels métier
L’authentification a son propre budget. Recréer un jeton à chaque traitement peut interrompre l’intégration alors que le code des réservations n’a pas changé.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Demandes de jetons | Le guide indique au plus cinq demandes de jeton par clé d’API sur vingt-quatre heures. | Ce budget concerne l’obtention des jetons, pas cinq lectures de réservation ni cinq utilisateurs du logiciel. |
| Validité | Un jeton reste valide vingt-quatre heures ; expires_in fournit sa durée, habituellement 86 400 secondes. | Réutilisez un jeton valide et suivez son échéance ; un redémarrage du programme ne justifie pas à lui seul une nouvelle demande. |
| Attente de renouvellement | Dans ce contexte d’authentification, ratelimit-reset exprime un nombre de secondes avant régénération du créneau utilisé. | N’appliquez pas la lecture d’un horodatage Unix provenant d’un autre prestataire à cet en-tête. |
| Périmètre partenaire | Le guide demande aux partenaires Marketplace ou Channel/OTA de contacter le circuit partenaire plutôt que d’utiliser l’Open API. | Ne présentez pas ce parcours de compte comme l’accès générique d’un distributeur ; faites confirmer le produit et le contrat adaptés. |
Deux causes de blocage à distinguer
Exemples fictifs, sans appel d’authentification.
Le service redémarre six fois et réclame un jeton à chaque démarrage
Le jeton précédent est encore valide mais n’est pas conservé entre redémarrages.
Demandes fictives dans la période : 6
Jeton encore valide : disponible avant redémarrage
Cache partagé : absentLecture du cas. Le programme risque d’épuiser son budget d’authentification. Organisez la réutilisation et l’échéance du jeton ; ce symptôme ne prouve pas une erreur de contenu du dossier.
Une agence OTA suit le guide de compte Open API
Le projet fictif cherche un accès de distribution en tant que partenaire Channel/OTA.
Profil du projet : partenaire Channel/OTA
Guide utilisé : Open API de compteLecture du cas. Le guide renvoie ce profil vers le circuit partenaire. Faites confirmer la bonne offre avant de considérer une authentification de compte comme l’ouverture de la distribution.
Périmètre Guesty Open API consulté le 23 octobre 2026. Le quota d’authentification est distinct des limites des requêtes métier ; aucun secret ni compte n’est utilisé ici.
Guesty Open API — Get Started · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- Airbnb — synchroniser le calendrier d’hôte avec d’autres sites : Comportement de l’import Airbnb consulté le 22 octobre 2026. Le rafraîchissement dans l’autre sens dépend du site qui reçoit le calendrier Airbnb. (consultée le )
- Airbnb : modes de synchronisation PMS et channel manager : Synchronisation complète ou prix et disponibilité. (consultée le )
- Hostaway : channel manager : Exemple de connexions API et calendaires selon les canaux. (consultée le )
- IETF : RFC 7396, JSON Merge Patch : Transformation des valeurs JSON selon RFC 7396 ; ce mécanisme doit être explicitement supporté par l’API avant tout usage. (consultée le )
- Guesty Open API — Get Started : Périmètre Guesty Open API consulté le 23 octobre 2026. Le quota d’authentification est distinct des limites des requêtes métier ; aucun secret ni compte n’est utilisé ici. (consultée le )
Questions fréquentes
Questions utiles avant de décider
iCal synchronise-t-il le prix ?
Un calendrier iCal ne doit pas être assimilé à une connexion tarifaire. Vérifiez séparément les fonctions de prix, restrictions et contenu disponibles sur le canal.
Une API garantit-elle l’absence de survente ?
Non. Mapping, délais, stock physique et procédures de reprise restent déterminants. Testez votre configuration.
Qui doit modifier le contenu d’une annonce ?
Désignez le système de référence en fonction du mode de synchronisation choisi. Évitez les corrections concurrentes qui s’écrasent.
Que vérifier avant migration ?
Réservations futures, références canal, soldes et consignes. Faites reprendre un dossier modifié par l’équipe qui accueillera le voyageur.
Distinguer mise à jour de description et blocage de dates : quelle preuve conserver ?
Conservez contrat de description et contrat de calendrier, objets réellement affectés et la décision attribuée. Une mise à jour JSON n’est pas présumée changer un calendrier iCal.
Airbnb importe-t-il immédiatement les blocages d’un autre calendrier ?
Airbnb annonce une actualisation automatique toutes les 3 heures. Certains blocages autres qu’une réservation peuvent ne pas être repris. Vérifiez le dernier import du calendrier concerné et utilisez Actualiser lorsque c’est possible.
La limite de cinq jetons Guesty signifie-t-elle cinq appels de réservation par jour ?
Non. Le guide Open API décrit cinq demandes de jeton par clé sur vingt-quatre heures. Les appels métier ont leurs propres limites. Réutilisez le jeton valide au lieu de refaire une authentification pour chaque lecture.




