Demo en vivo

API de reservas de cruceros

API de cruceros para agencias: salidas, camarotes y calendarios de pago

Una API de cruceros permite a tu web mostrar salidas en vivo, calcular el precio de las categorías de camarote y crear reservas de crucero con la naviera. Esta página explica cómo son los datos, cómo funcionan los camarotes y los pagos, y las dos formas de poner inventario de cruceros en tu propia web con PHPTRAVELS.

  • Salidas e itinerarios
  • Categorías de camarote y planos de cubierta
  • Depósito y pago final
  • Integraciones de cruceros a medida

Qué devuelve una API de cruceros

Una salida, descrita en datos

Un crucero se vende como una salida: un barco, un itinerario, una fecha de partida. Toda API de cruceros, sea cual sea su formato, se construye alrededor de esa unidad.

Una búsqueda envía una región, un mes o rango de fechas, la duración y el número de pasajeros. La respuesta es una lista de salidas, cada una con el barco, la naviera, las fechas de embarque y regreso, los puertos de escala con sus horarios, los días de navegación y un precio desde por persona para cada categoría de camarote aún disponible.

Después, otras llamadas calculan el precio de la categoría elegida para los pasajeros reales, listan los camarotes que se pueden elegir, crean la reserva y cobran los pagos asociados. Los nombres y formatos varían según la naviera, así que una plataforma convierte cada fuente al mismo modelo de salida, camarote y reserva antes de que lo vea el pasajero.

Naviera

Tu naviera socia

Barco socio · 7 noches

Abierto
Embarque
2027-05-15
Regreso
2027-05-22

Itinerario

  1. D1Southampton--:-- · 17:00
  2. D2En el mar
  3. D3Brujas (Zeebrugge)08:00 · 18:00
  4. D4Ámsterdam09:00 · 19:00
  5. D5En el mar
  6. D6Copenhague07:00 · 17:00
  7. D7Oslo09:00 · 16:00
  8. D8Southampton07:00 · --:--
Precio desdepor persona, dos por camaroteEUR 899

Registro ilustrativo, no el formato de una naviera concreta.

Una plataforma de reservas de cruceros que recibe salidas, categorías de camarote y precios del sistema de una naviera

Categorías de camarote

Cuatro escalones en el barco: interior, exterior, balcón, suite

Bajo cada salida, una API de cruceros lista categorías de camarote. Son el principal factor de precio, y cada una cambia varias cosas a la vez.

  1. 01InteriorSin ventana

    El precio de entrada de la salida. Las navieras suelen dividirla en varias categorías por cubierta y posición, cada una con su propio código.

    Nivel de precio
  2. 02ExteriorVentana u ojo de buey

    Un paso más arriba para tener luz natural. Algunas categorías tienen vista parcialmente obstruida, algo que la API indica en la descripción.

    Nivel de precio
  3. 03BalcónBalcón privado

    Un espacio exterior privado, con categorías que cambian según la altura de la cubierta y la posición en el centro o en la popa.

    Nivel de precio
  4. 04SuiteBalcón y zona de estar

    Lo más alto de la lista de precios, a menudo con extras incluidos en la tarifa, y las categorías que con más probabilidad se venden como camarote concreto.

    Nivel de precio

Códigos de categoría y de tarifa

Cada categoría tiene un código, y cada salida puede venderse con varios códigos de tarifa: tarifas estándar, promocionales y de grupo o agencia. El mismo camarote puede tener precios y condiciones distintos según el código de tarifa.

Garantizado o camarote concreto

En una reserva garantizada, el pasajero compra una categoría y la naviera asigna el camarote más tarde, en esa categoría o superior. En una reserva de camarote concreto, el número queda fijado al reservar. Muchas navieras precian ambas de forma distinta.

Elección de camarote

Elige el camarote en el plano de cubierta

Cuando la naviera permite reservar un camarote concreto, la API devuelve los camarotes aún libres de la categoría elegida, con cubierta, posición y cuántos pasajeros caben en cada uno.

Cubierta 9

Selecciona un camarote

ProaPopa
0814
242636
29
011119
  • Interior
  • Exterior
  • Balcón
  • Suite
  • No disponible

Camarote 9110

Interior

Camarote interior, el precio más bajo de esta cubierta. Se vende como camarote concreto o garantizado.

Exterior

Camarote con ventana en proa, donde el casco se curva. La API devuelve la nota de la vista junto con la categoría.

Balcón

Camarote con balcón en el centro del barco. La posición en la cubierta suele ser una categoría aparte con su propio precio.

Suite

Suite orientada a popa con balcón más grande. Normalmente se reserva como camarote concreto, no garantizado.

  1. 1.Listar los camarotesCuando el pasajero elige categoría, la plataforma pide a la naviera los camarotes libres en ella y los dibuja sobre la cubierta.
  2. 2.Retener el camaroteMuchas API de cruceros permiten retener el camarote elegido unos minutos mientras el pasajero introduce los nombres y paga.
  3. 3.ReservarloLa reserva confirma el número de camarote, los pasajeros y el código de tarifa, y la naviera devuelve su localizador.

En el Cruceros de PHPTRAVELS, los barcos llevan sus cubiertas y categorías de camarote, y los pasajeros eligen con todos los datos delante, tanto si los camarotes son tuyos como si vienen de una naviera conectada.

Calendario de pagos

Depósito ahora, el resto antes de zarpar

Los cruceros se reservan con meses de antelación y se pagan por fases. La naviera fija las fechas e importes de cada salida y tarifa, y la API los devuelve con la reserva.

  1. 01

    Reserva y depósito

    El pasajero paga un depósito fijado por la naviera, por persona o por reserva, para confirmar el camarote.

  2. 02

    Pago final

    El saldo vence en una fecha que la naviera fija antes de la partida. Pasada esa fecha, la naviera puede cancelar las reservas sin pagar.

  3. 03

    Documentos

    Con el pago completo, la naviera libera los documentos del crucero y el pasajero completa los datos de check-in.

  4. 04

    Día de la salida

    El pasajero embarca. Los cambios a partir de ese momento se gestionan a bordo o según las normas de la naviera.

Penalizaciones de cancelación por tramo

Tramo del depósitoLa penalización crecePenalización máxima

Cuanto más cerca de la salida, más parte de la tarifa se retiene al cancelar. Los tramos y porcentajes son propios de cada naviera y tarifa, así que una API de cruceros los envía con la reserva y tu plataforma los muestra al pasajero antes del pago.

Cuando vendes salidas que contratas tú, el Cruceros funciona igual: fijas el depósito y la fecha de vencimiento del saldo por salida, y los saldos pendientes se siguen en el panel hasta que se pagan.

Precios en cruceros

Cómo se construye el precio de un crucero

Los precios de crucero se leen distinto a los de hotel o vuelo. Una API de cruceros devuelve las partes por separado, y tu motor de reservas debe combinarlas igual que la naviera.

Sobre el precio de la naviera, PHPTRAVELS aplica tus márgenes y comisiones por barco, salida o canal, y los agentes del Portal de viajes B2B ven sus propias tarifas netas.

  • Por persona, no por camarote

    Las tarifas de crucero se dan por pasajero. Un camarote para dos cuesta el doble de la tarifa por persona, y la API precia a cada pasajero según su edad y su plaza en el camarote.

  • Basado en ocupación doble

    Los precios desde suponen dos pasajeros compartiendo. El tercero y el cuarto suelen pagar una tarifa menor, y quien viaja solo paga un suplemento individual.

  • Impuestos, tasas y gastos portuarios

    Los impuestos, tasas y gastos portuarios se suman por persona a la tarifa del crucero. Muéstralos en líneas propias para que el total no dé sorpresas.

  • Crédito a bordo y extras

    Algunas tarifas incluyen crédito a bordo, un paquete de bebidas o propinas. La API los devuelve como inclusiones de la tarifa, y son un motivo por el que dos tarifas del mismo camarote difieren.

Cómo conseguir inventario de cruceros

Tus propios contratos o una API de naviera

Hay dos caminos para tener cruceros en tu web. Muchas agencias empiezan por el primero y añaden el segundo cuando el volumen lo justifica.

Listo en el módulo de cruceros

Carga tus propios contratos de cruceros

Introduce en el panel las salidas que contratas: barcos, cubiertas, categorías de camarote, itinerarios puerto a puerto, fechas de salida, tarifas por persona, temporadas, depósitos y fechas de saldo. Se puede dar a los socios navieros un acceso de proveedor para mantener al día sus propias salidas.

  • Espacios de grupo y cupos que mantienes
  • Comisión por naviera
  • Tarifas netas para agentes B2B
  • En vivo desde el día de la instalación
Integración a medida

Conecta la API de una naviera o consolidador

En la lista de integraciones de PHPTRAVELS no hay un conector de cruceros ya hecho. Como todos los planes incluyen el código fuente completo, la API de una naviera o consolidador de cruceros se conecta como Integración de API personalizada, adaptada a las mismas salidas, camarotes y reservas que el módulo ya muestra.

  • Tú firmas con la naviera o el consolidador
  • Tú recibes y conservas las credenciales de la API
  • El conector adapta salidas, categorías y camarotes
  • Reservas, pagos y cancelaciones siguen las normas de la naviera

¿Buscas proveedores? El Lista de proveedores XML API de viajes lista navieras que distribuyen por API, y Qué es la integración de API explica cómo se construye una conexión así.

Mira funcionar el flujo de reserva de cruceros

Abre la demo en vivo para buscar salidas, comparar categorías de camarote y reservar con depósito, y luego compara los planes en Precios.

Preguntas frecuentes

Preguntas sobre la API de cruceros

Habla con ventas

Una API de cruceros es un conjunto de servicios web que una naviera o un consolidador de cruceros abre a los vendedores de viajes. Tu sistema la usa para buscar salidas, leer itinerarios, calcular el precio de las categorías de camarote, listar camarotes disponibles, crear reservas y cobrar el depósito y el pago final.

No. El módulo de cruceros está construido en torno al inventario que gestionas tú: barcos, categorías de camarote y salidas que contratas. La conexión con una naviera o consolidador concreto se desarrolla como integración a medida sobre el código fuente incluido.

Solicitas acceso a la naviera o a un consolidador de cruceros como vendedor de viajes. Las condiciones varían según la naviera y el mercado. Tú firmas el acuerdo y recibes las credenciales; PHPTRAVELS nunca facilita credenciales de proveedores.

Una reserva garantizada asegura una categoría de camarote a un precio fijo, y la naviera asigna el camarote real más tarde, en esa categoría o superior. Una reserva de camarote concreto fija el número al reservar.

La naviera los fija por salida y tarifa, y su API los devuelve con la reserva. En las salidas que cargas tú, fijas el depósito y la fecha de vencimiento del saldo por salida en el panel.

Las tarifas de crucero se dan por pasajero, normalmente con dos pasajeros por camarote. El tercero y el cuarto pagan su propia tarifa, quien viaja solo paga un suplemento individual, y los impuestos, tasas y gastos portuarios se suman por persona.

Sí. Los agentes reservan en el portal B2B con sus propias tarifas netas y comisiones y pagan desde su monedero de agente, desde la misma instalación que tu web pública.

El plan Enterprise incluye la REST API de PHPTRAVELS y webhooks con documentación, y todos los planes incluyen el código fuente completo, así que tus desarrolladores pueden ampliar el motor de reservas de cruceros o conectarlo con otros sistemas.

Empieza con las salidas que ya contratas, cárgalas en el módulo de cruceros y mira cómo se venden. Cuando una alianza con una naviera o el volumen lo justifique, añade la API de esa naviera mediante una integración a medida.