Feed de itinerário

O feed de itinerário contém informações sobre a navegação de cruzeiros. Cada itinerário tem um conjunto de viagens. Cada viagem contém detalhes, como portos, datas e horários de chegada e partida, duração da viagem de cada fase da jornada e descrição de cada viagem. Você pode fazer upload de feeds de itinerário no formato CSV.

Principais componentes

O feed de itinerários tem campos obrigatórios que não diferenciam maiúsculas de minúsculas. Alguns campos são opcionais e podem ser deixados em branco. O envio de dados opcionais melhora a qualidade dos dados.

Ele tem os seguintes campos obrigatórios:

• sail_id : um identificador de navegação exclusivo para uma viagem específica.

• stop_index : um identificador de parada exclusivo para cada porto de partida.

  Importante: sail_id e stop_index são concatenados para formar uma chave primária composta e precisam ser exclusivos.

• port_of_call: o porto de escala ou o local onde o cruzeiro faz paradas.

• itinerary_desc: descrição do itinerário.

• arrival_dt: data e hora de chegada no horário universal coordenado(UTC) do porto.

• departure_dt: data e hora de partida no fuso horário Universal Coordenado (UTC) do porto.

• ship_name: o nome do navio.

• sail_duration: a duração ou o número de dias de navegação.

Campos

A tabela a seguir descreve todos os campos disponíveis no feed de itinerários:

Nome do campo	Obrigatório?	Tipo	Descrição
sail_id	Required	string	Identificador de navegação exclusivo para uma viagem específica no itinerário com datas de início e término. Por exemplo, em um itinerário de cinco noites com três paradas, o sail_id é único e permanece o mesmo para as três paradas. Um exemplo de sail_id é ABC12345. Observação:sail_id e stop_index são concatenados para formar uma chave primária composta e precisam ser exclusivos.
stop_index	Required	integer	Identificador de índice exclusivo para cada parada no itinerário do cruzeiro. Ele começa com o índice zero para a primeira parada. Zero representa a primeira porta de saída. Por exemplo, o stop_index é representado como 0. Observação:sail_id e stop_index são concatenados para formar uma chave primária composta e precisam ser exclusivos.
port_of_call	Required	string	Local com o nome da cidade e do país onde o cruzeiro faz paradas. Por exemplo, o port_of_call pode ser representado como Venice,Italy. Aspas (") não são necessárias.
itinerary_desc	Required	string	Descrição do itinerário. Ele começa com "X-night", em que X é o número de noites no itinerário. Ele não diferencia maiúsculas de minúsculas. Por exemplo, o itinerary_desc pode ser 7-night greek isles & eastern med.
arrival_dt	Required	datetime	Data e hora de chegada no horário universal coordenado(UTC) do porto. O arrival_dt da primeira porta precisa estar vazio, e o stop_index precisa ser zero. Por exemplo, o arrival_dt é representado como 2025-01-22T06:00:00+01:00.
departure_dt	Required	datetime	Data e hora de partida no fuso horário universal coordenado(UTC) do porto. O departure_dt da última porta precisa estar vazio. O stop_index precisa ser a última noite do itinerário. Por exemplo, departure_dt é representado como 2025-01-23T18:00:00+01:00.
ship_name	Required	string	O nome do navio. Ele não diferencia maiúsculas de minúsculas. Por exemplo, o ship_name pode ser representado como NORWEGIAN Escape.
sail_duration	Required	integer	A duração da viagem ou o número de noites de navegação. Por exemplo, para 5 noites de navegação, o sail_duration é representado como 5.
itinerary_id	Required	string	Identifica o itinerário. O itinerary_id distingue os itinerários uns dos outros. Todas as viagens que visitam os mesmos portos de escala compartilham o mesmo itinerary_id, permitindo o agrupamento e a organização das viagens. Por exemplo, se o porto de escala for em São Francisco para dois itinerários diferentes, o ID do itinerário será o mesmo para os dois itinerários. Ele é representado como XYZ12345.
latitude	Optional	decimal	A latitude desse porto de escala. Ele precisa ser especificado na notação WGS84. Essas informações são úteis para localizar com precisão a entidade de porta de chamada. Por exemplo, as coordenadas de latitude de Trieste, Itália, são 45.64665541364354. Não há suporte para o seguinte: TÓQUIO GCJ-02
longitude	Optional	decimal	A longitude desse porto de escala. Ele precisa ser especificado na notação WGS84. Essas informações são úteis para localizar com precisão a entidade de porta de chamada. Por exemplo, as coordenadas de longitude de Trieste, Itália, são 13.76188003458354. Não há suporte para o seguinte: TÓQUIO GCJ-02
image_url	Optional	URL	O URL de uma imagem que representa o porto de escala. Por exemplo, https://partner.com/images/XXXXX.jpg
updated_at	Optional	datetime	A data e a hora em que essa entrada foi atualizada pela última vez no Horário Universal Coordenado(UTC). Essas informações são úteis para identificar dados desatualizados. Ela precisa seguir o formato ISO 8601. Por exemplo, updated_at é 2025-01-22T00:00:00+00:00.

Exemplos

Confira a seguir um exemplo básico de um feed de itinerário para duas viagens, em que uma é de ida e a outra é de ida e volta.

Os exemplos mostram os formatos CSV e JSON. Os campos sail_id e stop_index são concatenados para formar a chave primária composta e precisam ser exclusivos para cada linha.

Importante: não use o formato JSON, que é apenas para fins informativos. Todos os feeds precisam estar no formato CSV.

CSV

Viagem só de ida (obrigatório)

A primeira viagem ou itinerário é de ida de São Francisco para o Canadá, com duração de 4 noites. O exemplo a seguir ilustra apenas os campos obrigatórios:

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

Viagem só de ida (todas)

O exemplo a seguir ilustra todos os campos disponíveis para uma viagem 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 e volta (obrigatório)

A segunda viagem é uma ida e volta de São Francisco, cobrindo o Alasca e o Canadá por 14 noites. O exemplo a seguir ilustra apenas os campos obrigatórios:

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 e volta (todas)

O exemplo a seguir ilustra todos os campos disponíveis para ida e volta:

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 (para fins informativos)

Viagem só de ida (obrigatório)

A primeira viagem ou itinerário é de ida de São Francisco para o Canadá, com duração de 4 noites. O exemplo a seguir ilustra apenas os campos obrigatórios:

[
  {
    "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"
  }
]

Observação: todos os feeds precisam estar no formato CSV. Não use o formato JSON.

Viagem só de ida (todas)

O exemplo a seguir ilustra todos os campos disponíveis para uma viagem 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"
  }
]

Observação: todos os feeds precisam estar no formato CSV. Não use o formato JSON.

Ida e volta (obrigatório)

A segunda viagem é uma rota de ida e volta de São Francisco, cobrindo o Alasca e o Canadá por 14 noites. O exemplo a seguir ilustra apenas os campos obrigatórios:

[
  {
    "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"
  }
]

Observação: todos os feeds precisam estar no formato CSV. Não use o formato JSON.

Ida e volta (todas)

O exemplo a seguir ilustra todos os campos disponíveis para ida e volta:

[
  {
    "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"
  }
]

Observação: todos os feeds precisam estar no formato CSV. Não use o formato JSON.