# Soluciones de ficha de hotel

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

La ficha de hotel ofrece los datos básicos de un hotel en campos separados y filtrables en lugar de texto libre: tipo de establecimiento, estrellas, número de habitaciones, horarios de entrada y salida, playa y piscinas, política de niños y mascotas, restaurantes y datos de contacto. La información de todos los proveedores se reúne bajo el HM ID del hotel, los valores contradictorios se marcan; los datos se entregan por API y archivos dump.

## Qué ganará

- **Listo para filtrar:** La hora de entrada, la política de niños, el tipo de playa y el número de habitaciones son campos independientes, por lo que se usan directamente en filtros y comparaciones.
- **Un hotel, una sola verdad:** La información de un hotel en todos los proveedores se reúne bajo un único HM ID. La página del hotel no cambia según el proveedor del que se llegue.
- **Contradicciones visibles:** Cuando los proveedores dan valores distintos para el mismo campo, el campo se marca. En la respuesta ve qué datos están pendientes de revisión.
- **Coherente con las descripciones:** Las descripciones de hoteles se generan a partir de los mismos datos de la ficha; el texto y los campos no se contradicen.

## Antes y después

Datos brutos del establecimiento de dos proveedores

**supplier_facts.txt**

```text
[A / HTL-88213]
Check-in 14:00 / Check-out 12:00. 412 rooms. Private sandy
beach 250m. 3 outdoor pools, 1 indoor pool. Kids 0-6.99 free.
Pets not allowed.

[B / 40917]
Giriş: 15.00, Çıkış: 12.00 - 410 oda - Otele ait kum plaj
(250 mt) - Açık havuz x3 - Çocuk 0-7 yaş arası ücretsiz
```

Ficha de hotel estándar bajo un HM ID

**Ficha de hotel HM-1048213**

```json
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "check_in": "14:00",
    "check_out": "12:00",
    "room_count": 412,
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
    "pets_allowed": false,
    "review_flags": ["check_in", "room_count"]
  }
}
```

_Datos de ejemplo; el hotel y los códigos no pertenecen a un establecimiento real. Los campos en los que los proveedores se contradicen (aquí, la hora de entrada y el número de habitaciones) se marcan con review_flags._

## Cómo funciona

1. **Reunión de las fuentes:** Se reúnen los datos de todos los registros de proveedores vinculados al mismo HM ID. Los datos brutos se conservan tal cual y los cambios se versionan.
2. **División en campos:** Los horarios, cifras, distancias y políticas del texto libre se convierten en campos separados; se normalizan los formatos de hora, distancia y edad.
3. **Control de contradicciones:** Cuando las fuentes dan información distinta, se comparan los valores. Los campos dudosos se marcan y pasan a la cola de revisión del equipo de datos.
4. **Entrega y actualización:** La ficha de hotel se devuelve desde el endpoint GET /v1/hotels/{hm_id}/content; todo el inventario llega en archivos dump completos y delta diarios.

## Ejemplo de API

**Solicitud de ficha de hotel**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "property": { "type": "resort", "stars": 5, "room_count": 412 },
    "policies": {
      "check_in": "14:00",
      "check_out": "12:00",
      "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
      "pets_allowed": false
    },
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "dining": [
      { "type": "restaurant", "cuisine": "turkish" },
      { "type": "bar", "location": "pool" }
    ],
    "contact": { "email": "info@sunsetbay.example" },
    "review_flags": ["check_in", "room_count"]
  },
  "updated_at": "2026-11-02T08:14:00Z"
}
```

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

## ¿Por qué la ficha de hotel usa campos separados?

Los proveedores suelen enviar los datos del hotel dentro de texto libre. Uno escribe la hora de entrada como 14:00 y otro como 15:00; uno dice 412 habitaciones y otro 410. La información de la playa se pierde dentro de una frase y el límite de edad de los niños llega en formatos distintos. Así no se puede montar un filtro de "hoteles con playa de arena privada" o "niños de 0 a 6 años gratis".

La ficha de hotel extrae estos datos a campos separados y los vincula al [HM ID](https://hotelmapping.org/es/glosario/hm-id/) del hotel. El requisito previo es mapear bien el hotel; puede consultar el método en la [guía de mapeo hotelero](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/) y el producto en la página de [mapeo hotelero](https://hotelmapping.org/es/productos/soluciones-mapeo-hotelero/).

## Campos de la ficha de hotel

| Grupo | Campos | Valor de ejemplo |
| --- | --- | --- |
| Datos del establecimiento | Tipo de establecimiento, estrellas, cadena y marca, número de habitaciones y plantas, año de apertura y de renovación | Resort, 5 estrellas, 412 habitaciones |
| Políticas | Horario de entrada y salida; política de niños, mascotas, tabaco y pago | 14:00 / 12:00, gratis de 0 a 6,99 años |
| Playa y piscina | Tipo de playa, si es del hotel, distancia; número de piscinas exteriores e interiores | Arena, del hotel, 250 m; 3 exteriores, 1 interior |
| Restauración | Restaurantes, bares, tipos de cocina, horarios de apertura | Restaurante de cocina turca, bar en la piscina |
| Contacto y dirección | Dirección verificada, teléfono, correo electrónico, sitio web | info@sunsetbay.example |

Los nombres y valores de los campos son independientes del idioma; en su interfaz muestra la etiqueta en su propio idioma.

## Información contradictoria

Cuando los proveedores dan valores distintos para el mismo hotel, se comparan los valores. Los campos que siguen siendo dudosos se marcan con `review_flags` y los revisa el equipo de datos. Así ve en la respuesta qué información es segura y cuál está pendiente de revisión.

## Descripciones y entrega

Las [descripciones de hoteles](https://hotelmapping.org/es/productos/soluciones-descripciones-hoteles/) se generan a partir de los mismos datos de la ficha; un horario o una distancia que aparezcan en el texto no contradicen el valor del campo. La galería de fotos del hotel está en el servicio de [imágenes de hoteles](https://hotelmapping.org/es/productos/soluciones-imagenes-hoteles/); si la ficha indica que el hotel tiene playa y no hay ninguna imagen etiquetada como playa, puede generar una alerta para el equipo de contenido.

La ficha de hotel se entrega por API REST hotel a hotel y, para todo el inventario, con archivos completos y [dump delta](https://hotelmapping.org/es/glosario/delta-dump/) diarios. El parámetro `include` y los nombres de campo del ejemplo son un borrador de la API v1; el esquema definitivo se publicará en la [página para desarrolladores](https://hotelmapping.org/es/desarrolladores/). Para conocer el alcance y el precio, puede [solicitar un presupuesto](https://hotelmapping.org/es/solicitar-presupuesto/).

## Preguntas frecuentes

### ¿Qué es la ficha de hotel?

Es la presentación de los datos básicos de un hotel (tipo de establecimiento, estrellas, número de habitaciones, horarios de entrada y salida, políticas, restauración, contacto) en campos estructurados.

### ¿Cuál es la diferencia entre la ficha de hotel y la descripción del hotel?

La descripción es un texto escrito para leerse; la ficha de hotel son campos separados para filtrar y comparar. Ambas se basan en los mismos datos verificados.

### ¿Qué valor se usa si los proveedores dan información distinta?

Se comparan los valores; los campos que siguen siendo dudosos se marcan y los revisa el equipo de datos. En la respuesta, review_flags muestra qué campos están pendientes de revisión.

### ¿En qué formatos puedo recibir los datos de la ficha de hotel?

Por API REST hotel a hotel o, para todo el inventario, con archivos dump completos y delta diarios (CSV, JSON). Está previsto un webhook para notificar cambios.

## Productos relacionados

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

## Artículos relacionados

- [¿Qué es la integración XML hotelera? Diferencia entre datos estáticos y dinámicos](https://hotelmapping.org/es/guia/que-es-integracion-xml-hoteles/)
- [¿Qué es el mapeo hotelero (hotel mapping) y cómo funciona? Guía completa](https://hotelmapping.org/es/guia/que-es-mapeo-hotelero/)
- [Coste de los hoteles duplicados para la agencia: conversión, cancelaciones y quejas de clientes](https://hotelmapping.org/es/guia/coste-hoteles-duplicados/)
