G7 Travelmessage V3.1 description

General

Endpoint

Travelmessage G7 has an API endpoint. Once you have a key you can try our services according to the standard described in the reference documentation. And this follows the standard ANVR G7 Standard version 3.1.

In the next section the requests that had been implemented at TUI are briefly described. The pictures are from the "standard for ANVR XML-Message flow" document provided by the ANVR. Not all elements shown in the pictures are used at TUI. In the reference documentation is a more detailed description and together with the examples it gives a good understanding of the elements used at TUI.

Availability

The availability of a journey can be requested with the dialogue Availability. AvailabilityRequest is used for checking the availability from Transport, Accommodation, Journey, Round trip and/or Additional products. The message contains Package data or Component data and possibly the request for(details from) additional products. At TUI the package approach is implemented.

Sell

The dialogue of Sell aims at indicating the package parts which have been selected for the subsequent dialogue. The message contains package information and optional information relating to Transport, Accommodation and Additional products (Roundtrip and Cruise information are not implemented yet). At TUI the SellRequest is only used for setting up a session and do some basic validating.

Assign

With the dialogue and the XML-messages of Assign it is possible to store passenger information and the assignments for a trip. This information and assignments are stored in the session created with Sell. For changes in passenger information or changes in assignments Assign can be called more then once with the same sessionID. If elements are changed (for example other unit) or added (for example extras) then a new Sell and Assign must be send. If the result of Assign is OK a price breakdown is given.

Book

With the dialogue Book it is possible to complete a booking according to the PaxDetails and the PaxAssignment. For G7 the passenger information and assignment must be in the request. For TUI only confirmation of the sessionID is enough. So Changes in names or assignments between Assign and Book are ignored. In this case Assign has to be called again before calling Book.

AddProAvailability

AddProAvailability is used to acquire summary information about additional products. There a two approaches. With overview response, ResponseID is filled with AvailabilityResponse. Only minimum information, ID and description are given. If a detailed response is necessary ResponseID will be filled with AvailabilityDetailsResponse. All information is given. These 2 approaches are not (yet) implemented at TUI. For TUI there is a third approach where additional product information can be acquired from the transport which is chosen (for example luggage). In this case the RequestID should be filled with AddProAvailabilityTransportRequest.

Break

The Break-dialogue allows to cut off a session between the travel agent and the tour operator decently. Break can be used after Sell and before Book.

Receipt

This message is acquired for specifying a receipt. It is a kind of combination of Sell and Assign to get back a price breakdown without starting a session. Because for TUI things were missing in the the structure of the 3.1 xsd, the xsd was changed to fit our needs. So the picture is not entirely correct.

Recap

With the dialogue of Recap recapitulation from the data stored at the Touroperator concerning the currently booked trip can be requested. Or it can be used after creating a booking to get all the booking information. At TUI the Recap is only implemented for getting a booking.

Cancellation

With the dialogue of Cancellation a created booking can be cancelled. It is recommended to use two messages. First doing a cancellation request to get the cancellation cost and the do a cancellation confirmed request which actually cancels the booking. For now TUI only implemented the confirmed version. So using this a booking will be directly cancelled if possible.

V1.1