# Board mapping solutions

> URL: https://hotelmapping.org/en/products/board-mapping-solutions/ · Language: English

Board mapping converts the different spellings suppliers send for the same food-and-beverage concept ("ALL INCLUSIVE ULTRA", "Ultra Herşey Dahil", "Ультра всё включено") into a single standard code: RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI or SAI. This way, an all inclusive offer is never compared as if it were the same product as an ultra all inclusive offer.

## What you gain

- **Accurate price comparison:** AI and UAI offers stay under separate codes. It is clear in the listing when a cheaper-looking offer is actually a lower-tier concept.
- **Ten standard codes:** RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI and SAI. All supplier spellings link to this short list; filters and reports work with a single list.
- **Multilingual synonym dictionary:** Turkish, English, German and Russian spellings, typos and abbreviations are kept in the dictionary: "Herşey Dahil", "Halbpension", "Полупансион".
- **New spellings are added in a controlled way:** A spelling not in the dictionary is suggested for a code by a similarity score and added to the dictionary after specialist approval. A spelling that has been approved once is never asked about again.
- **Separate codes for resort concepts:** Concepts common especially at resorts in Turkey and the Mediterranean, such as ultra all inclusive, soft all inclusive and half board with drinks, are covered by separate codes.

## Before and after

Board spellings from three suppliers for the same hotel

**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.
```

Standard board codes

**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" }
  ]
}
```

_Sample data; the hotel and codes do not belong to a real property._

## How it works

1. **Normalization:** The incoming spelling is lowercased; punctuation, extra spaces and abbreviations such as "Inc." and "Incl." are expanded. "Herşey" and "Her Şey" are brought to the same form.
2. **Dictionary match:** The normalized spelling is looked up in the synonym dictionary of each language. If found, it is linked directly to the standard code.
3. **Similarity suggestion:** For spellings not in the dictionary, the closest code is suggested with a similarity score. The score and the method (dictionary or similarity) come back together in the response.
4. **Specialist approval:** Uncertain suggestions go to the review queue. An approved spelling is added to the dictionary and matches directly on the next request.
5. **Delivery:** The standard code comes back instantly in the API response. The original spelling sent by the supplier is also stored, so you can run retrospective checks when needed.

## API example

**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"
    }
  ]
}
```

_Code samples are illustrative; field names may change in the v1 release._

## Where does the confusion come from?

Board type is one of the fields that changes a hotel's price the most. Even so, suppliers often send it as free text and in their own languages. The problem is most visible in resort markets where all inclusive concepts are common, such as Turkey and the Mediterranean, and it shows up in four ways:

1. **Same concept, different spelling.** "ALL INCLUSIVE ULTRA", "Ultra Herşey Dahil" and "Ультра всё включено" are the same concept. Without mapping, the same room is listed as three separate products.
2. **Narrow code list.** A supplier whose system has no UAI code may send the ultra concept as "AI". Then one supplier's UAI price and another's "AI" price end up side by side, and the customer cannot tell what each includes.
3. **Intermediate concepts.** "Soft AI" may be recorded as AI at some suppliers and as FB+ at others. "Half Board Plus" may be reduced to HB, in which case the drink information is lost.
4. **Typos and the hotel's own names.** If a spelling like "Ultra Herşey Dahil Plus" is not in the dictionary verbatim, it is suggested for a code by a similarity score and enters the dictionary after specialist approval.

## Standard codes and common spellings

| Code | Meaning | Spellings seen at suppliers |
| --- | --- | --- |
| RO | Room only | Room Only, Sadece Oda, Ohne Verpflegung, Без питания |
| BB | Bed and breakfast | Bed & Breakfast, Oda Kahvaltı, Frühstück, Завтрак |
| HB | Half board | Half Board, Yarım Pansiyon, Halbpension, Полупансион |
| HB+ | Half board + drinks | Half Board Plus, HB Plus, Yarım Pansiyon + İçecek |
| FB | Full board | Full Board, Tam Pansiyon, Vollpension, Полный пансион |
| FB+ | Full board + drinks | Full Board Plus, Tam Pansiyon Plus |
| AI | All inclusive | All Inclusive, Her Şey Dahil, Herşey Dahil, Всё включено |
| AI+ | Extended all inclusive | All Inclusive Plus, AI Plus, Her Şey Dahil Plus |
| UAI | Ultra all inclusive | Ultra All Inclusive, Ultra Herşey Dahil, Ультра всё включено |
| SAI | Limited all inclusive | Soft All Inclusive, Soft AI, Soft Her Şey Dahil |

The codes are explained in detail in the [board types guide](https://hotelmapping.org/en/guide/board-types-and-codes-guide/), and the difference between AI and UAI is covered in [all inclusive vs. ultra all inclusive](https://hotelmapping.org/en/guide/all-inclusive-vs-ultra-all-inclusive/). For the term, see the [board type](https://hotelmapping.org/en/glossary/board-basis/) glossary page.

## Where the product fits and where it stops

At many mapping providers, board type is not offered as a separate product. At hotelmapping.org, board mapping is a separate product with its own dictionary and review queue; when you request a quote, you can [select it](https://hotelmapping.org/en/get-a-quote/) as a separate module.

Board mapping converts the spelling into a standard code. Which drinks are served at which hours in a hotel's ultra concept is the hotel's own definition; that is a matter for the hotel description, not the board code. For hotel descriptions, see the [hotel content](https://hotelmapping.org/en/products/hotel-descriptions-solutions/) product. For accurate price comparison, the board code works together with [hotel mapping](https://hotelmapping.org/en/products/hotel-mapping-solutions/) and [room mapping](https://hotelmapping.org/en/products/room-mapping-solutions/). For the general framework, see the [hotel mapping guide](https://hotelmapping.org/en/guide/what-is-hotel-mapping/), and to try a single spelling, the [board code converter](https://hotelmapping.org/en/tools/board-code-converter/).

## Frequently asked questions

### What is the difference between AI and UAI?

AI (all inclusive) generally covers meals and domestic drinks. UAI (ultra all inclusive) usually adds extras such as imported drinks or à la carte restaurants. The scope varies from hotel to hotel; we convert the concept into the standard code, while the hotel defines what the concept includes.

### Which code does Soft AI map to?

Soft AI maps to a separate code, SAI. It is generally a more limited form of all inclusive; for example, alcoholic drinks are not offered at all or are limited to certain hours. Recording it as AI or FB+ breaks price comparison.

### What is the difference between Half Board Plus and HB?

Half Board Plus (HB+) adds drinks to half board; usually domestic drinks are included with dinner, and the scope varies from hotel to hotel. If a supplier sends it only as HB, the drink information is lost; the standard code preserves this difference.

### Do other mapping services offer board mapping too?

At many mapping providers, board type is not offered as a separate product. At hotelmapping.org, board mapping is a separate product and works together with hotel and room mapping.

### Can I try a single spelling at once?

Yes. In the free board code converter tool, you can enter a spelling such as "Ultra Herşey Dahil Plus" and see which standard code it maps to.

## Related products

- [Hotel mapping solutions](https://hotelmapping.org/en/products/hotel-mapping-solutions/)
- [Room mapping solutions](https://hotelmapping.org/en/products/room-mapping-solutions/)
- [Hotel descriptions solutions](https://hotelmapping.org/en/products/hotel-descriptions-solutions/)

## Related articles

- [Board types and codes: the RO, BB, HB, FB, AI, UAI guide](https://hotelmapping.org/en/guide/board-types-and-codes-guide/)
- [All Inclusive vs Ultra All Inclusive: the difference and how suppliers spell them](https://hotelmapping.org/en/guide/all-inclusive-vs-ultra-all-inclusive/)
- [What is hotel mapping? How it works: a complete guide](https://hotelmapping.org/en/guide/what-is-hotel-mapping/)
