Demo en vivo

API de alojamiento

Una API de alojamientos para hoteles, apartamentos y alquileres vacacionales

Una API de alojamientos lleva todo tipo de alojamiento a su web de reservas: habitaciones de hotel, apartamentos con servicios, casas vacacionales, hostales y pensiones. Esta página explica los datos de una estancia, las reglas que distinguen los alquileres de los hoteles y cómo PHPTRAVELS vende sus propiedades y el stock de proveedores en una sola búsqueda.

  • Propiedad, unidad, tarifa, calendario
  • Estancia mínima y tasas
  • Plazos de cancelación
  • Stock propio más oferta por API

El modelo de datos

Cuatro capas dentro de cada estancia

Ya sea un hotel de 300 habitaciones o una sola casa de playa, una API de alojamientos lo describe en las mismas cuatro capas anidadas. Cada capa responde a una pregunta distinta que se hace el huésped antes de reservar.

01Propiedad

El lugar en sí: nombre, tipo, dirección y posición en el mapa, fotos, servicios, categoría por estrellas o calidad, normas de la casa y horarios de entrada.

property_id · type · address · geo · photos · amenities · check_in_from

02Habitación o unidad

Lo que realmente se reserva: un tipo de habitación, un apartamento entero o una cama en un dormitorio compartido, con su tamaño, camas y ocupación máxima.

unit_id · beds · size_m2 · max_adults · max_children

03Tarifa

Cómo se vende esa unidad: el régimen de comidas, la política de cancelación, las condiciones de pago y quién puede reservarla, por ejemplo público o solo agentes.

rate_plan_id · board · cancel_policy · payment · channel

04Disponibilidad

Una fila por noche: el precio, las unidades restantes, la estancia mínima y si se permite la llegada o la salida ese día.

date · price · units_left · min_stay · closed_to_arrival

Un edificio, una habitación, una etiqueta de precio y un calendario dibujados como capas apiladas de un mismo alojamiento

PHPTRAVELS llama Stays a su módulo de alojamiento porque el mismo modelo cubre mucho más que hoteles. Una propiedad contiene unidades, una unidad se vende con una o varias tarifas y cada tarifa tiene un calendario noche a noche con precio y disponibilidad. Si estas cuatro capas están bien, una cama de hostal, una suite de hotel y una villa de tres dormitorios caben en la misma búsqueda y el mismo pago.

Los proveedores nombran las capas de forma distinta y algunos fusionan dos, pero la estructura siempre existe. El Hoteles asigna cada fuente a ella, de modo que el huésped ve una página coherente.

Noche a noche

El calendario de disponibilidad decide si se gana o se pierde una estancia

Toda API de alojamientos termina en un calendario. La búsqueda solo devuelve una propiedad cuando cada noche de la estancia pedida está libre, tiene precio y la permiten las reglas de estancia.

Apartamento de dos dormitorios · Tarifa estándarNoviembre 2026 · Precio por noche
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Libre, con precio por noche
  • Ya reservada
  • Cerrada por el propietario
  • Estancia mínima desde esta llegada
  • Cerrada a la llegada

Datos ilustrativos, simplificados

  • Los precios son por nocheEl total de la estancia es la suma de cada noche, así que un viernes y un sábado a tarifa de fin de semana cuestan más que dos días laborables. Los precios por día y por temporada están en el calendario, no en la propiedad.
  • Reglas de estancia mínimaUn mínimo de tres noches con llegada en viernes oculta la unidad en una búsqueda de dos noches. Los alquileres usan estas reglas mucho más que los hoteles, a menudo más estrictas en fin de semana y temporada alta.
  • Cerrada a la llegada o a la salidaUna noche puede reservarse dentro de una estancia más larga pero no como primera o última noche. Así funcionan los días de cambio en las casas vacacionales.
  • Noches cerradas y stop-sellLos propietarios bloquean fechas para uso propio o mantenimiento, y un stop-sell retira una unidad de la venta al instante. Cualquier noche cerrada dentro de las fechas pedidas elimina la unidad de los resultados.

No todo alojamiento es un hotel

Hoteles, apartamentos y alquileres vacacionales

El modelo de datos es común, pero cada tipo de alojamiento lo rellena de forma distinta. Estas son las diferencias que debe resolver su flujo de reserva si vende algo más que habitaciones de hotel.

Hoteles

Incluye hostales y pensiones

Qué se reserva
Un tipo de habitación con muchas habitaciones idénticas, o una cama en un dormitorio compartido.
Precios
Una tarifa por noche según habitación y régimen; adultos o niños adicionales pueden cambiarla.
Reglas de estancia
Estancia mínima solo en fechas punta; la mayoría de las noches se pueden reservar sueltas.
Tasas y fianzas
Tasa turística o municipal, a veces una tasa de resort que se paga en el alojamiento.
Llegada
Recepción 24 horas o con personal; basta con los horarios de entrada en el bono.
Fuente habitual
Bancos de camas y mayoristas, contratos directos, channel managers.

Apartamentos con servicios

Apartahoteles y apartamentos urbanos

Qué se reserva
Un tipo de unidad, a menudo con cocina y dormitorios separados.
Precios
Una tarifa por noche y unidad, con precios semanales o mensuales para estancias largas.
Reglas de estancia
Las estancias mínimas son habituales y las estancias largas son gran parte de la demanda.
Tasas y fianzas
Una tarifa de limpieza por estancia y una fianza reembolsable son habituales.
Llegada
El horario de recepción varía; las llegadas tardías necesitan una caja de llaves o un código.
Fuente habitual
Channel managers, contratos directos y algunos mayoristas.

Alquileres vacacionales

Casas, villas y cabañas

Qué se reserva
Una casa concreta. Normalmente solo hay una.
Precios
Una tarifa por noche para toda la casa, más un cargo por huésped adicional sobre un número base.
Reglas de estancia
Estancias mínimas, días de cambio fijos y fechas cerradas a la llegada son la norma.
Tasas y fianzas
Tarifa de limpieza, fianza reembolsable por daños e impuestos locales, cada uno mostrado antes del pago.
Llegada
Las instrucciones de entrada, la dirección y un contacto se envían antes de la llegada, nunca en la página pública.
Fuente habitual
Propietarios y gestores, directamente o mediante un channel manager.

¿Vende casas de muchos anfitriones en lugar de sus propios contratos? Eso es un marketplace, tratado en la página Portal BnB.

Plazos de la política de cancelación

Una reserva, tres plazos de cancelación

Una política de cancelación es una línea de tiempo contada hacia atrás desde la fecha de llegada. Cada plazo indica lo que recupera el huésped si cancela dentro de él.

ReservaCheck-in
  1. 01 · Hasta 14 días antes de la llegadaCancelación gratuitaEl huésped cancela y se le reembolsa todo. Es la fecha límite que los viajeros buscan primero, así que muéstrela como fecha, no como regla.
  2. 02 · De 14 a 3 días antesPenalización parcialSe aplica una penalización, a menudo la primera noche o un porcentaje de la estancia. Los alquileres pueden retener la fianza en este plazo.
  3. 03 · Últimos 3 días y no presentaciónNo reembolsableSe retiene el importe completo. Las tarifas vendidas como no reembolsables empiezan en este plazo desde el momento de la reserva.
Plazos de ejemplo; cada tarifa tiene los suyos.
  • Por tarifa, no por propiedadEl mismo apartamento puede tener una tarifa flexible y otra más barata no reembolsable, así que la política pertenece a la capa de tarifa.
  • Fechas en la zona horaria de la propiedad"14 días antes" se cuenta desde la fecha de llegada en el lugar de la propiedad. Conviértalo en una fecha y hora claras en la página y en el bono.
  • Prevalece la política del proveedorCon stock de API no puede ofrecer condiciones más flexibles que las de su proveedor. Con contratos propios, usted fija los plazos.

Stock propio y stock por API

Sus propiedades contratadas y las APIs de proveedores en una sola búsqueda

La mayoría de los vendedores de alojamiento hacen ambas cosas: cargan los lugares que contratan ellos mismos y añaden APIs de proveedores para el resto. El viajero nunca debería notar de dónde viene una estancia.

Sus propias propiedades

  • Cargue usted mismo propiedades, unidades y tarifas en el panel de administración
  • Dé a propietarios y hoteles un acceso de extranet para gestionar su calendario
  • Fije precios, estancias mínimas, fechas cerradas y plazos de cancelación
  • Allotments con días de liberación y stop-sell
  • O reciba tarifas y disponibilidad de un channel manager

Stock de APIs de proveedores

  • Grandes catálogos en destinos que nunca podría contratar
  • Precios y disponibilidad en vivo en el momento de la búsqueda
  • Regímenes, políticas y tasas del proveedor en cada tarifa
  • Se activa con su propio contrato y credenciales de proveedor
  • Reserva y cancelación enviadas directamente al proveedor

Lo que obtiene el huésped

  • Una lista de resultados con una página de propiedad por lugar
  • La misma habitación de varias fuentes mostrada una vez, a su precio
  • Sus márgenes por proveedor, destino o canal, y tarifas B2B para agentes
  • Un solo formato de bono, sea cual sea la fuente que lo confirmó

La conexión de un channel manager se explica en Integración con channel managers. Para las habitaciones que tiene bajo contrato, vea Sistema de inventario de reservas.

Listo en PHPTRAVELS

Proveedores de Stays ya conectados

Estos proveedores de alojamiento están conectados hoy al módulo Stays. Usted firma con el proveedor, introduce sus propias credenciales en el panel, prueba en su sandbox y sale en vivo. La lista procede en directo de nuestro directorio de integraciones.

¿Necesita un proveedor que no figura, como una red regional de alquileres? Se puede añadir cualquier API de alojamiento con documentación, vea Integración de API personalizada. Para los tipos de proveedor de hoteles y el mapeo de contenido, lea la página API de hoteles, y las dos guías de bancos de camas más grandes: Integración de la API de RateHawk y Integración de la API de Hotelbeds.

Reserve una estancia como lo harán sus huéspedes

Busque, compare tarifas y reserve en la demo en vivo, y luego díganos qué propiedades y proveedores piensa vender.

Probar la demo en vivoConsultar por sus proveedores

¿Crea su propia app o un feed para socios? La REST API de PHPTRAVELS sirve todas las fuentes de Stays conectadas en un solo formato, con webhooks para eventos de reserva. Viene con el plan Enterprise, vea Precios y la documentación para desarrolladores. El panorama completo está en APIs de viajes.

Preguntas frecuentes

API de alojamientos: preguntas de desarrolladores y agencias

Habla con ventas

Una API de alojamientos es un conjunto de servicios web que permite a un sitio de reservas buscar alojamiento, leer precios y disponibilidad para unas fechas y huéspedes, y crear, consultar y cancelar reservas. Cubre hoteles y cualquier otro tipo de alojamiento: apartamentos, alquileres vacacionales, hostales y pensiones.

Las llamadas principales son las mismas. Una API de alojamientos también debe resolver lo que necesitan los alojamientos que no son hoteles: reservas de unidades completas, estancias mínimas y días de cambio, cargos por huésped adicional, tarifas de limpieza, fianzas reembolsables e instrucciones de entrada enviadas antes de la llegada.

Sí. En PHPTRAVELS el módulo Stays usa un único modelo de propiedad, unidad, tarifa y disponibilidad para cualquier tipo de alojamiento, de modo que hoteles, apartamentos y casas vacacionales aparecen en la misma búsqueda con sus propias reglas.

Cada noche del calendario puede llevar una duración mínima de estancia, normalmente ligada a la fecha de llegada. Si un huésped busca menos noches que el mínimo, la unidad no se devuelve. Los indicadores de cerrado a la llegada y a la salida funcionan igual para los días de cambio.

Sí. Puede añadir usted mismo propiedades, unidades, tarifas y calendarios, dar a los propietarios un acceso de extranet o recibir tarifas de un channel manager, y venderlos junto al stock de proveedores en una sola lista de resultados.

De la tarifa. El stock de proveedores lleva la política del proveedor y sus propias propiedades usan los plazos que usted fije. La fecha límite se muestra al huésped antes del pago y se imprime en el bono.

No. Usted firma con cada proveedor de alojamiento e introduce sus propias credenciales en el panel. PHPTRAVELS ofrece la plataforma de reservas, el módulo Stays y los conectores ya preparados.

Sí. En el plan Enterprise, la REST API de PHPTRAVELS expone búsqueda y reserva de todas las fuentes conectadas en un solo formato, con webhooks para eventos de reserva y el código fuente completo para ampliarla.

Una licencia de PHPTRAVELS, su propio dominio y al menos una fuente de stock: propiedades que contrate usted mismo, un channel manager o un contrato de proveedor con un mayorista de alojamiento. La demo en vivo muestra primero todo el flujo.

Sigue explorando

Más sobre la plataforma