# Connecter Rentals United

Rentals United diffuse vos logements sur de nombreux canaux. Une fois connecté au portail voyageurs, ses réservations sont importées automatiquement, et chaque voyageur reçoit un lien vers le portail pour le check-in en ligne et les paiements.

## 1. Obtenir vos clés API

L'API XML de Rentals United s'authentifie avec une **clé d'accès** (access key) et une **clé secrète** (secret key). Vous les trouverez dans votre compte Rentals United, dans les paramètres API / intégration, ou votre gestionnaire de compte Rentals United vous les fournit. Assurez-vous que les clés peuvent lire vos logements et vos réservations.

## 2. Connecter depuis votre tableau de bord

1. Ouvrez **Settings → Channels → RentalsUnited** (Paramètres → Canaux).
2. Collez l'**Access key** et la **Secret key**.
3. Laissez **API endpoint** vide pour utiliser l'endpoint standard de Rentals United, sauf si Rentals United vous en a fourni un autre.
4. Cochez **Enabled**, cliquez sur **Save** puis sur **Test** — vous devriez voir *RentalsUnited: connected*.

![Settings → Channels](/site/img/docs/d-settings-channels.webp "Settings → Channels")

## 3. Relier vos logements

1. Cliquez sur **Show listings** pour voir vos logements Rentals United avec leurs identifiants et savoir s'ils sont reliés.
2. Cliquez sur **Add selected as properties** (les photos sont également importées — la première devient la photo de couverture ; **Import photos** dans la carte les récupère pour les logements reliés auparavant) pour créer un logement pour chaque élément coché (nommé comme dans Rentals United) et le relier ; les réservations déjà présentes dans le cache apparaissent immédiatement.
3. Pour un logement que vous avez déjà créé manuellement, décochez-le et collez plutôt l'identifiant dans **Settings → Properties → Settings → RentalsUnited property ID**.

![Show listings → Add selected as properties](/site/img/docs/d-channels-listings.webp "Show listings → Add selected as properties")

## 4. Importer

**Import now** récupère les réservations ; ensuite, l'import s'exécute toutes les 10 minutes. Le nom, l'e-mail, le téléphone, les adultes et les enfants proviennent de la réservation, et le canal (Booking.com, Airbnb, Expedia…) est indiqué sur la réservation.

## Fonctionnement du cache des réservations

L'interface de réservations de Rentals United ne signale que les réservations **créées, modifiées ou annulées dans une fenêtre de temps donnée**, à raison d'une requête par minute au maximum. Un séjour réservé il y a des mois et inchangé depuis n'est pas renvoyé. Le portail voyageurs conserve donc son propre **cache de réservations** pour votre compte :

- Chaque réservation signalée par Rentals United est stockée, **pour tous vos logements Rentals United — reliés ou non**. Lorsque vous reliez un logement plus tard, ses réservations apparaissent immédiatement depuis le cache.
- Juste après la connexion, le portail remonte également les modifications plus anciennes, une semaine à la fois (jusqu'à environ quatre mois), toutes les deux minutes jusqu'à la fin. La carte du canal affiche entre-temps *loading older reservations…*.
- Si le serveur a été hors ligne pendant un moment, la période manquée est récupérée par tranches d'une semaine. Si Rentals United refuse une période trop ancienne, la carte l'indique et le portail revérifie un par un chaque séjour à venir qu'il connaît déjà, afin de ne manquer aucune annulation.
- Les réservations en cache sont supprimées 35 jours après le départ.

Une réservation absente du cache — par exemple un séjour plus ancien qui n'a pas changé depuis la connexion — peut être importée avec **Import a reservation by ID** dans la carte Rentals United. Saisissez le numéro de réservation Rentals United et cliquez sur **Import reservation**.

Les réservations annulées, refusées et expirées sont marquées comme annulées ; les demandes et les prospects ne sont pas importés. Une réservation portant sur plusieurs logements apparaît sur chaque logement relié.

## Questions fréquentes

### Les réservations effectuées sur d'autres canaux sont-elles incluses ?

Oui — tout ce qui arrive sur votre compte Rentals United pour un logement relié est importé, quel que soit le canal d'origine.

### Import now indique de réessayer dans un instant ?

Rentals United autorise une requête de réservations par minute. Les réservations déjà présentes dans le cache sont appliquées immédiatement ; les nouvelles suivent lors du prochain import automatique, quelques minutes plus tard.

### Test indique que l'authentification a échoué ?

Vérifiez que vous avez copié la clé d'accès et la clé secrète sans espaces et qu'elles sont actives. Une nouvelle paire de clés de Rentals United résout la plupart des problèmes.