FAQ sur l'API Airbnb

Objectif Comprendre le comportement courant de la connexion API Airbnb dans Cloudbeds PMS, y compris les différences de synchronisation, le fonctionnement de la Réservation instantanée, les fonctionnalités prises en charge, les tarifs, la communication avec les clients, la disponibilité du numéro de téléphone du client et les soldes des réservations.
Idéal pour Administrateur d’établissement · Gestionnaire d’établissement · Propriétaire
À utiliser lorsque Tu as besoin de comprendre comment l’API Airbnb fonctionne avec Cloudbeds PMS, comparer l’API Airbnb avec Airbnb iCal, confirmer le comportement pris en charge par l’API Airbnb, ou résoudre des questions courantes sur l’API Airbnb.
Tu as besoin D’un accès à la page Distribution et d’un compte Airbnb actif ou d’une annonce connectée ou prête à être connectée via l’API Airbnb.
Résultat attendu Tu comprends ce que l’API Airbnb peut synchroniser, comment elle diffère d’Airbnb iCal, comment fonctionne la Réservation instantanée avec l’API Airbnb, et quel article associé utiliser pour la configuration, le comportement iCal ou les étapes de déconnexion.
Limite importante L’API Airbnb active automatiquement la Réservation instantanée. Cloudbeds PMS ne traite pas actuellement les demandes de réservation Airbnb, les demandes en attente ou les réservations temporaires comme des réservations en attente via la connexion API Airbnb.

Introduction

Airbnb peut se connecter à Cloudbeds PMS via l’API Airbnb ou Airbnb iCal. Ces types de connexion ne fonctionnent pas de la même manière. Utilise cette FAQ pour confirmer quel comportement s’applique à l’API Airbnb, où le comportement Airbnb iCal est différent, et quel guide associé suivre lorsque tu as besoin de détails sur la configuration ou la connexion.

Cet article se concentre sur les questions fréquemment posées concernant la connexion API Airbnb. Pour des instructions pas à pas sur la connexion, utilise le guide Connecter l’API Airbnb à Cloudbeds PMS.

Table des matières

Notions de base sur la connexion API Airbnb

Utilise cette section pour comprendre la différence entre l’API Airbnb et Airbnb iCal, quand passer d’iCal à l’API, et comment supprimer l’ancienne connexion Airbnb iCal si elle est encore active.

Quelle est la différence entre l’API Airbnb et Airbnb iCal ?

Airbnb iCal et l’API Airbnb sont deux manières différentes de connecter Airbnb avec Cloudbeds PMS.

iCal signifie Internet Calendaring and Scheduling Core Object Specification, aussi appelé iCalendar. API signifie Application Programming Interface.

Type de connexion Fonctionnement Ce qu’il faut savoir
Airbnb iCal Utilise des flux de calendrier pour synchroniser les événements de disponibilité, comme les dates bloquées ou les réservations, entre Airbnb et Cloudbeds PMS. iCal n’est pas exclusif aux systèmes hôteliers et n’a pas été développé spécifiquement pour les workflows hôteliers ou de gestion d’établissements. Les mises à jour ne sont pas instantanées car le canal doit récupérer les nouvelles informations du calendrier. Cela peut augmenter le risque de surréservations, et les tarifs ne sont pas mis à jour via les connexions iCal.
API Airbnb Fournit une connexion directe entre Cloudbeds PMS et Airbnb afin que plusieurs types de données puissent être synchronisés entre les systèmes. L’API Airbnb offre une synchronisation plus robuste que iCal et réduit la fenêtre de temps pendant laquelle une double réservation pourrait survenir. Cloudbeds PMS peut mettre à jour les tarifs, la disponibilité, les restrictions, les annulations et les modifications. L’API Airbnb prend également en charge les types de chambre avec plusieurs unités, les remises, les règles tarifaires, les règles de disponibilité ainsi que les taxes ou frais.

Pour plus d’informations sur les connexions basées sur le calendrier, consulte Canaux basés sur le calendrier et connexions iCal dans Cloudbeds PMS.

Si toutes mes chambres sont connectées à Airbnb iCal, quand puis-je passer à Airbnb API ?

Tu peux passer immédiatement d’Airbnb iCal à Airbnb API. Si Airbnb iCal était utilisé auparavant, désactive la connexion Airbnb iCal pour éviter des mises à jour conflictuelles.

Pour changer la connexion, suis les étapes dans Connecter Airbnb API à Cloudbeds PMS.

Comment puis-je désactiver l’ancienne connexion Airbnb iCal ?

Si Airbnb iCal est actif, désactive l’ancienne connexion iCal avant d’utiliser Airbnb API pour éviter des mises à jour conflictuelles.

  1. Accède à la page Distribution.
  2. Trouve Airbnb (iCal).
  3. Supprime tous les liens ajoutés à la connexion Airbnb iCal.
  4. Retourne au canal et enlève la coche.

Page Distribution de Cloudbeds PMS montrant l’option de connexion au canal Airbnb iCal.

Paramètres de connexion Airbnb iCal dans Cloudbeds PMS où les liens iCal existants peuvent être supprimés.

Fonctionnalités prises en charge par l’API Airbnb et comportement des annonces

Utilise cette section pour vérifier quelles fonctionnalités de l’API Airbnb sont prises en charge, jusqu’où Cloudbeds PMS envoie les tarifs et la disponibilité, et quel comportement des annonces Airbnb peut affecter le multi-inventaire.

Quelles fonctionnalités du canal Airbnb API sont prises en charge ?

Pris en charge par l’API Airbnb Non pris en charge par l’API Airbnb
  • Jours fermés
  • Fermé à l’arrivée
  • Fermé au départ
  • Durée minimale du séjour
  • Durée maximale du séjour
  • Messagerie avec le client
  • Annulations
  • Modifications
  • Tarifs avancés par canal
  • Carte de crédit
  • Dates limites de réservation
  • Réservation de dernière minute
  • Tarification par personne
  • Tarifs usage unique

Combien de photos peut-on téléverser sur Airbnb ?

Tu peux téléverser autant de photos que tu veux.

Quels types d’annonces Airbnb ne prennent pas en charge le multi-inventaire ?

Airbnb a fourni les indications suivantes concernant l’inventaire par type de chambre :

Politiques d’inventaire par type de chambre :

L’inventaire par type de chambre permet aux hôtes d’avoir plusieurs disponibilités pour la même annonce le même jour. Les hôtes peuvent regrouper plusieurs chambres en un seul ensemble représentatif et utiliser des comptes de disponibilité journaliers pour gérer la disponibilité sur l’annonce.

Cette fonctionnalité doit être mise en œuvre uniquement lorsqu’il y a plus d’une chambre disponible par jour pour l’annonce, et lorsque ces chambres partagent des attributs similaires de sorte qu’elles puissent être considérées comme de véritables substituts. Les chambres doivent avoir les mêmes équipements, configurations de lits, taille, décoration et adresse.

Les annonces avec un type d’établissement Maison ne sont pas éligibles pour être listées en tant qu’inventaire par type de chambre.

Jusqu’à quelle date dans le futur Cloudbeds PMS peut-il mettre à jour les tarifs et la disponibilité sur Airbnb ?

Cloudbeds PMS envoie les tarifs et la disponibilité pour les trois prochaines années à Airbnb. Airbnb affiche 365 jours.

Comportement de la Réservation Instantanée Airbnb API et des réservations

Utilise cette section pour confirmer comment fonctionne la Réservation Instantanée lorsque Airbnb est connecté via API, et comment le comportement de l’API Airbnb diffère de celui d’Airbnb iCal pour les demandes de réservation, les demandes en attente et les blocages temporaires.

Comment fonctionne la Réservation Instantanée avec l’API Airbnb ?

Définition de la Réservation Instantanée Airbnb

La Réservation Instantanée est une fonctionnalité Airbnb qui permet aux clients répondant aux exigences de l’annonce de réserver des dates disponibles sans que le propriétaire ou l’hôte n’examine la demande avant la confirmation de la réservation.

Comportement de la Réservation Instantanée avec l’API Airbnb

Lorsque ton annonce est connectée via l’API Airbnb, la Réservation Instantanée est activée automatiquement sur Airbnb. Elle ne peut pas être désactivée tant que la connexion API Airbnb est active. Pour arrêter d’utiliser la Réservation Instantanée, tu dois déconnecter la connexion API Airbnb de Cloudbeds PMS.

Exigences clients Airbnb qui restent modifiables

Puisque la Réservation Instantanée est activée automatiquement via la connexion API Airbnb, tu peux toujours modifier les exigences clients dans Paramètres de réservation lors de la modification de tes annonces sur l’extranet Airbnb.

Onglet Paramètres de réservation Airbnb montrant les sections Comment les clients peuvent réserver et Exigences clients.

Choisis les options requises pour les clients confirmés :

  • Photo de profil
  • Pièce d’identité officielle
  • Recommandation d’autres hôtes
  • Message avant réservation : saisis un message que le client doit lire et auquel il doit répondre avant de confirmer la réservation.

Paramètres des exigences clients Airbnb montrant les options Photo de profil, Pièce d’identité officielle, Recommandation d’autres hôtes et Message avant réservation.

Cloudbeds PMS traite-t-il les demandes de réservation ou les blocages temporaires Airbnb API ?

Non. Cloudbeds PMS ne traite actuellement pas les demandes de réservation Airbnb, les demandes en attente ni les blocages temporaires comme des réservations en attente via la connexion API Airbnb.

Si tu ne souhaites pas recevoir de réservations Réservation Instantanée depuis Airbnb, vérifie si une connexion Airbnb iCal est la bonne option pour ton flux de travail. Airbnb iCal fonctionne différemment de l’API Airbnb et offre un comportement de synchronisation plus limité. En savoir plus dans Canaux basés sur le calendrier et connexions iCal dans Cloudbeds PMS.

Tarifs, disponibilité et tarification de l’API Airbnb

Utilise cette section pour vérifier comment Airbnb affiche les tarifs et la disponibilité envoyés depuis Cloudbeds PMS, et pourquoi la tarification peut sembler différente entre les systèmes.

Comment puis-je vérifier l’exactitude des tarifs et de la disponibilité envoyés à Airbnb ?

Lorsque les tarifs et la disponibilité Airbnb sont gérés par Cloudbeds PMS, vérifie que Airbnb affiche les prix et la disponibilité attendus pour le type de chambre ou l’annonce associé.

  1. Connecte-toi à l’extranet Airbnb et va dans Listings.
  2. Ouvre l’annonce que tu souhaites vérifier et clique sur Preview listing.

Page des annonces Airbnb montrant l’option pour prévisualiser une annonce sélectionnée.

  1. Sur la nouvelle page, confirme que tu vois l’en-tête Preview mode.

Page de prévisualisation d’une annonce Airbnb montrant l’en-tête Preview mode.

  1. Sélectionne les dates de séjour et le nombre de clients.

Champs de prévisualisation d’une annonce Airbnb pour sélectionner les dates de séjour et le nombre de clients.

Résultat de la prévisualisation d’une annonce Airbnb montrant les tarifs et la disponibilité pour les dates de séjour sélectionnées.

Les tarifs et la disponibilité doivent correspondre aux tarifs de base et à la disponibilité dans Cloudbeds PMS pour le type de chambre ou l’annonce sélectionné.

Pourquoi les tarifs journaliers diffèrent-ils du calendrier dans le versement de la réservation ?

Bien que chaque tarif journalier puisse être différent dans ton calendrier, Airbnb prend le montant total de la réservation et le divise par le nombre de nuits. Airbnb affiche ensuite ce montant comme tarif journalier.

Par exemple, pour cette réservation de sept nuits, les tarifs journaliers dans le calendrier étaient :

  • Vendredi : 29 $
  • Samedi : 23,20 $
  • Dimanche : 23,20 $
  • Lundi : 18 $
  • Mardi : 18 $
  • Mercredi : 18 $
  • Jeudi : 18 $

Total : 147,40 $

Airbnb a divisé le total par le nombre de nuits, affiché 21,00 $ par nuit, et arrondi le total à 148,00 $.

Exemple de versement de réservation Airbnb montrant le montant total de la réservation divisé sur le nombre de nuits.

Pourquoi ne puis-je pas voir les réductions hebdomadaires ou mensuelles pour mes dortoirs sur Airbnb ?

Lorsque tu configures une réduction hebdomadaire ou mensuelle pour les dortoirs dans le mappage Cloudbeds PMS, tu ne verras pas ces réductions reflétées dans les paramètres de l’extranet Airbnb. Cela ne signifie pas que la réduction n’est pas appliquée.

Cloudbeds PMS calcule le prix réduit et envoie le tarif final à Airbnb en fonction des dates de séjour, de la durée du séjour et du nombre de clients. Comme la réduction est déjà calculée avant l’envoi du tarif, Airbnb peut afficher Aucune dans les champs de réduction hebdomadaire ou mensuelle dans l’extranet Airbnb.

Dans Cloudbeds PMS, les réductions hebdomadaires et mensuelles se configurent dans les paramètres de tarification des chambres Airbnb :

Paramètres de tarification des chambres Airbnb dans Cloudbeds PMS montrant les champs de réduction hebdomadaire et mensuelle configurés pour un dortoir.

Dans l’extranet Airbnb, les mêmes champs de réduction hebdomadaire et mensuelle peuvent s’afficher comme Aucune, même lorsque Cloudbeds PMS envoie déjà le tarif final réduit :

Section Réductions selon la durée du séjour dans l’extranet Airbnb montrant les réductions hebdomadaires et mensuelles comme Aucune.

Pour confirmer si la réduction a été appliquée, vérifie une réservation effectuée sous la règle de réduction hebdomadaire ou mensuelle. Le tarif final de la réservation doit déjà inclure la réduction par rapport aux tarifs de ton calendrier.

Pourquoi le prix de la chambre affiché sur Airbnb est-il différent de celui dans Cloudbeds PMS ?

Les prix des chambres peuvent différer entre Airbnb et Cloudbeds PMS pour plusieurs raisons. Les causes les plus courantes sont :

  • Les taxes et les frais ne sont pas configurés de la même manière dans Cloudbeds PMS et sur Airbnb. Il faut configurer les taxes et les frais de façon cohérente pour afficher le total correct de la réservation.
  • Airbnb applique des réductions ou des règles de tarification, comme des remises selon la durée du séjour, des remises liées à la politique d’annulation ou des remises de dernière minute.
  • Les frais forfaitaires ne sont pas inclus dans la ventilation du tarif. Ces frais forfaitaires doivent être ajoutés en tant qu’inclus.

Consulte les articles suivants pour plus d’informations :

Communication avec les clients Airbnb via l’API et solde de paiement

Utilise cette section pour comprendre comment Airbnb partage les informations de contact des clients via l’API, comment contacter les clients lorsqu’un numéro de téléphone n’est pas disponible, et pourquoi les réservations Airbnb peuvent afficher un solde dû dans Cloudbeds PMS.

Pourquoi ne puis-je pas envoyer d’e-mails aux clients Airbnb ?

Airbnb ne transmet pas les adresses e-mail des clients pour les réservations via l’API en raison des politiques d’Airbnb. Utilise les outils de messagerie Airbnb disponibles pour contacter les clients. Les numéros de téléphone des clients peuvent également être indisponibles ou remplacés par des numéros temporaires, selon les règles de confidentialité d’Airbnb. Consulte la FAQ suivante pour plus de détails.

Pour plus d’informations, consulte la ressource d’Airbnb : Une mise à jour pour les hôtes qui utilisent la fonction d’alias e-mail.

Pourquoi le numéro de téléphone d’un client Airbnb est-il manquant ou remplacé par un numéro temporaire ?

Airbnb limite les numéros de téléphone des clients partagés via les réservations API pour protéger les hôtes et les clients contre le phishing et l’utilisation abusive des informations personnelles. À partir de la semaine du 26 octobre 2026, Airbnb a commencé à déployer des numéros de téléphone temporaires pour certaines réservations au lieu de partager les numéros réels des clients.

Quand Airbnb fournit-il un numéro de téléphone temporaire ? Toutes les conditions suivantes doivent être remplies :

  • La réservation a été acceptée à partir du 26 octobre 2026.
  • L’annonce Airbnb est située aux États-Unis ou au Canada.
  • L’hôte et le client ont tous deux un numéro de téléphone.
  • L’hôte et le client résident dans le même pays, soit aux États-Unis, soit au Canada.

Quand aucun numéro de téléphone n’est-il fourni ? Airbnb ne transmet ni le numéro de téléphone du client ni un numéro temporaire via l’API pour toute réservation ne remplissant pas toutes les conditions ci-dessus. Cela inclut les réservations acceptées avant le 26 octobre 2026, les annonces situées en dehors des États-Unis et du Canada, ainsi que les réservations où l’hôte et le client résident dans des pays différents.

 Airbnb peut afficher les quatre derniers chiffres du numéro réel du client sur la page des détails de la réservation pour des flux de travail tels que les codes d’accès. Cela ne signifie pas que le numéro réel ou ces chiffres sont transmis à Cloudbeds PMS via l’API.

Comment contacter un client sans numéro de téléphone ? Utilise la messagerie Airbnb ou une autre méthode de messagerie client disponible et prise en charge plutôt que de te fier au champ du numéro de téléphone dans la réservation Cloudbeds PMS.

Cette restriction est déterminée par la politique de partage des données API d’Airbnb, et non par un paramètre de numéro de téléphone dans Cloudbeds PMS. Pour plus d’informations, consulte Comment fonctionnent les numéros de téléphone temporaires - Centre d’aide Airbnb.

Pourquoi un solde dû apparaît-il dans Cloudbeds pour les réservations Airbnb ?

Les clients Airbnb paient directement Airbnb, qui règle ensuite l’établissement par virement bancaire. En raison de ce flux de paiement, le PMS Cloudbeds importe la réservation Airbnb avec un solde dû.

Pour solder ce solde, ajoute manuellement un paiement dans le PMS Cloudbeds afin de refléter les fonds que l’établissement reçoit d’Airbnb.


Utilise ces articles lorsque tu as besoin d’étapes de configuration, de détails sur le comportement d’iCal, d’étapes de déconnexion ou de conseils sur la configuration des taxes et frais liés à Airbnb.

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.