# Connecter CodeB PMS

Si vous gérez vos logements avec **CodeB PMS**, le portail voyageurs importe automatiquement ses réservations : dates, nombre de voyageurs, nom, e-mail et téléphone du voyageur, canal de réservation (Airbnb, Booking.com, en direct …) et prix. Les annulations et les changements de dates suivent. Vos données de check-in, paiements et notes ne sont jamais écrasés par l'import.

La connexion utilise l'**API partenaire** de CodeB PMS (elle parle le même langage que l'API Hostaway) : rien à installer.

## 1. Créer des identifiants partenaire dans CodeB PMS

1. Connectez-vous à CodeB PMS en tant qu'administrateur.
2. Ouvrez les paramètres de la **Hostaway-compatible API** (API partenaire).
3. Ajoutez une clé partenaire pour le portail voyageurs : un **client ID** (par exemple *guestbud*) et un **client secret** long et aléatoire. Enregistrez.
4. Notez l'adresse de votre CodeB PMS, par exemple `https://pms.example.com`.

Sans clé partenaire, l'API partenaire CodeB ne répond rien — c'est voulu, car elle fournit des données personnelles des voyageurs.

## 2. Connecter CodeB PMS dans votre tableau de bord

1. Ouvrez **Settings → Channels → CodeB PMS**.
2. Saisissez la **CodeB PMS address** (`https://pms.example.com` suffit — le portail voyageurs ajoute `/api/v1` lui-même), le **Partner client ID** et le **Partner client secret**.
3. Cochez **Enabled** et cliquez sur **Test** (l'enregistrement se fait d'abord). Vous devriez voir *CodeB PMS: connected*.

## 3. Lier vos logements

1. Cliquez sur **Show listings** dans la carte CodeB PMS. Vous voyez chaque logement CodeB avec son identifiant et s'il est déjà lié.
2. **Nouveau sur le portail voyageurs ?** Laissez les logements cochés et cliquez sur **Add selected as properties**. Chacun devient un logement ici, est lié et ses réservations sont importées immédiatement. Les photos ne font pas partie de l'API partenaire — ajoutez-les dans le **Guide editor**.
3. **Vous avez déjà créé un logement à la main ?** Décochez-le et collez plutôt l'identifiant du logement CodeB dans **Settings → Properties → Settings → CodeB PMS property ID**.

## 4. Rester à jour

- Les réservations sont importées **toutes les 10 minutes**, ainsi qu'à chaque clic sur **Import now**.
- Une réservation n'est jamais rattachée qu'au logement auquel elle appartient dans CodeB PMS.
- Les demandes de renseignements et les séjours du propriétaire ne sont pas importés ; une réservation annulée est marquée comme annulée ici.
- **Mises à jour instantanées :** la carte CodeB PMS affiche une adresse de webhook. Dès que votre version de CodeB PMS peut envoyer des webhooks sortants, collez-la dans CodeB PMS : les nouvelles réservations arrivent alors en quelques secondes.

## Ce qui n'est pas encore disponible

- **Chat avec les voyageurs :** les messages via le chat Airbnb ou Booking.com ne sont pas encore disponibles pour les réservations CodeB — le portail voyageurs envoie le lien et les messages **par e-mail**.
- **Adultes et enfants :** CodeB ne transmet pour l'instant que le nombre total de voyageurs. Les voyageurs confirment le nombre d'adultes et de moins de 18 ans lors du check-in en ligne, qui calcule alors correctement la taxe de séjour.

## Questions fréquentes

### Quelle adresse dois-je saisir ?

L'adresse avec laquelle vous ouvrez CodeB PMS, par exemple `https://pms.example.com`. Si votre API partenaire tourne sous `/hostaway/v1` au lieu de `/api/v1`, saisissez l'adresse complète avec ce chemin.

### Le test affiche HTTP 403 — que faire ?

Le client ID ou le secret ne correspond à aucune clé partenaire dans CodeB PMS, ou aucune clé partenaire n'existe encore. Vérifiez-les dans CodeB et saisissez à nouveau le secret (celui enregistré reste masqué).

### Puis-je utiliser CodeB PMS et Hostaway en même temps ?

Oui. Chaque logement est lié à une seule source : liez un logement soit à son annonce Hostaway, soit à son logement CodeB PMS, pas aux deux, afin qu'une réservation ne soit pas importée deux fois.