Da de alta los cuatro tipos de entidad de tu cuenta

Al terminar tendrás una de cada uno de los cuatro tipos de entidad en tu cuenta —un alojamiento, una ubicación, una búsqueda de ubicación y un vuelo—, que es lo que te pide cualquier endpoint Feed o Real Time para saber sobre qué trabajar.

Qué necesitas: una API key de Veetal. Nada más: los endpoints de account son gratis y funcionan con cualquier key.

Lo que cuesta: nada en el dashboard. Dar de alta entidades es gratis, y también la resolución contra Booking y la búsqueda de perfiles en OTAs que hacen los asistentes mientras las creas: solo pagas cuando pides datos sobre ellas. Por API, dos de esas consultas son peticiones aparte; la sección de API, al final, dice cuáles.

Qué es una entidad y por qué hay cuatro

Una entidad es algo que le has dicho a Veetal que vigile. Los endpoints no aceptan texto libre: aceptan tus identificadores. Cuál necesitas depende de la pregunta:

Los cuatro viven en Mi organización, cada uno en su pestaña, y los cuatro se pueden crear también desde el botón + de la cabecera. Si abres el asistente desde la página de una API, añade un paso final para meter la entidad nueva directamente en los schedules de esa API.

1. Alojamiento — el hotel

En la pestaña Accommodations, Add accommodations. El asistente abre con tres caminos:

Search Booking accommodation es el habitual. I have accommodation Booking URL sirve cuando la búsqueda es ambigua y ya tienes la ficha abierta. Import accommodations from .csv/.xls file es la vía masiva.

Busca por nombre. Los resultados traen la foto y la ciudad del hotel, y los que ya tienes en la cuenta salen en gris y marcados It's yours, lo que te ahorra el duplicado:

Si no aparece nada, usa menos palabras: la búsqueda casa contra Booking por aproximación, no por tu cadena exacta.

Elige uno y Continue. Veetal resuelve la ficha de verdad y te enseña lo que ha encontrado —estrellas, nota de los huéspedes, número de reseñas, dirección— más Profiles Found: en qué OTAs tiene ficha ese hotel realmente.

En este ejemplo aparecieron Booking, Tripadvisor y Google; Expedia y Hotels.com no. Eso importa después: una OTA sin ficha no tiene nada que importar, y el feed de reputación solo devolverá las del tick verde. Repeat search profiles relanza la detección si crees que se ha dejado alguna, y View Profile abre la ficha con la que ha casado para que compruebes que es el hotel correcto.

Add accommodation y el hotel entra en el listado de la pestaña Accommodations. Su columna SETUP es ese mismo mapa de perfiles, una insignia por OTA; aquí, en otros hoteles de la cuenta:

Un detalle que conviene saber: el slug que asigna Veetal sale de la URL de Booking, no del nombre. "Ohla Barcelona" se quedó en ohla. El slug es lo que piden todos los endpoints, así que cópialo de la fila en vez de deducirlo.

2. Ubicación — el destino

Pestaña Locations, Add locations. El propio diálogo dice para qué es: "You will use them to search events in the destination".

Busca el destino y verás por qué existe este paso:

Cuatro Barcelonas —España, Venezuela, Colombia, Filipinas—, cada una con sus coordenadas y un Show Map para comprobarlo. Elige la que no es y todos los eventos que leas después serán de otra ciudad.

Add location y la fila aparece con su tipo —aquí Tier 1— y sus coordenadas:

3. Búsqueda de ubicación — el destino, filtrado

Pestaña Location searches, Add location searches. El buscador es más rico que el de ubicaciones: además de la ciudad ofrece barrios, el aeropuerto, la provincia y recintos como la Fira, porque un "mercado" puede ser cualquiera de esas cosas.

El segundo paso es la razón de ser de esta entidad: los filtros.

País, moneda e idioma (cambian los precios que enseña Booking), régimen, estrellas, tipo de alojamiento y, más abajo, distancia al centro, puntuación mínima, cancelación gratuita, pet friendly, noches, adultos, niños, bebés y habitaciones.

Esos filtros son la entidad. Definen qué hoteles entran en la búsqueda —tu universo competitivo—. No cambian el precio: cada ejecución del feed se cobra por búsqueda de ubicación y por noche, entren los hoteles que entren. El ejemplo de aquí son hoteles de 4 y 5 estrellas en Barcelona, una noche, dos adultos. Add location search, y la fila te devuelve los filtros como chips:

4. Vuelo — la ruta

Pestaña Flights, Add flights. Es la más autocontenida de las cuatro: los aeropuertos se resuelven en local, así que funciona incluso cuando las OTAs no.

Escribe una ciudad y te salen sus aeropuertos con su código IATA. Londres da siete —seis alrededor de Londres y uno en London, Ontario (YXU)—, así que mira el país antes de elegir:

Después el tipo de viaje, las fechas, los pasajeros y dos campos obligatorios que es fácil pasar por alto: LANGUAGE y COUNTRY. Son el punto de venta —el mercado cuyos precios quieres—, no la ruta. Deja uno vacío y el campo se pone en rojo con This field is required y Add flight sigue deshabilitado.

Un Round trip pide un rango de fechas; One way se conforma con una.

Lo mismo por API

Los cuatro tienen su endpoint de account, pero cada uno pide su propio body:

Un GET a esas mismas rutas lista lo que tienes. Las ubicaciones, las búsquedas de ubicación y los vuelos responden { data: [...], pagination }. Los alojamientos responden un objeto con el slug como clave —el slug que piden los endpoints de datos— y solo con tus hoteles activos: los desactivados y los competidores no salen, y un hotel sin slug va con su id como clave.

Tres cosas que los asistentes hacen por ti y que aquí haces tú:

• Los perfiles de OTA. Crear un hotel con su URL de Booking solo resuelve Booking. La búsqueda de sus otros perfiles es POST /v3/account/accommodation/{accommodation_id}/otas, y se cobra por lo que encuentra: la parte proporcional a las OTAs que rellena, como mucho lo que cuesta una petición Real Time, y nada si no encuentra ninguna. force_otas (por ejemplo ["expedia"]) vuelve a buscar las que ya tienen id.
• El id del destino. booking_dest_id es el booking_id que devuelve GET /v3/real-time/booking/search/{type}/{name}, y esa búsqueda es una petición Real Time. Una ubicación acepta city, region, country o district; una búsqueda de ubicación acepta además landmark y airport. Cualquier otro tipo responde con el error 732. El name no se compara con el de Booking: se busca en Booking, y el id del destino tiene que salir entre los resultados. Si mandas el nombre que devolvió la búsqueda, sale; con un nombre tuyo puede no salir y fallar con el error 731.
• El punto de venta. language y country son opcionales aquí. Un vuelo creado sin ellos se guarda como es / ES —tarifas de España— sin avisar. Mándalos.

Qué pasa después

Las entidades por sí solas no traen nada. A partir de aquí el camino se bifurca: un endpoint Real Time te responde sobre ellas al momento, petición a petición; un dataset Feed necesita que antes haya corrido un import, que se programa como schedule en la página de esa API. Cada fila tiene además activar, desactivar y borrar, y los checkboxes te dan esas tres acciones en masa — una entidad desactivada deja de importarse, y lo que escribieron los imports anteriores sigue legible hasta que caduca (las tarifas, la paridad, la reputación, las búsquedas de ubicación y los vuelos se guardan 15 días; las reseñas, los eventos y la demanda de mercado no se borran).