# Solutions de mapping des types de pension

> URL: https://hotelmapping.org/fr/produits/solutions-mapping-types-pension/ · Langue: Français

Le mapping des types de pension convertit en un code standard unique les différentes graphies que les fournisseurs envoient pour un même concept de restauration (« ALL INCLUSIVE ULTRA », « Ultra Herşey Dahil », « Ультра всё включено ») : RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI ou SAI. Une offre tout compris n'est ainsi plus comparée comme s'il s'agissait du même produit qu'une offre ultra tout compris.

## Ce que vous y gagnez

- **Comparaison de prix correcte:** Les offres AI et UAI restent sous des codes distincts. On voit clairement dans la liste quand l'offre qui paraît moins chère correspond en réalité à un concept inférieur.
- **Dix codes standard:** RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI et SAI. Toutes les graphies fournisseurs sont rattachées à cette courte liste ; filtres et rapports fonctionnent avec une seule liste.
- **Dictionnaire de synonymes multilingue:** Les graphies en turc, anglais, allemand et russe, ainsi que les fautes de frappe et les abréviations, sont conservées dans le dictionnaire : « Herşey Dahil », « Halbpension », « Полупансион ».
- **Les nouvelles graphies sont ajoutées de façon contrôlée:** Une graphie absente du dictionnaire est proposée pour un code par score de similarité, puis ajoutée au dictionnaire après validation par un expert. Une graphie validée une fois n'est plus jamais redemandée.
- **Codes distincts pour les concepts de villégiature:** Des concepts répandus surtout dans les complexes de Turquie et de Méditerranée, comme l'ultra tout compris, le soft tout compris et la demi-pension avec boissons, disposent de codes distincts.

## Avant et après

Graphies de pension de trois fournisseurs pour un même hôtel

**supplier_boards.csv**

```csv
supplier,hotel_code,rate_code,board
A,HTL-88213,R1,ALL INCLUSIVE ULTRA
B,40917,UAI,Ultra Herşey Dahil
C,TR-ANT-551,UAI-1,Ультра всё включено
A,HTL-88213,R2,Half Board Plus
B,40917,HBP,Yarım Pansiyon + İçecek
C,TR-ANT-551,SAI,Soft All Inc.
```

Codes de pension standard

**boards.json**

```json
{
  "hm_id": "HM-1048213",
  "boards": [
    { "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
    { "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
    { "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
    { "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
    { "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
    { "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
  ]
}
```

_Données d'exemple ; l'hôtel et les codes ne correspondent à aucun établissement réel._

## Comment ça marche

1. **Normalisation:** La graphie reçue est mise en minuscules ; la ponctuation, les espaces superflus et les abréviations comme « Inc. » ou « Incl. » sont développés. « Herşey » et « Her Şey » sont ramenés à la même forme.
2. **Correspondance dans le dictionnaire:** La graphie normalisée est recherchée dans le dictionnaire de synonymes de chaque langue. Si elle est trouvée, elle est directement rattachée au code standard.
3. **Proposition par similarité:** Pour les graphies absentes du dictionnaire, le code le plus proche est proposé avec un score de similarité. Le score et la méthode (dictionnaire ou similarité) sont renvoyés ensemble dans la réponse.
4. **Validation par un expert:** Les propositions incertaines passent dans la file de contrôle. La graphie validée est ajoutée au dictionnaire et correspond directement à la requête suivante.
5. **Livraison:** Le code standard est renvoyé instantanément dans la réponse API. La graphie d'origine envoyée par le fournisseur est également conservée, ce qui permet un contrôle rétroactif si nécessaire.

## Exemple d'API

**POST /v1/boards/map**

```bash
curl -X POST https://api.hotelmapping.org/v1/boards/map \
  -H "X-API-Key: $HM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hm_id": "HM-1048213",
    "values": ["Soft All Inc.", "Ultra Herşey Dahil Plus"]
  }'
```

**200 OK**

```json
{
  "results": [
    {
      "input": "Soft All Inc.",
      "code": "SAI",
      "score": 0.99,
      "decision": "auto_match",
      "method": "dictionary"
    },
    {
      "input": "Ultra Herşey Dahil Plus",
      "code": "UAI",
      "score": 0.88,
      "decision": "review",
      "method": "similarity"
    }
  ]
}
```

_Les exemples de code sont indicatifs ; les noms de champs peuvent changer lors de la publication de la v1._

## D'où vient la confusion ?

Le type de pension est l'un des champs qui font le plus varier le prix d'un hôtel. Pourtant, les fournisseurs l'envoient le plus souvent en texte libre et dans leur propre langue. Le problème est particulièrement visible sur les marchés de villégiature comme la Turquie et la Méditerranée, où les concepts tout compris sont répandus, et il prend quatre formes :

1. **Même concept, graphie différente.** « ALL INCLUSIVE ULTRA », « Ultra Herşey Dahil » et « Ультра всё включено » désignent le même concept. Sans mapping, la même chambre est listée comme trois produits distincts.
2. **Liste de codes trop étroite.** Un fournisseur dont le système n'a pas de code UAI peut envoyer le concept ultra sous la forme « AI ». Le prix UAI d'un fournisseur se retrouve alors à côté du prix « AI » d'un autre, et le client ne comprend pas ce que chacun inclut.
3. **Concepts intermédiaires.** Le « Soft AI » peut être enregistré comme AI chez certains fournisseurs et comme FB+ chez d'autres. Le « Half Board Plus » peut être réduit à HB ; l'information sur les boissons est alors perdue.
4. **Fautes de frappe et appellations propres à l'hôtel.** Si une graphie comme « Ultra Herşey Dahil Plus » n'existe pas à l'identique dans le dictionnaire, elle est proposée pour un code par score de similarité, puis entre dans le dictionnaire après validation par un expert.

## Codes standard et graphies courantes

| Code | Signification | Graphies observées chez les fournisseurs |
| --- | --- | --- |
| RO | Chambre seule | Room Only, Sadece Oda, Ohne Verpflegung, Без питания |
| BB | Chambre et petit-déjeuner | Bed & Breakfast, Oda Kahvaltı, Frühstück, Завтрак |
| HB | Demi-pension | Half Board, Yarım Pansiyon, Halbpension, Полупансион |
| HB+ | Demi-pension + boissons | Half Board Plus, HB Plus, Yarım Pansiyon + İçecek |
| FB | Pension complète | Full Board, Tam Pansiyon, Vollpension, Полный пансион |
| FB+ | Pension complète + boissons | Full Board Plus, Tam Pansiyon Plus |
| AI | Tout compris | All Inclusive, Her Şey Dahil, Herşey Dahil, Всё включено |
| AI+ | Tout compris étendu | All Inclusive Plus, AI Plus, Her Şey Dahil Plus |
| UAI | Ultra tout compris | Ultra All Inclusive, Ultra Herşey Dahil, Ультра всё включено |
| SAI | Tout compris limité | Soft All Inclusive, Soft AI, Soft Her Şey Dahil |

Le détail des codes figure dans le [guide des types de pension](https://hotelmapping.org/fr/guide/types-de-pension-et-codes/) ; la différence entre AI et UAI est expliquée dans l'article sur la [différence entre tout compris et ultra tout compris](https://hotelmapping.org/fr/guide/tout-compris-ultra-tout-compris-difference/). Pour le terme, consultez la page du glossaire [type de pension](https://hotelmapping.org/fr/glossaire/type-de-pension/).

## Place et limites du produit

Chez beaucoup de prestataires de mapping, le type de pension n'est pas proposé comme un produit à part. Chez hotelmapping.org, le mapping des types de pension est un produit distinct, avec son propre dictionnaire et sa propre file de contrôle ; lorsque vous demandez un devis, vous pouvez le [sélectionner](https://hotelmapping.org/fr/demander-un-devis/) comme module séparé.

Le mapping des types de pension convertit la graphie en code standard. Quelles boissons sont servies à quels horaires dans le concept ultra d'un hôtel relève de la description propre à l'hôtel : ce n'est pas l'objet du code de pension, mais de la description de l'hôtel. Pour les descriptions d'hôtels, consultez le produit [contenu hôtelier](https://hotelmapping.org/fr/produits/solutions-descriptions-hotels/). Pour une comparaison de prix correcte, le code de pension fonctionne avec le [mapping hôtelier](https://hotelmapping.org/fr/produits/solutions-mapping-hotelier/) et le [mapping des chambres](https://hotelmapping.org/fr/produits/solutions-mapping-chambres/). Pour le cadre général, consultez le [guide du mapping hôtelier](https://hotelmapping.org/fr/guide/qu-est-ce-que-le-mapping-hotelier/) ; pour tester une seule graphie, le [convertisseur de codes de pension](https://hotelmapping.org/fr/outils/convertisseur-code-pension/).

## Questions fréquentes

### Quelle est la différence entre AI et UAI ?

L'AI (tout compris) couvre généralement les repas et les boissons locales. L'UAI (ultra tout compris) y ajoute généralement des services supplémentaires tels que les boissons importées ou les restaurants à la carte. Le périmètre varie d'un hôtel à l'autre ; nous convertissons le concept en code standard, c'est l'hôtel qui définit le contenu du concept.

### À quel code correspond le Soft AI ?

Le Soft AI correspond à un code distinct, SAI. Il s'agit généralement d'une forme plus limitée du tout compris ; par exemple, les boissons alcoolisées ne sont pas proposées ou sont limitées à certains horaires. L'enregistrer comme AI ou FB+ fausse la comparaison des prix.

### Quelle est la différence entre Half Board Plus et HB ?

Le Half Board Plus (HB+) ajoute des boissons à la demi-pension ; en général, les boissons locales sont incluses au dîner, avec un périmètre variable selon l'hôtel. Si un fournisseur l'envoie simplement comme HB, l'information sur les boissons est perdue ; le code standard préserve cette différence.

### Le mapping des types de pension existe-t-il chez d'autres prestataires de mapping ?

Chez beaucoup de prestataires de mapping, le type de pension n'est pas proposé comme un produit à part. Chez hotelmapping.org, le mapping des types de pension est un produit distinct, qui fonctionne avec le mapping des hôtels et des chambres.

### Peut-on tester une graphie en une seule fois ?

Oui. Dans l'outil gratuit de conversion de codes de pension, vous pouvez saisir une graphie comme « Ultra Herşey Dahil Plus » et voir à quel code standard elle correspond.

## Produits associés

- [Solutions de mapping hôtelier](https://hotelmapping.org/fr/produits/solutions-mapping-hotelier/)
- [Solutions de mapping des chambres](https://hotelmapping.org/fr/produits/solutions-mapping-chambres/)
- [Solutions de descriptions d'hôtels](https://hotelmapping.org/fr/produits/solutions-descriptions-hotels/)

## Articles associés

- [Guide des types de pension et de leurs codes : RO, BB, HB, FB, AI, UAI](https://hotelmapping.org/fr/guide/types-de-pension-et-codes/)
- [Différence entre tout compris et ultra tout compris, et écritures variées des fournisseurs](https://hotelmapping.org/fr/guide/tout-compris-ultra-tout-compris-difference/)
- [Qu'est-ce que le mapping hôtelier (hotel mapping) ? Fonctionnement et guide complet](https://hotelmapping.org/fr/guide/qu-est-ce-que-le-mapping-hotelier/)
