Compra

12 preguntas que hay que hacer al elegir una API de mapeo hotelero

Al elegir una API de mapeo hotelero, pregunte cómo se mide la precisión, si la cobertura vale para sus regiones, cómo se tratan las coincidencias inciertas, la permanencia de los ID, el soporte de habitaciones y regímenes, los métodos de entrega, el proceso de corrección de errores y las condiciones de salida. Verifique cada respuesta con una prueba hecha con sus propios datos de proveedor.

Autor
Equipo editorial de hotelmapping.org
Última actualización:
13 min de lectura

¿Cómo se usa esta lista?

La mayoría de los proveedores de mapeo hotelero prometen alta precisión, amplia cobertura y fácil integración. Cuando las promesas se parecen, la elección se reduce fácilmente al precio y a la impresión de la demostración. Sin embargo, las diferencias están en los detalles: cómo se mide la precisión, qué pasa con los registros inciertos, cómo se comporta el ID cuando un hotel cierra, si el tipo de habitación y de régimen entran en la cobertura.

Las 12 preguntas siguientes agrupan en cinco apartados los temas que hay que plantear al evaluar una API de mapeo hotelero. Para cada pregunta escribimos por qué importa y cómo verificar la respuesta. La lista es neutral; puede aplicarse del mismo modo a cualquier proveedor, incluido hotelmapping.org.

Si es nuevo en el tema, le recomendamos leer antes la guía qué es el mapeo hotelero. El lado estático y dinámico de las conexiones con proveedores lo explicamos en el artículo integración XML hotelera.

Calidad de los datos

1. ¿Cómo se mide la precisión y cuál es la tasa de coincidencias erróneas?

Por qué importa: una coincidencia errónea suele costar más que una coincidencia ausente. Si dos hoteles distintos se unen en un solo registro, el cliente puede reservar en el hotel equivocado, lo que significa cancelación, queja y coste adicional. La palabra “precisión” puede no significar lo mismo en todos los proveedores: la tasa puede calcularse solo sobre las coincidencias automáticas o incluyendo los registros que han pasado por revisión humana.

Cómo verificarlo: pregunte con qué conjunto de prueba se hizo la medición: ¿cuántos pares de hoteles, de qué regiones, quién los etiquetó, cuándo se midió por última vez? Pida por separado la tasa de coincidencias erróneas (falsos positivos) y la tasa de coincidencias perdidas (falsos negativos). Después envíe una muestra de sus propios datos de proveedor y revise los resultados a mano con su equipo.

2. ¿Para qué regiones y proveedores es válida la tasa de cobertura?

Por qué importa: una tasa de cobertura global puede no reflejar la situación en las regiones en las que usted vende. Las zonas de resorts del Mediterráneo, con muchos establecimientos del mismo nombre y ubicaciones cercanas entre sí, son un terreno difícil. Además, la cobertura depende de si el proveedor de mapeo ya procesa los datos de sus proveedores.

Cómo verificarlo: dé la lista de proveedores con los que trabaja y pida una tasa de cobertura para cada uno. Pida resultados por región para los destinos que más vende (p. ej., Antalya, Muğla, Estambul). Pregunte si la tasa de cobertura se calcula sobre el total de registros o sobre los registros activos y vendibles.

3. ¿Cómo se tratan las coincidencias de las que no se está seguro?

Por qué importa: la mayoría de los sistemas de mapeo generan una puntuación de coincidencia y usan valores de umbral. Lo que se hace con los registros de puntuación no concluyente determina directamente la calidad: ¿se emparejan automáticamente de todos modos, los revisa un especialista o se abre un registro nuevo?

Cómo verificarlo: pregunte por los valores de umbral y qué ocurre en cada intervalo. Pida la proporción de registros que pasan a revisión humana y el tiempo medio de decisión. Compruebe si la respuesta de la API le devuelve la puntuación; si la devuelve, puede aplicar en su lado un umbral más estricto.

Identidad y ciclo de vida

4. ¿Es permanente el ID? ¿Qué pasa con los hoteles que cierran, se fusionan o se separan?

Por qué importa: el identificador de mapeo se escribe en su historial de reservas, en sus tablas de contenido y en sus informes. Si un ID se reasigna a otro hotel o se elimina en silencio, sus datos históricos se corrompen.

Cómo verificarlo: pregunte por escrito si un ID se ha reasignado alguna vez a otro hotel. Pida una respuesta de ejemplo que muestre si, cuando dos hoteles se fusionan, el ID antiguo se redirige al nuevo y cómo se ve eso en la API (p. ej., un campo status o merged_into). Compruebe si los hoteles cerrados se marcan como inactivos.

5. ¿Pueden migrar sus ID y códigos actuales?

Por qué importa: la mayoría de los equipos no empiezan de cero. Puede que tenga códigos de hotel propios o los ID de un servicio de mapeo que usaba antes. Si el nuevo proveedor no puede guardarlos como referencia cruzada, aumenta el coste de la migración.

Cómo verificarlo: envíe una muestra de su tabla de mapeo actual y compruebe si, junto con los nuevos ID, regresan también los identificadores antiguos. Pregunte, en caso de conflicto (cuando su tabla y el resultado del proveedor difieren), cuál se toma como base y si esas diferencias se le reportan.

6. ¿Cómo se notifican los cambios de código de proveedor?

Por qué importa: los proveedores eliminan códigos, asignan códigos nuevos, vuelven a listar un hotel con otro código. Si esos cambios no le llegan, su tabla de mapeo se queda obsoleta en silencio y en la búsqueda aparecen hoteles perdidos o registros duplicados.

Cómo verificarlo: pregunte por qué canal se notifican los cambios: delta dump, webhook o un endpoint de historial de cambios. Compruebe si los registros eliminados y fusionados figuran de forma explícita en el delta. Pida un archivo delta de ejemplo del último mes.

Profundidad de cobertura

7. ¿Existe mapeo de habitaciones y cómo funciona?

Por qué importa: el mapeo hotelero por sí solo no basta para comparar precios. Si “DBL SV”, “Double Room Sea View” y “Deniz Manzaralı Çift Kişilik Oda” son la misma habitación, también deben vincularse a un único identificador. De lo contrario, en la misma tarjeta de hotel la misma habitación aparece varias veces.

Cómo verificarlo: pregunte si el mapeo de habitaciones es un producto aparte o está incluido en el mapeo hotelero. Averigüe si funciona al instante (por llamada) o en bloque. Envíe nombres de habitación difíciles de sus propios datos (abreviados, en varios idiomas, habitaciones familiares, habitaciones comunicadas) y mire los resultados. Para más detalles, consulte nuestra página de mapeo de habitaciones.

8. ¿Se admiten el mapeo de regímenes y el de destinos?

Por qué importa: en el mercado de resorts, el régimen es uno de los factores principales que determinan el precio. Si grafías como “AI”, “All Inclusive”, “Ultra Her Şey Dahil”, “Soft AI” no se convierten a un código estándar, regímenes distintos pueden compararse en la misma línea de precio. En cuanto a los destinos, los proveedores envían la misma zona con jerarquías distintas (p. ej., un proveedor “Antalya”, otro “Belek”).

Cómo verificarlo: pida la lista de códigos de régimen estándar admitidos. Envíe las grafías de régimen que llegan de sus propios proveedores y compruebe a qué código se convierten. Para los destinos, pregunte si los niveles de país, provincia, distrito y zona de resort se mantienen por separado.

9. ¿Cómo se procesan los nombres y direcciones en varios idiomas?

Por qué importa: el mismo hotel puede llegar en un proveedor con caracteres latinos y en otro con caracteres cirílicos o árabes. Los caracteres turcos (ç, ğ, ı, ö, ş, ü) se corrompen o se pierden en algunos sistemas. Estas diferencias dificultan el mapeo basado en la similitud de nombres.

Cómo verificarlo: pregunte cómo se hacen la transliteración y la normalización de caracteres. Incluya en la muestra hoteles que llegan con nombre en ruso o árabe y registros con caracteres turcos corrompidos. Evalúe los resultados por separado en este subgrupo.

Integración técnica y operación

10. ¿Cuáles son los métodos de entrega, los límites y la actualidad?

Por qué importa: el resultado del mapeo se usa en el momento de la búsqueda. Ir a una API remota en cada búsqueda puede crear latencia; la mayoría de los equipos guarda los resultados en su lado como una tabla. Por eso, la entrega de archivos masivos (dump) es tan importante como la API.

Cómo verificarlo: pida por escrito los detalles siguientes:

  • Endpoints de la API y ejemplos de petición/respuesta
  • Límites de llamadas (por minuto, día y mes) y qué ocurre al superarlos
  • Formatos de dump completo y delta (CSV, JSON, Parquet, etc.) y frecuencia de publicación
  • Compatibilidad con webhook
  • Tiempo de mapeo de un nuevo archivo de proveedor
  • Entorno de pruebas (sandbox) y si la documentación es pública

En el entorno de pruebas, ejecute durante varios días un flujo parecido a su carga de trabajo real.

11. ¿Qué pasa cuando se notifica una coincidencia errónea?

Por qué importa: ningún sistema está libre de errores. La diferencia está en la rapidez con que se corrige el error y en si el mismo error se repite. Si el proceso de corrección no está claro, su equipo tendrá que parchear a mano los registros erróneos en su lado.

Cómo verificarlo: pregunte por el canal de notificación de errores (API, portal, correo) y el tiempo objetivo de corrección. Averigüe si la corrección se aplica solo en su cuenta o para todos los clientes. Compruebe si el contrato incluye un nivel de servicio (SLA) y si el idioma de soporte se ajusta a su equipo. Durante la prueba, notifique un error a propósito y siga el proceso de principio a fin.

Condiciones comerciales

12. ¿Cuáles son el modelo de precios, la prueba y las condiciones de salida?

Por qué importa: los servicios de mapeo pueden tarificarse por número de proveedores, de hoteles, de llamadas o por módulo de producto. Si el modelo no encaja con su plan de crecimiento, el coste aumenta de forma inesperada. Además, que pueda seguir usando los resultados de su mapeo cuando termine el contrato determina el coste del cambio.

Cómo verificarlo: compruebe si el precio está escrito de forma clara, qué módulos están incluidos y si hay un cargo por proveedor adicional. Pregunte si hay una prueba gratuita o un entorno de pruebas (sandbox). Pida por escrito en qué formato podrán exportarse los datos al final del contrato y las condiciones de licencia.

Las 12 preguntas de un vistazo

# Pregunta Prueba que hay que pedir Señal de alerta
1 ¿Cómo se mide la precisión? Descripción del conjunto de prueba, resultado con su propia muestra Una única tasa sin método explicado
2 ¿Cuál es la cobertura en sus regiones? Tasa por proveedor y región Solo la tasa global
3 ¿Qué pasa con las coincidencias inciertas? Valores de umbral, tasa de revisión humana Que la puntuación no se devuelva en la API
4 ¿Es permanente el ID? Respuesta de ejemplo de fusión y cierre Que el ID pueda reutilizarse
5 ¿Se pueden migrar los ID actuales? Salida de ejemplo con referencia cruzada Pérdida de los códigos antiguos
6 ¿Se notifican los cambios de código? Archivo delta de ejemplo Que los registros eliminados no estén en el delta
7 ¿Hay mapeo de habitaciones? Resultado de prueba con nombres de habitación difíciles Que solo devuelva texto libre
8 ¿Hay regímenes y destinos? Lista de códigos estándar, ejemplo de jerarquía Que el régimen quede fuera del alcance
9 ¿Se procesan los nombres en varios idiomas? Prueba con registros en cirílico y árabe Caída notable en este subgrupo
10 ¿Cuáles son la entrega y los límites? Documentación, sandbox, ejemplo de dump Que no exista la opción de entrega masiva
11 ¿Cómo se corrigen los errores? Canal de notificación, plazo objetivo, SLA Proceso de corrección poco claro
12 ¿Cuáles son el precio y las condiciones de salida? Precio escrito, derecho de exportación Datos inutilizables al final del contrato

Ejemplo: qué mirar en una respuesta de mapeo

Las respuestas de API que obtiene durante la evaluación contestan de un vistazo a muchas de las preguntas anteriores. A continuación mostramos como ejemplo la respuesta de POST /v1/match de la API v1 de hotelmapping.org para un hotel ficticio; los nombres de campo de otros proveedores pueden ser distintos.

Petición:

{
  "reference": "res-20417",
  "name": "Kemer Pine Garden Hotel",
  "address": "Göynük Mah. Atatürk Cad. No:45, Kemer, Antalya",
  "lat": 36.6515,
  "lng": 30.5601,
  "supplier": "C",
  "supplier_code": "KPG-7781"
}

Respuesta:

{
  "reference": "res-20417",
  "hm_id": "HM-1061590",
  "confidence": 0.984,
  "decision": "auto_match",
  "status": "active",
  "merged_into": null,
  "destination_id": "TR-07-KEMER-GOYNUK",
  "external_ids": { "client": "OTL-2231" },
  "supplier_codes": { "A": "KPGH-1102", "C": "KPG-7781" },
  "matched_at": "2026-11-15T09:20:00Z"
}

Son datos de ejemplo; el nombre del hotel, la dirección y los códigos no pertenecen a un establecimiento real. Los nombres de campo siguen la API v1 y pueden cambiar. En esta respuesta, fíjese en lo siguiente:

  • confidence y decision: ¿se devuelven la puntuación y el tipo de decisión? (Pregunta 3)
  • status y merged_into: ¿se ve el estado de cierre y de fusión? (Pregunta 4)
  • external_ids: ¿se conservan sus propios códigos de hotel o los identificadores de su proveedor actual? (Pregunta 5)
  • supplier_codes: ¿están en un solo registro los códigos de los demás proveedores del mismo hotel? (Pregunta 6)
  • destination_id: ¿la jerarquía de destinos llega con un identificador estándar? (Pregunta 8)

Los detalles de la Find Match API están en las páginas de la API de mapeo y de mapeo hotelero; la lista de endpoints, en la página de desarrolladores.

¿Cómo plantear el proceso de prueba?

Para obtener las respuestas con datos en lugar de con una presentación, basta un breve plan de prueba:

  1. Prepare una muestra: saque una lista de registros formada por todos sus proveedores, las regiones en las que más vende y los casos difíciles (hoteles con el mismo nombre, establecimientos de ubicación cercana, nombres en varios idiomas).
  2. Determine de antemano las respuestas correctas: mapee a mano con su equipo una parte de esa lista. Será el criterio con el que comparará los resultados del proveedor.
  3. Envíe los mismos datos a todos los candidatos: para que la comparación sea justa, cada proveedor debe recibir el mismo archivo.
  4. Mida los resultados por separado: obtenga cifras distintas de coincidencias erróneas, coincidencias perdidas, registros que pasan a revisión humana y tiempo de entrega.
  5. Pruebe la operación: notifique un error, pida un archivo delta, ponga a prueba los límites de la API.
  6. Obtenga las condiciones contractuales por escrito: el precio, el SLA y el derecho de exportación de datos deben figurar con claridad en la oferta.

Calcular cuánto cuestan a su negocio los registros duplicados le ayuda a convertir los resultados de la prueba en impacto de negocio. Para ello, consulte el artículo coste de los hoteles duplicados.

Hágale estas preguntas también a hotelmapping.org

No hemos preparado esta lista a favor de ningún proveedor; esperamos que haga las mismas preguntas también a hotelmapping.org. Nuestros valores medidos de precisión y cobertura se publicarán en la página de cobertura cuando se complete el conjunto de prueba. Cómo se determina la tarificación según los módulos y el número de proveedores lo explicamos en la página de presupuesto. Si está comparando varios proveedores, mida los resultados sobre el mismo conjunto de datos; cómo leer juntas las cifras de precisión y cobertura lo explicamos en el artículo ¿precisión o cobertura en el mapeo?.

Preguntas frecuentes

¿Qué diferencia hay entre precisión y cobertura?

La precisión indica qué parte de las coincidencias realizadas es realmente correcta. La cobertura indica qué parte de los registros de proveedor ha podido vincularse a un hotel. Una puede ser alta y la otra baja; por eso hay que preguntar por las dos por separado y sobre el mismo conjunto de datos.

¿Cuántos datos bastan para una prueba?

No hay una cifra exacta. Lo importante es que la muestra represente su inventario real: las regiones en las que más vende, los casos difíciles (hoteles con el mismo nombre, nombres en cirílico o en caracteres árabes, establecimientos de ubicación cercana) y todos sus proveedores deben estar en la muestra.

Si cambio de proveedor, ¿se pierden mis mapeos?

Depende del contrato y de las condiciones de propiedad de los datos. Antes de elegir, pregunte por escrito en qué formato podrá exportar los resultados del mapeo y si podrá seguir usando esos datos después de que termine el contrato.

¿Podemos hacerle estas preguntas también a hotelmapping.org?

Sí. La lista se ha preparado de forma neutral y puede aplicarse del mismo modo a cualquier proveedor, incluido hotelmapping.org. Una prueba con sus propios datos es el método de comparación más fiable.

Equipo editorial de hotelmapping.org

Equipo de datos hoteleros de DIJI.TECH

El equipo de DIJI.TECH que trabaja en mapeo hotelero, integración de proveedores y software de viajes.

Productos relacionados

  • Soluciones de Find Match API

    Envíe nombre, dirección y coordenadas; reciba el HM ID y la puntuación de confianza. No requiere código de proveedor.

  • Soluciones de mapeo hotelero

    Un HM ID permanente por establecimiento; códigos de proveedor e IDs cruzados en un único registro.