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
D1Southampton--:-- · 17:00
D2En el mar
D3Brujas (Zeebrugge)08:00 · 18:00
D4Ámsterdam09:00 · 19:00
D5En el mar
D6Copenhague07:00 · 17:00
D7Oslo09:00 · 16:00
D8Southampton07:00 · --:--
Registro ilustrativo, no el formato de una naviera concreta.
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.
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
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
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
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
Pasillo
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.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.Retener el camaroteMuchas API de cruceros permiten retener el camarote elegido unos minutos mientras el pasajero introduce los nombres y paga.
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.
01
Reserva y depósito
El pasajero paga un depósito fijado por la naviera, por persona o por reserva, para confirmar el camarote.
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.
03
Documentos
Con el pago completo, la naviera libera los documentos del crucero y el pasajero completa los datos de check-in.
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.
A
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.
B
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.
C
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.
D
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
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.
Usamos cookies de Google para medir qué anuncios atraen visitas y consultas, y para mostrarle anuncios relevantes. Acepte para permitirlas o rechácelas para mantener solo las cookies necesarias para el funcionamiento del sitio. Declaración de privacidad