FAQ
Registration and technology
Q: What technology is used in the file distribution? A: The Partners retrieve the files via a REST endpoint as a zip file which contains each file as a JSON file. See https://developer.hurtigruten.com/hrg/Partners/RatesAndAvailability for more information. The JSON files with the availability and prices can be easily converted to CSV (many tools for this) if required, but the content files contain html, so these are best handled as JSON. Q: How can I as an Agency retrieve the files? A: The Partners retrieve the files by JSON technology. See https://developer.hurtigruten.com/hrg/Partners/AgentBookings for more information. Q: How do I sign up as an Agency to this distribution? A: You can go to https://developer.hurtigruten.com/signup for self-service registration. Q: To whom are the files distributed? A: The files are distributed to Agencies and Partners. Q: How can I as an Agency integrate with Hurtigruten’s API technology to allow Customers to book on my web site? A: Please have a look at https://developer.hurtigruten.com/hrg/Partners/AgentBookings
§§§§§§§§§§§§§§§§§§§§§§§§
Flat file contents
Q: What information do the files contain? A: The files contain data about prices, availability, itinerary, ships, and more. Please look at file structure at https://developer.hurtigruten.com/hrg/Partners/RatesAndAvailability and https://developer.hurtigruten.com/hrg/Partners/CmsContent Q: Do the files contain data about all voyages by Hurtigruten? A: The files contain all the international explorer voyages and the three Norwegian coastal classic voyages: (1) Bergen – Bergen [return] (2) Bergen – Kirkenes [northbound] (3) Kirkenes – Bergen [southbound] Q: How often are the files updated? A: The files are updated once per day. Normally generated by 12 noon CET. Q: Which periods do the files cover? A: The files contain data of approximately 16 months for international explorer voyages and 18 months for Norwegian coastal voyages. Q: What does the cabin “Category” and “Super Category” mean? A: Information about ships and cabins can be found in the ships.json as documented at https://developer.hurtigruten.com/hrg/Partners/CmsContent and also on our webpages Change the url .com to .uk, .fr and spelling of hurtigruten in your language , etc ... Q: Why can the “From prices” differ from the actual prices when I move from search to book? A: The files are generated once per day, and the prices may change. The “From prices” are per person in a double or twin cabin. Other party mixes may have different prices. Plus at present the flat-files contain cruise-only prices at present See https://developer.hurtigruten.com/forum/topics/package-prices-will-be-included-in-the-flat-files for when package prices will be included. Q: Do the prices include Agency commissions? A: Agencies follow different commission structures at Hurtigruten. The prices in the flat-files do not reflect commissions, however when you book online via https://developer.hurtigruten.com/hrg/Partners/AgentBookings Q: Are taxes included in the prices? A: The prices include taxes. Q: Are campaign rebates included in the prices? A: The lowest possible prices are shown for your market. Q: Are there group prices in the files? A: The files contain individual prices (FIT) only. Q: Are the prices for the specific Agency? A: The prices are per market. Q: In which currencies are the prices available? A: NOK, SEK, DKK, USD, GBP, and EUR. AUD is available soon. Q: Do the prices contain flights and other package items? A: The prices are cruise only. However we are supplying information about the packages available - see the RefData files in the Flat file zip object. Plus at present the flat-files contain cruise-only prices at present See https://developer.hurtigruten.com/forum/topics/package-prices-will-be-included-in-the-flat-files for when package prices will be included. Q : Is it possible that a room has a single rate but doesn’t have a double rate, or the other way around, has a double rate but has no single rate? A : Yes it is possible sometimes, but this would rarely be the case. One instance where this could happen is for categories e.g. “D1”, which are single occupancy categories. Q: Please describe the passenger types, including the term “Young Explorer” A: These age ranges are valid: Seniors: 67+ years Infant: less than 4 years Child: 4 -15 years Adults: 16 – 66 The age ranges are the same across all ships and destinations. There’s just no Military or Student pricing available for Explorer. Young Explorer isn’t a passenger type so you can just ignore it. It is just an on-board programme offered. Q: What are the rate_codes? A: Apply only for the Norwegian Coastal sailings (i.e not Explorer sailings.) The definition of them can be found at https://global.hurtigruten.com/practical-information/price-structure/ Q: How deck level can be extracted from cabin number? A: In the cabin number the first digit always indicates the deck of cabin. E.g. Cabin O3-316 is located on deck 3. For MS Vesterålen and MS Lofoten, deck 1 = deck A, deck 2 = deck b etc. Q: How to get day-to-day itinerary for classic coastal voyages from voyages_LANG.json? A: By now the classic coastal voyages doesn't have travelSuggestionCodes registered, but they are listed as first sets in voyages_LANG.json VoyageLink and travelSuggestionCodes are supposed to be added into booking engine for classic coastal voyages. Q: How to get day-to-day itinerary for expedition voyages from voyages_LANG.json? A: Expedition cruises have a travelSuggestionCodes registered in voyages_LANG.json These codes can be retrieved from PackageMetaData.json:PackageId where PackageMetaData.json:MasterPackageId is linked to SourceMarket.json:MasterPackageId The content of FlatFiles and reference Data is described on their own pages in more detail. Q: In which timezone StartDate,EndDate and EmbarkationDate are shown in FlatFiles? A: Date and time are always local times in combination with the given location in StartLocation or EndLocation. Same applies for ArrivalDateTime and DepartureDateTime with the given location in Port So as example: "Port": "MAL", Måløy timezone CET "ArrivalDateTime": "2019-03-22T07:15:00" 22.03.2019 07:15:00 CET or 22.03.2019 06:15:00 UTC "DepartureDateTime": "2019-03-22T07:30:00" 22.03.2019 07:30:00 CET or 22.03.2019 06:30:00 UTC
§§§§§§§§§§§§§§§§§§§§§§§§
Api config
Q: How do I create my first API application. By default it is connected to our production environment A: Press the application link in the header, and then "Create new application" and choose the "Partner Booking" service. Q: How do I create a TEST application that goes against the HRG staging/test servers A: First you must subscribe to the "Service" for the staging/test environment via the services link in the header. Then create the application via the same method as answered above Q: Invite your new users to your API Account A: User administrion and new invites can be done via the Settings link in the header.
§§§§§§§§§§§§§§§§§§§§§§§§
Booking process
Q: How long is a quote alive in API booking process A: A quote or an option for cabins is alive for 30 minutes since the last query or update on the quote. To ensure the booking, the process has to be comitted as booking within 30 minutes since the last update or the cabin will be release to general availability. Q: How to get the rates for triple and more occupancies. A: You need to call to our service center to get prices for triple or quad occupancy. They will not be shown in FlatFiles. You can reach use on phone or email: Client Service Center Nordic +47 810 03 030 Europe +0844 272 8961 UK/Rest of the world +44 208 846 2666 US +1 866 552 0371 Germany +49 (0)40 87 40 88 55 France +33 1 82 88 26 95 In case of any issues regarding the booking engine and its functionalities, please contact b2b.support@hurtigruten.com In case of any price and availability related requests, please turn to general email of your respective market. Nordic: booking@hurtigruten.com UK/Rest of the world: book@hurtigruten.com US: usbooking@hurtigruten.com Germany : webookingCE@hurtigruten.com Q: How many passengers can be booked in a single quote? A: With a single quote, our booking engine is capable of maximum 8 passengers. If you have 10 or more persons, please contact the groups department of your market. Q: How does the booking process for classic coastal voyages and expedition cruises differ? A: For both types a differnt approach is needed to generate a valid quote and commit a booking For classic coastal voyages it follows the path api/Search/Voyage > api/Search/Cabin > api/Quote/Cabin For expedition voyages it starts from api/Search/Package > api/Search/PackagePrice > api/Quote/Package A detailed booking flow is described on Partners/AgentBookings Q: How to book multiple cabins with confirmed cabin numbers? A: Currently it is only possible, to book multiple cabins with confirmed cabin numbers through our API, if they are create with multiple quotes having each only one cabin. In case of more cabins per quote, the selection of chosen cabin numbers can only be done after committing the quote and reach out to our service center.
§§§§§§§§§§§§§§§§§§§§§§§§