# Soluciones de mapeo de regímenes alimenticios

> URL: https://hotelmapping.org/es/productos/soluciones-mapeo-regimenes-alimenticios/ · Idioma: Español

El mapeo de regímenes alimenticios convierte las distintas grafías que los proveedores envían para un mismo concepto de comidas y bebidas ("ALL INCLUSIVE ULTRA", "Ultra Herşey Dahil", "Ультра всё включено") en un único código estándar: RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI o SAI. Así, una oferta de todo incluido no se compara con una de ultra todo incluido como si fueran el mismo producto.

## Qué ganará

- **Comparación de precios correcta:** Las ofertas AI y UAI permanecen en códigos separados. Se ve con claridad en el listado cuando la oferta que parece más barata es en realidad un concepto inferior.
- **Diez códigos estándar:** RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI y SAI. Todas las grafías de los proveedores se vinculan a esta lista corta; los filtros y los informes funcionan con una única lista.
- **Diccionario multilingüe de sinónimos:** Las grafías en turco, inglés, alemán y ruso, así como las erratas y abreviaturas, se guardan en el diccionario: "Herşey Dahil", "Halbpension", "Полупансион".
- **Las grafías nuevas se añaden de forma controlada:** Una grafía que no está en el diccionario se propone para un código mediante una puntuación de similitud y se incorpora al diccionario tras la aprobación de un especialista. Una grafía aprobada una vez no se vuelve a consultar.
- **Códigos propios para los conceptos de resort:** Conceptos habituales sobre todo en los resorts de Turquía y del Mediterráneo, como ultra todo incluido, soft todo incluido o media pensión con bebidas, se cubren con códigos independientes.

## Antes y después

Grafías de régimen de tres proveedores para el mismo 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.
```

Códigos de régimen estándar

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

_Datos de ejemplo; el hotel y los códigos no corresponden a un establecimiento real._

## Cómo funciona

1. **Normalización:** La grafía recibida se pasa a minúsculas; se eliminan la puntuación y los espacios sobrantes y se expanden abreviaturas como "Inc." o "Incl.". "Herşey" y "Her Şey" se llevan a la misma forma.
2. **Coincidencia con el diccionario:** La grafía normalizada se busca en el diccionario de sinónimos de cada idioma. Si se encuentra, se vincula directamente al código estándar.
3. **Propuesta por similitud:** Para las grafías que no están en el diccionario, se propone el código más cercano con una puntuación de similitud. La puntuación y el método (diccionario o similitud) se devuelven juntos en la respuesta.
4. **Aprobación de un especialista:** Las propuestas dudosas pasan a la cola de revisión. La grafía aprobada se añade al diccionario y en la siguiente petición coincide directamente.
5. **Entrega:** El código estándar se devuelve al instante en la respuesta de la API. También se conserva la grafía original enviada por el proveedor, de modo que se puede hacer una comprobación retroactiva cuando haga falta.

## Ejemplo de 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"
    }
  ]
}
```

_Los ejemplos de código son ilustrativos; los nombres de los campos pueden cambiar en la versión v1._

## ¿De dónde viene la confusión?

El régimen alimenticio es uno de los campos que más modifica el precio de un hotel. Aun así, los proveedores suelen enviarlo como texto libre y en su propio idioma. El problema es más evidente en los mercados de resorts donde predominan los conceptos de todo incluido, como Turquía y el Mediterráneo, y se manifiesta de cuatro maneras:

1. **El mismo concepto, distinta grafía.** "ALL INCLUSIVE ULTRA", "Ultra Herşey Dahil" y "Ультра всё включено" son el mismo concepto. Sin mapeo, la misma habitación se lista como tres productos distintos.
2. **Lista de códigos reducida.** Un proveedor cuyo sistema no tiene el código UAI puede enviar el concepto ultra como "AI". Entonces el precio UAI de un proveedor se coloca junto al precio "AI" de otro y el cliente no puede saber qué incluye cada uno.
3. **Conceptos intermedios.** "Soft AI" puede registrarse como AI en unos proveedores y como FB+ en otros. "Half Board Plus" puede reducirse a HB; en ese caso se pierde la información de las bebidas.
4. **Erratas y nombres propios del hotel.** Si una grafía como "Ultra Herşey Dahil Plus" no está literalmente en el diccionario, se propone para un código mediante una puntuación de similitud y entra en el diccionario tras la aprobación de un especialista.

## Códigos estándar y grafías habituales

| Código | Significado | Grafías vistas en proveedores |
| --- | --- | --- |
| RO | Solo alojamiento | Room Only, Sadece Oda, Ohne Verpflegung, Без питания |
| BB | Alojamiento y desayuno | Bed & Breakfast, Oda Kahvaltı, Frühstück, Завтрак |
| HB | Media pensión | Half Board, Yarım Pansiyon, Halbpension, Полупансион |
| HB+ | Media pensión + bebidas | Half Board Plus, HB Plus, Yarım Pansiyon + İçecek |
| FB | Pensión completa | Full Board, Tam Pansiyon, Vollpension, Полный пансион |
| FB+ | Pensión completa + bebidas | Full Board Plus, Tam Pansiyon Plus |
| AI | Todo incluido | All Inclusive, Her Şey Dahil, Herşey Dahil, Всё включено |
| AI+ | Todo incluido ampliado | All Inclusive Plus, AI Plus, Her Şey Dahil Plus |
| UAI | Ultra todo incluido | Ultra All Inclusive, Ultra Herşey Dahil, Ультра всё включено |
| SAI | Todo incluido limitado | Soft All Inclusive, Soft AI, Soft Her Şey Dahil |

La explicación detallada de los códigos está en la [guía de tipos de régimen](https://hotelmapping.org/es/guia/tipos-regimen-alimenticio-codigos/) y la diferencia entre AI y UAI, en el artículo sobre la [diferencia entre todo incluido y ultra todo incluido](https://hotelmapping.org/es/guia/todo-incluido-ultra-todo-incluido-diferencia/). Para el término, consulte la página del glosario [régimen alimenticio](https://hotelmapping.org/es/glosario/regimen-alimenticio/).

## El lugar y el límite del producto

En muchos proveedores de mapeo, el régimen alimenticio no se ofrece como producto aparte. En hotelmapping.org, en cambio, el mapeo de regímenes es un producto independiente, con su propio diccionario y su propia cola de revisión; al solicitar un presupuesto puede [elegirlo](https://hotelmapping.org/es/solicitar-presupuesto/) como módulo aparte.

El mapeo de regímenes convierte la grafía en el código estándar. Qué bebidas se sirven y en qué horarios dentro del concepto ultra de un hotel es una definición del propio hotel; no es asunto del código de régimen, sino de la descripción del hotel. Para las descripciones de hoteles, consulte el producto de [contenido hotelero](https://hotelmapping.org/es/productos/soluciones-descripciones-hoteles/). Para una comparación de precios correcta, el código de régimen funciona junto con el [mapeo hotelero](https://hotelmapping.org/es/productos/soluciones-mapeo-hotelero/) y el [mapeo de habitaciones](https://hotelmapping.org/es/productos/soluciones-mapeo-habitaciones/). Para el marco general, consulte la [guía de mapeo hotelero](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/) y, para probar una grafía concreta, el [conversor de códigos de régimen](https://hotelmapping.org/es/herramientas/conversor-codigo-regimen/).

## Preguntas frecuentes

### ¿Cuál es la diferencia entre AI y UAI?

AI (todo incluido) suele cubrir las comidas y las bebidas locales. UAI (ultra todo incluido) normalmente añade servicios adicionales, como bebidas importadas o restaurantes a la carta. El alcance varía de un hotel a otro; nosotros convertimos el concepto en el código estándar, pero el contenido del concepto lo define el hotel.

### ¿A qué código corresponde Soft AI?

Soft AI corresponde a un código propio, SAI. Suele ser una forma más limitada de todo incluido; por ejemplo, no ofrece bebidas alcohólicas o las limita a ciertos horarios. Registrarlo como AI o FB+ distorsiona la comparación de precios.

### ¿Qué diferencia hay entre Half Board Plus y HB?

Half Board Plus (HB+) añade bebidas a la media pensión; normalmente incluye bebidas locales en la cena, aunque el alcance varía de un hotel a otro. Si un proveedor lo envía solo como HB, se pierde la información de las bebidas; el código estándar conserva esa diferencia.

### ¿El mapeo de regímenes existe también en otros servicios de mapeo?

En muchos proveedores de mapeo, el régimen alimenticio no se ofrece como producto aparte. En hotelmapping.org, en cambio, el mapeo de regímenes es un producto independiente y funciona junto con el mapeo de hoteles y de habitaciones.

### ¿Se puede probar una grafía de forma puntual?

Sí. En la herramienta gratuita de conversión de códigos de régimen puede introducir una grafía como "Ultra Herşey Dahil Plus" y ver a qué código estándar corresponde.

## Productos relacionados

- [Soluciones de mapeo hotelero](https://hotelmapping.org/es/productos/soluciones-mapeo-hotelero/)
- [Soluciones de mapeo de habitaciones](https://hotelmapping.org/es/productos/soluciones-mapeo-habitaciones/)
- [Soluciones de descripciones de hoteles](https://hotelmapping.org/es/productos/soluciones-descripciones-hoteles/)

## Artículos relacionados

- [Tipos de régimen alimenticio y códigos: guía de RO, BB, HB, FB, AI y UAI](https://hotelmapping.org/es/guia/tipos-regimen-alimenticio-codigos/)
- [Diferencia entre Todo Incluido y Ultra Todo Incluido y las distintas grafías de los proveedores](https://hotelmapping.org/es/guia/todo-incluido-ultra-todo-incluido-diferencia/)
- [¿Qué es el mapeo hotelero (hotel mapping) y cómo funciona? Guía completa](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/)
