Feed de precios

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

Las siguientes monedas están disponibles con Google:

• USD
• CAD
• AUD
• GBP

El USD es la única moneda disponible para la integración con Google. Puedes proporcionar otras monedas admitidas, pero solo se mostrará la moneda en USD. En el futuro, se admitirán más monedas de la lista. Consulta la lista de otras monedas admitidas y sus códigos correspondientes de tres letras.

Componentes clave

El feed de precios tiene campos obligatorios que no distinguen mayúsculas de minúsculas. Algunos campos son opcionales y pueden dejarse en blanco. El envío de 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.

  Punto clave: sail_id y currency_code se concatenan para formar una clave principal compuesta y deben ser únicos.

• 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 del precio.

Campos

Nombre del campo	¿Obligatorio?	Tipo	Descripción
sail_id	Required	string	Es el identificador de navegación único para un viaje específico en el itinerario con fecha de inicio y finalización. Por ejemplo, para un itinerario de 5 noches con 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 principal compuesta y deben ser únicos.
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 principal compuesta y deben ser únicos.
cruise_line	Required	string	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 el interior 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 se muestra en la lista. Puedes usar una imagen de cabina diferente. Un ejemplo de image_url es https://partner.com/images/XXXXX.jpg
brand_name	Optional	string	Es la clave secundaria que permite varios sail_url para el mismo sail_id y currency_code. Por ejemplo, Fancy Crusies.
updated_at	Optional	datetime	Fecha y hora en la que se actualizó por última vez esta entrada en la hora universal coordinada(UTC). Esta información es útil para identificar datos inactivos. Debe seguir el formato de la norma ISO 8601. Por ejemplo, el updated_at es 2025-01-22T00:00:00+00:00.

Ejemplos

A continuación, se muestra un ejemplo básico de un feed de precios para dos viajes en barco, en el 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 principal compuesta y deben ser únicos para cada fila.

Punto clave: No uses el formato JSON, ya que solo tiene fines informativos. Todos los feeds deben estar en formato CSV.

CSV

Campos obligatorios

A continuación, se muestra 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 muestra 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 para fines informativos)

Campos obligatorios

A continuación, se muestra 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"
  }
]

Nota: Todos los feeds deben estar en formato CSV. No uses el formato JSON.

Todos los campos disponibles

El siguiente ejemplo muestra 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"
  }
]

Nota: Todos los feeds deben estar en formato CSV. No uses el formato JSON.