Importer des réservations à l'aide d'un fichier CSV dans Portfolio Analytics
Cette fonctionnalité permet d'importer d'anciennes réservations dans PriceLabs lorsque vous changez de logiciel de gestion de biens (PMS), ou d'importer des réservations qui existent dans le PMS, mais ne peuvent pas être récupérées automatiquement par PriceLabs. Vous pouvez également l'utiliser pour mettre à jour les dates de réservation si elles sont incorrectes dans le PMS, ou importer des informations sur les réservations en bloc que PriceLabs n'a pas reçues.
Avant de commencer
- Cette fonctionnalité est disponible sur demande. Pour ce faire, veuillez nous contacter à l'adresse support@pricelabs.co.
- Utilisez uniquement cette fonctionnalité pour les réservations qui n'existent pas dans PriceLabs, ou si la date de réservation est incorrecte.
- Important : Cette fonctionnalité ne doit pas être utilisée pour des réservations en cours qui sont déjà comptabilisées dans le PMS, parce que celles-ci sont synchronisées automatiquement toutes les 24-36 heures par PriceLabs.
- Cette fonctionnalité est disponible sur demande. Pour ce faire, veuillez nous contacter à l'adresse support@pricelabs.co.
- Utilisez uniquement cette fonctionnalité pour les réservations qui n'existent pas dans PriceLabs, ou si la date de réservation est incorrecte.
- Important : Cette fonctionnalité ne doit pas être utilisée pour des réservations en cours qui sont déjà comptabilisées dans le PMS, parce que celles-ci sont synchronisées automatiquement toutes les 24-36 heures par PriceLabs.
Cas d'importation manuelle de réservations
- Importation d'anciennes réservations lorsque le changement de PMS se produit et qu'aucune option de transfert de données n'est disponible.
- Importation de réservations directes ou hors ligne que PriceLabs ne peut pas récupérer via l'API du PMS.
- Importation de dates de réservation qui sont incorrectes dans le PMS.
- Importation d'informations de réservation en blocs si le PMS n'envoie pas ces données à PriceLabs.
Comment importer des réservations
- Cliquez sur les trois points verticaux en haut à droite de l'écran.
- Téléchargez le fichier CSV d'exemple.
- Renseignez les informations demandées et importez le fichier.
- Après l'importation, vous recevrez un e-mail avec, en pièce jointe, des explications détaillées sur la réussite ou l'échec de l'opération.
- Cliquez sur les trois points verticaux en haut à droite de l'écran.
- Téléchargez le fichier CSV d'exemple.
- Renseignez les informations demandées et importez le fichier.
- Après l'importation, vous recevrez un e-mail avec, en pièce jointe, des explications détaillées sur la réussite ou l'échec de l'opération.
Correction des dates de réservation pour l'API
Certains PMS envoient la date de création au lieu de la date de réservation initiale. Le problème survient lorsque les utilisateurs changent de PMS et importent des données historiques dans leur nouveau PMS.
Dans ce cas, le nouveau PMS envoie la date d'importation de la réservation comme date de réservation, ce qui génère des incohérences dans les rapports et les analyses. Les utilisateurs ont désormais la possibilité de corriger ces dates de réservations incorrectes. Suivez simplement ces étapes :
Certains PMS envoient la date de création au lieu de la date de réservation initiale. Le problème survient lorsque les utilisateurs changent de PMS et importent des données historiques dans leur nouveau PMS.
Étapes à suivre pour corriger les dates de réservation :
Téléchargez le fichier CSV d'exemple
- Accédez à Portfolio Analytics (KPIs et Rapports Historiques) dans PriceLabs.
- Cliquez sur les trois points verticaux en haut à droite de l'écran
- Téléchargez le fichier CSV d'exemple, qui intègre le format
de correction des dates de réservation.
Téléchargez le fichier CSV d'exemple
- Accédez à Portfolio Analytics (KPIs et Rapports Historiques) dans PriceLabs.
- Cliquez sur les trois points verticaux en haut à droite de l'écran
- Téléchargez le fichier CSV d'exemple, qui intègre le format de correction des dates de réservation.
Exportez les données de réservation :
- Dans la section Tendances par Date de Création des Réservations, cliquez sur l'icône à trois points en haut à droite.
- Exportez toutes les réservations au format CSV.
- Le fichier exporté comportera les éléments suivants :
- reservation_id
- listing_id
- pms_name
- start_date
- end_date
- rental_revenue
- Dans la section Tendances par Date de Création des Réservations, cliquez sur l'icône à trois points en haut à droite.
Identifiez et cartographiez les dates de réservation incorrectes
- Ouvrez le fichier exporté et identifiez les lignes contenant des dates de réservation incorrectes.
- Répertoriez ces données au format CSV dans le fichier d'exemple récupéré plus tôt. Vérifiez que :
- les données reservation_id, listing_id, pms_name, start_date, end_date, et rental_revenue sont bien renseignées à partir du fichier exporté.
Renseignez les champs requis
- total_cost : Renseignez les mêmes valeurs que rental_revenue.
- currency : Utilisez la devise dans laquelle l'annonce concernée est diffusée.
- pl_status : Utilisez toujours le statut "booked" (réservé).
- Remarque importante : Ces champs ne seront pas mis à jour dans PriceLabs ; seul le champ booked_time sera mis à jour pour les réservations existantes.
Importez le fichier corrigé
- Référez-vous à l'article d'aide fourni dans la documentation d'assistance.
- Importez dans PriceLabs les réservations corrigées au format CSV, avec les dates de réservation à jour.
Veuillez noter que cette opération aura uniquement pour effet de corriger les dates de réservation. Aucune autre valeur ne sera mise à jour, puisque nous ne permettons pas aux utilisateurs de modifier les données d'API autres que les dates de réservation.
À noter
- Identifiant de l'annonce : Vérifiez qu'il correspond bien à celui qui s'affiche dans PriceLabs, sinon l'importation échouera.
- Veillez à ce que la colonne listing_id soit bien au format texte.
- Colonnes obligatoires : listing_id, pms_name, start_date, end_date, total_cost (si le statut est "booked", réservé), rental_revenue, currency (ISO3 format) et pl_status.
- La colonne Reservation_ID est également obligatoire. Voir le point 5.
- Bien que d'autres colonnes (non obligatoires), non listées ici, ne nécessitent pas d'être renseignées, leurs en-têtes ne peuvent pas être retirées. Ces champs peuvent être laissés vides s'il n'est pas pertinent d'indiquer une valeur.
- Les annonces doivent être visibles dans votre compte PriceLabs, et Portfolio Analytics doit être activé pour le PMS concerné.
- Reservation_ID : Obligatoire. Si cette colonne n'est pas renseignée, le système recevra un message d'erreur : ECHEC : reservation_id doit être une chaîne de caractères.
- Total_cost et rental_revenue ne doivent pas être inférieurs ou égaux à 0 si le statut pl_status est "booked" (réservé). Veillez à ce que les champs total_cost, rental_revenue et tous les autres champs liés aux revenus soient au format numérique, et ne comportent aucun symbole ni texte. Par exemple, les formats $25, USD25 sont tous deux incorrects.
- Le champ booked_time doit être renseigné si le statut est "booked" (réservé).
- Pour modifier ou mettre à jour une saisie, veuillez importer les données révisées en utilisant le même identifiant de réservation, ou utiliser le format mentionné ci-dessus s'il n'a pas été utilisé plus tôt. Aussi, vous pouvez télécharger toutes les réservations avec les identifiants de réservation à partir de la section "Tendances par Date de Création des Réservations". Pour cela, sélectionnez "Réservations" dans l'option Graphique et téléchargez le fichier CSV.
- Options pl_status : "booked" (réservé), "blocked" (bloqué), "cancelled" (annulé) et "available" (disponible).
- Options Booking Source ("Source de réservation") : airbnb, vrbo, bcom, manual et autres.
- 5 000 saisies maximum peuvent être actualisées en une seule et même fois.
- Si pl_status est annulé, renseignez le champ cancelled_time, sinon l'importation échouera.
- Ne supprimez ni ne modifiez les colonnes obligatoires. Les utilisateurs peuvent réorganiser ou supprimer les colonnes facultatives au moment de l'importation.
- La date de réservation ("booked time") ne peut excéder la date de début et la date de fin. Veuillez noter que la date de réservation correspond à la date réservée, dans l'un des formats valides mentionnés ci-dessous.
- Veillez à ce que le fichier reste au format CSV. Utilisez l'option "Enregistrer sous" pour modifier l'extension si nécessaire (n'utilisez pas l'option "Renommer" pour modifier l'extension du fichier).
- Formats de date acceptés : AAAA-MM-JJ, JJ mois AAAA, JJ.MM.AAAA (par ex. : 2019-01-19, 19 janvier 2019, 19.01.2019.
- Parfois, le fichier CSV a tendance à convertir les grands nombres en notation scientifique. Cliquez sur "Ne pas convertir" pour conserver le format non scientifique d'origine comme ci-dessous.
Si vous avez des questions ou si vous avez besoin d'une assistance supplémentaire, n'hésitez pas à nous contacter à l'adresse support@pricelabs.co.
- Identifiant de l'annonce : Vérifiez qu'il correspond bien à celui qui s'affiche dans PriceLabs, sinon l'importation échouera.
- Veillez à ce que la colonne listing_id soit bien au format texte.
- Colonnes obligatoires : listing_id, pms_name, start_date, end_date, total_cost (si le statut est "booked", réservé), rental_revenue, currency (ISO3 format) et pl_status.
- La colonne Reservation_ID est également obligatoire. Voir le point 5.
- Bien que d'autres colonnes (non obligatoires), non listées ici, ne nécessitent pas d'être renseignées, leurs en-têtes ne peuvent pas être retirées. Ces champs peuvent être laissés vides s'il n'est pas pertinent d'indiquer une valeur.
- Les annonces doivent être visibles dans votre compte PriceLabs, et Portfolio Analytics doit être activé pour le PMS concerné.
- Reservation_ID : Obligatoire. Si cette colonne n'est pas renseignée, le système recevra un message d'erreur : ECHEC : reservation_id doit être une chaîne de caractères.
- Total_cost et rental_revenue ne doivent pas être inférieurs ou égaux à 0 si le statut pl_status est "booked" (réservé). Veillez à ce que les champs total_cost, rental_revenue et tous les autres champs liés aux revenus soient au format numérique, et ne comportent aucun symbole ni texte. Par exemple, les formats $25, USD25 sont tous deux incorrects.
- Le champ booked_time doit être renseigné si le statut est "booked" (réservé).
- Pour modifier ou mettre à jour une saisie, veuillez importer les données révisées en utilisant le même identifiant de réservation, ou utiliser le format mentionné ci-dessus s'il n'a pas été utilisé plus tôt. Aussi, vous pouvez télécharger toutes les réservations avec les identifiants de réservation à partir de la section "Tendances par Date de Création des Réservations". Pour cela, sélectionnez "Réservations" dans l'option Graphique et téléchargez le fichier CSV.
- Options pl_status : "booked" (réservé), "blocked" (bloqué), "cancelled" (annulé) et "available" (disponible).
- Options Booking Source ("Source de réservation") : airbnb, vrbo, bcom, manual et autres.
- 5 000 saisies maximum peuvent être actualisées en une seule et même fois.
- Si pl_status est annulé, renseignez le champ cancelled_time, sinon l'importation échouera.
- Ne supprimez ni ne modifiez les colonnes obligatoires. Les utilisateurs peuvent réorganiser ou supprimer les colonnes facultatives au moment de l'importation.
- La date de réservation ("booked time") ne peut excéder la date de début et la date de fin. Veuillez noter que la date de réservation correspond à la date réservée, dans l'un des formats valides mentionnés ci-dessous.
- Veillez à ce que le fichier reste au format CSV. Utilisez l'option "Enregistrer sous" pour modifier l'extension si nécessaire (n'utilisez pas l'option "Renommer" pour modifier l'extension du fichier).
- Formats de date acceptés : AAAA-MM-JJ, JJ mois AAAA, JJ.MM.AAAA (par ex. : 2019-01-19, 19 janvier 2019, 19.01.2019.
- Parfois, le fichier CSV a tendance à convertir les grands nombres en notation scientifique. Cliquez sur "Ne pas convertir" pour conserver le format non scientifique d'origine comme ci-dessous.
Si vous avez des questions ou si vous avez besoin d'une assistance supplémentaire, n'hésitez pas à nous contacter à l'adresse support@pricelabs.co.