Feed de itinerarios

El feed de itinerario contiene información sobre los viajes en crucero. Cada itinerario tiene un conjunto de viajes. Cada viaje contiene detalles como puertos, horas y fechas de llegada y salida, duración de la navegación de cada fase del viaje y descripción de cada viaje. Puedes subir feeds de itinerarios en formato CSV.

Componentes clave

El feed de itinerarios tiene campos obligatorios que no distinguen entre mayúsculas y 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.

• stop_index : Es un identificador de parada único para cada puerto de salida.

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

• port_of_call: Es el puerto de escala o la ubicación en la que se detiene el crucero.

• itinerary_desc: Descripción del itinerario.

• arrival_dt: Fecha y hora de llegada al puerto en horario universal coordinado(UTC).

• departure_dt: Fecha y hora de partida en el horario universal coordinado (UTC) del puerto.

• ship_name: Es el nombre del barco.

• sail_duration: Es la duración o la cantidad de días de navegación.

Campos

En la siguiente tabla, se describen todos los campos disponibles en el feed de itinerarios:

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 stop_index se concatenan para formar una clave principal compuesta y deben ser únicos.
stop_index	Required	integer	Es el identificador de índice único para cada parada del itinerario del crucero. Comienza con el índice cero para la primera parada. El cero representa el primer puerto de salida. Por ejemplo, el stop_index se representa como 0. Nota: sail_id y stop_index se concatenan para formar una clave principal compuesta y deben ser únicos.
port_of_call	Required	string	Ubicación con el nombre de la ciudad y el país donde se detiene el crucero. Por ejemplo, el port_of_call se puede representar como Venice,Italy. No se requieren comillas (") de forma explícita.
itinerary_desc	Required	string	Descripción del itinerario. Comienza con "X-noche", donde X es la cantidad de noches del itinerario. No distingue mayúsculas de minúsculas. Por ejemplo, itinerary_desc puede ser 7-night greek isles & eastern med.
arrival_dt	Required	datetime	Fecha y hora de llegada al puerto en hora universal coordinada(UTC). El arrival_dt del primer puerto debe estar vacío y el stop_index debe ser cero. Por ejemplo, el arrival_dt se representa como 2025-01-22T06:00:00+01:00.
departure_dt	Required	datetime	Fecha y hora de partida en la hora universal coordinada(UTC) del puerto. El departure_dt del último puerto debe estar vacío. El stop_index debe ser la última noche del itinerario. Por ejemplo, el departure_dt se representa como 2025-01-23T18:00:00+01:00.
ship_name	Required	string	Es el nombre del barco. No distingue mayúsculas de minúsculas. Por ejemplo, el ship_name se puede representar como NORWEGIAN Escape.
sail_duration	Required	integer	Duración del viaje o cantidad de noches de navegación Por ejemplo, para 5 noches de navegación, el sail_duration se representa como 5.
itinerary_id	Required	string	Identifica el itinerario. El itinerary_id distingue los itinerarios entre sí. Todos los viajes que visitan los mismos puertos de escala comparten el mismo itinerary_id, lo que permite agrupar y organizar los viajes. Por ejemplo, si el puerto de escala es San Francisco para dos itinerarios diferentes, el ID del itinerario será el mismo para ambos. Se representa como XYZ12345.
latitude	Optional	decimal	Latitud de este puerto de escala. Se debe especificar en notación WGS84. Esta información es útil para ubicar con precisión la entidad del puerto de escala. Por ejemplo, las coordenadas de latitud de Trieste, Italia, son 45.64665541364354. No se admiten los siguientes elementos: Tokio GCJ-02
longitude	Optional	decimal	Es la longitud de este puerto de escala. Se debe especificar en la notación WGS84. Esta información es útil para ubicar con precisión la entidad del puerto de escala. Por ejemplo, las coordenadas de longitud de Trieste, Italia, son 13.76188003458354. No se admiten los siguientes elementos: Tokio GCJ-02
image_url	Optional	URL	Es la URL de una imagen que representa el puerto de escala. Por ejemplo: https://partner.com/images/XXXXX.jpg.
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 itinerario 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 stop_index 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

Viaje de ida (obligatorio)

El primer viaje o itinerario es de ida desde San Francisco a Canadá y dura 4 noches. En el siguiente ejemplo, solo se ilustran los campos obligatorios:

sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt;ship_name;sail_duration;itinerary_id
54321; 0; Seattle, Washington; 4 Night Alaska Cruise Trip; NULL;2025-05-23 15:00:00; Floating Home; 04; 888888
54321; 1; Ketchikan, Alaska; 4 Night Alaska Cruise Trip;2025-05-25 18:00:00; 2025-05-25 7:00:00; Floating Home; 04; 888888
54321; 2; Vancouver (Canada Place), British Columbia;4 Night Alaska Cruise Trip; 2025-05-27 7:30:00; NULL; Floating Home; 04; 888888

Viaje de ida (todos)

En el siguiente ejemplo, se ilustran todos los campos disponibles para un viaje de ida:

sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name;sail_duration; itinerary_id; latitude; longitude; image_url; updated_at
54321; 0; Seattle, Washington; 4 Night Alaska Cruise Trip; NULL; 2025-05-23 15:00:00; Floating Home;04; 888888; 47.608013; -122.335167; https://partner.com/images/XXXXX.jpg; 2025-05-23T00:00:00+00:00
54321; 1; Ketchikan, Alaska; 4 Night Alaska Cruise Trip; 2025-05-25 18:00:00; 2025-05-25 7:00:00;Floating Home; 04; 888888; 55.341808; -131.647507; https://partner.com/images/XXXXX.jpg; 2025-05-25T00:00:00+00:00
54321; 2; Vancouver (Canada Place), British Columbia; 4 Night Alaska Cruise Trip; 2025-05-27 7:30:00; NULL; Floating Home; 04; 888888; 49.246292; -123.116226; https://partner.com/images/XXXXX.jpg; 2025-05-27T00:00:00+00:00

Ida y vuelta (obligatorio)

El segundo viaje es de ida y vuelta desde San Francisco y abarca Alaska y Canadá durante 14 noches. En el siguiente ejemplo, solo se ilustran los campos obligatorios:

sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name;sail_duration; itinerary_id
12345; 0; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park; NULL;2025-06-06 16:00:00; Beautiful Ship; 14; 888888
12345; 1; Ketchikan, Alaska; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-09 21:00:00; 2025-06-10 5:00:00; Beautiful Ship; 14; 888888
12345; 2; Vancouver (Canada Place), British Columbia; 14 Night Alaska Cruise with Glacier Bay   National Park; 2025-06-13 14:00:00; 2025-06-14 20:00:00; Beautiful Ship; 14; 888888
12345; 3; Victoria, British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park 2025-06-15 21:00:00; 2025-06-16 6:00:00; Beautiful Ship; 14; 888888
12345; 4; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park 2025-06-20 7:00:00; NULL; Beautiful Ship; 14; 888888

Ida y vuelta (todos)

En el siguiente ejemplo, se ilustran todos los campos disponibles para el viaje de ida y vuelta:

sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name; sail_duration; itinerary_id; latitude; longitude; image_url; updated_at
12345; 0; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park; NULL; 2025-06-06 16:00:00; Beautiful Ship; 14; 888888; 37.773972; -122.431297; https://partner.com/images/XXXXX.jpg; 2025-06-06T00:00:00+00:00
12345; 1; Ketchikan, Alaska; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-09 21:00:00; 2025-06-10 5:00:00; Beautiful Ship; 14; 888888; 55.341808; -131.647507; https://partner.com/images/XXXXX.jpg;  2025-06-09T00:00:00+00:00
12345; 2; Vancouver (Canada Place), British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-13 14:00:00; 2025-06-14 20:00:00; Beautiful Ship; 14; 888888; 49.246292; -123.116226; https://partner.com/images/XXXXX.jpg; 2025-06-13T00:00:00+00:00
12345; 3; Victoria, British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-15 21:00:00; 2025-06-16 6:00:00; Beautiful Ship; 14; 888888; 48.407326; -123.329773; https://partner.com/images/XXXXX.jpg; 2025-06-15T00:00:00+00:00
12345; 4; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park;2025-06-20 7:00:00; NULL; Beautiful Ship; 14; 888888; 37.773972; -122.431297; https://partner.com/images/XXXXX.jpg; 2025-06-20T00:00:00+00:00

JSON (solo para fines informativos)

Viaje de ida (obligatorio)

El primer viaje o itinerario es de ida desde San Francisco a Canadá y dura 4 noches. En el siguiente ejemplo, solo se ilustran los campos obligatorios:

[
  {
    "sail_id": "54321",
    "stop_index": "0",
    "port_of_call": "Seattle, Washington",
    "itinerary_desc": "4 Night Alaska Cruise Trip",
    "arrival_dt": null,
    "departure_dt": "2025-05-23 15:00:00",
    "ship_name": "Floating Home",
    "sail_duration": 4,
    "itinerary_id": "888888"
  },
  ---
  {
    "sail_id": "54321",
    "stop_index": "2",
    "port_of_call": "Vancouver (Canada Place), British Columbia",
    "itinerary_desc": "4 Night Alaska Cruise Trip",
    "arrival_dt": "2025-05-27 7:30:00",
    "departure_dt": null,
    "ship_name": "Floating Home",
    "sail_duration": 4,
    "itinerary_id": "888888"
  }
]

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

Viaje de ida (todos)

En el siguiente ejemplo, se ilustran todos los campos disponibles para un viaje de ida:

[
  {
    "sail_id": "54321",
    "stop_index": "0",
    "port_of_call": "Seattle, Washington",
    "itinerary_desc": "4 Night Alaska Cruise Trip",
    "arrival_dt": "2025-05-23 15:00:00",
    "departure_dt": null,
    "ship_name": "Floating Home",
    "sail_duration": 4,
    "itinerary_id": "888888",
    "latitude": "47.608013",
    "longitude": "-122.335167",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-05-23T00:00:00+00:00"
  },
  ---
  {
    "sail_id": "54321",
    "stop_index": "2",
    "port_of_call": "Vancouver (Canada Place), British Columbia",
    "itinerary_desc": "4 Night Alaska Cruise Trip",
    "arrival_dt": null,
    "departure_dt": "2025-05-27 7:30:00",
    "ship_name": "Floating Home",
    "sail_duration": 4,
    "itinerary_id": "888888",
    "latitude": "49.246292",
    "longitude": "-123.116226",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-05-27T00:00:00+00:00"
  }
]

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

Ida y vuelta (obligatorio)

El segundo viaje es de ida y vuelta desde San Francisco y abarca Alaska y Canadá durante 14 noches. En el siguiente ejemplo, solo se ilustran los campos obligatorios:

[
  {
    "sail_id": "12345",
    "stop_index": "0",
    "port_of_call": "San Francisco, California",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": null,
    "departure_dt": "2025-06-06 16:00:00",
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888"
  },
  {
    "sail_id": "12345",
    "stop_index": "1",
    "port_of_call": "Ketchikan, Alaska",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": "2025-06-09 21:00:00",
    "departure_dt": "2025-06-10 5:00:00",
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888"
  },
  ---
  {
    "sail_id": "12345",
    "stop_index": "4",
    "port_of_call": "San Francisco, California",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": "2025-06-20 7:00:00",
    "departure_dt": null,
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888"
  }
]

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

Ida y vuelta (todos)

En el siguiente ejemplo, se ilustran todos los campos disponibles para el viaje de ida y vuelta:

[
  {
    "sail_id": "12345",
    "stop_index": "0",
    "port_of_call": "San Francisco, California",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": null,
    "departure_dt": "2025-06-06 16:00:00",
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888",
    "latitude": "37.773972",
    "longitude": "-122.335167",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-06-06T00:00:00+00:00"
  },
  {
    "sail_id": "12345",
    "stop_index": "1",
    "port_of_call": "Ketchikan, Alaska",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": "2025-06-09 21:00:00",
    "departure_dt": "2025-06-10 5:00:00",
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888",
    "latitude": "55.341808",
    "longitude": "-131.647507",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-06-09T00:00:00+00:00"
  },
  ---
  {
    "sail_id": "12345",
    "stop_index": "4",
    "port_of_call": "San Francisco, California",
    "itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
    "arrival_dt": "2025-06-20 7:00:00",
    "departure_dt": null,
    "ship_name": "Beautiful Ship",
    "sail_duration": 14,
    "itinerary_id": "888888",
    "latitude": "37.773972",
    "longitude": "-122.431297",
    "image_url": "https://partner.com/images/XXXXX.jpg",
    "updated_at": "2025-06-20T00:00:00+00:00"
  }
]

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