# Connexion OTA

[FR](/kribos-docs/guides-clients/gitbook-guide-connexion-ota-gitbook-native.md) | [EN](/kribos-docs/guides-clients/gitbook-ota-connection-guide-en.md)

![Connecter vos OTA sans configuration technique](/files/y8eOFwlq6Rx5eGnx87L9)

> **Guide client KribOS**
>
> Connectez Booking.com, Airbnb, Expedia, VRBO, Agoda, Trip.com, Hotelbeds et autres plateformes a KribOS, sans configuration technique cote hebergeur.

> **Delai d'activation**
>
> Apres l'envoi d'une demande, KribOS verifie les informations et revient vers vous sous **24h ouvrees**. Certaines plateformes demandent aussi une validation dans leur extranet.

## En bref

| Ce que KribOS synchronise | Pourquoi c'est utile                                                           |
| ------------------------- | ------------------------------------------------------------------------------ |
| **Disponibilites**        | Les dates reservees ou bloquees sont envoyees vers les plateformes connectees. |
| **Reservations**          | Les nouvelles reservations sont centralisees dans votre espace KribOS.         |
| **Accompagnement**        | KribOS vous guide si une action est necessaire dans l'extranet OTA.            |

![Workflow de connexion OTA](/files/VAjhgakeEEP9xc559akP)

## Deux scenarios possibles

![Deux scenarios d'activation OTA](/files/TghRMf9UlHPy2Z6jxsn0)

### Scenario A - Vous avez deja des annonces OTA

Choisissez ce parcours si vos logements existent deja sur Booking.com, Airbnb, Expedia, VRBO ou une autre plateforme.

1. KribOS recupere les informations disponibles depuis la plateforme ou depuis les identifiants fournis.
2. Vous validez le mapping: quelle annonce OTA correspond a quel logement KribOS.
3. KribOS controle les chambres, tarifs et disponibilites.
4. La synchronisation est activee apres verification.

Ce scenario est utile quand vos annonces existent deja et que vous voulez eviter de tout recréer a la main.

### Scenario B - Vous creez d'abord vos proprietes dans KribOS

Choisissez ce parcours si vous voulez repartir proprement depuis KribOS, ou si vos logements ne sont pas encore bien structures.

1. Vous ajoutez vos proprietes, chambres ou unites dans KribOS.
2. Vous ajoutez ensuite les identifiants OTA ou les liens d'annonces disponibles.
3. L'equipe KribOS prepare les correspondances avec les plateformes.
4. KribOS finalise l'activation avec vous.

Ce scenario est utile si vous souhaitez utiliser KribOS comme source centrale avant de raccorder les OTA.

> **A retenir**
>
> Le mapping est toujours valide avant activation. Cela evite de relier une annonce OTA au mauvais logement KribOS.

## Commissions et frais OTA

KribOS ne change pas les commissions appliquees par vos OTA. Les commissions Booking.com, Airbnb, Expedia ou autres dependent de votre contrat avec chaque plateforme.

Channex agit comme couche de connectivite entre KribOS et les OTA. La documentation Channex montre que les reservations peuvent contenir une information `ota_commission`, c'est-a-dire la commission communiquee par l'OTA sur une reservation. Cela ne signifie pas que Channex cree une nouvelle commission pour l'hebergeur.

Pour les reservations directes via un moteur de reservation, Channex indique que son Instant Booking Page est gratuit et sans frais. Dans KribOS, les conditions commerciales applicables restent celles de votre abonnement KribOS et de vos contrats OTA.

Sources:

* [Channex - Bookings Collection](https://docs.channex.io/api-v.1-documentation/bookings-collection)
* [Channex - Instant Booking Page / Booking Engine](https://help.channex.io/en/articles/8275292-instant-booking-page-booking-engine)
* [Channex - About and FAQ](https://docs.channex.io/about-channex-and-faq)

## Avant de commencer

Preparez ces informations pour chaque plateforme:

| Information             | Exemple                           | Ou la trouver                    |
| ----------------------- | --------------------------------- | -------------------------------- |
| Nom de la plateforme    | Booking.com, Airbnb, Expedia      | Votre compte OTA                 |
| Identifiant du logement | Property ID, Listing ID, Hotel ID | Extranet ou URL de l'annonce     |
| Nom du logement         | Riad Atlas Marrakech              | KribOS ou votre OTA              |
| Email du compte OTA     | <host@example.com>                | Email utilise pour la plateforme |

> **Important**
>
> Ne partagez jamais votre mot de passe OTA avec KribOS. Nous demandons uniquement les identifiants necessaires a la connexion ou nous vous guidons pour autoriser la connexion depuis l'extranet.

## Parcours de connexion

![Sequence de synchronisation KribOS et OTA](/files/MHKpN3DGE2HNrJ351yP4)

### Etape 1 - Choisir la plateforme

Dans KribOS, ouvrez **Plateformes de reservation**, puis recherchez l'OTA a connecter.

### Etape 2 - Ajouter les informations

Renseignez l'identifiant de l'annonce, le nom du logement et l'email du compte si disponible.

### Etape 3 - Envoyer la demande

Cliquez sur **Envoyer la demande**. Elle apparait ensuite dans **Suivi des connexions**.

### Etape 4 - Attendre la confirmation KribOS

KribOS verifie les informations, prepare la connexion et revient vers vous sous **24h ouvrees**.

> **Connexion active**
>
> Une fois la connexion active, vos disponibilites et reservations sont synchronisees automatiquement selon les capacites de la plateforme.

## Exemple d'ecran KribOS

### Carte plateforme

| Plateforme      | Description                                                                           | Action        |
| --------------- | ------------------------------------------------------------------------------------- | ------------- |
| **Booking.com** | Disponible dans votre extranet Booking.com, dans les informations de l'etablissement. | **Connecter** |
| **Airbnb**      | Identifiant souvent visible dans l'URL de l'annonce apres `/rooms/`.                  | **Connecter** |
| **Expedia**     | Identifiant disponible dans Expedia Partner Central.                                  | **Connecter** |

### Exemple de statut

| Logement             | Plateforme  | Statut          | Message                                                                |
| -------------------- | ----------- | --------------- | ---------------------------------------------------------------------- |
| Riad Atlas Marrakech | Booking.com | Demande envoyee | KribOS verifie les informations et revient vers vous sous 24h ouvrees. |

## Delai d'activation

| Cas                                            | Delai indicatif                                 |
| ---------------------------------------------- | ----------------------------------------------- |
| Identifiant correct et aucune action externe   | Activation rapide apres verification            |
| Validation requise dans l'extranet OTA         | Selon la rapidite de validation cote plateforme |
| Informations manquantes ou mauvais identifiant | KribOS vous demande une correction              |
| Plateforme regionale ou moins courante         | Verification de disponibilite avant activation  |

## Statuts possibles

| Statut dans KribOS      | Signification                                                   |
| ----------------------- | --------------------------------------------------------------- |
| **Demande envoyee**     | KribOS a recu votre demande et verifie les informations.        |
| **Action hote requise** | Vous devez valider une action dans l'extranet de la plateforme. |
| **Configuration**       | KribOS relie votre annonce a votre logement.                    |
| **Connectee**           | La synchronisation est active.                                  |
| **A corriger**          | Une information manque ou doit etre modifiee.                   |
| **Bloquee**             | La connexion ne peut pas etre terminee sans intervention.       |

## Plateformes disponibles

| OTA principales | OTA additionnelles   |
| --------------- | -------------------- |
| Booking.com     | Agoda                |
| Airbnb          | Trip.com / Ctrip     |
| Expedia         | Despegar             |
| VRBO            | Hotelbeds            |
| Google Hotel    | Hostelworld          |
|                 | Hopper               |
|                 | HRS                  |
|                 | HyperGuest           |
|                 | Klook                |
|                 | MakeMyTrip / Goibibo |
|                 | Traveloka            |
|                 | Tiket.com            |
|                 | OpenGDS              |
|                 | Feratel              |
|                 | Autre plateforme     |

> **Plateforme non listee**
>
> Si votre plateforme n'apparait pas dans la liste, choisissez **Autre plateforme** et ajoutez le nom de l'OTA, le lien de l'annonce ou l'identifiant disponible.

## Guide rapide par plateforme

### Booking.com

Information demandee: **Property ID Booking.com**

Vous pouvez generalement le trouver dans l'extranet Booking.com, dans les informations de l'etablissement.

Actions possibles:

1. Ouvrez Booking.com Extranet.
2. Allez dans les parametres de connectivite.
3. Choisissez KribOS comme fournisseur si l'option est disponible.
4. Envoyez la demande dans KribOS.

### Airbnb

Information demandee: **Listing ID Airbnb**

Vous pouvez souvent le trouver dans l'URL de l'annonce, apres `/rooms/`.

Actions possibles:

1. Ouvrez votre tableau de bord hote Airbnb.
2. Verifiez l'identifiant de l'annonce.
3. Envoyez la demande dans KribOS.
4. KribOS vous indiquera si une autorisation supplementaire est necessaire.

### Expedia / VRBO

Information demandee: **Property ID Expedia ou VRBO**

Actions possibles:

1. Ouvrez Expedia Partner Central ou votre portail VRBO.
2. Verifiez l'identifiant de l'etablissement.
3. Activez le fournisseur de connectivite si la plateforme vous le demande.
4. Envoyez la demande dans KribOS.

### Agoda

Information demandee: **Hotel ID Agoda**

Vous pouvez le trouver dans Agoda YCS.

### Autre plateforme

Information demandee:

* nom de la plateforme;
* lien de l'annonce si disponible;
* identifiant hotel, logement ou compte si disponible;
* email utilise sur la plateforme.

KribOS verifiera si la connexion est disponible et vous repondra sous **24h ouvrees**.

## Bonnes pratiques

* Connectez d'abord vos plateformes les plus importantes.
* Verifiez que vos annonces et logements KribOS correspondent bien.
* Evitez de changer vos prix ou disponibilites dans plusieurs outils en meme temps pendant l'activation.
* Gardez l'acces a vos extranets OTA pendant la configuration.
* Signalez a KribOS toute reservation existante non encore importee.

## Questions frequentes

### Est-ce que mes reservations existantes sont importees automatiquement ?

Cela depend de la plateforme. Certaines permettent de recuperer les futures reservations existantes, d'autres demandent une verification manuelle. KribOS vous indiquera le comportement attendu pendant l'activation.

### Est-ce que je dois donner mon mot de passe OTA a KribOS ?

Non. Ne partagez pas votre mot de passe OTA. KribOS vous demandera uniquement les identifiants utiles a la connexion ou vous guidera pour autoriser la connexion depuis l'extranet.

### Est-ce que la synchronisation est immediate ?

Une fois la connexion active, les mises a jour de disponibilite et de reservation sont synchronisees automatiquement. Pendant la phase de demande, prevoyez jusqu'a **24h ouvrees** pour la verification KribOS.

### Que faire si je ne trouve pas mon identifiant ?

Envoyez la demande avec le nom de la plateforme et le lien de votre annonce. KribOS vous aidera a retrouver l'information correcte.

## Checklist avant activation

* [ ] Le logement existe dans KribOS.
* [ ] L'annonce existe sur la plateforme OTA.
* [ ] L'identifiant de l'annonce ou de l'etablissement est disponible.
* [ ] L'email du compte OTA est connu.
* [ ] Les reservations futures importantes sont signalees a KribOS.
* [ ] Vous pouvez acceder a l'extranet OTA si une validation est demandee.

## Direction visuelle KribOS pour GitBook

Utilisez ces couleurs pour tous les visuels et blocs GitBook:

| Element           | Recommandation                           |
| ----------------- | ---------------------------------------- |
| Titre page        | `Connecter vos plateformes OTA a KribOS` |
| CTA visuel        | Terracotta KribOS `#B85A3B`              |
| Terracotta clair  | `#F7E9E2`                                |
| Fond doux         | Sand `#FAFAF7`                           |
| Fond secondaire   | Sage `#F1F3EE`                           |
| Texte principal   | Ink `#141412`                            |
| Texte secondaire  | Ink muted `#62645D`                      |
| Bordures          | `#DFE3D8`                                |
| Accent validation | Green `#3B7F5D`                          |
| Accent attention  | Gold `#9A7835`                           |

Pour un rendu plus premium dans GitBook:

1. Ajoutez les trois images SVG au debut, dans **Parcours de connexion** et avant **Ce que KribOS synchronise**.
2. Transformez la section **En bref** en trois cards GitBook si votre plan GitBook le permet.
3. Transformez **Parcours de connexion** en stepper ou cards.
4. Remplacez les citations importantes par des blocks **Hint / Info / Warning** depuis le menu GitBook.
5. Renommez la page dans la sidebar: **Connexion OTA**.
6. Evitez les titres en majuscules automatiques: preferez **Connecter vos plateformes de reservation a KribOS**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kribos.gitbook.io/kribos-docs/guides-clients/gitbook-guide-connexion-ota-gitbook-native.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.