Feed de precios

El feed de precios contiene información de precios para todos los itinerarios de cruceros. Incluye el precio más económico de la cabina para un crucero para cada tipo de moneda. Puedes subir feeds de precios en formato CSV.

Las siguientes monedas están disponibles en Google:

  • USD
  • CAD
  • AUD
  • GBP

USD es la única moneda disponible para la integración con Google. Puedes proporcionar otras monedas admitidas, pero solo se mostrará la moneda USD. En el futuro, se admitirán monedas adicionales de la lista. Consulta la lista de otras monedas admitidas y el código de moneda de tres letras correspondiente.

Componentes clave

El feed de precios tiene campos obligatorios que no distinguen mayúsculas de minúsculas. Algunos campos son opcionales y se pueden dejar en blanco. Enviar datos opcionales mejora la calidad de los datos.

Tiene los siguientes campos obligatorios:

  • sail_id: Es un identificador de navegación único para un viaje específico.
  • currency_code: Es un código de moneda de tres letras único para la moneda específica.

  • cruise_line: Es el nombre de la línea de cruceros.

  • starting_price: Es el precio total del itinerario del crucero, incluidos los impuestos.

  • sail_url: Es la URL de la página de destino que muestra la información de precios.

Campos

Nombre del campo ¿Obligatorio? Tipo Descripción
sail_id Required string Es el identificador único de la navegación para un viaje en particular del itinerario con fecha de inicio y de finalización. Por ejemplo, para un itinerario de 5 noches que tiene 3 paradas, el sail_id es único y permanece igual para las 3 paradas. Un ejemplo de sail_id es ABC12345.

Nota: sail_id y currency_code se concatenan para formar una clave primaria compuesta y deben ser únicas.

currency_code Required currency Es el código de moneda de tres letras del precio. Por ejemplo, currency_code puede ser USD.

Nota: sail_id y currency_code se concatenan para formar una clave primaria compuesta y deben ser únicas.

cruise_line Required string Es el nombre de la línea de cruceros. cruise_line es obligatorio para los agregadores que venden en nombre de otras empresas. Por ejemplo, Norwegian Cruise Line.
starting_price Required decimal Es el precio total del itinerario del crucero, incluidos los impuestos. El precio total, incluidos los impuestos y la tarifa del crucero. Debe ser el mismo valor que se muestra en el sitio web del socio cuando se abre la URL de la oferta. Por ejemplo, 1000.00.
sail_url Required URL Es la URL de la página de destino que muestra la información del precio. Por ejemplo, https://partner.com/path.html&id=XYZ12345
offer_desc Optional string Es una descripción de la oferta asociada al precio o al nombre de la cabina. Por ejemplo, Inside Cabin.
image_url Optional URL Es la URL de una imagen que representa el itinerario. La imagen debe estar relacionada con los interiores del crucero, como una imagen de la cabina, la cubierta del barco y otras instalaciones que se proporcionan en el barco. No es necesario que la imagen sea de la cabina exacta que aparece en la ficha. Puedes usar otra imagen de la cabina. Un ejemplo de image_url es https://partner.com/images/XXXXX.jpg.
brand_name Optional string Clave secundaria para permitir varios sail_url para el mismo sail_id y currency_code. Por ejemplo, Fancy Crusies.
updated_at Optional datetime Es la fecha y hora de la última actualización de esta entrada en la hora universal coordinada(UTC). Esta información es útil para identificar datos inactivos. Debe seguir el formato ISO 8601. Por ejemplo, updated_at es 2025-01-22T00:00:00+00:00.

Ejemplos

El siguiente es un ejemplo básico de un feed de precios para dos viajes en los que uno es de ida y el otro es de ida y vuelta.

En los ejemplos, se muestran los formatos CSV y JSON. Los campos sail_id y currency_code se concatenan para formar la clave primaria compuesta y deben ser únicos para cada fila.

CSV

Campos obligatorios

El siguiente es un ejemplo de los campos obligatorios en el feed de precios:

sail_id; currency_code; cruise_line; starting_price; sail_url
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345

Todos los campos disponibles

El siguiente ejemplo es de todos los campos disponibles en el feed de precios:

sail_id; currency_code; cruise_line; starting_price; sail_url; offer_desc; image_url; brand_name; updated_at
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Fancy Cruises; 2025-06-20T00:00:00+00:00
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00

JSON (solo con fines informativos)

Campos obligatorios

El siguiente es un ejemplo de los campos obligatorios en el feed de precios:

[
  {
    "sail_id": "12345",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 2198,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  },
  {
    "sail_id": "54321",
    "currency_code": "GBP",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 449,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  },
  {
    "sail_id": "54321",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 430,
    "sail_url": "https://partner.com/path.html&id=XYZ12345"
  }
]

Todos los campos disponibles

El siguiente ejemplo es de todos los campos disponibles en el feed de precios:

[
  {
    "sail_id": "12345",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 2198,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Fancy Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  },
  {
    "sail_id": "54321",
    "currency_code": "GBP",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 449,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Caribbean Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  },
  {
    "sail_id": "54321",
    "currency_code": "USD",
    "cruise_line": "Happy Cruises Company",
    "starting_price": 430,
    "sail_url": "https://partner.com/path.html&id=XYZ12345",
    "offer_desc": "Inside Cabin",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "brand_name": "Caribbean Crusies",
    "updated_at": "2025-06-20T00:00:00+00:00"
  }
]