# Soluciones de mapeo de habitaciones

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

El mapeo de habitaciones descompone los distintos nombres que los proveedores envían para una misma habitación en etiquetas de tipo, clase, vista, cama, características y capacidad, y agrupa la misma habitación en un único ID de habitación vinculado al HM ID del hotel (p. ej., HM-1048213-R03). Así, los precios de distintos proveedores para la misma habitación pueden compararse lado a lado.

## Qué ganará

- **Misma habitación, una sola fila:** "DBL SV BLC", "DZ Meerblick Balkon" y "Deniz Manzaralı Balkonlu Çift Kişilik Oda" se vinculan al mismo ID de habitación; los precios se comparan en una sola fila.
- **Diccionario multilingüe de abreviaturas:** Las abreviaturas y variantes de escritura de habitaciones en TR, EN, DE y RU se guardan en un diccionario de reglas; donde el diccionario no alcanza, interviene el modelo de etiquetado.
- **Datos de habitación estructurados:** Cada nombre de habitación se descompone en seis etiquetas. Filtrar y ordenar por vista, tipo de cama o capacidad no requiere un análisis aparte.
- **Se conserva la diferencia de vista y capacidad:** Las habitaciones con vista a tierra y con vista al mar tienen etiquetas distintas; por eso permanecen en IDs de habitación separados y no se muestran en la misma fila.
- **Al instante o por lotes:** En una sola petición se mapean al instante varios nombres de habitación; también se ofrece procesamiento por lotes y entrega por archivo para todo el inventario.

## Antes y después

Nombres de tres proveedores para la misma habitación

**supplier_rooms.csv**

```csv
supplier,hotel_code,room_code,room_name
A,HTL-88213,DBLSV-B,Dbl Sea View Balcony
B,40917,DZMB,DZ Meerblick Balkon
C,TR-ANT-551,STD-DNZ,Standart Oda Deniz Manzaralı Balkonlu (2+1)
```

Un único registro de habitación desglosado en etiquetas

**HM-1048213-R03**

```json
{
  "room_id": "HM-1048213-R03",
  "hm_id": "HM-1048213",
  "name": "Standard Double Room, Sea View, Balcony",
  "type": "room",
  "class": "standard",
  "view": "sea",
  "bed": "double",
  "features": ["balcony"],
  "max_occupancy": 3,
  "supplier_rooms": {
    "A": "DBLSV-B",
    "B": "DZMB",
    "C": "STD-DNZ"
  }
}
```

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

## Cómo funciona

1. **Segmentación del nombre de la habitación:** El nombre de la habitación se divide en palabras y abreviaturas. Se normalizan mayúsculas y minúsculas, puntuación, capacidad entre paréntesis ("2+1") y diferencias de idioma.
2. **Diccionario de reglas:** Cada fragmento se asocia con el diccionario de abreviaturas en TR, EN, DE y RU: "SV", "Meerblick" y "Deniz Manzaralı" caen en la misma etiqueta de vista.
3. **Modelo de etiquetado:** Un modelo de etiquetado asigna a tipo, clase, vista, cama, característica o capacidad los fragmentos que no están en el diccionario o que tienen más de un significado.
4. **Agrupación dentro del hotel:** Las habitaciones vinculadas al mismo HM ID se comparan según sus etiquetas. Los nombres cuyas etiquetas coinciden se vinculan al mismo ID de habitación; los registros contradictorios pasan a revisión humana.
5. **Entrega:** El resultado se devuelve al instante en la respuesta de la API y, en los trabajos por lotes, como archivo. Cada código de habitación de proveedor se guarda junto con el ID de habitación al que se vincula.

## Ejemplo de API

**POST /v1/rooms/map**

```bash
curl -X POST https://api.hotelmapping.org/v1/rooms/map \
  -H "X-API-Key: $HM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hm_id": "HM-1048213",
    "rooms": [
      { "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon" },
      { "supplier": "B", "code": "FZLS", "name": "FZ Landseite" }
    ]
  }'
```

**200 OK**

```json
{
  "hm_id": "HM-1048213",
  "groups": [
    {
      "room_id": "HM-1048213-R03",
      "type": "room",
      "class": "standard",
      "view": "sea",
      "bed": "double",
      "features": ["balcony"],
      "max_occupancy": 3,
      "matched": [
        { "supplier": "B", "code": "DZMB", "name": "DZ Meerblick Balkon", "confidence": 0.98, "decision": "auto_match" }
      ]
    },
    {
      "room_id": "HM-1048213-R07",
      "type": "family_room",
      "class": "standard",
      "view": "land",
      "bed": null,
      "features": [],
      "max_occupancy": 4,
      "matched": [
        { "supplier": "B", "code": "FZLS", "name": "FZ Landseite", "confidence": 0.91, "decision": "review" }
      ]
    }
  ]
}
```

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

## ¿Por qué son tan variados los nombres de habitación?

Cada proveedor escribe el nombre de la habitación según las reglas de su propio sistema. Uno usa abreviaturas ("DBL SV BLC"), otro el lenguaje de catálogo de los touroperadores alemanes ("DZ Meerblick") y otro envía tal cual el nombre en turco que figura en el hotel. Si un hotel tiene 10 tipos de habitación y 5 proveedores, el número de nombres por mapear sube a 50. El mapeo manual es lento y las diferencias de vista o de capacidad se pasan por alto con facilidad.

El mapeo de habitaciones descompone cada nombre en las mismas seis etiquetas y realiza la comparación sobre esas etiquetas en lugar de sobre los nombres. Para una explicación detallada del tema, consulte la guía [qué es el mapeo de habitaciones](https://hotelmapping.org/es/guia/que-es-mapeo-de-habitaciones/) y, para el marco general, la [guía de mapeo hotelero](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/).

## ¿En qué etiquetas se descompone el nombre de la habitación?

| Etiqueta | Qué describe | Valores de ejemplo |
| --- | --- | --- |
| Tipo | Categoría de la habitación | Habitación, suite, junior suite, estudio, habitación familiar, villa, bungalow, apartamento |
| Clase | Nivel de confort | Económica, estándar, superior, deluxe |
| Vista | Lo que se ve desde la ventana | Mar, lateral al mar, tierra, jardín, piscina |
| Cama | Distribución de las camas | Individual (single), doble (double), dos camas separadas (twin), king, queen |
| Característica | Equipamiento adicional | Balcón, terraza, jacuzzi, acceso directo a la piscina, habitación comunicada |
| Capacidad | Número máximo de personas | SGL = 1, DBL = 2, TRP = 3, QUAD = 4; 2+1, 2+2 |

## Diccionario de abreviaturas

El diccionario de reglas vincula a una sola etiqueta las formas de escribir el mismo concepto en cuatro idiomas. Las filas siguientes son ejemplos; la lista completa está en la guía de [abreviaturas de tipos de habitación](https://hotelmapping.org/es/guia/abreviaturas-tipos-de-habitacion/).

| Concepto | EN | DE | TR | RU |
| --- | --- | --- | --- | --- |
| Uso individual (capacidad 1) | SGL | EZ (Einzelzimmer) | Tek kişilik | одноместный |
| Uso doble (capacidad 2) | DBL | DZ (Doppelzimmer) | Çift kişilik | двухместный |
| Dos camas separadas (cama: twin) | TWN | 2 Einzelbetten | İki ayrı yataklı | две кровати |
| Habitación familiar | FAM | FZ (Familienzimmer) | Aile odası | семейный номер |
| Vista al mar | SV | Meerblick | Deniz manzaralı | вид на море |
| Balcón | BLC | Balkon | Balkonlu | балкон |
| Suite | STE | Suite | Süit | люкс |

En la mayoría de los proveedores, DBL indica una habitación para dos personas, pero no siempre especifica el tipo de cama. Por eso "DBL" se lee primero como capacidad (al menos 2 personas). Si el nombre no incluye TWN ni "twin", la etiqueta de cama es double; si hay una pista más clara, como "king", se usa esa. La etiqueta de tipo, en cambio, es la categoría de la habitación: "DBL Sea View" es una habitación (room) y "Junior Suite" es una junior suite.

El mapeo de habitaciones solo funciona entre habitaciones del mismo hotel; por eso el HM ID del hotel se determina primero con el [mapeo hotelero](https://hotelmapping.org/es/productos/soluciones-mapeo-hotelero/). Para que la comparación de precios sea correcta, junto con la habitación también se necesita el [mapeo de regímenes alimenticios](https://hotelmapping.org/es/productos/soluciones-mapeo-regimenes-alimenticios/). Para los términos, consulte las páginas del glosario [mapeo de habitaciones](https://hotelmapping.org/es/glosario/mapeo-de-habitaciones/) y [código de proveedor](https://hotelmapping.org/es/glosario/codigo-de-proveedor/).

## Preguntas frecuentes

### ¿El mapeo de habitaciones se hace después del mapeo hotelero?

Sí. Los nombres de habitación solo se comparan con las habitaciones del mismo hotel. Por eso primero se determina el HM ID del hotel y, a continuación, se agrupan los nombres de habitación de proveedor que pertenecen a ese hotel.

### ¿Qué ocurre si el proveedor cambia el nombre de una habitación?

El nuevo nombre se vuelve a etiquetar. Si las etiquetas no cambian, sigue vinculado al mismo ID de habitación. Si cambian, el registro pasa a la cola de revisión y, si es necesario, se vincula a otro ID de habitación.

### ¿Qué se hace cuando no hay certeza sobre las etiquetas?

Está previsto aplicar también a las habitaciones la lógica de umbrales del mapeo hotelero: 0,97 o más se vincula automáticamente, entre 0,80 y 0,97 pasa a un especialista y por debajo de 0,80 se abre un nuevo registro de habitación. Las decisiones de los especialistas retroalimentan el diccionario y el modelo.

### ¿Qué idiomas de nombres de habitación se admiten?

En el lanzamiento, el diccionario de reglas cubre las abreviaturas en turco, inglés, alemán y ruso. La cobertura para árabe y otros idiomas aún no está decidida.

### ¿El mapeo de habitaciones aporta también datos de precio o disponibilidad?

No. El mapeo de habitaciones solo estandariza los datos estáticos de habitación. El precio y la disponibilidad llegan a su sistema desde el proveedor; nosotros solo indicamos a qué habitación pertenecen.

## Productos relacionados

- [Soluciones de mapeo hotelero](https://hotelmapping.org/es/productos/soluciones-mapeo-hotelero/)
- [Soluciones de mapeo de regímenes alimenticios](https://hotelmapping.org/es/productos/soluciones-mapeo-regimenes-alimenticios/)
- [Soluciones de Find Match API](https://hotelmapping.org/es/productos/soluciones-find-match-api/)

## Artículos relacionados

- [¿Qué es el mapeo de habitaciones? ¿Por qué los nombres de habitación son tan confusos?](https://hotelmapping.org/es/guia/que-es-mapeo-de-habitaciones/)
- [Glosario de abreviaturas de tipos de habitación: SGL, DBL, TWN, TRP, SV, LV, FAM](https://hotelmapping.org/es/guia/abreviaturas-tipos-de-habitacion/)
- [¿Qué es el mapeo hotelero (hotel mapping) y cómo funciona? Guía completa](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/)
