Only with us

Board mapping solutions

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
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
{
  "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. 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. 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. 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. 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. 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.

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, and the difference between AI and UAI is covered in all inclusive vs. ultra all inclusive. For the term, see the board type 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 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 product. For accurate price comparison, the board code works together with hotel mapping and room mapping. For the general framework, see the hotel mapping guide, and to try a single spelling, the board code converter.

What is hotel mapping? The complete guide

API example

Request

POST /v1/boards/map
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"]
  }'

Response

200 OK
{
  "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.

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.

Request a quote

Get your tailored quote

Send your request in three steps; we will email the quote to your work address. The request is non-binding.

  1. 1 Select solutions
  2. 2 Select suppliers
  3. 3 Leave your contact details